nodelist_bn* NewNodeList_bn ( int  length,   environ_ns*  env )

Creates and returns a new node list with length entries, each filled with NULL.

You can then fill the entries using SetNthNode_bn. A safer way to build node lists is to call this function with length = 0, and then add nodes to the end of the list by calling AddNodeToList_bn with an index of LAST_ENTRY.

Use DeleteNodeList_bn to free the list when you are done with it (do not try to use the Standard C/ C++ 'free' or 'delete').

Version:

This function is available in all versions.

See also:

DeleteNodeList_bn  (reverse operation) Free the new list made
DupNodeList_bn  Make a copy of an existing list
AddNodeToList_bn  Increases a list's length by adding a node
SetNthNode_bn