void SetNodeName_bn ( node_bn*  node,   const char*  name )

Changes the name of node to be name.

name must be a legal IDname, which means it must have NAME_MAX_ns (30) or fewer characters, all of which are letters, digits or underscores, and it must start with a letter.

name must be different from the name of every other node already in the same net (by case-sensitive comparison).

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

If name ends with an asterisk (*), then Netica will replace the * with an integer to make a unique name for the node; you can discover what name was picked using GetNodeName_bn after the node is formed.


This function is available in all versions.

See also:

GetNodeName_bn    Retrieves value
SetNodeTitle_bn    Not restricted by IDname criteria
NewNode_bn    Gives the node its original name