WBin
Returns the binary WString (Unicode) representation of a number
Declare Function WBin ( ByVal number As UByte ) As WString
Declare Function WBin ( ByVal number As UShort ) As WString
Declare Function WBin ( ByVal number As Ulong ) As WString
Declare Function WBin ( ByVal number As ULongInt ) As WString
Declare Function WBin ( ByVal number As Const Any Ptr ) As WString
Declare Function WBin ( ByVal number As UByte, ByVal digits As Long ) As WString
Declare Function WBin ( ByVal number As UShort, ByVal digits As Long ) As WString
Declare Function WBin ( ByVal number As Ulong, ByVal digits As Long ) As WString
Declare Function WBin ( ByVal number As ULongInt, ByVal digits As Long ) As WString
Declare Function WBin ( ByVal number As Const Any Ptr, ByVal digits As Long ) As WString
result = WBin( number [, digits] )
number
Returns a binary WString representation of number, truncated or padded with zeros ("0") to fit the number of digits, if specified.
Returns a WString (Unicode) representing the binary value of the integer number. Binary digits range from 0 to 1.
If you specify digits > 0, the result wstring will be exactly that length. It will be truncated or padded with zeros on the left, if necessary.
The length of the returned string will not be longer than the maximum number of digits required for the type of expression (32 for a Long, 64 for floating point or LongInt)
will produce the output:
Syntax
Declare Function WBin ( ByVal number As UByte ) As WString
Declare Function WBin ( ByVal number As UShort ) As WString
Declare Function WBin ( ByVal number As Ulong ) As WString
Declare Function WBin ( ByVal number As ULongInt ) As WString
Declare Function WBin ( ByVal number As Const Any Ptr ) As WString
Declare Function WBin ( ByVal number As UByte, ByVal digits As Long ) As WString
Declare Function WBin ( ByVal number As UShort, ByVal digits As Long ) As WString
Declare Function WBin ( ByVal number As Ulong, ByVal digits As Long ) As WString
Declare Function WBin ( ByVal number As ULongInt, ByVal digits As Long ) As WString
Declare Function WBin ( ByVal number As Const Any Ptr, ByVal digits As Long ) As WString
Usage
result = WBin( number [, digits] )
Parameters
number
A whole number or expression evaluating to a whole number.
digitsOptional number of digits to return.
Return Value
Returns a binary WString representation of number, truncated or padded with zeros ("0") to fit the number of digits, if specified.
Description
Returns a WString (Unicode) representing the binary value of the integer number. Binary digits range from 0 to 1.
If you specify digits > 0, the result wstring will be exactly that length. It will be truncated or padded with zeros on the left, if necessary.
The length of the returned string will not be longer than the maximum number of digits required for the type of expression (32 for a Long, 64 for floating point or LongInt)
Example
Print WBin(54321)
Print WBin(54321, 5)
Print WBin(54321, 20)
Print WBin(54321, 5)
Print WBin(54321, 20)
will produce the output:
1101010000110001 10001 00001101010000110001
Platform Differences
- Unicode strings are not supported in the DOS port of FreeBASIC.
Dialect Differences
- Not available in the -lang qb dialect unless referenced with the alias __Wbin.
Differences from QB
- New to FreeBASIC
See also