String.Trim メソッド

リファレンス

定義

名前空間:: System

アセンブリ:: System.Runtime.dll

アセンブリ:: netstandard.dll

アセンブリ:: mscorlib.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

現在の文字列から指定した文字セットの先頭と末尾のすべての出現箇所が削除される新しい文字列を返します。

オーバーロード

Trim(Char)	現在の文字列から文字の先頭と末尾のすべてのインスタンスを削除します。
Trim(ReadOnlySpan<Char>)	スパンで指定された一連の文字の先頭と末尾のすべての出現箇所を現在の文字列から削除します。
Trim()	現在の文字列から先頭と末尾のすべての空白文字を削除します。
Trim(Char[])	配列で指定された文字セットの先頭と末尾のすべての出現箇所を現在の文字列から削除します。

Trim(Char)

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

現在の文字列から文字の先頭と末尾のすべてのインスタンスを削除します。

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

削除する Unicode 文字。

戻り値

String

trimChar 文字のすべてのインスタンスの後に残っている文字列は、現在の文字列の先頭と末尾から削除されます。現在のインスタンスから文字をトリミングできない場合、メソッドは現在のインスタンスを変更せずに返します。

注釈

Trim(System.Char) メソッドは、trimChar 文字の先頭と末尾のすべてのインスタンスを現在の文字列から削除します。先頭と末尾の各トリム操作は、trimChar とは異なる文字が検出されると停止します。たとえば、trimChar が - で、現在の文字列が "---abc---xyz----" の場合、Trim(System.Char) メソッドは "abc---xyz" を返します。文字列内の単語間の文字を削除するには、.NET 正規表現使用します。

注意

Trim(System.Char) メソッドが現在のインスタンスから文字を削除した場合、このメソッドは現在のインスタンスの値を変更しません。代わりに、現在のインスタンスで見つかった先頭と末尾のすべての trimChar 文字が削除される新しい文字列が返されます。

現在の文字列が Empty 等しい場合、または現在のインスタンス内のすべての文字が trimChar 文字で構成されている場合、メソッドは Emptyを返します。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Trim(ReadOnlySpan<Char>)

スパンで指定された一連の文字の先頭と末尾のすべての出現箇所を現在の文字列から削除します。

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

パラメーター

trimChars: ReadOnlySpan<Char>

削除する Unicode 文字のスパン。

戻り値

String

trimChars パラメーター内のすべての文字が出現した後に残っている文字列は、現在の文字列の先頭と末尾から削除されます。 trimChars が空の場合は、代わりに空白文字が削除されます。現在のインスタンスから文字をトリミングできない場合、メソッドは現在のインスタンスを変更せずに返します。

適用対象

.NET 9

製品	バージョン
.NET	9

Trim()

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

現在の文字列から先頭と末尾のすべての空白文字を削除します。

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

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.

注釈

Trim メソッドは、現在の文字列から、先頭と末尾のすべての空白文字を削除します。空白以外の文字が検出されると、先頭と末尾の各トリミング操作が停止します。たとえば、現在の文字列が "abc xyz" の場合、Trim メソッドは "abc xyz" を返します。文字列内の単語間の空白文字を削除するには、.NET 正規表現使用します。

注意

Trim メソッドが現在のインスタンスから文字を削除した場合、このメソッドは現在のインスタンスの値を変更しません。代わりに、現在のインスタンスで見つかった先頭と末尾のすべての空白文字が削除される新しい文字列を返します。

現在の文字列が Empty 等しい場合、または現在のインスタンス内のすべての文字が空白文字で構成されている場合、メソッドは Emptyを返します。

空白文字は、Unicode 標準で定義されています。 Trim メソッドは、Char.IsWhiteSpace メソッドに渡されたときに true の戻り値を生成する先頭と末尾の文字をすべて削除します。

注意 (呼び出し元)

.NET Framework 3.5 SP1 以前のバージョンでは、このメソッドがトリミングする空白文字の内部リストが保持されています。 .NET Framework 4 以降では、このメソッドはすべての Unicode 空白文字 (つまり、IsWhiteSpace(Char) メソッドに渡されたときに true 戻り値を生成する文字) をトリミングします。この変更により、.NET Framework 3.5 SP1 以前のバージョンの Trim() メソッドは、.NET Framework 4 以降のバージョンの Trim() メソッドが削除しない 2 文字の ZERO WIDTH SPACE (U+200B) と ZERO WIDTH NO-BREAK SPACE (U+FEFF) を削除します。さらに、.NET Framework 3.5 SP1 以前のバージョンの Trim() メソッドでは、3 つの Unicode 空白文字 (モンゴル語の母音区切り文字 (U+180E)、NARROW NO-BREAK SPACE (U+202F)、MEDIUM MATHEMATICAL SPACE (U+205F) はトリミングされません。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Trim(Char[])

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

配列で指定された文字セットの先頭と末尾のすべての出現箇所を現在の文字列から削除します。

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[]

削除する Unicode 文字の配列、または 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("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'

注釈

Trim(System.Char[]) メソッドは、現在の文字列から、trimChars パラメーター内のすべての先頭と末尾の文字を削除します。先頭と末尾の各トリミング操作は、trimChars に含まれていない文字が検出されると停止します。たとえば、現在の文字列が "123abc456xyz789" で、trimChars に "1" から "9" までの数字が含まれている場合、Trim(System.Char[]) メソッドは "abc456xyz" を返します。

注意

Trim(System.Char[]) メソッドが現在のインスタンスから文字を削除した場合、このメソッドは現在のインスタンスの値を変更しません。代わりに、現在のインスタンスで見つかった先頭と末尾のすべての trimChars 文字が削除される新しい文字列が返されます。

現在の文字列が Empty 等しい場合、または現在のインスタンス内のすべての文字が trimChars 配列内の文字で構成されている場合、メソッドは Emptyを返します。

trimChars が null または空の配列の場合、このメソッドは、Char.IsWhiteSpace メソッドに渡されたときに true を返す先頭または末尾の文字をすべて削除します。

注意 (呼び出し元)

.NET Framework 3.5 SP1 以前のバージョンでは、trimChars が null または空の配列の場合に、このメソッドによってトリミングされる空白文字の内部リストが保持されます。 .NET Framework 4 以降では、trimChars が null または空の配列である場合、メソッドはすべての Unicode 空白文字 (つまり、IsWhiteSpace(Char) メソッドに渡されたときに true 戻り値を生成する文字) をトリミングします。この変更により、.NET Framework 3.5 SP1 以前のバージョンの Trim() メソッドは、.NET Framework 4 以降のバージョンの Trim() メソッドが削除しない 2 文字の ZERO WIDTH SPACE (U+200B) と ZERO WIDTH NO-BREAK SPACE (U+FEFF) を削除します。さらに、.NET Framework 3.5 SP1 以前のバージョンの Trim() メソッドでは、3 つの Unicode 空白文字 (モンゴル語の母音区切り文字 (U+180E)、NARROW NO-BREAK SPACE (U+202F)、MEDIUM MATHEMATICAL SPACE (U+205F) はトリミングされません。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

次の方法で共有

String.Trim メソッド

定義

オーバーロード

Trim(Char)

パラメーター

戻り値

注釈

適用対象

Trim(ReadOnlySpan<Char>)

パラメーター

戻り値

適用対象

Trim()

戻り値

例

注釈

注意 (呼び出し元)

こちらもご覧ください

適用対象

Trim(Char[])

パラメーター

戻り値

例

注釈

注意 (呼び出し元)

こちらもご覧ください

適用対象

その他のリソース