HP-UX

NAME

viVScanf − Reads, converts, and formats data

SYNOPSIS

viVScanf(ViSession vi, ViString readFmt, ViPVAList params);

Description

 
This function reads, converts, and formats data using the format specifier, and then stores the formatted data in params. This function is similar to viScanf, except that the ViVAList parameters list provides the parameters rather than separate arg parameters.
 

Parameters

vi An input parameter. Unique logical identifier to a session. 
 

readFmt An input parameter. 
 The format string to apply to parameters in ViVAList. See viScanf for description.
 

params An output parameter.  A list with the variable number of parameters into which the data is read and the format string is applied. 
 
 

Return Values

 
This is the functional return status.  It returns either a completion code or an error code as follows.
 

VI_SUCCESS Data was successfully read and formatted into arg parameter(s). 
 
 

VI_ERROR_INV_SESSION VI_ERROR_INV_OBJECT The given session or object reference is invalid (both are the same value). 
 

VI_ERROR_IO Could not perform read function because of I/O error. 
 

VI_ERROR_TMO Timeout expired before read function completed. 
 

VI_ERROR_INV_FMT A format specifier in the readFmt string is invalid. 
 

VI_ERROR_NSUP_FMT A format specifier in the readFtmt string is not supported. 
 

VI_ERROR_ALLOC The system could not allocate a formatted I/O buffer because of insufficient resources. 
 
 

See Also

 
viScanf
 

AUTHOR

viVScanf was developed by HP
 

Hewlett-Packard Comapny  —  September 29, 1999