Função mb_stristr

A função mb_stristr busca a primeira ocorrência de uma substring em uma string sem diferenciar maiúsculas de minúsculas e retorna parte da string do início da ocorrência encontrada até o final. O primeiro parâmetro é a string onde buscar, o segundo é a substring procurada, o terceiro (opcional) é um valor booleano para retornar a parte da string antes da ocorrência, e o quarto (opcional) é a codificação.

Sintaxe

phpmb_stristr(string $haystack, string $needle, bool $before_needle = false, ?string $encoding = null): string|false

Exemplo

Vamos encontrar uma substring em uma string sem diferenciar maiúsculas de minúsculas:

php<?php
  $res = mb_stristr('ABCDE', 'bc');
  echo $res;
?>

Resultado da execução do código:

php'BCDE'

Exemplo

Usando o parâmetro $before_needle para obter a parte da string antes da ocorrência:

php<?php
  $res = mb_stristr('ABCDE', 'bc', true);
  echo $res;
?>

Resultado da execução do código:

php'A'

Exemplo

Busca especificando a codificação UTF-8:

php<?php
  $res = mb_stristr('Привет мир', 'МИР', false, 'UTF-8');
  echo $res;
?>

Resultado da execução do código:

php'мир'

Veja também

  • a função mb_strstr,
    que realiza a busca de substring diferenciando maiúsculas de minúsculas
  • a função stristr,
    que é similar à mb_stristr, mas para codificações de byte único