C# | Char.ConvertFromUtf32(Int32) Method

This method is used to converts the specified Unicode code point into a UTF-16 encoded string.
Syntax:

public static string ConvertFromUtf32 (int utf32);

Here, utf32 is a 21-bit Unicode code point.
Return Value: This method returns a string consisting of one Char object or a surrogate pair of Char objects equivalent to the code point specified by the utf32 parameter.
Exception: This method returns the ArgumentOutOfRangeException if utf32 is not a valid 21-bit Unicode code point ranging from U+0 through U+10FFFF, excluding the surrogate pair range from U+D800 through U+DFFF.
Below programs illustrate the use of Char.ConvertFromUtf32(Int32) Method:
Example 1:

csharp

// C# program to demonstrate
// Char.ConvertFromUtf32(Int32)
// Method
using System;
using System.Globalization;

class GFG {

    // Main Method
    public static void Main()
    {
        try {

            // declaring and initializing
            // int variablewith 21 bit
            // unicode
            int utf = 0x0042;

            // getting the value
            // using ConvertFromUtf32()
            string value = Char.ConvertFromUtf32(utf);

            // Display the value
            Console.WriteLine("value is {0}", value);
        }
        catch (ArgumentOutOfRangeException e) {

            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

Output:

value is B

Example 2: For ArgumentOutOfRangeException

csharp

// C# program to demonstrate
// Char.ConvertFromUtf32(Int32)
// Method
using System;
using System.Globalization;

class GFG {

    // Main Method
    public static void Main()
    {
        try {

            // declaring and initializing
            // int variable with 21 bit
            // unicode
            int utf = 0x11FFFF;

            // getting the value
            // using ConvertFromUtf32()
            Console.WriteLine("0x11FFFF is exceeding the limit");
            string value = Char.ConvertFromUtf32(utf);

            // Display the value
            Console.WriteLine("value is {0}", value);
        }
        catch (ArgumentOutOfRangeException e) {

            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

Output

0x11FFFF is exceeding the limit
Exception Thrown: System.ArgumentOutOfRangeException

Reference:

• https://docs.microsoft.com/en-us/dotnet/api/system.char.convertfromutf32?view=netframework-4.7.2