User Tools

Site Tools


howmany_return_dimensions_.htm
Navigation:  Language Reference > 13 - Built-in Functions >====== HOWMANY (return dimensions) ====== Previous pageReturn to chapter overviewNext page

 

HOWMANY( label ,element)

blk2blue.jpg

HOWMANY Returns the number of dimensions for a designated element.
label The label of a GROUP, QUEUE or RECORD.
element A LONG constant or variable that identifies the ordinal position of the target element to examine.

HOWMANY returns the number of dimensions the n'th field of a GROUP, QUEUE or RECORD. A multi-dimensioned field has its dimensions flattened.

HOWMANY will return zero (0) if you ask for the dimensions of a field within a dimensioned GROUP. To access the number of dimensions of such a field, you must first use GETGROUP to get one element of the dimensioned group.

Return Data Type: LONG

Example:

NestGroup  GROUP

subGroup    GROUP,DIM(2,2)

var1         LONG,DIM(3,3)

           END

          END

gr &GROUP

MyGroup  GROUP

var1      LONG,DIM(3,3)

var2      LONG,DIM(100)

var3      LONG,DIM(2,3,4)

        END

CODE

 HOWMANY(MyGroup, 1)    !Returns 9

 HOWMANY(MyGroup, 2)    !Returns 100

 HOWMANY(MyGroup, 3)    !Returns 24

 HOWMANY(NestGroup, 1)  !Returns 4

 HOWMANY(NestGroup, 2)  !Returns 0

 IF ISGROUP(NestGroup, 1)

   gr &= GETGROUP(NestGroup, 1, 1)

   HOWMANY(gr, 1)       !Returns 9

 END

See Also:

ISGROUP

GETGROUP

WHAT

WHERE

WHO

howmany_return_dimensions_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)