IntlChar::isWhitespace

(PHP 7, PHP 8)

IntlChar::isWhitespace — コードポイントが、ICU の空白文字であるかを調べる

説明

public static IntlChar::isWhitespace(int|string $codepoint): ?bool

コードポイントが、ICU の空白文字であるかを判定します。

以下の条件のうちひとつでも満たす場合のみ、 文字は ICU の空白文字であると見なされます:

  • Unicode の区切り文字 (categories "Z" = "Zs", "Zl", "Zp" の場合) であるが、 同時に ノーブレークスペース (U+00A0 NBSP, U+2007 Figure Space, U+202F Narrow NBSP) でもないこと。
  • U+0009 HORIZONTAL TABULATION の場合
  • U+000A LINE FEED の場合
  • U+000B VERTICAL TABULATION の場合
  • U+000C FORM FEED の場合
  • U+000D CARRIAGE RETURN の場合
  • U+001C FILE SEPARATOR の場合
  • U+001D GROUP SEPARATOR の場合
  • U+001E RECORD SEPARATOR の場合
  • U+001F UNIT SEPARATOR の場合

パラメータ

codepoint

コードポイントを表す int 型の値 (例: U+2603 SNOWMAN を表す 0x2603)、あるいは UTF-8 文字列としてエンコードされた文字 (例: "\u{2603}")。

戻り値

codepoint が、ICU の空白文字である場合は true を返します。 そうでない場合は、false を返します。 失敗した場合は、null を返します。

例

例1 さまざまなコードポイントの例

<?php
var_dump(IntlChar::iswhitespace("A"));
var_dump(IntlChar::iswhitespace(" "));
var_dump(IntlChar::iswhitespace("\n"));
var_dump(IntlChar::iswhitespace("\t"));
var_dump(IntlChar::iswhitespace("\u{00A0}"));
?>

上の例の出力は以下となります。

bool(false)
bool(true)
bool(true)
bool(true)
bool(false)

参考

関連キーワード: 　文字, コード, ポイント, 空白, IntlChar, SEPARATOR, codepoint, スペース, FEED, TABULATION