PHP 8.4.1 Released!

    La classe RegexIterator

    (No version information available, might only be in Git)

    Introduction

    Cet itérateur sert pour réaliser un filtre basé sur une expression rationnelle.

    Synopsis de la classe

    class RegexIterator extends FilterIterator {
    /* Constantes */
    public const int USE_KEY;
    public const int INVERT_MATCH;
    public const int MATCH;
    public const int GET_MATCH;
    public const int ALL_MATCHES;
    public const int SPLIT;
    public const int REPLACE;
    /* Propriétés */
    public ?string $replacement = null;
    /* Méthodes */
    public __construct(
        Iterator $iterator,
        string $pattern,
        int $mode = RegexIterator::MATCH,
        int $flags = 0,
        int $pregFlags = 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 $pregFlags): void
    /* Méthodes héritées */
    public FilterIterator::accept(): bool
    public FilterIterator::current(): mixed
    public FilterIterator::key(): mixed
    public FilterIterator::next(): void
    public FilterIterator::rewind(): void
    public FilterIterator::valid(): bool
    public IteratorIterator::current(): mixed
    public IteratorIterator::getInnerIterator(): ?Iterator
    public IteratorIterator::key(): mixed
    public IteratorIterator::next(): void
    public IteratorIterator::rewind(): void
    public IteratorIterator::valid(): bool
    }

    Constantes pré-définies

    Modes d'opération de RegexIterator

    RegexIterator::ALL_MATCHES

    Retourne toutes les occurrences de l'élément courant (voyez preg_match_all()).

    RegexIterator::GET_MATCH

    Retourne la première occurrence de l'élément courant (voyez preg_match()).

    RegexIterator::MATCH

    Effectue une recherche simple pour l'élément courant (voyez preg_match()).

    RegexIterator::REPLACE

    Remplace l'élément courant (voyez preg_replace() ; pas encore totalement implémenté).

    RegexIterator::SPLIT

    Retourne les valeurs séparées pour l'élément courant (voyez preg_split()).

    Drapeaux RegexIterator

    RegexIterator::USE_KEY

    Option spéciale : travaille sur la clé au lieu de la valeur.

    RegexIterator::INVERT_MATCH

    Inverse la valeur de retour de RegexIterator::accept().

    Propriétés

    replacement

    Sommaire

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    33
    jinmoku at hotmail dot com
    13 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
    2
    chris dot snyder at totara dot com
    1 year 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