length

This function calculates the total length of the parameter in bytes.

length ( input_text )

The result of this function is of type NUMBER: the length of the input_text in bytes.

This function has one parameter:

  1. input_text, type TEXT. The text whose length in bytes will be determined.

Example

@( length( "abcdefgh" ) ) 

Result: 8.00.

Note that the construction @ ( ) around the function means that the result of the function is displayed in the text. This construction must be used in a text part of a model document. The switch from ITP mode to text mode in a model document is made with the # characters. An ITP model document starts in text model, the #BEGIN makes the switch to ITP mode.

Note

The function length specifies the length of a given text in bytes. To calculate the length of a given text in characters you should use the function number_of_characters.

Note

The setting EnhancedUnicodeSupport in the ITP/Server Administrator can be used to map the function length automatically to the function number_of_characters. Refer to topic Enhanced Unicode support for more information.