Class TextReaderDecoratorExtensions

Namespace: Cuemon.IO

Assembly: Cuemon.IO.dll

Extension methods for the TextReader class hidden behind the IDecorator<T> interface.

public static class TextReaderDecoratorExtensions

Inheritance: object

TextReaderDecoratorExtensions

Examples

TextReaderDecoratorExtensions provides extension methods on Decorator.Enclose for copying TextReader content to TextWriter instances asynchronously with configurable buffer sizes. This example creates a StringReader with three lines of text, copies to a StringWriter via CopyToAsync, and outputs the result. It also demonstrates a custom buffer size of 1024 for the copy operation and copying between different reader/writer types (StreamReader to StringWriter). Console output confirms the copied content matches the source for all three scenarios.

using System.Text;
using System;
using System.IO;
using System.Threading.Tasks;
using Cuemon;
using Cuemon.IO;

namespace MyApp.IO
{
    public class TextReaderDecoratorExtensionsExample
    {
        public async Task DemonstrateAsync()
        {
            string source = "Line 1\nLine 2\nLine 3\n";

            // Copy content from a TextReader to a TextWriter asynchronously
            using var reader = new StringReader(source);
            using var writer = new StringWriter();

            await Decorator.Enclose(reader).CopyToAsync(writer);

            string result = writer.ToString();
            Console.WriteLine(result); // "Line 1\nLine 2\nLine 3\n"

            // Use a custom buffer size
            using var readerSmallBuffer = new StringReader(source);
            using var writerSmallBuffer = new StringWriter();

            await Decorator.Enclose(readerSmallBuffer).CopyToAsync(writerSmallBuffer, bufferSize: 1024);

            string resultSmallBuffer = writerSmallBuffer.ToString();
            Console.WriteLine(resultSmallBuffer); // "Line 1\nLine 2\nLine 3\n"

            // Copy between different TextReader/TextWriter types
            using var streamReader = new StreamReader(new MemoryStream(
                Encoding.UTF8.GetBytes("Stream content")));
            using var stringWriter = new StringWriter();

            await Decorator.Enclose(streamReader).CopyToAsync(stringWriter);
            Console.WriteLine(stringWriter.ToString()); // "Stream content"

}}
}

Methods

CopyToAsync(IDecorator<TextReader>, TextWriter, int)

Asynchronously reads the bytes from the enclosed TextReader of the specified decorator and writes them to the writer.

public static Task CopyToAsync(this IDecorator<TextReader> decorator, TextWriter writer, int bufferSize = 81920)

Parameters

decorator IDecorator<TextReader>: The IDecorator<T> to extend.
writer TextWriter: The TextWriter to asynchronously write bytes to.
bufferSize int: The size, in bytes, of the buffer. This value must be greater than zero. The default size is 81920.

Returns

Task: A task that represents the asynchronous copy operation.

Exceptions

ArgumentNullException: decorator cannot be null -or- writer cannot be null.
ArgumentOutOfRangeException: bufferSize is lower than or equal to 0.

Table of Contents