CONVERT FROM TEXT

version 11

CONVERT FROM TEXT (4Dtext; charSet; convertedBLOB)

The CONVERT FROM TEXT command can be used to convert a text expressed in the current character set of 4D to a text expressed in another character set.

In the 4Dtext parameter, pass the text to be converted. This text is expressed in the character set of 4D. In version 11, 4D uses the Unicode character set by default.

In charSet, pass the character set to be used for the conversion. You can pass a string containing the standard name of the set (for example "ISO-8859-1" or "UTF-8"), or its MIBEnum identifier.

The standard character set names are specified by the IANA. The command accepts the main name of the character set as well as all its referenced aliases (for example, "IO-8859-1" can be named "CP819," "csISOLatin1," "latin1," or yet again "l1"). For more information about the names of character sets, please refer to the following address: http://www.iana.org/assignments/character-sets

After execution of the command, the converted text will be returned in the convertedBLOB BLOB. This BLOB can be read by the Convert to text command.

Note: This command only works when 4D is executed in Unicode mode (the Unicode option must be checked in the 4D Preferences, see the "About Unicode" section). If it is used in compatibility mode (non-Unicode), convertedBLOB is returned empty and the OK variable is set to 0.

Convert to text.

If the command has been correctly executed, the OK variable is set to 1. Otherwise, it is set to 0.