ServiceStack.Text

Utils to load types

Find the type from the name supplied

[typeName] or [typeName, assemblyName]

The top-most interface of the given type, if any.

Find type if it exists

The type if it exists

If AlwaysUseUtc is set to true then convert all DateTime to UTC. If PreserveUtc is set to true then UTC dates will not convert to local

Repairs an out-of-spec XML date/time string which incorrectly uses a space instead of a 'T' to separate the date from the time. These string are occasionally generated by SQLite and can cause errors in OrmLite when reading these columns from the DB.

The XML date/time string to repair The repaired string. If no repairs were made, the original string is returned.

WCF Json format: /Date(unixts+0000)/

Get the type(string) constructor if exists

The type.

micro optimizations: using flags instead of value.IndexOfAny(EscapeChars)

Class to hold

Parses the specified path info. e.g. MusicPage/arg1/0/true?debug&showFlows=3 => PathInfo .ActionName = 'MusicPage' .Arguments = ['arg1','0','true'] .Options = { debug:'True', showFlows:'3' }

The path url.

A fast, standards-based, serialization-issue free DateTime serializer.

Only .ConfigAwait(false) in .NET Core as loses HttpContext.Current in NETFX/ASP.NET

Determines whether this serializer can create the specified type from a string.

The type. true if this instance [can create from string] the specified type; otherwise, false.

Parses the specified value.

The value.

Deserializes from reader.

The reader.

Serializes to string.

The value.

Serializes to writer.

The value. The writer.

Mark JsConfig global config as initialized and assert it's no longer mutated

Initialize global config and assert that it's no longer mutated

Sets which format to use when serializing TimeSpans

Text case to use for property names (Default = PascalCase)

Emitting camelCase for property names

Emitting lowercase_underscore_casing for property names

Define how property names are mapped during deserialization

Gets or sets a value indicating if the framework should throw serialization exceptions or continue regardless of serialization errors. If the framework will throw; otherwise, it will parse as many fields as possible. The default is .

Gets or sets a value indicating if the framework should always convert to UTC format instead of local time.

Gets or sets a value indicating if the framework should skip automatic conversions. Dates will be handled literally, any included timezone encoding will be lost and the date will be treaded as DateTimeKind.Local Utc formatted input will result in DateTimeKind.Utc output. Any input without TZ data will be set DateTimeKind.Unspecified This will take precedence over other flags like AlwaysUseUtc JsConfig.DateHandler = DateHandler.ISO8601 should be used when set true for consistent de/serialization.

Gets or sets a value indicating if the framework should always assume is in UTC format if Kind is Unspecified.

Gets or sets whether we should append the Utc offset when we serialize Utc dates. Defaults to no. Only supported for when the JsConfig.DateHandler == JsonDateHandler.TimestampOffset

Gets or sets a value indicating if unicode symbols should be serialized as "\uXXXX".

