Submit a Pull Request Report a Bug

    La clase RegexIterator

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

    Introducción

    Este iterador puede ser usado para filtrar otro iterador basado en una expresión regular.

    Sinopsis de la Clase

    class RegexIterator extends FilterIterator {
    /* Constantes */
    const integer MATCH = 0;
    const integer GET_MATCH = 1;
    const integer ALL_MATCHES = 2;
    const integer SPLIT = 3;
    const integer REPLACE = 4;
    const integer USE_KEY = 1;
    /* Métodos */
    public __construct(
        Iterator $iterator,
        string $regex,
        int $mode = self::MATCH,
        int $flags = 0,
        int $preg_flags = 0
    )
    public accept(): bool
    public getFlags(): int
    public getMode(): int
    public getPregFlags(): int
    public getRegex(): string
    public setFlags(int $flags): void
    public setMode(int $mode): void
    public setPregFlags(int $preg_flags): void
    /* Métodos heredados */
    public abstract FilterIterator::accept(): bool
    public FilterIterator::__construct(Iterator $iterator)
    public FilterIterator::current(): mixed
    public FilterIterator::key(): mixed
    public FilterIterator::next(): void
    public FilterIterator::rewind(): void
    public FilterIterator::valid(): bool
    }

    Constantes predefinidas

    Modos de operación RegexIterator

    RegexIterator::ALL_MATCHES

    Devuelve todas las coincidencias de la entrada actual. (véase preg_match_all()).

    RegexIterator::GET_MATCH

    Devuelve la primera coincidencia de la entrada actual. (véase preg_match()).

    RegexIterator::MATCH

    Sólo ejecuta la coincidencia (filtro) para la entrada actual (véase preg_match()).

    RegexIterator::REPLACE

    Reemplaza la entrada actual (véase preg_replace(); No está completamente implementado)

    RegexIterator::SPLIT

    Devuelve los valores divididos de la entrada actual (véase preg_split()).

    Flags RegexIterator

    RegexIterator::USE_KEY

    Flag especial: Coincidir con la clave de entrada en lugar del valor de la entrada.

    Tabla de contenidos

    ＋add a note

    User Contributed Notes 2 notes

    up
    33
    jinmoku at hotmail dot com
    12 years ago
    An exemple :

    <?php
    $a     = new ArrayIterator(array('test1', 'test2', 'test3'));
    $i = new RegexIterator($a, '/^(test)(\d+)/', RegexIterator::REPLACE);
    $i->replacement = '$2:$1';
          
    print_r(iterator_to_array($i));
    /*
    Array
    (
        [0] => 1:test
        [1] => 2:test
        [2] => 3:test
    )
    */
    ?>
    up
    1
    chris dot snyder at totara dot com
    4 months ago
    In case the difference between modes RegexIterator::MATCH and RegexIterator::GET_MATCH is not immediately clear:

    MATCH will only return one value per matched element, as a string.

    GET_MATCH will return as many values, per matched element, as there are sub-patterns. If there are sub-patterns, each iteration returns an indexed array with the full pattern match at 0 and each of the sub-pattern matches as another element.

    If there are no sub-patterns, the behaviour of GET_MATCH is the same as MATCH.
    ＋add a note
    To Top