str_decrement

Decrement an alphanumeric string

&reftitle.description; `string` `str_decrement` `string` `string`

Returns the decremented alphanumeric ASCII `string`.

&reftitle.parameters;

`string`

- The input string.

&reftitle.returnvalues;

Returns the decremented alphanumeric ASCII string.

&reftitle.errors;

A `ValueError` is thrown if `string` is empty.

A `ValueError` is thrown if `string` is not an alphanumeric ASCII string.

A `ValueError` is thrown if `string` cannot be decremented. For example, `"A"` or `"0"`.

&reftitle.examples;

### Basic `str_decrement` example

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

&example.outputs;

    string(3) "ABB"

### `str_decrement` example with a carry

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

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

&example.outputs;

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

&reftitle.seealso;

- `str_increment`