draft/man3/wcsncasecmp.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 Mon Oct 18 22:59:06 JST 1999
  15 .\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  16 .\"
  17 .TH WCSNCASECMP 3 2009-02-04 "GNU" "Linux Programmer's Manual"
  18 .\"O .SH NAME
  19 .SH Ì¾Á°
  20 .\"O wcsncasecmp \- compare two fixed-size wide-character strings, ignoring case
  21 wcsncasecmp \- ÂçÊ¸»ú¤È¾®Ê¸»ú¤ò¶èÊÌ¤»¤º¡¢2 ¤Ä¤Î¸ÇÄêÄ¹¤Î¥ï¥¤¥ÉÊ¸»úÊ¸»úÎó¤òÈæ³Ó¤¹¤ë
  22 .\"O .SH SYNOPSIS
  23 .SH ½ñ¼°
  24 .nf
  25 .B #define _GNU_SOURCE
  26 .B #include <wchar.h>
  27 .sp
  28 .BI "int wcsncasecmp(const wchar_t *" s1 ", const wchar_t *" s2 ", size_t " n );
  29 .fi
  30 .\"O .SH DESCRIPTION
  31 .SH ÀâÌÀ
  32 .\"O The
  33 .\"O .BR wcsncasecmp ()
  34 .\"O function is the wide-character equivalent of the
  35 .\"O .BR strncasecmp (3)
  36 .\"O function.
  37 .\"O It compares the wide-character string pointed to
  38 .\"O by \fIs1\fP and the wide-character string
  39 .\"O pointed to by \fIs2\fP, but at most
  40 .\"O \fIn\fP wide characters from each string, ignoring case differences
  41 .\"O .RB ( towupper (3),
  42 .\"O .BR towlower (3)).
  43 .BR wcsncasecmp ()
  44 ´Ø¿ô¤Ï¡¢
  45 .BR strncasecmp (3)
  46 ´Ø¿ô¤ËÂÐ±þ¤¹¤ë¥ï¥¤¥ÉÊ¸»ú´Ø
  47 ¿ô¤Ç¤¢¤ë¡£¤³¤Î´Ø¿ô¤Ï¡¢\fIs1\fP ¤¬»Ø¤¹¥ï¥¤¥ÉÊ¸»úÊ¸»úÎó¤È \fIs2\fP ¤¬»Ø
  48 ¤¹¥ï¥¤¥ÉÊ¸»úÊ¸»úÎó¤òÈæ³Ó¤¹¤ë¤¬¡¢ºÇÂç¤Ç¤âÀèÆ¬¤Î¥ï¥¤¥ÉÊ¸»ú \fIn\fP ¸Ä
  49 ¤·¤«Èæ³Ó¤·¤Ê¤¤¡£¤Þ¤¿¡¢ÂçÊ¸»ú¤È¾®Ê¸»ú
  50 .RB ( towupper (3),
  51 .BR towlower (3))
  52 ¤Ï¶èÊÌ¤·¤Ê¤¤¡£
  53 .\"O .SH "RETURN VALUE"
  54 .SH ÊÖ¤êÃÍ
  55 .\"O The
  56 .\"O .BR wcsncasecmp ()
  57 .\"O function returns zero
  58 .\"O if the wide-character strings at
  59 .\"O \fIs1\fP and \fIs2\fP,
  60 .\"O truncated to at most length \fIn\fP, are equal except
  61 .\"O for case distinctions.
  62 .\"O It returns a positive integer if truncated \fIs1\fP is
  63 .\"O greater than truncated \fIs2\fP, ignoring case.
  64 .\"O It returns a negative integer
  65 .\"O if truncated \fIs1\fP is smaller than truncated \fIs2\fP, ignoring case.
  66 .BR wcsncasecmp ()
  67 ´Ø¿ô¤Ï¡¢\fIs1\fP ¤È \fIs2\fP ¤¬¤½¤ì¤¾¤ì»Ø¤¹Ê¸»úÎó¤ò
  68 \fIn\fP Ê¸»ú¤Ë¼ý¤Þ¤ë¤è¤¦¤ËÀÚ¤êµÍ¤á¤¿¤â¤Î¤ò¡¢ÂçÊ¸»ú¤È¾®Ê¸»ú¤Î°ã¤¤¤òÌµ»ë
  69 ¤·¤ÆÈæ³Ó¤·¤¿¤È¤¤ËÅù¤·¤±¤ì¤Ð 0 ¤òÊÖ¤¹¡£¤³¤Î´Ø¿ô¤Ï¡¢ÂçÊ¸»ú¤È¾®Ê¸»ú¤ò¶è
  70 ÊÌ¤·¤Ê¤¤¾ì¹ç¤Ë¡¢\fIs1\fP ¤òÀÚ¤êµÍ¤á¤¿¤â¤Î¤¬ \fIs2\fP ¤òÀÚ¤êµÍ¤á¤¿¤â¤Î
  71 ¤è¤êÂç¤¤±¤ì¤ÐÀµ¤ÎÃÍ¤òÊÖ¤¹¡£¤³¤Î´Ø¿ô¤Ï¡¢ÂçÊ¸»ú¤È¾®Ê¸»ú¤ò¶èÊÌ¤·¤Ê¤¤¾ì¹ç
  72 ¤Ë¡¢\fIs1\fP ¤òÀÚ¤êµÍ¤á¤¿¤â¤Î¤¬ \fIs2\fP ¤òÀÚ¤êµÍ¤á¤¿¤â¤Î¤è¤ê¾®¤µ¤±¤ì
  73 ¤ÐÉé¤ÎÃÍ¤òÊÖ¤¹¡£
  74 .\"O .SH "CONFORMING TO"
  75 .SH ½àµò
  76 POSIX.1-2008.
  77 .\"O This function is not specified in POSIX.1-2001,
  78 .\"O and is not widely available on other systems.
  79 ¤³¤Î´Ø¿ô¤Ï POSIX.1-2001 ¤Ç¤Ïµ¬Äê¤µ¤ì¤Æ¤¤¤Ê¤¤¤¬¡¢
  80 Linux °Ê³°¤ÎÂ¾¤Î¥·¥¹¥Æ¥à¤Ç¹¤¯ÍøÍÑ²ÄÇ½¤Ç¤¢¤ë¡£
  81 .\"O .SH NOTES
  82 .SH Ãí°Õ
  83 .\"O The behavior of
  84 .\"O .BR wcsncasecmp ()
  85 .\"O depends on the
  86 .\"O .B LC_CTYPE
  87 .\"O category of the
  88 .\"O current locale.
  89 .BR wcsncasecmp ()
  90 ¤ÎÆ°ºî¤Ï¡¢¸½ºß¤Î¥í¥±¡¼¥ë¤Î
  91 .B LC_CTYPE
  92 ¥«¥Æ¥´¥ê¤Ë°ÍÂ¸¤¹¤ë¡£
  93 .\"O .SH "SEE ALSO"
  94 .SH ´ØÏ¢¹àÌÜ
  95 .BR strncasecmp (3),
  96 .BR wcsncmp (3)