const char* GetNodeStateName_bn ( const node_bn*  node,   state_bn  state )

Given an integer index representing a state of node, this returns the associated name of that state, or the empty string (rather than NULL) if it does not have a name.

Either all of the states have names, or none of them do.

If the name is present, you can count on it to be a legal IDname, which means that it is NAME_MAX_ns (30) or fewer characters (not including terminating 0).

If you need the string to persist, make a copy of the string returned, since its contents may become invalid after further calls to Netica API. Do not try to directly modify or free the string returned.

Version:

This function is available in all versions.

See also:

SetNodeStateName_bn    Sets it
SetNodeStateNames_bn    Sets names of all states at once
GetStateNamed_bn    (inverse function) Returns the state with a given state name
GetNodeStateTitle_bn    
GetNodeNumberStates_bn    state must be between 0 and one less than this, inclusive