gettext: po_message_iterator_t API
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.