Platform Package reference: Function EwNewStringAnsi()

Welcome to Embedded Wizard

Quick Tour - a Tutorial

Working with Embedded Wizard

Build Environments

Embedded Wizard Studio

Programming language Chora

Framework Mosaic

Platform Integration Aspects

Framebuffer Concepts

Memory Footprint

Extern Bitmap interface

Implementing Prototyper intrinsics

Certification Aspects

Platform Package reference

Function EwAlloc()

Function EwAddHeapMemoryPool()

Function EwAllocUserColor()

Function EwAnyPendingSignals()

Function EwBeginUpdate()

Function EwBeginUpdateArea()

Function EwColorToIndex()

Function EwCompString()

Function EwConfigViewport()

Function EwCreateBitmap()

Function EwDoneGraphicsEngine()

Function EwDoneHeap()

Function EwDoneViewport()

Function EwDumpHeap()

Function EwEnableGfxTaskTracing()

Function EwEndUpdate()

Function EwFindUserColor()

Function EwFree()

Function EwFreeBitmap()

Function EwFreeUserColor()

Function EwGetAutoObject()

Function EwGetHeapInfo()

Function EwGetLanguage()

Function EwGetStringLength()

Function EwGetUtf8StringLength()

Function EwGetStyles()

Function EwIndexToColor()

Function EwInitGraphicsEngine()

Function EwInitHeap()

Function EwInitViewport()

Function EwLockBitmap()

Function EwLockObject()

Function EwModifyBitmapPalette()

Function EwNewColor()

Function EwNewObject()

Function EwNewObjectIndirect()

Function EwNewPoint()

Function EwNewRect()

Function EwNewString()

Function EwNewStringAnsi()

Function EwNewStringChar()

Function EwNewStringUtf8()

Function EwNextTimerExpiration()

Function EwPrintPerfCounters()

Function EwPrintProfilerStatistic()

Function EwProcessSignals()

Function EwProcessTimers()

Function EwReclaimMemory()

Function EwRegisterFlashAreaReader()

Function EwResetPerfCounters()

Function EwSetLanguage()

Function EwSetStackBaseAddress()

Function EwSetStyles()

Function EwSetUserColor()

Function EwStringToAnsi()

Function EwStringToUtf8()

Function EwUnlockBitmap()

Function EwUnlockObject()

Function EwVerifyHeap()

Basic Data Type Definitions

Type XBitmapLock

Type XViewportProc

Error and Warning Codes

Platform Package reference: Function EwNewStringAnsi()

Description of the function EwNewStringAnsi() available in all Platform Packages for 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.