Gets or sets a value indicating if HTML entity chars [> < & = '] should be escaped as "\uXXXX".

Gets or sets a value indicating if the framework should call an error handler when an exception happens during the deserialization.

Parameters have following meaning in order: deserialized entity, property name, parsed value, property type, caught exception.

If set to true, Interface types will be preferred over concrete types when serializing.

Sets the maximum depth to avoid circular dependencies

Set this to enable your own type construction provider. This is helpful for integration with IoC containers where you need to call the container constructor. Return null if you don't know how to construct the type and the parameterless constructor will be used.

Always emit type info for this type. Takes precedence over ExcludeTypeInfo

Never emit type info for this type

Text case to use for property names (Default = PascalCase)

Emitting camelCase for property names

Emitting lowercase_underscore_casing for property names

Define custom serialization fn for BCL Structs

Opt-in flag to set some Value Types to be treated as a Ref Type

Whether there is a fn (raw or otherwise)

Define custom raw serialization fn

Define custom serialization hook

Define custom after serialization hook

Define custom deserialization fn for BCL Structs

Define custom raw deserialization fn for objects

Exclude specific properties of this type from being serialized

The property names on target types must match property names in the JSON source

The property names on target types may not match the property names in the JSON source

Uses the xsd format like PT15H10M20S

Uses the standard .net ToString method of the TimeSpan class

If unspecified uses PascalCase

PascalCase

camelCase

snake_case

Bypass Init checks. Only call on Startup.

Shortcut escape when we're sure value doesn't contain any escaped chars

Given a character as utf32, returns the equivalent string provided that the character is legal json.

Micro-optimization keep pre-built char arrays saving a .ToCharArray() + function call (see .net implementation of .Write(string))

Searches the string for one or more non-printable characters.

The string to search. True if there are any characters that require escaping. False if the value can be written verbatim. Micro optimizations: since quote and backslash are the only printable characters requiring escaping, removed previous optimization (using flags instead of value.IndexOfAny(EscapeChars)) in favor of two equality operations saving both memory and CPU time. Also slightly reduced code size by re-arranging conditions. TODO: Possible Linq-only solution requires profiling: return value.Any(c => !c.IsPrintable() || c == QuoteChar || c == EscapeChar);

Implement the serializer using a more static approach

Get JSON string value converted to T

Get JSON string value

Get unescaped string value

Write JSON Array, Object, bool or number values as raw string

Creates an instance of a Type from a string value

Parses the specified value.

The value.

Implement the serializer using a more static approach

Pretty Thread-Safe cache class from: http://code.google.com/p/dapper-dot-net/source/browse/Dapper/SqlMapper.cs This is a micro-cache; suitable when the number of terms is controllable (a few hundred, for example), and strictly append-only; you cannot change existing values. All key matches are on **REFERENCE** equality. The type is fully thread-safe.

Represents an individual object, allowing access to members by-name

Get or Set the value of a named member for the underlying object

The object represented by this instance

Use the target types definition of equality

Obtain the hash of the target object

Use the target's definition of a string representation

Wraps an individual object, allowing by-name access to that instance

Provides by-name member-access to objects of a given type

Does this type support new instances via a parameterless constructor?

Create a new instance of this type

Provides a type-specific accessor, allowing by-name access for all objects of that type

The accessor is cached internally; a pre-existing accessor may be returned

Get or set the value of a named member on the target instance

Courtesy of @marcgravell https://github.com/mgravell/protobuf-net/blob/master/src/protobuf-net/BufferPool.cs

https://docs.microsoft.com/en-us/dotnet/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element https://docs.microsoft.com/en-us/dotnet/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element

Generic implementation of object pooling pattern with predefined pool size limit. The main purpose is that limited number of frequently used objects can be kept in the pool for further recycling. Notes: 1) it is not the goal to keep all returned objects. Pool is not meant for storage. If there is no space in the pool, extra returned objects will be dropped. 2) it is implied that if object was obtained from a pool, the caller will return it back in a relatively short time. Keeping checked out objects for long durations is ok, but reduces usefulness of pooling. Just new up your own. Not returning objects to the pool in not detrimental to the pool's work, but is a bad practice. Rationale: If there is no intent for reusing the object, do not use pool - just use "new".

Not using System.Func{T} because this file is linked into the (debugger) Formatter, which does not have that type (since it compiles against .NET 2.0).

Produces an instance.

Search strategy is a simple linear probing which is chosen for it cache-friendliness. Note that Free will try to store recycled objects close to the start thus statistically reducing how far we will typically search.

Returns objects to the pool.

Removes an object from leak tracking. This is called when an object is returned to the pool. It may also be explicitly called if an object allocated from the pool is intentionally not being returned to the pool. This can be of use with pooled arrays if the consumer wants to return a larger array to the pool than was originally allocated.

this is RAII object to automatically release pooled object when its owning pool

