Click above to get retro games delivered to your door ever month!

cmxKeySkip()          Skip specified number of index keys
------------------------------------------------------------------------------

Synopsis

    cmxKeySkip([nKeys]) -> NIL

Arguments

    nKeys is optional and is the number of keys to skip.  If omitted, it
    defaults to 1.  If nKeys is negative, then cmxKeySkip() will skip
    backwards.

Returns

    NIL.

Description

    cmxKeySkip() skips the specified number of keys in the current master
    index.  This is very similar to dbSkip(), but is a "raw" skip.

    dbSkip() will "jump over" any records not meeting the filter condition
    (or deleted records if SET DELETED is ON).
    
    However, cmxKeySkip() will skip the specified number of keys
    disregarding the filter condition or the deleted setting (i.e., a "raw"
    skip).

    cmxKeySkip() does obey the current index scope in effect (if any).  It
    will go to BOF() if you attempt to skip before the beginning of the
    scope, or EOF() if you attempt to skip past the end of the scope.

Example

    use demo                        && Assume demo has 1000 records
    set index to first              && Make records in first name order
    set deleted on                  && Ignore deleted records

    go top
    ? cmxKeyNo()                    && Will display 1
    dbSkip(10)                      && Skip 10 _non-deleted_ records
    ? cmxKeyNo()                    && May display 11 _or_ higher if there
                                    && were any deleted records in the way

    go top
    ? cmxKeyNo()                    && Will display 1
    cmxKeySkip(10)                  && Skip 10 keys
    ? cmxKeyNo()                    && Will _always_ display 11

See Also

    cmxKeyCount(), cmxKeyGoto(), cmxKeyNo()