StringPolyfillExtensionReplaceLineEndings(String) Method

Replaces all newlines in s with NewLine.

Definition

Namespace: FolkerKinzel.Strings
Assembly: FolkerKinzel.Strings (in FolkerKinzel.Strings.dll) Version: 9.4.0+10a7d4d71aa960998e32ac0ac6c4fcbe4164c917

C#

public static string ReplaceLineEndings(
	this string s
)

VB

<ExtensionAttribute>
Public Shared Function ReplaceLineEndings ( 
	s As String
) As String

C++

public:
[ExtensionAttribute]
static String^ ReplaceLineEndings(
	String^ s
)

F#

[<ExtensionAttribute>]
static member ReplaceLineEndings : 
        s : string -> string

Parameters

s String: The source String.

Return Value

String
A String whose contents match the content of s, but with all newline sequences replaced with NewLine.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type String. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

This is a polyfill for the .NET 6.0 method String.ReplaceLineEndings(). The method should therefore only be used in the extension method syntax. It throws a NullReferenceException if s is null in order to show identical behavior to the original .NET method.

The method searches for all newline sequences within s and canonicalizes them to match the newline sequence for the current environment. For example, when running on Windows, all occurrences of non-Windows Newline sequences are replaced with the sequence CRLF. When running on Unix, all occurrences of non-Unix Newline sequences are replaced with a single LF character.

The list of recognized newline sequences is:

CR (U+000D)
LF (U+000A)
CRLF (U+000D U+000A)
NEL (U+0085)
LS (U+2028)
FF (U+000C)
PS (U+2029)

This list is specified by the Unicode standard (Sec. 5.8, Recommendation R4 and Table 5-2).

Exceptions

NullReferenceException

s is null.