DQ.VALUE Function

Retrieves the value from the last parse or extract function.

Category:	Data Quality
Returned data type:	Integer
Note:	The returned value is true if the index is valid.

Syntax

Required Arguments

Details

Examples

Syntax

DQ.VALUE(integer, string)

Required Arguments

integer

represents an index of the token.

string

a string that represents the output value.

Details

The DQ.VALUE function is used to retrieve an extraction or parse result. The first parameter is the index of a token. The second parameter receives the attribute that is stored in the token. The function returns true if it is able to get the token value. It returns false if it fails. This function follows a parse or extract function.

Examples

Example 1

data quality dq
string output
integer o
integer i
 
/* Initialize DQ */
dq = dq_initialize()
dq.loadqkb("EN")
 
/* Extract using the "Product Attributes" Extraction definition (using QKB PD 2012A) */
o = dq.extract("Product Attributes", "DOOR RANCHERO WOOD 16X8 WHT")
 
/* print all of the tokens we got */
print (o & " tokens filled")
for i = 1 to o
begin
     dq.token(i, output)
     print ("token #" & i & " = " & output)
     dq.value(i, output)
     print ("value #" & i & " = " & output)
end
/* to get a token's value by its name... */
dq.tokenvalue("Colors", output)
print ("Colors = " & output)

Example 2

/* Parse (using QKB CI 2013A) */
o = dq.parse("Name", "Mr. John Q Public Sr")
 
/* print all of the tokens available */
print (o & " tokens filled")
for i = 1 to o
begin
     dq.token(i, output)
     print ("token #" & i & " = " & output)
     dq.value(i, output)
     print ("value #" & i & " = " & output)
end
 
/* Get a token value by the name. */
dq.tokenvalue("Given Name", output)
print ("Given Name= " & output)