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

  Sx_KeyGoto():

  Syntax:  Sx_KeyGoto( [nOrder] | [cTagName [, cIndexName ],] <nKeyNo> )

           nOrder     = Optional position of tag in list of tag orders.
           cTagName   = Optional name of tag.
           cIndexName = Optional name of index file which contains cTagName.
           nKeyNo     = The key number to move the index pointer to.

  Returns: .T. if pointer was moved successfully, .F. if not.

  Description:  Positions the record pointer to the Nth key in the index
                without having to do a GO TOP followed by a SKIP <nRecs>.

    NOTE:  This function respects any active SCOPE condition.  For example,
           if a SCOPE is active, and you issue a call to Sx_KeyGoto( 5 ),
           it will position the record pointer to the 5th key from the top
           of the active SCOPE.

    NOTE:  This function is NOT supported under SIXNTX.


  Examples:

    Sx_KeyGoTo( 500 )         // Move to the 500th key in the current order

    Sx_KeyGoTo( 2, 500 )      // Move to the 500th key in the second order

    Sx_KeyGoTo( "AGE", 10 )   // Move to the 10th key in the "AGE" tag

    // Move to the 10th key in the "AGE" tag of the TEST.CDX file
    Sx_KeyGoTo( "AGE", "TEST", 10 )