Shared object pool for roslyn Use this shared pool if only concern is reducing object allocations. if perf of an object pool itself is also a concern, use ObjectPool directly. For example, if you want to create a million of small objects within a second, use the ObjectPool directly. it should have much less overhead than using this.

pool that uses default constructor with 100 elements pooled

pool that uses default constructor with 20 elements pooled

pool that uses string as key with StringComparer.OrdinalIgnoreCase as key comparer

pool that uses string as element with StringComparer.OrdinalIgnoreCase as element comparer

pool that uses string as element with StringComparer.Ordinal as element comparer

Used to reduce the # of temporary byte[]s created to satisfy serialization and other I/O requests

pooled memory : 4K * 512 = 4MB

Manages pools of RecyclableMemoryStream objects.

There are two pools managed in here. The small pool contains same-sized buffers that are handed to streams as they write more data. For scenarios that need to call GetBuffer(), the large pool contains buffers of various sizes, all multiples/exponentials of LargeBufferMultiple (1 MB by default). They are split by size to avoid overly-wasteful buffer usage. There should be far fewer 8 MB buffers than 1 MB buffers, for example.

ETW events for RecyclableMemoryStream

Static log object, through which all events are written.

Type of buffer

Small block buffer

Large pool buffer

The possible reasons for discarding a buffer

Buffer was too large to be re-pooled

There are enough free bytes in the pool

Logged when a stream object is created.

A unique ID for this stream. A temporary ID for this stream, usually indicates current usage. Requested size of the stream

Logged when the stream is disposed

A unique ID for this stream. A temporary ID for this stream, usually indicates current usage.

Logged when the stream is disposed for the second time.

A unique ID for this stream. A temporary ID for this stream, usually indicates current usage. Call stack of initial allocation. Call stack of the first dispose. Call stack of the second dispose. Note: Stacks will only be populated if RecyclableMemoryStreamManager.GenerateCallStacks is true.

Logged when a stream is finalized.

A unique ID for this stream. A temporary ID for this stream, usually indicates current usage. Call stack of initial allocation. Note: Stacks will only be populated if RecyclableMemoryStreamManager.GenerateCallStacks is true.

Logged when ToArray is called on a stream.

A unique ID for this stream. A temporary ID for this stream, usually indicates current usage. Call stack of the ToArray call. Length of stream Note: Stacks will only be populated if RecyclableMemoryStreamManager.GenerateCallStacks is true.

Logged when the RecyclableMemoryStreamManager is initialized.

Size of blocks, in bytes. Size of the large buffer multiple, in bytes. Maximum buffer size, in bytes.

Logged when a new block is created.

Number of bytes in the small pool currently in use.

Logged when a new large buffer is created.

Requested size Number of bytes in the large pool in use.

Logged when a buffer is created that is too large to pool.

Size requested by the caller A temporary ID for this stream, usually indicates current usage. Call stack of the requested stream. Note: Stacks will only be populated if RecyclableMemoryStreamManager.GenerateCallStacks is true.

Logged when a buffer is discarded (not put back in the pool, but given to GC to clean up).

Type of the buffer being discarded. A temporary ID for this stream, usually indicates current usage. Reason for the discard.

Logged when a stream grows beyond the maximum capacity.

The requested capacity. Maximum capacity, as configured by RecyclableMemoryStreamManager. A temporary ID for this stream, usually indicates current usage. Call stack for the capacity request. Note: Stacks will only be populated if RecyclableMemoryStreamManager.GenerateCallStacks is true.

Generic delegate for handling events without any arguments.

Delegate for handling large buffer discard reports.

Reason the buffer was discarded.

Delegate for handling reports of stream size when streams are allocated

Bytes allocated.

Delegate for handling periodic reporting of memory use statistics.

Bytes currently in use in the small pool. Bytes currently free in the small pool. Bytes currently in use in the large pool. Bytes currently free in the large pool.

Default block size, in bytes

Default large buffer multiple, in bytes

Default maximum buffer size, in bytes

Initializes the memory manager with the default block/buffer specifications.

