KRASCHE
&
BYRNE
         ELZED  HOME       NEWS       DOCS       DOWNLOADS       LICENSING       SUPPORT       FAQ       ABOUT  US

What's An Elzed?
Features
Licensing
Downloads
Documentation
Elzed News
    ELZED 
 Documentation 
 The Details 
 API 

lzGetBoolArrayElementByHandle

The lzGetBoolArrayElementByHandle function returns the value of the indicated boolean array element.

bool lzGetBoolArrayElementByHandle(
   LZObjectHandle hHandle,   // a handle to the array
   long lDimensions,   // the number of array dimensions
   long lDim1,   // first array index
   long lDim2,   // second array index
   long lDim3,   // third array index
   long lDim4,   // fourth array index
   long lDim5,   // fifth array index
   long lDim6   // sixth array index
);

Parameters

hHandle
   An LZObjectHandle to the desired array.

lDimensions
   A long integer value indicating the total number of array dimensions.

lDim1
   A long integer value indicating the first array dimension index.

lDim2
   A long integer value indicating the second array dimension index. Pass zero for this parameter if the dimension is not used.

lDim3
   A long integer value indicating the third array dimension index. Pass zero for this parameter if the dimension is not used.

lDim4
   A long integer value indicating the fourth array dimension index. Pass zero for this parameter if the dimension is not used.

lDim5
   A long integer value indicating the fifth array dimension index. Pass zero for this parameter if the dimension is not used.

lDim6
   A long integer value indicating the sixth array dimension index. Pass zero for this parameter if the dimension is not used.

Return Value

   Returns the value of the array element.

Remarks

   The indicated Elzed array must already exist.

This function fails silently and returns a value of FALSE if the array is not found, is not of boolean type, or if there is a dimension mismatch. Use lzGetLastErrorID or lzGetLastErrorText to find out what failed.

It probably goes without saying that the number of dimensions declared must match the number of dimensions actually in the array. The dimension parameters must be used in order starting with the first one (no skipping).

Versions

   Introduced in Elzed 2.4.0
   This page describes the version of lzGetBoolArrayElementByHandle active in Elzed 2.5.0 (244: 2.5.0)

See Also



  Copyright  ©  MMXXV  by  R R Le Cropane   •   All Rights Reserved   •   Terms of Use   •   Privacy Policy