PHP str_contains

Resumo : neste tutorial, você aprenderá como usar a str_contains()função PHP para verificar se uma string contém uma substring.

Introdução à função PHP str_contains()

A função PHP str_contains()verifica se uma string contém uma substring. Aqui está a sintaxe da str_contains()função:

str_contains ( string $haystack , string $needle ) : boolLinguagem de código:  PHP  ( php )

A str_contains()função possui os seguintes parâmetros:

  • $haystacké a string a ser verificada.
  • $needleé a substring a ser pesquisada na string de entrada $haystack.

A str_contains()função retorna truese $needleestiver no $haystack, falsecaso contrário.

Ao pesquisar por $needleno $haystack, a str_contains()função usa uma pesquisa que diferencia maiúsculas de minúsculas .

Observe que str_contains()a função está disponível desde o PHP 8.0.0. Se você usar uma versão anterior do PHP, poderá preencher a str_contains()função assim:

<?php

if (!function_exists('str_contains')) {
    function str_contains( $haystack, $needle)
    {
        return $needle !== '' && mb_strpos($haystack, $needle) !== false;
  
}Linguagem de código:  PHP  ( php )

Exemplos de funções PHP str_contains()

O exemplo a seguir usa a str_contains()função para verificar se a string 'PHP'está na string 'PHP string functions':

<?php

$haystack = 'PHP is cool.';
$needle = 'PHP';

$result = str_contains($haystack, $needle) ? 'is' : 'is not';

echo "The string {$needle} {$result} in the sentence.";Linguagem de código:  PHP  ( php )

Saída:

The string PHP is in the sentenceLinguagem de código:  PHP  ( php )

Conforme mencionado anteriormente, a str_contains()função usa a pesquisa com distinção entre maiúsculas e minúsculas para verificar se uma substring está em uma string. Por exemplo:

<?php

$haystack = 'PHP is cool.';
$needle = 'Cool';

$result = str_contains($haystack, $needle) ? 'is' : 'is not';

echo "The string {$needle} {$result} in the sentence.";Linguagem de código:  PHP  ( php )

Saída:

The string Cool is not in the sentence.Linguagem de código:  PHP  ( php )

Resumo

  • Use a função PHP str_contains()para realizar uma pesquisa com distinção entre maiúsculas e minúsculas para verificar se uma string está em outra string.

Deixe um comentário

O seu endereço de email não será publicado. Campos obrigatórios marcados com *