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

 _stornl()
 Assign a numeric value to a referenced variable using a long
------------------------------------------------------------------------------
 C Prototype

     #include "extend.api"
     int _stornl(
                  long lNumber,
                  int iParamNum
                  [, int iArrayIndex]
                )

 Arguments

     lNumber is a numeric expression of type long.

     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

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

 Description

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

 Examples

     .  From C:

        _stornl( 123456789L, 1 );

     .  From Assembly language:

        EXTRN __stornl:FAR
              mov   ax, 1
              push  ax                  ; iParamNum
              mov   dx, 1883
              mov   ax, 52501
              push  dx                  ; push hi-order first
              push  ax
              call  __stornl
              add   sp, 6               ; reset stack pointer

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