کتابخانه‌ی استاندارد · سیستم و ابزار

حافظه mem

کار مستقیم با حافظه: تخصیص و آزادسازی، رونوشت، قلمرو و استخر، و بررسی نشتی.

واردسازی حافظه

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

بیشتر برنامه‌ها هیچ‌وقت به این بسته نیاز ندارند: وکتور و نگاشت و رشته حافظه‌شان را خودشان مدیریت می‌کنند. بسته‌ی حافظه برای کارهای سطح پایین است، مثل همکاری با کتابخانه‌های C، پر کردن دستی یک میان‌گیر بایتی یا ساختن ساختمان داده‌ی خودتان. تابع‌هایش پوسته‌ی نازکی روی تخصیص‌دهنده‌ی C (malloc، realloc، free، memcpy) هستند، به‌علاوه‌ی دو تخصیص‌دهنده‌ی خودش و شمارنده‌های نشتی.

  • تخصیص، بازتخصیص و آزادسازی: هر بار یک بلوک که خودتان آزادش می‌کنید.
  • قلمرو (arena) یک تکه حافظه‌ی بزرگ است که از جلویش پشت‌سرهم برمی‌دارید و در پایان همه را یک‌جا رها می‌کنید؛ برای تعداد زیادی شیء کوچک هم‌عمر خیلی سریع است.
  • استخر بلوک‌های هم‌اندازه را به هر ترتیبی می‌دهد و پس می‌گیرد.

برای فهرستی از مقدارها که بزرگ می‌شود، وکتور انتخاب امن‌تری است؛ برای بایت‌ها و قالب‌های دودویی، دودویی را ببینید. برای دیدن حافظه از بیرون یک تابع، اشکال زدایی تابع آمار حافظه را دارد و زمان اجرا حافظه‌ی دستگاه را گزارش می‌کند.

اشتباه‌های رایج:

  • هیچ چیز بررسی نمی‌شود. نوشتن بیرون از انتهای بلوک، دو بار آزاد کردن یا استفاده پس از آزادسازی، بازنشانی قلمرو یا بازگشت به استخر حافظه را بی‌هیچ پیام خطایی خراب می‌کند. salam memcheck این‌ها را برای بلوک‌های تخصیص پیدا می‌کند، ولی نه درون قلمرو یا استخر که برایش فقط یک بلوک‌اند.
  • حافظه را همان‌طور پس بدهید که گرفته‌اید: حافظه.آزادسازی برای تخصیص، و تابع خود کتابخانه‌ی C برای چیزی که آن کتابخانه برمی‌گرداند. در ساخت -DSALAM_MEM_DEBUG هر بلوک تخصیص یک سرآیند پنهان ۸ بایتی دارد، پس قاطی کردن این دو آن‌جا برنامه را از کار می‌اندازد، حتی اگر در ساخت معمولی درست به نظر برسد.
  • پوچ را بررسی کنید. تخصیص، تخصیص در قلمرو و تخصیص از استخر همه وقتی حافظه یا جا نباشد آن را برمی‌گردانند.
  • قلمرو و استخر حافظه را با هم‌ترازی ۸ بایتی می‌دهند که برای همه‌ی گونه‌های سلام کافی است، ولی نه برای داده‌ای که هم‌ترازی ۱۶ بایتی می‌خواهد.

میانگیری که بزرگ می‌شود

کاربرد کلاسیک بازتخصیص میانگیری است که اندازه‌ی نهایی‌اش را نمی‌داند. طول و ظرفیت را کنار اشاره‌گر نگه دارید و وقتی میانگیر پر شد دو برابر جا بخواهید. بازتخصیص محتوای قبلی را نگه می‌دارد، ممکن است آن را به نشانی تازه‌ای ببرد و روی اشاره‌گر پوچ هم کار می‌کند، پس نخستین بزرگ شدن حالت خاصی نمی‌خواهد.

