StrIterPeekPrev

Description

Peek one position behind in the iteration direction, i.e. the character just consumed by the previous StrIterNext. IterPeekAt scales the offset by dir, so this passes a plain -1 and stays opposite of StrIterPeekNext for both forward and reverse iters.

Parameters

Success

*out is set to the previous character; the cursor is not advanced; returns true.

Failure

That position is outside [0, length); *out is not written, returns false.

Usage example (Cross-references)

        StrIterMustNext(&si); // -> 'b'
        char c = 0;
        if (!StrIterPeekPrev(&si, &c) || c != 'a') {
            return false;
        }

        StrIter si = StrIterFromZstr("ab");
        char    c  = 0x7F;
        if (StrIterPeekPrev(&si, &c)) {
            return false;
        }