String.Trim Метод

Определение

Возвращает новую строку, в которой удалены все начальные и конечные вхождения заданного набора символов из текущей строки.

Перегрузки

Trim(Char[])

Удаляет все начальные и конечные вхождения набора символов, заданного в виде массива, из текущей строки.

Trim(Char)

Удаляет все начальные и конечные экземпляры символа из текущей строки.

Trim()

Удаляет все начальные и конечные символы пробела из текущей строки.

Trim(Char[])

Удаляет все начальные и конечные вхождения набора символов, заданного в виде массива, из текущей строки.

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

Параметры

trimChars
Char[]

Массив удаляемых знаков Юникода или null.

Возвращаемое значение

String

Строка, оставшаяся после удаления всех вхождений символов, заданных в параметре trimChars, из начала и конца текущей строки. Если значением параметра trimChars является null или пустой массив, удаляются символы-разделители. Если в текущем экземпляре невозможно усечь символы, метод возвращает текущий экземпляр без изменений.

Примеры

В следующем примере метод используется Trim(System.Char[]) для удаления пробелов, символов звездочки (*) и апострофа (') из строки.

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'

Комментарии

Trim(System.Char[])Метод удаляет из текущей строки все начальные и конечные символы, которые находятся в trimChars параметре. Каждая начальная и конечная операции усечения останавливается при обнаружении символа, который не находится в trimChars . Например, если текущая строка имеет значение «123abc456xyz789» и trimChars содержит цифры от «1» до «9», Trim(System.Char[]) метод возвращает «abc456xyz».

Примечание

Если Trim(System.Char[]) метод удаляет любые символы из текущего экземпляра, этот метод не изменяет значение текущего экземпляра. Вместо этого возвращается новая строка, в которой удаляются все начальные и конечные trimChars символы, найденные в текущем экземпляре.

Если текущая строка равна Empty или все символы в текущем экземпляре состоят из символов в trimChars массиве, метод возвращает значение Empty .

Если trimChars имеет значение null или пустой массив, этот метод удаляет все начальные или конечные символы, которые приводят к возврату метода, true когда они передаются в Char.IsWhiteSpace метод.

Примечания для тех, кто вызывает этот метод

платформа .NET Framework 3,5 с пакетом обновления 1 (SP1) и более ранние версии поддерживают внутренний список пробелов, которые этот метод обрезает, если trimChars имеет значение null или пустой массив. начиная с платформа .NET Framework 4, если trimChars имеет значение null или пустой массив, метод обрезает все пробельные символы юникода (то есть символы, которые true возвращают возвращаемое значение при передаче в IsWhiteSpace(Char) метод). из-за этого изменения Trim() метод в платформа .NET Framework 3,5 с пакетом обновления 1 (SP1) и более ранних версий удаляет два символа: пустое пространство нулевой ширины (u + 200B) и нулевую ширину свободного пространства (u + FEFF), что Trim() метод в платформа .NET Framework 4and более поздних версиях не удаляется. кроме того, Trim() метод в платформа .NET Framework 3,5 с пакетом обновления 1 (SP1) и более ранних версий не обрезает три пробела в юникоде: монгольский гласный разделитель (u + 180E), узкие пространства без перерывов (u + 202F) и среднее математическое пространство (u + 205F).

См. также раздел

Применяется к

Trim(Char)

Удаляет все начальные и конечные экземпляры символа из текущей строки.

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

Параметры

trimChar
Char

Удаляемый символ Юникода.

Возвращаемое значение

String

Строка, оставшаяся после удаления всех экземпляров символа trimChar из начала и конца текущей строки. Если в текущем экземпляре невозможно усечь символы, метод возвращает текущий экземпляр без изменений.

Комментарии

Trim(System.Char)Метод удаляет из текущей строки все начальные и конечные экземпляры trimChar символа. Каждая начальная и конечная операция усечения останавливается при обнаружении символа, отличного от trimChar . Например, если trimChar имеет значение, - а текущая строка — "---ABC---XYZ----", Trim(System.Char) метод возвращает "ABC---XYZ". Чтобы удалить символы между словами в строке, используйте регулярные выражения .NET.

Примечание

Если Trim(System.Char) метод удаляет любые символы из текущего экземпляра, этот метод не изменяет значение текущего экземпляра. Вместо этого возвращается новая строка, в которой удаляются все начальные и конечные trimChar символы, найденные в текущем экземпляре.

Если текущая строка равна Empty или все символы в текущем экземпляре состоят из trimChar символов, метод возвращает значение Empty .

Применяется к

Trim()

Удаляет все начальные и конечные символы пробела из текущей строки.

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

Возвращаемое значение

String

Строка, оставшаяся после удаления всех знаков пробела из начала и конца текущей строки. Если в текущем экземпляре невозможно усечь символы, метод возвращает текущий экземпляр без изменений.

Примеры

В следующем примере метод используется String.Trim() для удаления лишних пробелов из строк, вводимых пользователем, перед их сцеплением.

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.

Комментарии

TrimМетод удаляет из текущей строки все начальные и конечные символы пробела. Каждая начальная и конечная операции усечения останавливается при обнаружении символа, не являющегося пробелом. Например, если текущей строкой является "ABC XYZ", Trim метод возвращает "ABC XYZ". Чтобы удалить пробельные символы между словами в строке, используйте регулярные выражения .NET.

Примечание

Если Trim метод удаляет любые символы из текущего экземпляра, этот метод не изменяет значение текущего экземпляра. Вместо этого возвращается новая строка, в которой удаляются все начальные и конечные символы пробела, найденные в текущем экземпляре.

Если текущая строка равна Empty или все символы в текущем экземпляре состоят из пробельных символов, метод возвращает значение Empty .

Пробельные символы определяются стандартом Юникода. TrimМетод удаляет все ведущие и замыкающие символы, которые возвращают возвращаемое значение, true когда они передаются в Char.IsWhiteSpace метод.

Примечания для тех, кто вызывает этот метод

в платформа .NET Framework 3,5 с пакетом обновления 1 (SP1) и более ранних версиях поддерживается внутренний список символов пробела, которые обрезаются этим методом. начиная с платформа .NET Framework 4, метод усекает все пробельные символы юникода (то есть символы, true возвращающие возвращаемое значение, когда они передаются в IsWhiteSpace(Char) метод). из-за этого изменения Trim() метод в платформа .NET Framework 3,5 с пакетом обновления 1 (SP1) и более ранних версий удаляет два символа: пустое пространство нулевой ширины (u + 200B) и нулевую ширину свободного пространства (u + FEFF), что Trim() метод в платформа .NET Framework 4and более поздних версиях не удаляется. кроме того, Trim() метод в платформа .NET Framework 3,5 с пакетом обновления 1 (SP1) и более ранних версий не обрезает три пробела в юникоде: монгольский гласный разделитель (u + 180E), узкие пространства без перерывов (u + 202F) и среднее математическое пространство (u + 205F).

См. также раздел

Применяется к