mem-guide-buffer.salam
واردسازی حافظه

ساختار میانگیر:
    همگانی داده: طبیعی۸* = پوچ
    همگانی طول داده: طبیعی۶۴ = ۰
    همگانی ظرفیت: طبیعی۶۴ = ۰
پایان

تابع افزودن(م &: میانگیر، بایت: طبیعی۸):
    اگر م.طول داده == م.ظرفیت:
        ناپایا بعدی := م.ظرفیت * (۲ برگردان طبیعی۶۴)
        اگر بعدی == (۰ برگردان طبیعی۶۴):
            بعدی = ۴ برگردان طبیعی۶۴
        پایان
        م.داده = حافظه.بازتخصیص(م.داده برگردان تهی*، بعدی) برگردان طبیعی۸*
        م.ظرفیت = بعدی
        سرچاپ "بزرگ شد به"، م.ظرفیت، "بایت"
    پایان
    م.داده[م.طول داده] = بایت
    م.طول داده++
پایان

تابع ریشه:
    ناپایا م := میانگیر {}
    متن := "Hello, arena and pool!"
    تکرار متن.طول() در ای:
        افزودن(م، متن[ای] برگردان طبیعی۸)
    پایان
    سرچاپ "طول:"، م.طول داده، "ظرفیت:"، م.ظرفیت
    ناپایا جمع := ۰
    تکرار م.طول داده برگردان صحیح در ای:
        جمع += م.داده[ای] برگردان صحیح
    پایان
    سرچاپ "جمع بایت‌ها:"، جمع
    حافظه.آزادسازی(م.داده برگردان تهی*)
پایان
خروجیبزرگ شد به 4 بایت بزرگ شد به 8 بایت بزرگ شد به 16 بایت بزرگ شد به 32 بایت طول: 22 ظرفیت: 32 جمع بایت‌ها: 1941

با دو برابر کردن، ۲۲ بایت فقط چهار بازتخصیص هزینه دارد و یک میلیون بایت حدود بیست تا. همیشه اشاره‌گری را که بازتخصیص برمی‌گرداند نگه دارید: شاید اشاره‌گر قبلی دیگر معتبر نباشد. در بیشتر برنامه‌ها یک وکتور<طبیعی۸> دقیقاً همین کار را برایتان می‌کند.

یک قلمرو برای هر درخواست

قلمرو وقتی می‌درخشد که شیءهای کوچک زیادی با هم زنده‌اند و با هم از بین می‌روند، مثل هر چیزی که هنگام رسیدگی به یک درخواست یا تجزیه‌ی یک خط ساخته می‌شود. هنگام کار از قلمرو بگیرید و در پایان یک بار بازنشانی قلمرو را صدا بزنید، به‌جای آن‌که تک‌تک شیءها را آزاد کنید. حافظه برای دور بعد دوباره به کار می‌رود، پس برنامه هرگز از سیستم حافظه‌ی بیشتری نمی‌خواهد.

mem-guide-arena.salam
واردسازی حافظه

ساختار توکن:
    همگانی آغاز: صحیح = ۰
    همگانی اندازه: صحیح = ۰
پایان

تابع توکن کردن(ق &: حافظه.قلمرو، خط: رشته): صحیح:
    ناپایا شمار := ۰
    ناپایا ای := ۰
    تا ای < خط.طول():
        اگر خط[ای] == ' ':
            ای++
        وگرنه:
            ت := حافظه.تخصیص در قلمرو(ق، اندازه‌گونه(توکن)) برگردان توکن*
            ت[۰] = توکن { آغاز = ای }
            تا ای < خط.طول() و خط[ای] != ' ':
                ای++
            پایان
            ت[۰].اندازه = ای - ت[۰].آغاز
            شمار++
        پایان
    پایان
    برگشت شمار
پایان

