KZDev.PerfUtils 1.0.0

KZDev.PerfUtils

This package contains the MemoryStreamSlim class; a high-performance, memory-efficient, and easy-to-use replacement for the MemoryStream class that provides particular benefits for large or frequently used streams.

Features

MemoryStreamSlim is a drop-in replacement for the MemoryStream class that provides the following benefits:

• Throughput performance is better than the standard MemoryStream.
• Much lower memory traffic and far fewer garbage collections than the standard MemoryStream.
• Eliminates Large Object Heap (LOH) fragmentation caused by frequent use and release of single-byte arrays used by the standard MemoryStream.
• Simple replacement for MemoryStream with the same API, other than the constructor.
• Optionally allows using native memory for storage, which allows even more flexibility to minimize GC pressure.

Example

Below is an example of how to use the MemoryStreamSlim class. Other than instantiation using the Create method, the API is identical to the standard MemoryStream class. It is always a best practice to dispose of the MemoryStreamSlim instance when it is no longer needed.

using KZDev.PerfUtils;

// Create a new MemoryStreamSlim instance
// For the best management of the memory buffers, it is very important to
// dispose of the MemoryStreamSlim instance when it is no longer needed.
using (MemoryStreamSlim stream = MemoryStreamSlim.Create())
{
		// Write some data to the stream
		stream.Write(new byte[] { 1, 2, 3, 4, 5 }, 0, 5);

		// Read the data back from the stream
		stream.Position = 0;
		byte[] buffer = new byte[5];
		stream.Read(buffer, 0, 5);
}

Compare to RecyclableMemoryStream

The MemoryStreamSlim class is similar in concept and purpose to the RecyclableMemoryStream class from Microsoft however the internal implementation of buffer management is quite different. Also, compared to RecyclableMemoryStream, the MemoryStreamSlim class is designed to:

• 'Just work' and be easier to use without tuning parameters.
• Be more flexible in most use cases.
• Perform fewer memory allocations.
• Incur fewer garbage collections.
• Perform on par or better in terms of throughput performance.
• Provide more consistent performance across different workloads.
• Treat security as a priority and opt-out rather than opt-in.
• Optionally allow using native memory for storage to avoid GC pressure impact altogether.

Documentation

Full documentation for the package is available on the PerfUtils Documentation page.

Future Features

The roadmap plan for this package is to add several additional helpful performance focused utilities. These will be forthcoming as time permits, so this first release is focused just on the MemoryStreamSlim class.