<-- Previous || Up || Next -->

Set Variant Cube Function
Array Manipulations Class

Public Function SetVariantCube( _
      ByRef rIn() As Variant _
    , ByVal v1Dim As Variant _
    , ByVal v2Dim As Variant _
    , ByVal v3Dim As Variant _
    , ByVal vValue As Variant _
    ) As Boolean

"Set Variant Cube Element"
Sets the value of an element of a three-dimensional Variant array.
Will expand the array if necessary to allow the element to be set.

Summary: 
    rIn(v1Dim, v2Dim, v3Dim) = vValue
Example: 
    Assuming
       Dim avarData() As Variant
       ReDim avarData(0 To 5, 0 To 5, 0 To 5)
    for example
       SetVariantCube(10, 5, 5, "RE") = True
See also: 
    SetVariantMatrix Function
    SetVariantVector Function
    ReDimPreserveVariantCube Function
rIn: Three-dimensional array of Variant values. rIn must already be dimensioned before it is passed to this function or else an error will occur. rIn should be dynamic because this function will attempt to redimension the array if necessary so that the specified element can be set.
v1Dim: First-dimension element number of the element to be set. Function returns False if v1Dim is Null or cannot be fixed-up to a number.
v2Dim: Second-dimension element number of the element to be set. Function returns False if v2Dim is Null or cannot be fixed-up to a number.
v3Dim: Third-dimension element number of the element to be set. Function returns False if v3Dim is Null or cannot be fixed-up to a number.
vValue: The value that will be assigned to element rIn(v1Dim, v2Dim, v3Dim)
Return value: Function returns True upon success.

Return to ENTISOFT Home Page

Copyright © 1999-2005 Entisoft