Função str_contains

A função str_contains verifica a presença de um caractere em uma string. Retorna true, se o caractere estiver na string, e false no caso contrário. No primeiro parâmetro da função definimos a string na qual iremos procurar o caractere. No segundo parâmetro especificamos o caractere ou substring desejado.

Sintaxe

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

Exemplo

Vamos verificar se há um caractere especificado na string:

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

Resultado da execução do código:

phptrue

Exemplo

Vamos verificar se há uma substring especificada na string:

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

Resultado da execução do código:

phptrue

Exemplo

Agora vamos procurar em nossa string a substring 'ac':

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

Resultado da execução do código:

phpfalse

Veja também

  • a função str_starts_with,
    que verifica o início da string
  • a função str_ends_with,
    que verifica o final da string
  • a função in_array,
    que verifica a presença de um elemento em um array
  • a função strpos,
    que retorna a posição da ocorrência de uma substring