String.TrimStart メソッド

リファレンス

定義

名前空間:: System

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

アセンブリ:: netstandard.dll

アセンブリ:: mscorlib.dll

重要

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

オーバーロード

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

TrimStart(ReadOnlySpan<Char>)

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

public:
 System::String ^ TrimStart(ReadOnlySpan<char> trimChars);

public string TrimStart (scoped ReadOnlySpan<char> trimChars);

member this.TrimStart : ReadOnlySpan<char> -> string

Public Function TrimStart (trimChars As ReadOnlySpan(Of Char)) As String

パラメーター

trimChars: ReadOnlySpan<Char>

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

戻り値

String

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

適用対象

TrimStart()

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

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

public:
 System::String ^ TrimStart();

public string TrimStart ();

member this.TrimStart : unit -> string

Public Function TrimStart () As String

戻り値

String

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

注釈

TrimStart メソッドは、現在の文字列から先頭のすべての空白文字を削除します。空白以外の文字が検出されると、トリミング操作が停止します。たとえば、現在の文字列が "abc xyz" の場合、TrimStart メソッドは "abc xyz" を返します。

手記

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

適用対象

TrimStart(Char)

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

指定した文字の先頭のすべての出現箇所を現在の文字列から削除します。

public:
 System::String ^ TrimStart(char trimChar);

public string TrimStart (char trimChar);

member this.TrimStart : char -> string

Public Function TrimStart (trimChar As Char) As String

パラメーター

trimChar: Char

削除する Unicode 文字。

戻り値

String

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

注釈

TrimStart(System.Char) メソッドは、現在の文字列から先頭のすべての trimChar 文字を削除します。トリミング操作は、trimChar されていない文字が検出されると停止します。たとえば、trimChar が - で、現在の文字列が "---abc---xyz----" の場合、TrimStart(System.Char) メソッドは "abc---xyz----" を返します。

手記

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

適用対象

TrimStart(Char[])

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

ソース:: String.Manipulation.cs

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

public:
 System::String ^ TrimStart(... cli::array <char> ^ trimChars);

public string TrimStart (params char[] trimChars);

public string TrimStart (params char[]? trimChars);

member this.TrimStart : char[] -> string

Public Function TrimStart (ParamArray trimChars As Char()) As String

パラメーター

trimChars: Char[]

削除する Unicode 文字の配列、または nullします。

戻り値

String

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

例

次の例は、TrimStart メソッドの基本的な機能を示しています。

// TrimStart examples
string lineWithLeadingSpaces = "   Hello World!";
string lineWithLeadingSymbols = "$$$$Hello World!";
string lineWithLeadingUnderscores = "_____Hello World!";
string lineWithLeadingLetters = "xxxxHello World!";
string lineAfterTrimStart = string.Empty;

// Make it easy to print out and work with all of the examples
string[] lines = { lineWithLeadingSpaces, lineWithLeadingSymbols, lineWithLeadingUnderscores, lineWithLeadingLetters };

foreach (var line in lines)
{
    Console.WriteLine($"This line has leading characters: {line}");
}
// Output:
// This line has leading characters:    Hello World!
// This line has leading characters: $$$$Hello World!
// This line has leading characters: _____Hello World!
// This line has leading characters: xxxxHello World!

// A basic demonstration of TrimStart in action
lineAfterTrimStart = lineWithLeadingSpaces.TrimStart(' ');
Console.WriteLine($"This is the result after calling TrimStart: {lineAfterTrimStart}");
// This is the result after calling TrimStart: Hello World!   

// Since TrimStart accepts a character array of leading items to be removed as an argument,
// it's possible to do things like trim multiple pieces of data that each have different 
// leading characters,
foreach (var lineToEdit in lines)
{
    Console.WriteLine(lineToEdit.TrimStart(' ', '$', '_', 'x'));
}
// Result for each: Hello World!

// or handle pieces of data that have multiple kinds of leading characters 
var lineToBeTrimmed = "__###__ John Smith";
lineAfterTrimStart = lineToBeTrimmed.TrimStart('_', '#', ' ');
Console.WriteLine(lineAfterTrimStart);
// Result: John Smith

