Function tip_NextDocument
|
|
Prototype: | tip_NextDocument(Collection);
|
---|
Arguments: | Collection: A Collection object. (CDM_Collection)
|
---|
|
|
Description:
This function will return the next available Document object. "Next"
means the Document that follows the one previously returned by calls to
the following functions:
tip_FirstDocument, tip_NextDocument, tip_GetDocument,
tip_GetByExternalId. If previous calls to this function have returned all available
Documents, then an error will prompt and the current active Tcl
interpreter (CDM_Interp) will be reseted. If an error occurs, then an
error message will prompt again. As a result, the caller must check the
information stored at this Tcl interpreter in order to distinguish
between the normal termination of the Document chain or an error
condition.
Return Value:
This function returns a Document object (of type CDM_Document) that can
be used as a reference to all functions that require a Document object
as input. This object will be valid until the Collection that holds this
Document object is closed (through CDM_Close) and the parent Collection
removed from memory. If this object is used after its parent Collection
has been closed, an undefined behaviour will occur.
If an error occurs, an error message will prompt. An error message will
also be prompted if the last Document of the specified Collection has
already been returned by any of the following functions:
tip_FirstDocument, tip_NextDocument, tip_GetDocument,
tip_GetByExternalId.
Also note that the returned object is property of the CDM and should
never be freed or modified in any way by the caller.
Notes:
Note that if this function is called with a Collection object that has
just be created or opened, an undefined behaviour will occur. This function is equivelant to CDM_NextDocument (C++ API).
See Also:
tip_Close, tip_FirstDocument, tip_NextDocument, tip_GetDocument,
tip_GetByExternalId
Generated by: petasis@aias on Wed Aug 16 10:31:45 PM EEST 2006.