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.