تابع ریشه:
    ناپایا قلمرو := حافظه.قلمرو جدید(۴۰۹۶ برگردان طبیعی۶۴)
    خط‌ها := ["GET /index.html HTTP/1.1"، "POST /api/orders HTTP/1.1"، "DELETE /api/orders/7"]
    هر خط در خط‌ها:
        ع := توکن کردن(قلمرو، خط)
        سرچاپ ع، "توکن،"، حافظه.استفاده شده قلمرو(قلمرو)، "بایت مصرف شده"
        حافظه.بازنشانی قلمرو(قلمرو)
    پایان
    سرچاپ "پس از آخرین بازنشانی:"، حافظه.استفاده شده قلمرو(قلمرو)، "بایت مصرف شده از"، حافظه.ظرفیت قلمرو(قلمرو)
    حافظه.آزادسازی قلمرو(قلمرو)
پایان
خروجی3 توکن، 24 بایت مصرف شده 3 توکن، 24 بایت مصرف شده 2 توکن، 16 بایت مصرف شده پس از آخرین بازنشانی: 0 بایت مصرف شده از 4096

هر تخصیص به مضربی از ۸ بایت گرد می‌شود، برای همین هر توکن با دو صحیح ۸ بایت می‌گیرد. تخصیص در قلمرو وقتی قلمرو پر است پوچ برمی‌گرداند، پس نتیجه را بسنجید یا قلمرو را به اندازه‌ی بزرگ‌ترین دور بسازید. پس از بازنشانی قلمرو همه‌ی اشاره‌گرهایی که از قلمرو گرفته‌اید کهنه‌اند؛ آن‌ها را از یک دور به دور بعد نبرید.

استخری از بلوک‌های هم‌اندازه

استخر برای شیءهای هم‌اندازه‌ای مناسب است که به هر ترتیبی می‌آیند و می‌روند، مثل گره‌های یک فهرست یا درخت. بازگشت به استخر بلوک را به فهرست آزاد استخر برمی‌گرداند و تخصیص از استخر بعدی دوباره همان را می‌دهد، بی‌آن‌که در هیچ‌کدام سراغ تخصیص‌دهنده‌ی سیستم برود. استخر تعداد ثابتی بلوک دارد؛ وقتی همه در حال استفاده‌اند، تخصیص از استخر پوچ برمی‌گرداند. بازگشت به استخر آرگومانش را بررسی نمی‌کند: بلوکی که دو بار برگردانده شود دو بار در فهرست آزاد می‌نشیند و بعداً به دو صاحب داده می‌شود.

mem-guide-pool.salam
واردسازی حافظه
واردسازی رشته

ساختار گره:
    همگانی مقدار: صحیح = ۰
    همگانی بعدی: گره* = پوچ
پایان

تابع گذاشتن(ا &: حافظه.استخر، سر: گره*، مقدار: صحیح): گره*:
    گ := حافظه.تخصیص از استخر(ا) برگردان گره*
    اگر گ == پوچ:
        سرچاپ "استخر پر است، کنار گذاشته شد:"، مقدار
        برگشت سر
    پایان
    گ[۰] = گره { مقدار = مقدار، بعدی = سر }
    برگشت گ
پایان

تابع برداشتن(ا &: حافظه.استخر، سر: گره*): گره*:
    بعدی := سر[۰].بعدی
    حافظه.بازگشت به استخر(ا، سر برگردان تهی*)
    برگشت بعدی
پایان

تابع ریشه:
    ناپایا استخر گره := حافظه.استخر جدید(اندازه‌گونه(گره)، ۳ برگردان طبیعی۶۴)
    ناپایا سر := پوچ برگردان گره*
    تکرار ۱ تا ۴ در م:
        سر = گذاشتن(استخر گره، سر، م * ۱۰)
    پایان
    سرچاپ "بالا:"، سر[۰].مقدار
    سر = برداشتن(استخر گره، سر)
    سر = گذاشتن(استخر گره، سر، ۹۹)
    ناپایا نتیجه := ""
    تا سر != پوچ:
        نتیجه = نتیجه + رشته.از عدد(سر[۰].مقدار) + " "
        سر = برداشتن(استخر گره، سر)
    پایان
    سرچاپ "پشته:"، نتیجه.پیراست()
    حافظه.نابودسازی استخر(استخر گره)
