array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.str-decrement.php', 1 => 'str_decrement', 2 => 'Dekrementiert eine alphanumerische Zeichenkette', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String-Funktionen', ), 'prev' => array ( 0 => 'function.str-contains.php', 1 => 'str_contains', ), 'next' => array ( 0 => 'function.str-ends-with.php', 1 => 'str_ends_with', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/strings/functions/str-decrement.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

str_decrement

(PHP 8 >= 8.3.0)

str_decrement — Dekrementiert eine alphanumerische Zeichenkette

Beschreibung

str_decrement(string $string): string

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

Parameter-Liste

string

Die Eingabezeichenkette

Rückgabewerte

Gibt die dekrementierte 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.

Wenn string nicht dekrementiert werden kann, z. B. "A" oder "0", wird ein ValueError geworfen.

Beispiele

Beispiel #1 Grundlegendes str_decrement()-Beispiel

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

string(3) "ABB"

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

<?php
$str = 'ZA';
var_dump(str_decrement($str));

$str = 'AA';
var_dump(str_decrement($str));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

string(2) "YZ"
string(1) "Z"

Siehe auch