<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/refs.basic.vartype.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'book.ctype.php',
    1 => 'Ctype',
    2 => '文字タイプチェック',
  ),
  'up' => 
  array (
    0 => 'refs.basic.vartype.php',
    1 => '変数・データ型関連',
  ),
  'prev' => 
  array (
    0 => 'function.trait-exists.php',
    1 => 'trait_exists',
  ),
  'next' => 
  array (
    0 => 'ctype.setup.php',
    1 => 'インストール/設定',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'reference/ctype/book.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/book.ctype.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="book.ctype" class="book">
 
 <h1 class="title">文字タイプチェック</h1>
 

 <div id="intro.ctype" class="preface">
  <h1 class="title">はじめに</h1>
  <p class="para">
   以下の関数は、現在のロケール(<span class="function"><a href="function.setlocale.php" class="function">setlocale()</a></span>も参照)
   に基づき文字または文字列がある文字クラスに含まれるかどうかを調べます。
  </p>
  <p class="para">
   整数の引数を指定してコールした場合、これらの関数は、<var class="filename">ctype.h</var>
   に記述された C の同名の関数と全く同様に動作します。
   これは、256 より小さな整数が指定された場合、
   指定した範囲 (数値は 0x30-0x39) に収まっているかどうかを
   調べるために、そのアスキー値を使用することを意味します。
   数値が -128 および -1 (境界を含む) の間の場合、256 が追加され、
   その数字に関してチェックが行われます。
  </p>
  <div class="warning"><strong class="warning">警告</strong><p class="para">
PHP 8.1.0 以降は、ctype関数 に文字列でない引数を渡すことは、推奨されなくなりました。将来のバージョンでは、引数は ASCII コードポイントではなく、文字列として解釈されるようになります。ユーザが意図する振る舞いによっては、引数を文字列にキャストするか、 <span class="function"><a href="function.chr.php" class="function">chr()</a></span> を明示的にコールすべきです。</p></div>
  <p class="para">
   文字列引数を指定してコールした場合、これらの関数は、その文字列の全
   ての文字を調べ、その文字列の全ての文字が要求された基準に一致する場
   合にのみ <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> を返します。空文字列を渡して呼び出した場合、結果は常に <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> になります。
  </p>
  <p class="para">
   文字列または整数以外のものを指定した場合は、直ちに <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> が
   返されます。
  </p>
  <p class="para">
   ctype 関数は、正規表現よりもつねに好ましく、さらに <code class="literal">&quot;str_*&quot;</code> および <code class="literal">&quot;is_*&quot;</code> のような
   いくつかの等価な関数よりも好ましいことに注意してください。
   これは、ctype 関数がネイティブな C ライブラリを使用しており、処理が著しく
   高速であるためです。
  </p>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <p class="para">
    これらの関数は、Python の &quot;ctypes&quot; ライブラリとはまったく無関係です。
    この拡張モジュールの名前は C のヘッダファイル <var class="filename">ctype.h</var>
    からとったもので、このヘッダファイルには C 言語における同等の機能が定義されています。
   </p>
   <p class="para">
    また、この拡張モジュールのほうが Python の &quot;ctypes&quot; より先に登場しているわけで、
    こんなややこしいことになってしまったのも、決して PHP のせいではないわけで…。
   </p>
  </p></blockquote>
 </div>

 










 









<ul class="chunklist chunklist_book"><li><a href="ctype.setup.php">インストール/設定</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="ctype.requirements.php">要件</a></li><li><a href="ctype.installation.php">インストール手順</a></li></ul></li><li><a href="ref.ctype.php">Ctype 関数</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="function.ctype-alnum.php">ctype_alnum</a> — 英数字かどうかを調べる</li><li><a href="function.ctype-alpha.php">ctype_alpha</a> — 英字かどうかを調べる</li><li><a href="function.ctype-cntrl.php">ctype_cntrl</a> — 制御文字かどうかを調べる</li><li><a href="function.ctype-digit.php">ctype_digit</a> — 数字かどうかを調べる</li><li><a href="function.ctype-graph.php">ctype_graph</a> — 空白以外の印字可能な文字かどうかを調べる</li><li><a href="function.ctype-lower.php">ctype_lower</a> — 小文字かどうかを調べる</li><li><a href="function.ctype-print.php">ctype_print</a> — 印字可能な文字かどうかを調べる</li><li><a href="function.ctype-punct.php">ctype_punct</a> — 空白、英数字以外の出力可能な文字かどうかを調べる</li><li><a href="function.ctype-space.php">ctype_space</a> — 空白文字かどうか調べる</li><li><a href="function.ctype-upper.php">ctype_upper</a> — 大文字かどうか調べる</li><li><a href="function.ctype-xdigit.php">ctype_xdigit</a> — 16 進数を表す文字かどうかを調べる</li></ul></li></ul></div><?php manual_footer($setup); ?>