پایان
خروجیاستخر پر است، کنار گذاشته شد: 40 بالا: 30 پشته: 99 20 10

پیدا کردن نشتی

با -DSALAM_MEM_DEBUG بسازید تا تخصیص و آزادسازی شمردن را شروع کنند. آن‌وقت بررسی نشتی جمع‌ها را روی خطای استاندارد چاپ می‌کند و اگر بایتی هنوز آزاد نشده باشد هشدار می‌دهد. ساخت معمولی این شمارش را انجام نمی‌دهد و هزینه‌ای ندارد.

mem-guide-leaks.salam
واردسازی حافظه

تابع ساختن رونوشت(متن: رشته): طبیعی۸*:
    ع := متن.طول() برگردان طبیعی۶۴
    ا := حافظه.تخصیص(ع + (۱ برگردان طبیعی۶۴)) برگردان طبیعی۸*
    تکرار متن.طول() در ای:
        ا[ای] = متن[ای] برگردان طبیعی۸
    پایان
    ا[متن.طول()] = ۰ برگردان طبیعی۸
    برگشت ا
پایان

تابع ریشه:
    الف := ساختن رونوشت("نخست")
    ب := ساختن رونوشت("دوم")
    حافظه.آزادسازی(الف برگردان تهی*)
    اگر حافظه.اشکال زدایی حافظه فعال است():
        سرچاپ "تخصیص‌ها:"، حافظه.شمار تخصیص()، "آزادسازی‌ها:"، حافظه.شمار آزادسازی()
        سرچاپ "بایت‌هایی که هنوز آزاد نشده‌اند:"، حافظه.بایت های زنده()
    وگرنه:
        سرچاپ "برای شمردن تخصیص‌ها با -DSALAM_MEM_DEBUG بسازید"
    پایان
    حافظه.بررسی نشتی()
    حافظه.آزادسازی(ب برگردان تهی*)
پایان
خروجیبرای شمردن تخصیص‌ها با -DSALAM_MEM_DEBUG بسازید

با این پرچم، همین برنامه میانگیری را گزارش می‌کند که هنگام اجرای بررسی نشتی هنوز آزاد نشده بود:

$ salam run -DSALAM_MEM_DEBUG mem-guide-leaks.salam
تخصیص‌ها: 2 آزادسازی‌ها: 1
بایت‌هایی که هنوز آزاد نشده‌اند: 7
[salam memcheck] allocs=2 frees=1 live=7 peak=16
[WARNING] leak bytes=7

شمارنده‌ها حافظه‌ای را می‌بینند که از راه همین بسته گرفته شده، و همچنین حافظه‌ی وکتورها و بسیاری از کارهای رشته‌ای را، ولی نه حافظه‌ای که یک کتابخانه‌ی C با malloc خودش می‌گیرد. برای آن، salam memcheck file.salam برنامه را با AddressSanitizer می‌سازد و هر نشتی را همراه جایی که تخصیص یافته گزارش می‌کند.

کدام تخصیص‌دهنده برای کدام کار

وضعیتاز این استفاده کنیدآزاد کردن با
یک بلوک با هر اندازهتخصیص، تخصیص صفرشدهآزادسازی
آرایه‌ای از N قلمتخصیص آرایه(n، اندازه‌گونه(T))آزادسازی
بلوکی که باید بزرگ شودبازتخصیصآزادسازی
بلوکی که برنامه بدون آن نمی‌تواند ادامه دهدتخصیص حتمی، تخصیص صفرشده حتمی، بازتخصیص حتمیآزادسازی
شیءهای کوچک زیاد با یک عمرقلمرو جدید و تخصیص در قلمروبازنشانی قلمرو، سپس آزادسازی قلمرو
شیءهای هم‌اندازه‌ی زیاد که به هر ترتیبی آزاد می‌شونداستخر جدید و تخصیص از استخربازگشت به استخر، سپس نابودسازی استخر

