str_increment

(PHP 8 >= 8.3.0)

str_increment — Inkrementiert eine alphanumerische Zeichenkette

Beschreibung

function 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
6
yarns_purport0n at icloud dot com
1 year 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