1 | /* |
---|
2 | FUNCTION |
---|
3 | <<uselocale>>---free resources allocated for a locale object |
---|
4 | |
---|
5 | INDEX |
---|
6 | uselocale |
---|
7 | |
---|
8 | INDEX |
---|
9 | _uselocale_r |
---|
10 | |
---|
11 | SYNOPSIS |
---|
12 | #include <locale.h> |
---|
13 | locale_t uselocale(locale_t <[locobj]>); |
---|
14 | |
---|
15 | locale_t _uselocale_r(void *<[reent]>, locale_t <[locobj]>); |
---|
16 | |
---|
17 | DESCRIPTION |
---|
18 | The <<uselocale>> function shall set the current locale for the current |
---|
19 | thread to the locale represented by newloc. |
---|
20 | |
---|
21 | The value for the newloc argument shall be one of the following: |
---|
22 | |
---|
23 | 1. A value returned by the <<newlocale>> or <<duplocale>> functions |
---|
24 | |
---|
25 | 2. The special locale object descriptor LC_GLOBAL_LOCALE |
---|
26 | |
---|
27 | 3. (locale_t) <<0>> |
---|
28 | |
---|
29 | Once the <<uselocale>> function has been called to install a thread-local |
---|
30 | locale, the behavior of every interface using data from the current |
---|
31 | locale shall be affected for the calling thread. The current locale for |
---|
32 | other threads shall remain unchanged. |
---|
33 | |
---|
34 | If the newloc argument is (locale_t) <<0>>, the object returned is the |
---|
35 | current locale or LC_GLOBAL_LOCALE if there has been no previous call to |
---|
36 | <<uselocale>> for the current thread. |
---|
37 | |
---|
38 | If the newloc argument is LC_GLOBAL_LOCALE, the thread shall use the |
---|
39 | global locale determined by the <<setlocale>> function. |
---|
40 | |
---|
41 | RETURNS |
---|
42 | Upon successful completion, the <<uselocale>> function shall return the |
---|
43 | locale handle from the previous call for the current thread, or |
---|
44 | LC_GLOBAL_LOCALE if there was no such previous call. Otherwise, |
---|
45 | <<uselocale>> shall return (locale_t) <<0>> and set errno to indicate |
---|
46 | the error. |
---|
47 | |
---|
48 | |
---|
49 | PORTABILITY |
---|
50 | <<uselocale>> is POSIX-1.2008. |
---|
51 | */ |
---|
52 | |
---|
53 | #include <newlib.h> |
---|
54 | #include <reent.h> |
---|
55 | #include <stdlib.h> |
---|
56 | #include "setlocale.h" |
---|
57 | |
---|
58 | struct __locale_t * |
---|
59 | _uselocale_r (struct _reent *p, struct __locale_t *newloc) |
---|
60 | { |
---|
61 | struct __locale_t *current_locale; |
---|
62 | |
---|
63 | current_locale = __get_locale_r (p); |
---|
64 | if (!current_locale) |
---|
65 | current_locale = LC_GLOBAL_LOCALE; |
---|
66 | if (newloc == LC_GLOBAL_LOCALE) |
---|
67 | p->_locale = NULL; |
---|
68 | else if (newloc) |
---|
69 | p->_locale = newloc; |
---|
70 | return current_locale; |
---|
71 | } |
---|
72 | |
---|
73 | #ifndef _REENT_ONLY |
---|
74 | struct __locale_t * |
---|
75 | uselocale (struct __locale_t *newloc) |
---|
76 | { |
---|
77 | return _uselocale_r (_REENT, newloc); |
---|
78 | } |
---|
79 | #endif |
---|