strstr()

Introdução

A função strstr() no PHP encontra a primeira ocorrência de uma string dentro de outra string. Ela retorna a parte da haystack a partir do needle até o final. Este artigo aborda sua sintaxe, comportamento e uso.

Entendendo a função strstr()

A sintaxe para usar a função strstr() no PHP é a seguinte:

A sintaxe PHP do strstr()

strstr(string $haystack, string $needle, bool $before_needle = false) : string|false

Aqui, $haystack é a string na qual queremos encontrar o $needle. O parâmetro $needle é a string que queremos buscar dentro do $haystack. O parâmetro $before_needle é um booleano opcional. Por padrão (false), a função retorna a parte do $haystack desde a primeira ocorrência do $needle até o final. Se definido como true, retorna a parte do $haystack antes da primeira ocorrência do $needle.

Note que strstr() diferencia maiúsculas de minúsculas. Para correspondência sem distinção de maiúsculas e minúsculas, use stristr(). Se você precisar apenas da posição do needle em vez da parte correspondente, use strpos().

A função strstr() retorna a parte da string $haystack a partir da primeira ocorrência da string $needle até o final da string $haystack. Se o parâmetro $needle não for encontrado no $haystack, a função retorna false.

Exemplo de Uso

Aqui está um exemplo de uso da função strstr() no PHP:

Exemplo de strstr() em PHP

No exemplo acima, definimos uma string $string e uma substring $substring. Usamos a função strstr() para encontrar a primeira ocorrência de $substring dentro de $string. Como $substring está presente em $string, a saída será "The first occurrence of 'World' in 'Hello World' is 'World'".

Usando o parâmetro opcional e tratando false

<?php

$text = "Hello World";

// Returns the part before the needle
echo strstr($text, "World", true); // Outputs: Hello

// Returns false when the needle is not found
var_dump(strstr($text, "PHP")); // Outputs: false

Conclusão

A função strstr() localiza substrings de forma eficiente dentro de strings maiores. Compreender seu comportamento sensível a maiúsculas e minúsculas e seus parâmetros opcionais ajuda os desenvolvedores a escrever código PHP mais preciso. Para ir além, veja stristr() para buscas sem distinção de maiúsculas e minúsculas, strpos() para obter o índice do needle, substr() para extrair uma fatia por posição, e str_replace() para substituir substrings.

Prática