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

ordSetFocus()         Make the specified index the master index
------------------------------------------------------------------------------

Synopsis

    ordSetFocus( [nOrder] | [cTag [, cBag]] ) -> cPrevTag

Arguments

    nOrder, cTag and cBag are optional parameters which specify the index.
    If omitted the master index will remain unchanged,

    nOrder is the numeric order of the index.

    cTag is the tag of the index, and cBag is the specific index file in
    which to find cTag.

Returns

    ordSetFocus() returns a character string which is the tag of the
    previous master index.

Description

    ordSetFocus() makes the index with the specified tag or order the master
    index.  ordSetFocus() supersedes the dbSetOrder() function because it
    can take either a numeric argument or a tag name.  (Please note however
    that dbSetOrder() still works).

Example

    use demo

    index on last tag last
    index on first to first

    ? ordNumber()                       && Returns 2

    ordSetFocus("last")
    ? ordNumber()                       && Returns 1

    ordSetFocus("first")
    ? ordNumber()                       && Returns 2

    ordSetFocus("notThere")
    ? ordNumber()                       && Returns 0

See Also

    SET ORDER TO TAG