Platform Package reference: Function EwNewStringAnsi()

Description of the function EwNewStringAnsi() available in all Platform Packages for ANSI C compatible target systems. This function is intended to be used when integrating the Embedded Wizard created GUI application with the underlying graphics subsystem, graphics hardware or other external GUI applications coexisting on the same system.

Declaration

XString EwNewStringAnsi( const char* aAnsi )

Parameters

aAnsi

Pointer to a zero terminated ANSI string (8-bit per character) to create a copy.

Discussion

The function EwNewStringAnsi() creates a wide-character (16-bit per character) copy of the given ANSI (8-bit per character) string. The function reserves memory for the new string and copies all characters from aAnsi string into this reserved memory area. During the operation the function extends all ANSI characters to 16-bit wide-characters properly.

Please note, the returned string is controlled by the Embedded Wizard Runtime Environment. If not used anymore, the string is released automatically during the next EwReclaimMemory() invocation. Please see Be careful when exchanging strings.