release/man3/wcswidth.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" References consulted:
  11 .\"   GNU glibc-2 source code and manual
  12 .\"   Dinkumware C library reference http://www.dinkumware.com/
  13 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  14 .\"
  15 .\"*******************************************************************
  16 .\"
  17 .\" This file was generated with po4a. Translate the source file.
  18 .\"
  19 .\"*******************************************************************
  20 .\"
  21 .\" Translated Sat Oct 23 18:44:42 JST 1999
  22 .\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  23 .\"
  24 .TH WCSWIDTH 3 2014\-01\-22 GNU "Linux Programmer's Manual"
  25 .SH 名前
  26 wcswidth \- 固定サイズのワイド文字文字列の表示に必要なカラム数を求める
  27 .SH 書式
  28 .nf
  29 \fB#define _XOPEN_SOURCE\fP             /* feature_test_macros(7) 参照 */
  30 \fB#include <wchar.h>\fP
  31 .sp
  32 \fBint wcswidth(const wchar_t *\fP\fIs\fP\fB, size_t \fP\fIn\fP\fB);\fP
  33 .fi
  34 .SH 説明
  35 \fBwcswidth\fP()  関数は、\fIs\fP が指すワイド文字文字列を表現するために 必要なカラム数を返す。ただし、最大 \fIn\fP
  36 文字しか処理しない。 印刷可能でないワイド文字が文字列に含まれる場合には、 \-1 が返される。
  37 .SH 返り値
  38 \fBwcswidth\fP()  関数は、ワイド文字文字列 \fIs\fP の表現に必要なカラム数 を返す。ただしワイド文字文字列は最大 \fIn\fP
  39 個に切り詰められる。
  40 .SH 属性
  41 .SS "マルチスレッディング (pthreads(7) 参照)"
  42 \fBwcswidth\fP() 関数は、例外付きのスレッドセーフである。実行中に \fBsetlocale\fP(3)
  43 を呼び出してロケールを変更しない限り、マルチスレッドアプリケーションで安全に使用することができる。
  44 .SH 準拠
  45 POSIX.1\-2001.
  46 .SH 注意
  47 \fBwcswidth\fP()  の動作は現在のロケールの \fBLC_CTYPE\fP カテゴリに依存する。
  48 .SH 関連項目
  49 \fBiswprint\fP(3), \fBwcwidth\fP(3)
  50 .SH この文書について
  51 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.65 の一部
  52 である。プロジェクトの説明とバグ報告に関する情報は
  53 http://www.kernel.org/doc/man\-pages/ に書かれている。