File: gettext.info,  Node: po_filepos_t API,  Next: Format Type API,  Prev: PO Header Entry API,  Up: libgettextpo

10.13.6 po_filepos_t API
------------------------

 -- Data Type: po_filepos_t
     This is a pointer type that refers to a string's position within a
     source file.

   The following functions provide an interface to extract and
manipulate these references.

 -- Function: po_filepos_t po_message_filepos (po_message_t MESSAGE,
          int INDEX)
     Returns the file reference in position INDEX from the message.  If
     INDEX is out of range, returns ‘NULL’.

 -- Function: void po_message_remove_filepos (po_message_t MESSAGE,
          int INDEX)
     Removes the file reference in position INDEX from the message.  It
     moves all references following INDEX one position backwards.

 -- Function: void po_message_add_filepos (po_message_t MESSAGE,
          const char *FILE, size_t START_LINE)
     Adds a reference to the string from FILE starting at START_LINE, if
     it is not already present for the message.  The value
     ‘(size_t)(-1)’ for START_LINE denotes that the line number is not
     available.