Internationalization of Strings using gettext library

Redefined classes

redef extern class CString

gettext :: gettext $ CString

C string char *
redef abstract class String

gettext :: gettext $ String

Immutable sequence of characters.
redef class Sys

gettext :: gettext $ Sys

The main class of the program.

All class definitions

redef extern class CString

gettext :: gettext $ CString

C string char *
redef abstract class String

gettext :: gettext $ String

Immutable sequence of characters.
redef class Sys

gettext :: gettext $ Sys

The main class of the program.
package_diagram gettext::gettext gettext core core gettext::gettext->core gettext::langannot langannot gettext::langannot->gettext::gettext a_star-m a_star-m a_star-m->gettext::langannot a_star-m... ... a_star-m...->a_star-m

Ancestors

module abstract_collection

core :: abstract_collection

Abstract collection classes and services.
module abstract_text

core :: abstract_text

Abstract class for manipulation of sequences of characters
module array

core :: array

This module introduces the standard array structure.
module bitset

core :: bitset

Services to handle BitSet
module bytes

core :: bytes

Services for byte streams and arrays
module circular_array

core :: circular_array

Efficient data structure to access both end of the sequence.
module codec_base

core :: codec_base

Base for codecs to use with streams
module codecs

core :: codecs

Group module for all codec-related manipulations
module collection

core :: collection

This module define several collection classes.
module environ

core :: environ

Access to the environment variables of the process
module error

core :: error

Standard error-management infrastructure.
module exec

core :: exec

Invocation and management of operating system sub-processes.
module file

core :: file

File manipulations (create, read, write, etc.)
module fixed_ints

core :: fixed_ints

Basic integers of fixed-precision
module fixed_ints_text

core :: fixed_ints_text

Text services to complement fixed_ints
module flat

core :: flat

All the array-based text representations
module gc

core :: gc

Access to the Nit internal garbage collection mechanism
module hash_collection

core :: hash_collection

Introduce HashMap and HashSet.
module iso8859_1

core :: iso8859_1

Codec for ISO8859-1 I/O
module kernel

core :: kernel

Most basic classes and methods.
module list

core :: list

This module handle double linked lists
module math

core :: math

Mathematical operations
module native

core :: native

Native structures for text and bytes
module numeric

core :: numeric

Advanced services for Numeric types
module protocol

core :: protocol

module queue

core :: queue

Queuing data structures and wrappers
module range

core :: range

Module for range of discrete objects.
module re

core :: re

Regular expression support for all services based on Pattern
module ropes

core :: ropes

Tree-based representation of a String.
module sorter

core :: sorter

This module contains classes used to compare things and sorts arrays.
module stream

core :: stream

Input and output streams of characters
module text

core :: text

All the classes and methods related to the manipulation of text entities
module time

core :: time

Management of time and dates
module union_find

core :: union_find

union–find algorithm using an efficient disjoint-set data structure
module utf8

core :: utf8

Codec for UTF-8 I/O

Parents

module core

core :: core

Standard classes and methods used by default by Nit programs and libraries.

Children

module langannot

gettext :: langannot

Sample module showing the use of the i18n annotation

Descendants

module a_star-m

a_star-m

# Internationalization of Strings using `gettext` library
module gettext is
	new_annotation i18n
end

in "C" `{
	#include <libintl.h>
	#include <locale.h>
`}

redef class Sys
	redef fun run do
		"".to_cstring.set_locale
		super
	end
end

redef class CString
	# Sets the locale of the program running
	#
	# This can be set at different times in the program,
	# if used with an empty string, the locale will
	# be set to the user's environment locale.
	#
	# For more info, SEE setlocale manual
	fun set_locale `{
		setlocale(LC_ALL, self);
	`}
end

redef class String
	# Gets the translation of `self` via gettext from `dir` using `domain`
	#
	# `domain`: Gettext domain, i.e. file/module name
	# `dir`: Where the locale/LC_MESSAGES folder for this domain is located
	fun get_translation(domain, dir: String): String do
		bindtextdomain(domain, dir)
		return dgettext(domain)
	end

	# Gettext `gettext`, SEE gettext manual for further info
	fun gettext: String
	import String.to_cstring, CString.to_s `{
		return CString_to_s(gettext(String_to_cstring(self)));
	`}

	# Gettext `dgettext`, SEE gettext manual for further info
	fun dgettext(domain: String): String
	import String.to_cstring, CString.to_s `{
		return CString_to_s(dgettext(String_to_cstring(domain), String_to_cstring(self)));
	`}
end

# Gettext `bindtextdomain`, SEE gettext manual for further info
fun bindtextdomain(domain, dir: String) import String.to_cstring `{
	bindtextdomain(String_to_cstring(domain), String_to_cstring(dir));
`}

# Gettext `textdomain`, SEE gettext manual for further info
fun textdomain(domain: String) import String.to_cstring `{
	textdomain(String_to_cstring(domain));
`}
lib/gettext/gettext.nit:15,1--76,2