Removes all occurrences of a set of characters specified in an array from the end of this instance.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Visual Basic (Declaration)
Public Function TrimEnd ( _
ParamArray trimChars As Char() _
) As String
Dim instance As String
Dim trimChars As Char()
Dim returnValue As String
returnValue = instance.TrimEnd(trimChars)
public string TrimEnd (
params char[] trimChars
)
public:
String^ TrimEnd (
... array<wchar_t>^ trimChars
)
public String TrimEnd (
char[] trimChars
)
public function TrimEnd (
... trimChars : char[]
) : String
Parameters
- trimChars
An array of Unicode characters to be removed or a null reference (Nothing in Visual Basic).
Return Value
The String that remains after all occurrences of the characters in trimChars are removed from the end. If trimChars is a null reference (Nothing in Visual Basic), white space characters are removed instead.
For more information about what Unicode characters are categorized as white space characters, see the Remarks section of the Trim method overload.
The following code example demonstrates how you can use the TrimEnd method overload to trim white space or other characters from the end of a string.
Imports System
Public Class TrimTest
Public Shared Sub Main()
Dim temp As String() = MakeArray()
Console.WriteLine("Concatenating the inital values in the array, we get the string:")
Console.WriteLine("'{0}'{1}", [String].Concat(temp), Environment.NewLine)
Dim i As Integer
' trim whitespace from both ends of the elements
For i = 0 To temp.Length - 1
temp(i) = temp(i).Trim()
Next i
Console.WriteLine("Concatenating the trimmed values in the array, we get the string:")
Console.WriteLine("'{0}'{1}", [String].Concat(temp), Environment.NewLine)
' reset the array
temp = MakeArray()
' trim the start of the elements. Passing null trims whitespace only
For i = 0 To temp.Length - 1
temp(i) = temp(i).TrimStart(" "c)
Next i
Console.WriteLine("Concatenating the start-trimmed values in the array, we get the string:")
Console.WriteLine("'{0}'{1}", [String].Concat(temp), Environment.NewLine)
' reset the array
temp = MakeArray()
' trim the end of the elements. Passing null trims whitespace only
For i = 0 To temp.Length - 1
temp(i) = temp(i).TrimEnd(" "c)
Next i
Console.WriteLine("Concatenating the end-trimmed values in the array, we get the string:")
Console.WriteLine("'{0}'", [String].Concat(temp))
End Sub 'Main
Private Shared Function MakeArray() As String()
Dim arr As String() = {" please ", " tell ", " me ", " about ", " yourself "}
Return arr
End Function 'MakeArray
End Class 'TrimTest
using System;
public class TrimTest {
public static void Main() {
string [] temp = MakeArray();
Console.WriteLine("Concatenating the inital values in the array, we get the string:");
Console.WriteLine("'{0}'{1}", String.Concat(temp), Environment.NewLine);
// trim whitespace from both ends of the elements
for (int i = 0; i < temp.Length; i++)
temp[i] = temp[i].Trim();
Console.WriteLine("Concatenating the trimmed values in the array, we get the string:");
Console.WriteLine("'{0}'{1}", String.Concat(temp), Environment.NewLine);
// reset the array
temp = MakeArray();
// trim the start of the elements. Passing null trims whitespace only
for (int i = 0; i < temp.Length; i++)
temp[i] = temp[i].TrimStart(null);
Console.WriteLine("Concatenating the start-trimmed values in the array, we get the string:");
Console.WriteLine("'{0}'{1}", String.Concat(temp), Environment.NewLine);
// reset the array
temp = MakeArray();
// trim the end of the elements. Passing null trims whitespace only
for (int i = 0; i < temp.Length; i++)
temp[i] = temp[i].TrimEnd(null);
Console.WriteLine("Concatenating the end-trimmed values in the array, we get the string:");
Console.WriteLine("'{0}'", String.Concat(temp));
}
private static string [] MakeArray() {
string [] arr = {" please ", " tell ", " me ", " about ", " yourself "};
return arr;
}
}
using namespace System;
array<String^>^ MakeArray()
{
array<String^>^arr = {" please "," tell "," me "," about "," yourself "};
return arr;
}
int main()
{
array<String^>^temp = MakeArray();
Console::WriteLine( "Concatenating the inital values in the array, we get the string:" );
Console::WriteLine( "'{0}'\n", String::Concat( temp ) );
// trim whitespace from both ends of the elements
for ( int i = 0; i < temp->Length; i++ )
temp[ i ] = temp[ i ]->Trim();
Console::WriteLine( "Concatenating the trimmed values in the array, we get the string:" );
Console::WriteLine( "'{0}'", String::Concat( temp ) );
// reset the array
temp = MakeArray();
// trim the start of the elements-> Passing 0 trims whitespace only
for ( int i = 0; i < temp->Length; i++ )
temp[ i ] = temp[ i ]->TrimStart( 0 );
Console::WriteLine( "Concatenating the start-trimmed values in the array, we get the string:" );
Console::WriteLine( "'{0}'\n", String::Concat( temp ) );
// reset the array
temp = MakeArray();
// trim the end of the elements-> Passing 0 trims whitespace only
for ( int i = 0; i < temp->Length; i++ )
temp[ i ] = temp[ i ]->TrimEnd( 0 );
Console::WriteLine( "Concatenating the end-trimmed values in the array, we get the string:" );
Console::WriteLine( "'{0}'", String::Concat( temp ) );
}
import System.*;
public class TrimTest
{
public static void main(String[] args)
{
String temp[] = MakeArray();
Console.WriteLine("Concatenating the inital values in the array,"
+ " we get the string:");
Console.WriteLine("'{0}'{1}", String.Concat(temp),
Environment.get_NewLine());
// trim whitespace from both ends of the elements
for (int i = 0; i < temp.get_Length(); i++) {
temp.set_Item(i, temp[i].Trim());
}
Console.WriteLine("Concatenating the trimmed values in the array,"
+ " we get the string:");
Console.WriteLine("'{0}'{1}", String.Concat(temp),
Environment.get_NewLine());
// reset the array
temp = MakeArray();
// trim the start of the elements. Passing null trims whitespace only
for (int i = 0; i < temp.get_Length(); i++) {
temp.set_Item(i, temp[i].TrimStart(null));
}
Console.WriteLine("Concatenating the start-trimmed values in the "
+ "array, we get the string:");
Console.WriteLine("'{0}'{1}", String.Concat(temp),
Environment.get_NewLine());
// reset the array
temp = MakeArray();
// trim the end of the elements. Passing null trims whitespace only
for (int i = 0; i < temp.get_Length(); i++) {
temp.set_Item(i, temp[i].TrimEnd(null));
}
Console.WriteLine("Concatenating the end-trimmed values in the array,"
+ " we get the string:");
Console.WriteLine("'{0}'", String.Concat(temp));
} //main
private static String[] MakeArray()
{
String arr[] = { " please ", " tell ", " me ",
" about ", " yourself " };
return arr;
} //MakeArray
} //TrimTest
import System;
public class TrimTest {
public static function Main() : void {
var temp : String [] = MakeArray();
Console.WriteLine("Concatenating the inital values in the array, we get the string:");
Console.WriteLine("'{0}'{1}", String.Concat(temp), Environment.NewLine);
// trim whitespace from both ends of the elements
for (var i : int = 0; i < temp.Length; i++)
temp[i] = temp[i].Trim();
Console.WriteLine("Concatenating the trimmed values in the array, we get the string:");
Console.WriteLine("'{0}'{1}", String.Concat(temp), Environment.NewLine);
// reset the array
temp = MakeArray();
var c : char[] = undefined;
// trim the start of the elements. Passing null trims whitespace only
for (i = 0; i < temp.Length; i++)
temp[i] = temp[i].TrimStart(c);
Console.WriteLine("Concatenating the start-trimmed values in the array, we get the string:");
Console.WriteLine("'{0}'{1}", String.Concat(temp), Environment.NewLine);
// reset the array
temp = MakeArray();
// trim the end of the elements. Passing null trims whitespace only
for (i = 0; i < temp.Length; i++)
temp[i] = temp[i].TrimEnd(c);
Console.WriteLine("Concatenating the end-trimmed values in the array, we get the string:");
Console.WriteLine("'{0}'", String.Concat(temp));
}
private static function MakeArray() : String [] {
var arr : String [] = [" please ", " tell ", " me ", " about ", " yourself "];
return arr;
}
}
TrimTest.Main();
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
.NET Framework
Supported in: 2.0, 1.1, 1.0
.NET Compact Framework
Supported in: 2.0, 1.0