گونه‌ها

قلمرو Arena

ساختار قلمرو
یک قلمرو حافظه.
نامانگلیسیگونهتوضیح
حافظهbufتهی*نشانی حافظه‌ی قلمرو.
ظرفیتcapطبیعی۶۴ = 0ظرفیت بر حسب بایت.
مقدار استفاده‌شدهusedطبیعی۶۴ = 0مقدار استفاده‌شده.
mem-Arena.salam
واردسازی حافظه

تابع ریشه:
    ناپایا ق := حافظه.قلمرو جدید(۱۰۲۴ برگردان طبیعی۶۴)
    سرچاپ حافظه.ظرفیت قلمرو(ق)، حافظه.استفاده شده قلمرو(ق)
    الف := حافظه.تخصیص در قلمرو(ق، ۱۰۰ برگردان طبیعی۶۴)
    ب := حافظه.تخصیص صفرشده در قلمرو(ق، ۲۰۰ برگردان طبیعی۶۴)
    سرچاپ الف != پوچ، ب != پوچ، حافظه.استفاده شده قلمرو(ق) >= ۳۰۰، حافظه.باقیمانده قلمرو(ق) <= ۷۲۴
    سرچاپ حافظه.تخصیص در قلمرو(ق، ۴۰۰۰ برگردان طبیعی۶۴) == پوچ
    حافظه.بازنشانی قلمرو(ق)
    سرچاپ حافظه.استفاده شده قلمرو(ق)، ق.ظرفیت
    حافظه.آزادسازی قلمرو(ق)
پایان
خروجی1024 0 true true true true true 0 1024

استخر Pool

ساختار استخر
یک استخر بلوک‌های هم‌اندازه.
نامانگلیسیگونهتوضیح
اندازه بلوکblock_sizeطبیعی۶۴ = 0اندازه‌ی هر بلوک.
تعداد بلوک‌هاblock_countطبیعی۶۴ = 0تعداد بلوک‌ها.
حافظه بلوک‌هاblocksتهی*نشانی حافظه‌ی بلوک‌ها.
فهرست آزادهاfree_listتهی*فهرست بلوک‌های آزاد.
mem-Pool.salam
واردسازی حافظه

تابع ریشه:
    ناپایا ا := حافظه.استخر جدید(۳۲ برگردان طبیعی۶۴، ۴ برگردان طبیعی۶۴)
    سرچاپ حافظه.اندازه بلوک(ا)، حافظه.ظرفیت استخر(ا)
    ب۱ := حافظه.تخصیص از استخر(ا)
    ب۲ := حافظه.تخصیص از استخر(ا)
    سرچاپ ب۱ != پوچ، ب۲ != پوچ، ب۱ != ب۲
    حافظه.بازگشت به استخر(ا، ب۱)
    ب۳ := حافظه.تخصیص از استخر(ا)
    سرچاپ ب۳ == ب۱
    حافظه.نابودسازی استخر(ا)
پایان
خروجی32 4 true true true true

تابع‌ها

قلمرو جدید NewArena

تابع قلمرو جدید(capacity: طبیعی۶۴): قلمرو
قلمرویی با ظرفیت داده‌شده به بایت می‌سازد. اگر حافظه به دست نیاید، هر تخصیص در قلمرو پوچ برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Arena.salam

تخصیص در قلمرو ArenaAlloc

تابع تخصیص در قلمرو(a &: قلمرو، size: طبیعی۶۴): تهی*
از قلمرو حافظه برمی‌دارد؛ اندازه به مضرب ۸ گرد می‌شود. اگر جا نباشد یا اندازه صفر باشد، پوچ برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Arena.salam

