area_in_words

The function area_in_words interprets a number as an area and returns that area in words. It only succeeds if the number passed to it is greater than or equal to zero.

area_in_words ( input_number ) 

The result of this function is of type TEXT; the input_number as an area in words.

This function has one parameter:

1. input_number, type NUMBER. This number will be interpreted as an area and converted to words.

Example

@( area_in_words( 122302) ) 

Result: 12 hectare, 23 acre and 2 centiare. (In fact this is incorrect, it should be ares and not acres. The metric system is used here.)

The words used to describe the area depends on the output language setting in the ITP configuration window, however the system used to convert the number to an area is metric e.g., the number is taken to mean square meters.

Note

Do not use this function with the ITP Output Language set to english.

The output is incorrect if you do; 'ares' (10 by 10 metres! = 100 m2) is translated with 'acres' (4046.8564224 m2) without conversion.

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.