Next: , Previous: Halt, Up: Reference



High

Synopsis

     function High (ordinal_type_or_variable): ordinal_type;

or

     function High (array_type_or_variable): array_index_type;

or

     function High (string_variable): Integer;

Description

For ordinal types or variables of that type, High returns the highest value a variable of that type can assume.

For array types or variables of that type, High returns the highest index a variable of that type can assume. Note: the result is of the same type as the array index is. If the array has more than one dimension, High returns the highest index in the first dimension.

If the argument is a string variable, High returns the discriminant of the string type (i.e. its capacity).

Conforming to

High is a Borland Pascal extension.

Example

     program HighDemo;
     type
       Colors = (Red, Green, Blue);
     var
       Col: array [Colors] of (Love, Hope, Faithfulness);
       Foo: Colors;
       Bar: Integer;
       Baz: String (123);
     begin
       Foo := High (Col);             { yields Blue }
       Bar := Ord (High (Col[Foo]));  { yields Ord (Faithfulness), i.e., 2 }
       Bar := High (Integer);         { highest possible value of `Integer' }
       Bar := High (Baz)              { returns 123 }
     end.

See also

Low