_storl()
 Assign a logical value to a referenced variable
------------------------------------------------------------------------------
 C Prototype

     #include "extend.api"
     int _storl(
                 int iLogical,
                 int iParamNum
                 [, int iArrayIndex]
               )

 Arguments

     iLogical is an integer representing the logical value to be
     assigned.  A value of zero represents false (.F.).  Any other value
     represents true (.T.).

     iParamNum is the one-based ordinal position in the parameter list of
     the parameter to be assigned.

     iArrayIndex is an array index that specifies a particular element if
     the iParamNum parameter is an array.

 Returns

     _storl() returns one if the function is successful; otherwise, it
     returns zero.

 Description

     _storl() stores a logical value to a variable passed by reference as a
     parameter from CA-Clipper.  If the parameter specified by iParamNum is
     not passed by reference, _storl() ignores the call and returns a value
     of zero.

 Examples

     .  From C:

        _storl(1, 1);

     .  From Assembly language:

        EXTRN __storl:FAR
              mov   ax, 1               ; iParamNum
              push  ax
              push  ax
              call  __storl
              add   sp, 4               ; reset stack pointer

 Files  Library is CLIPPER.LIB, header file is Extend.api.