String.Trim Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Sestavení:

netstandard.dll

Sestavení:

mscorlib.dll

Vrátí nový řetězec, ve kterém jsou odebrány všechny počáteční a koncové výskyty sady zadaných znaků z aktuálního řetězce.

Přetížení

Trim(Char[])	Odebere všechny počáteční a koncové výskyty sady znaků zadané v poli z aktuálního řetězce.
Trim(Char)	Odebere všechny počáteční a koncové instance znaku z aktuálního řetězce.
Trim()	Odebere z aktuálního řetězce všechny úvodní a koncové prázdné znaky.

Trim(Char[])

Odebere všechny počáteční a koncové výskyty sady znaků zadané v poli z aktuálního řetězce.

public:
 System::String ^ Trim(... cli::array <char> ^ trimChars);

public string Trim (params char[] trimChars);

public string Trim (params char[]? trimChars);

member this.Trim : char[] -> string

Public Function Trim (ParamArray trimChars As Char()) As String

Parametry

trimChars

Char[]

Pole znaků Unicode, které se mají odebrat, nebo null .

Návraty

String

Řetězec, který zůstane po všech výskytech znaků v parametru , se odebere ze začátku a konce trimChars aktuálního řetězce. Pokud trimChars je nebo prázdné null pole, prázdné znaky se místo toho odstraní. Pokud z aktuální instance nelze oříznuty žádné znaky, metoda vrátí aktuální instanci beze změny.

Příklady

