Função mb_strstr

A função mb_strstr pesquisa a primeira ocorrência de uma substring em uma string com suporte a codificações multibyte. O primeiro parâmetro é a string na qual a pesquisa é realizada. O segundo parâmetro é a substring procurada. O terceiro parâmetro opcional determina se deve retornar a parte da string antes da ocorrência encontrada. O quarto parâmetro opcional especifica a codificação.

Sintaxe

phpmb_strstr(
  string $haystack,
  string $needle,
  [bool $before_needle = false],
  [string $encoding],
);

Exemplo

Vamos encontrar a primeira ocorrência de uma substring em uma string:

php<?php
  $res = mb_strstr('abcde', 'b');
  echo $res;
?>

Resultado da execução do código:

php'bcde'

Exemplo

Vamos encontrar a primeira ocorrência de uma substring em uma string e retornar a parte anterior à ocorrência:

php<?php
  $res = mb_strstr('abcde', 'cd', true);
  echo $res;
?>

Resultado da execução do código:

php'ab'

Exemplo

Pesquisa com especificação da codificação UTF-8:

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

Resultado da execução do código:

php'мир'

Veja também

  • a função mb_strpos,
    que pesquisa a posição da primeira ocorrência de uma substring
  • a função strstr,
    que realiza uma pesquisa similar sem suporte a codificações multibyte