PHP 8.4.2 Released!

    str_increment

    (PHP 8 >= 8.3.0)

    str_increment — Inkrementiert eine alphanumerische Zeichenkette

    Beschreibung

    str_increment(string $string): string

    Inkrementiert die aus alphanumerischen Zeichen bestehende ASCII-Zeichenkette string und gibt die resultierende Zeichenkette zurück.

    Parameter-Liste

    string

    Die Eingabezeichenkette

    Rückgabewerte

    Gibt die inkrementierte alphanumerische ASCII-Zeichenkette zurück.

    Fehler/Exceptions

    Wenn string leer ist, wird ein ValueError geworfen.

    Wenn string keine alphanumerische ASCII-Zeichenkette ist, wird ein ValueError geworfen.

    Beispiele

    Beispiel #1 Grundlegendes str_increment()-Beispiel

    <?php
    $str     = 'ABC';
    var_dump(str_increment($str));
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    string(3) "ABD"

    Beispiel #2 str_increment()-Beispiel mit einem Übertrag

    <?php
    $str     = 'DZ';
    var_dump(str_increment($str));

    $str = 'ZZ';
    var_dump(str_increment($str));
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    string(2) "EA"
string(3) "AAA"

    Siehe auch

    Found A Problem?

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

    User Contributed Notes 1 note

    up
    1
    yarns_purport0n at icloud dot com
    2 months ago
    The strings are incremented per character and each character position can be one of 3 modes:
    1. [A-Z] uppercase
    2. [a-z] lowercase
    3. [0-9] decimal

    you can mix any combination of the modes and (at least in right to left languages like english) it always increments from the right overflowing leftwards
    the mode/type of character that overflows remains the mode/type of the first (0 index) position.
    so: input 'zZ9' & 'aaA0' is returned
    so: input 'Z9z' & 'AA0a' is returned
    so: input '9zZ' & '10aA' is returned

    Example:
    <?php
    $str     = 'zZ9'; // overflows in lowercase
    echo $str = str_increment($str).PHP_EOL; // aaA0
    $str = 'Z9z'; // overflows in uppercase
    echo $str = str_increment($str).PHP_EOL; // AA0a
    $str = '9zZ'; // overflows in decimal
    echo ($str = str_increment($str)); // 10aA
    ?>
    ＋add a note
    To Top