Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_PT_GETLEVELNAME

# EOS_PT_GETLEVELNAME

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