تخصیص صفرشده در قلمرو ArenaAllocZeroed

تابع تخصیص صفرشده در قلمرو(a &: قلمرو، size: طبیعی۶۴): تهی*
مثل تخصیص در قلمرو، با حافظه‌ی صفرشده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Arena.salam

بازنشانی قلمرو ArenaReset

تابع بازنشانی قلمرو(a &: قلمرو)
همه‌ی برداشت‌ها را یک‌جا پس می‌گیرد تا قلمرو دوباره به کار برود؛ همه‌ی اشاره‌گرهایی که داده بود دیگر معتبر نیستند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Arena.salam

آزادسازی قلمرو ArenaFree

تابع آزادسازی قلمرو(a &: قلمرو)
حافظه‌ی قلمرو را رها می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Arena.salam

استفاده شده قلمرو ArenaUsed

تابع استفاده شده قلمرو(a &: قلمرو): طبیعی۶۴
بایت‌های استفاده‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Arena.salam

ظرفیت قلمرو ArenaCapacity

تابع ظرفیت قلمرو(a &: قلمرو): طبیعی۶۴
ظرفیت قلمرو.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Arena.salam

باقیمانده قلمرو ArenaRemaining

تابع باقیمانده قلمرو(a &: قلمرو): طبیعی۶۴
بایت‌های باقیمانده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Arena.salam

استخر جدید NewPool

تابع استخر جدید(block_size: طبیعی۶۴، block_count: طبیعی۶۴): استخر
استخری با block_count بلوک block_size بایتی می‌سازد؛ اندازه به مضرب ۸ گرد می‌شود و دست‌کم ۸ است. اگر حافظه به دست نیاید، استخر هیچ بلوکی ندارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Pool.salam

تخصیص از استخر PoolAlloc

تابع تخصیص از استخر(p &: استخر): تهی*
یک بلوک آزاد می‌دهد؛ اگر نماند، پوچ.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Pool.salam

بازگشت به استخر PoolFree

تابع بازگشت به استخر(p &: استخر، ptr: تهی*)
بلوک را به استخر برمی‌گرداند؛ تخصیص بعدی همین را می‌دهد. بررسی نمی‌کند که بلوک از همین استخر آمده یا از قبل آزاد نبوده است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Pool.salam

اندازه بلوک PoolBlockSize

تابع اندازه بلوک(p &: استخر): طبیعی۶۴
اندازه‌ی بلوک.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Pool.salam

ظرفیت استخر PoolCapacity

تابع ظرفیت استخر(p &: استخر): طبیعی۶۴
تعداد کل بلوک‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Pool.salam

نابودسازی استخر PoolDestroy

تابع نابودسازی استخر(p &: استخر)
حافظه‌ی استخر را رها می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Pool.salam

تخصیص Allocate

تابع تخصیص(size: طبیعی۶۴): تهی*
بلوکی با اندازه‌ی داده‌شده به بایت می‌گیرد، یا اگر حافظه نباشد پوچ برمی‌گرداند. محتوایش مشخص نیست.
mem-Allocate.salam
واردسازی حافظه

تابع ریشه:
    ب := حافظه.تخصیص(۸ برگردان طبیعی۶۴)
    حافظه.تنظیم(ب، ۰، ۸ برگردان طبیعی۶۴)
    ا := ب برگردان صحیح۸*
    ا[۰] = ۶۵ برگردان صحیح۸
    ا[۱] = ۶۶ برگردان صحیح۸
    ب۲ := حافظه.تخصیص صفرشده(۸ برگردان طبیعی۶۴)
    حافظه.کپی(ب۲، ب، ۲ برگردان طبیعی۶۴)
    ا۲ := ب۲ برگردان صحیح۸*
    سرچاپ ا۲[۰]، ا۲[۱]، ا۲[۲]
    حافظه.جابجایی حافظه(ب، (ب برگردان صحیح۶۴ + ۱) برگردان تهی*، ۱ برگردان طبیعی۶۴)
    سرچاپ ا[۰]
    ب۳ := حافظه.بازتخصیص(ب، ۶۴ برگردان طبیعی۶۴)
    آ := حافظه.تخصیص آرایه(۴ برگردان طبیعی۶۴، ۸ برگردان طبیعی۶۴)
    آ۶۴ := آ برگردان صحیح۶۴*
    سرچاپ آ۶۴[۳]
    حافظه.آزادسازی(ب۳)
    حافظه.آزادسازی(ب۲)
    حافظه.آزادسازی(آ)
