GoFiler Legato Script Reference   Legato v 1.5d Application v 5.25a

Table of Contents	< < Previous	Next >>

 

Chapter Five — General Functions (continued)

AnsiToUnicode Function

Overview

The AnsiToUnicode function takes an 8-bit string in ANSI/ISO-8859-1 coding and translates it to Unicode-16.

Syntax/Parameters

Syntax

wstring = AnsiToUnicode ( string data );

Parameters

data

A string containing ANSI text to convert.

Return Value

Returns a wstring containing the converted string. Use the IsError, IsNotError and GetLastError functions to determine if an error occurred and to retrieve a formatted error code.

Remarks

The function moves through the source data and promotes ANSI special characters to Unicode character positions while converting each 8-bit byte to a 16-bit word. Unicode shares the ASCII and ISO Latin portion of ANSI characters but typographical and special characters must be converted.

The conversion differs from simply converting 8-bit characters to 16-bit characters. Also note that there a number of undefined positions in ANSI, if present those characters are converted to Ctrl+? (0x1F) characters. When characters cannot be converted, an error condition is set and the number of failed conversion in the low word of the error code.

Related Functions

AnsiToUTF — Converts an ANSI encoded string to UTF-8.

EntitiesToUTF — Converts a string with character entities to a UTF-8 string.

UnicodeToAnsi — Converts a Unicode string to ANSI.

UnicodeToUTF — Converts a Unicode string to UTF-8.

UTFToAnsi — Converts a string containing UTF-8 encoding to ANSI.

UTFToEntities — Converts a string containing UTF-8 encoding to SGML character entities.

UTFToUnicode — Converts Unicode Formatted Text string to Unicode.

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic

 

Table of Contents	< < Previous	Next >>

GoFiler Legato Script Reference — Generated on 12/16/2024

© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.