C# String.TrimEnd() – Syntax & Examples

C# String.TrimEnd() – Examples

String.TrimEnd() method is used to remove all the trailing white-space characters from the current string.

String.TrimEnd(Char) method is used to remove specified character from trailing edge of the current string.

String.TrimEnd(Char[]) method is used to remove all specified characters from trailing edge of the current string.

String.TrimEnd() does not modify the original string but returns a new String instance with the trailing white-space/specified characters removed from the given string value.

In this tutorial, we will learn about the syntax of C# String.TrimEnd(), C# String.TrimEnd(Char) and C# String.TrimEnd(Char[]) method, and learn how to use these method with the help of examples.

TrimEnd()

String.TrimEnd() removes all the trailing white-space characters from the current string.

Syntax

The syntax of TrimEnd() method is

String.TrimEnd()

Return Value

This method returns String value.

Example 1 – TrimEnd()

In this example, we will take a string str with trailing white spaces. To remove these trailing white spaces, we will call TrimEnd() method on this string str. TrimEnd() returns a new String instance.

C# Program

using System;
 
class Example {
    static void Main(string[] args) {
        String str = "abc  ";
        String result = str.TrimEnd();
        Console.WriteLine($"Original String     : \"{str}\"");
        Console.WriteLine($"Result of TrimEnd() : \"{result}\"");
    }
}

Output

Original String     : "abc  "
Result of TrimEnd() : "abc"

Example 2 – TrimEnd() – No Trailing Spaces

In this example, we will take a string str with no trailing white spaces. If we call TrimEnd() method on this string str, TrimEnd() returns the original String instance on which we are calling the method. In this case alone, TrimEnd() does not create a new String.

C# Program

using System;
 
class Example {
    static void Main(string[] args) {
        String str = "abc";
        String result = str.TrimEnd();
        Console.WriteLine($"Original String     : \"{str}\"");
        Console.WriteLine($"Result of TrimEnd() : \"{result}\"");
    }
}

Output

Original String     : "abc"
Result of TrimEnd() : "abc"

Example 3 – TrimEnd() – Null String

In we call TrimEnd() method on a null String, then this method throws System.NullReferenceException.

C# Program

using System;
 
class Example {
    static void Main(string[] args) {
        String str = null;
        String result = str.TrimEnd();
        Console.WriteLine($"Original String     : \"{str}\"");
        Console.WriteLine($"Result of TrimEnd() : \"{result}\"");
    }
}

Output

Unhandled exception. System.NullReferenceException: Object reference not set to an instance of an object.
   at Example.Main(String[] args) in D:\workspace\csharp\HelloWorld\Program.cs:line 6

TrimEnd(Char)

String.TrimEnd() removes all the trailing occurrences of a character from the current string.

Syntax

The syntax of TrimEnd(Char) method is

String.TrimEnd(Char trimChar)

where

Parameter	Description
trimChar	A Unicode character to remove from trailing edge of the String.

Return Value

This method returns String value.

Example 4 – TrimEnd(Char)

In this example, we will take a string, and trim the specified character if present at the trailing edge of this string using TrimEnd(Char) method.

C# Program

using System;
 
class Example {
    static void Main(string[] args) {
        String str = "abcdeaaa";
        Char trimChar = 'a';
        String result = str.TrimEnd(trimChar);
        Console.WriteLine($"Original String     : \"{str}\"");
        Console.WriteLine($"Result of TrimEnd() : \"{result}\"");
    }
}

Output

Original String     : "abcdeaaa"
Result of TrimEnd() : "abcde"

Only the trailing edge is trimmed, not the leading edge.

TrimEnd(Char[])

String.TrimEnd() removes all the trailing occurrences of a set of characters specified in an array from the current string.

Syntax

The syntax of TrimEnd(Char[]) method is

String.TrimEnd(Char[] trimChars)

where

Parameter	Description
trimChars	The array of Unicode characters to remove from trailing edge of given string.

Return Value

This method returns String value.

Example 5 – TrimEnd(Char[])

In this example, we will take a string and remove all the trailing characters that are in the specified character array trimChars, using TrimEnd(Char[]) method.

C# Program

using System;
 
class Example {
    static void Main(string[] args) {
        String str = "abbcdeaafabab";
        Char[] trimChars = {'a', 'b'};
        String result = str.TrimEnd(trimChars);
        Console.WriteLine($"Original String     : \"{str}\"");
        Console.WriteLine($"Result of TrimEnd() : \"{result}\"");
    }
}

Output

Original String     : "abbcdeaafabab"
Result of TrimEnd() : "abbcdeaaf"

Conclusion

In this C# Tutorial, we have learnt the syntax of C# String.TrimEnd() method, and also learnt how to use this method with the help of C# example programs.