This function returns the name of a level given the level number (0-based).

Examples


In this example, we return the level name of the 0th level of the second point defined in the EOS_PT_DEFLEVEL section:

status = EOS_PT_GETLEVELNAME(pointID2, 0, levelname)

Syntax


Result = EOS_PT_GETLEVELNAME( pointID, level, levelname [, LENGTH=variable] )

Return Value


Returns SUCCEED (0) if successful and FAIL (–1) otherwise.

Arguments


pointID

Point id (long) returned by EOS_PT_CREATE or EOS_PT_ATTACH.

level

Point level (0-based long).

levelname

A named variable that will contain the level name (string).

Keywords


LENGTH

Set this keyword to a named variable that will contain the string length of the level name.

Version History


5.2

Introduced