Data type to represent offsets (positions) within a data stream. FIXME: gsf_off_t is really supposed to be the widest type off_t can be configured to on the platform Creates a new #GsfBlob object to hold the specified data. The blob can then be used as a facility for reference-counting for the data. The data is copied internally, so the blob does not hold references to external chunks of memory. A newly-created #GsfBlob, or %NULL if the data could not be copied. Error domain: #GSF_ERROR Possible errors: #GSF_ERROR_OUT_OF_MEMORY if the @data_to_copy could not be copied. Size of the data in bytes. Data which will be copied into the blob, or %NULL if @size is zero. Queries the size in bytes of the data stored in the blob. Size in bytes, or 0 if the data is %NULL. A #GsfBlob. Queries a pointer to the data stored in the blob. This does not copy the data for you; it returns a pointer to the actual buffer which the blob uses internally, so you should not free this buffer on your own. Pointer to the data stored in the blob, or %NULL if the size of the data is zero. A #GsfBlob. Creates a new #GsfClipData object. This function acquires a reference to the @data_blob, so you should unref the blob on your own if you no longer need it directly. A newly-created #GsfClipData. Format for the data inside the @data_blob Object which holds the binary contents for the #GsfClipData Queries the data blob that actually stores a #GsfClipData's binary data. A new reference to the #GsfBlob that stores this @clip_data's binary data. You must use g_object_unref() to dispose of that data blob when you are done with it. A #GsfClipData. Queries the clipboard data format of a #GsfClipData. The format refers to the data blob inside the @clip_data; use gsf_clip_data_get_data_blob() to get that data blob. The format in which the #GsfClipData's data blob is stored. A #GsfClipData. Queries the Windows clipboard data format for a #GsfClipData. The @clip_data must have been created with #GSF_CLIP_FORMAT_WINDOWS_CLIPBOARD. A #GsfClipFormatWindows value. Possible errors: #GSF_ERROR_INVALID_DATA if the data blob in the @clip_data is smaller than it should be; in this case GSF_CLIP_FORMAT_WINDOWS_ERROR will be returned. A #GsfClipData. Queries a pointer directly to the clipboard data of a #GsfClipData. The resulting pointer is not necessarily the same data pointer that was passed to gsf_blob_new() prior to creating the @clip_data. For example, if the data is in #GSF_CLIP_FORMAT_WINDOWS_CLIPBOARD format, then it will have extra header bytes in front of the actual metafile data. This function will skip over those header bytes if necessary and return a pointer to the "real" data. Pointer to the real clipboard data. The size in bytes of this buffer is returned in the @ret_size argument. A #GsfClipData. Location to return the size of the returned data buffer. Windows clipboard format Macintosh clipboard format GUID that contains a format identifier No clipboard data Custom clipboard format Unknown clipboard type or invalid data error unknown CF_METAFILEPICT CF_DIB CF_ENHMETAFILE Class representing information about a document, such as creator and time of last modification. a new metadata property collection Iterate through each (key, value) pair in this collection the collection the function called once for each element in the collection any supplied user data Take ownership of @name and @value and insert a property into @meta. If a property exists with @name, it is replaced (The link is lost) #GsfDocMetaData the id. #GValue the property with @name in @meta. The caller can modify the property value and link but not the name. #GsfDocMetaData Extend @xin so that it can parse a subtree in OpenDoc metadata format #GsfDocMetaData #GsfXMLInDoc Read a stream formated as a set of MS OLE properties from @in and store the results in @accum. A #GError if there was an error. #GsfDocMetaData #GsfInput Read an OpenDocument metadata stream from @input and store the properties into @md. Overwrite any existing properties with the same id. a #GError if there is a problem. #GsfDocMetaData #GsfInput If @name does not exist in the collection, do nothing. If @name does exist, remove it and its value from the collection the collection the non-null string name of the property the number of items in this collection the collection the property with @name in @meta. #GsfDocMetaData #GsfDocMetaData #GsfDocProp %TRUE on success; #GsfDocMetaData #GsfOutput a kludge to differentiate DocumentSummary from Summary %TRUE if no error occured. #GsfDocMetaData a pointer to a #GsfOutput. Class representing a properties of a document. a new #GsfDocProp. The name of the property. A debugging utility to dump @prop as text via g_print New in 1.14.2 #GsfDocProp Release the given property. #GsfDocProp the current link descriptor of @prop. #GsfDocProp the name of the property #GsfDocProp the value of the property, the caller should not modify the result. the property Sets @prop's link to @link #GsfDocProp a link. Assigns @val to @prop, and unsets and frees the current value. #GsfDocProp #GValue the current value of @prop, and replaces it with @val. #GsfDocProp #GValue This function creates a new gsf_docprop_vector object. GsfDocPropVector* Insert a copy of @value as the last element of @vector. The vector to which the GValue will be added The GValue to add to @vector This function returns a string which represents all the GValues in @vector. The caller is responsible for freeing the result. a string of comma-separated values The #GsfDocPropVector from which GValues will be extracted. Memory allocation failed Invalid data encountered (e.g. not enough data) the utf8 encoded name of the @i-th child An #GsfInfile zero-based index of child to find. the number of children the storage has, or -1 if the storage can not have children. the structured storage This function finds a child that is several directory levels down the tree. If, for example, the names "foo", "bar", and "baz" are given, then this function first finds the "foo" directory in the root infile, then locates "bar" within that directory, and finally locates "baz" within that and returns the "baz" child. In other words, this function finds the "foo/bar/baz" child. New in 1.14.9. a newly created child which must be unrefed. #GsfInfile A %NULL terminated array of names (e.g. from g_strsplit) TODO : For 2.0 api will change to include a #GError. a newly created child which must be unrefed. #GsfInfile target index The function returns a named child of the given infile. This only works for an immediate child. If you need to go several levels down use gsf_infile_child_by_aname, for example. TODO : For 2.0 api will change to include a #GError. a newly created child which must be unrefed. #GsfInfile target name Apart from argument types, this is the same as gsf_infile_child_by_aname. Please see the documentation there. New in 1.14.9. a newly created child which must be unrefed. #GsfInfile A %NULL terminated array of names (e.g. from g_strsplit) Apart from the way arguments are specified, this is the same as gsf_infile_child_by_aname. Please see the documentation there. a newly created child which must be unrefed. a #GsfInfile A %NULL terminated list of names the utf8 encoded name of the @i-th child An #GsfInfile zero-based index of child to find. the number of children the storage has, or -1 if the storage can not have children. the structured storage the number of children the storage has, or -1 if the storage can not have children. the structured storage the utf8 encoded name of the @i-th child An #GsfInfile zero-based index of child to find. Opens the root directory of an MS OLE file. <note>This adds a reference to @source.</note> the new ole file handler #GsfInput Retrieves the 16 byte indentifier (often a GUID in MS Windows apps) stored within the directory associated with @ole and stores it in @res. TRUE on success a #GsfInfileMSOle 16 byte identifier (often a GUID in MS Windows apps) a collection of names and source code. A #GHashTable of names and source code (unknown encoding). #GsfInfile A collection of names and source code which the caller is responsible for destroying. A #GHashTable of names and source code (unknown encoding). #GsfInfile a new file or %NULL. in locale dependent encoding Opens the root directory of a Tar file. <note>This adds a reference to @source.</note> the new tar file handler A base #GsfInput Opens the root directory of a Zip file. <note>This adds a reference to @source.</note> the new zip file handler A base #GsfInput Controls the level of compression used for new members. Class representing an input stream. A new #GsfInputMemory The file on disk that you want to mmap A utility quark to flag a #GError as being an input problem. Duplicates input @src leaving the new one at the same offset. the duplicate The input to duplicate UNIMPLEMENTED BY ANY BACKEND and it is probably unnecessary. gsf_input_get_container provides enough power to do what is necessary. Attempts to open a 'sibling' of @input. The caller is responsible for managing the resulting object. A related #GsfInput The input name. Read at least @num_bytes. Does not change the current position if there is an error. Will only read if the entire amount can be read. Invalidates the buffer associated with previous calls to gsf_input_read. pointer to the buffer or %NULL if there is an error or 0 bytes are requested. the input stream number of bytes to read Pointer to destination memory area Move the current location in the input stream. %TRUE on error. the input stream target offset determines whether the offset is relative to the beginning or the end of the stream, or to the current location. @input's container the input stream Copy the contents from @input to @output from their respective current positions. So if you want to be sure to copy *everything*, make sure to call gsf_input_seek (input, 0, G_SEEK_SET) and gsf_output_seek (output, 0, G_SEEK_SET) first, if applicable. %TRUE on success a non-null #GsfInput a non-null #GsfOutput Dumps @input's contents to STDOUT, optionally in hex format. a #GsfInput If %TRUE, dump in hexidecmal format Duplicates input @src leaving the new one at the same offset. the duplicate The input to duplicate Are we at the end of the file? %TRUE if the input is at the eof. the input A utility routine that attempts to find the VBA file withint a stream. a GsfInfile #GsfInput A #GDateTime representing when the input was last modified, or %NULL if not known. the input stream The name of the input stream. @input's name in utf8 form, or %NULL if it has no name. the input stream Read at least @num_bytes. Does not change the current position if there is an error. Will only read if the entire amount can be read. Invalidates the buffer associated with previous calls to gsf_input_read. pointer to the buffer or %NULL if there is an error or 0 bytes are requested. the input stream number of bytes to read Pointer to destination memory area Read @num_bytes. Does not change the current position if there is an error. Will only read if the entire amount can be read. the data read. the input stream number of bytes to read copy of @num_bytes the number of bytes left in the file. the input stream Move the current location in the input stream. %TRUE on error. the input stream target offset determines whether the offset is relative to the beginning or the end of the stream, or to the current location. Emulate forward seeks by reading. %TRUE if the emulation failed. stream to emulate seek for absolute position to seek to %TRUE if the assignment was ok. the input stream protected. %TRUE if the assignment was ok. the input stream the new modification time. protected. %TRUE if the assignment was ok. the input stream the new name of the stream protected. %TRUE if the assignment was ok. the input stream the (fs-sys encoded) filename %TRUE if the assignment was ok. the input stream the size of the stream UNIMPLEMENTED BY ANY BACKEND and it is probably unnecessary. gsf_input_get_container provides enough power to do what is necessary. Attempts to open a 'sibling' of @input. The caller is responsible for managing the resulting object. A related #GsfInput The input name. the total number of bytes in the input or -1 on error The input the current offset in the file. the input stream This functions takes ownership of the incoming reference and yields a new one as its output. A stream equivalent to the source stream, but uncompressed if the source was compressed. stream to be uncompressed. The container, optionally %NULL, in which this input lives. %TRUE if the end of the file has been reached. The time the input was last updated. This represents the timestamp from the originating file or @GsfInfile member. It is not supported by all derived classes. The current position in the input. The number of bytes remaining in the file. The total number of bytes in the file. the duplicate The input to duplicate pointer to the buffer or %NULL if there is an error or 0 bytes are requested. the input stream number of bytes to read Pointer to destination memory area %TRUE on error. the input stream target offset determines whether the offset is relative to the beginning or the end of the stream, or to the current location. A related #GsfInput The input name. Adds a reference to @source. a new file or %NULL. The underlying data source. A new #GsfInputGio or %NULL A new #GsfInputGio or %NULL A new #GsfInputGio or %NULL an open HTTP connection, ready for reading. A string containing the URL to retrieve an allocated string containing the Content-Type field of the HTTP response. #GsfInputHTTP an allocated string containing the URL used for input. #GsfInputHTTP A new #GsfInputMemory The input bytes The length of @buf Whether you want this memory to be free'd at object destruction A new #GsfInputMemory The input bytes The length of @buf a new #GsfInputMemory or %NULL. a #GsfInput a new #GsfInputMemory or %NULL. a #GIOChannel. This creates a new proxy to the entire, given input source. See gsf_input_proxy_new_section for details. a new input object. The underlying data source. This creates a new proxy to a section of the given source. The new object will have its own current position, but any operation on it can change the source's position. If a proxy to a proxy is created, the intermediate proxy is short- circuited. This function will ref the source. a new input object. The underlying data source. Offset into source for start of section. Length of section. a new file or %NULL. in utf8. Assumes ownership of @file when succeeding. If @keep_open is true, ownership reverts to caller when the #GsfInput is closed. a new #GsfInput wrapper for @file. Note that if the file is not seekable, this function will make a local copy of the entire file. The filename corresponding to @file. an existing stdio <type>FILE</type> * Should @file be closed when the wrapper is closed <note>This adds a reference to @source.</note> a new file in some combination of ascii and utf8 A utility routine to read things line by line from the underlying source. Trailing newlines and carriage returns are stripped, and the resultant buffer can be edited. the string read, or %NULL on eof. #GsfInputTextline A utility routine to read things line by line from the underlying source. Trailing newlines and carriage returns are stripped, and the resultant buffer can be edited. the string read, or %NULL on eof. #GsfInputTextline Interpret binary data as a double in little endian order. pointer to storage Interpret binary data as a float in little endian order. pointer to storage Interpret binary data as a signed 16-bit integer in little endian order. pointer to storage Interpret binary data as a signed 32-bit integer in little endian order. pointer to storage Interpret binary data as a signed 64-bit integer in little endian order. pointer to storage Interpret binary data as a signed 8-bit integer in little endian order. pointer to storage Interpret binary data as an unsigned 16-bit integer in little endian order. pointer to storage Interpret binary data as an unsigned 32-bit integer in little endian order. pointer to storage Interpret binary data as an unsigned 64-bit integer in little endian order. pointer to storage Interpret binary data as an unsigned 8-bit integer in little endian order. pointer to storage Store @dat in little endian order in memory pointed to by @p. pointer to storage double to be stored Store @dat in little endian order in memory pointed to by @p. pointer to storage float to be stored Store @dat in little endian order in memory pointed to by @p. pointer to storage 16-bit signed integer Store @dat in little endian order in memory pointed to by @p. pointer to storage 32-bit signed integer Store @dat in little endian order in memory pointed to by @p. pointer to storage 64-bit signed integer Store @dat in little endian order in memory pointed to by @p. pointer to storage 8-bit signed integer Store @dat in little endian order in memory pointed to by @p. pointer to storage 16-bit unsigned integer Store @dat in little endian order in memory pointed to by @p. pointer to storage 32-bit unsigned integer Store @dat in little endian order in memory pointed to by @p. pointer to storage 64-bit unsigned integer Store @dat in little endian order in memory pointed to by @p. pointer to storage 8-bit unsigned integer (Integer) Count of bytes in the document. (Unsigned Integer) Identifier representing the case-sensitiveness. <note>of what ?? why is it an integer ??</note> (String) Category of the document. <note>example???</note> (Integer) Count of cells in the spread-sheet document, if appropriate. (Integer) Count of characters in the document. TODO See how to sync this with ODF's document-statistic (UnsignedShort) The MS codepage to encode strings for metadata 1.14.0 Clarified that this is unique from _NAME_CODEPAGE in msole (String) Name of the company/organization that the "CREATOR" entity is associated with. 1.14.1 Moved from "gsf:company" to "dc:publisher". (String) An entity primarily responsible for making the content of the resource typically a person, organization, or service. 1.14.0 Moved from "gsf" to "dc". (Date as ISO String) A date associated with an event in the life cycle of the resource (creation/publication date). Moved from gsf:date-created to meta:creation-date. This way can be used correctly by OpenDocument and Gnumeric. (GsfTimestamp) The last time this document was saved. 1.14.0 Moved from dc:date-modified to dc:date. (String) An account of the content of the resource. (None) Reserved name (PID) for Dictionary (Vector of strings) Names of the 'interesting' parts of the document. In spreadsheets this is a list of the sheet names, and the named expressions. From MSOLE (Date as ISO String) The total-time taken until the last modification. Moved from "gsf" to "meta". This way can be used correctly by OpenDocument and Gnumeric. (String) The application that generated this document. AbiWord, Gnumeric, etc... 1.14.0 Moved from "gsf" to "meta". (Vector of string value pairs stored in alternating elements) Store the counts of objects in the document as names 'worksheet' and count '4' From MSOLE (Integer) Count of hidden-slides in the presentation document. (Integer) Count of images in the document, if appropriate. (String) Specifies the name of the person who created the document initially. 1.14.0 Moved from "gsf" to "meta". (String) Searchable, indexable keywords. Similar to PDF keywords or HTML's meta block. (GsfDocPropVector of String) Searchable, indexable keywords. Similar to PDF keywords or HTML's meta block. (String) The locale language of the intellectual content of the resource (basically xx_YY form for us). 1.14.0 Clarified that this is unique from _NAME_CODEPAGE in msole (GSF_META_NAME_HEADING_PAIRS) The last time this document was printed. 1.14.0 Moved from "gsf" to "dc". 1.14.1 Moved back to "gsf" from "dc". (String) The entity that made the last change to the document, typically a person, organization, or service. (Integer) Count of liness in the document. (Boolean) ??????? (Unsigned Integer) Identifier representing the default system locale. (String) Name of the manager of "CREATOR" entity. (Integer) Count of "multi-media" clips in the document. (Unknown) User-defined name (Unknown) User-defined name (Boolean) User-defined name (Unknown) User-defined name (Unknown) User-defined name (Boolean) User-defined name (i4) User-defined name (Integer) Count of "notes" in the document. (Integer) Count of objects (OLE and other graphics) in the document, if appropriate. (Integer) Count of pages in the document, if appropriate. (Integer) Count of paragraphs in the document, if appropriate. (String) Type of presentation, like "On-screen Show", "SlideView" etc. (String) Specifies the name of the last person who printed the document. 1.14.0 Moved from "gsf" to "meta". (GsfTimestamp) Specifies the date and time when the document was last printed. (Integer) Count of revision on the document, if appropriate. Moved from gsf:revision-count to meta:editing-cycles. This way can be used correctly by OpenDocument and Gnumeric. (Boolean) ????? (Integer) Level of security. <informaltable frame="none" role="params"> <tgroup cols="2"> <thead> <row><entry align="left">Level</entry><entry>Value</entry></row> </thead> <tbody> <row><entry>None</entry><entry>0</entry></row> <row><entry>Password protected</entry><entry>1</entry></row> <row><entry>Read-only recommended</entry><entry>2</entry></row> <row><entry>Read-only enforced</entry><entry>3</entry></row> <row><entry>Locked for annotations</entry><entry>4</entry></row> </tbody></tgroup></informaltable> (Integer) Count of slides in the presentation document. (Integer) Count of pages in the document, if appropriate. (String) The topic of the content of the resource, <emphasis>typically</emphasis> including keywords. (Integer) Count of tables in the document, if appropriate. (String) The template file that is been used to generate this document. 1.14.0 Moved from "gsf" to "meta" (GsfClipData) Thumbnail data of the document, typically a preview image of the document. (String) A formal name given to the resource. (Integer) Count of words in the document. The target of @rel. #GsfOpenPkgRel The type of @rel. #GsfOpenPkgRel %TRUE if @rel has mode 'External' #GsfOpenPkgRel Class representing an output file, counterpart to #GsfInfile. a newly created child A #GsfOutfile The name of the new child to create %TRUE to create a directory, %FALSE to create a plain file a newly created child A #GsfOutfile The name of the new child to create %TRUE to create a directory, %FALSE to create a plain file a newly created child A #GsfOutfile The name of the new child to create %TRUE to create a directory, %FALSE to create a plain file a newly created child A #GsfOutfile The name of the new child to create %TRUE to create a directory, %FALSE to create a plain file A convenience wrapper to create a child in @dir of @content_type then create a @type relation to @parent the new part. #GsfOutfile target name non-%NULL content type #GsfOutfile target type a newly created child A #GsfOutfile The name of the new child to create %TRUE to create a directory, %FALSE to create a plain file Creates the root directory of an MS OLE file and manages the addition of children. <note>This adds a reference to @sink.</note> the new ole file handler. a #GsfOutput to hold the OLE2 file Creates the root directory of an MS OLE file and manages the addition of children. <note>This adds a reference to @sink.</note> the new ole file handler. a #GsfOutput to hold the OLE2 file. size of large blocks. size of small blocks. Write @clsid to the directory associated with @ole. %TRUE on success. a #GsfOutfileMSOle Identifier (often a GUID in MS Windows apps) Convenience routine to create a GsfOutfileOpenPkg inside @sink. a GsfOutfile that the caller is responsible for. #GsfOutfile Add an external relation to @parent. The id of the relation. The string is managed by the parent and should not be changed or freed by the caller. #GsfOutfileOpenPkg target type target content Create a relationship between @child and @parent of @type. the relID which the caller does not own but will live as long as @parent. #GsfOutfileOpenPkg #GsfOutfileOpenPkg target type #GsfOutfileOpenPkg Assigns a GsfOutput (@sink) to store the package into. #GsfOutfileOpenPkg #GsfOutput a new outfile or %NULL. root directory in utf8. a new outfile or %NULL. root directory in utf8. place to store a #GError if anything goes wrong name of first property to set value of first property, followed by more properties, %NULL-terminated a new outfile or %NULL. root directory in utf8. place to store a #GError if anything goes wrong name of first property to set a %NULL-terminated #va_list Creates the root directory of a Zip file and manages the addition of children. <note>This adds a reference to @sink.</note> the new zip file handler a #GsfOutput to hold the ZIP file Class representing an output stream, counterpart to #GsfInput. %TRUE if the unwrapping succeeded. %TRUE if the wrapping succeeded. Close a stream. %FALSE on error #GsfOutput Reposition in output stream @output. @whence specifies what the offset is relative to: the beginning of the stream (%G_SEEK_SET), current position in the stream (%G_SEEK_CUR) or the end of the stream (%G_SEEK_END). This function is similar to <citerefentry><refentrytitle>fseek</refentrytitle> <manvolnum>3</manvolnum></citerefentry>. %FALSE on error. #GsfOutput Relative amount to reposition What the offset is relative to. Output @args to @output using the format string @format, similar to <citerefentry><refentrytitle>vprintf</refentrytitle> <manvolnum>3</manvolnum></citerefentry>. number of bytes printed, a negative value if not successful A #GsfOutput The printf-style format string the arguments for @format Write @num_bytes of @data to @output. %FALSE on error. Output stream Number of bytes to write Data to write. Close a stream. %FALSE on error #GsfOutput @output's container the last error logged on the output A #GDateTime representing when the output was last modified the output stream %TRUE if @output has already been closed. #GsfOutput Give the name of @output. @output's name in utf8 form. #GsfOutput Output @Varargs to @output using the format string @format, similar to <citerefentry><refentrytitle>printf</refentrytitle> <manvolnum>3</manvolnum></citerefentry>. %TRUE if successful, %FALSE if not A #GsfOutput The printf-style format string the arguments for @format Like fputs, this assumes that the line already ends with a newline %TRUE if successful, %FALSE if not A #GsfOutput Nul terminated string to write Reposition in output stream @output. @whence specifies what the offset is relative to: the beginning of the stream (%G_SEEK_SET), current position in the stream (%G_SEEK_CUR) or the end of the stream (%G_SEEK_END). This function is similar to <citerefentry><refentrytitle>fseek</refentrytitle> <manvolnum>3</manvolnum></citerefentry>. %FALSE on error. #GsfOutput Relative amount to reposition What the offset is relative to. <note>This is a utility routine that should only be used by derived outputs.</note> %TRUE if the assignment was ok. #GsfOutput #GsfOutfile <note>This is a utility routine that should only be used by derived outputs.</note> Always returns %FALSE to facilitate its use. #GsfOutput The error id printf style format string arguments for @format %TRUE if the assignment was ok. the output stream the new modification time. <note>This is a utility routine that should only be used by derived outputs.</note> %TRUE if the assignment was ok. #GsfOutput the new name <note>This is a utility routine that should only be used by derived outputs.</note> %TRUE if the assignment was ok. the output stream the (fs-sys encoded) filename Determine the size of the output stream @output. the size of the output, or -1 if it does not have a size. #GsfOutput Tell the current position in @output, similar to <citerefentry><refentrytitle>ftell</refentrytitle> <manvolnum>3</manvolnum></citerefentry>. the current position in the file #GsfOutput Output @args to @output using the format string @format, similar to <citerefentry><refentrytitle>vprintf</refentrytitle> <manvolnum>3</manvolnum></citerefentry>. number of bytes printed, a negative value if not successful A #GsfOutput The printf-style format string the arguments for @format Write @num_bytes of @data to @output. %FALSE on error. Output stream Number of bytes to write Data to write. The container, optionally %NULL, in which this output lives. %TRUE if the output has been closed. The time the output was last updated. This must be set on object construction and represents the timestamp to put on the resulting file or #GsfOutfile member. Not all derived classes will actually do anything with this property. The current position in the output. The current file size. Adds a reference to @sink. a new file or %NULL. The underlying data source. %FALSE on error #GsfOutput %FALSE on error. #GsfOutput Relative amount to reposition What the offset is relative to. %FALSE on error. Output stream Number of bytes to write Data to write. number of bytes printed, a negative value if not successful A #GsfOutput The printf-style format string the arguments for @format Controls when to add quotes around fields. never add quotes around fields add quotes around fields when needed always add quotes around fields Adds a reference to @sink. a new file or %NULL. The underlying data source. A new #GsfOutputGio or %NULL an existing GFile A new #GsfOutputGio or %NULL A new #GsfOutputGio or %NULL a new file or %NULL. A #GIOChannel Adds a reference to @sink. a new GsfOutput object or %NULL. The underlying data source. The target character set. The source character set. Either NULL or a UTF-8 string (representable in the target encoding) to convert and output in place of characters that cannot be represented in the target encoding. NULL means use \u1234 or \U12345678 format. a new file. The data that has been written to @mem the output device. a new file or %NULL. name of file to create or replace. Assumes ownership of @file. If @keep_open is true, ownership reverts to caller when the GsfOutput is closed. a new GsfOutput wrapper for @file. Warning: the result will be seekable only if @file is seekable. If it is seekable, the resulting GsfOutput object will seek relative to @file's beginning, not its current location at the time the GsfOutput object is created. The filename corresponding to @file. an existing stdio <type>FILE</type> * Should @file be closed when the wrapper is closed a new file or %NULL. name of file to create or replace. place to store a #GError if anything goes wrong %NULL terminated list of properties Create a tree of binary blobs with unknown content from a #GsfInput or #GsfInfile and store it in a newly created #GsfStructuredBlob. a new #GsfStructuredBlob object which the caller is responsible for. An input (potentially a GsfInfile) holding the blob Dumps structured blob @blob onto the @container. Will fail if the output is not an Outfile and blob has multiple streams. %TRUE on success. #GsfStructuredBlob #GsfOutfile A point in time. #GDate in local timezone #glong number of seconds since @date. possibly blank #GString of the timezone as from mktime. Produce a string representation (ISO 8601 format) of @stamp. a string representation of @stamp. When @stamp is %NULL, the representation is "&lt;invalid&gt;". timestamp to be converted. Copies a timestamp. a separate copy of @stamp. timestamp to be copied Compare timestamps @a and @b. true if @a and @b represent the same point in time; false otherwise. a timestamp another timestamp Releases the memory in use for @stamp (if any). timestamp to be freed Very simple parser for time stamps. Currently requires a format of 'YYYY-MM-DDThh:mm:ss' and does only rudimentary range checking %TRUE on success #GsfTimestamp The string to parse Calls g_value_set_box (value, stamp); #GsfTimestamp #GValue Controls the handling of character data within a parser node. node has no cstr contents node has cstr contents node has contents that is shared with children node is second or later occurrence user data the current node content #GsfXMLInDoc current node (not on the stack) According to @state is @str in the namespace @ns_id ? a pointer to @str after the namespace if successful, otherwise %NULL. #GsfXMLIn string to check the namespace id (New in 1.14.2) (but does not reference) the stream being parsed. #GsfXMLIn Checks to see if @str is the same as @ns_id::@name with either an explicit namespace or the current default namespace. %TRUE if @str == @ns_id:@name according to @state. The #GsfXMLIn we are reading from. The potentially namespace qualified node name. The name space id to check The target node name Take the first node from @doc as the current node and call its start handler. #GsfXMLIn #GsfXMLInDoc arbitrary content for the parser #GsfXMLInExtDtor array of xmlChar const * (New in 1.14.33) This provides a means to silently ignore unknown tags in contexts where they are expected. #GsfXMLIn whether to be silent about unknown tags Combine the nodes in the %NULL terminated array starting at @nodes with the name spaces in the %NULL terminated array starting at @ns. Prepare the data structures necessary to validate a doument based on that description. a #GsfXMLInDoc an array of node descriptors an array of namespace identifiers Adds additional nodes to the structure of @doc #GsfXMLInDoc %NULL terminated array of #GsfXMLInNode Free up resources #GsfXMLInDoc Read an xml document from @input and parse based on the the descriptor in @doc %FALSE on error #GsfXMLInDoc #GsfInput arbitrary content stored in the parser Call the function @handler when an unexpected child node is found #GsfXMLInDoc The function to call URI identifier unique in the entire tree namespace identifier node name parent node identifier whether the node has content whether to check namespace for children whether to share children with parent. Create an XML output stream. #GsfXMLOut #GsfOutput Dump @len bytes in @data into the content of node @id using base64 #GsfXMLOut tag id, or %NULL for node content Data to be written Length of data dump boolean value @val to an attribute named @id or as the nodes content Use '1' or '0' to simplify import #GsfXMLOut tag id, or %NULL for node content a boolean dump Color @r.@g.@b to an attribute named @id or as the nodes content #GsfXMLOut tag id, or %NULL for node content Red value Green value Blue value dump @val_utf8 to an attribute named @id or as the nodes content escaping characters as necessary. If @val_utf8 is %NULL do nothing (no warning, no output) #GsfXMLOut tag id, or %NULL for node content a utf8 encoded string dump @val_utf8 to an attribute named @id without checking to see if the content needs escaping. A useful performance enhancement when the application knows that structure of the content well. If @val_utf8 is %NULL do nothing (no warning, no output) #GsfXMLOut tag id, or %NULL for node content a utf8 encoded string to export Output the name of value @val of enumeration type @etype. #GsfXMLOut tag id, or %NULL for node content #GType enum element number dump float value @val to an attribute named @id or as the nodes content with precision @precision. The number will be formattted according to the "C" locale. #GsfXMLOut tag id, or %NULL for node content the value the number of significant digits to use, -1 meaning "enough". Output the value of @val as a string. Does NOT store any type information with the string, just thevalue. #GsfXMLOut tag id, or %NULL for node content #GValue dump integer value @val to an attribute named @id or as the nodes content #GsfXMLOut tag id, or %NULL for node content the value dump unsigned integer value @val to an attribute named @id or as the nodes content #GsfXMLOut tag id, or %NULL for node content the value Closes/ends an XML element. the element that has been closed. #GsfXMLOut Get the #GsfOutput we are writing to.. #GsfInput #GsfXMLOut the current state of the pretty-print flag. Note, that gsf_xml_out_set_pretty_print will return the same value. #GsfXMLOut Store some optional &lt;!DOCTYPE .. &gt; content #GsfXMLOut the document type declaration the previous state of the pretty-print flag. #GsfXMLOut new state of pretty-print flag. Convenience routine to output a simple @id element with content @content. #GsfXMLOut Element name Content of the element Convenience routine to output an element @id with float value @val using @precision significant digits. #GsfXMLOut Element name Element value the number of significant digits to use, -1 meaning "enough". Convenience routine to output an element @id with integer value @val. #GsfXMLOut Element name Element value Output a start element @id, if necessary preceeded by an XML declaration. #GsfXMLOut Element name Decodes a chunk of base64 encoded data from @data back into @data. the number of bytes converted data stream max length of data to decode Decodes a chunk of base64 encoded data the number of bytes converted input stream max length of data to decode output stream holds the number of bits that are stored in @save leftover bits that have not yet been decoded This funcion should be called to when finished encoding everything, to flush off the last little bit. a count of the number of bytes in the final block. Data to be encoded Length of data to be encoded Whether to use line breaks Encoded data. holds the number of bits that are stored in @save leftover bits that have not yet been decoded Encodes data from @data back into @data using base64 encoding. the number of bytes encoded data stream max length of data to encode Performs an 'encode step', only encodes blocks of 3 characters from @in into the output @out at a time, saves left-over state in @state and @save (initialise to 0 on first invocation). the number of bytes encoded input stream max length of data to decode Whether to use line breaks output stream holds the number of bits that are stored in @save leftover bits that have not yet been decoded A debugging utility to dump the content of @meta via g_print #GsfDocMetaData the #GQuark used to identify libgsf errors in #GError structures. Specific error codes come from the #GsfError enumeration. Extracts the extension from the end of a filename (the part after the final '.' in the filename). A pointer to the extension part of the filename, or a pointer to the end of the string if the filename does not have an extension. A filename or file path. A utility wrapper to make sure filenames are valid utf8. Caller must g_free the result. @filename using utf-8 encoding for display file name suitable for open(2). if %TRUE, the resulting utf8 file name will be quoted (unless it is invalid). A utility wrapper to safely close an iconv handle. handle to be closed. Initializes the GSF library Initializes the GSF library and associates it with a type module @mod. #GTypeModule. Interpret binary data as a double in little endian order. interpreted data pointer to storage Interpret binary data as a float in little endian order. interpreted data pointer to storage Interpret binary data as a guint64 (8 byte unsigned integer type) in little endian order. interpreted data pointer to storage Store a value of type double in memory in little endian order pointer to storage double to be stored Store a value of type float in memory in little endian order. pointer to storage float to be stored Dump @len bytes from the memory location given by @ptr. memory area to be dumped. how many bytes will be dumped. NOTE: skipped since GIConv is not exported to introspection. an iconv converter to go from utf8 -> to our best guess at a useful windows codepage. the target code page. NOTE: skipped since GIConv is not exported to introspection. an iconv converter for @codepage -> utf8. the target encoding. the source code page. NOTE: skipped since GIConv is not exported to introspection. an iconv converter to go from utf8 -> to our best guess at a useful windows codepage. the target code page. the source encoding. NOTE: skipped since GIConv is not exported to introspection. an iconv convert to go from utf8 -> to our best guess at a useful windows codepage. NOTE: skipped since GIConv is not exported to introspection. an iconv converter for single byte encodings @codepage -> utf8. Attempt to handle the semantics of a specification for multibyte encodings since this is only supposed to be used for single bytes. the source code page. our best guess at the applicable windows code page based on an environment variable or the current locale. Decompresses an LZ compressed stream. A GByteArray that the caller is responsible for freeing stream to read from offset into it for start byte of compresse stream the xx_YY style string (can be just xx or xxx) for the given LID. If the LID is not found, is set to 0x0400, or is set to 0x0000, will return "-none-" numerical language id the LID (Language Identifier) for the input language. If lang is %NULL, return 0x0400 ("-none-"), and not 0x0000 ("no proofing") Language id, i.e., locale name. our best guess at the codepage for the given language id numerical language id the Iconv codepage string for the given LID. numerical language id the used ODF namespace Gives the ODF version used by libgsf when writing Open Document files. the ODF version: 102. Gives the ODF version used by libgsf when writing Open Document files. the ODF version as a string: "1.2". New in 1.14.9 Walks each relationship associated with @opkg and calls @func with @user_data. #GsfInput #GsfOpenPkgIter gpointer New in 1.14.6 Finds @opkg's relation with @id NOTE: skipping because gsf_open_pkg_rel_get_type() does not return a GType. A #GsfOpenPkgRel or %NULL #GsfInput identifier. New in 1.14.6 Finds _a_ relation of @opkg with @type (no order is guaranteed) NOTE: skipping because gsf_open_pkg_rel_get_type() does not return a GType. A #GsfOpenPkgRel or %NULL #GsfInput target a new #GsfInput which the called needs to unref, or %NULL and sets @err #GsfInput #GsfOpenPkgRel New in 1.14.7 Open @opkg's relation @id A new GsfInput or %NULL, and sets @err if possible. #GsfInput target id New in 1.14.9 Open one of @opkg's relationships with type=@type. A new GsfInput or %NULL, and sets @err if possible. #GsfInput target type Convenience function to parse a related part. %NULL on success or a #GError on failure. #GsfXMLIn target id #GsfXMLInNode #GsfXMLInNS This function builds a GParameter array suitable for g_object_newv. the GType for which the properties are being set. a pointer to the GParameter array that holds the properties. (Used for both input and output. This may point to a %NULL pointer if there are no properties collected yet.) a pointer to the number of properties collected. (Used for both input and output.) the name of the first property being set, or %NULL. a va_list holding the remainder of the property names and values, terminated by a %NULL. De-intializes the GSF library Currently does nothing. De-intializes the GSF library from a type module. Currently does nothing. currently unused This function returns a pointer to the GsfDocPropVector structure in @value. No additional references are created. A pointer to the #GsfDocPropVector structure in @value A GValue of type #GsfDocPropVector. Decompresses VBA stream. A pointer to guint8 array stream to read from offset into it for start byte of compressed stream size of the returned array whenever add or not null at the end of array Dumps the document @cur into @output. status from xmlSaveFormatFileTo. #GsfOutput #xmlDocPtr The encoding to use. %TRUE to reformat the output. Try to parse @str as a value of type @t into @res. True when parsing of @str as a value of type @t was succesfull; false otherwise. Result value Type of data Value string Create a libxml2 pull style parser context wrapper around gsf input @input. This signature will probably change to supply a SAX structure. <note>This adds a reference to @input.</note> <note>A simple wrapper around a cleaner implementation that will fold in when we add other api changes. Its not worth bumping just for this.</note> NOTE: skipped since xmlParserCtxt is not exported to introspection. A parser context #GsfInput TRUE on success. #GsfInput #GsfXMLProbeFunc