C# | BitConverter.ToChar() Method

This method is used to return a Unicode character converted from two bytes at a specified position in a byte array.

Syntax:

public static char ToChar (byte[] value, int startIndex);

Parameters:



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

Return Value: This method returns a character formed by two bytes beginning at startIndex.

Exceptions:

ArgumentException: If the startIndex equals 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.ToChar(Byte[], Int32) Method:

Example 1:

filter_none

edit
close

play_arrow

link
brightness_4
code

// C# program to demonstrate
// BitConverter.ToChar(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
        for (int index = 1; index < bytes.Length - 1;
                                index = index + 2) {
  
            char values = BitConverter.ToChar(bytes, index);
            Console.WriteLine("index element   char");
            Console.WriteLine(" {0}     {1}     {2}",
                            index, bytes[index], 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("intial Array in string: {0} ",
                       BitConverter.ToString(myArr));
    Console.WriteLine();
}
}

chevron_right


Output:

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

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

index  element     char
  1      0         
index  element     char
  3      42         *
index  element     char
  5      65         A
index  element     char
  7      125         }
index  element     char
  9      197         ?
index  element     char
  11      168         ?
index  element     char
  13      41         ?
index  element     char
  15      125         ?

Example 2: For ArgumentException

filter_none

edit
close

play_arrow

link
brightness_4
code

// C# program to demonstrate
// BitConverter.ToChar(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 };
  
        // Display the values of the myArr.
        Console.Write("Initial Array: ");
  
        // calling the PrintIndexAndValues()
        // method to print
        PrintIndexAndValues(bytes);
  
        // print char value
        for (int index = 1; index < bytes.Length; 
                            index = index + 2) {
  
            if (index == bytes.Length - 1) {
                Console.WriteLine();
                Console.WriteLine("startIndex equals the "+
                               "length of value minus 1.");
                char values = BitConverter.ToChar(bytes, index);
            }
            else {
                char values = BitConverter.ToChar(bytes, index);
                Console.WriteLine("index element     char");
                Console.WriteLine(" {0}     {1}      {2}"
                                index, bytes[index], 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("intial Array in string: {0} ",
                    BitConverter.ToString(myArr));
    Console.WriteLine();
}
}

chevron_right


Output:

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

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

index  element     char
  1      0         
index  element     char
  3      42         *
index  element     char
  5      65         A
index  element     char
  7      125         }
index  element     char
  9      197         ?
index  element     char
  11      168         ?
index  element     char
  13      41         ?

startIndex equals the length of value minus 1.
Exception Thrown: System.ArgumentException

Example 3: For ArgumentOutOfRangeException

filter_none

edit
close

play_arrow

link
brightness_4
code

// C# program to demonstrate
// BitConverter.ToChar(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 };
  
        // Display the values of the myArr.
        Console.Write("Initial Array: ");
  
        // calling the PrintIndexAndValues()
        // method to print
        PrintIndexAndValues(bytes);
  
        // print char value
        for (int index = 0; index < bytes.Length + 1; 
                                 index = index + 2) {
  
            if (index == bytes.Length) {
                Console.WriteLine();
                Console.WriteLine("startIndex is greater than "+
                                "the length of value minus 1.");
                char values = BitConverter.ToChar(bytes, index);
            }
            else {
                char values = BitConverter.ToChar(bytes, index);
                Console.WriteLine("index element     char");
                Console.WriteLine(" {0}     {1}      {2}"
                                index, bytes[index], 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("intial Array in string: {0} ",
                    BitConverter.ToString(myArr));
    Console.WriteLine();
}
}

chevron_right


Output:

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

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

index  element     char
  0      32          
index  element     char
  2      0         ?
index  element     char
  4      0         ?
index  element     char
  6      0         ?
index  element     char
  8      0         ?
index  element     char
  10      0         ?
index  element     char
  12      3         ?
index  element     char
  14      4         ?

startIndex is greater than the length of value minus 1.
Exception Thrown: System.ArgumentOutOfRangeException

Example 4: For ArgumentNullException

filter_none

edit
close

play_arrow

link
brightness_4
code

// C# program to demonstrate
// BitConverter.ToChar(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 char value
  
            char values = BitConverter.ToChar(bytes, 0);
        }
        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);
        }
    }
}

chevron_right


Output:

Exception Thrown: System.ArgumentNullException

Reference:



My Personal Notes arrow_drop_up

Recommended Posts:



    Article Tags :

    Be the First to upvote.


    Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.