String.Trim Yöntem

Tanım

Geçerli dizeden belirtilen karakter kümesinin tüm baştaki ve sondaki oluşumlarının kaldırıldığı yeni bir dize döndürür.

Aşırı Yüklemeler

Trim(Char)

Geçerli dizeden bir karakterin tüm baştaki ve sondaki örneklerini kaldırır.

Trim(ReadOnlySpan<Char>)

Geçerli dizeden bir span içinde belirtilen bir karakter kümesinin tüm baştaki ve sondaki oluşumlarını kaldırır.

Trim()

Geçerli dizeden baştaki ve sonundaki tüm boşluk karakterlerini kaldırır.

Trim(Char[])

Bir dizide belirtilen karakter kümesinin tüm baştaki ve sondaki oluşumlarını geçerli dizeden kaldırır.

Trim(Char)

Kaynak:
String.Manipulation.cs
Kaynak:
String.Manipulation.cs
Kaynak:
String.Manipulation.cs

Geçerli dizeden bir karakterin tüm baştaki ve sondaki örneklerini kaldırır.

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

Parametreler

trimChar
Char

Kaldırılacak bir Unicode karakteri.

Döndürülenler

trimChar karakterinin tüm örneklerinden sonra kalan dize geçerli dizenin başından ve sonundan kaldırılır. Geçerli örnekten hiçbir karakter kırpılamıyorsa, yöntemi geçerli örneği değişmeden döndürür.

Açıklamalar

Trim(System.Char) yöntemi, geçerli dizeden trimChar karakterinin tüm baştaki ve sondaki örneklerini kaldırır. trimChar farklı bir karakterle karşılaşıldığında baştaki ve sondaki her kırpma işlemi durdurulur. Örneğin, trimChar- ve geçerli dize "---abc---xyz----" ise, Trim(System.Char) yöntemi "abc---xyz" döndürür. Dizedeki sözcükler arasındaki karakterleri kaldırmak için.NET Normal İfadeleri kullanın.

Not

Trim(System.Char) yöntemi geçerli örnekteki karakterleri kaldırırsa, bu yöntem geçerli örneğin değerini değiştirmez. Bunun yerine, geçerli örnekte bulunan tüm baştaki ve sondaki trimChar karakterlerin kaldırıldığı yeni bir dize döndürür.

Geçerli dize Empty eşitse veya geçerli örnekteki tüm karakterler trimChar karakterden oluşuyorsa, yöntemi Emptydöndürür.

Şunlara uygulanır

Trim(ReadOnlySpan<Char>)

Geçerli dizeden bir span içinde belirtilen bir karakter kümesinin tüm baştaki ve sondaki oluşumlarını kaldırır.

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

Parametreler

trimChars
ReadOnlySpan<Char>

Kaldırılacak Unicode karakter aralığı.

Döndürülenler

trimChars parametresindeki karakterlerin tüm oluşumlarından sonra kalan dize, geçerli dizenin başından ve sonundan kaldırılır. trimChars boşsa, bunun yerine boşluk karakterleri kaldırılır. Geçerli örnekten hiçbir karakter kırpılamıyorsa, yöntemi geçerli örneği değişmeden döndürür.

Şunlara uygulanır

Trim()

Kaynak:
String.Manipulation.cs
Kaynak:
String.Manipulation.cs
Kaynak:
String.Manipulation.cs

Geçerli dizeden baştaki ve sonundaki tüm boşluk karakterlerini kaldırır.

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

Döndürülenler

Tüm boşluk karakterleri geçerli dizenin başından ve sonundan kaldırıldıktan sonra kalan dize. Geçerli örnekten hiçbir karakter kırpılamıyorsa, yöntemi geçerli örneği değişmeden döndürür.

Örnekler

Aşağıdaki örnekte, kullanıcı tarafından girilen dizelerdeki fazladan boşlukları birleştirmeden önce kaldırmak için String.Trim() yöntemi kullanılır.

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.

Açıklamalar

Trim yöntemi geçerli dizeden tüm baştaki ve sondaki boşluk karakterlerini kaldırır. Boşluk olmayan bir karakterle karşılaşıldığında baştaki ve sondaki her kırpma işlemi durdurulur. Örneğin, geçerli dize " abc xyz " ise, Trim yöntemi "abc xyz" döndürür. Bir dizedeki sözcükler arasındaki boşluk karakterlerini kaldırmak için .NET Normal İfadelerikullanın.

Not

Trim yöntemi geçerli örnekteki karakterleri kaldırırsa, bu yöntem geçerli örneğin değerini değiştirmez. Bunun yerine, geçerli örnekte bulunan tüm baştaki ve sondaki boşluk karakterlerinin kaldırıldığı yeni bir dize döndürür.

Geçerli dize Empty eşitse veya geçerli örnekteki tüm karakterler boşluk karakterlerinden oluşuyorsa, yöntemi Emptydöndürür.

