Skip to content

IterMustPrev

Description

Aborting variant of IterPrev. See that macro for parameter semantics and success-state effects.

Success

Returns to the caller; the underlying IterPrev succeeded.

Failure

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

Usage example (Cross-references)

Usage examples (Cross-references)
        BufIter  it     = from(buf, 3);
        // pos=0, dir=+1: prev would land at -1.
        IterMustPrev(&it);
        return true; // unreachable
    }
    #define StrIterPrev(si) IterPrev((si))
    /// Aborting variant of `StrIterPrev`.
    #define StrIterMustPrev(si) IterMustPrev((si))
    
    // ---------------------------------------------------------------------------
Last updated on