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

lowercase2

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

Use the lowercase2 function to convert a text fragment to lowercase. 

 lowercase2 ( 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

lowercase2 ("THIS IS AN example"; 6; 7) results in "THIS is AN example"

lowercase2 ("THIS IS AN example"; 7; 6) results in "THIS IS AN example"

The lowercase2 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.