release/man3/towlower.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\" and Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com>
   3 .\"
   4 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
   5 .\" This is free documentation; you can redistribute it and/or
   6 .\" modify it under the terms of the GNU General Public License as
   7 .\" published by the Free Software Foundation; either version 2 of
   8 .\" the License, or (at your option) any later version.
   9 .\" %%%LICENSE_END
  10 .\"
  11 .\" References consulted:
  12 .\"   GNU glibc-2 source code and manual
  13 .\"   Dinkumware C library reference http://www.dinkumware.com/
  14 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  15 .\"   ISO/IEC 9899:1999
  16 .\"
  17 .\"*******************************************************************
  18 .\"
  19 .\" This file was generated with po4a. Translate the source file.
  20 .\"
  21 .\"*******************************************************************
  22 .\"
  23 .\" Translated Mon Oct 25 08:06:53 JST 1999
  24 .\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  25 .\"
  26 .TH TOWLOWER 3 2014\-03\-18 GNU "Linux Programmer's Manual"
  27 .SH 名前
  28 towlower, towlower_l \- ワイド文字 1 個を小文字に変換する
  29 .SH 書式
  30 .nf
  31 \fB#include <wctype.h>\fP
  32 .sp
  33 \fBwint_t towlower(wint_t \fP\fIwc\fP\fB);\fP
  34
  35 \fBwint_t towlower_l(wint_t \fP\fIwc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
  36 .fi
  37 .sp
  38 .in -4n
  39 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  40 .in
  41 .sp
  42 \fBtowlower_l\fP():
  43 .PD 0
  44 .RS 4
  45 .TP
  46 glibc 2.10 以降:
  47 _XOPEN_SOURCE\ >=\ 700
  48 .TP
  49 glibc 2.10 より以前:
  50 _GNU_SOURCE
  51 .RE
  52 .PD
  53 .SH 説明
  54 The \fBtowlower\fP()  function is the wide\-character equivalent of the
  55 \fBtolower\fP(3)  function.  If \fIwc\fP is an uppercase wide character, and there
  56 exists a lowercase equivalent in the current locale, it returns the
  57 lowercase equivalent of \fIwc\fP.  In all other cases, \fIwc\fP is returned
  58 unchanged.
  59
  60 The \fBtowupper_l\fP()  function performs the same task, but performs the
  61 conversion based on the character type information in the locale specified
  62 by \fIlocale\fP.  The behavior of \fBtowupper_l()\fP is undefined if \fIlocale\fP is
  63 the special locale object \fBLC_GLOBAL_LOCALE\fP (see \fBduplocale\fP(3))  or is
  64 not a valid locale object handle.
  65
  66 The argument \fIwc\fP must be representable as a \fIwchar_t\fP and be a valid
  67 character in the locale or be the value \fBWEOF\fP.
  68 .SH 返り値
  69 If \fIwc\fP was convertible to lowercase, \fBtowlower\fP()  returns its lowercase
  70 equivalent; otherwise it returns \fIwc\fP.
  71 .SH 属性
  72 .SS "マルチスレッディング (pthreads(7) 参照)"
  73 .\" FIXME need a thread-safety statement about towlower_l()
  74 \fBtowlower\fP() 関数は、例外付きのスレッドセーフである。実行中に \fBsetlocale\fP(3)
  75 を呼び出してロケールを変更しない限り、マルチスレッドアプリケーションで安全に使用することができる。
  76 .SH バージョン
  77 \fBtowlower_l\fP() 関数は glibc 2.3 で初めて登場した。
  78 .SH 準拠
  79 \fBtowlower\fP(): C99, POSIX.1\-2001 (XSI); POSIX.1\-2008 の XSI
  80 拡張に存在しているが、廃止予定とされている。
  81
  82 \fBtowlower_l\fP(): POSIX.1\-2008.
  83 .SH 注意
  84 これらの関数の動作は、ロケールの \fBLC_CTYPE\fP カテゴリに依存する。
  85 .PP
  86 これらの関数で Unicode 文字を扱うのはあまり適切でない。 なぜなら、Unicode には、大文字 (upper case)・小文字 (lower
  87 case)・ タイトル文字 (title case) という 3 つの "case" が含まれているからである。
  88 .SH 関連項目
  89 \fBiswlower\fP(3), \fBtowctrans\fP(3), \fBtowupper\fP(3), \fBlocale\fP(7)
  90 .SH この文書について
  91 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.63 の一部
  92 である。プロジェクトの説明とバグ報告に関する情報は
  93 http://www.kernel.org/doc/man\-pages/ に書かれている。