Initializes the memory manager with the given block requiredSize.

Size of each block that is pooled. Must be > 0. Each large buffer will be a multiple of this value. Buffers larger than this are not pooled blockSize is not a positive number, or largeBufferMultiple is not a positive number, or maximumBufferSize is less than blockSize. maximumBufferSize is not a multiple of largeBufferMultiple

Initializes the memory manager with the given block requiredSize.

Size of each block that is pooled. Must be > 0. Each large buffer will be a multiple/exponential of this value. Buffers larger than this are not pooled Switch to exponential large buffer allocation strategy blockSize is not a positive number, or largeBufferMultiple is not a positive number, or maximumBufferSize is less than blockSize. maximumBufferSize is not a multiple/exponential of largeBufferMultiple

The size of each block. It must be set at creation and cannot be changed.

All buffers are multiples/exponentials of this number. It must be set at creation and cannot be changed.

Use multiple large buffer allocation strategy. It must be set at creation and cannot be changed.

Use exponential large buffer allocation strategy. It must be set at creation and cannot be changed.

Gets the maximum buffer size.

Any buffer that is returned to the pool that is larger than this will be discarded and garbage collected.

Number of bytes in small pool not currently in use

Number of bytes currently in use by stream from the small pool

Number of bytes in large pool not currently in use

Number of bytes currently in use by streams from the large pool

How many blocks are in the small pool

How many buffers are in the large pool

How many bytes of small free blocks to allow before we start dropping those returned to us.

How many bytes of large free buffers to allow before we start dropping those returned to us.

Maximum stream capacity in bytes. Attempts to set a larger capacity will result in an exception.

A value of 0 indicates no limit.

Whether to save callstacks for stream allocations. This can help in debugging. It should NEVER be turned on generally in production.

Whether dirty buffers can be immediately returned to the buffer pool. E.g. when GetBuffer() is called on a stream and creates a single large buffer, if this setting is enabled, the other blocks will be returned to the buffer pool immediately. Note when enabling this setting that the user is responsible for ensuring that any buffer previously retrieved from a stream which is subsequently modified is not used after modification (as it may no longer be valid).

Causes an exception to be thrown if ToArray is ever called.

Calling ToArray defeats the purpose of a pooled buffer. Use this property to discover code that is calling ToArray. If this is set and stream.ToArray() is called, a NotSupportedException will be thrown.

Removes and returns a single block from the pool.

A byte[] array

Returns a buffer of arbitrary size from the large buffer pool. This buffer will be at least the requiredSize and always be a multiple/exponential of largeBufferMultiple.

The minimum length of the buffer The tag of the stream returning this buffer, for logging if necessary. A buffer of at least the required size.

Returns the buffer to the large pool

The buffer to return. The tag of the stream returning this buffer, for logging if necessary. buffer is null buffer.Length is not a multiple/exponential of LargeBufferMultiple (it did not originate from this pool)

Returns the blocks to the pool

Collection of blocks to return to the pool The tag of the stream returning these blocks, for logging if necessary. blocks is null blocks contains buffers that are the wrong size (or null) for this memory manager

Retrieve a new MemoryStream object with no tag and a default initial capacity.

A MemoryStream.

Retrieve a new MemoryStream object with no tag and a default initial capacity.

A unique identifier which can be used to trace usages of the stream. A MemoryStream.

Retrieve a new MemoryStream object with the given tag and a default initial capacity.

A tag which can be used to track the source of the stream. A MemoryStream.

Retrieve a new MemoryStream object with the given tag and a default initial capacity.

A unique identifier which can be used to trace usages of the stream. A tag which can be used to track the source of the stream. A MemoryStream.

Retrieve a new MemoryStream object with the given tag and at least the given capacity.

A tag which can be used to track the source of the stream. The minimum desired capacity for the stream. A MemoryStream.

Retrieve a new MemoryStream object with the given tag and at least the given capacity.

