void SetNodeStateTitle_bn ( node_bn*  node,   state_bn  state,   const char*  state_title )

Gives the title state_title to that state of node whose index is state.

state must be between 0 and one less than the number that would be returned by GetNodeNumberStates_bn, inclusive.

State titles provide an alternative to state names for labeling the states of a node. Unlike a state's name, there is no restriction on the length of the title, or on what characters it might contain. node may have some states titled, and others not.

Discretized continuous nodes may have their states titled, as well as regular discrete nodes.

Passing NULL for state_title will remove the title of that state only.

Netica will make a copy of state_title; it won't modify or free the passed string.

Version:

Versions 1.18 and later have this function.

See also:

GetNodeStateTitle_bn    Get the existing state title if there is one
SetNodeStateName_bn    
SetNodeStateComment_bn    Sets the state's comment
GetNodeNumberStates_bn    state must be between 0 and one less than this, inclusive