Gettext/po 005ffilepos 005ft-API

Next: Format Type API, Previous: PO Header Entry API, Up: libgettextpo   [Contents][Index]

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.