Tag Archives: FT_NTXHAND

FT Database

Posted on by vivaclipper 
 FT_DBFHAND()     Obtain the handle associated with an open .DBF file.
 FT_DBTHAND()     Obtain the handle associated with an open .DBT file.
 FT_FDEC()        Return the number of decimals in a numeric (type "N") field.
 FT_FEMPTY()      Determine if a field is empty, i.e., contains no value.
 FT_FEXIST()      Check for the existence of a field.
 FT_FLEN()        Return a field's length.
 FT_FNUM()        Return a field's ordinal position given the field name.
 FT_FPLACE()      Write a new value to a field.
 FT_FTYPE()       Return a field's type, given field name or ordinal position
 FT_FVAL()        Return the value of a field.
 FT_FVALLEN()     Return the length of the value in a field.
 FT_NTXHAND()     Obtain the handle associated with an open .NTX file.

 

FT_NTXHAND

Posted on by vivaclipper 
FT_NTXHAND()
 Obtain the handle associated with an open .NTX file.

 Syntax

     FT_NTXHand( <nOrderNum> ) -> nHandle

 Arguments

    <nOrderNum> is a numeric value indicating the active index for which
    the handle is to be obtained.

 Returns

   The file handle, or zero if no .NTX is open in the specified
   work area or if <nOrderNum> does not represent an open index.

 Description

   For your own twisted reasons you may need make direct use of the
   file handle associated with an index.  This function gives you
   that capability, but use it with care and don't blame me if you
   botch something up.

   By default this function works on the current work area, but can be
   made to work on any work area through the use of the standard Clipper
   alias operator.

   Be aware that this function makes use of Clipper's internal work
   area information which is subject to change in future versions of
   Clipper.  If this makes you uncomfortable then don't use this function,
   you gutless weasel.

   This function is written to adhere to Turbo Assembler's IDEAL mode.
   To use another assembler, rearrange the SEGMENT and PROC directives
   and make any other necessary changes to the source code.

 Examples

     // Get the handle for the second index

     QOut( FT_NTXHand( 2 ) )

     // Try a non-current work area

     nHandle := THISFILE->( FT_NTXHand( 1 ) )

     // This will return zero because only 15 indexes can be active

     nHandle := THATFILE->( FT_NTXHand( 22 ) )

 Source: NTXHANDL.ASM

 Author: Ted Means