 RealView Libraries and Floating Point Support Guide | |
| Home Products Events Support | |
On-Line Manuals
RealView Libraries and Floating Point Support Guide
Preface Introduction The C and C++ Libraries About the C and C++ libraries
Features of the C and C++ libraries Namespaces Writing reentrant and thread‑safe code Introduction to reentrancy and thread‑safety Use of static data in the C libraries The __user_libspace static data area Managing locks in multithreaded applications Using the ARM C libraries with a multithreaded app Thread‑safety in the ARM C libraries Thread‑safety in the ARM C++ libraries Building an application with the C library Using the libraries with an application Building an application for a semihosted environme Building an application for a non semihosting envi Building an application without the C library Integer and FP helper functions Bare machine integer C Bare machine C with floating‑point Exploiting the C library The standalone C library functions Tailoring the C library to a new execution environ How C and C++ programs use the library functions __rt_entry Exiting from the program __rt_exit() __rt_lib_init() __rt_lib_shutdown() Tailoring static data access Tailoring locale and CTYPE using assembler macros Selecting locale at link time Selecting locale at runtime Defining a locale block LC_CTYPE data block LC_COLLATE data block LC_MONETARY data block LC_NUMERIC data block LC_TIME data block _get_lconv() localeconv() setlocale() _findlocale() The lconv structure Tailoring locale and CTYPE using C macros Selecting locale at link time Selecting locale at runtime Macros and utility functions _get_lc_ctype() _get_lc_collate() _get_lc_monetary() _get_lc_numeric() _get_lc_time() _get_lconv() localeconv() setlocale() _findlocale() __LC_CTYPE_DEF __LC_COLLATE_DEF __LC_TIME_DEF __LC_NUMERIC_DEF __LC_MONETARY_DEF __LC_INDEX_END The lconv structure Tailoring error signaling, error handling, and pro _sys_exit() errno __rt_errno_addr() __raise() __rt_raise() __default_signal_handler() _ttywrch() __rt_fp_status_addr() Tailoring storage management Avoiding the ARM‑supplied heap and heap‑using Support for malloc Tailoring the runtime memory model The memory models Controlling the runtime memory model Writing your own memory model __user_initial_stackheap() __user_setup_stackheap() __user_heap_extend() __user_heap_extent() __user_stack_cleanup_space() __rt_heap_extend() __rt_stack_postlongjmp() Tailoring the input/output functions Dependencies on low‑level functions Target‑dependent input/output support functions _sys_open() _sys_close() _sys_read() _sys_write() _sys_ensure() _sys_flen() _sys_seek() _sys_istty() _sys_tmpnam() _sys_command_string() #pragma import(_main_redirection) Tailoring other C library functions clock() _clock_init() time() remove() rename() system() getenv() _getenv_init() Selecting real‑time division ISO implementation definition ISO C library implementation definition Standard C++ library implementation definition C library extensions atoll() strtoll() strtoull() printf() snprintf() vsnprintf() lldiv() llabs() wcstombs() alloca() strlcpy() strlcat() _fisatty() __heapstats() __heapvalid() Library naming conventions Placing ARM libraries Helper libraries Identifying library variants The C Micro-library Floating‑point SupportLC_CTYPE data block
  | |||
  |  | ||
