File: gettext.info,  Node: po_file_t API,  Next: po_message_iterator_t API,  Prev: Error Handling,  Up: libgettextpo

10.13.2 po_file_t API
---------------------

 -- Data Type: po_file_t
     This is a pointer type that refers to the contents of a PO file,
     after it has been read into memory.

 -- Function: po_file_t po_file_create ()
     The ‘po_file_create’ function creates an empty PO file
     representation in memory.

 -- Function: po_file_t po_file_read (const char *FILENAME,
          struct po_xerror_handler *HANDLER)
     The ‘po_file_read’ function reads a PO file into memory.  The file
     name is given as argument.  The return value is a handle to the PO
     file's contents, valid until ‘po_file_free’ is called on it.  In
     case of error, the functions from HANDLER are called to signal it.

     This function is exported as ‘po_file_read_v3’ at ABI level, but is
     defined as ‘po_file_read’ in C code after the inclusion of
     ‘’.

 -- Function: po_file_t po_file_write (po_file_t FILE,
          const char *FILENAME, struct po_xerror_handler *HANDLER)
     The ‘po_file_write’ function writes the contents of the memory
     structure FILE the FILENAME given.  The return value is FILE after
     a successful operation.  In case of error, the functions from
     HANDLER are called to signal it.

     This function is exported as ‘po_file_write_v2’ at ABI level, but
     is defined as ‘po_file_write’ in C code after the inclusion of
     ‘’.

 -- Function: void po_file_free (po_file_t FILE)
     The ‘po_file_free’ function frees a PO file's contents from memory,
     including all messages that are only implicitly accessible through
     iterators.

 -- Function: const char * const * po_file_domains (po_file_t FILE)
     The ‘po_file_domains’ function returns the domains for which the
     given PO file has messages.  The return value is a ‘NULL’
     terminated array which is valid as long as the FILE handle is
     valid.  For PO files which contain no ‘domain’ directive, the
     return value contains only one domain, namely the default domain
     ‘"messages"’.