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.

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ý 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

Trim(ReadOnlySpan<Char>)

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

public:
 System::String ^ Trim(ReadOnlySpan<char> trimChars);
public string Trim (scoped ReadOnlySpan<char> trimChars);
member this.Trim : ReadOnlySpan<char> -> string
Public Function Trim (trimChars As ReadOnlySpan(Of Char)) As String

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

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.

public:
 System::String ^ Trim();
public string Trim ();
member this.Trim : unit -> string
Public Function Trim () As String

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.

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.
    }
}
printf "Enter your first name: "
let firstName = stdin.ReadLine()

printf "Enter your middle name or initial: "
let middleName = stdin.ReadLine()

printf "Enter your last name: "
let lastName = stdin.ReadLine()

printfn $"\nYou entered '{firstName}', '{middleName}', and '{lastName}'." 

let name = ((firstName.Trim() + " " + middleName.Trim()).Trim() + " " + lastName.Trim()).Trim()
printfn $"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 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

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.

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 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.

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("Trimmed\n   {0}\nto\n   '{1}'", banner, result);

// The example displays the following output:
//       Trimmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'
let charsToTrim = [| '*'; ' '; '\'' |]
let banner = "*** Much Ado About Nothing ***"
let result = banner.Trim charsToTrim
printfn $"Trimmmed\n   {banner}\nto\n   '{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 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