UInt16.Parse(String) Method in C# with Examples

UInt16.Parse(String) Method is used to convert the string representation of a number to its 16-bit unsigned integer equivalent.

Syntax:

public static ushort Parse (string str);

Here, str is a string containing a number to convert. The format of str will be [optional white space][optional sign]digits[optional white space]. The sign can be positive or negative. But negative sign can be used only with zero otherwise it will throw an OverflowException.

Return Value: It is a 16-bit unsigned integer equivalent to the number contained in str.

Exceptions:

• ArgumentNullException: If str is null.
• FormatException: If str is not in the correct format.
• OverflowException: If str represents a number less than MinValue or greater than MaxValue.

Below programs illustrate the use of above-discussed method:

Example 1:

// C# program to demonstrate
// UInt16.Parse(String) Method
using System;

class GFG {

    // Main Method
    public static void Main()
    {

        // passing different values
        // to the method to check
        checkParse("65535");
        checkParse("15,784");
        checkParse("-4589");
        checkParse(" 785");
    }

    // Defining checkParse method
    public static void checkParse(string input)
    {

        try {

            // declaring UInt16 variable
            ushort val;

            // getting parsed value
            val = UInt16.Parse(input);
            Console.WriteLine("'{0}' parsed as {1}", input, val);
        }

        catch (OverflowException) {
            Console.WriteLine("Can't Parsed '{0}'", input);
        }

        catch (FormatException) {
            Console.WriteLine("Can't Parsed '{0}'", input);
        }
    }
}

Output:

'65535' parsed as 65535
Can't Parsed '15,784'
Can't Parsed '-4589'
' 785' parsed as 785

Example 2: For ArgumentNullException

// C# program to demonstrate
// UInt16.Parse(String) Method
// for ArgumentNullException
using System;

class GFG {

    // Main Method
    public static void Main()
    {

        try {

            // passing null value as a input
            checkParse(null);
        }

        catch (ArgumentNullException e) {

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

        catch (FormatException e) {

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

    // Defining checkparse method
    public static void checkParse(string input)
    {

        // declaring UInt16 variable
        ushort val;

        // getting parsed value
        val = UInt16.Parse(input);
        Console.WriteLine("'{0}' parsed as {1}", input, val);
    }
}

Output:

Exception Thrown: System.ArgumentNullException

Reference:

• https://docs.microsoft.com/en-us/dotnet/api/system.uint16.parse?view=netframework-4.7.2#System_UInt16_Parse_System_String_