A unique identifier which can be used to trace usages of the stream. A tag which can be used to track the source of the stream. The minimum desired capacity for the stream. A MemoryStream.

Retrieve a new MemoryStream object with the given tag and at least the given capacity, possibly using a single contiguous underlying buffer.

Retrieving a MemoryStream which provides a single contiguous buffer can be useful in situations where the initial size is known and it is desirable to avoid copying data between the smaller underlying buffers to a single large one. This is most helpful when you know that you will always call GetBuffer on the underlying stream. A unique identifier which can be used to trace usages of the stream. A tag which can be used to track the source of the stream. The minimum desired capacity for the stream. Whether to attempt to use a single contiguous buffer. A MemoryStream.

Retrieve a new MemoryStream object with the given tag and at least the given capacity, possibly using a single contiguous underlying buffer.

Retrieving a MemoryStream which provides a single contiguous buffer can be useful in situations where the initial size is known and it is desirable to avoid copying data between the smaller underlying buffers to a single large one. This is most helpful when you know that you will always call GetBuffer on the underlying stream. A tag which can be used to track the source of the stream. The minimum desired capacity for the stream. Whether to attempt to use a single contiguous buffer. A MemoryStream.

Retrieve a new MemoryStream object with the given tag and with contents copied from the provided buffer. The provided buffer is not wrapped or used after construction.

The new stream's position is set to the beginning of the stream when returned. A unique identifier which can be used to trace usages of the stream. A tag which can be used to track the source of the stream. The byte buffer to copy data from. The offset from the start of the buffer to copy from. The number of bytes to copy from the buffer. A MemoryStream.

Retrieve a new MemoryStream object with the contents copied from the provided buffer. The provided buffer is not wrapped or used after construction.

The new stream's position is set to the beginning of the stream when returned. The byte buffer to copy data from. A MemoryStream.

Retrieve a new MemoryStream object with the given tag and with contents copied from the provided buffer. The provided buffer is not wrapped or used after construction.

The new stream's position is set to the beginning of the stream when returned. A tag which can be used to track the source of the stream. The byte buffer to copy data from. The offset from the start of the buffer to copy from. The number of bytes to copy from the buffer. A MemoryStream.

Triggered when a new block is created.

Triggered when a new large buffer is created.

Triggered when a new stream is created.

Triggered when a stream is disposed.

Triggered when a stream is finalized.

Triggered when a user converts a stream to array.

Triggered when a large buffer is discarded, along with the reason for the discard.

Periodically triggered to report usage statistics.

MemoryStream implementation that deals with pooling and managing memory streams which use potentially large buffers.

This class works in tandem with the RecyclableMemoryStreamManager to supply MemoryStream objects to callers, while avoiding these specific problems: 1. LOH allocations - since all large buffers are pooled, they will never incur a Gen2 GC 2. Memory waste - A standard memory stream doubles its size when it runs out of room. This leads to continual memory growth as each stream approaches the maximum allowed size. 3. Memory copying - Each time a MemoryStream grows, all the bytes are copied into new buffers. This implementation only copies the bytes when GetBuffer is called. 4. Memory fragmentation - By using homogeneous buffer sizes, it ensures that blocks of memory can be easily reused. The stream is implemented on top of a series of uniformly-sized blocks. As the stream's length grows, additional blocks are retrieved from the memory manager. It is these blocks that are pooled, not the stream object itself. The biggest wrinkle in this implementation is when GetBuffer() is called. This requires a single contiguous buffer. If only a single block is in use, then that block is returned. If multiple blocks are in use, we retrieve a larger buffer from the memory manager. These large buffers are also pooled, split by size--they are multiples/exponentials of a chunk size (1 MB by default). Once a large buffer is assigned to the stream the small blocks are NEVER again used for this stream. All operations take place on the large buffer. The large buffer can be replaced by a larger buffer from the pool as needed. All blocks and large buffers are maintained in the stream until the stream is disposed (unless AggressiveBufferReturn is enabled in the stream manager).

