X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=original%2Fman3%2Fsetlocale.3;fp=original%2Fman3%2Fsetlocale.3;h=0000000000000000000000000000000000000000;hb=2460a0b8024ceb8570acdbc9208713d79458efcb;hp=28ddea1e7fccb5935bd80fd4a72cc58bafb10311;hpb=83f9e5d087c3464d5131604d3c9893479e6228eb;p=linuxjm%2FLDP_man-pages.git diff --git a/original/man3/setlocale.3 b/original/man3/setlocale.3 deleted file mode 100644 index 28ddea1e..00000000 --- a/original/man3/setlocale.3 +++ /dev/null @@ -1,197 +0,0 @@ -.\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) -.\" and Copyright 1999 by Bruno Haible (haible@clisp.cons.org) -.\" -.\" %%%LICENSE_START(VERBATIM) -.\" Permission is granted to make and distribute verbatim copies of this -.\" manual provided the copyright notice and this permission notice are -.\" preserved on all copies. -.\" -.\" Permission is granted to copy and distribute modified versions of this -.\" manual under the conditions for verbatim copying, provided that the -.\" entire resulting derived work is distributed under the terms of a -.\" permission notice identical to this one. -.\" -.\" Since the Linux kernel and libraries are constantly changing, this -.\" manual page may be incorrect or out-of-date. The author(s) assume no -.\" responsibility for errors or omissions, or for damages resulting from -.\" the use of the information contained herein. The author(s) may not -.\" have taken the same level of care in the production of this manual, -.\" which is licensed free of charge, as they might when working -.\" professionally. -.\" -.\" Formatted or processed versions of this manual, if unaccompanied by -.\" the source, must acknowledge the copyright and authors of this work. -.\" %%%LICENSE_END -.\" -.\" Modified Sat Jul 24 18:20:12 1993 by Rik Faith (faith@cs.unc.edu) -.\" Modified Tue Jul 15 16:49:10 1997 by Andries Brouwer (aeb@cwi.nl) -.\" Modified Sun Jul 4 14:52:16 1999 by Bruno Haible (haible@clisp.cons.org) -.\" Modified Tue Aug 24 17:11:01 1999 by Andries Brouwer (aeb@cwi.nl) -.\" Modified Tue Feb 6 03:31:55 2001 by Andries Brouwer (aeb@cwi.nl) -.\" -.TH SETLOCALE 3 2014-05-28 "GNU" "Linux Programmer's Manual" -.SH NAME -setlocale \- set the current locale -.SH SYNOPSIS -.nf -.B #include -.sp -.BI "char *setlocale(int " category ", const char *" locale ); -.fi -.SH DESCRIPTION -The -.BR setlocale () -function is used to set or query the program's current locale. -.PP -If -.I locale -is not NULL, -the program's current locale is modified according to the arguments. -The argument -.I category -determines which parts of the program's current locale should be modified. -.TS -lB lB -lB l. -Category Governs -LC_ALL All of the locale -LC_ADDRESS T{ -Formatting of addresses and -.br -geography-related items (*) -T} -LC_COLLATE String collation -LC_CTYPE Character classification -LC_IDENTIFICATION Metadata describing the locale (*) -LC_MEASUREMENT T{ -Settings related to measurements -.br -(metric versus US customary) (*) -T} -LC_MESSAGES Localizable natural-language messages -LC_MONETARY Formatting of monetary values -LC_NAME Formatting of salutations for persons (*) -LC_NUMERIC Formatting of nonmonetary numeric values -LC_PAPER Settings related to the standard paper size (*) -LC_TELEPHONE Formats to be used with telephone services (*) -LC_TIME Formatting of date and time values -.TE -.PP -The categories marked with an asterisk in the above table -are GNU extensions. -For further information on these locale categories, see -.BR locale (7). -.PP -The argument -.I locale -is a pointer to a character string containing the -required setting of -.IR category . -Such a string is either a well-known constant like "C" or "da_DK" -(see below), or an opaque string that was returned by another call of -.BR setlocale (). -.PP -If -.I locale -is an empty string, -.BR """""" , -each part of the locale that should be modified is set according to the -environment variables. -The details are implementation-dependent. -For glibc, first (regardless of -.IR category ), -the environment variable -.B LC_ALL -is inspected, -next the environment variable with the same name as the category -(see the table above), -and finally the environment variable -.BR LANG . -The first existing environment variable is used. -If its value is not a valid locale specification, the locale -is unchanged, and -.BR setlocale () -returns NULL. -.PP -The locale -.B """C""" -or -.B """POSIX""" -is a portable locale; its -.B LC_CTYPE -part corresponds to the 7-bit ASCII -character set. -.PP -A locale name is typically of the form -.IR language "[_" territory "][." codeset "][@" modifier "]," -where -.I language -is an ISO 639 language code, -.I territory -is an ISO 3166 country code, and -.I codeset -is a character set or encoding identifier like -.B "ISO-8859-1" -or -.BR "UTF-8" . -For a list of all supported locales, try "locale \-a", cf.\& -.BR locale (1). -.PP -If -.I locale -is NULL, the current locale is only queried, not modified. -.PP -On startup of the main program, the portable -.B """C""" -locale is selected as default. -A program may be made portable to all locales by calling: -.nf - - setlocale(LC_ALL, ""); - -.fi -after program initialization, by using the values returned -from a -.BR localeconv (3) -call -for locale-dependent information, by using the multibyte and wide -character functions for text processing if -.BR "MB_CUR_MAX > 1" , -and by using -.BR strcoll (3), -.BR wcscoll (3) -or -.BR strxfrm (3), -.BR wcsxfrm (3) -to compare strings. -.SH RETURN VALUE -A successful call to -.BR setlocale () -returns an opaque string that corresponds to the locale set. -This string may be allocated in static storage. -The string returned is such that a subsequent call with that string -and its associated category will restore that part of the process's -locale. -The return value is NULL if the request cannot be honored. -.SH CONFORMING TO -C89, C99, POSIX.1-2001. -.SH SEE ALSO -.BR locale (1), -.BR localedef (1), -.BR isalpha (3), -.BR localeconv (3), -.BR nl_langinfo (3), -.BR rpmatch (3), -.BR strcoll (3), -.BR strftime (3), -.BR charsets (7), -.BR locale (7) -.SH COLOPHON -This page is part of release 3.79 of the Linux -.I man-pages -project. -A description of the project, -information about reporting bugs, -and the latest version of this page, -can be found at -\%http://www.kernel.org/doc/man\-pages/.