DTWAIN_ArrayANSIStringToFloat

Top  Previous  Next

The DTWAIN_ArrayANSIStringToFloat creates a DTWAIN_ARRAY of DTWAIN_FLOAT values from a DTWAIN_ARRAY of DTWAIN_ARRAYANSISTRING

 

DTWAIN_ARRAY DTWAIN_ArrayANSIStringToFloat ( DTWAIN_ARRAY Array )

 

Parameters

Array

A DTWAIN_ARRAY that holds string values.

 

Return Values

If the function succeeds, a new DTWAIN_ARRAY is returned that contains DTWAIN_FLOAT values.  


On failure, NULL is returned.  Call DTWAIN_GetLastError() to get extended information.

 

Comments

The DTWAIN_ArrayANSIStringToFloat function returns a new DTWAIN_ARRAY that holds DTWAIN_FLOAT values that are equivalent to the string values in the DTWAIN_ARRAY that was passed in.  The Array must be one that was created with a type of DTWAIN_ARRAYANSISTRING.

 

This function is useful if the computer language used to write your application doesn't use or handle DTWAIN_FLOAT variable types correctly, and you want to call DTWAIN functions that use DTWAIN_FLOAT values (for example DTWAIN_SetCapValues for capabilities that require floating point values).  


To convert a DTWAIN_ARRAY of wide (Unicode) characters, see DTWAIN_ArrayWideStringToFloat.

 

TWAIN State Transitions

None.

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize