draft/man3/wcswidth.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" References consulted:
   9 .\"   GNU glibc-2 source code and manual
  10 .\"   Dinkumware C library reference http://www.dinkumware.com/
  11 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  12 .\"
  13 .\" About this Japanese page, please contact to JM Project <JM@linux.or.jp>
  14 .\" Translated Sat Oct 23 18:44:42 JST 1999
  15 .\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  16 .\"
  17 .TH WCSWIDTH 3  2010-09-10 "GNU" "Linux Programmer's Manual"
  18 .\"O .SH NAME
  19 .SH 名前
  20 .\"O wcswidth \- determine columns needed for a fixed-size wide-character string
  21 wcswidth \- 固定サイズのワイド文字文字列の表示に必要なカラム数を求める
  22 .\"O .SH SYNOPSIS
  23 .SH 書式
  24 .nf
  25 .\"O .BR "#define _XOPEN_SOURCE" "             /* See feature_test_macros(7) */"
  26 .BR "#define _XOPEN_SOURCE" "             /* feature_test_macros(7) 参照 */"
  27 .B #include <wchar.h>
  28 .sp
  29 .BI "int wcswidth(const wchar_t *" s ", size_t " n );
  30 .fi
  31 .\"O .SH DESCRIPTION
  32 .SH 説明
  33 .\"O The
  34 .\"O .BR wcswidth ()
  35 .\"O function returns the
  36 .\"O number of columns needed to represent
  37 .\"O the wide-character string pointed to by \fIs\fP, but at most \fIn\fP wide
  38 .\"O characters.
  39 .\"O If a nonprintable wide character occurs among these characters,
  40 .\"O \-1 is returned.
  41 .BR wcswidth ()
  42 関数は、\fIs\fP が指すワイド文字文字列を表現するために
  43 必要なカラム数を返す。ただし、最大 \fIn\fP 文字しか処理しない。
  44 印刷可能でないワイド文字が文字列に含まれる場合には、 \-1 が返される。
  45 .\"O .SH "RETURN VALUE"
  46 .SH 返り値
  47 .\"O The
  48 .\"O .BR wcswidth ()
  49 .\"O function
  50 .\"O returns the number of column positions for the
  51 .\"O wide-character string \fIs\fP, truncated to at most length \fIn\fP.
  52 .BR wcswidth ()
  53 関数は、ワイド文字文字列 \fIs\fP の表現に必要なカラム数
  54 を返す。ただしワイド文字文字列は最大 \fIn\fP 個に切り詰められる。
  55 .\"O .SH "CONFORMING TO"
  56 .SH 準拠
  57 POSIX.1-2001.
  58 .\"O .SH NOTES
  59 .SH 注意
  60 .\"O The behavior of
  61 .\"O .BR wcswidth ()
  62 .\"O depends on the
  63 .\"O .B LC_CTYPE
  64 .\"O category of the
  65 .\"O current locale.
  66 .BR wcswidth ()
  67 の動作は現在のロケールの
  68 .B LC_CTYPE
  69 カテゴリに依存する。
  70 .\"O .SH "SEE ALSO"
  71 .SH 関連項目
  72 .BR iswprint (3),
  73 .BR wcwidth (3)