str_increment

(PHP 8 >= 8.3.0)

str_incrementУвеличивает на единицу буквенно-цифровую строку

Описание

str_increment(string $string): string

Возвращает увеличенную буквенно-цифровую строку string, состоящую из символов в кодировке ASCII.

Список параметров

string

Входная строка.

Возвращаемые значения

Возвращает увеличенную буквенно-цифровую строку, состоящую из ASCII-символов.

Ошибки

Будет выброшено исключение ValueError, если входная строка string пустая.

Будет выброшено исключение ValueError, если входная строка string состоит не из ASCII-символов.

Примеры

Пример #1 Базовый пример использования str_increment()

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

Результат выполнения приведённого примера:

string(3) "ABD"

Пример #2 Пример использования str_increment() с переносом (увеличением высшего разряда или разрядности)

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

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

Результат выполнения приведённого примера:

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

Смотрите также

  • str_decrement() - Уменьшает на единицу буквенно-цифровую строку

Добавить

Примечания пользователей 1 note

up
1
yarns_purport0n at icloud dot com
9 months ago
The strings are incremented per character and each character position can be one of 3 modes:1. [A-Z] uppercase2. [a-z] lowercase3. [0-9] decimalyou can mix any combination of the modes and (at least in right to left languages like english) it always increments from the right overflowing leftwardsthe mode/type of character that overflows remains the mode/type of the first (0 index) position.so: input 'zZ9' & 'aaA0' is returnedso: input 'Z9z' & 'AA0a' is returnedso: input '9zZ' & '10aA' is returnedExample:<?php$str = 'zZ9'; // overflows in lowercaseecho $str = str_increment($str).PHP_EOL; // aaA0$str = 'Z9z'; // overflows in uppercaseecho $str = str_increment($str).PHP_EOL; // AA0a$str = '9zZ'; // overflows in decimalecho ($str = str_increment($str)); // 10aA?>
To Top