All of these blocks must be the same size

This list is used to store buffers once they're replaced by something larger. This is for the cases where you have users of this class that may hold onto the buffers longer than they should and you want to prevent race conditions which could corrupt the data.

This is only set by GetBuffer() if the necessary buffer is larger than a single block size, or on construction if the caller immediately requests a single large buffer.

If this field is non-null, it contains the concatenation of the bytes found in the individual blocks. Once it is created, this (or a larger) largeBuffer will be used for the life of the stream.

Unique identifier for this stream across its entire lifetime

Object has been disposed

A temporary identifier for the current usage of this stream.

Object has been disposed

Gets the memory manager being used by this stream.

Object has been disposed

Callstack of the constructor. It is only set if MemoryManager.GenerateCallStacks is true, which should only be in debugging situations.

Callstack of the Dispose call. It is only set if MemoryManager.GenerateCallStacks is true, which should only be in debugging situations.

Allocate a new RecyclableMemoryStream object.

The memory manager

Allocate a new RecyclableMemoryStream object.

The memory manager A unique identifier which can be used to trace usages of the stream.

Allocate a new RecyclableMemoryStream object

The memory manager A string identifying this stream for logging and debugging purposes

Allocate a new RecyclableMemoryStream object

The memory manager A unique identifier which can be used to trace usages of the stream. A string identifying this stream for logging and debugging purposes

Allocate a new RecyclableMemoryStream object

The memory manager A string identifying this stream for logging and debugging purposes The initial requested size to prevent future allocations

Allocate a new RecyclableMemoryStream object

The memory manager A unique identifier which can be used to trace usages of the stream. A string identifying this stream for logging and debugging purposes The initial requested size to prevent future allocations An initial buffer to use. This buffer will be owned by the stream and returned to the memory manager upon Dispose.

The finalizer will be called when a stream is not disposed properly.

Failing to dispose indicates a bug in the code using streams. Care should be taken to properly account for stream lifetime.

Returns the memory used by this stream back to the pool.

Whether we're disposing (true), or being called by the finalizer (false)

Equivalent to Dispose

Gets or sets the capacity

Capacity is always in multiples of the memory manager's block size, unless the large buffer is in use. Capacity never decreases during a stream's lifetime. Explicitly setting the capacity to a lower value than the current value will have no effect. This is because the buffers are all pooled by chunks and there's little reason to allow stream truncation. Writing past the current capacity will cause Capacity to automatically increase, until MaximumStreamCapacity is reached. Object has been disposed

Gets the number of bytes written to this stream.

Object has been disposed

Gets the current position in the stream

Object has been disposed

Whether the stream can currently read

Whether the stream can currently seek

Always false

Whether the stream can currently write

Returns a single buffer containing the contents of the stream. The buffer may be longer than the stream length.

A byte[] buffer IMPORTANT: Doing a Write() after calling GetBuffer() invalidates the buffer. The old buffer is held onto until Dispose is called, but the next time GetBuffer() is called, a new buffer from the pool will be required. Object has been disposed

Returns an ArraySegment that wraps a single buffer containing the contents of the stream.

