array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.mb-strstr.php', 1 => 'mb_strstr', 2 => 'Encontra a primeira ocorrência de uma string em outra', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Strings Multibyte e Funções', ), 'prev' => array ( 0 => 'function.mb-strrpos.php', 1 => 'mb_strrpos', ), 'next' => array ( 0 => 'function.mb-strtolower.php', 1 => 'mb_strtolower', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mbstring/functions/mb-strstr.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mb_strstr

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

mb_strstr — Encontra a primeira ocorrência de uma string em outra

Descrição

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

mb_strstr() encontra a primeira ocorrência de needle em haystack e retorna a porção de haystack. Se needle não for encontrado, retorna false.

Parâmetros

haystack

A string da qual obter a primeira ocorrência de needle

needle

A string a ser encontrada em haystack

before_needle

Determina qual parte de haystack essa função retorna. Se definido como true, retorna toda a haystack desde o início até a primeira ocorrência de needle (excluindo needle). Se definido como false, retorna toda a haystack da primeira ocorrência de needle até o final (incluindo needle).

encoding

O parâmetro encoding é a codificação de caracteres. Se for omitido ou null, o valor da codificação de caracteres interna será usado.

Valor Retornado

Retorna a porção de haystack, ou false se needle não for encontrado.

Registro de Alterações

Versão Descrição
8.0.0 O parâmetro needle agora aceita uma string vazia.
8.0.0 O parâmetro encoding agora pode ser nulo.

Veja Também