関数・クラス解説

strspn

version:PHP 4, PHP 5, PHP 7 (公式)

指定したマスク内に含まれる文字からなる文字列の最初のセグメントの長さを探す

公式リファレンス

書式

strspn ( string $subject , string $mask [, int $start [, int $length ]] ) : int

説明

subject の中で、 mask 内の文字だけを含む最初の部分の長さを返します。

start と length を省略した場合は、subject 全体を調べます。 指定した場合は、strspn(substr($subject, $start, $length), $mask) (詳細は substr を参照ください) をコールするのと同じ働きをします。

たとえば、

$var = strspn("42 is the answer to the 128th question.", "1234567890"); このコードは、$var に 2 を代入します。これは、 subject の中で "1234567890" 内の文字だけで構成される 最初の部分が "42" であるためです。

パラメータ

subject
調べたい文字列。
mask
許可する文字の一覧。
start
subject の中で調べ始める位置。 start に非負の値を指定すると、 strspn() は subject の start 番目の位置から調査を始めます。 たとえば、文字列 'abcdef' において 0 番目の位置にある文字は 'a' で 2 番目の位置にある文字は 'c' のようになります。 start に負の値を指定すると、 strspn() は subject の最後から start 番目の位置から調査を始めます。
length
subject 内で調べる部分の長さ。 length に非負の値を指定すると、 subject の開始位置から length 文字ぶんの範囲を調査します。 length に負の値を指定すると、 subject の調査範囲は 開始位置から始まって subject の最後から length だけさかのぼったところまでとなります。

返値

subject の中で、全て mask の中の文字からなる最初のセグメントの長さを返します。

注意: start パラメータを設定した場合は、返される長さはその位置からのものとなります。 subject の先頭からの長さではありません。

注意

注意: この関数はバイナリデータに対応しています。

サンプル

例1 strspn() の例

// subjectの最初の文字がmaskのどの文字とも一致しません var_dump(strspn("foo", "o")); // subject のオフセット 1 から 2 文字を調べます var_dump(strspn("foo", "o", 1, 2)); // subject のオフセット 1 から 1 文字を調べます var_dump(strspn("foo", "o", 1, 1));

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

int(0) int(2) int(1)

参考

  • strcspn() - マスクにマッチしない最初のセグメントの長さを返す
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール