String.Trim メソッド

定義

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

オーバーロード

名前 説明
Trim(Rune)
Trim(Char[])

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

Trim(Char)

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

Trim()

現在の文字列の先頭および末尾の空白文字をすべて削除します。

Trim(Rune)

ソース:
String.Manipulation.cs
public:
 System::String ^ Trim(System::Text::Rune trimRune);
public string Trim(System.Text.Rune trimRune);
member this.Trim : System.Text.Rune -> string
Public Function Trim (trimRune As Rune) As String

パラメーター

trimRune
Rune

返品

適用対象

Trim(Char[])

ソース:
String.Manipulation.cs
ソース:
String.Manipulation.cs
ソース:
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

返品

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

次の例では、 Trim(System.Char[]) メソッドを使用して、文字列からスペース、アスタリスク (*)、アポストロフィ (') 文字を削除します。

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" を返します。

Note

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

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

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

Trim(Char)

ソース:
String.Manipulation.cs
ソース:
String.Manipulation.cs
ソース:
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 文字。

返品

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

注釈

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

Note

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

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

適用対象

Trim()

ソース:
String.Manipulation.cs
ソース:
String.Manipulation.cs
ソース:
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.Trim() メソッドを使用して、ユーザーが入力した文字列から余分な空白を削除してから連結します。

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正規表現を使用します。

Note

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

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

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象