WorksheetFunction.Hex2Bin(Object, Object) Method

Definition

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Converts a hexadecimal number to binary.

public string Hex2Bin (object Arg1, object Arg2);

Public Function Hex2Bin (Arg1 As Object, Optional Arg2 As Object) As String

Parameters

Arg1

Object

Number - the hexadecimal number you want to convert. Number cannot contain more than 10 characters. The most significant bit of number is the sign bit (40th bit from the right). The remaining 9 bits are magnitude bits. Negative numbers are represented using two's-complement notation.

Arg2

Object

Places - the number of characters to use. If places is omitted, Hex2Bin uses the minimum number of characters necessary. Places is useful for padding the return value with leading 0s (zeros).

Returns

String

Remarks

If number is negative, Hex2Bin ignores places and returns a 10-character binary number.

If number is negative, it cannot be less than FFFFFFFE00, and if number is positive, it cannot be greater than 1FF.

If number is not a valid hexadecimal number, Hex2Bin returns the #NUM! error value.

If Hex2Bin requires more than places characters, it returns the #NUM! error value. If places is not an integer, it is truncated.

If places is nonnumeric, Hex2Bin returns the #VALUE! error value.

If places is negative, Hex2Bin returns the #NUM! error value.