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  2007-07-26 "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 .B #define _XOPEN_SOURCE
  26 .B #include <wchar.h>
  27 .sp
  28 .BI "int wcswidth(const wchar_t *" s ", size_t " n );
  29 .fi
  30 .\"O .SH DESCRIPTION
  31 .SH ÀâÌÀ
  32 .\"O The
  33 .\"O .BR wcswidth ()
  34 .\"O function returns the
  35 .\"O number of columns needed to represent
  36 .\"O the wide-character string pointed to by \fIs\fP, but at most \fIn\fP wide
  37 .\"O characters.
  38 .\"O If a nonprintable wide character occurs among these characters,
  39 .\"O \-1 is returned.
  40 .BR wcswidth ()
  41 ´Ø¿ô¤Ï¡¢\fIs\fP ¤¬»Ø¤¹¥ï¥¤¥ÉÊ¸»úÊ¸»úÎó¤òÉ½¸½¤¹¤ë¤¿¤á¤Ë
  42 É¬Í×¤Ê¥«¥é¥à¿ô¤òÊÖ¤¹¡£¤¿¤À¤·¡¢ºÇÂç \fIn\fP Ê¸»ú¤·¤«½èÍý¤·¤Ê¤¤¡£
  43 °õºþ²ÄÇ½¤Ç¤Ê¤¤¥ï¥¤¥ÉÊ¸»ú¤¬Ê¸»úÎó¤Ë´Þ¤Þ¤ì¤ë¾ì¹ç¤Ë¤Ï¡¢ \-1 ¤¬ÊÖ¤µ¤ì¤ë¡£
  44 .\"O .SH "RETURN VALUE"
  45 .SH ÊÖ¤êÃÍ
  46 .\"O The
  47 .\"O .BR wcswidth ()
  48 .\"O function
  49 .\"O returns the number of column positions for the
  50 .\"O wide-character string \fIs\fP, truncated to at most length \fIn\fP.
  51 .BR wcswidth ()
  52 ´Ø¿ô¤Ï¡¢¥ï¥¤¥ÉÊ¸»úÊ¸»úÎó \fIs\fP ¤ÎÉ½¸½¤ËÉ¬Í×¤Ê¥«¥é¥à¿ô
  53 ¤òÊÖ¤¹¡£¤¿¤À¤·¥ï¥¤¥ÉÊ¸»úÊ¸»úÎó¤ÏºÇÂç \fIn\fP ¸Ä¤ËÀÚ¤êµÍ¤á¤é¤ì¤ë¡£
  54 .\"O .SH "CONFORMING TO"
  55 .SH ½àµò
  56 POSIX.1-2001.
  57 .\"O .SH NOTES
  58 .SH Ãí°Õ
  59 .\"O The behavior of
  60 .\"O .BR wcswidth ()
  61 .\"O depends on the
  62 .\"O .B LC_CTYPE
  63 .\"O category of the
  64 .\"O current locale.
  65 .BR wcswidth ()
  66 ¤ÎÆ°ºî¤Ï¸½ºß¤Î¥í¥±¡¼¥ë¤Î
  67 .B LC_CTYPE
  68 ¥«¥Æ¥´¥ê¤Ë°ÍÂ¸¤¹¤ë¡£
  69 .\"O .SH "SEE ALSO"
  70 .SH ´ØÏ¢¹àÌÜ
  71 .BR iswprint (3),
  72 .BR wcwidth (3)