‫بهینه‌سازی تخصیص حافظه با متد جدید StringBuilder.MoveChunks در NET 11.

// شبیه‌سازی مفهومی عملکرد MoveChunks
var snapshot = new StringBuilder(source.ToString());
source.Clear();

var source = new StringBuilder();
source.AppendLine("Hello World");

// انتقال چانک‌ها به نمونه جدید
StringBuilder snapshot = StringBuilder.MoveChunks(source);

Console.WriteLine(snapshot.ToString()); // خروجی: "Hello World"
Console.WriteLine(source.ToString());   // خروجی: "" (رشته خالی)
Console.WriteLine(source.Length);       // خروجی: 0

// شیء اولیه مجدداً قابل استفاده است
source.Append("Ready for reuse");

namespace System.Text;

public sealed partial class StringBuilder
{
    public static StringBuilder MoveChunks(StringBuilder source)
    {
        ArgumentNullException.ThrowIfNull(source);

        // ساخت یک نمونه جدید با استفاده از سازنده اختصاصی
        StringBuilder destination = new StringBuilder(source);

        // ریست کردن تمام فیلدهای داخلی شیء مبدا به وضعیت اولیه
        source.m_ChunkChars = [];
        source.m_ChunkPrevious = null;
        source.m_ChunkLength = 0;
        source.m_ChunkOffset = 0;

        return destination;
    }

    // Move Constructor (سازنده انتقالی)
    private StringBuilder(StringBuilder from)
    {
        // کپی کردن مراجع آرایه‌ها و مقادیر بدون هیچ‌گونه تخصیص حافظه اضافی
        m_ChunkLength = from.m_ChunkLength;
        m_ChunkOffset = from.m_ChunkOffset;
        m_ChunkChars = from.m_ChunkChars;
        m_ChunkPrevious = from.m_ChunkPrevious;
        m_MaxCapacity = from.m_MaxCapacity;

        // بررسی صحت ساختار در حالت Debug
        AssertInvariants();
    }
}

namespace Microsoft.CodeAnalysis.Text;

public abstract class SourceText
{
    public static SourceText From(string text, Encoding? encoding = null, ...);
    public static SourceText From(TextReader reader, int length, ...);
    public static SourceText From(Stream stream, ...);
    public static SourceText From(byte[] buffer, ...);
}

public static SourceText From(StringBuilder stringBuilder, ...);

نکته:

اگر در معماری سیستم خود از الگوهایی مانند اشیای اشتراکی مکرر (Object Pooling) برای StringBuilder استفاده می‌کنید، توجه داشته باشید که استفاده از MoveChunks باعث می‌شود آرایه‌های داخلی شیء اولیه آزاد شوند. بنابراین در استفاده‌های بعدی، آرایه‌های جدیدی تخصیص خواهند یافت. این متد باید صرفاً در گلوگاه‌هایی استفاده شود که قصد دارید تخصیص حافظه حاصل از ToString() روی رشته‌های بزرگ را به صفر برسانید.