Builds compound text from a number of variables placed in a format string. The format string contains plain text and a number of numbered place holders in that text of the form %n, where n is in the range 1..20 and represents the corresponding subsequent arguments. Use %% to indicate the % character. Identifying arguments numerically is useful when multiple user interface languages must be considered, as shown in the example. The format string can also be given as a numerical string ID, in which case it will be substituted by the equivalent string loaded from Modeller's resources.
| format | string | |
| arg1 | optional string | |
| arg2 | optional string | |
| arg3 | optional string | |
| arg4 | optional string | |
| arg5 | optional string | |
| arg6 | optional string | |
| arg7 | optional string | |
| arg8 | optional string | |
| arg9 | optional string | |
| arg10 | optional string | |
| arg11 | optional string | |
| arg12 | optional string | |
| arg13 | optional string | |
| arg14 | optional string | |
| arg15 | optional string | |
| arg16 | optional string | |
| arg17 | optional string | |
| arg18 | optional string | |
| arg19 | optional string | |
| arg20 | optional string | |
| Return value | string | 
Example
 number = "10"
 if (language == "French") then
     fruit = "pommes"
     colour = "rouge"
 ' in French, adjectives come after the noun
     fmt = "J'ai %1%% des %3 %2"
 else
     fruit = "apples"
     colour = "red"
 ' in English, adjectives come before the noun
     fmt = "I have %1%% of the %2 %3"
 end if
 msgbox(localFormat(fmt, number, colour, fruit))
 
 would display the string "I have 10% of the red apples" for English,
 and "J'ai 10% des pommes rouge" in French
 
 msgbox(localFormat(IDS_ELEMENT_NAME))
 
 would display the string "Element", correctly translated for the current user interface language
Back to Modeller
Back to Overview