UnsafeString Class
A generalized representation of a string that can be either backed by a system System.String,
a char[], or an UnsafeStringBuilder. Conversions between these types happen transparently
and are cached.
Namespace: PostSharp.Patterns.Formatters
Assembly: PostSharp.Patterns.Common.dll
Syntax
public sealed class UnsafeString : ObjectRemarks
Because an UnsafeString can be backed by a UnsafeStringBuilder, which is a mutable type, and is generally pooled and reused for different purposes, it is generally not safe to evaluate an UnsafeString at a different moment than the one designed by the API that exposes the UnsafeString. To make it safe to evaluate the UnsafeString at any moment, call the MakeImmutable() method, which unbounds the UnsafeString from its parent UnsafeStringBuilder.
Constructors
| Name | Description |
|---|---|
| UnsafeString(Char[]) | Initializes a new UnsafeString backed by an array of System.Char. |
| UnsafeString(String) | Initializes a new UnsafeString backed by a System.String. |
Properties
| Name | Description |
|---|---|
| Buffer | Gets an unmanaged pointer to the string. |
| IsImmutable | Determines whether the current UnsafeString is immutable
or, when the value of this property is |
| Length | Gets the number of characters in the string. |
Methods
| Name | Description |
|---|---|
| MakeImmutable() | If the current UnsafeString is bound to its origin UnsafeStringBuilder, evaluates the UnsafeStringBuilder and breaks the binding, so that later changes in the UnsafeStringBuilder do not cause changes in the current UnsafeString. This method also prevents the UnsafeString form being recycled. |
| ToCharArray() | Gets an ArraySegment<T> representing the current UnsafeString. |
| ToString() |