String.Trim String.Trim String.Trim String.Trim Method

定義

現在の String オブジェクトの先頭および末尾から、指定した文字セットをすべて削除した新しい文字列を返します。Returns a new string in which all leading and trailing occurrences of a set of specified characters from the current String object are removed.

オーバーロード

Trim() Trim() Trim() Trim()

現在の String オブジェクトの先頭および末尾にある空白文字をすべて削除します。Removes all leading and trailing white-space characters from the current String object.

Trim(Char[]) Trim(Char[]) Trim(Char[]) Trim(Char[])

現在の String オブジェクトの先頭および末尾から、配列で指定された文字セットをすべて削除します。Removes all leading and trailing occurrences of a set of characters specified in an array from the current String object.

Trim(Char) Trim(Char) Trim(Char) Trim(Char)

Trim() Trim() Trim() Trim()

現在の String オブジェクトの先頭および末尾にある空白文字をすべて削除します。Removes all leading and trailing white-space characters from the current String object.

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

戻り値

現在の文字列の先頭および末尾から空白文字をすべて削除した後に残った文字列。The string that remains after all white-space characters are removed from the start and end of the current string. 現在のインスタンスから文字をトリミングできない場合、メソッドは現在のインスタンスを変更せずに返します。If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

次の例では、String.Trim()それらを連結する前に、ユーザーが入力した文字列から余分な空白を削除する方法。The following example uses the String.Trim() method to remove any extra white space from strings entered by the user before concatenating them.

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 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メソッドは、現在の文字列から先頭および末尾の空白文字がすべて削除します。The Trim method removes from the current string all leading and trailing white-space characters. 各先頭および末尾のトリム操作は、空白以外の文字が検出されたときに停止します。Each leading and trailing trim operation stops when a non-white-space character is encountered. たとえば、現在の文字列が"abc xyz"の場合、Trimメソッドは"abc xyz"を返します。For example, if the current string is " abc xyz ", the Trim method returns "abc xyz". 文字列内の単語の間の空白文字を削除する使用.NET の正規します。To remove white-space characters between words in a string, use .NET Regular Expressions.

注意

場合、Trimメソッドは、現在のインスタンスから任意の文字を削除、このメソッドは、現在のインスタンスの値を変更しません。If the Trim method removes any characters from the current instance, this method does not modify the value of the current instance. 代わりに、現在のインスタンスで検出されたすべての先頭および末尾の空白文字を削除する新しい文字列を返します。Instead, it returns a new string in which all leading and trailing white space characters found in the current instance are removed.

現在の文字列が等しい場合Emptyメソッドを返します、現在のインスタンスのすべての文字は、空白文字で構成されている、またはEmptyします。If the current string equals Empty or all the characters in the current instance consist of white-space characters, the method returns Empty.

空白文字は、Unicode 規格によって定義されます。White-space characters are defined by the Unicode standard. Trim()メソッドの戻り値を生成する先頭および末尾の文字を削除trueに渡されるときに、Char.IsWhiteSpaceメソッド。The Trim() method removes any leading and trailing characters that produce a return value of true when they are passed to the Char.IsWhiteSpace method.

注意 (呼び出し元)

.NET Framework 3.5 SP1.NET Framework 3.5 SP1および以前のバージョンがこのメソッドをトリミングする空白文字の内部リストを管理します。The .NET Framework 3.5 SP1.NET Framework 3.5 SP1 and earlier versions maintain an internal list of white-space characters that this method trims. 以降では、 .NET Framework 4.NET Framework 4、メソッドは、すべての Unicode の空白文字をトリミング (つまり、文字が生成する、trueに渡されるときに値を返す、IsWhiteSpace(Char)メソッド)。Starting with the .NET Framework 4.NET Framework 4, the method trims all Unicode white-space characters (that is, characters that produce a true return value when they are passed to the IsWhiteSpace(Char) method). この変更により、Trim()メソッド、.NET Framework 3.5 SP1.NET Framework 3.5 SP1し、以前のバージョンは、ゼロ幅の容量 (U + 200B) またはゼロ幅の非分割領域 (U+FEFF) を 2 つの文字を削除する、Trim()メソッド、.NET Framework 4.NET Framework 4以降のバージョンは、削除されません。Because of this change, the Trim() method in the .NET Framework 3.5 SP1.NET Framework 3.5 SP1 and earlier versions removes two characters, ZERO WIDTH SPACE (U+200B) and ZERO WIDTH NO-BREAK SPACE (U+FEFF), that the Trim() method in the .NET Framework 4.NET Framework 4and later versions does not remove. さらに、Trim()メソッドで、.NET Framework 3.5 SP1.NET Framework 3.5 SP1と以前のバージョンは次の 3 つの Unicode の空白文字を除去しません。モンゴル文字の母音区切り記号 (U + 180E)、狭い非分割領域 (U + 202F)、および中規模の数学的な領域 (U + 205F)。In addition, the Trim() method in the .NET Framework 3.5 SP1.NET Framework 3.5 SP1 and earlier versions does not trim three Unicode white-space characters: MONGOLIAN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F), and MEDIUM MATHEMATICAL SPACE (U+205F).

こちらもご覧ください

Trim(Char[]) Trim(Char[]) Trim(Char[]) Trim(Char[])

