Next: Format Type API, Previous: PO Header Entry API, Up: Writing your own programs that process PO files [Contents][Index]
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.
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.
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.
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.