StrIterMustPrev

Description

Aborting variant of StrIterPrev. Alias for IterMustPrev; see IterMustPrev for the full contract.

Parameters

Success

Cursor steps back one character; returns to the caller.

Failure

Does not return – aborts via LOG_FATAL when stepping back would leave the valid range.

Usage example (Cross-references)

    
                if (!StrIterPeek(&si, &c) || !IS_DIGIT(c)) {
                    StrIterMustPrev(&si);
                    break;
                }

    
                if (!StrIterPeek(&si, &c) || !IS_DIGIT(c)) {
                    StrIterMustPrev(&si);
                    break;
                }