WStr

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

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal n KeyPgAsAs KeyPgByteByte ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal n KeyPgAsAs KeyPgUbyteUByte ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal n KeyPgAsAs KeyPgShortShort ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal n KeyPgAsAs KeyPgUshortUShort ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal n KeyPgAsAs KeyPgLongLong ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal n KeyPgAsAs KeyPgUlongULong ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal n KeyPgAsAs KeyPgLongintLongInt ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal n KeyPgAsAs KeyPgUlongintULongInt ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal n KeyPgAsAs KeyPgSingleSingle ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal n KeyPgAsAs KeyPgDoubleDouble ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByrefByRef str KeyPgAsAs KeyPgConstQualifierConst KeyPgStringString ) KeyPgAsAs KeyPgWstringWString
	KeyPgDeclareDeclare KeyPgFunctionFunction WStr ( KeyPgByvalByVal str KeyPgAsAs KeyPgConstQualifierConst KeyPgWstringWString KeyPgPtrPtr ) KeyPgAsAs KeyPgWstring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 KeyPgStr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 CompilerOptlang-lang qb dialect unless referenced with the 
	  alias __Wstr.

Differences from QB
	* New to FreeBASIC

See also
	* KeyPgStrStr
	* KeyPgWstringWString

