strrpos

    (PHP 4, PHP 5, PHP 7, PHP 8)

    strrpos — Find the position of the last occurrence of a substring in a string

    Descrição

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

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

    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 starts offset bytes from the right instead of from the beginning of haystack. The search is performed right to left, searching for the first occurrence of needle from the selected byte.

    Nota:

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

    Valor Retornado

    Returns the position where the needle exists relative to the beginning 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.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 Checking if a needle is in the haystack

    It is easy to mistake the return values for "character found at position 0" and "character not found". Here's how to detect the difference:

    <?php

    $pos     = strrpos($mystring, "b");
    if (    $pos === false) { // note: three equal signs

    Exemplo #2 Searching with offsets

    <?php
    $foo     = "0123456789a123456789b123456789c";

    // Looking for '0' from the 0th byte (from the beginning)
    var_dump(strrpos($foo, '0', 0));

    // Looking for '0' from the 1st byte (after byte "0")
    var_dump(strrpos($foo, '0', 1));

    // Looking for '7' from the 21th byte (after byte 20)
    var_dump(strrpos($foo, '7', 20));

    // Looking for '7' from the 29th byte (after byte 28)
    var_dump(strrpos($foo, '7', 28));

    // Looking for '7' right to left from the 5th byte from the end
    var_dump(strrpos($foo, '7', -5));

    // Looking for 'c' right to left from the 2nd byte from the end
    var_dump(strrpos($foo, 'c', -2));

    // Looking for '9c' right to left from the 2nd byte from the end
    var_dump(strrpos($foo, '9c', -2));
    ?>

    O exemplo acima produzirá:

    int(0) bool(false) int(27) bool(false) int(17) bool(false) int(29)

    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
    • strripos() - Find the position of the last occurrence of a case-insensitive substring in a string
    • strrchr() - Find the last occurrence of a character in a string
    • substr() - Retorna parte de uma string
    To Top