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)
    /// TAGS: StrIter, Prev, Must, Alias
    ///
    #define StrIterMustPrev(si) IterMustPrev((si))
    
    // ---------------------------------------------------------------------------
        const u8 buf[3] = {0};
        BufIter  it     = BufIterFromMemory(buf, 3);
        IterMustPrev(&it);
        return true;
    }
Last updated on