Open In App

C# | BitConverter.ToUInt64 Method

Improve
Improve
Like Article
Like
Save
Share
Report

This method is used to return a 64-bit unsigned integer converted from eight bytes at a specified position in a byte array.

Syntax: 

public static ulong ToUInt64 (byte[] value, int startIndex);

Parameters: 

value: It is an array of bytes. 
startIndex: It is the starting position within value
 

Return Value: This method returns a 64-bit unsigned integer formed by the eight bytes beginning at startIndex.

Exceptions:  

  • ArgumentException: If startIndex is greater than or equal to the length of value minus 7, and is less than or equal to the length of value minus 1.
  • ArgumentNullException: If the value is null.
  • ArgumentOutOfRangeException: If the startIndex is less than zero or greater than the length of value minus 1.

Below programs illustrate the use of BitConverter.ToUInt64 Method:

Example 1: 

C#




// C# program to demonstrate
// BitConverter.ToUInt64(Byte[], Int32);
// Method
using System;
   
class GFG {
   
// Main Method
public static void Main()
{
   
    try {
   
        // Define an array of byte values.
        byte[] bytes = {32, 0, 0, 42, 0, 65,
                          0, 125, 0, 197, 0, 
                     168, 3, 41, 4, 125,32};
   
        // Display the values of the myArr.
        Console.Write("Initial Array: ");
   
        // calling the PrintIndexAndValues()
        // method to print
        PrintIndexAndValues(bytes);
   
        // print char value
        Console.WriteLine("index         byte Array"+
                          "             ulong value");
           
        for (int index = 0; index < bytes.Length - 7;
                                index = index + 8) {
   
            ulong values = BitConverter.ToUInt64(bytes, index);
   
            Console.WriteLine(" {0}     {1}     {2}", index, 
                             BitConverter.ToString(bytes, 
                                      index, 8), values);
        }
    }
    catch (ArgumentNullException e) {
   
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
    catch (ArgumentOutOfRangeException e) {
   
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
    catch (ArgumentException e) {
   
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
}
   
// Defining the method
// PrintIndexAndValues
public static void PrintIndexAndValues(byte[] myArr)
{
    for (int i = 0; i < myArr.Length; i++) {
   
        Console.Write("{0} ", myArr[i]);
    }
   
    Console.WriteLine();
    Console.WriteLine();
}
}


Output: 

Initial Array: 32 0 0 42 0 65 0 125 0 197 0 168 3 41 4 125 32 

index         byte Array             ulong value
 0     20-00-00-2A-00-41-00-7D     9007270723701440544
 8     00-C5-00-A8-03-29-04-7D     9008370250328098048

 

Example 2: For ArgumentException

C#




// C# program to demonstrate
// BitConverter.ToUInt64(Byte[], Int32);
// Method
using System;
    
class GFG {
    
// Main Method
public static void Main()
{
   
    try {
   
        // Define an array of byte values.
        byte[] bytes = {32, 0, 0, 42, 0, 65,
                          0, 125, 0, 197, 0, 
                     168, 3, 41, 4, 125,32};
   
        // Display the values of the myArr.
        Console.Write("Initial Array: ");
   
        // calling the PrintIndexAndValues()
        // method to print
        PrintIndexAndValues(bytes);
   
        // print char value
        Console.WriteLine("index           element"+
                    "                 ulong value");
                       
        for (int index = 0; index < bytes.Length + 1;
                                index = index + 8) {
   
            if (index == bytes.Length) {
   
                Console.WriteLine();
                Console.WriteLine("startindex is {0} which is greater than "
                                   + "the length of Array minus 1.", index);
   
                ulong values = BitConverter.ToUInt64(bytes, index);
                   
                Console.WriteLine("  {0}      {1}      {2}", index,
                   BitConverter.ToString(bytes, index, 8), values);
            }
   
            else {
                ulong values = BitConverter.ToUInt64(bytes, index);
                   
                Console.WriteLine("  {0}      {1}      {2}", index,
                   BitConverter.ToString(bytes, index, 8), values);
            }
        }
    }
    catch (ArgumentNullException e) {
   
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
    catch (ArgumentOutOfRangeException e) {
   
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
    catch (ArgumentException e) {
   
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
}
   
// Defining the method
// PrintIndexAndValues
public static void PrintIndexAndValues(byte[] myArr)
{
    for (int i = 0; i < myArr.Length; i++) {
   
        Console.Write("{0} ", myArr[i]);
    }
   
    Console.WriteLine();
    Console.WriteLine();
    Console.WriteLine("initial Array in string: {0} ",
                      BitConverter.ToString(myArr));
    Console.WriteLine();
}
}


Output:

Initial Array: 32 0 0 42 0 65 0 125 0 197 0 168 3 41 4 125 32 

initial Array in string: 20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-7D-20 

index           element                 ulong value
  0      20-00-00-2A-00-41-00-7D      9007270723701440544
  8      00-C5-00-A8-03-29-04-7D      9008370250328098048
Exception Thrown: System.ArgumentException

Example 3: For ArgumentNullException

C#




// C# program to demonstrate
// BitConverter.ToUInt64(Byte[], Int32);
// Method
using System;
   
class GFG {
   
    // Main Method
    public static void Main()
    {
   
        try {
   
            // Define an array of byte values.
            byte[] bytes = null;
   
            // get the long value
   
            ulong values = BitConverter.ToUInt64(bytes, 0);
            Console.Write("{0}", values);
        }
        catch (ArgumentNullException e) {
   
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
        catch (ArgumentOutOfRangeException e) {
   
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
        catch (ArgumentException e) {
   
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}


Output: 

Exception Thrown: System.ArgumentNullException

 

Reference: 

 



Last Updated : 11 Jan, 2022
Like Article
Save Article
Share your thoughts in the comments
Similar Reads