| |||
| Home > The C and C++ Libraries > Tailoring locale and CTYPE using assembler macros > LC_CTYPE data block | |||
The macros that define an LC_CTYPE data block are as follows:
Call
LC_CTYPE_beginwith a symbol name and a locale name. See Specifying the beginning for more information.Call
LC_CTYPE_tablerepeatedly to specify 256 table entries.LC_CTYPE_tabletakes a single argument in quotes. This must be a comma‑separated list of table entries. Each table entry describes one of the 256 possible characters, and can be either an illegal character (IL) or a combination sum using any of the following flags:__Swhitespace characters
__Ppunctuation characters
__Bprintable space characters
__Llowercase letters
__Uuppercase letters
__Ndecimal digits
__Ccontrol characters
__Xhexadecimal digit letters A‑F and a‑f
__Aalphabetic but neither uppercase nor lowercase, such as Japanese katakana.
Note
A printable space character is defined as any character where the result of both
isprint()andisspace()is true.__Amust not be specified for the same character as either__Nor__X.See Specifying the data for more information.
If required, call one or both of the following optional macros:
LC_CTYPE_full_wctype, calling this macro without arguments, causes the C99 wide-character ctype functions (iswalpha,iswupper, ...) to return useful values across the full range of Unicode when thisLC_CTYPElocale is active. If this macro is not specified, the wide ctype functions simply treats the first 256wchar_tvalues as the same as the 256 char values, and the rest of thewchar_trange as containing illegal characters.LC_CTYPE_multibytedefines this locale to be a multi-byte character set. Call this macro with three arguments. The first two arguments are the names of functions that perform conversion between the multi-byte character set and Unicode wide characters. The last argument is the value that must be taken by the C macroMB_CUR_MAXfor the respective character set. The two function arguments have the following prototypes:size_t internal_mbrtowc(wchar_t *pwc, char c, mbstate_t *pstate); size_t internal_wcrtomb(char *s, wchar_t w, mbstate_t *pstate);
internal_mbrtowc()takes one byte
cas input, and updates thembstate_tpointed to bypstateas a result of reading that byte. If the byte completes the encoding of a multibyte character, it writes the corresponding wide character into the location pointed to bypwc, and returns 1 to indicate that it has done so. If not, it returns -2 to indicate the state change ofmbstate_tand that no character is output. Otherwise, it returns -1 to indicate that the encoded input is invalid.internal_wcrtomb()takes one wide character
was input, and writes some number of bytes into the memory pointed to bys. It returns the number of bytes output, or -1 to indicate that the input character has no valid representation in the multibyte character set.
Call
LC_CTYPE_end, without arguments, to finish the locale block definition. See Specifying the ending for more information.
Example 2.4 shows an LC_CTYPE data block.
Example 2.4. Defining the CTYPE locale
LC_CTYPE_begin utf8_ctype, "UTF-8"
;
; Single-byte characters in the low half of UTF-8 are exactly
; the same as in the normal "C" locale.
LC_CTYPE_table "__C, __C, __C, __C, __C, __C, __C, __C, __C" ; 0x00-0x08
LC_CTYPE_table "__C+__S, __C+__S, __C+__S, __C+__S, __C+__S"
; 0x09-0x0D(BS,LF,VT,FF,CR)
LC_CTYPE_table "__C, __C, __C, __C, __C, __C, __C, __C, __C" ; 0x0E-0x16
LC_CTYPE_table "__C, __C, __C, __C, __C, __C, __C, __C, __C" ; 0x17-0x1F
LC_CTYPE_table "__B+__S" ; space
LC_CTYPE_table "__P, __P, __P, __P, __P, __P, __P, __P" ; !"#$%&'(
LC_CTYPE_table "__P, __P, __P, __P, __P, __P, __P" ; )*+,-./
LC_CTYPE_table "__N, __N, __N, __N, __N, __N, __N, __N, __N, __N" ; 0-9
LC_CTYPE_table "__P, __P, __P, __P, __P, __P, __P" ; :;<=>?@
LC_CTYPE_table "__U+__X, __U+__X, __U+__X, __U+__X, __U+__X, __U+__X" ; A-F
LC_CTYPE_table "__U, __U, __U, __U, __U, __U, __U, __U, __U, __U" ; G-P
LC_CTYPE_table "__U, __U, __U, __U, __U, __U, __U, __U, __U, __U" ; Q-Z
LC_CTYPE_table "__P, __P, __P, __P, __P, __P" ; [\]^_`
LC_CTYPE_table "__L+__X, __L+__X, __L+__X, __L+__X, __L+__X, __L+__X" ; a-f
LC_CTYPE_table "__L, __L, __L, __L, __L, __L, __L, __L, __L, __L" ; g-p
LC_CTYPE_table "__L, __L, __L, __L, __L, __L, __L, __L, __L, __L" ; q-z
LC_CTYPE_table "__P, __P, __P, __P" ; {|}~
LC_CTYPE_table "__C" ; 0x7F
;
; Nothing in the top half of UTF-8 is valid on its own as a
; single-byte character, so they are all illegal characters (IL).
LC_CTYPE_table "IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL"
LC_CTYPE_table "IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL"
LC_CTYPE_table "IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL"
LC_CTYPE_table "IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL"
LC_CTYPE_table "IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL"
LC_CTYPE_table "IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL"
LC_CTYPE_table "IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL"
LC_CTYPE_table "IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL,IL"
;
; The UTF-8 ctype locale wants the full version of wctype.
LC_CTYPE_full_wctype
;
; UTF-8 is a multi-byte locale, so we must specify some
; conversion functions. MB_CUR_MAX is 6 for UTF-8 (the lead
; bytes 0xFC and 0xFD are each followed by five continuation
; bytes).
;
; The implementations of the conversion functions are not
; provided in this example.
;
IMPORT utf8_mbrtowc
IMPORT utf8_wcrtomb
LC_CTYPE_multibyte utf8_mbrtowc, utf8_wcrtomb, 6
LC_CTYPE_end
| Copyright © 2007 ARM Limited. All rights reserved. | ARM DUI 0378A |
 PDF version | |
| Home > The C and C++ Libraries > Tailoring locale and CTYPE using assembler macros > LC_CTYPE data block | |
| |
| Contact Site Map Press Privacy | Copyright © 2008 Keil™, An ARM® Company. All rights reserved. |
