Function

AppStreamComposeTranslateDesktopTextFn

Declaration

GPtrArray*
(* AscTranslateDesktopTextFn) (
  const GKeyFile* de,
  const gchar* text,
  gpointer user_data
)

Description [src]

Function which is called while parsing a desktop-entry file to allow external translations of string values. This is used in e.g. the Ubuntu distribution.

The return value must contain a list of strings with the locale name in even indices, and the text translated to the preceding locale in the following odd indices.

This function is not directly available to language bindings.

Parameters

de

Type: GKeyFile

A pointer to the desktop-entry data we are reading.

The data is owned by the caller of the function.

text

Type: const gchar*

The string to translate.

The data is owned by the caller of the function.

The value is a NUL terminated UTF-8 string.

user_data

Type: gpointer

Additional data.

The argument can be NULL.

The data is owned by the caller of the function.

Return value

Type: An array of gpointer

A new GPtrArray containing the translation mapping.

The caller of the function takes ownership of the data, and is responsible for freeing it.