- Using StringBuild in multilingual applications
StringBuild (Function) In french: ChaîneConstruit Builds a character string from an initial string and parameters.
MyString1 is string MyString1 = "The %1 file cannot be opened by " + ... "%2. The %1 file cannot be accessed." MyResult is string = StringBuild(MyString1, "Example", "Tintin") // MyResult contains: "The Example file cannot be // opened by Tintin. The Example file cannot be accessed."
Versions 18 and later
MyString1 is string MyString1 = "The %1 file cannot be opened by " + ... "%2. The %1 file cannot be accessed." MyArray is array of 1 string MyArray[1] = "Example" MyArray[2] = "Tintin" MyResult is string = StringBuild(MyString1, MyArray) // MyResult contains: "The Example file cannot be // opened by Tintin. The Example file cannot be accessed." // You can also use the following syntax MyResult is string = StringBuild(MyString1, ["Example", "Tintin"])
New in version 18
MyString1 is string MyString1 = "The %1 file cannot be opened by " + ... "%2. The %1 file cannot be accessed." MyArray is array of 1 string MyArray[1] = "Example" MyArray[2] = "Tintin" MyResult is string = StringBuild(MyString1, MyArray) // MyResult contains: "The Example file cannot be // opened by Tintin. The Example file cannot be accessed." // You can also use the following syntax MyResult is string = StringBuild(MyString1, ["Example", "Tintin"])
MyString1 is string MyString1 = "The %1 file cannot be opened by " + ... "%2. The %1 file cannot be accessed." MyArray is array of 1 string MyArray[1] = "Example" MyArray[2] = "Tintin" MyResult is string = StringBuild(MyString1, MyArray) // MyResult contains: "The Example file cannot be // opened by Tintin. The Example file cannot be accessed." // You can also use the following syntax MyResult is string = StringBuild(MyString1, ["Example", "Tintin"])
Syntax
Building a string from parameters Hide the details
<Result> = StringBuild(<Initial string> [, <Parameter 1> [... [, <Parameter N>]]])
<Result>: Character string Result string: the %X characters have been replaced by the specified parameters. <Initial string>: Character string (with quotes) Character string containing optional parameters (%1 to %n). To display the % character in the <Result> string, it must be typed twice (%%). <Parameter 1>: Optional character string (with quotes) First parameter that will be inserted into the formatted character string. <Parameter 1> will replace the %1 character, <Parameter 2> will replace the %2 character, etc. The number of specified parameters must be equal to or greater than the number of parameters used in <Initial string>. If <Initial string> contains more parameters, the additional parameters will be replaced by empty strings. <Parameter N>: Optional character string (with quotes) Nth parameter that will be inserted into the formatted character string. <Parameter 1> will replace the %1 character, <Parameter 2> will replace the %2 character, etc. The number of specified parameters must be equal to or greater than the number of parameters used in <Initial string>. If <Initial string> contains more parameters, the additional parameters will be replaced by empty strings. Versions 18 and later
Building a string from parameters stored in an array Hide the details
<Result> = StringBuild(<Initial string> [, <Array of parameters>])
<Result>: Character string Result string: the %X characters have been replaced by the specified parameters. <Initial string>: Character string (with quotes) Character string containing optional parameters (%1 to %n). To display the % character in the <Result> string, it must be typed twice (%%) <Array of parameters>: Array Name of the one-dimensional array containing the parameters to insert into the formatted character string. The first element in the array will replace the %1 character, the second element in the array will replace the %2 character, etc., ... The number of elements in the array must be equal to or greater than the number of parameters used in <Initial string>. If <Initial string> contains more parameters, the additional parameters will be replaced by empty strings.Remark: You can also pass an array as a parameter by using the following syntax:
<Element 1>, ..., <Element N>
New in version 18
Building a string from parameters stored in an array Hide the details
<Result> = StringBuild(<Initial string> [, <Array of parameters>])
<Result>: Character string Result string: the %X characters have been replaced by the specified parameters. <Initial string>: Character string (with quotes) Character string containing optional parameters (%1 to %n). To display the % character in the <Result> string, it must be typed twice (%%) <Array of parameters>: Array Name of the one-dimensional array containing the parameters to insert into the formatted character string. The first element in the array will replace the %1 character, the second element in the array will replace the %2 character, etc., ... The number of elements in the array must be equal to or greater than the number of parameters used in <Initial string>. If <Initial string> contains more parameters, the additional parameters will be replaced by empty strings.Remark: You can also pass an array as a parameter by using the following syntax:
<Element 1>, ..., <Element N>
Building a string from parameters stored in an array Hide the details
<Result> = StringBuild(<Initial string> [, <Array of parameters>])
<Result>: Character string Result string: the %X characters have been replaced by the specified parameters. <Initial string>: Character string (with quotes) Character string containing optional parameters (%1 to %n). To display the % character in the <Result> string, it must be typed twice (%%) <Array of parameters>: Array Name of the one-dimensional array containing the parameters to insert into the formatted character string. The first element in the array will replace the %1 character, the second element in the array will replace the %2 character, etc., ... The number of elements in the array must be equal to or greater than the number of parameters used in <Initial string>. If <Initial string> contains more parameters, the additional parameters will be replaced by empty strings.Remark: You can also pass an array as a parameter by using the following syntax:
<Element 1>, ..., <Element N>
Remarks Using StringBuild in multilingual applications If your application contains messages displayed in several languages, StringBuild is used to replace the optional characters in all the supported languages. For example:
Related Examples:
|
Unit examples (WINDEV): Complex strings
[ + ] Implementing the building of complex strings with StringBuild.
|
This page is also available for…
|
|
|