gettext: po_filepos_t API

 
 9.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.