1 '\" te 2 .\" Copyright (c) 2001, The IEEE and The Open Group. All Rights Reserved. Portions Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. 3 .\" Copyright (c) 2014, Joyent, Inc. All rights reserved. 4 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at 5 .\" http://www.opengroup.org/bookstore/. 6 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. 7 .\" This notice shall appear on any product containing this material. 8 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. 9 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. 10 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] 11 .TH LOCALE.H 3HEAD "Sep 10, 2004" 12 .SH NAME 13 locale.h, locale \- category macros 14 .SH SYNOPSIS 15 .LP 16 .nf 17 #include <\fBlocale.h\fR> 18 .fi 19 20 .SH DESCRIPTION 21 .sp 22 .LP 23 The <\fBlocale.h\fR> header provides a definition for the \fBlconv\fR 24 structure, which includes the following members. (See the definition of 25 \fBLC_MONETARY\fR in \fBlocale\fR(5).) 26 .sp 27 .in +2 28 .nf 29 char *currency_symbol 30 char *decimal_point 31 char frac_digits 32 char *grouping 33 char *int_curr_symbol 34 char int_frac_digits 35 char int_n_cs_precedes 36 char int_n_sep_by_space 37 char int_n_sign_posn 38 char int_p_cs_precedes 39 char int_p_sep_by_space 40 char int_p_sign_posn 41 char *mon_decimal_point 42 char *mon_grouping 43 char *mon_thousands_sep 44 char *negative_sign 45 char n_cs_precedes 46 char n_sep_by_space 47 char n_sign_posn 48 char *positive_sign 49 char p_cs_precedes 50 char p_sep_by_space 51 char p_sign_posn 52 char *thousands_sep 53 .fi 54 .in -2 55 56 .sp 57 .LP 58 The <\fBlocale.h\fR> header defines \fINULL\fR (as defined in <\fBstddef.h\fR>) 59 and the following as macros: 60 .sp 61 .in +2 62 .nf 63 LC_ALL 64 LC_COLLATE 65 LC_CTYPE 66 LC_MESSAGES 67 LC_MONETARY 68 LC_NUMERIC 69 LC_TIME 70 .fi 71 .in -2 72 73 .sp 74 .LP 75 The preceding expand to distinct integer constant expressions, for use as the 76 first argument to the \fBsetlocale()\fR function. See \fBsetlocale\fR(3C). 77 .sp 78 .LP 79 In addition, to facilitate the use of per-thread locales with the 80 .BR uselocale (3C) 81 function, the 82 .RB < locale.h > 83 header defines the following type and macro: 84 .sp 85 .in +2 86 .nf 87 locale_t 88 .fi 89 .in -2 90 .sp 91 .RS 6n 92 An opaque type that refers to a locale constructed through the use of 93 the 94 .BR newlocale (3C) 95 function. 96 .RE 97 98 .sp 99 .in +2 100 .nf 101 LC_GLOBAL_LOCALE 102 .fi 103 .in -2 104 .sp 105 .RS 6n 106 A macro which expands to a 107 .B locale_t 108 that represents the current global locale as set by 109 .BR setlocale (3C). 110 .RE 111 112 .sp 113 .LP 114 Additional macro definitions, beginning with the characters \fBLC_\fR and an 115 uppercase letter, can also be specified here. 116 .SH ATTRIBUTES 117 .sp 118 .LP 119 See \fBattributes\fR(5) for descriptions of the following attributes: 120 .sp 121 122 .sp 123 .TS 124 box; 125 c | c 126 l | l . 127 ATTRIBUTE TYPE ATTRIBUTE VALUE 128 _ 129 Interface Stability Standard 130 .TE 131 132 .SH SEE ALSO 133 .sp 134 .LP 135 .BR newlocale (3C), 136 .BR setlocale (3C), 137 .BR uselocale (3C), 138 .BR localeconv (3C), 139 .BR stddef.h (3HEAD), 140 .BR attributes (5), 141 .BR locale (5), 142 .BR standards (5)