پایان
خروجی65 66 0 66 0

بازتخصیص Reallocate

تابع بازتخصیص(ptr: تهی*، size: طبیعی۶۴): تهی*
اندازه‌ی یک بلوک را تغییر می‌دهد و محتوایش را نگه می‌دارد؛ ممکن است نشانی تازه‌ای برگرداند و روی اشاره‌گر پوچ تخصیص تازه می‌دهد. نتیجه را نگه دارید: اشاره‌گر قبلی ممکن است نامعتبر باشد، و اگر شکست بخورد پوچ برمی‌گرداند و بلوک قبلی هنوز مال شماست که آزادش کنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Allocate.salam

آزادسازی Free

تابع آزادسازی(ptr: تهی*)
بلوکی را که از تخصیص، بازتخصیص یا شکل‌های صفرشده آمده پس می‌دهد. پوچ نادیده گرفته می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Allocate.salam

تنظیم Set

تابع تنظیم(ptr: تهی*، value: صحیح، n: طبیعی۶۴)
n بایت را با مقدار داده‌شده پر می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Allocate.salam

کپی Copy

تابع کپی(dst: تهی*، src: تهی*، n: طبیعی۶۴)
n بایت را از src به dst رونوشت می‌کند؛ دو بازه نباید هم‌پوشانی داشته باشند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Allocate.salam

جابجایی حافظه MemMove

تابع جابجایی حافظه(dst: تهی*، src: تهی*، n: طبیعی۶۴): تهی*
مثل کپی، ولی حتی اگر بازه‌ها هم‌پوشانی داشته باشند درست کار می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Allocate.salam

تخصیص صفرشده AllocateZeroed

تابع تخصیص صفرشده(size: طبیعی۶۴): تهی*
حافظه‌ی صفرشده می‌گیرد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Allocate.salam

کمبود حافظه OutOfMemory

تابع کمبود حافظه()
خروجی استاندارد را تخلیه می‌کند، salam: out of memory را چاپ می‌کند و برنامه را متوقف می‌کند. برای برنامه‌ای که خودش پوچ را بررسی می‌کند و راهی برای ادامه ندارد.
mem-Must.salam
واردسازی حافظه

تابع ریشه:
    الف := حافظه.تخصیص حتمی(۸ برگردان طبیعی۶۴) برگردان صحیح۶۴*
    الف[۰] = ۷
    سرچاپ الف[۰]
    ب := حافظه.تخصیص صفرشده حتمی(۸ برگردان طبیعی۶۴) برگردان صحیح۶۴*
    سرچاپ ب[۰]
    بزرگ := حافظه.بازتخصیص حتمی(الف برگردان تهی*، ۶۴ برگردان طبیعی۶۴)
    نگه‌داشته := حافظه.تخصیص(۱۶ برگردان طبیعی۶۴)
    اگر نگه‌داشته برابر پوچ:
        حافظه.کمبود حافظه()
    پایان
    حافظه.آزادسازی(نگه‌داشته)
    حافظه.آزادسازی(بزرگ)
    حافظه.آزادسازی(ب برگردان تهی*)
پایان

تخصیص حتمی MustAllocate

