visus
/
toolchain-gcc-arm-embedded
Observar 1
Favorito 0
Fork 0
Código Issues 0 Pull requests 0 Versões 0 Wiki Atividade
Você não pode selecionar mais de 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.
2 Commits
1 Branch
Tag: 898a39b5ab
Branches Tags
${ item.name }
Criar branch ${ searchTerm }
de 898a39b5ab
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/libc/setlocale.html

188 linhas
9.2KB
Original Anotar Histórico 

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

  2. <html>

  3. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->

  4. <head>

  5. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  6. <title>setlocale (The Red Hat newlib C Library)</title>

  7. 

  8. <meta name="description" content="setlocale (The Red Hat newlib C Library)">

  9. <meta name="keywords" content="setlocale (The Red Hat newlib C Library)">

  10. <meta name="resource-type" content="document">

  11. <meta name="distribution" content="global">

  12. <meta name="Generator" content="makeinfo">

  13. <link href="index.html#Top" rel="start" title="Top">

  14. <link href="Document-Index.html#Document-Index" rel="index" title="Document Index">

  15. <link href="Document-Index.html#SEC_Contents" rel="contents" title="Table of Contents">

  16. <link href="Locale.html#Locale" rel="up" title="Locale">

  17. <link href="Reentrancy.html#Reentrancy" rel="next" title="Reentrancy">

  18. <link href="Locale.html#Locale" rel="prev" title="Locale">

  19. <style type="text/css">

  20. <!--

  21. a.summary-letter {text-decoration: none}

  22. blockquote.indentedblock {margin-right: 0em}

  23. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}

  24. blockquote.smallquotation {font-size: smaller}

  25. div.display {margin-left: 3.2em}

  26. div.example {margin-left: 3.2em}

  27. div.lisp {margin-left: 3.2em}

  28. div.smalldisplay {margin-left: 3.2em}

  29. div.smallexample {margin-left: 3.2em}

  30. div.smalllisp {margin-left: 3.2em}

  31. kbd {font-style: oblique}

  32. pre.display {font-family: inherit}

  33. pre.format {font-family: inherit}

  34. pre.menu-comment {font-family: serif}

  35. pre.menu-preformatted {font-family: serif}

  36. pre.smalldisplay {font-family: inherit; font-size: smaller}

  37. pre.smallexample {font-size: smaller}

  38. pre.smallformat {font-family: inherit; font-size: smaller}

  39. pre.smalllisp {font-size: smaller}

  40. span.nolinebreak {white-space: nowrap}

  41. span.roman {font-family: initial; font-weight: normal}

  42. span.sansserif {font-family: sans-serif; font-weight: normal}

  43. ul.no-bullet {list-style: none}

  44. -->

  45. </style>

  46. 

  47. 

  48. </head>

  49. 

  50. <body lang="en">

  51. <a name="setlocale"></a>

  52. <div class="header">

  53. <p>

  54. Up: <a href="Locale.html#Locale" accesskey="u" rel="up">Locale</a> &nbsp; [<a href="Document-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Document-Index.html#Document-Index" title="Index" rel="index">Index</a>]</p>

  55. </div>

  56. <hr>

  57. <a name="setlocale_002c-localeconv_002d_002d_002dselect-or-query-locale"></a>

  58. <h3 class="section">9.1 <code>setlocale</code>, <code>localeconv</code>&mdash;select or query locale</h3>

  59. <a name="index-setlocale"></a>

  60. <a name="index-localeconv"></a>

  61. <a name="index-_005fsetlocale_005fr"></a>

  62. <a name="index-_005flocaleconv_005fr"></a>

  63. <p><strong>Synopsis</strong>

  64. </p><div class="example">

  65. <pre class="example">#include &lt;locale.h&gt;

  66. char *setlocale(int <var>category</var>, const char *<var>locale</var>);

  67. lconv *localeconv(void);

  68. 

  69. char *_setlocale_r(void *<var>reent</var>,

  70.     int <var>category</var>, const char *<var>locale</var>);

  71. lconv *_localeconv_r(void *<var>reent</var>);

  72. 

  73. </pre></div>

  74. <p><strong>Description</strong><br>

  75. <code>setlocale</code> is the facility defined by ANSI C to condition the

  76. execution environment for international collating and formatting

  77. information; <code>localeconv</code> reports on the settings of the current

  78. locale.

  79. </p>

  80. <p>This is a minimal implementation, supporting only the required <code>&quot;POSIX&quot;</code>

  81. and <code>&quot;C&quot;</code> values for <var>locale</var>; strings representing other locales are not

  82. honored unless _MB_CAPABLE is defined.

  83. </p>

  84. <p>If _MB_CAPABLE is defined, POSIX locale strings are allowed, following

  85. the form

  86. </p>

  87. <p>language[_TERRITORY][.charset][@modifier]

  88. </p>

  89. <p><code>&quot;language&quot;</code> is a two character string per ISO 639, or, if not available

  90. for a given language, a three character string per ISO 639-3.

  91. <code>&quot;TERRITORY&quot;</code> is a country code per ISO 3166.  For <code>&quot;charset&quot;</code> and

  92. <code>&quot;modifier&quot;</code> see below.

  93. </p>

  94. <p>Additionally to the POSIX specifier, the following extension is supported

  95. for backward compatibility with older implementations using newlib:

  96. <code>&quot;C-charset&quot;</code>.

  97. Instead of <code>&quot;C-&quot;</code>, you can also specify <code>&quot;C.&quot;</code>.  Both variations allow

  98. to specify language neutral locales while using other charsets than ASCII,

  99. for instance <code>&quot;C.UTF-8&quot;</code>, which keeps all settings as in the C locale,

  100. but uses the UTF-8 charset.

  101. </p>

  102. <p>The following charsets are recognized:

  103. <code>&quot;UTF-8&quot;</code>, <code>&quot;JIS&quot;</code>, <code>&quot;EUCJP&quot;</code>, <code>&quot;SJIS&quot;</code>, <code>&quot;KOI8-R&quot;</code>, <code>&quot;KOI8-U&quot;</code>,

  104. <code>&quot;GEORGIAN-PS&quot;</code>, <code>&quot;PT154&quot;</code>, <code>&quot;TIS-620&quot;</code>, <code>&quot;ISO-8859-x&quot;</code> with

  105. 1 &lt;= x &lt;= 16, or <code>&quot;CPxxx&quot;</code> with xxx in [437, 720, 737, 775, 850, 852, 855,

  106. 857, 858, 862, 866, 874, 932, 1125, 1250, 1251, 1252, 1253, 1254, 1255, 1256,

  107. 1257, 1258].

  108. </p>

  109. <p>Charsets are case insensitive.  For instance, <code>&quot;EUCJP&quot;</code> and <code>&quot;eucJP&quot;</code>

  110. are equivalent.  Charset names with dashes can also be written without

  111. dashes, as in <code>&quot;UTF8&quot;</code>, <code>&quot;iso88591&quot;</code> or <code>&quot;koi8r&quot;</code>.  <code>&quot;EUCJP&quot;</code> and

  112. <code>&quot;EUCKR&quot;</code> are also recognized with dash, <code>&quot;EUC-JP&quot;</code> and <code>&quot;EUC-KR&quot;</code>.

  113. </p>

  114. <p>Full support for all of the above charsets requires that newlib has been

  115. build with multibyte support and support for all ISO and Windows Codepage.

  116. Otherwise all singlebyte charsets are simply mapped to ASCII.  Right now,

  117. only newlib for Cygwin is built with full charset support by default.

  118. Under Cygwin, this implementation additionally supports the charsets

  119. <code>&quot;GBK&quot;</code>, <code>&quot;GB2312&quot;</code>, <code>&quot;eucCN&quot;</code>, <code>&quot;eucKR&quot;</code>, and <code>&quot;Big5&quot;</code>.  Cygwin

  120. does not support <code>&quot;JIS&quot;</code>.

  121. </p>

  122. <p>Cygwin additionally supports locales from the file

  123. /usr/share/locale/locale.alias.

  124. </p>

  125. <p>(<code>&quot;&quot;</code> is also accepted; if given, the settings are read from the

  126. corresponding LC_* environment variables and $LANG according to POSIX rules.)

  127. </p>

  128. <p>This implementation also supports the modifiers <code>&quot;cjknarrow&quot;</code> and

  129. <code>&quot;cjkwide&quot;</code>, which affect how the functions <code>wcwidth</code> and <code>wcswidth</code>

  130. handle characters from the &quot;CJK Ambiguous Width&quot; category of characters

  131. described at http://www.unicode.org/reports/tr11/#Ambiguous.

  132. These characters have a width of 1 for singlebyte charsets and a width of 2

  133. for multibyte charsets other than UTF-8.

  134. For UTF-8, their width depends on the language specifier:

  135. it is 2 for <code>&quot;zh&quot;</code> (Chinese), <code>&quot;ja&quot;</code> (Japanese), and <code>&quot;ko&quot;</code> (Korean),

  136. and 1 for everything else. Specifying <code>&quot;cjknarrow&quot;</code> or <code>&quot;cjkwide&quot;</code>

  137. forces a width of 1 or 2, respectively, independent of charset and language.

  138. </p>

  139. <p>If you use <code>NULL</code> as the <var>locale</var> argument, <code>setlocale</code> returns a

  140. pointer to the string representing the current locale.  The acceptable

  141. values for <var>category</var> are defined in &lsquo;<code>locale.h</code>&rsquo; as macros

  142. beginning with <code>&quot;LC_&quot;</code>.

  143. </p>

  144. <p><code>localeconv</code> returns a pointer to a structure (also defined in

  145. &lsquo;<code>locale.h</code>&rsquo;) describing the locale-specific conventions currently

  146. in effect.  

  147. </p>

  148. <p><code>_localeconv_r</code> and <code>_setlocale_r</code> are reentrant versions of

  149. <code>localeconv</code> and <code>setlocale</code> respectively.  The extra argument

  150. <var>reent</var> is a pointer to a reentrancy structure.

  151. </p>

  152. <br>

  153. <p><strong>Returns</strong><br>

  154. A successful call to <code>setlocale</code> returns a pointer to a string

  155. associated with the specified category for the new locale.  The string

  156. returned by <code>setlocale</code> is such that a subsequent call using that

  157. string will restore that category (or all categories in case of LC_ALL),

  158. to that state.  The application shall not modify the string returned

  159. which may be overwritten by a subsequent call to <code>setlocale</code>.

  160. On error, <code>setlocale</code> returns <code>NULL</code>.

  161. </p>

  162. <p><code>localeconv</code> returns a pointer to a structure of type <code>lconv</code>,

  163. which describes the formatting and collating conventions in effect (in

  164. this implementation, always those of the C locale).

  165. </p>

  166. <br>

  167. <p><strong>Portability</strong><br>

  168. ANSI C requires <code>setlocale</code>, but the only locale required across all

  169. implementations is the C locale.

  170. </p>

  171. <br>

  172. <p><strong>Notes</strong><br>

  173. There is no ISO-8859-12 codepage.  It&rsquo;s also refused by this implementation.

  174. </p>

  175. <p>No supporting OS subroutines are required.

  176. </p>

  177. <br>

  178. <hr>

  179. <div class="header">

  180. <p>

  181. Up: <a href="Locale.html#Locale" accesskey="u" rel="up">Locale</a> &nbsp; [<a href="Document-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Document-Index.html#Document-Index" title="Index" rel="index">Index</a>]</p>

  182. </div>

  183. 

  184. 

  185. 

  186. </body>

  187. </html>