関数 str_contains

関数 str_contains は、文字列内に 文字が存在するかどうかをチェックします。文字列内に文字が存在する場合は true を返し、 存在しない場合は false を返します。関数の最初のパラメータで検索対象の文字列を指定し、 2番目のパラメータで探したい文字または部分文字列を指定します。

構文

phpstr_contains(string $haystack, string $needle): bool

例

文字列に指定された文字が含まれているか 確認してみましょう:

php<?php
  $str = 'abcde';
  $res = str_contains($str, 'a');
  
  var_dump($res);
?>

コードの実行結果:

phptrue

例

文字列に指定された部分文字列が含まれているか 確認してみましょう:

php<?php
  $str = 'abcde';
  $res = str_contains($str, 'ab');
  
  var_dump($res);
?>

コードの実行結果:

phptrue

例

次に、文字列内で部分文字列 'ac' を 探してみましょう:

php<?php
  $str = 'abcde';
  $res = str_contains($str, 'ac');
  
  var_dump($res);
?>

コードの実行結果:

phpfalse

関連項目

  • 文字列の先頭をチェックする関数 str_starts_with,
  • 文字列の末尾をチェックする関数 str_ends_with,
  • 配列内に要素が存在するかチェックする関数 in_array,
  • 部分文字列の出現位置を返す関数 strpos,