Python Library Reference

Previous: 21.2.2 For extension writers Up: 21.2 locale Next: 22. Program Frameworks

---

21.2.3 Access to message catalogs

The locale module exposes the C library's gettext interface on systems that provide this interface. It consists of the functions gettext(), dgettext(), dcgettext(), textdomain(), bindtextdomain(), and bind_textdomain_codeset(). These are similar to the same functions in the gettext module, but use the C library's binary format for message catalogs, and the C library's search algorithms for locating message catalogs.

Python applications should normally find no need to invoke these functions, and should use gettext instead. A known exception to this rule are applications that link use additional C libraries which internally invoke gettext() or dcgettext(). For these applications, it may be necessary to bind the text domain, so that the libraries can properly locate their message catalogs.

---

Python Library Reference

Previous: 21.2.2 For extension writers Up: 21.2 locale Next: 22. Program Frameworks

---

Release 2.5.2, documentation updated on 21th February, 2008.