mme_setlocale()

Set the preferred language for media with unknown language

Synopsis:

#include <mme/mme.h>

int mme_setlocale ( mme_hdl_t *hdl,
                    const char *locale );


Arguments:

hdl
An MME connection handle.
locale
The locale code to set. This is a string containing a 5-character language and region code. This string consists of a 2-character ISO639-1 language code, followed by a “_” character, followed by a 2-character ISO3166-1 alpha-2 region code. See http://www.loc.gov/standards/iso639-2/php/code_list.php.

Library:

mme

Description:

The function mme_setlocale() sets the preferred language for displaying:

The requested language must exist in the database, and the languages table must be populated with the appropriate text strings.

This function doesn't set the preferred language for media playback. To specify that setting, use mme_media_set_def_lang().


Note: The current MME implementation uses only the first two characters to extract the language. In the future, this function may set the language used in strings where language sets are available, causing a re-ordering of database tables that are lexicographically collated.

Events

None delivered.

Blocking and validation

This function is fully validating and runs to completion.

Returns:

0
Success.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_getlocale(), mme_media_get_def_lang(), mme_media_set_def_lang()