現在の String オブジェクトの先頭および末尾から、配列で指定された文字セットをすべて削除します。Removes all leading and trailing occurrences of a set of characters specified in an array from the current String object.

public:
 System::String ^ Trim(... cli::array <char> ^ trimChars);
public string Trim (params char[] trimChars);
member this.Trim : char[] -> string
Public Function Trim (ParamArray trimChars As Char()) As String

パラメーター

trimChars
Char[]

削除する Unicode 文字の配列、または nullAn array of Unicode characters to remove, or null.

戻り値

現在の文字列の先頭および末尾から、trimChars パラメーターの文字をすべて削除した後に残った文字列。The string that remains after all occurrences of the characters in the trimChars parameter are removed from the start and end of the current string. trimCharsnull または空の配列の場合は、代わりに空白文字が削除されます。If trimChars is null or an empty array, white-space characters are removed instead. 現在のインスタンスから文字をトリミングできない場合、メソッドは現在のインスタンスを変更せずに返します。If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

次の例では、String.Trim(Char[])領域、アスタリスク (*)、およびアポストロフィ (') 文字を文字列から削除する方法。The following example uses the String.Trim(Char[]) method to remove space, asterisk (*), and apostrophe (') characters from a string.

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'
using System;

public class Example
{
   public static void Main()
   {
      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メソッドが現在の文字列からではすべての先頭および末尾の文字を削除、trimCharsパラメーター。The Trim method removes from the current string all leading and trailing characters that are in the trimChars parameter. それぞれの先頭と末尾の操作が停止されていない文字をトリミングtrimCharsが発生しました。Each leading and trailing trim operation stops when a character that is not in trimChars is encountered. たとえば、現在の文字列が"123abc456xyz789"とtrimCharsから「9」、「1」、桁の数字が含まれています、 Trim "abc456xyz"を返します。For example, if the current string is "123abc456xyz789" and trimChars contains the digits from "1" through "9", the Trim method returns "abc456xyz".

注意

場合、Trimメソッドは、現在のインスタンスから任意の文字を削除、このメソッドは、現在のインスタンスの値を変更しません。If the Trim method removes any characters from the current instance, this method does not modify the value of the current instance. 代わりに、すべての新しい文字列を返します先頭と末尾のtrimChars現在のインスタンスで検出された文字が削除されます。Instead, it returns a new string in which all leading and trailing trimChars characters found in the current instance are removed.

現在の文字列が等しい場合Emptyまたは現在のインスタンスのすべての文字内の文字から成る、trimChars配列を返しますEmptyします。If the current string equals Empty or all the characters in the current instance consist of characters in the trimChars array, the method returns Empty.

場合trimCharsnullまたは空の配列に、このメソッドは、メソッドの返されると、先頭または末尾の文字を削除しますtrueに渡されるときに、Char.IsWhiteSpaceメソッドIf trimChars is null or an empty array, this method removes any leading or trailing characters that result in the method returning true when they are passed to the Char.IsWhiteSpace method,

注意 (呼び出し元)

.NET Framework 3.5 SP1.NET Framework 3.5 SP1以前のバージョンは、このメソッドはトリム場合の空白文字の内部の一覧を管理およびtrimCharsnullまたは空の配列。The .NET Framework 3.5 SP1.NET Framework 3.5 SP1 and earlier versions maintains an internal list of white-space characters that this method trims if trimChars is null or an empty array. 以降では、.NET Framework 4.NET Framework 4場合は、trimCharsnull、空の配列、メソッドがすべての Unicode の空白文字をトリミングまたは (つまり、文字が生成する、trueに渡されるときに値を返す、IsWhiteSpace(Char)メソッド)。Starting with the .NET Framework 4.NET Framework 4, if trimChars is null or an empty array, the method trims all Unicode white-space characters (that is, characters that produce a true return value when they are passed to the IsWhiteSpace(Char) method). この変更により、Trim()メソッド、.NET Framework 3.5 SP1.NET Framework 3.5 SP1し、以前のバージョンは、ゼロ幅の容量 (U + 200B) またはゼロ幅の非分割領域 (U+FEFF) を 2 つの文字を削除する、Trim()メソッド、.NET Framework 4.NET Framework 4以降のバージョンは、削除されません。Because of this change, the Trim() method in the .NET Framework 3.5 SP1.NET Framework 3.5 SP1 and earlier versions removes two characters, ZERO WIDTH SPACE (U+200B) and ZERO WIDTH NO-BREAK SPACE (U+FEFF), that the Trim() method in the .NET Framework 4.NET Framework 4and later versions does not remove. さらに、Trim()メソッドで、.NET Framework 3.5 SP1.NET Framework 3.5 SP1と以前のバージョンは次の 3 つの Unicode の空白文字を除去しません。モンゴル文字の母音区切り記号 (U + 180E)、狭い非分割領域 (U + 202F)、および中規模の数学的な領域 (U + 205F)。In addition, the Trim() method in the .NET Framework 3.5 SP1.NET Framework 3.5 SP1 and earlier versions does not trim three Unicode white-space characters: MONGOLIAN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F), and MEDIUM MATHEMATICAL SPACE (U+205F).

こちらもご覧ください

Trim(Char) Trim(Char) Trim(Char) 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 Char Char Char

戻り値

適用対象