WStr

FreeBASIC

previous page next page

WStr

Returns a wide-character string representation of a number or ASCII character string

Syntax

Declare Function WStr ( ByVal n As Byte ) As WString Declare Function WStr ( ByVal n As UByte ) As WString Declare Function WStr ( ByVal n As Short ) As WString Declare Function WStr ( ByVal n As UShort ) As WString Declare Function WStr ( ByVal n As Long ) As WString Declare Function WStr ( ByVal n As Ulong ) As WString Declare Function WStr ( ByVal n As LongInt ) As WString Declare Function WStr ( ByVal n As ULongInt ) As WString Declare Function WStr ( ByVal n As Single ) As WString Declare Function WStr ( ByVal n As Double ) As WString Declare Function WStr ( ByRef str As Const String ) As WString Declare Function WStr ( ByVal str As Const WString Ptr ) As WString

Usage

result = WStr( number ) or result = WStr( string )

Parameters

number

Numeric expression to convert to a wide-character string.

string

String expression to convert to a wide-character string.

Return Value

Returns the wide-character representation of the numeric or string expression.

Description

WStr converts numeric variables to their wide-character string representation. It is the wide-character equivalent to Str.

WStr also converts ASCII character strings to Unicode character strings. If a wide-character string is given, that string is returned unmodified.

Example

#if defined( __FB_WIN32__ ) #include "windows.bi" #endif Dim zs As ZString * 20 Dim ws As WString * 20 zs = "Hello World" ws = WStr(zs) #if defined( __FB_WIN32__ ) MessageBox(null, ws, WStr("Unicode 'Hello World'"), MB_OK Or MB_ICONINFORMATION) #else Print ws Print WStr("Unicode 'Hello World'") #endif

Platform Differences

DOS does not support WStr.

Dialect Differences

Not available in the -lang qb dialect unless referenced with the alias __Wstr.

Differences from QB

New to FreeBASIC