strripos

(PHP 5, PHP 7, PHP 8)

strriposFind the position of the last occurrence of a case-insensitive substring in a string

Descrição

strripos(string$haystack, string$needle, int$offset = 0): int|false

Find the numeric position of the last occurrence of needle in the haystack string.

Unlike the strrpos(), strripos() is case-insensitive.

Parâmetros

haystack

The string to search in.

needle

The string to search for.

Antes do PHP 8.0.0, se needle não for uma string, ela será convertida para um número inteiro e aplicada como o valor ordinal de um caractere. Este comportamento tornou-se defasado a partir do PHP 7.3.0 e depender dele é altamente desaconselhado. Dependendo do comportamento pretendido, o parâmetro needle deve ser explicitamente convertido em string ou uma chamada explícita para chr() deve ser realizada.

offset

If zero or positive, the search is performed left to right skipping the first offset bytes of the haystack.

If negative, the search is performed right to left skipping the last offset bytes of the haystack and searching for the first occurrence of needle.

Nota:

This is effectively looking for the last occurrence of needle before the last offset bytes.

Valor Retornado

Returns the position where the needle exists relative to the beginnning of the haystack string (independent of search direction or offset).

Nota: String positions start at 0, and not 1.

Returns false if the needle was not found.

Aviso

Esta função pode retornar o valor booleano false, mas também pode retornar um valor não booleano que pode ser avaliado como false. Leia a seção sobre Booleanos para mais informações. Use o operador === para testar o valor retornado por esta função.

Registro de Alterações

VersãoDescrição
8.2.0 A redução de todas as letras a maiúsculas ou minúsculas não depende mais da localidade definida com setlocale(). Somente a redução de todas as letras ASCII a maiúsculas ou minúsculas será feita. Os bytes não ASCII serão comparados por seu valor de byte.
8.0.0 O parâmetro needle agora aceita uma string vazia.
8.0.0 Passing an int as needle is no longer supported.
7.3.0 Passing an int as needle has been deprecated.

Exemplos

Exemplo #1 A simple strripos() example

<?php
$haystack
= 'ababcd';
$needle = 'aB';

$pos = strripos($haystack, $needle);

if (
$pos === false) {
echo
"Sorry, we did not find ($needle) in ($haystack)";
} else {
echo
"Congratulations!\n";
echo
"We found the last ($needle) in ($haystack) at position ($pos)";
}
?>

O exemplo acima produzirá:

Congratulations! We found the last (aB) in (ababcd) at position (2)

Veja Também

  • strpos() - Find the position of the first occurrence of a substring in a string
  • stripos() - Find the position of the first occurrence of a case-insensitive substring in a string
  • strrpos() - Find the position of the last occurrence of a substring in a string
  • strrchr() - Find the last occurrence of a character in a string
  • stristr() - Case-insensitive strstr
  • substr() - Retorna parte de uma string
To Top