An ArraySegment containing a reference to the underlying bytes. Always returns true. GetBuffer has no failure modes (it always returns something, even if it's an empty buffer), therefore this method always returns a valid ArraySegment to the same buffer returned by GetBuffer.

Returns a new array with a copy of the buffer's contents. You should almost certainly be using GetBuffer combined with the Length to access the bytes in this stream. Calling ToArray will destroy the benefits of pooled buffers, but it is included for the sake of completeness.

Object has been disposed The current RecyclableStreamManager object disallows ToArray calls.

Reads from the current position into the provided buffer

Destination buffer Offset into buffer at which to start placing the read bytes. Number of bytes to read. The number of bytes read buffer is null offset or count is less than 0 offset subtracted from the buffer length is less than count Object has been disposed

Reads from the specified position into the provided buffer

Destination buffer Offset into buffer at which to start placing the read bytes. Number of bytes to read. Position in the stream to start reading from The number of bytes read buffer is null offset or count is less than 0 offset subtracted from the buffer length is less than count Object has been disposed

Writes the buffer to the stream

Source buffer Start position Number of bytes to write buffer is null offset or count is negative buffer.Length - offset is not less than count Object has been disposed

Returns a useful string for debugging. This should not normally be called in actual production code.

Writes a single byte to the current position in the stream.

byte value to write Object has been disposed

Reads a single byte from the current position in the stream.

The byte at the current position, or -1 if the position is at the end of the stream. Object has been disposed

Reads a single byte from the specified position in the stream.

The position in the stream to read from The byte at the current position, or -1 if the position is at the end of the stream. Object has been disposed

Sets the length of the stream

value is negative or larger than MaxStreamLength Object has been disposed

Sets the position to the offset from the seek location

How many bytes to move From where The new position Object has been disposed offset is larger than MaxStreamLength Invalid seek origin Attempt to set negative position

Synchronously writes this stream's bytes to the argument stream.

Destination stream Important: This does a synchronous write, which may not be desired in some situations stream is null

Synchronously writes this stream's bytes, starting at offset, for count bytes, to the argument stream.

Destination stream Offset in source Number of bytes to write stream is null Offset is less than 0, or offset + count is beyond this stream's length.

Release the large buffer (either stores it for eventual release or returns it immediately).

Allow Type to be deserialized into late-bound object Types using __type info

Reusable StringBuilder ThreadStatic Cache

Alternative Reusable StringBuilder ThreadStatic Cache

Helpful extensions on ReadOnlySpan<char> Previous extensions on StringSegment available from: https://gist.github.com/mythz/9825689f0db7464d1d541cb62954614c

Returns null if Length == 0, string.Empty if value[0] == NonWidthWhitespace, otherwise returns value.ToString()

Reusable StringWriter ThreadStatic Cache

Alternative Reusable StringWriter ThreadStatic Cache

A class to allow the conversion of doubles to string representations of their exact decimal values. The implementation aims for readability over efficiency. Courtesy of @JonSkeet http://www.yoda.arachsys.com/csharp/DoubleConverter.cs

Converts the given double to a string representation of its exact decimal value.

The double to convert. A string representation of the double's exact decimal value.

Private class used for manipulating

Digits in the decimal expansion, one byte per digit

How many digits are *after* the decimal point

Constructs an arbitrary decimal expansion from the given long. The long must not be negative.

Multiplies the current expansion by the given amount, which should only be 2 or 5.

Shifts the decimal point; a negative value makes the decimal expansion bigger (as fewer digits come after the decimal place) and a positive value makes the decimal expansion smaller.

Removes leading/trailing zeroes from the expansion.

Converts the value to a proper decimal string representation.

Creates an instance of a Type from a string value

Determines whether the specified type is convertible from string.

The type. true if the specified type is convertible from string; otherwise, false.

Parses the specified value.

The value.

Parses the specified type.

The type. The value.

Useful extension method to get the Dictionary[string,string] representation of any POCO type.

Recursively prints the contents of any POCO object in a human-friendly, readable format

Print Dump to Console.WriteLine

Print string.Format to Console.WriteLine

Parses the specified value.

The value.

Customize ServiceStack AutoMapping Behavior

Ignore Type to Type Mapping (including collections containing them)

Populate an object with Example data.

Populates the object with example data.

Tracks how deeply nested we are

Return T[0] when enumerable is null, safe to use in enumerations like foreach

Useful class for C# 8 using declaration to defer action til outside of scope, e.g: using var defer = new Defer(() => response.Close());

RedisNativeClient instance, late-bound object to decouple

Move conflicting extension methods into 'ServiceStack.Extensions' namespace

Returns HttpWebResponse Stream which must be disposed

Populate HttpRequestMessage with a simpler, untyped API Syntax compatible with HttpClient's HttpRequestMessage

Case-insensitive, trimmed compare of two content types from start to ';', i.e. without charset suffix

Returns null for unknown Content-length Syntax + Behavior compatible with HttpClient HttpResponseMessage

Public Code API to register commercial license for ServiceStack.

Internal Utilities to verify licensing

Case-insensitive, trimmed compare of two content types from start to ';', i.e. without charset suffix

UX friendly alternative alias of Dictionary<string, object>

UX friendly alternative alias of Dictionary<string, string>

UX friendly alternative alias of List<KeyValuePair<string, object>gt;

UX friendly alternative alias of List<KeyValuePair<string, string>gt;

Maps the path of a file in the context of a VS project in a Console App

the relative path the absolute path Assumes static content is two directories above the /bin/ directory, eg. in a unit test scenario the assembly would be in /bin/Debug/.

Maps the path of a file in the context of a VS 2017+ multi-platform project in a Console App

the relative path the absolute path Assumes static content is two directories above the /bin/ directory, eg. in a unit test scenario the assembly would be in /bin/Debug/net45

Maps the path of a file in the bin\ folder of a self-hosted scenario

the relative path the absolute path Assumes static content is copied to /bin/ folder with the assemblies

Maps the path of a file in an ASP.NET hosted scenario

the relative path the absolute path Assumes static content is in the parent folder of the /bin/ directory

Create Directory if not exists

Add a Property attribute at runtime. Not threadsafe, should only add attributes on Startup.

Check if #nullable enabled reference type is non nullable

true if #nullable enabled reference type, false if optional, null if value Type or #nullable not enabled

Check if #nullable enabled reference type is non nullable

true if #nullable enabled reference type, false if optional, null if value Type or #nullable not enabled

Implement the serializer using a more static approach

Creates a new instance of type. First looks at JsConfig.ModelFactory before falling back to CreateInstance

Creates a new instance from the default constructor of type

Includes unfiltered serializable properties suitable for caching. Need to exclude JsConfig.ShouldExcludePropertyType() if serializing at runtime

@jonskeet: Collection of utility methods which operate on streams. r285, February 26th 2009: http://www.yoda.arachsys.com/csharp/miscutil/

Reads the given stream up to the end, returning the data as a byte array.

Reads the given stream up to the end, returning the data as a byte array, using the given buffer size.

Reads the given stream up to the end, returning the data as a byte array, using the given buffer for transferring data. Note that the current contents of the buffer is ignored, so the buffer needn't be cleared beforehand.

Reads the given stream up to the end, returning the data as a byte array.

Reads the given stream up to the end, returning the data as a byte array, using the given buffer size.

Reads the given stream up to the end, returning the MemoryStream Buffer as ReadOnlyMemory<byte>.

Copies all the data from one stream into another.

Copies all the data from one stream into another, using a buffer of the given size.

Copies all the data from one stream into another, using the given buffer for transferring data. Note that the current contents of the buffer is ignored, so the buffer needn't be cleared beforehand.

Reads exactly the given number of bytes from the specified stream. If the end of the stream is reached before the specified amount of data is read, an exception is thrown.

Reads into a buffer, filling it completely.

Reads exactly the given number of bytes from the specified stream, into the given buffer, starting at position 0 of the array.

Same as ReadExactly, but without the argument checks.

Returns bytes in publiclyVisible MemoryStream

Writes partial range as specified by start-end, from fromStream to toStream.

Converts from base: 0 - 62

The source. From. To.

Skip the encoding process for 'safe strings'

The Words class transforms words from one form to another. For example, from singular to plural.

Return the plural of a word.

The singular form The plural form of

Return the singular of a word.

The plural form The singular form of

Capitalizes a word.

The word to be capitalized. capitalized.

Avoid polluting extension methods on every type with a 'X.*' short-hand