UniBasic Commands Reference - Rocket Software

ISNVS
Syntax
ISNVS(dynamic.array)
Description
The UniBasic ISNVS function tests dynamic array elements to see if any of them is
the null value. This function is meaningful only when null value handling is on. It
returns an array with 0 or 1 in each element. If the array element is the null value, this
function returns a code of 1. If the element is not null, or if it contains the null value
as well as other characters, this function returns a code of 0.
Note: The udtconfig parameter NULL_FLAG must be on for a program that contains
ISNVS to compile. With this flag on, the null value represents an unknown value
(represented BY @NULL in UniBasic programs), as opposed to an empty string
(represented as “”). IBM recommends that you use @ variables to represent UniData
delimiters and the null value because the ASCII value used to represent these
characters can vary with language group.
Example
1-405 UniBasic Commands Reference
The following program demonstrates the ISNVS function by printing
the return values stored in array D:
B=@FM:"stereo":@FM:@NULL:@FM:"234":@FM
D=ISNVS(B)
STG=B
GOSUB PRINT.SETUP
PRINT "Dynamic array = "
PRINT PRT.STG
FOR X = 1 TO 4
PRINT "D = ":D
NEXT X
PRINT.SETUP:
PRT.STG = CHANGE(STG, @NULL, "@NULL")
PRT.STG = CHANGE(PRT.STG, @FM, "@FM")
PRT.STG = CHANGE(PRT.STG, @AM, "@AM")
PRT.STG = CHANGE(PRT.STG, @VM, "@VM")
RETURN