Function

GLibdpgettext

Declaration

const gchar*
g_dpgettext (
  const gchar* domain,
  const gchar* msgctxtid,
  gsize msgidoffset
)

Description

This function is a variant of g_dgettext() which supports a disambiguating message context. GNU gettext uses the ‘\004’ character to separate the message context and message id in msgctxtid. If 0 is passed as msgidoffset, this function will fall back to trying to use the deprecated convention of using “|” as a separation character.

This uses g_dgettext() internally. See that functions for differences with dgettext() proper.

Applications should normally not use this function directly, but use the C_() macro for translations with context.

Available since:2.16

Parameters

domain const gchar*
 

The translation domain to use, or NULL to use the domain set with textdomain()

 The argument can be NULL.
 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
msgctxtid const gchar*
 

A combined message context and message id, separated by a \004 character.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
msgidoffset gsize
 

The offset of the message id in msgctxid.

Return value

Returns: utf8
 

The translated string.

 The data is owned by the called function.
 The string is a NUL terminated UTF-8 string.