|
|
The Collection object must be a valid object (corresponding to an open Collection) returned by either tip_CreateCollection or tip_OpenCollection.
The External Id must be a valid (absolute) path. A local copy of this
argument will be created for use by this function. The existance of
this path will not be checked. This path value will be
converted automatically to a valid platform dependant path. As a result,
for this value can be safely used the notation used for paths under the
unix operating system. That means that the path:
will be converted interanlly to the following path, assuming windows as
operating system :
The RawData parameter must contain the desired for the new Document
text, in UTF-8 format. A local copy of this variable will be also
created. If the text is not in UTF-8 (i.e. contains text just red from
a file using the standart C library routines and is in the ISO 8859-7
encoding) then must be converted to UTF using tip_ExternalToUtf. If
the origin of this string is Tcl, then it is already in UTF format, as
Tcl uses ONLY UTF for encoding strings internally.
The Annotations parameter must contain an Annotation set created with tip_CreateAnnotationSet.
The Attributes parameter must hold a valid Attribute set created with tip_CreateAttributeSet.
Finally, an optional encoding can be specified. A local copy of this
string will be created. The value of this parameter must be a standart
Tcl encoding value (like iso8859-7 or cp1253). For all available Tcl
encodings please refer to the
Tcl manuals.
If this parameter is ommitted,
then a default value will be used. This value will be inherited from the
parent Collection object. It is important for the encoding to correctly
describe the text. If the given UTF string cannot be converted to the
Document's encoding, then the text will be filled with the character "?"
in places where the conversion will fail.
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 tip_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. Return Value:
If an error occurs, then an error message wil prompt.
*
This function is equivelant to CDM_CreateDocument (C++ API). Notes:
tip_CreateAnnotationSet, tip_CreateAttributeSet, tip_CreateCollection,
tip_ExternalToUtf, tip_OpenCollection
The Tcl Encoding manual.
See Also:
Generated by: petasis@aias on Wed Aug 16 10:31:45 PM EEST 2006.