release/man3/mblen.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 .\"   ISO/IEC 9899:1999
  13 .\"
  14 .\"*******************************************************************
  15 .\"
  16 .\" This file was generated with po4a. Translate the source file.
  17 .\"
  18 .\"*******************************************************************
  19 .TH MBLEN 3 1999\-07\-25 GNU "Linux Programmer's Manual"
  20 .SH 名前
  21 mblen \- 次のマルチバイト文字のバイト数を返す
  22 .SH 書式
  23 .nf
  24 \fB#include <stdlib.h>\fP
  25 .sp
  26 \fBint mblen(const char *\fP\fIs\fP\fB, size_t \fP\fIn\fP\fB);\fP
  27 .fi
  28 .SH 説明
  29 \fIs\fP が NULL ポインターでなければ、 \fBmblen\fP()  関数は \fIs\fP から始まる最大 \fIn\fP
  30 バイトのマルチバイト文字列を検査して、 次の完全なマルチバイト文字を取り出す。これには \fBmblen\fP()
  31 関数のみが使用する静的で名前のないシフト状態が使用される。 マルチバイト文字がナルワイド文字でなければ \fIs\fP から消費される
  32 バイト数を返す。マルチバイト文字がナルワイド文字ならば 0 を返す。
  33 .PP
  34 \fIs\fP から始まる \fIn\fP バイトが完全なマルチバイト文字を含んで いなければ、 \fBmblen\fP()  は \-1 を返す。マルチバイト文字列
  35 に冗長なシフトシーケンスが含まれていると、 \fIn\fP が \fIMB_CUR_MAX\fP 以上の場合にも このようなことが起こりえる。
  36 .PP
  37 \fIs\fP から始まるマルチバイト文字列が次の完全な文字の前に 不正なマルチバイト列を含んでいる場合にも、 \fBmblen\fP()  は \-1 を返す。
  38 .PP
  39 .\" The Dinkumware doc and the Single UNIX specification say this, but
  40 .\" glibc doesn't implement this.
  41 \fIs\fP が NULL ポインターならば、 \fBmblen\fP()  関数はこの関数のみが
  42 使用するシフト状態を初期化状態に戻し、シフト状態を使用した文字符号の場合に はゼロ以外を、文字符号がシフト状態を持たない場合にはゼロを返す。
  43 .SH 返り値
  44 \fBmblen\fP()  関数は \fIs\fP から始まるマルチバイト列を検査して ナルワイド文字以外を確認した場合にはそのバイト数を返す。
  45 ナルワイド文字を確認した場合にはゼロを返す。不正なマルチバイト列に 遭遇した場合や完全なマルチバイト文字を解析できなかった場合には \-1 を返す。
  46 .SH 準拠
  47 C99.
  48 .SH 注意
  49 \fBmblen\fP()  の動作は現在のロケールの \fBLC_CTYPE\fP カテゴリに依存している。
  50 .PP
  51 \fBmbrlen\fP(3)  関数は同じ機能のより良いインタフェースを提供する。
  52 .SH 関連項目
  53 \fBmbrlen\fP(3)