› KCM Template Scripting Developer's Guide › Functions › Text functions › uppercase2

uppercase2

The uppercase2 function has been superseded by the uppercase_of_characters function. Unless Enhanced Unicode Support is disabled, all calls to uppercase2 are automatically mapped to uppercase_of_characters function.

Use the uppercase2 function to convert a fragment of a text to uppercase.

uppercase_of_characters function. 

 uppercases2 ( input; start; end )

This function returns a value of type TEXT.

The function has three parameters:

  1. input, type TEXT. The text which is converted.
  2. start, type NUMBER. The position of the first character to be changed.
  3. end, type NUMBER. The position of the last character to be changed.

start and end start at 1 for the first character in input. A negative or 0 value is interpreted as the beginning of the value. If end is smaller than start, the value is returned unmodified.

Examples

uppercases2 ("This is an EXAMPLE"; 6; 7) results in "This IS an EXAMPLE"

uppercases2 ("This is an EXAMPLE"; 7; 6) results in "This is an EXAMPLE"

The uppercases2 function is limited to content that only consists of latin-1 text. This function does not support word processor instructions or Unicode content. Use of this function with non latin-1 content can result in run-time errors or broken result documents.