// TrimStart examples
let lineWithLeadingSpaces = "   Hello World!"
let lineWithLeadingSymbols = "$$$$Hello World!"
let lineWithLeadingUnderscores = "_____Hello World!"
let lineWithLeadingLetters = "xxxxHello World!"

// Make it easy to print out and work with all of the examples
let lines = [| lineWithLeadingSpaces; lineWithLeadingSymbols; lineWithLeadingUnderscores; lineWithLeadingLetters |]

for line in lines do
    printfn $"This line has leading characters: {line}"
// Output:
// This line has leading characters:    Hello World!
// This line has leading characters: $$$$Hello World!
// This line has leading characters: _____Hello World!
// This line has leading characters: xxxxHello World!

// A basic demonstration of TrimStart in action
let lineAfterTrimStart = lineWithLeadingSpaces.TrimStart ' '
printfn $"This is the result after calling TrimStart: {lineAfterTrimStart}"
// This is the result after calling TrimStart: Hello World!   

// Since TrimStart accepts a character array of leading items to be removed as an argument,
// it's possible to do things like trim multiple pieces of data that each have different 
// leading characters,
for lineToEdit in lines do
    printfn $"""{lineToEdit.TrimStart(' ', '$', '_', 'x')}"""
// Result for each: Hello World!

// or handle pieces of data that have multiple kinds of leading characters 
let lineToBeTrimmed = "__###__ John Smith"
let lineAfterTrimStart2 = lineToBeTrimmed.TrimStart('_', '#', ' ')
printfn $"{lineAfterTrimStart2}"
// Result: John Smith

Public Sub Main()
   ' TrimStart Examples
   Dim lineWithLeadingSpaces as String = "   Hello World!"
   Dim lineWithLeadingSymbols as String = "$$$$Hello World!"
   Dim lineWithLeadingUnderscores as String = "_____Hello World!"
   Dim lineWithLeadingLetters as String = "xxxxHello World!"
   Dim lineAfterTrimStart = String.Empty

   ' Make it easy to print out and work with all of the examples
   Dim lines As String() = { lineWithLeadingSpaces, line lineWithLeadingSymbols, lineWithLeadingUnderscores, lineWithLeadingLetters }

   For Each line As String in lines
     Console.WriteLine($"This line has leading characters: {line}")
   Next
   ' Output:
   ' This line has leading characters:    Hello World!
   ' This line has leading characters: $$$$Hello World!
   ' This line has leading characters: _____Hello World!
   ' This line has leading characters: xxxxHello World!

   Console.WriteLine($"This line has leading spaces: {lineWithLeadingSpaces}")
   ' This line has leading spaces:   Hello World!

   ' A basic demonstration of TrimStart in action
   lineAfterTrimStart = lineWithLeadingSpaces.TrimStart(" "c)
   Console.WriteLine($"This is the result after calling TrimStart: {lineAfterTrimStart}")
   ' This is the result after calling TrimStart: Hello World!

   ' Since TrimStart accepts a character array of leading items to be removed as an argument,
   ' it's possible to do things like trim multiple pieces of data that each have different 
   ' leading characters,
   For Each lineToEdit As String in lines
     Console.WriteLine(lineToEdit.TrimStart(" "c, "$"c, "_"c, "x"c ))
   Next
   ' Result for each: Hello World!

   ' or handle pieces of data that have multiple kinds of leading characters
   Dim lineToBeTrimmed as String = "__###__ John Smith"
   lineAfterTrimStart = lineToBeTrimmed.TrimStart("_"c , "#"c , " "c)
   Console.WriteLine(lineAfterTrimStart)
   ' Result: John Smith

 End Sub

