Home Original page

String.Create Method (System)

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Creates a new string with a specific length and initializes it after creation by using the specified callback.

public:
generic <typename TState>
 static System::String ^ Create(int length, TState state, System::Buffers::SpanAction<char, TState> ^ action);
public static string Create<TState>(int length, TState state, System.Buffers.SpanAction<char,TState> action) where TState : allows ref struct;
public static string Create<TState>(int length, TState state, System.Buffers.SpanAction<char,TState> action);
static member Create : int * 'State * System.Buffers.SpanAction<char, 'State> -> string
Public Shared Function Create(Of TState) (length As Integer, state As TState, action As SpanAction(Of Char, TState)) As String

Type Parameters

TState

The type of the element to pass to action.

Parameters

length
Int32

The length of the string to create.

state
TState

The element to pass to action.

Returns

The created string.

Remarks

The initial content of the destination span passed to action is undefined. Therefore, it is the delegate's responsibility to ensure that every element of the span is assigned. Otherwise, the resulting string could contain random characters.

To support interop scenarios, the underlying buffer is guaranteed to be at least 1 greater than represented by the span parameter of the action callback. This additional index represents the null-terminator and, if written, that is the only value supported. Writing any value other than the null-terminator corrupts the string and is considered undefined behavior.

Applies to