This function is used to convert an alphanumeric string to an IMAGE variable, taking character encoding into account.
Context
Windows client
- Windows server
Java client
Java server
Adelia Web Client
Adelia Cloud client
- Event Adelia client
Parameters
ALPHA |
String |
String to encode. |
| ALPHA | Encoding | Character encoding to use when converting the alphanumeric string to an IMAGE variable. 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 libiconv library (Windows). If encoding is not specified (empty string), the string to encode is converted using:
|
IMAGE |
Binary |
Target Binary, resulting from the conversion. |
NUM_BIN_2 |
ReturnCode |
Operation return code: 0: Operation completed successfully. -1: Character encoding not supported. -3: Invalid IMAGE variable (Windows platform) -4: Insufficient memory (Windows platform) |
For example
IMAGE |
img |
| ALPHA(20) | encoding |
ALPHA(100) |
string |
NUM_BIN_2 |
retCode |
encoding = 'UTF-8'
string = 'The pound(sign £)is the main unit of sterling'
CALL_DLL 'VATOOLBX.DLL' 'VaToolBxAlphaToImage' string encoding img retCode
List of VaToolBx DLL functions by topic