This function is used to convert the binary content of an image to an alphanumeric string according to a character encoding.
Context
- Windows Client
- Windows Server
Java client
Java server
Adelia Web Client
Adelia Cloud client
- Event Adelia client
Parameters
IMAGE |
SourceBinary |
Binary to decode. |
| ALPHA | Encoding | Character encoding to use when converting the image to an alphanumeric string. This encoding value must be included in the character set registry defined by the IANA. It must also be included in the character sets supported by the JVM (Java) or by the libiconv library (Windows). If encoding is not specified (empty string), the string to encode is converted using:
|
ALPHA |
String |
Target string resulting from the conversion. |
NUM_BIN_4 |
Length |
Length of the target string. Important: in the event of a -2 execution error, this parameter is updated when the function call is returned (see the description of the ReturnCode parameter below). |
NUM_BIN_2 |
ReturnCode |
Operation return code: 0: Operation completed successfully. -1: Character encoding not supported. -2: The target string is too short. In this case, when the function is returned, the "Length" parameter is updated with the recommended string size. |
Example
|
Img |
ALPHA(20) |
encoding |
|
|
|
|
|
|
encoding = 'UTF-8'
LgBuff = 32000
CALL_DLL 'VATOOLBX.DLL' 'VaToolBxImageToAlpha' Img encoding string LgBuff retCode
List of VaToolBx DLL functions by topic