nodelist_bn* DupNodeList_bn ( const nodelist_bn*  nodes )

Duplicates the list nodes, and returns the duplicate list.

When you are finished with the list returned, pass it to DeleteNodeList_bn (not the Standard C 'free' or 'delete').

This only makes a copy of the list; if you want to duplicate the nodes as well, use DuplicateNodes_bn.

When Netica API functions return const nodelist_bn*, the returned node lists are volatile (they may become invalid after further Netica calls) and nonmodifiable. Duplicating them with this function removes both of these concerns.

Version:

This function is available in all versions.

See also:

DeleteNodeList_bn  Delete the new list created
NewNodeList_bn  Make a new empty list
DuplicateNodes_bn  Duplicates the nodes as well as the list