次の例では、TrimStart メソッドを使用して、ソースコードの行から空白文字とコメント文字をトリミングします。 StripComments メソッドは、TrimStart の呼び出しをラップし、スペースとコメント文字を含む文字配列を渡します。これは Visual Basic のアポストロフィ ( ' ) と C# または F# のスラッシュ ( / ) です。 TrimStart メソッドは、文字列がコメントであるかどうかを評価するときに先頭の空白を削除するためにも呼び出されます。

public static string[] StripComments(string[] lines)
{
    List<string> lineList = new List<string>();
    foreach (string line in lines)
    {
        if (line.TrimStart(' ').StartsWith("//"))
            lineList.Add(line.TrimStart(' ', '/'));
    }
    return lineList.ToArray();
}

let stripComments (lines: #seq<string>) =
    [|  for line in lines do
            if line.TrimStart(' ').StartsWith "//" then
                line.TrimStart(' ', '/') |]

Public Shared Function StripComments(lines() As String) As String()
   Dim lineList As New List(Of String)
   For Each line As String In lines
      If line.TrimStart(" "c).StartsWith("'") Then
         linelist.Add(line.TrimStart("'"c, " "c))
      End If
   Next
   Return lineList.ToArray()
End Function

次の例では、StripComments メソッドの呼び出しを示します。

public static void Main()
{
    string[] lines = {"using System;",
                   "",
                   "public class HelloWorld",
                   "{",
                   "   public static void Main()",
                   "   {",
                   "      // This code displays a simple greeting",
                   "      // to the console.",
                   "      Console.WriteLine(\"Hello, World.\");",
                   "   }",
                   "}"};
    Console.WriteLine("Before call to StripComments:");
    foreach (string line in lines)
        Console.WriteLine("   {0}", line);

    string[] strippedLines = StripComments(lines);
    Console.WriteLine("After call to StripComments:");
    foreach (string line in strippedLines)
        Console.WriteLine("   {0}", line);
}
// This code produces the following output to the console:
//    Before call to StripComments:
//       using System;
//   
//       public class HelloWorld
//       {
//           public static void Main()
//           {
//               // This code displays a simple greeting
//               // to the console.
//               Console.WriteLine("Hello, World.");
//           }
//       }  
//    After call to StripComments:
//       This code displays a simple greeting
//       to the console.

let lines = 
    [| "module HelloWorld"
       ""
       "[<EntryPoint>]"
       "let main _ ="
       "    // This code displays a simple greeting"
       "    // to the console."
       "    printfn \"Hello, World.\""
       "    0" |]
printfn "Before call to StripComments:"
for line in lines do
    printfn $"   {line}"

let strippedLines = stripComments lines
printfn "After call to StripComments:"
for line in strippedLines do
    printfn $"   {line}"
// This code produces the following output to the console:
//    Before call to StripComments:
//       module HelloWorld
//
//       [<EntryPoint>]
//       let main _ =
//           // This code displays a simple greeting
//           // to the console.
//           printfn "Hello, World."
//           0
//    After call to StripComments:
//       This code displays a simple greeting
//       to the console.

Public Shared Sub Main()
   Dim lines() As String = {"Public Module HelloWorld", _
                            "   Public Sub Main()", _
                            "      ' This code displays a simple greeting", _
                            "      ' to the console.", _
                            "      Console.WriteLine(""Hello, World."")", _
                            "   End Sub", _
                            " End Module"}
   Console.WriteLine("Code before call to StripComments:")
   For Each line As String In lines
      Console.WriteLine("   {0}", line)                         
   Next                            
   
   Dim strippedLines() As String = StripComments(lines) 
   Console.WriteLine("Code after call to StripComments:")
   For Each line As String In strippedLines
      Console.WriteLine("   {0}", line)                         
   Next                            
End Sub
' This code produces the following output to the console:
'    Code before call to StripComments:
'       Public Module HelloWorld
'          Public Sub Main()
'             ' This code displays a simple greeting
'             ' to the console.
'             Console.WriteLine("Hello, World.")
'          End Sub
'       End Module
'    Code after call to StripComments:
'       This code displays a simple greeting
'       to the console.

注釈

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

手記

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

注意 (呼び出し元)

.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) はトリミングされません。

こちらもご覧ください

適用対象

次の方法で共有

String.TrimStart メソッド

定義

オーバーロード

TrimStart(ReadOnlySpan<Char>)

パラメーター

戻り値

適用対象

TrimStart()

戻り値

注釈

適用対象

TrimStart(Char)

パラメーター

戻り値

注釈

適用対象

TrimStart(Char[])

パラメーター

戻り値

例

注釈

注意 (呼び出し元)

こちらもご覧ください

適用対象

その他のリソース