version 11 (Modified)
ISO to Mac (text) String
Parameter | Type | Description | |
text | String | Text expressed using standard Web character set | |
Function result | String | Text expressed using Mac OS ASCII map |
Compatibility Note: This command only works when the database is executed in ASCII compatibility mode. In Unicode mode, it does nothing (the text string is returned without modification). Beginning with version 11 of 4D, this command is thus obsolete and its use is no longer recommended. It is recommended to convert character strings using the CONVERT FROM TEXT or Convert to text commands.
Description
The ISO to Mac command returns text, expressed using the Mac OS ASCII map, equivalent to the text you pass in text, expressed using the ISO Latin-1 character map.
You will generally not need to use this command.
This command expects a text parameter expressed using the ISO Latin-1 character map.
4D converts characters received from and sent to a Web Browser. As a result, the text values you deal with, inside a Web Connection process, are always expressed using the Mac OS ASCII map.
Generally, when running on Windows, you do not need to convert ASCII codes. In ASCII compatibility mode (non-Unicode), when you copy or paste text between 4D and Windows or when you import or export data, 4D automatically performs these conversions. However, when you use disk read/write commands such as SEND PACKET or RECEIVE PACKET, 4D does not perform any ASCII code conversion.
Within 4D, all the text values, fields, or variables that you have not yet converted to another ASCII map are Mac OS-encoded on both Macintosh and Windows. For more information, see the ASCII Codes section.
On Windows, it is necessary that, in this case, you do not filter the characters using an output filter ASCII map.
Consequently, no matter what the platform, if you want to use RECEIVE PACKET to read ISO Latin-1 HTML documents from the disk, you just need to convert the text using ISO to Mac. This is the main purpose of the ISO to Mac command.
Example
The following line of code converts the (assumed) ISO Latin-1 encoded text stored in vtSomeText into a Mac OS encoded text:
RECEIVE PACKET ($vhDocRef;vtSomeText;16*1024) ` Read some text from an ISO Latin-1 HTML document vtSomeText:=ISO to Mac(vtSomeText)
See Also
ASCII Codes, Mac to ISO, RECEIVE PACKET, USE CHARACTER SET.