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.


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
GetNodeNumberStates_bn    state must be between 0 and one less than this, inclusive