Asn1Util Class Reference

List of all members.

Static Public Member Functions

static System.String BCDToString (byte[] bcd)
static byte[] DecodeBase64Array (byte[] srcArray)
static byte[] EncodeBase64Array (byte[] srcArray)
static byte[] GetAddressBytes (string ipaddress)
static int GetBytesCount (long val)
static int GetUlongBytesCount (long val)
static byte[] StringToBCD (System.String str)
static byte[] StringToTBCD (System.String str)
static String StripWhitespace (String value)
static System.String TBCDToString (byte[] bcd)
static void ToArray (System.Collections.ICollection c, System.Object[] objects)
static byte[] ToByteArray (System.String sourceString)
static char[] ToCharArray (byte[] byteArray)
static System.String ToHexString (byte[] b, int offset, int nbytes, bool spaces)
static System.String ToHexString (byte[] b, int offset, int nbytes)
static System.String ToHexString (byte b)
static long URShift (long number, long bits)
static long URShift (long number, int bits)
static int URShift (int number, long bits)
static int URShift (int number, int bits)
static void WriteStackTrace (System.Exception throwable, System.IO.TextWriter stream)

Detailed Description

This class contains some general purpose static utility functions.

Member Function Documentation

static System.String BCDToString ( byte[]  bcd  )  [static]

Translates a BCD string to an ASCII string. The 0xF half-byte is assumed as end of string indicator.

Parameters:
bcd the source BCD string
Returns:
the ASCII string.
static byte [] DecodeBase64Array ( byte[]  srcArray  )  [static]

Translates the specified Base64 array into byte array. The resulting array could be converted to the String by new String (byte[]) constructor.

Parameters:
srcArray Base64 byte array to be translated
Returns:
decoded byte array
static byte [] EncodeBase64Array ( byte[]  srcArray  )  [static]

Translates the specified byte array to Base64 byte array. The resulting array could be converted to the String by new String (byte[]) constructor.

Parameters:
srcArray byte array to be translated
Returns:
Base64 encoded byte array
static byte [] GetAddressBytes ( string  ipaddress  )  [static]

Converts an IPaddress to byte array

Parameters:
ipaddress String representation of IP Address
Returns:
The byte array(size 4) represenation of IP address
static int GetBytesCount ( long  val  )  [static]

Calculate the number of bytes necessary to represent a signed long value.

Parameters:
val singed long value.
Returns:
the number of bytes.
static int GetUlongBytesCount ( long  val  )  [static]

Calculate the number of bytes necessary to represent an unsigned long value.

Parameters:
val unsinged long value.
Returns:
the number of bytes.
static byte [] StringToBCD ( System.String  str  )  [static]

Translates an ASCII string to a BCD string. The ASCII string must contain only characters in the range [0..9] & ([A..F] | [a..f]). If the length of the source string is not even, the unused part of the last byte will be set to 0xF.

Parameters:
str the source ASCII string
Returns:
the BCD string as a byte array.
Exceptions:
Asn1ValueParseException If invalid characters are in the source string.
static byte [] StringToTBCD ( System.String  str  )  [static]

Translates an ASCII string to a TBCD string. The ASCII string must contain only characters in the range [0..9] & ([A..F] | [a..f]). If the length of the source string is not even, the unused part of the last byte will be set to 0xF. TBCD strings differ from BCD strings in that the least significant nibble is set in the upper four bits; so the string "12345" would be translated "0x2143f5".

Parameters:
str the source ASCII string
Returns:
the TBCD string as a byte array.
Exceptions:
Asn1ValueParseException If invalid characters are in the source string.
static String StripWhitespace ( String  value  )  [static]

Return the given string with all whitespace characters removed. Here, "whitespace characters" means those characters defined by X.680 12.1.6 as whitespace: HT, LF, VT, FF, CR, SPACE.

Returns:
value, with all whitespace removed; if the input string has no whitespace, it is returned itself.
static System.String TBCDToString ( byte[]  bcd  )  [static]

Translates a TBCD string to an ASCII string. The 0xF half-byte is assumed as end of string indicator.

Parameters:
bcd the source TBCD string
Returns:
the ASCII string.
static void ToArray ( System.Collections.ICollection  c,
System.Object[]  objects 
) [static]

Obtains an array containing all the elements of the collection.

Parameters:
c The Collection instance, which contains the elements.
objects The array into which the elements of the collection will be stored.
Returns:
The array containing all the elements of the collection.
static byte [] ToByteArray ( System.String  sourceString  )  [static]

Converts a string to an array of bytes

Parameters:
sourceString The string to be converted
Returns:
The new array of bytes
static char [] ToCharArray ( byte[]  byteArray  )  [static]

Converts an array of bytes to an array of chars

Parameters:
byteArray The array of bytes to convert
Returns:
The new array of chars
static System.String ToHexString ( byte[]  b,
int  offset,
int  nbytes,
bool  spaces 
) [static]

Convert a array of bytes into a hex string.

Parameters:
b byte array to be converted to hex string
offset start position in byte array
nbytes no. of bytes to be converted
spaces Pass true if each byte's hex digits should be followed by a space character.
Returns:
Hex String value
static System.String ToHexString ( byte[]  b,
int  offset,
int  nbytes 
) [static]

Convert a array of bytes into a hex string.

Parameters:
b byte array to be converted to hex string
offset start position in byte array
nbytes no. of bytes to be converted
Returns:
Hex String value
static System.String ToHexString ( byte  b  )  [static]

Convert a byte value to a hex string. Unlike the C# built-in function, this will:

a. not sign extend the byte value out to 32 bits if the MSB is set, and b. put a zero padding byte in front if less than 0xf

In other words, a character string of length 2 is always returned.

Parameters:
b byte value
Returns:
Hex String value
static long URShift ( long  number,
long  bits 
) [static]

Performs an unsigned bitwise right shift with the specified number The low-order bits of number are discarded, the remaining bits are shifted right, and the high-order empty bit positions are set to zero.

Parameters:
number Number to operate on
bits Ammount of bits to shift
Returns:
The resulting number from the shift operation
static long URShift ( long  number,
int  bits 
) [static]

Performs an unsigned bitwise right shift with the specified number The low-order bits of number are discarded, the remaining bits are shifted right, and the high-order empty bit positions are set to zero.

Parameters:
number Number to operate on
bits Ammount of bits to shift
Returns:
The resulting number from the shift operation
static int URShift ( int  number,
long  bits 
) [static]

Performs an unsigned bitwise right shift with the specified number The low-order bits of number are discarded, the remaining bits are shifted right, and the high-order empty bit positions are set to zero.

Parameters:
number Number to operate on
bits Ammount of bits to shift
Returns:
The resulting number from the shift operation
static int URShift ( int  number,
int  bits 
) [static]

Performs an unsigned bitwise right shift with the specified number. The low-order bits of number are discarded, the remaining bits are shifted right, and the high-order empty bit positions are set to zero.

Parameters:
number Number to operate on
bits Ammount of bits to shift
Returns:
The resulting number from the shift operation
static void WriteStackTrace ( System.Exception  throwable,
System.IO.TextWriter  stream 
) [static]

Writes the exception stack trace to the received stream

Parameters:
throwable Exception to obtain information from
stream Output sream used to write to