تابع تخصیص حتمی(size: طبیعی۶۴): تهی*
مانند تخصیص، اما اگر حافظه به دست نیاید خروجی استاندارد را تخلیه می‌کند، salam: out of memory را چاپ می‌کند و برنامه را متوقف می‌کند و پوچ برنمی‌گرداند. وکتور، نگاشت، رشته‌ها، جعبه‌های پویا و بستارها هم همین‌گونه شکست می‌خورند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Must.salam

تخصیص صفرشده حتمی MustAllocateZeroed

تابع تخصیص صفرشده حتمی(size: طبیعی۶۴): تهی*
مانند تخصیص صفرشده، اما با همان پیام متوقف می‌شود و پوچ برنمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Must.salam

بازتخصیص حتمی MustReallocate

تابع بازتخصیص حتمی(ptr: تهی*، size: طبیعی۶۴): تهی*
مانند بازتخصیص، اما با همان پیام متوقف می‌شود و پوچ برنمی‌گرداند. اندازه‌ی صفر شکست به حساب نمی‌آید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Must.salam

تخصیص آرایه AllocateArray

تابع تخصیص آرایه(count: طبیعی۶۴، size: طبیعی۶۴): تهی*
حافظه‌ی صفرشده برای count عضو، هر کدام size بایت. اگر یکی از آن دو صفر باشد یا حاصل‌ضرب در ۶۴ بیت جا نشود، پوچ برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Allocate.salam

شمار تخصیص AllocCount

تابع شمار تخصیص(): صحیح۶۴
تعداد تخصیص‌ها؛ فقط در ساخت با اشکال‌زدایی حافظه، وگرنه صفر.
mem-Debug.salam
واردسازی حافظه

تابع ریشه:
    سرچاپ حافظه.اشکال زدایی حافظه فعال است()، حافظه.ای سن فعال است()، حافظه.بررسی حافظه فعال است()
    سرچاپ حافظه.شمار تخصیص()، حافظه.شمار آزادسازی()، حافظه.بایت های زنده()، حافظه.بیشترین بایت ها()
    حافظه.بررسی نشتی()
پایان
خروجیfalse false false 0 0 0 0

شمار آزادسازی FreeCount

تابع شمار آزادسازی(): صحیح۶۴
تعداد آزادسازی‌ها؛ فقط در ساخت با اشکال‌زدایی حافظه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Debug.salam

بایت های زنده LiveBytes

تابع بایت های زنده(): صحیح۶۴
بایت‌هایی که گرفته و هنوز پس داده نشده‌اند؛ بدون اشکال‌زدایی حافظه صفر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Debug.salam

بیشترین بایت ها PeakBytes

تابع بیشترین بایت ها(): صحیح۶۴
بیشترین حافظه‌ی گرفته‌شده در یک لحظه؛ فقط با اشکال‌زدایی حافظه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Debug.salam

اشکال زدایی حافظه فعال است IsMemDebug

تابع اشکال زدایی حافظه فعال است(): منطقی
اگر برنامه با شمارش تخصیص ساخته شده باشد، درست است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Debug.salam

ای سن فعال است IsAsanActive

تابع ای سن فعال است(): منطقی
اگر برنامه با بررسی‌گر ASAN ساخته شده باشد، درست است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Debug.salam

بررسی حافظه فعال است MemDebugActive

تابع بررسی حافظه فعال است(): منطقی
اگر یکی از دو بررسی‌گر حافظه فعال باشد، درست است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Debug.salam

بررسی نشتی CheckLeaks

تابع بررسی نشتی()
شمارنده‌ها را در خطای استاندارد چاپ می‌کند و درباره‌ی بایت‌هایی که پس داده نشده‌اند هشدار می‌دهد؛ در پایان برنامه صدایش بزنید. بدون اشکال‌زدایی حافظه چیزی چاپ نمی‌کند و زیر ASan گزارش هنگام خروج می‌آید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: mem-Debug.salam