C API Reference
===============

The C API is a drop-in replacement for GNU gettext's ``<libintl.h>``.
Link with ``-lintl`` (shared) or ``-lintl_static`` (static).

Domain Management
-----------------

.. doxygenfunction:: textdomain
.. doxygenfunction:: bindtextdomain
.. doxygenfunction:: bind_textdomain_codeset

Translation Lookup
------------------

.. doxygenfunction:: gettext
.. doxygenfunction:: dgettext
.. doxygenfunction:: dcgettext
.. doxygenfunction:: ngettext
.. doxygenfunction:: dngettext
.. doxygenfunction:: dcngettext

Context-Qualified Lookups
-------------------------

.. doxygenfunction:: dcpgettext_expr
.. doxygenfunction:: dcnpgettext_expr

In C, convenience macros are also provided:

- ``pgettext(msgctxt, msgid)``
- ``dpgettext(domain, msgctxt, msgid)``
- ``npgettext(msgctxt, msgid1, msgid2, n)``
- ``dnpgettext(domain, msgctxt, msgid1, msgid2, n)``