Následující příklad používá Trim(System.Char[]) metodu pro odebrání mezer, hvězdičky (*) a apostrof (') znaků z řetězce.

using namespace System;

void main()
{
   array<Char>^ charsToTrim = { L'*', L' ', L'\\' };
   String^ banner = "*** Much Ado About Nothing ***";
   String^ result = banner->Trim(charsToTrim);
   Console::WriteLine("Trimmmed\n   {0}\nto\n   '{1}'", banner, result);
}
// The example displays the following output:
//       Trimmmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'

char[] charsToTrim = { '*', ' ', '\''};
string banner = "*** Much Ado About Nothing ***";
string result = banner.Trim(charsToTrim);
Console.WriteLine("Trimmmed\n   {0}\nto\n   '{1}'", banner, result);

// The example displays the following output:
//       Trimmmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'

Module Example
   Public Sub Main()
      Dim charsToTrim() As Char = { "*"c, " "c, "'"c}
      Dim banner As String = "*** Much Ado About Nothing ***"
      Dim result As String = banner.Trim(charsToTrim)
      Console.WriteLine("Trimmmed{0}   {1}{0}to{0}   '{2}'", _
                        vbCrLf, banner, result)
   End Sub
End Module
' The example displays the following output:
'       Trimmmed
'          *** Much Ado About Nothing ***
'       to
'          'Much Ado About Nothing'

Poznámky

Metoda odebere z aktuálního řetězce všechny úvodní a Trim(System.Char[]) koncové znaky, které jsou v trimChars parametru . Každá počáteční a koncová operace ořezávání se zastaví, když dojde k znaku, který není v trimChars . Pokud je aktuální řetězec například "123abc456xyz789" a trimChars obsahuje číslice od "1" až "9", Trim(System.Char[]) Metoda vrátí "abc456xyz".

Poznámka

Pokud Trim(System.Char[]) Metoda odebere z aktuální instance všechny znaky, tato metoda neupraví hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou odebrány všechny úvodní a koncové trimChars znaky nalezené v aktuální instanci.

Pokud se aktuální řetězec rovná Empty nebo všechny znaky v aktuální instanci sestávají ze znaků v trimChars poli, vrátí metoda Empty .

Pokud trimChars je null nebo prázdné pole, tato metoda odstraní všechny úvodní nebo koncové znaky, jejichž výsledkem je metoda vracející se, true když jsou předány Char.IsWhiteSpace metodě.

Poznámky pro volající

.NET Framework 3,5 SP1 a starší verze udržuje interní seznam prázdných znaků, který tato metoda ořízne, pokud trimChars je null nebo prázdné pole. počínaje .NET Framework 4, pokud trimChars je null nebo prázdné pole, metoda ořízne všechny prázdné znaky Unicode (tj. znaky, které vyvolávají true návratovou hodnotu, když jsou předány IsWhiteSpace(Char) metodě). z důvodu této změny Trim() metoda v .NET Framework 3,5 SP1 a dřívějších verzích odebere dva znaky, nulovou šířku (U + 200B) a nulovou šířkou mezer (u + FEFF), že Trim() metoda v .NET Framework 4and novějších verzích se neodebere. kromě toho Trim() metoda v .NET Framework 3,5 SP1 a dřívějších verzích neořízne tři prázdné znaky Unicode: mongolský oddělovač (u + 180E), zúžené místo na konci (u + 202F) a střední místo (u + 205F).

Viz také

• Char
• TrimEnd(Char[])
• TrimStart(Char[])
• IsWhiteSpace(Char)

Trim(Char)

Odebere všechny počáteční a koncové instance znaku z aktuálního řetězce.

public:
 System::String ^ Trim(char trimChar);

public string Trim (char trimChar);

member this.Trim : char -> string

Public Function Trim (trimChar As Char) As String

Parametry

trimChar

Char

Znak Unicode, který se má odebrat.

Návraty

String

Řetězec, který zůstane po odebrání všech instancí znaku ze začátku a konce trimChar aktuálního řetězce. Pokud z aktuální instance nelze oříznuty žádné znaky, metoda vrátí aktuální instanci beze změny.

Poznámky

Metoda odebere z aktuálního řetězce všechny úvodní a koncové Trim(System.Char) instance trimChar znaku. Každá počáteční a koncová operace oříznutí se zastaví, když se zjistí trimChar jiný znak než . Pokud je například a aktuální řetězec je trimChar - ---abc---xyz----, vrátí metoda Trim(System.Char) "abc---xyz". Pokud chcete odebrat znaky mezi slovy v řetězci, použijte regulární výrazy .NET.

Poznámka

Pokud metoda odebere z aktuální instance všechny znaky, tato metoda neupraví Trim(System.Char) hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou odebrány všechny úvodní a koncové znaky nalezené trimChar v aktuální instanci.

Pokud se aktuální řetězec rovná nebo se všechny znaky v Empty aktuální instanci skládají ze trimChar znaků, vrátí metoda Empty .

Trim()

Odebere z aktuálního řetězce všechny úvodní a koncové prázdné znaky.

public:
 System::String ^ Trim();

public string Trim ();

member this.Trim : unit -> string

Public Function Trim () As String

Návraty

String

Řetězec, který zůstane po odebrání všech prázdných znaků ze začátku a konce aktuálního řetězce. Pokud z aktuální instance nelze oříznuty žádné znaky, metoda vrátí aktuální instanci beze změny.

Příklady

Následující příklad používá metodu k odebrání jakýchkoli dalších mezer z řetězců zadaných uživatelem před String.Trim() jejich zřetězování.

using namespace System;

void main()
{
   Console::Write("Enter your first name: ");
   String^ firstName = Console::ReadLine();
   
   Console::Write("Enter your middle name or initial: ");
   String^ middleName = Console::ReadLine();
   
   Console::Write("Enter your last name: ");
   String^ lastName = Console::ReadLine();
   
   Console::WriteLine();
   Console::WriteLine("You entered '{0}', '{1}', and '{2}'.",
                      firstName, middleName, lastName);
   
   String^ name = ((firstName->Trim() + " " + middleName->Trim())->Trim() + " " +
                  lastName->Trim())->Trim();
   Console::WriteLine("The result is " + name + ".");
}
// The following is possible output from this example:
//       Enter your first name:    John
//       Enter your middle name or initial:
//       Enter your last name:    Doe
//       
//       You entered '   John  ', '', and '   Doe'.
//       The result is John Doe.

using System;

public class Example
{
    public static void Main()
    {
        Console.Write("Enter your first name: ");
        string firstName = Console.ReadLine();
      
        Console.Write("Enter your middle name or initial: ");
        string middleName = Console.ReadLine();
      
        Console.Write("Enter your last name: ");
        string lastName = Console.ReadLine();
      
        Console.WriteLine();
        Console.WriteLine("You entered '{0}', '{1}', and '{2}'.", 
                        firstName, middleName, lastName);
      
        string name = ((firstName.Trim() + " " + middleName.Trim()).Trim() + " " + 
                    lastName.Trim()).Trim();
        Console.WriteLine("The result is " + name + ".");

        // The following is a possible output from this example:
        //       Enter your first name:    John
        //       Enter your middle name or initial:
        //       Enter your last name:    Doe
        //       
        //       You entered '   John  ', '', and '   Doe'.
        //       The result is John Doe.
    }
}

Module Example
   Public Sub Main()
      Console.Write("Enter your first name: ")
      Dim firstName As String = Console.ReadLine()
      
      Console.Write("Enter your middle name or initial: ")
      Dim middleName As String = Console.ReadLine()
      
      Console.Write("Enter your last name: ")
      Dim lastName As String = Console.ReadLine
      
      Console.WriteLine()
      Console.WriteLine("You entered '{0}', '{1}', and '{2}'.", _
                        firstName, middleName, lastName)
                        
      Dim name As String = ((firstName.Trim() + " " + middleName.Trim()).Trim() _
                           + " " + lastName.Trim()).Trim()                        
      Console.WriteLine("The result is " + name + ".")
   End Sub
End Module
' The following is possible output from this example:
'       Enter your first name:    John
'       Enter your middle name or initial:
'       Enter your last name:    Doe
'       
'       You entered '   John  ', '', and '   Doe'.
'       The result is John Doe.

Poznámky

Metoda odebere z aktuálního řetězce všechny úvodní a koncové prázdné Trim znaky. Při použití prázdného znaku se zastaví každá počáteční a koncová operace oříznutí. Pokud je například aktuální řetězec " abc xyz ", metoda Trim vrátí "abc xyz". Pokud chcete odebrat prázdné znaky mezi slovy v řetězci, použijte regulární výrazy .NET.

Poznámka

Pokud metoda odebere z aktuální instance všechny znaky, tato metoda neupraví Trim hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou odebrány všechny úvodní a koncové prázdné znaky nalezené v aktuální instanci.

Pokud se aktuální řetězec rovná nebo se všechny znaky v aktuální instanci skládají z prázdných Empty znaků, vrátí metoda Empty .

Prázdné znaky jsou definovány standardem Unicode. Metoda Trim odebere všechny úvodní a koncové znaky, které vytvářejí návratovou hodnotu, když jsou true předány Char.IsWhiteSpace metodě.

Poznámky pro volající

Verze .NET Framework 3.5 SP1 a starší udržují interní seznam mezer, které tato metoda oříznou. Počínaje .NET Framework 4 metoda oříznou všechny prázdné znaky Unicode (to znamená znaky, které vytvářejí návratovou hodnotu, když jsou předány true IsWhiteSpace(Char) metodě ). Z důvodu této změny metoda ve verzi .NET Framework 3.5 SP1 a starších verzích odebere dva znaky: MEZERA NULOVÉ ŠÍŘKY (U+200B) a MEZERA BEZ PŘERUŠENÍ S NULOVOU ŠÍŘKOU (U+FEFF), které metoda v Trim() .NET Framework 4a novějších verzích Trim() neodebere. Kromě toho metoda v rozhraní .NET Framework 3.5 SP1 a starších verzích neořízne tři prázdné znaky Trim() Unicode: SEPARATOR VÍCE ZNAKŮ UNICODE (U+180E), ÚZKÉ MEZERY BEZ PŘERUŠENÍ (U+202F) a STŘEDNÍ MATEMATICKÝ PROSTOR (U+205F).

Viz také

• TrimEnd(Char[])
• TrimStart(Char[])
• IsWhiteSpace(Char)