GoFiler Legato Script Reference   Legato v 1.5b Application v 5.24b

Table of Contents	< < Previous	Next >>

 

Chapter Five — General Functions (continued)

XMLTextToANSI Function

Overview

The XMLTextToANSI function converts XML character entities to ANSI text.

Syntax/Parameters

Syntax

string = XMLTextToANSI ( string data );

Parameters

data

A string to convert.

Return Value

Returns a string containing data converted. Use the IsError and GetLastError functions to retrieve error information.

If the string overflows, the buffer will be clipped near the 2MB limit.

Remarks

The XMLTextToANSI function is meant to process well formed ANSI data from XML. It converts SGML escaped characters (‘<’, ‘>’, and ‘&’) to ANSI. This function does not convert HTML named character entities. Erroneous character will be replaced with ‘?’ characters. Unicode characters will be down converted to ANSI characters as possible. Codes that cannot be converted are treated as errors. See the SGML chapter for a more comprehensive conversion.

The maximum size of the string is 2MB.

Note that the error count will be in the lower portion of the error code returned by the GetLastError function (and & with ERROR_CODE_MASK to remove the error code).

Related Functions

ANSITextToXML — Converts an ANSI string to XML CDATA.

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

CharacterEntityToValue — Converts an XML or HTML character entity to a character value.

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

ValueToCharacterEntity — Converts a character to a character entity value.

XMLTextToUTF — Converts XML text to an UTF-8 string.

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 10/21/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.