String.ReplaceLineEndings メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

オーバーロード

ReplaceLineEndings(String)	現在の文字列内のすべての改行 シーケンスを に置き replacementText換えます。
ReplaceLineEndings()	現在の文字列内のすべての改行 シーケンスを に置き NewLine換えます。

ReplaceLineEndings(String)

ソース:

String.Manipulation.cs

現在の文字列内のすべての改行 シーケンスを に置き replacementText換えます。

public:
 System::String ^ ReplaceLineEndings(System::String ^ replacementText);

public string ReplaceLineEndings (string replacementText);

member this.ReplaceLineEndings : string -> string

Public Function ReplaceLineEndings (replacementText As String) As String

パラメーター

replacementText

String

置換として使用するテキスト。

戻り値

String

内容が現在の文字列と一致するが、すべての改行シーケンスが に replacementText置き換えられた文字列。

注釈

このメソッドは、文字列内のすべての改行 シーケンスを検索し、 によって replacementText提供される改行 シーケンスに正規化します。 が のEmpty場合replacementText、文字列内のすべての改行シーケンスが削除されます。

プロトコル パーサーがこの API を利用することはお勧めしません。 プロトコルの仕様では、多くの場合、特定の改行 シーケンスが必要です。 たとえば、HTTP/1.1 (RFC 8615) では、要求行、状態行、ヘッダー行が CRLF で終わる必要があります。 この API は幅広い改行 シーケンスで動作するため、この API を利用するプロトコル パーサーは、プロトコルの作成者が意図しない動作を示す可能性があります。

認識される改行 シーケンスの一覧は、CR (U+000D)、LF (U+000A)、CRLF (U+000D U+000A)、NEL (U+0085)、LS (U+2028)、FF (U+000C)、PS (U+2029) です。 この一覧は、Unicode 標準、Sec. 5.8、推奨事項 R4、および表 5-2 で示されています。

このメソッドでは、O(n * r) の複雑さが保証されます。 ここで、n は入力文字列の長さ、 r は の replacementText長さです。

ReplaceLineEndings()

ソース:

String.Manipulation.cs

現在の文字列内のすべての改行 シーケンスを に置き NewLine換えます。

public:
 System::String ^ ReplaceLineEndings();

public string ReplaceLineEndings ();

member this.ReplaceLineEndings : unit -> string

Public Function ReplaceLineEndings () As String

戻り値

String

内容が現在の文字列と一致するが、すべての改行シーケンスが に NewLine置き換えられた文字列。

注釈

このメソッドは、文字列内のすべての改行 シーケンスを検索し、現在の環境の改行 シーケンスと一致するように正規化します。 たとえば、Windows でを実行する場合、Windows 以外の改行 シーケンスのすべての出現箇所は、シーケンス CRLF に置き換えられます。 Unix でを実行する場合、Unix 以外の改行 シーケンスのすべての出現箇所は、1 つの LF 文字に置き換えられます。

プロトコル パーサーがこの API を利用することはお勧めしません。 プロトコルの仕様では、多くの場合、特定の改行 シーケンスが必要です。 たとえば、HTTP/1.1 (RFC 8615) では、要求行、状態行、ヘッダー行が CRLF で終わる必要があります。 この API は幅広い改行 シーケンスで動作するため、この API を利用するプロトコル パーサーは、プロトコルの作成者が意図しない動作を示す可能性があります。

このオーバーロードは、replacementText パラメーターとして を渡す NewLine を呼び出すことReplaceLineEndings(String)と同じです。

このメソッドは O(n) の複雑さが保証されます。 ここで、n は入力文字列の長さです。