DTWAIN_ArrayStringToFloat
|
The DTWAIN_ArrayStringToFloat creates a DTWAIN_ARRAY of DTWAIN_FLOAT values from a DTWAIN_ARRAY of DTWAIN_ARRAYSTRING
DTWAIN_ARRAY DTWAIN_ArrayStringToFloat ( 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. Otherwise, NULL is returned.
Comments The DTWAIN_ArrayStringToFloat 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_ARRAYSTRING. This means that the types of strings stored in Array will either be ANSI or wide strings, depending on whether the DTWAIN DLL that is being used is ANSI or Unicode, respectively.
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 specifically non-wide (ANSI) characters, see DTWAIN_ArrayANSIStringToFloat. To convert a DTWAIN_ARRAY of specifically wide (Unicode) characters, see DTWAIN_ArrayWideStringToFloat.
TWAIN State Transitions None.
Prerequisite Function Call(s)
|