String.Trim メソッド

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

パラメーター

戻り値

String

現在の文字列の先頭および末尾から、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. trimChars が null または空の配列の場合は、代わりに空白文字が削除されます。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.

例

次の例では、Trim(System.Char[]) メソッドを使用して、文字列からスペース、アスタリスク (*)、およびアポストロフィ (') 文字を削除します。The following example uses the Trim(System.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'

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 パラメーターに含まれる先頭と末尾のすべての文字を現在の文字列から削除します。The Trim(System.Char[]) 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 に "1" ~ "9" の数字が含まれている場合、Trim(System.Char[]) メソッドは "abc456xyz" を返します。For example, if the current string is "123abc456xyz789" and trimChars contains the digits from "1" through "9", the Trim(System.Char[]) method returns "abc456xyz".

現在の文字列が 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.

trimChars が null または空の配列の場合、このメソッドは、メソッドが Char.IsWhiteSpace メソッドに渡されたときに true を返す、先頭または末尾の文字を削除します。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 以前のバージョンは、trimChars が null または空の配列の場合に、このメソッドがトリムする空白文字の内部リストを保持します。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以降では、trimChars が null または空の配列の場合、メソッドはすべての Unicode 空白文字 (つまり、IsWhiteSpace(Char) メソッドに渡されるときに true 戻り値を生成する文字) をトリムします。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). この変更のため、.NET Framework 3.5 SP1.NET Framework 3.5 SP1 以前のバージョンの Trim() メソッドでは、2つの文字、0の幅のスペース (U + 200B) とゼロ幅の改行なしスペース (U + FEFF) が削除されます。これは、.NET Framework 4.NET Framework 4以降のバージョンの Trim() メソッドでは削除されません。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. さらに、.NET Framework 3.5 SP1.NET Framework 3.5 SP1 以前のバージョンの Trim() メソッドでは、3つの Unicode の空白文字 (モンゴル語の母音の区切り記号 (U + 180 e)、ナローの区切りスペース (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).

こちらもご覧ください

• Char
• TrimEnd(Char[])
• TrimStart(Char[])
• IsWhiteSpace(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

パラメーター

戻り値

String

現在の文字列の先頭と末尾から trimChar 文字のすべてのインスタンスが削除された後に残った文字列。The string that remains after all instances of the trimChar character 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.

注釈

Trim(System.Char) メソッドは、trimChar 文字の先頭および末尾のすべてのインスタンスを現在の文字列から削除します。The Trim(System.Char) method removes from the current string all leading and trailing instances of the trimChar character. trimChar とは異なる文字が検出されると、それぞれの先頭および末尾のトリム操作が停止します。Each leading and trailing trim operation stops when a character different from trimChar is encountered. たとえば、trimChar が -、現在の文字列が "---abc---xyz----" の場合、Trim(System.Char) メソッドは "abc---xyz" を返します。For example, if trimChar is - and the current string is "---abc---xyz----", the Trim(System.Char) method returns "abc---xyz". 文字列内の単語間の文字を削除するには、 .net の正規表現を使用します。To remove characters between words in a string, use .NET Regular Expressions.

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

public:
 System::String ^ Trim();

public string Trim ();

member this.Trim : unit -> string

Public Function Trim () As String

戻り値

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 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 メソッドは、現在の文字列からすべての先頭および末尾の空白文字を削除します。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.

現在の文字列が 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 メソッドは、Char.IsWhiteSpace メソッドに渡されるときに true の戻り値を生成する先頭と末尾の文字を削除します。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 空白文字 (つまり、IsWhiteSpace(Char) メソッドに渡されるときに true 戻り値を生成する文字) をトリムします。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). この変更のため、.NET Framework 3.5 SP1.NET Framework 3.5 SP1 以前のバージョンの Trim() メソッドでは、2つの文字、0の幅のスペース (U + 200B) とゼロ幅の改行なしスペース (U + FEFF) が削除されます。これは、.NET Framework 4.NET Framework 4以降のバージョンの Trim() メソッドでは削除されません。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. さらに、.NET Framework 3.5 SP1.NET Framework 3.5 SP1 以前のバージョンの Trim() メソッドでは、3つの Unicode の空白文字 (モンゴル語の母音の区切り記号 (U + 180 e)、ナローの区切りスペース (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).

こちらもご覧ください

• TrimEnd(Char[])
• TrimStart(Char[])
• IsWhiteSpace(Char)