Gettext/po 005fmessage 005fiterator 005ft-API

Next: po_message_t API, Previous: po_file_t API, Up: libgettextpo   [Contents][Index]

9.13.3 po_message_iterator_t API

Data Type

po_message_iterator_t

This is a pointer type that refers to an iterator that produces a sequence of messages.

Function

po_message_iterator_t po_message_iterator (po_file_t file, const char *domain)

The po_message_iterator returns an iterator that will produce the messages of file that belong to the given domain. If domain is NULL, the default domain is used instead. To list the messages, use the function po_next_message repeatedly.

Function

void po_message_iterator_free (po_message_iterator_t iterator)

The po_message_iterator_free function frees an iterator previously allocated through the po_message_iterator function.

Function

po_message_t po_next_message (po_message_iterator_t iterator)

The po_next_message function returns the next message from iterator and advances the iterator. It returns NULL when the iterator has reached the end of its message list.