Boşluk karakterleri Unicode standardı tarafından tanımlanır. Trim yöntemi, Char.IsWhiteSpace yöntemine geçirildiğinde true dönüş değeri oluşturan baştaki ve sondaki karakterleri kaldırır.

Arayanlara Notlar

.NET Framework 3.5 SP1 ve önceki sürümleri, bu yöntemin kırptığını boşluk karakterlerinin iç listesini tutar. .NET Framework 4'den başlayarak, yöntem tüm Unicode boşluk karakterlerini (yani, IsWhiteSpace(Char) yöntemine geçirildiğinde true dönüş değeri oluşturan karakterleri) kırpıyor. Bu değişiklik nedeniyle, .NET Framework 3.5 SP1 ve önceki sürümlerdeki Trim() yöntemi, .NET Framework 4 ve sonraki sürümlerindeki Trim() yönteminin kaldırmadığı SIFIR GENİşLİk ARALIĞI (U+200B) ve SIFIR GENİşLİk NO-BREAK ARALIK (U+FEFF) adlı iki karakteri kaldırır. Ayrıca, .NET Framework 3.5 SP1 ve önceki sürümlerindeki Trim() yöntemi üç Unicode boşluk karakterini kırpmaz: MONGOLIAN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F) ve MEDIUM MATHEMATICAL SPACE (U+205F).

Ayrıca bkz.

Şunlara uygulanır

Trim(Char[])

Kaynak:
String.Manipulation.cs
Kaynak:
String.Manipulation.cs
Kaynak:
String.Manipulation.cs

Bir dizide belirtilen karakter kümesinin tüm baştaki ve sondaki oluşumlarını geçerli dizeden kaldırır.

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

Parametreler

trimChars
Char[]

Kaldırılacak Bir Unicode karakter dizisi veya null.

Döndürülenler

trimChars parametresindeki karakterlerin tüm oluşumlarından sonra kalan dize, geçerli dizenin başından ve sonundan kaldırılır. trimChars null veya boş bir diziyse, bunun yerine boşluk karakterleri kaldırılır. Geçerli örnekten hiçbir karakter kırpılamıyorsa, yöntemi geçerli örneği değişmeden döndürür.

Örnekler

Aşağıdaki örnekte, bir dizeden boşluk, yıldız işareti (*) ve kesme işareti (') karakterleri kaldırmak için Trim(System.Char[]) yöntemi kullanılır.

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'

Açıklamalar

Trim(System.Char[]) yöntemi, trimChars parametresindeki tüm baştaki ve sondaki karakterleri geçerli dizeden kaldırır. trimChars içinde olmayan bir karakterle karşılaşıldığında baştaki ve sondaki her kırpma işlemi durdurulur. Örneğin, geçerli dize "123abc456xyz789" ise ve trimChars "1" ile "9" arasında basamakları içeriyorsa, Trim(System.Char[]) yöntemi "abc456xyz" döndürür.

Not

Trim(System.Char[]) yöntemi geçerli örnekteki karakterleri kaldırırsa, bu yöntem geçerli örneğin değerini değiştirmez. Bunun yerine, geçerli örnekte bulunan tüm baştaki ve sondaki trimChars karakterlerin kaldırıldığı yeni bir dize döndürür.

Geçerli dize Empty eşitse veya geçerli örnekteki tüm karakterler trimChars dizisindeki karakterlerden oluşuyorsa, yöntemi Emptydöndürür.

trimChars null veya boş bir diziyse, bu yöntem, Char.IsWhiteSpace yöntemine geçirildiğinde yöntemin true döndürmesine neden olan baştaki veya sondaki karakterleri kaldırır.

Arayanlara Notlar

.NET Framework 3.5 SP1 ve önceki sürümleri, trimCharsnull veya boş bir dizi olduğunda bu yöntemin kırptığını boşluk karakterlerinin iç listesini tutar. .NET Framework 4'den başlayarak, trimCharsnull veya boş bir diziyse, yöntem tüm Unicode boşluk karakterlerini (IsWhiteSpace(Char) yöntemine geçirildiğinde true dönüş değeri oluşturan karakterler) kırpılır. Bu değişiklik nedeniyle, .NET Framework 3.5 SP1 ve önceki sürümlerdeki Trim() yöntemi, .NET Framework 4 ve sonraki sürümlerindeki Trim() yönteminin kaldırmadığı SIFIR GENİşLİk ARALIĞI (U+200B) ve SIFIR GENİşLİk NO-BREAK ARALIK (U+FEFF) adlı iki karakteri kaldırır. Ayrıca, .NET Framework 3.5 SP1 ve önceki sürümlerindeki Trim() yöntemi üç Unicode boşluk karakterini kırpmaz: MONGOLIAN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F) ve MEDIUM MATHEMATICAL SPACE (U+205F).

Ayrıca bkz.

Şunlara uygulanır