info(“arraybuildstatus”)

The info(“arraybuildstatus”) function returns the status of the most recently executed superarraybuild statement.


Description

This function returns the status of the most recently executed superarraybuild statement. The possible return values are:

0 = array complete
1 = array incomplete (timed out)
2 = array incomplete (keyboard abort)
3 = array incomplete (record limit)

This example displays a list of phone numbers. As the list is built, it is displayed every 1/2 second until the entire list is complete.

local displayArray
aboptions=0
loop 
    superarraybuild 
        displayArray,
        cr(),
        "",
        Status="Active",
        Name+" "+Phone,
        aboptions,
        30,
        0,
        0,
        0
    showvariables  displayArray
    aboptions=1
while info("arraybuildstatus")=1

Note: For new applications like this, we recommend using a Text List or Matrix object. These objects can build and display an array like this with no programming at all, simply as part of the normal operation of the object. See Text List Database Integration and Matrix Database Integration The info(“arraybuildstatus”) function is included for compatibility with older databases, but only works with superarraybuild, not with the array building capabilities of these objects.


See Also


History

VersionStatusNotes
10.0No ChangeCarried over from Panorama 6.0.