Skip to main content

IAR Embedded Workbench for RX 5.20

J.4 Locale

In this section:
Members of the source and execution character set (5.2.1)

By default, the compiler accepts all one-byte characters in the host’s default character set. The chapter Encodings describes how to change the default encoding for the source character set, and by that the encoding for plain character constants and plain string literals in the execution character set.

The meaning of the additional characters (5.2.1.2)

Any multibyte characters in the extended source character set is translated into the following encoding for the execution character set:

Execution character set

Encoding

L typed

UTF-32

u typed

UTF-16

U typed

UTF-32

u8 typed

UTF-8

none typed

The same as the source character set

Table 105. Translation of multibyte characters in the extended source character set


It is up to your application with the support of the library configuration to handle the characters correctly.

Shift states for encoding multibyte characters (5.2.1.2)

No shift states are supported.

Direction of successive printing characters (5.2.2)

The application defines the characteristics of a display device.

The decimal point character (7.1.1)

For a library with the configuration Normal or Tiny, the default decimal-point character is a '.'. For a library with the configuration Full, the chosen locale defines what character is used for the decimal point.

Printing characters (7.4, 7.30.2)

The set of printing characters is determined by the chosen locale.

Control characters (7.4, 7.30.2)

The set of control characters is determined by the chosen locale.

Characters tested for (7.4.1.2, 7.4.1.3, 7.4.1.7, 7.4.1.9, 7.4.1.10, 7.4.1.11, 7.30.2.1.2, 7.30.5.1.3, 7.30.2.1.7, 7.30.2.1.9, 7.30.2.1.10, 7.30.2.1.11)

The set of characters tested for the character-based functions are determined by the chosen locale. The set of characters tested for the wchar_t-based functions are the UTF-32 code points 0x0 to 0x7F.

The native environment (7.11.1.1)

The native environment is the same as the "C" locale.

Subject sequences for numeric conversion functions (7.22.1, 7.29.4.1)

There are no additional subject sequences that can be accepted by the numeric conversion functions.

The collation of the execution character set (7.24.4.3, 7.29.4.4.2)

Collation is not supported.

Message returned by strerror (7.24.6.2)

The messages returned by the strerror function depending on the argument is:

Argument

Message

EZERO

no error

EDOM

domain error

ERANGE

range error

EFPOS

filepositioningerror

EILSEQ

multi-byteencodingerror

<0 || >99

unknown error

all others

error nnn

Table 106. Message returned by strerror()—DLIB runtime environment 


Formats for time and date (7.27.3.5, 7.29.5.1)

Time zone information is as you have implemented it in the low-level function __getzone.

Character mappings (7.30.1)

The character mappings supported are tolower and toupper.

Character classifications (7.30.1)

The character classifications that are supported are alnum, cntrl, digit, graph, lower, print, punct, space, upper, and xdigit.