Atmel CAVR-4 Manual De Usuario

CAVR-4

Locale

Reference Guide

Note: If you use multibyte characters in your C or assembler source code, make sure 
that you select the correct locale symbol (the local host locale).

The locale interface is not included if the configuration symbol 

_DLIB_FULL_LOCALE_SUPPORT

 is set to 0 (zero). This means that a hardwired locale 

is used—by default the standard C locale—but you can choose one of the supported 
locale configuration symbols. The 

setlocale

 function is not available and can 

therefore not be used for changing locales at runtime.

Support for the locale interface is obtained if the configuration symbol 

_DLIB_FULL_LOCALE_SUPPORT

 is set to 1. By default, the standard C locale is used, 

but you can define as many configuration symbols as required. Because the 

setlocale

 

function will be available in your application, it will be possible to switch locales at 
runtime.

The standard library function 

setlocale

 is used for selecting the appropriate portion 

of the application’s locale when the application is running.

The 

setlocale

 function takes two arguments. The first one is a locale category that is 

constructed after the pattern 

LC_CATEGORY

. The second argument is a string that 

describes the locale. It can either be a string previously returned by 

setlocale

, or it 

can be a string constructed after the pattern:

or

The 

 part specifies the language code, and the 

 part specifies a region 

qualifier, and 

 specifies the multibyte encoding that should be used.

The 

 part matches the 

_LOCALE_USE_LANG

_

 preprocessor 

symbols that can be specified in the library configuration file.

This example sets the locale configuration symbols to Swedish to be used in Finland and 

UTF8

 multibyte encoding:

setlocale (LC_ALL, "sv_FI.Utf8");