Introduction

This function can be used to format the result of an ISML expression. The value of an ISML expression is returned by getValue() as a formatted string. The standard formatter classes control how the string is formatted.

There are three ways to control the formatter classes:

• use pre-defined formatter string
  The standard formatter classes come with pre-defined formatter strings. These are called styles.
• use custom formatter string
  You can define and use your own formatter string with the formatter class.
• use default formatter string
  Each formatter class has one default style. This style will be used if you do not specify anything else (neither a style nor a custom formatter string).

Syntax

getValue( <value> )
getValue( <value>, <style> )
getValue( <value>, <formatter> )

Example

The first example shows one of the styles in the formatter class:

<ISPRINT value="#getValue(Basket:TotalPrice,MONEY_LONG)#">

The next example shows how to specify a formatter string:

<ISPRINT value="#getValue(Offering:Weight,'#,##0.00')#">

Because neither a style nor a formatter string has been specified, the default style of the formatter class is used for formatting in the following example:

<ISPRINT value="#getValue(Purchaser:Address:Zip)#">

Parameters

value

value = ISML Expression

Specify the ISML expression to be formatted. Usually this will be just a template variable.

style

style = style identifier

Specify a valid style to be used for formatting the expression result. See Formatting Expression Resultsfor a list of valid styles.

formatter

formatter = formatter string

Specify a formatter string to control the formatting of the expression result. See the Java documentation in <IS.INSTANCE.DIR>\docs for more information about creating formatter strings.