String.Trim Metoda

Definice

Vrátí nový řetězec, ve kterém budou 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é instance znaku z aktuálního řetězce.

Trim(ReadOnlySpan<Char>)

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

Trim()

Odebere z aktuálního řetězce všechny počáteční 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.

Trim(Char)

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

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

C#
public string Trim (char trimChar);

Parametry

trimChar
Char

Znak Unicode, který chcete odebrat.

Návraty

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

Poznámky

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

Poznámka

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

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

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Trim(ReadOnlySpan<Char>)

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

C#
public string Trim (scoped ReadOnlySpan<char> trimChars);

Parametry

trimChars
ReadOnlySpan<Char>

Rozsah znaků Unicode, které chcete odebrat.

Návraty

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

Platí pro

.NET 9
Produkt Verze
.NET 9

Trim()

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

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

C#
public string Trim ();

Návraty

Řetězec, který zůstane za všemi prázdnými znaky, se odebere ze začátku a konce aktuálního řetězce. Pokud nelze oříznout žádné znaky z aktuální instance, vrátí metoda aktuální instanci beze změny.

Příklady

Následující příklad používá metodu String.Trim() k odebrání nadbytečných prázdných znaků z řetězců zadaných uživatelem před jejich zřetězením.

C#
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.
    }
}

Poznámky

Metoda Trim odebere z aktuálního řetězce všechny počáteční a koncové prázdné znaky. Každá počáteční a koncová operace oříznutí se zastaví, když dojde k neprázdné znaky. 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ích výrazů .NET.

Poznámka

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

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

Prázdné znaky jsou definovány standardem Unicode. Metoda Trim odebere všechny počáteční a koncové znaky, které generují návratovou hodnotu true při jejich předání metodě Char.IsWhiteSpace.

Poznámky pro volající

Rozhraní .NET Framework 3.5 SP1 a starší verze udržují interní seznam prázdných znaků, které tato metoda oříznou. Počínaje rozhraním .NET Framework 4 metoda ořízne všechny znaky prázdného znaku Unicode (tj. znaky, které generují true návratovou hodnotu při jejich předání do metody IsWhiteSpace(Char)). Z důvodu této změny odebere metoda Trim() v rozhraní .NET Framework 3.5 SP1 a starších verzích dva znaky, MEZERA S NULOVOU ŠÍŘKOU (U+200B) a NULOVÁ ŠÍŘKA NO-BREAK MEZERA (U+FEFF), že metoda Trim() v rozhraní .NET Framework 4 a novějších verzích neodebere. Kromě toho Trim() metoda v rozhraní .NET Framework 3.5 SP1 a starších verzích neořízne tři znaky prázdné znaky Unicode: MONGOLN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F) a STŘEDNÍ MATEMATICKÝ PROSTOR (U+205F).

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Trim(Char[])

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

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

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

Parametry

trimChars
Char[]

Pole znaků Unicode k odebrání nebo null.

Návraty

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

Příklady

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

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

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

Poznámky

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

Poznámka

Pokud metoda Trim(System.Char[]) odebere všechny znaky z aktuální instance, tato metoda nezmění hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou odebrány všechny počáteční 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 se skládají ze znaků v poli trimChars, metoda vrátí Empty.

Pokud je trimCharsnull nebo prázdné pole, tato metoda odebere všechny počáteční nebo koncové znaky, které vrátí metodu vracející true při jejich předání do metody Char.IsWhiteSpace.

Poznámky pro volající

Rozhraní .NET Framework 3.5 SP1 a starší verze udržuje interní seznam prázdných znaků, které tato metoda oříznou, pokud je trimCharsnull nebo prázdné pole. Počínaje rozhraním .NET Framework 4, pokud je trimCharsnull nebo prázdné pole, metoda ořízne všechny znaky prázdného znaku Unicode (tj. znaky, které vytvářejí true návratovou hodnotu při jejich předání metodě IsWhiteSpace(Char)). Z důvodu této změny odebere metoda Trim() v rozhraní .NET Framework 3.5 SP1 a starších verzích dva znaky, MEZERA S NULOVOU ŠÍŘKOU (U+200B) a NULOVÁ ŠÍŘKA NO-BREAK MEZERA (U+FEFF), že metoda Trim() v rozhraní .NET Framework 4and novější verze neodebere. Kromě toho Trim() metoda v rozhraní .NET Framework 3.5 SP1 a starších verzích neořízne tři znaky prázdné znaky Unicode: MONGOLN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F) a STŘEDNÍ MATEMATICKÝ PROSTOR (U+205F).

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0