کتابخانه‌ی استاندارد · کدگذاری و داده

بایگانی archive

ساختن، فهرست کردن، بررسی و استخراج زیپ، تار، tar.gz، tar.zst، جی‌زیپ، زستد و RAR، با گذرواژه و RAR چندبخشی.

واردسازی بایگانی

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

بایگانی چند پرونده را در یک پرونده جمع می‌کند. زیپ هر پرونده را جدا فشرده می‌کند؛ تار فقط پرونده‌ها را پشت‌سرهم می‌گذارد و معمولاً بعد با جی‌زیپ فشرده می‌شود (.tar.gz).

تابع‌ها هم در حافظه کار می‌کنند و هم با پرونده. داده‌ی بایگانی را با نشانی و طول می‌گیرند، مثل ب.data و ب.len از یک بافر بایت.

همه‌ی قالب‌ها در یک نگاه

قالبساختنفهرستخواندن یک پروندهاستخراج همهآیا داده بررسی می‌شود؟
.zipساخت زیپ، ساخت زیپ بزرگ، ساخت پرونده زیپفهرست زیپاستخراج با نام از زیپ، استخراج با نام از زیپ با سقف، استخراج تایید شده از زیپاستخراج همه از زیپبا استخراج تایید شده از زیپ، بررسی زیپ و استخراج همه از زیپ بله. استخراج با نام از زیپ بررسی نمی‌کند (بخش «بررسی یک بایگانی»).
.tarساخت تار، ساخت پرونده تارفهرست تاراستخراج با نام از تاراستخراج همه از تارنه. تار چک‌جمعی از محتوا نگه نمی‌دارد.
.tar.gzساخت تار جی زیپ، ساخت پرونده تار جی زیپفهرست تار جی زیپ، فهرست تار جی زیپ با سقفاستخراج با نام از تار جی زیپ، استخراج با نام از تار جی زیپ با سقفاستخراج همه از تار جی زیپ، استخراج همه از تار جی زیپ با سقفبله، با مرحله‌ی جی‌زیپ: CRC-32 و طول آن سنجیده می‌شود. شکل‌های «با سقف» جلوی باز شدن بی‌حد یک پرونده‌ی کوچک را می‌گیرند.
.tar.zstساخت تار زستد، ساخت پرونده تار زستدفهرست تار زستد، فهرست تار زستد با سقفاستخراج با نام از تار زستد، استخراج با نام از تار زستد با سقفاستخراج همه از تار زستد، استخراج همه از تار زستد با سقفبله، با مرحله‌ی زستد: چک‌جمع XXH64 آن سنجیده می‌شود. شکل‌های با سقف جلوی باز شدن بی‌حد یک پرونده‌ی کوچک را می‌گیرند.
.bz2 (یک پرونده)فشرده سازی پرونده بی زیپ دو، فشرده سازی.فشرده سازی بی زیپ دو بافرنداردکدگشایی پرونده بی زیپ دو، فشرده سازی.کدگشایی بی زیپ دو بافرهمانبله: CRC همه‌ی بلوک‌ها و CRC جریان سنجیده می‌شود و با ناهمخوانی ok نادرست است.
.gz (یک پرونده)فشرده سازی پرونده جی زیپ، فشرده سازی.فشرده سازی جی زیپ بافرنداردکدگشایی پرونده جی زیپ، فشرده سازی.کدگشایی جی زیپ بافرهمانبله: CRC-32 و طول سنجیده می‌شود و با ناهمخوانی ok نادرست است.
.xz (یک پرونده)فشرده سازی پرونده ایکس زد، فشرده سازی.فشرده سازی ایکس زد بافرکاربرد نداردکدگشایی پرونده ایکس زد، فشرده سازی.کدگشایی ایکس زد بافرهمانبله: سرآیندها، نمایه و CRC-32، CRC-64 یا SHA-256 هر بلوک بررسی می‌شود و در ناهمخوانی ok نادرست است.
.lzma (یک پرونده)فشرده سازی پرونده الزد ام ای، فشرده سازی.فشرده سازی الزد ام ای بافرکاربرد نداردکدگشایی پرونده الزد ام ای، فشرده سازی.کدگشایی الزد ام ای بافرهمانفقط ساختار: این قالب چک‌جمع ندارد.
.zst (یک پرونده)فشرده سازی پرونده زستد، فشرده سازی پرونده زستد با سطح، فشرده سازی.فشرده سازی زستد بافرنداردکدگشایی پرونده زستد، فشرده سازی.کدگشایی زستد بافرهمانبله: اگر پرونده چک‌جمع XXH64 داشته باشد سنجیده می‌شود و با ناهمخوانی ok نادرست است.
.rarساخت آر ای آر، ساخت پرونده آر ای آر (ذخیره‌شده، RAR 5)فهرست آر ای آر، مدخل‌های آر ای آراستخراج آر ای آر، خواندن از آر ای آراستخراج همه از آر ای آر، خواندن همه از آر ای آربله، هر مدخل؛ نتیجه یک کد وضعیت است.
.7zساخت هفت زد، ساخت پرونده هفت زد (ذخیره‌شده)، ساخت هفت زد با سطح، ساخت پرونده هفت زد با سطح (LZMA، سطح ۱ تا ۹)فهرست هفت زد، مدخل‌های هفت زداستخراج با نام از هفت زد، استخراج هفت زد، خواندن از هفت زداستخراج همه از هفت زد، خواندن همه از هفت زدبله: سرآیندها، هر بلوک یکپارچه و هر پرونده با CRC-32 سنجیده می‌شوند؛ نتیجه یک کد وضعیت است.

مجموعه‌ی چندبخشی برای RAR با RarOpenVolumes برای 7z با SevenZipOpenVolumes و برای زیپ با ZipOpenFile (یکی از قطعه‌های .zip، .z01 یا .zip.001 را بدهید؛ بقیه کنار آن پیدا می‌شوند) کار می‌کند و با ZipCreateFileSplit نوشته می‌شود. گذرواژه برای RAR با RarOpen و برای 7z با SevenZipOpen کار می‌کند. مدخل‌های زیپ گذرواژه‌دار با بازکردن پرونده زیپ و تنظیم گذرواژه پرونده زیپ خوانده می‌شوند (ZipCrypto و AES وین‌زیپ) و با گذرواژه نوشته می‌شوند.

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

محدودیت‌هایی که باید بدانید

  • زیپ: zip64 خوانده و نوشته می‌شود (اندازه و جابه‌جایی ۶۴ بیتی، رکورد پایانی zip64، بیش از ۶۵۵۳۵ مدخل)، ولی بسته بایت‌ها را در یک int می‌شمارد، پس در عمل بایگانی و هر مدخل باید زیر ۲ گیگابایت بماند. مدخل بزرگ‌تر با اندازه‌ی واقعی‌اش فهرست می‌شود و استخراجش ZIP_TOO_BIG گزارش می‌کند؛ ساخت زیپ برای ورودی‌ای که جا نمی‌شود، یعنی طول منفی، نشانی تهی همراه با طول، نام بیش از ۶۵۵۳۵ بایت یا مجموع نزدیک ۱٫۹ گیگابایت، بافر خالی برمی‌گرداند (و ساخت پرونده زیپ نادرست). ساخت زیپ فقط از ۶۵۵۳۵ مدخل به بالا خودش به zip64 می‌رود؛ ساخت زیپ بزرگ همیشه شکل zip64 را می‌نویسد که unzip و 7z می‌خوانند. روش‌های ۰ (بی‌فشرده‌سازی)، ۸ (DEFLATE)، ۱۲ (bzip2)، ۱۴ (LZMA) و ۹۳ (zstd) خوانده و نوشته می‌شوند و روش ۹ (Deflate64، همان که 7-Zip با -mm=Deflate64 می‌نویسد) خوانده می‌شود؛ هر روش دیگر ZIP_UNSUPPORTED گزارش می‌شود و مدخل‌های رمزدار به شکل ZipCrypto یا AES-128، AES-192 و AES-256 وین‌زیپ نوشته می‌شوند (گذرواژه و رمزگذاری)؛ خواننده‌های درون‌حافظه‌ای آن‌ها را نمی‌پذیرند، از بازکردن پرونده زیپ استفاده کنید. استخراج با نام از زیپ و استخراج با نام از زیپ با سقف CRC-32 را بررسی نمی‌کنند؛ استخراج تایید شده از زیپ، بررسی زیپ و استخراج همه از زیپ بررسی می‌کنند و استخراج همه از زیپ مدخلی را که بررسی را نگذراند نمی‌نویسد و نادرست برمی‌گرداند.
  • نام و تاریخ در زیپ: نامی که بایت غیر ASCII دارد با پرچم UTF-8 (بیت ۱۱ پرچم‌های عمومی) نوشته می‌شود، پس Windows Explorer، unzip و 7-Zip نام‌های فارسی را درست نشان می‌دهند. هنگام خواندن، نام همان‌طور که هست (UTF-8) گرفته می‌شود، مگر فیلد «مسیر یونیکد» Info-ZIP باشد که در آن صورت آن برنده است. نام‌های کدصفحه‌های دیگر تبدیل نمی‌شوند. تاریخ‌ها تاریخ DOS هستند: گام دو ثانیه‌ای، بین ۱۹۸۰ و ۲۱۰۷، بدون منطقه‌ی زمانی، که اینجا UTC خوانده می‌شود. برای تاریخ‌دار کردن مدخل ZipFileInput.mtime (ثانیه از ۱۹۷۰) را بگذارید؛ ۰ یا هر زمان پیش از ۱۹۸۰ تاریخ ۱ ژانویه‌ی ۱۹۸۰ را می‌نویسد. فیلد اضافی زمان نوشته نمی‌شود. استخراج همه از زیپ زمان تغییر پرونده‌های نوشته‌شده را از همین تاریخ می‌گذارد، مگر در ویندوز و سامانه‌های ۳۲ بیتی، و به پوشه‌ها دست نمی‌زند.
  • تار: نام با هر طولی بدون تغییر نوشته و خوانده می‌شود: نام بلند اگر در یک اسلش بشکند در فیلد پیشوند ustar و در غیر این صورت در یک رکورد path از PAX ذخیره می‌شود، و خواندن پیشوند ustar، PAX (انواع x و g) و نام‌ها و پیوندهای بلند GNU را می‌فهمد. پیوند نمادین و پیوند سخت مدخل‌های واقعی‌اند (مدخل.نوع و مدخل.پیوند)؛ دستگاه‌ها، لوله‌ها و دیگر مدخل‌های ویژه با نوع ۴ فهرست می‌شوند و استخراج همه از تار آن‌ها را رد می‌کند. زمان و دسترسی که تعیین کرده‌اید نوشته می‌شود (زمانی که از بازه‌ی ustar بیرون باشد در رکورد PAX می‌رود) و استخراج دسترسی و زمان تغییر پرونده‌ها و پوشه‌ها را اعمال می‌کند، ولی مالک را نه. روی ویندوز پیوند نمادین ساخته نمی‌شود (فراخوانی نادرست برمی‌گرداند)، پیوند سخت به رونوشت تبدیل می‌شود و زمان گذاشته نمی‌شود؛ روی سامانه‌های ۳۲ بیتی هم زمان گذاشته نمی‌شود. مدخلی که زمان نگیرد ۰ می‌گیرد، و دسترسی که صفر بگذارید برای پرونده‌ها 644، برای پوشه‌ها 755 و برای پیوند نمادین 777 می‌شود.
  • استخراج تار: استخراج همه از تار این موارد را رد می‌کند و نادرست برمی‌گرداند: نام مطلق یا نامی که با .. بیرون می‌زند، نامی که از یک پیوند نمادین عبور کند، پیوند نمادینی که مقصدش مطلق است یا از پوشه‌ی مقصد بیرون می‌رود (.. بعد از یک نام هم رد می‌شود)، و پیوند سختی به نامی بیرون از پوشه. بیت‌های مانند set-user-id هرگز اعمال نمی‌شوند.
  • RAR: بایگانی‌های RAR 5 کامل خوانده می‌شوند: همه‌ی سطح‌های فشرده‌سازی، بایگانی‌های پیوسته (solid) و فیلترهای داخلی، و CRC-32 هر مدخل بررسی می‌شود. بایگانی‌های قدیمی‌تر (RAR 1.5 تا 4) به همین شکل خوانده می‌شوند، با فشرده‌سازی متنی PPMd و فیلترهای استاندارد. بایگانی‌های گذرواژه‌دار با بازکردن آر ای آر و گذرواژه باز می‌شوند، حتی اگر نام پرونده‌ها هم رمزگذاری شده باشد؛ بدون گذرواژه RAR_ENCRYPTED می‌گیرید و گذرواژه‌ی اشتباه RAR_BAD_PASSWORD می‌دهد. بایگانی‌های چندبخشی از فهرست بخش‌ها باز می‌شوند (RarOpenVolumes، یا RarReadVolumes برای خواندن یک مجموعه از دیسک)؛ مجموعه‌ای که بخشی از آن کم باشد برای پرونده‌هایی که از آن می‌گذرند RAR_MULTIVOLUME می‌دهد. پرونده‌ای که هم رمزدار باشد و هم میان چند بخش پخش شده باشد هم خوانده می‌شود (با unrar مرجع روی مجموعه‌های RAR 1.5 و 2.0 و 3 و 5 سنجیده شده). گذرواژه‌های قدیمی RAR 1.5 و 2 هم کار می‌کنند و با یک پرونده‌ی واقعی WinRAR 2.02 آزموده شده‌اند. نسخه‌ی ۱ قالب RAR 7 (فرهنگ‌لغت بیش از ۴ گیگابایت و اندازه‌های کسری) خوانده می‌شود؛ فقط فاصله‌ی تطبیق بیش از ۴ گیگابایت هرگز اجرا نشده است. در تابع‌های درون‌حافظه‌ای بایگانی و هر مدخل باید زیر ۲ گیگابایت بمانند (مدخل بزرگ‌تر RAR_TOO_BIG می‌دهد)؛ برای پرونده‌های RAR 5 بزرگ‌تر از RarFileOpen استفاده کنید که از دیسک می‌خواند و تکه‌تکه باز می‌کند. استخراج مجوزهای یونیکس و زمان تغییر را بازمی‌گرداند (روی سامانه‌های ۶۴ بیتی جز ویندوز)، پیوندهای نمادین را که مقصدشان داخل پوشه‌ی مقصد بماند می‌سازد و پیوندهای سخت و رونوشت‌ها را همچون رونوشت ساده می‌نویسد؛ پیوندی که به بیرون اشاره کند کنار گذاشته و با RAR_UNSAFE_PATH گزارش می‌شود. بایگانی‌های تازه RAR 5 با پرونده‌های ذخیره‌شده‌اند، چون فقط خود WinRAR می‌تواند به RAR فشرده کند؛ هر ابزار RAR آن‌ها را باز می‌کند.
  • 7z: خواندن، و نوشتن فقط با داده‌ی ذخیره‌شده. LZMA، LZMA2، PPMd، BZip2، Deflate، Deflate64، ذخیره، BCJ2، فیلترهای شاخه (x86، ARM، ARM64، RISC-V و دیگران)، جابجایی بایت و دلتا پشتیبانی می‌شوند، با گذرواژه‌ی AES-256 (سرآیندها هم)؛ مجموعه‌های چندبخشی (.7z.001) و بایگانی‌های خودگشا (یک کد اجرایی پیش از بایگانی) خوانده می‌شوند. دسترسی یونیکس، زمان و پیوندهای نمادین هنگام استخراج بازسازی می‌شوند و پیوندی که بیرون از پوشه‌ی مقصد اشاره کند رد می‌شود. توابعی که نشانی و طول می‌گیرند هرچه را باز می‌کنند در حافظه نگه می‌دارند، پس بلوک یکپارچه تا حدود یک گیبی‌بایت سقف دارد و واژه‌نامه‌ی جریان LZMA نباید از یک گیبی‌بایت بگذرد؛ SevenZipOpenFile این محدودیت را ندارد (پایین‌تر). نام‌ها UTF-8 هستند؛ زمان، آخرین تغییر است.

راهنمای زیر کارهای معمول را نشان می‌دهد: زیپ کردن چند پرونده، ساختن و خواندن یک .tar.gz، شناختن قالب از روی بایت‌های نخست، و استخراج بی‌آنکه بایگانی بتواند بیرون از پوشه‌ی مقصد چیزی بنویسد.

زیپ کردن چند پرونده

هر پرونده‌ای که در زیپ می‌گذارید یک ورودی پرونده زیپ است: مسیرش درون بایگانی، نشانی و طول بایت‌هایش، و روش فشرده‌سازی: ۸ یعنی DEFLATE، ۰ یعنی نگه‌داری بی‌فشرده‌سازی، و ۱۲ و ۱۴ و ۹۳ یعنی bzip2 و LZMA و zstd (ثابت‌های روش زیپ...). ساخت ورودی پرونده زیپ با سطح برای این فشرده‌سازها سطح هم می‌گذارد. مدخل‌های bzip2 را هر unzip می‌خواند؛ مدخل‌های LZMA و zstd را 7-Zip و zipfile پایتون می‌خوانند (zstd از پایتون ۳٫۱۴)، ولی ابزارهای قدیمی مثل unzip بسته‌ی Info-ZIP نه، پس فقط وقتی خواننده را می‌شناسید از آن‌ها استفاده کنید. نامی که با / تمام شود یک پوشه است. ساخت پرونده زیپ بایگانی را روی دیسک می‌نویسد و اگر نتواند نادرست برمی‌گرداند؛ مدخل‌های bzip2 و LZMA و zstd از رمزگذارهای std/compress تکه‌تکه می‌گذرند، پس مدخل با هر اندازه فقط پنجره‌ی رمزگذار را در حافظه می‌خواهد (حدود ۱ مبی‌بایت برای zstd در سطح پیش‌فرض، چند مبی‌بایت برای LZMA، یک بلوک برای bzip2)؛ ساخت زیپ آن را در حافظه نگه می‌دارد، مثلاً برای فرستادن در پاسخ HTTP.

archive-guide-bundle.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    صفحه اصلی := فشرده سازی.بافر از رشته("<html><body><h1>Hello</h1><p>Hello again, hello once more.</p></body></html>\n")
    سبک := فشرده سازی.بافر از رشته("body { margin: 0; }\nh1 { margin: 0; }\np { margin: 0; }\n")
    نشان := فشرده سازی.فشرده سازی جی زیپ رشته("pretend this is an image that is already compressed")
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("site/"، پوچ، ۰، ۰))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("site/index.html"، صفحه اصلی.داده، صفحه اصلی.طول، ۸))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("site/style.css"، سبک.داده، سبک.طول، ۸))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("site/logo.bin"، نشان.داده، نشان.طول، ۰))
    اگر وارونه بایگانی.ساخت پرونده زیپ(پرونده‌ها، "site.zip"):
        سرچاپ "نوشتن site.zip نشد"
        برگشت ۱
    پایان
    ناپایا خوب := نادرست
    ز := بایگانی.خواندن پرونده دودویی("site.zip"، خوب)
    ناپایا فهرست := بایگانی.فهرست زیپ(ز.داده، ز.طول)
    هر م در فهرست:
        اگر م.پوشه:
            سرچاپ م.نام، "(پوشه)"
        وگرنه:
            سرچاپ م.نام، م.اندازه، "->"، م.اندازه فشرده، "روش"، م.روش
        پایان
    پایان
    بایگانی.آزادسازی فهرست(فهرست)
    برگشت ۰
پایان
خروجیsite/ (پوشه) site/index.html 77 -> 63 روش 8 site/style.css 55 -> 29 روش 8 site/logo.bin 64 -> 64 روش 0

متن خوب فشرده می‌شود. نشان از پیش فشرده است و برای همین روش ۰ دارد: DEFLATE دوباره روی آن فقط زمان می‌گیرد و حتی ممکن است بزرگ‌ترش کند. همین قاعده برای JPEG، PNG، MP4 و زیپ‌های دیگر هم درست است.

ساختن و خواندن .tar.gz

تار فشرده نمی‌کند. هر پرونده را پس از یک سرآیند ۵۱۲ بایتی می‌گذارد و محتوایش را تا مضربی از ۵۱۲ بایت پر می‌کند، پس سه پرونده‌ی کوچک همین حالا ۳٫۵ کیلوبایت می‌شوند. راه معمول این است که کل تار را جی‌زیپ کنید تا این پرکردن‌ها تقریباً ناپدید شوند. در حافظه این کار ساخت تار و سپس فشرده سازی.فشرده سازی جی زیپ بافر است؛ برای تاری که روی دیسک هست، فشرده سازی پرونده جی زیپ و کدگشایی پرونده جی زیپ از پرونده به پرونده کار می‌کنند. ساخت تار جی زیپ و ساخت پرونده تار جی زیپ هر دو مرحله را یک‌جا انجام می‌دهند.

archive-guide-targz.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    راهنما := فشرده سازی.بافر از رشته("پشتیبان پوشه‌ی تنظیمات.\n")
    تنظیم := فشرده سازی.بافر از رشته("port = 8080\nworkers = 4\nport_admin = 8081\n")
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("config"، پوچ، ۰، درست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("config/README"، راهنما.داده، راهنما.طول، نادرست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("config/app.conf"، تنظیم.داده، تنظیم.طول، نادرست))
    تار := بایگانی.ساخت تار(پرونده‌ها)
    فشرده := فشرده سازی.فشرده سازی جی زیپ بافر(تار)
    سرچاپ "tar:"، تار.طول، "بایت، tar.gz:"، فشرده.طول، "بایت"
    بایگانی.نوشتن پرونده دودویی از بافر("config.tar.gz"، فشرده)

    ناپایا خوب := نادرست
    خوانده := بایگانی.خواندن پرونده دودویی("config.tar.gz"، خوب)
    ساده := فشرده سازی.کدگشایی جی زیپ بافر(خوانده، خوب)
    اگر وارونه خوب:
        سرچاپ "config.tar.gz جی‌زیپ درستی نیست"
        برگشت ۱
    پایان
    ناپایا فهرست := بایگانی.فهرست تار(ساده.داده، ساده.طول)
    هر م در فهرست:
        سرچاپ م.نام، م.اندازه، م.پوشه
    پایان
    بایگانی.آزادسازی فهرست(فهرست)
    برنامه := بایگانی.استخراج با نام از تار(ساده.داده، ساده.طول، "config/app.conf"، خوب)
    چاپ فشرده سازی.بافر به رشته(برنامه)
    برگشت ۰
پایان
خروجیtar: 3584 بایت، tar.gz: 230 بایت config 0 true config/README 45 false config/app.conf 42 false port = 8080 workers = 4 port_admin = 8081

خواندن برعکس است: فهرست تار جی زیپ، استخراج با نام از تار جی زیپ و استخراج همه از تار جی زیپ در یک فراخوانی هم می‌گشایند و هم می‌خوانند، و اگر داده جی‌زیپ معتبر نباشد خوب را نادرست می‌کنند. بیش از ۱ گیگابایت باز نمی‌کنند؛ برای ورودی نامطمئن به شکل‌های «با سقف» سقف کمتری بدهید. ورودی‌های پوشه در تار اندازه‌ی ۰ دارند و is_dir آن‌ها درست است.

زستد هم همین‌طور کار می‌کند: ساخت تار زستد تار را می‌سازد و فشرده می‌کند، و فهرست تار زستد، استخراج با نام از تار زستد و استخراج همه از تار زستد در یک فراخوانی باز می‌کنند و می‌خوانند، با شکل‌های با سقف برای محدود کردن اندازه‌ی باز شده. یک .tar.zst که با tar --zstd ساخته شده همین‌طور خوانده می‌شود. برای یک پرونده‌ی تنها فشرده سازی پرونده زستد و کدگشایی پرونده زستد هست.

خواندن بایگانی 7z

بایگانی‌های 7z خوانده می‌شوند و با داده‌ی ذخیره‌شده (بی‌فشرده‌سازی) ساخته هم می‌شوند. فهرست هفت زد و فهرست هفت زد با وضعیت مدخل‌ها را فهرست می‌کنند، استخراج با نام از هفت زد یکی را باز می‌کند و استخراج همه از هفت زد همه‌چیز را زیر یک پوشه می‌نویسد. روش‌های LZMA، LZMA2، PPMd، BZip2، Deflate و Deflate64 شناخته می‌شوند، همراه BCJ2، فیلترهای شاخه (x86، ARM، ARM64، RISC-V، PowerPC، SPARC، IA-64)، جابجایی بایت و دلتا پیش از آن‌ها، بلوک‌های یکپارچه، پرونده‌ها و پوشه‌های تهی، داده‌ی رمزگذاری‌شده و سرآیندهای رمزگذاری‌شده (AES-256). سرآیند امضا، سرآیند، هر بلوک یکپارچه و هر پرونده با CRC-32 سنجیده می‌شوند. آیتم‌های ضد، که در بایگانی به‌روزرسانی یعنی «این نام را پاک کن»، کنار می‌مانند.

archive-guide-sevenzip.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی مسیر پرونده
واردسازی سیستم عامل

پایا PACKED := """
377abcaf271c0004285eeffde1000000000000002200000000000000b6539000e0009a00455d00271bca866798db2a9932
ecb108f48e70217d76d380887c03113d3cbf05381d9da1ba6b83a1a220c4656aeac3932a993abd9ea11cf8b4a761ae3af5
25cd41b942bff3ee0000000000813307ae0fd29aba3d40c090d2ff7d694d8f17af096379cb439267a35290e659701f3be3
6ecf209c510fa5d7b46a9c1bc2ee771f3e97490b78775d756e5d08a454586e1ec479608d69d1666dfa5b88efa423415340
9765eb30ad5f38ecae89e94cbd79558938ae1d384c90fe7db292aab05a6ec1eb816b7fbbeaf3ea941a1f4ff09d06216330
82fa2e2e1849c8fb9600000017064d0109809400070b01000123030101055d001000000c80ce0a01885a3c9d0000
"""

تابع نیم_بایت(نویسه: صحیح): صحیح:
    اگر نویسه بزرگتربرابر 48 و نویسه کوچکتربرابر 57:
        برگشت نویسه - 48
    پایان
    اگر نویسه بزرگتربرابر 97 و نویسه کوچکتربرابر 102:
        برگشت نویسه - 87
    پایان
    برگشت -1
پایان

تابع از_شانزده(متن_نمونه: رشته): فشرده سازی.بافر بایت:
    ناپایا بافر_محلی := فشرده سازی.بافر بایت جدید()
    نشانگر_بایت := متن_نمونه برگردان طبیعی۸*
    ناپایا بالا := -1
    تکرار متن_نمونه.طول() در شمارنده:
        مقدار_محلی := نیم_بایت(نشانگر_بایت[شمارنده] برگردان صحیح)
        اگر مقدار_محلی کوچکتر 0:
            گذر
        پایان
        اگر بالا کوچکتر 0:
            بالا = مقدار_محلی
        وگرنه:
            فشرده سازی.افزودن بایت(بافر_محلی، بالا * 16 + مقدار_محلی)
            بالا = -1
        پایان
    پایان
    برگشت بافر_محلی
پایان

تابع ریشه:
    بسته_شده := از_شانزده(PACKED)
    سرچاپ "بایگانی 7z:"، بایگانی.هفت زد است(بسته_شده.داده، بسته_شده.طول)

    ناپایا وضعیت := 0
    ناپایا فهرست := بایگانی.فهرست هفت زد با وضعیت(بسته_شده.داده، بسته_شده.طول، وضعیت)
    سرچاپ "مدخل‌ها:"، فهرست.طول()، بایگانی.متن وضعیت هفت زد(وضعیت)
    تکرار فهرست.طول() در شمارنده:
        عنصر := فهرست.بگیر(شمارنده)
        ناپایا گونه := "پرونده"
        اگر عنصر.پوشه:
            گونه = "پوشه"
        پایان
        سرچاپ " "، عنصر.نام، گونه، عنصر.اندازه
    پایان
    بایگانی.آزادسازی فهرست(فهرست)

    ناپایا موفق := نادرست
    متغیر_readme := بایگانی.استخراج با نام از هفت زد(بسته_شده.داده، بسته_شده.طول، "readme.txt"، موفق)
    سرچاپ "readme.txt:"، موفق، متغیر_readme.طول، "بایت"
    سقف_دار := بایگانی.استخراج با نام از هفت زد با سقف(بسته_شده.داده، بسته_شده.طول، "readme.txt"، 50، موفق)
    سرچاپ "سقف ۵۰ بایت:"، موفق، سقف_دار.طول

    پوشه := مسیر پرونده.پیوند(سیستم عامل.پوشه موقت()، "salam_sevenzip_guide")
    سیستم عامل.حذف همه(پوشه)
    سرچاپ "استخراج شد:"، بایگانی.استخراج همه از هفت زد(بسته_شده.داده، بسته_شده.طول، پوشه)
    سرچاپ سیستم عامل.وجود دارد(مسیر پرونده.پیوند(پوشه، "src/main.salam"))، سیستم عامل.وجود دارد(مسیر پرونده.پیوند(پوشه، "empty.log"))
    سیستم عامل.حذف همه(پوشه)

    ناپایا آسیب‌دیده := فشرده سازی.کپی بافر(بسته_شده)
    فشرده سازی.تنظیم بایت(آسیب‌دیده، آسیب‌دیده.طول - 3، فشرده سازی.دریافت بایت(آسیب‌دیده، آسیب‌دیده.طول - 3) ^ 1)
    خراب := بایگانی.استخراج هفت زد(آسیب‌دیده.داده، آسیب‌دیده.طول، "readme.txt"، 0، وضعیت)
    سرچاپ "خراب:"، بایگانی.متن وضعیت هفت زد(وضعیت)، خراب.طول
پایان
خروجیبایگانی 7z: true مدخل‌ها: 4 ok src پوشه 0 empty.log پرونده 0 readme.txt پرونده 120 src/main.salam پرونده 35 readme.txt: true 120 بایت سقف ۵۰ بایت: false 0 استخراج شد: true true true خراب: checksum mismatch 0

بلوک یکپارچه یک جریان فشرده با چند پرونده است، پس خواندن یک پرونده از آن کل بلوک را باز می‌کند؛ برای گرفتن پرونده‌های زیاد از یک بایگانی استخراج همه از هفت زد را بزنید که هر بلوک را یک بار باز می‌کند. هر فراخوانی به‌جای حدس زدن یک وضعیت SEVENZIP_... برمی‌گرداند: گذرواژه‌ی اشتباه SEVENZIP_BAD_PASSWORD، نبودن گذرواژه SEVENZIP_ENCRYPTED و پرونده‌ی خراب SEVENZIP_BAD_CRC یا SEVENZIP_CORRUPT است. بایگانی رمزگذاری‌شده را با بازکردن هفت زد و گذرواژه‌اش باز کنید، سپس مدخل‌های هفت زد، خواندن از هفت زد و خواندن همه از هفت زد را بزنید:

شناختن قالب از بایت‌های نخست

نام پرونده می‌تواند دروغ بگوید، بایت‌ها نه. هر قالب با امضای ثابتی شروع می‌شود، پس برنامه‌ای که پرونده‌ی بارگذاری‌شده می‌پذیرد باید پیش از انتخاب خواننده به بایت‌ها نگاه کند:

قالبامضابررسی
زیپ50 4b 03 04 (PK) در ابتدامقایسه‌ی چهار بایت نخست
جی‌زیپ1f 8b در ابتدامقایسه‌ی دو بایت نخست
xzfd 37 7a 58 5a 00 در ابتدامقایسه‌ی شش بایت نخست
آر ای آرRar! در ابتداآر ای آر است
7z37 7a bc af 27 1c در ابتدا (در بایگانی خودگشا دیرتر می‌آید)هفت زد است
تارustar در بایت ۲۵۷مقایسه‌ی پنج بایت از جایگاه ۲۵۷
archive-guide-detect.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع قالب بایگانی(ب: فشرده سازی.بافر بایت): رشته:
    اگر ب.طول >= ۴ و فشرده سازی.دریافت بایت(ب، ۰) == ۸۰ و فشرده سازی.دریافت بایت(ب، ۱) == ۷۵ و فشرده سازی.دریافت بایت(ب، ۲) == ۳ و فشرده سازی.دریافت بایت(ب، ۳) == ۴:
        برگشت "zip"
    پایان
    اگر ب.طول >= ۲ و فشرده سازی.دریافت بایت(ب، ۰) == ۳۱ و فشرده سازی.دریافت بایت(ب، ۱) == ۱۳۹:
        برگشت "gzip"
    پایان
    اگر بایگانی.آر ای آر است(ب.داده، ب.طول):
        برگشت "rar"
    پایان
    اگر ب.طول >= ۲۶۲ و فشرده سازی.دریافت بایت(ب، ۲۵۷) == ۱۱۷ و فشرده سازی.دریافت بایت(ب، ۲۵۸) == ۱۱۵ و فشرده سازی.دریافت بایت(ب، ۲۵۹) == ۱۱۶ و فشرده سازی.دریافت بایت(ب، ۲۶۰) == ۹۷ و فشرده سازی.دریافت بایت(ب، ۲۶۱) == ۱۱۴:
        برگشت "tar"
    پایان
    برگشت "ناشناخته"
پایان

تابع شمار ورودی‌ها(ب: فشرده سازی.بافر بایت): صحیح:
    گ := قالب بایگانی(ب)
    اگر گ == "zip": برگشت بایگانی.فهرست زیپ(ب.داده، ب.طول).طول() پایان
    اگر گ == "tar": برگشت بایگانی.فهرست تار(ب.داده، ب.طول).طول() پایان
    اگر گ == "rar": برگشت بایگانی.فهرست آر ای آر(ب.داده، ب.طول).طول() پایان
    اگر گ == "gzip":
        ناپایا خوب := نادرست
        درون := فشرده سازی.کدگشایی جی زیپ بافر(ب، خوب)
        اگر خوب: برگشت شمار ورودی‌ها(درون) پایان
    پایان
    برگشت ۰
پایان

تابع ریشه:
    یادداشت := فشرده سازی.بافر از رشته("یک یادداشت کوتاه\n")
    ناپایا زیپی := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    زیپی.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("note.txt"، یادداشت.داده، یادداشت.طول، ۸))
    ناپایا تاری := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    تاری.بیفزا(بایگانی.ساخت ورودی پرونده تار("note.txt"، یادداشت.داده، یادداشت.طول، نادرست))
    تار := بایگانی.ساخت تار(تاری)
    نمونه‌ها := [بایگانی.ساخت زیپ(زیپی)، تار، فشرده سازی.فشرده سازی جی زیپ بافر(تار)، یادداشت]
    هر ن در نمونه‌ها:
        سرچاپ قالب بایگانی(ن)، ن.طول، "بایت،"، شمار ورودی‌ها(ن)، "ورودی"
    پایان
پایان
خروجیzip 148 بایت، 1 ورودی tar 2048 بایت، 1 ورودی gzip 120 بایت، 1 ورودی ناشناخته 31 بایت، 0 ورودی

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

استخراج امن

استخراج همه از زیپ و استخراج همه از تار پوشه‌های لازم را زیر پوشه‌ی مقصد می‌سازند. بایگانی‌ای که از دیگران می‌رسد می‌تواند نام‌هایی مثل ../escape.txt یا /etc/passwd داشته باشد که بیرون از آن پوشه می‌نشینند؛ هر دو تابع چنین ورودی‌هایی را رد می‌کنند، بقیه را می‌نویسند و نادرست برمی‌گردانند تا بدانید چیزی جا مانده است. استخراج با نام از زیپ و استخراج با نام از تار وقتی نام در بایگانی نباشد خوب را نادرست می‌کنند.

archive-guide-extract.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    الف := فشرده سازی.بافر از رشته("پرونده‌ی نخست\n")
    ب := فشرده سازی.بافر از رشته("پرونده‌ی دوم\n")
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("docs/a.txt"، الف.داده، الف.طول، ۸))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("docs/deep/b.txt"، ب.داده، ب.طول، ۸))
    ز := بایگانی.ساخت زیپ(پرونده‌ها)
    سرچاپ "همه استخراج شد:"، بایگانی.استخراج همه از زیپ(ز.داده، ز.طول، "out")
    ناپایا خوب := نادرست
    خوانده := بایگانی.خواندن پرونده دودویی("out/docs/deep/b.txt"، خوب)
    چاپ "out/docs/deep/b.txt:"، فشرده سازی.بافر به رشته(خوانده)

    _ := بایگانی.استخراج با نام از زیپ(ز.داده، ز.طول، "docs/c.txt"، خوب)
    سرچاپ "docs/c.txt پیدا شد:"، خوب

    ناپایا بدخواه := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    بدخواه.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("../escape.txt"، الف.داده، الف.طول، ۰))
    بدخواه.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("safe.txt"، الف.داده، الف.طول، ۰))
    زب := بایگانی.ساخت زیپ(بدخواه)
    سرچاپ "همه استخراج شد:"، بایگانی.استخراج همه از زیپ(زب.داده، زب.طول، "out2")
    _ := بایگانی.خواندن پرونده دودویی("escape.txt"، خوب)
    سرچاپ "escape.txt نوشته شد:"، خوب
    _ := بایگانی.خواندن پرونده دودویی("out2/safe.txt"، خوب)
    سرچاپ "out2/safe.txt نوشته شد:"، خوب
پایان
خروجیهمه استخراج شد: true out/docs/deep/b.txt: پرونده‌ی دوم docs/c.txt پیدا شد: false همه استخراج شد: false escape.txt نوشته شد: false out2/safe.txt نوشته شد: true

پس نتیجه‌ی نادرست از تابع استخراج همیشه خطای دیسک نیست: اگر باید این دو را از هم جدا کنید، نام ورودی‌ها را با فهرست زیپ یا فهرست تار بررسی کنید.

جی‌زیپ کردن یک پرونده (.gz)

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

archive-guide-gzip.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    یادداشت := فشرده سازی.بافر از رشته("a log line that repeats, a log line that repeats, a log line that repeats\n")
    بایگانی.نوشتن پرونده دودویی از بافر("note.txt"، یادداشت)

    سرچاپ "gzip a file:"، بایگانی.فشرده سازی پرونده جی زیپ("note.txt"، "note.txt.gz")
    سرچاپ "gunzip it:"، بایگانی.کدگشایی پرونده جی زیپ("note.txt.gz"، "note-copy.txt")
    ناپایا خوب := نادرست
    رونوشت := بایگانی.خواندن پرونده دودویی("note-copy.txt"، خوب)
    سرچاپ "same bytes:"، فشرده سازی.برابری بافر(رونوشت، یادداشت)

    بسته‌شده := فشرده سازی.فشرده سازی جی زیپ بافر(یادداشت)
    سرچاپ "in memory:"، یادداشت.طول، "bytes become"، بسته‌شده.طول
    برگشتی := فشرده سازی.کدگشایی جی زیپ بافر(بسته‌شده، خوب)
    سرچاپ "round trip:"، خوب، فشرده سازی.برابری بافر(برگشتی، یادداشت)

    پ := بسته‌شده.داده برگردان طبیعی۸*
    پ[بسته‌شده.طول / ۲] = ((پ[بسته‌شده.طول / ۲] برگردان صحیح) ^ ۱) برگردان طبیعی۸
    _ := فشرده سازی.کدگشایی جی زیپ بافر(بسته‌شده، خوب)
    سرچاپ "damaged copy accepted:"، خوب

    سقف := فشرده سازی.فشرده سازی جی زیپ بافر(یادداشت)
    _ := فشرده سازی.کدگشایی جی زیپ با سقف(سقف.داده، سقف.طول، ۱۰، خوب)
    سرچاپ "over a 10 byte limit accepted:"، خوب
پایان
خروجیgzip a file: true gunzip it: true same bytes: true in memory: 74 bytes become 48 round trip: true true damaged copy accepted: false over a 10 byte limit accepted: false

برای فشرده کردن چند پرونده نخست آن‌ها را در یک تار بگذارید (بخش .tar.gz بالاتر). برای باز کردن .tar.gz همین دو گام را برعکس انجام می‌دهید.

بررسی یک بایگانی

«بررسی» دو معنا دارد. برای دیدن آنچه درون بایگانی هست بی‌آنکه باز شود، فهرستش کنید: فهرست زیپ، فهرست تار و فهرست آر ای آر (یا مدخل‌های آر ای آر) نام، اندازه، نشان پوشه و برای زیپ و RAR چک‌جمع CRC-32 ذخیره‌شده را می‌دهند؛ فهرست را با آزادسازی فهرست آزاد کنید. برای دانستن اینکه داده سالم است چک‌جمع لازم است و قالب‌ها فرق می‌کنند:

  • جی‌زیپ و RAR خودشان می‌سنجند. فراخوانی جی‌زیپ ok = false برمی‌گرداند؛ فراخوانی RAR وضعیت را RAR_BAD_CRC می‌کند، یا اگر گذرواژه اشتباه بود RAR_BAD_PASSWORD.
  • زیپ برای هر مدخل یک CRC-32 نگه می‌دارد. استخراج تایید شده از زیپ آن را با داده مقایسه می‌کند و status را روی ZIP_OK، ZIP_BAD_CRC و مانند آن می‌گذارد؛ بررسی زیپ همه‌ی مدخل‌ها را می‌سنجد و تعداد خراب‌ها را برمی‌گرداند؛ مدخل های خراب زیپ فهرستشان می‌کند. استخراج با نام از زیپ برای سرعت و کدهای قدیمی بی‌بررسی می‌ماند: فشرده سازی.چک جمع سی آر سی بافر(داده) را خودتان با Entry.crc32 مقایسه کنید، همان‌طور که نمونه‌ی زیر می‌کند.
  • تار برای محتوا چک‌جمع ندارد. فقط می‌توانید معقول بودن فهرست را ببینید (نام‌ها و اندازه‌ها)؛ برای سالم بودن، تار را جی‌زیپ کنید و به انتهای جی‌زیپ تکیه کنید، یا یک هش کنار پرونده نگه دارید.
archive-guide-check.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    الف := فشرده سازی.بافر از رشته("first file, stored as it is\n")
    ب := فشرده سازی.بافر از رشته("second file, a little longer than the first one\n")
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("a.txt"، الف.داده، الف.طول، ۰))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("b.txt"، ب.داده، ب.طول، ۰))
    ز := بایگانی.ساخت زیپ(پرونده‌ها)

    پ := ز.داده برگردان طبیعی۸*
    پ[۴۰] = ((پ[۴۰] برگردان صحیح) ^ ۱) برگردان طبیعی۸

    ناپایا فهرست := بایگانی.فهرست زیپ(ز.داده، ز.طول)
    ناپایا خوب := نادرست
    هر م در فهرست:
        داده := بایگانی.استخراج با نام از زیپ(ز.داده، ز.طول، م.نام، خوب)
        درست‌است := فشرده سازی.چک جمع سی آر سی بافر(داده) == م.چک‌جمع
        سرچاپ م.نام، "extracted:"، خوب، "checksum matches:"، درست‌است
    پایان
    بایگانی.آزادسازی فهرست(فهرست)

    ناپایا آر‌پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده آر ای آر>
    آر‌پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده آر ای آر("a.txt"، الف.داده، الف.طول، نادرست))
    ر := بایگانی.ساخت آر ای آر(آر‌پرونده‌ها)
    ک := ر.داده برگردان طبیعی۸*
    ک[ر.طول - ۱۲] = ((ک[ر.طول - ۱۲] برگردان صحیح) ^ ۱) برگردان طبیعی۸
    ناپایا وضعیت := ۰
    _ := بایگانی.استخراج آر ای آر(ر.داده، ر.طول، "a.txt"، ۰، وضعیت)
    سرچاپ "rar:"، بایگانی.متن وضعیت آر ای آر(وضعیت)
پایان
خروجیa.txt extracted: true checksum matches: false b.txt extracted: true checksum matches: true rar: checksum mismatch

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

فراخوان‌های تاییدشده این مقایسه را برایتان انجام می‌دهند. بررسی زیپ در checked تعداد پرونده‌هایی را که باز کرده می‌گذارد و تعداد خراب‌ها را برمی‌گرداند، یا ۱- اگر داده زیپ نباشد؛ متن وضعیت زیپ یک وضعیت را به جمله تبدیل می‌کند.

archive-guide-zipverify.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    متن := "سلام بایگانی، سلام بایگانی، سلام بایگانی"
    ب := فشرده سازی.بافر از رشته(متن)
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("a.txt"، ب.داده، ب.طول، 0))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("b.txt"، ب.داده، 5، 8))
    ز := بایگانی.ساخت زیپ(پرونده‌ها)
    ناپایا وضعیت := 0
    ناپایا بررسی‌شده := 0
    سالم := بایگانی.استخراج تایید شده از زیپ(ز.داده، ز.طول، "a.txt"، 0، وضعیت)
    سرچاپ وضعیت برابر بایگانی.زیپ موفق، سالم.طول، بایگانی.بررسی زیپ(ز.داده، ز.طول، بررسی‌شده)، بررسی‌شده

    نشانگر := ز.داده برگردان طبیعی۸*
    نشانگر[35] = 0x58 برگردان طبیعی۸
    خراب := بایگانی.استخراج تایید شده از زیپ(ز.داده، ز.طول، "a.txt"، 0، وضعیت)
    سرچاپ وضعیت برابر بایگانی.زیپ چک جمع ناهمخوان، خراب.طول، بایگانی.متن وضعیت زیپ(وضعیت)
    ناپایا خوب := نادرست
    ساده := بایگانی.استخراج با نام از زیپ(ز.داده، ز.طول، "a.txt"، خوب)
    سرچاپ خوب، ساده.طول
    سرچاپ بایگانی.بررسی زیپ(ز.داده، ز.طول، بررسی‌شده)، بررسی‌شده
    ناپایا شکسته := بایگانی.مدخل های خراب زیپ(ز.داده، ز.طول)
    هر م در شکسته:
        سرچاپ "خراب:"، م.نام
    پایان
    بایگانی.آزادسازی فهرست(شکسته)
    _ := بایگانی.استخراج تایید شده از زیپ(ز.داده، ز.طول، "missing.txt"، 0، وضعیت)
    سرچاپ وضعیت برابر بایگانی.زیپ یافت نشد، بایگانی.متن وضعیت زیپ(وضعیت)
پایان
خروجیtrue 75 0 2 true 0 checksum mismatch true 75 1 2 خراب: a.txt true entry not found

نمونه‌ی بعدی تاریخ و zip64 را نشان می‌دهد: ZipFileInput.mtime تاریخ مدخل را می‌گذارد، Entry.mtime آن را برمی‌خواند و ساخت زیپ بزرگ شکل zip64 را می‌نویسد.

archive-guide-ziptime.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    متن := "سلام، سلام، سلام"
    ب := فشرده سازی.بافر از رشته(متن)
    ناپایا نام‌دار := بایگانی.ساخت ورودی پرونده زیپ("سلام.txt"، ب.داده، ب.طول، 8)
    نام‌دار.زمان تغییر = 1700000000 برگردان صحیح۶۴
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(نام‌دار)
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("plain.txt"، ب.داده، ب.طول، 8))
    ز := بایگانی.ساخت زیپ(پرونده‌ها)
    ناپایا فهرست := بایگانی.فهرست زیپ(ز.داده، ز.طول)
    هر م در فهرست:
        سرچاپ م.نام، م.زمان تغییر
    پایان
    بایگانی.آزادسازی فهرست(فهرست)
    سرچاپ "پرچم UTF-8:"، (بایگانی.خواندن شانزده بیتی کم ارزش‌اول(ز.داده، 6) & 0x800) نابرابر 0

    بزرگ := بایگانی.ساخت زیپ بزرگ(پرونده‌ها)
    ناپایا دوباره := بایگانی.فهرست زیپ(بزرگ.داده، بزرگ.طول)
    سرچاپ دوباره.طول()، بزرگ.طول بزرگتر ز.طول، دوباره.بگیر(0).اندازه
    بایگانی.آزادسازی فهرست(دوباره)
    ناپایا بررسی‌شده := 0
    سرچاپ بایگانی.بررسی زیپ(بزرگ.داده، بزرگ.طول، بررسی‌شده)، بررسی‌شده
پایان
خروجیسلام.txt 1700000000 plain.txt 315532800 پرچم UTF-8: true 2 true 30 0 2

خواندن و ساختن RAR

خواندن با فهرست آر ای آر و استخراج آر ای آر انجام می‌شود، مثل زیپ. نمونه‌ی زیر یک RAR 5 فشرده‌ی کوچک است که WinRAR ساخته: پرونده‌ی دوم نسبت به نخست بسته‌بندی شده، پس استخراج آر ای آر برای رسیدن به آن هر دو را باز می‌کند. هر مدخل با CRC-32 خودش سنجیده می‌شود و status می‌گوید چه شد، به جای اینکه داده‌ی خراب بی‌صدا برگردد.

archive-guide-rar.salam
واردسازی بایگانی
واردسازی فشرده سازی

پایا نمونه := """
526172211a07010009efc86f0b0105070406010180808000f59006092302030bc300049c04a48302dcdfaa7280050105
612e7478740a031341fff06a00f2f92ec4de405543522f75043ded152822995a044050507ca7cbf17ff3c348ad0d2727
655f99a332a4c1ac1c51cad46312e761917434a437902ab22276d9e9f3b0b2cd03eb58c5ad77d22302030b9c0004b104
a4830220abc84ec0050105622e7478740a031341fff06ae4e7fa2e440719f5c9e63f0caebd274804c54d756dc27b960e
6971f66c94d170988ae3092702030b8000048000a4830200000000c0050109656d7074792e7478740a031341fff06ae4
e7fa2e1d77565103050400
"""

تابع رقم(ک: صحیح): صحیح:
    اگر ک >= ۴۸ و ک <= ۵۷:
        برگشت ک - ۴۸
    پایان
    اگر ک >= ۹۷ و ک <= ۱۰۲:
        برگشت ک - ۸۷
    پایان
    برگشت -۱
پایان

تابع از هگز(متن: رشته): فشرده سازی.بافر بایت:
    ناپایا خروجی := فشرده سازی.بافر بایت جدید()
    بایت‌ها := متن برگردان طبیعی۸*
    ناپایا بالا := -۱
    تکرار متن.طول() در ای:
        م := رقم(بایت‌ها[ای] برگردان صحیح)
        اگر م < ۰:
            گذر
        پایان
        اگر بالا < ۰:
            بالا = م
        وگرنه:
            فشرده سازی.افزودن بایت(خروجی، بالا * ۱۶ + م)
            بالا = -۱
        پایان
    پایان
    برگشت خروجی
پایان

تابع ریشه:
    ر := از هگز(نمونه)
    سرچاپ بایگانی.آر ای آر است(ر.داده، ر.طول)
    ناپایا فهرست := بایگانی.فهرست آر ای آر(ر.داده، ر.طول)
    هر م در فهرست:
        سرچاپ م.نام، م.اندازه، م.اندازه فشرده
    پایان
    بایگانی.آزادسازی فهرست(فهرست)

    ناپایا وضعیت := ۰
    ب := بایگانی.استخراج آر ای آر(ر.داده، ر.طول، "b.txt"، ۰، وضعیت)
    سرچاپ بایگانی.متن وضعیت آر ای آر(وضعیت)، ب.طول
پایان
خروجیtrue a.txt 540 67 b.txt 561 28 empty.txt 0 0 ok 561

ساختن RAR ساده‌تر است: چند ورودی پرونده آر ای آر بسازید و ساخت آر ای آر یا ساخت پرونده آر ای آر را صدا بزنید. نتیجه یک بایگانی RAR 5 درست است که پرونده‌ها در آن بی‌فشرده‌سازی ذخیره شده‌اند. اگر فشرده‌سازی واقعی می‌خواهید زیپ یا .tar.gz را به کار ببرید.

باز کردن RAR گذرواژه‌دار

یک بایگانی آر ای آر داده و گذرواژه را نگه می‌دارد، پس فهرست، یک خواندن تکی و استخراج کامل همه از آن‌ها استفاده می‌کنند. با گذرواژه‌ی اشتباه بایگانی باز نمی‌شود (اگر نام‌ها رمزگذاری شده باشند) یا هر خواندن با RAR_BAD_PASSWORD شکست می‌خورد؛ بدون گذرواژه RAR_ENCRYPTED می‌گیرید. RAR 5 گذرواژه را از پیش می‌سنجد. RAR 3 و 4 مقدار سنجشی ندارند، پس گذرواژه‌ی اشتباه در آن‌ها به شکل چک‌جمع ناهمخوان پیدا می‌شود و به همان شکل گزارش می‌شود.

archive-guide-rar-password.salam
واردسازی بایگانی
واردسازی فشرده سازی

پایا نمونه := """
526172211a07010038d1db9021040000010fe945634161dc2d7b3e8b87f362874d32048313f00358e483efb2886b026e
590dc3a9e23be3b7cfa25ea1dd6a6c4c4af8702cb2d51eb2f7798221661b321c792f762b84ffbf221b7100d324e8f848
ca96b61074ef27c65ba5a760024e3e27ccd59be9d8047bce7da160956a1dd1ca59d5970613a92c4582b076eb3398a1b7
8ef8151f33cf3665dea91210eaede8f1c08f503c488358eb375bf44e0a7a90b81067d6a6637ae589c00f19b387d3d769
f8cfa327f9b218211f11fe63a7a1783e45656fcc9573869eaf359485c0e2d4d5066ddc9981c7b13390c6d78d0ea24a04
386db10eb6d52567002ad55ebee7f1a172080c6a7bd1c72ac29e74d0480d38934012ee49a5fcd5111ad5899223384b67
b8491eed31431d7295083a332114430d96e4004c3426c450dbd1985644df90632ebb89c94cb9f9000fe8b54e0335aa44
fe401e45aad3727aee1392db44b09094b58754bc5ae4fd2186aeb6790bbf2dc3a4225dd37203f3eeecf02fcfb2f150a1
4293fbab1e38425c7bdd1909e3b24e6882fb38344a28184e8d993d93616aeb3eb57e60b5681280a7d138329a4cda
"""

تابع رقم(ک: صحیح): صحیح:
    اگر ک >= ۴۸ و ک <= ۵۷:
        برگشت ک - ۴۸
    پایان
    اگر ک >= ۹۷ و ک <= ۱۰۲:
        برگشت ک - ۸۷
    پایان
    برگشت -۱
پایان

تابع از هگز(متن: رشته): فشرده سازی.بافر بایت:
    ناپایا خروجی := فشرده سازی.بافر بایت جدید()
    بایت‌ها := متن برگردان طبیعی۸*
    ناپایا بالا := -۱
    تکرار متن.طول() در ای:
        م := رقم(بایت‌ها[ای] برگردان صحیح)
        اگر م < ۰:
            گذر
        پایان
        اگر بالا < ۰:
            بالا = م
        وگرنه:
            فشرده سازی.افزودن بایت(خروجی، بالا * ۱۶ + م)
            بالا = -۱
        پایان
    پایان
    برگشت خروجی
پایان

تابع ریشه:
    ر := از هگز(نمونه)
    ناپایا قفل‌شده := بایگانی.بازکردن آر ای آر(ر.داده، ر.طول، "")
    ناپایا نام‌ها := بایگانی.مدخل‌های آر ای آر(قفل‌شده)
    سرچاپ نام‌ها.طول()، بایگانی.متن وضعیت آر ای آر(قفل‌شده.وضعیت)
    بایگانی.آزادسازی فهرست(نام‌ها)

    ناپایا اشتباه := بایگانی.بازکردن آر ای آر(ر.داده، ر.طول، "guess")
    نام‌ها = بایگانی.مدخل‌های آر ای آر(اشتباه)
    سرچاپ نام‌ها.طول()، اشتباه.وضعیت == بایگانی.آر ای آر گذرواژه اشتباه
    بایگانی.آزادسازی فهرست(نام‌ها)

    ناپایا باز := بایگانی.بازکردن آر ای آر(ر.داده، ر.طول، "secret")
    نام‌ها = بایگانی.مدخل‌های آر ای آر(باز)
    هر م در نام‌ها:
        داده := بایگانی.خواندن از آر ای آر(باز، م.نام، ۰)
        سرچاپ م.نام، م.اندازه، داده.طول، بایگانی.متن وضعیت آر ای آر(باز.وضعیت)
    پایان
    بایگانی.آزادسازی فهرست(نام‌ها)
    سرچاپ بایگانی.خواندن همه از آر ای آر(باز، "unlocked")، بایگانی.متن وضعیت آر ای آر(باز.وضعیت)
پایان
خروجی0 encrypted data and no password 0 true n1.txt 352 352 ok n2.txt 348 348 ok 2 ok

خواندن RAR چندبخشی

بایگانی بزرگ را اغلب به بخش‌ها می‌برند: name.part01.rar، name.part02.rar و همین‌طور ادامه، یا شیوه‌ی قدیمی‌تر name.rar، name.r00، name.r01. RarReadVolumes نام پرونده‌ی نخست را می‌گیرد، بقیه را با همین نام‌گذاری پیدا می‌کند و می‌خواند؛ RarOpenVolumes فهرست را به یک RarArchive تبدیل می‌کند و RarEntries و RarRead همیشگی از میان برش‌ها کار می‌کنند. بایگانی را با RarClose ببندید و بخش‌ها را با RarFreeVolumes آزاد کنید.

archive-guide-rar-volumes.salam
واردسازی بایگانی
واردسازی فشرده سازی

پایا بخش۱ := """
526172211a0701006de128270b01050701060101808080002c64b9412502130be78600048df500a48302c8ac493d8005
0105762e7478740a0313c60bf16a7ed75827cc5dc30845643444334f3565365536a7751848c413a8c1d5a93ff0a349ca
1575f48991859458af2f2ba874489a028b323f09e3cf1e32ffefaf9f97e7e9e9e3edf6f1fa579a7a7d7c3dbdfcbebe3e
7f9f0fa7dbc3d3d3c16d1eff9ff7f7f2fd6ec95fb7f5e3f169de0de1e7efea4f755ebf7e5fe7d7f1fbe5efdec9ebf7f0
ac07f5f8f3ffbd1b1bddbb560ebd7589d7ab57eac6759257a2be6b5bff06db5907b7bfa37e2771d6115e7d65b5b1ead5
bc777f89dd96b66f649d2dbd8d5fb76ce932faf6d637ab6eb48ebc7784ebcd71b4dd9bcee1bd1377eeefbd11bfaa6188
98a280bb6b6d5a47dab204c174a6eafdbcad94b9666ab7f59414fe5a1970fab96f34eaf29a0edb711056b5ceb7494e85
b83775441bc51f56f4dc85bb03667c21d75603e2af914e76c0fb7fb5f428b8fa03bdef2854a35f5ad1273344a09bfacf
3d171047a766aa0d8c11896e85ced5a3fffcee5af7d608ba9d99ccb1aa2be1aa1342ae8b3ae9744562654f1606e38681
3201eddbf1afb701e2c1bbbff9efe02d2e17480a0962ab9b850cc218ea736bad10726ac6adab51e376d55ac13a036d61
8ec3818e63acd5ef5acb6746eae8ead37a7bb694b7a4c144844a6fa10afaf9603e08b482196964dcc8844ab4e013abdb
b4253899ef86069c3bb146ea4f805c057d5d03e101866c22c2413f3901cef35cb2faa62459ed943aafe3345d4aac4411
bb6c32bd58e376ad8393fda6c9ab56441546a250934dc2b662a55ca908f1fb6b12556784fd827901ad81c55caab012f8
0a35c584d114212450a1a8e1dc067711a39dda12659ce0d861a2ce3fafba224e2122c97cd0f5f92425ddfb9c36c9c953
6714555e7051d7dc252c7646f0df25808c58e78b266f0b92b8b917e2c910c0c3af16037381d7939fc090853cdd8df086
7370634378a2c228d4a8c0273788104daf093c9e6dccb0410dceb0215c0610eebaf222187780368a3dd2303226e99cf9
803e25ff56547e270704384ae9021fbc501683ba7cb179dcc0ae76d5600476f4c2ac82942f313d6213c24edbc0445454
d01f0c5e11d1f2ab6437eeafd08d1a3e40e3b6028205a2d7c3383a23c3fad885328bc65c5718d8d8630cfafc1b88c05c
bceb14fad1feaf94c163c9738d355824356adba1ca97a4a959832f630220a908b8b815c8b9acf685c0a255b735826132
911a80b69b45726abd4f52371614f9e267fe5840155b011bb28b47512603050401000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
00000000000000000000000000000000
"""

پایا بخش۲ := """
526172211a070100a9c2c4ca0c01050703010601018080800064563ccc25021b0be68600048df500a483020002230880
050105762e7478740a0313c60bf16a7ed75827046840f3834518cedc2f96f6bbb89190a3b6d9c514aacde7ee173d264c
b8f0692c7ca6b792780ee2bef245c9c3c949222294d2e016d242cd89838cbfa39edcb53775439267227627f0b5b02174
c9d22a0f2190336159b20695cd4c7113ce32dd1e2151829ab73dfea0950912309fda1d69b59f9b6e641be295e0f1f394
d8fd5c492fccc8a69b3426b4ab0d12b035942a0dfc9ca3a2401d11d385b8a8f007ead59f3e1694e6f315576c22200f28
4cd5c4a56653424b06d609611a293322bceeaf554095f3cca784064d2e5174624dd2a741e712bf8435f0a0c44458c205
f0a4b74671b82bb9635e6e10b24863da4475cc8f5a03b84b084d8bbf0834706da6cc792f4240b267a1fc20e04f3f4633
546acb84c2681dee1c00a436b6d9cccfdbffa1cad473bc7540b0002c96977021c9e8b443db4c80abd793bb7bd0d3305d
44416d504a0a9b699832d700ad111e6478d7e798ad90f492f8d248b49cd1380d23cfce8c4692ca5f5c3e8958a9b66477
c2a7d91522b7672ec51114c161dd650d948da76149d23cccc99308d707fc1db5100c4eba404d61309b83bb3c7503742b
a94a7440bae2115fd613fe21302d369c8b24bbe9c988d4eec33d9fbdc7c9038887de34419353b1bf82c0855b6c2277d6
8a8492d6e708fc7de0fa008c102633d12552fcaae7639fa3a0de6daf2336895df8a09169ed7e67ba0af51a4119c1daaa
71d7c254c05abbdab89669a40940e34742bf31a601545cdd2010c7e55016edb49cd2d7073b67d5f9ab38d9c418e76a44
f8394a65a783ab16db093629a33bd2ac91bdfb948263c08a0e4c9a4cae7af9eff46102d7bc913b5cb84a12b623a0a09f
ed11700ead0b984e3e78193ce0190ede74759a8ba34e3cee326dab0b3482d69a9af4f2e125c2d5c85cebccceb0e79c72
862a1f4252f2a18c33614af63cd523378109df9c8408d09c7e1dcc497bf400d082d87505f29af8f49a2034d6e575af9c
0e0ae77f857693f8e11cebcfb19f40a6fd1856362b74b7821b726242542b9c1c9c0add41783d931149e85a37418dba78
73ad990a9a4c7ac61b257db791159b11375886f2655cf56469191a5f853dba4f909dd88210d27dae6335450e4886e1a9
0976178ef226e03a38f420961ab7e866c8e252e62d8d1cd7eaaa2634d2747769c7a19d0e2d6c3c119034c1092a54ae36
4d4888b31633aa9473da001976173bcb5422b5d9d1922d044d8b47512603050401000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
00000000000000000000000000000000
"""

پایا بخش۳ := """
526172211a0701004ac54b440c0105070302060101808080004fb1c48c25020b0bfa8300048df500a4830287c98a0f80
050105762e7478740a0313c60bf16a7ed758276e9e2146d09044d59e5c974bc9e14a51910cdd41b71dcbf4f11fafd98d
16fb2d0683270a40c720ef76ab99b90b355e72e2acf71ea3c079e458b57797a810a9320e5b8f495efd066558b0974909
e6a8cff09481c66b5ee1259c3d36f48eeb7ec0f22fe946721c718c317a6058d161bf759e1c1e9a5b9427d538a4a3aade
0c326b40453c6b35b52d882e9413dbc82c5dc62160fc39a3b92dce54ac533a592fd09af8aba6fc2578f5cf12048671b2
740297a0d81a2d8f87113e877a3d3645e68034c922e7f1af8d0a794f3061e8696f2def1b8d951da84ce31a294f7c79a9
d784db31486ab60718767955e357868e61a57a866f4d072a16d82b283f8370e98ca225dd77dcf92004ea79317d93484a
62722811c2d2124f214fa55393d104c65b346abd4c63ecea91ca5bab74f0eb6af2378bc9734b8ad6ad79745d233884a7
6f99443c8e46eceeb4b9bc79895e4dedea7a4a4a2f1126126cadd27c20d3f24c0fbff173f03b3e4974014f428733869b
7f1b1916980a4335126a67984987f010b31fdcfd33edf46177414ac7a83f0909729736c70710e4bd7fb79cbf1924248d
8a2111eb874fa21f667084ea442d5950d187fd9eb2f066e09224441fbc9f32719e36176cab4d67b74200ba2c55397958
d35451df7777b403b0a724d22cb9a9a5ce7a7d72484b628b53c8b1cb893c158e558776fe1fc54ecdbc7cbe36e87c047d
942702030b8500048500a4830210c43fd080000109736d616c6c2e7478740a0313bd0bf16a5abb310b74696e790a1d77
565103050400
"""

تابع رقم(ک: صحیح): صحیح:
    اگر ک >= ۴۸ و ک <= ۵۷:
        برگشت ک - ۴۸
    پایان
    اگر ک >= ۹۷ و ک <= ۱۰۲:
        برگشت ک - ۸۷
    پایان
    برگشت -۱
پایان

تابع از هگز(متن: رشته): فشرده سازی.بافر بایت:
    ناپایا خروجی := فشرده سازی.بافر بایت جدید()
    بایت‌ها := متن برگردان طبیعی۸*
    ناپایا بالا := -۱
    تکرار متن.طول() در ای:
        م := رقم(بایت‌ها[ای] برگردان صحیح)
        اگر م < ۰:
            گذر
        پایان
        اگر بالا < ۰:
            بالا = م
        وگرنه:
            فشرده سازی.افزودن بایت(خروجی، بالا * ۱۶ + م)
            بالا = -۱
        پایان
    پایان
    برگشت خروجی
پایان

تابع ریشه:
    ناپایا بخش‌ها := وکتور {} برگردان وکتور<فشرده سازی.بافر بایت>
    بخش‌ها.بیفزا(از هگز(بخش۱))
    بخش‌ها.بیفزا(از هگز(بخش۲))
    بخش‌ها.بیفزا(از هگز(بخش۳))

    ناپایا باز := بایگانی.بازکردن بخش‌های آر ای آر(بخش‌ها، "")
    ناپایا نام‌ها := بایگانی.مدخل‌های آر ای آر(باز)
    هر م در نام‌ها:
        داده := بایگانی.خواندن از آر ای آر(باز، م.نام، ۰)
        سرچاپ م.نام، م.اندازه، داده.طول، بایگانی.متن وضعیت آر ای آر(باز.وضعیت)
    پایان
    بایگانی.آزادسازی فهرست(نام‌ها)
    بایگانی.بستن آر ای آر(باز)

    ناپایا ناقص := وکتور {} برگردان وکتور<فشرده سازی.بافر بایت>
    ناقص.بیفزا(بخش‌ها.بگیر(۰))
    ناقص.بیفزا(بخش‌ها.بگیر(۱))
    ناپایا خراب := بایگانی.بازکردن بخش‌های آر ای آر(ناقص، "")
    رفته := بایگانی.خواندن از آر ای آر(خراب، "v.txt"، ۰)
    سرچاپ رفته.طول، خراب.وضعیت == بایگانی.آر ای آر چند بخشی
    بایگانی.بستن آر ای آر(خراب)

    بایگانی.نوشتن پرونده دودویی از بافر("set.part01.rar"، بخش‌ها.بگیر(۰))
    بایگانی.نوشتن پرونده دودویی از بافر("set.part02.rar"، بخش‌ها.بگیر(۱))
    بایگانی.نوشتن پرونده دودویی از بافر("set.part03.rar"، بخش‌ها.بگیر(۲))
    ناپایا خوب := نادرست
    ناپایا یافته := بایگانی.خواندن بخش‌های آر ای آر("set.part01.rar"، خوب)
    سرچاپ خوب، یافته.طول()
    بایگانی.آزادسازی بخش‌های آر ای آر(یافته)
پایان
خروجیv.txt 14989 14989 ok small.txt 5 5 ok 0 true true 3

خواندن 7z تکه‌تکه

7z یک بایگانی بزرگ را به تکه‌های ساده‌ی name.7z.001، name.7z.002 و مانند آن می‌برد. SevenZipReadVolumes نام پرونده‌ی اول را می‌گیرد و بقیه را با بالا بردن عدد بار می‌کند؛ SevenZipOpenVolumes تکه‌ها را به هم می‌چسباند و مثل یک بایگانی باز می‌کند. یک 7z خودگشا (کد اجرایی با بایگانی چسبیده به انتها) را مستقیم با SevenZipOpen باز کنید: امضا در ۸ مگابایت اول جستجو می‌شود.

archive-guide-sevenzip-volumes.salam
// زبان: فارسی
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی

پایا PART1 := """
377abcaf271c000457983ded16000000000000004a00000000000000429e4011766f6c756d65206f6e650a766f6c756d6520
74776f0a0104060001091600070b
"""

پایا PART2 := """
01000101000c1600080a014e6ded24000005011113006e006f00740065002e0074007800740000001900140a0100d9199ec4
1c70dd01150601002080a4810000
"""

تابع نیم_بایت(نویسه: صحیح): صحیح:
    اگر نویسه بزرگتربرابر 48 و نویسه کوچکتربرابر 57:
        برگشت نویسه - 48
    پایان
    اگر نویسه بزرگتربرابر 97 و نویسه کوچکتربرابر 102:
        برگشت نویسه - 87
    پایان
    برگشت -1
پایان

تابع از_شانزده(متن_نمونه: رشته): فشرده سازی.بافر بایت:
    ناپایا بافر_محلی := فشرده سازی.بافر بایت جدید()
    نشانگر_بایت := متن_نمونه برگردان طبیعی۸*
    ناپایا بالا := -1
    تکرار متن_نمونه.طول() در شمارنده:
        مقدار_محلی := نیم_بایت(نشانگر_بایت[شمارنده] برگردان صحیح)
        اگر مقدار_محلی کوچکتر 0:
            گذر
        پایان
        اگر بالا کوچکتر 0:
            بالا = مقدار_محلی
        وگرنه:
            فشرده سازی.افزودن بایت(بافر_محلی، بالا * 16 + مقدار_محلی)
            بالا = -1
        پایان
    پایان
    برگشت بافر_محلی
پایان

تابع ریشه:
    ناپایا جلدها := وکتور {} برگردان وکتور<فشرده سازی.بافر بایت>
    جلدها.بیفزا(از_شانزده(PART1))
    جلدها.بیفزا(از_شانزده(PART2))
    ناپایا بایگانی_داده := بایگانی.بازکردن بخش‌های هفت زد(جلدها، "")
    نام‌ها := بایگانی.مدخل‌های هفت زد(بایگانی_داده)
    سرچاپ "مدخل‌ها:"، نام‌ها.طول()، بایگانی_داده.وضعیت
    داده := بایگانی.خواندن از هفت زد(بایگانی_داده، "note.txt"، 0)
    چاپ فشرده سازی.بافر به رشته(داده)
    بایگانی.بستن هفت زد(بایگانی_داده)
    بایگانی.آزادسازی بخش‌های هفت زد(جلدها)
پایان
خروجیمدخل‌ها: 1 0 volume one volume two

یک در برای همه‌ی قالب‌ها

Open بایت‌های نخست را می‌خواند، قالب را پیدا می‌کند و یک Archive برمی‌گرداند؛ List، Read، Extract و ExtractAll برای همه‌ی قالب‌ها یکسان کار می‌کنند و یک دسته کد ARCHIVE_ می‌دهند. OpenFile، ListFile و ExtractFile همین را از روی مسیر انجام می‌دهند. پرونده‌های gzip، bzip2 و xz هنگام باز شدن باز می‌شوند و تار درونشان شناخته می‌شود، پس .tar.gz، .tar.bz2 و .tar.xz مثل بقیه باز می‌شوند. توابع مخصوص هر قالب بدون تغییر کار می‌کنند.

قالبباز کردن، فهرست، خواندن، استخراجساختن
zipبلهCreate (.zip)
tar، tar.gz، tar.bz2، tar.zstبلهCreate (.tar، .tar.gz، .tgz، .tar.bz2، .tar.zst)
tar.xzبلهرمزگذار ندارد
gzip، bzip2، xz، zstd (یک پرونده)بله، به‌صورت بایگانی تک‌مدخلیCreate برای .gz، .bz2 و .zst با دقیقاً یک پرونده
RARبله، با گذرواژهCreate (.rar، ذخیره‌ای)
7zبله، با گذرواژهCreate (.7z، ذخیره‌ای)

ExtractAll راه امن باز کردن داده‌ی نامطمئن است. پیش از نوشتن هر چیز، همه‌ی مدخل‌ها را با Limits می‌سنجد (تعداد مدخل، اندازه‌ی یک مدخل، اندازه‌ی همه، و نسبت اندازه‌ی بازشده به اندازه‌ی بایگانی که بمب فشرده را می‌گیرد) و نام مطلق یا دارای ..، پیوند بیرون‌رونده، نوشتن از راه پیوند و مدخل دستگاه را رد می‌کند. اگر بررسی رد شود چیزی نوشته نمی‌شود و status دلیل را می‌گوید. سقف‌ها بر اساس اندازه‌های اعلام‌شده در بایگانی است؛ هر قالب هنگام باز کردن اندازه‌ی واقعی را هم می‌سنجد. RAR و 7z چندبخشی و خواندن پرونده‌های بسیار بزرگ با توابع مخصوص هر قالب می‌ماند.

همین فراخوانی‌ها از روی مسیر هم کار می‌کنند. ListFile و ExtractFile پرونده را باز می‌کنند، کار را انجام می‌دهند و می‌بندند؛ OpenFile یک Archive برای استفاده‌ی دوباره می‌دهد و SetLimits سقف‌های Limits یک بایگانی را سخت‌تر می‌کند. هر فراخوانی یک کد وضعیت می‌دهد و ArchiveStatusText آن را به متن تبدیل می‌کند. مثال یک .tar.gz می‌سازد، فهرست و استخراج می‌کند، عمداً به یک سقف و یک پرونده‌ی ناموجود برمی‌خورد و هر پانزده کد را چاپ می‌کند.

archive-guide-open.salam
واردسازی بایگانی
واردسازی مسیر پرونده
واردسازی سیستم عامل

تابع ریشه:
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده("notes/"، پوچ، 0، درست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده("notes/a.txt"، "alpha alpha alpha" برگردان تهی*، 17، نادرست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده("b.txt"، "bravo" برگردان تهی*، 5، نادرست))

    پوشه := مسیر پرونده.پیوند(سیستم عامل.پوشه موقت()، "salam-guide-open")
    سیستم عامل.حذف همه(پوشه)
    سیستم عامل.ساخت پوشه ها(پوشه)
    مسیر := مسیر پرونده.پیوند(پوشه، "demo.tar.gz")
    سرچاپ "ساخت:"، بایگانی.متن وضعیت بایگانی(بایگانی.ساخت بایگانی(مسیر، پرونده‌ها))
    پرونده‌ها.آزادکن()

    ناپایا وضعیت := 0
    ناپایا ورودی‌ها := بایگانی.فهرست پرونده بایگانی(مسیر، ""، وضعیت)
    سرچاپ "فهرست:"، بایگانی.متن وضعیت بایگانی(وضعیت)
    هر عنصر در ورودی‌ها:
        سرچاپ " "، عنصر.نام، عنصر.اندازه
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    خروجی_مقدار := مسیر پرونده.پیوند(پوشه، "out")
    شمار_بایت := بایگانی.استخراج پرونده بایگانی(مسیر، خروجی_مقدار، ""، وضعیت)
    سرچاپ "استخراج:"، شمار_بایت، بایگانی.متن وضعیت بایگانی(وضعیت)

    ناپایا بایگانی_داده := بایگانی.بازکردن پرونده بایگانی(مسیر، "")
    سرچاپ بایگانی.نام قالب(بایگانی_داده.قالب)، بایگانی_داده.وضعیت
    ناپایا محدودیت‌ها := بایگانی.سقف های پیش فرض()
    محدودیت‌ها.بیشینه مدخل = 2
    بایگانی.تنظیم سقف ها(بایگانی_داده، محدودیت‌ها)
    سرچاپ "محدود:"، بایگانی.استخراج همه از بایگانی(بایگانی_داده، مسیر پرونده.پیوند(پوشه، "tight"))، بایگانی.متن وضعیت بایگانی(بایگانی_داده.وضعیت)
    بایگانی.بستن بایگانی(بایگانی_داده)

    گمشده := بایگانی.استخراج پرونده بایگانی(مسیر پرونده.پیوند(پوشه، "none.zip")، خروجی_مقدار، ""، وضعیت)
    سرچاپ "ناموجود:"، گمشده، بایگانی.متن وضعیت بایگانی(وضعیت)

    ناپایا کد := 0
    تا کد کوچکتربرابر 14:
        سرچاپ کد، بایگانی.متن وضعیت بایگانی(کد)
        کد++
    پایان
    سیستم عامل.حذف همه(پوشه)
پایان
خروجیساخت: ok فهرست: ok notes/ 0 notes/a.txt 17 b.txt 5 استخراج: 2 ok tar.gz 0 محدود: 0 too many entries ناموجود: 0 file could not be read or written 0 ok 1 entry not found 2 unsupported format, method or feature 3 encrypted data and no password 4 corrupt data 5 checksum mismatch 6 entry too large 7 entry path or link leaves the target folder 8 wrong password 9 a volume of the multi-volume archive is missing 10 file could not be read or written 11 unknown archive format 12 too many entries 13 compression ratio too high 14 dictionary or window larger than the memory limit
کدثابتمعنا
0ARCHIVE_OKانجام شد.
1ARCHIVE_NOT_FOUNDمدخلی با این نام نیست.
2ARCHIVE_UNSUPPORTEDقالب، روش یا ویژگی‌ای که بسته نمی‌خواند.
3ARCHIVE_ENCRYPTEDرمزگذاری شده و رمزی داده نشده.
4ARCHIVE_CORRUPTساختار خراب یا ناقص است.
5ARCHIVE_BAD_CRCجمع کنترلی داده نمی‌خواند.
6ARCHIVE_TOO_BIGیک مدخل بیش از max_entry یا بیش از گنجایش حافظه است.
7ARCHIVE_UNSAFE_PATHیک نام یا پیوند از پوشه‌ی مقصد بیرون می‌رود.
8ARCHIVE_BAD_PASSWORDرمز نادرست است.
9ARCHIVE_MULTIVOLUMEیکی از بخش‌های مجموعه نیست.
10ARCHIVE_IO_ERRORپرونده‌ای خوانده یا نوشته نشد.
11ARCHIVE_UNKNOWN_FORMATبایت‌های نخست با هیچ قالبی نمی‌خواند.
12ARCHIVE_TOO_MANY_ENTRIESمدخل‌ها بیش از max_entries است.
13ARCHIVE_BOMBاندازه‌ی بازشده بیش از max_ratio برابر اندازه‌ی بایگانی است.
14ARCHIVE_WINDOW_TOO_BIGواژه‌نامه‌ی داده‌ی فشرده از سقف حافظه بیشتر است.

ساختن بایگانی 7z

مقدارهای SevenZipFileInput را بسازید و SevenZipCreate یا SevenZipCreateFile را صدا بزنید. پرونده، پوشه، پرونده‌ی تهی و پیوند نمادین (با link) نوشته می‌شوند، و اگر بدهید دسترسی و زمان هم. SevenZipCreate داده را ذخیره می‌کند؛ SevenZipCreateLevel و SevenZipCreateFileLevel هر پرونده را با LZMA در سطح ۱ تا ۹ فشرده می‌کنند. نتیجه در ۷-زیپ و در SevenZipExtractAll باز می‌شود.

archive-guide-sevenzip-create.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    الف := فشرده سازی.بافر از رشته("first file\n")
    بافر_محلی := فشرده سازی.بافر از رشته("second file, a little longer\n")
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده هفت زد>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده هفت زد("docs/"، پوچ، 0، درست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده هفت زد("docs/a.txt"، الف.داده، الف.طول، نادرست))
    ناپایا دومی := بایگانی.ساخت ورودی پرونده هفت زد("docs/b.txt"، بافر_محلی.داده، بافر_محلی.طول، نادرست)
    دومی.زمان تغییر = 1700000000 برگردان صحیح۶۴
    دومی.دسترسی = 420
    پرونده‌ها.بیفزا(دومی)
    ناپایا پیوند_محلی := بایگانی.ساخت ورودی پرونده هفت زد("docs/latest"، پوچ، 0، نادرست)
    پیوند_محلی.پیوند = "b.txt"
    پرونده‌ها.بیفزا(پیوند_محلی)
    بسته_شده := بایگانی.ساخت هفت زد(پرونده‌ها)
    سرچاپ بایگانی.هفت زد است(بسته_شده.داده، بسته_شده.طول)، بایگانی.ساخت پرونده هفت زد(پرونده‌ها، "made.7z")

    ناپایا ورودی‌ها := بایگانی.فهرست هفت زد(بسته_شده.داده، بسته_شده.طول)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه، عنصر.پوشه، عنصر.نوع، عنصر.زمان تغییر
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    ناپایا موفق := نادرست
    گرفته := بایگانی.استخراج با نام از هفت زد(بسته_شده.داده، بسته_شده.طول، "docs/b.txt"، موفق)
    سرچاپ موفق، فشرده سازی.بافر به رشته(گرفته) برابر "second file, a little longer\n"
پایان
خروجیtrue true docs 0 true 1 0 docs/a.txt 11 false 0 0 docs/b.txt 29 false 0 1700000000 docs/latest 5 false 2 0 true true

زیپ‌های بزرگ روی دیسک

تابع‌هایی که نشانی و طول می‌گیرند کل بایگانی را در حافظه نگه می‌دارند و به ۲ گیگابایت می‌رسند. برای زیپی با هر اندازه از ZipOpenFile استفاده کنید: فقط انتهای پرونده و فهرست مدخل‌ها را می‌خواند و ZipFileExtractTo و ZipFileExtractAll مستقیم روی دیسک و در تکه‌های ۶۴ کیلوبایتی باز می‌کنند و CRC-32 و اندازه را در همان حال بررسی می‌کنند. اندازه‌ها و جابه‌جایی‌ها ۶۴ بیتی‌اند و zip64 هم هست، پس مدخلی چند گیگابایتی هم کار می‌کند و مصرف حافظه کم می‌ماند. تنها محدودیت همان است که خودتان می‌دهید: cap شمار بایت‌هاست (۰ یعنی بدون سقف) و مدخلی بزرگ‌تر از آن پیش از نوشتن چیزی ZIP_TOO_BIG برمی‌گرداند.

archive-guide-zipfile.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی سیستم عامل

تابع ریشه:
    بدنه := "a large file would be unpacked straight to disk\n"
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("data/log.txt"، بدنه برگردان تهی*، بدنه.طول()، 8))
    ناپایا ساخته := بایگانی.ساخت زیپ(پرونده‌ها)
    پرونده‌ها.آزادکن()
    بایگانی.نوشتن پرونده دودویی از بافر("made.zip"، ساخته)
    فشرده سازی.آزادسازی بافر(ساخته)

    ناپایا پرونده_زیپ := بایگانی.بازکردن پرونده زیپ("made.zip")
    ناپایا ورودی‌ها := بایگانی.مدخل های پرونده زیپ(پرونده_زیپ)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    سرچاپ بایگانی.استخراج از پرونده زیپ به پرونده(پرونده_زیپ، "data/log.txt"، "log.out"، 0 برگردان صحیح۶۴) برابر بایگانی.زیپ موفق
    سرچاپ بایگانی.استخراج از پرونده زیپ به پرونده(پرونده_زیپ، "data/log.txt"، "log.out"، 10 برگردان صحیح۶۴) برابر بایگانی.زیپ بیش از حد بزرگ
    بایگانی.بستن پرونده زیپ(پرونده_زیپ)
    سیستم عامل.حذف("made.zip")
    سیستم عامل.حذف("log.out")
پایان
خروجیdata/log.txt 48 true true

پرونده‌های بزرگ 7z روی دیسک

SevenZipOpenFile یک 7z را روی دیسک باز می‌کند و فقط سرآیند آن را در حافظه نگه می‌دارد. SevenZipFileExtractTo و SevenZipFileExtractAll مستقیم روی دیسک باز می‌کنند: داده‌ی LZMA و LZMA2 از پنجره‌ای به اندازه‌ی واژه‌نامه می‌گذرد و در تکه‌های ۶۴ کیلوبایتی بیرون می‌آید، پس مدخلی چند گیگابایتی فقط چند مگابایت حافظه می‌خواهد. همه‌ی روش‌ها همین‌طور جریانی‌اند: PPMd فقط حافظه‌ی مدلی را می‌خواهد که ویژگی‌هایش می‌گویند، bzip2 یک بلوک نگه می‌دارد، فیلترهای شاخه (BCJ، ARM، ARM64، RISC-V و بقیه)، دلتا، جابه‌جایی بایت و BCJ2 مرحله‌هایی هستند که هر تکه را رد می‌کنند، و AES-256 تکه‌تکه و پیش از کدگذار بعدی رمزگشایی می‌کند، پس AES و بعد LZMA2 و بعد BCJ مستقیم از پرونده خوانده می‌شود بی پرونده‌ی موقت. سرآیندهای رمزگذاری‌شده از همین مسیر می‌گذرند. BCJ2 جریان کدگذار بازه‌ی خود را از پرونده می‌خواند؛ جریان‌های فراخوان و پرش اگر ذخیره‌شده باشند از پرونده و اگر فشرده باشند در بافرهای کوچک (حداکثر memcap) باز می‌شوند. بلوک فشرده‌ی یکپارچه برای همه‌ی پرونده‌هایش یک بار خوانده می‌شود. cap بایت‌های یک مدخل را و memcap حافظه‌ی کدگشا را محدود می‌کند؛ هر دو با ۰ بدون سقف‌اند.

archive-guide-sevenzipfile.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی سیستم عامل

تابع ریشه:
    بدنه := "a large file would be unpacked straight to disk\n"
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده هفت زد>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده هفت زد("data/log.txt"، بدنه برگردان تهی*، بدنه.طول()، نادرست))
    بایگانی.ساخت پرونده هفت زد(پرونده‌ها، "made.7z")
    پرونده‌ها.آزادکن()

    ناپایا پرونده_هفت := بایگانی.بازکردن پرونده هفت زد("made.7z"، "")
    ناپایا ورودی‌ها := بایگانی.مدخل های پرونده هفت زد(پرونده_هفت)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    سرچاپ بایگانی.استخراج از پرونده هفت زد به پرونده(پرونده_هفت، "data/log.txt"، "log.out"، 0 برگردان صحیح۶۴، 0 برگردان صحیح۶۴) برابر بایگانی.هفت زد موفق
    سرچاپ بایگانی.استخراج از پرونده هفت زد به پرونده(پرونده_هفت، "data/log.txt"، "log.out"، 10 برگردان صحیح۶۴، 0 برگردان صحیح۶۴) برابر بایگانی.هفت زد بیش از حد بزرگ
    بایگانی.بستن پرونده هفت زد(پرونده_هفت)
    سیستم عامل.حذف("made.7z")
    سیستم عامل.حذف("log.out")
پایان
خروجیdata/log.txt 48 true true

تارهای بزرگ روی دیسک

TarFileOpen تاری را از دیسک مدخل‌به‌مدخل می‌خواند: TarFileNext یک Entry پر می‌کند (اندازه‌ها و جابه‌جایی‌ها ۶۴ بیتی‌اند، پس مدخل ۵ گیگابایتی هم فقط یک مدخل است)، TarFileExtractTo داده‌اش را در تکه‌های ۶۴ کیلوبایتی در پرونده‌ای می‌ریزد و TarFileExtractAll کل بایگانی را با همان قواعد ایمنی TarExtractAll باز می‌کند. جز سرآیند یک مدخل چیزی در حافظه نمی‌ماند. cap تنها سقف اندازه است و دست خودتان است (۰ یعنی بدون سقف): TAR_TOO_BIG یعنی مدخلی از آن بزرگ‌تر است. TarGzFileExtractAll و GzipDecompressFileCap همین کار را برای gzip می‌کنند که به‌صورت جریان خوانده می‌شود. تار فشرده به پرونده‌ی موقت نیاز ندارد: TarGzFileExtractAll، TarBz2FileExtractAll، TarXzFileExtractAll و TarZstdFileExtractAll (یا TarCompressedFileExtractAll) خروجی کدگشا را تکه‌تکه به خواننده‌ی تار می‌دهند و TarCompressedFileEntries همین‌طور فهرستش می‌کند.

archive-guide-tarfile.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی سیستم عامل

تابع ریشه:
    بدنه := "streamed straight from the archive\n"
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("logs/a.txt"، بدنه برگردان تهی*، بدنه.طول()، نادرست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("logs/b.txt"، بدنه برگردان تهی*، 10، نادرست))
    ناپایا ساخته := بایگانی.ساخت تار(پرونده‌ها)
    پرونده‌ها.آزادکن()
    بایگانی.نوشتن پرونده دودویی از بافر("made.tar"، ساخته)
    فشرده سازی.آزادسازی بافر(ساخته)

    ناپایا پرونده_تار := بایگانی.بازکردن پرونده تار("made.tar")
    ناپایا عنصر := بایگانی.مدخل {}
    تا بایگانی.مدخل بعدی پرونده تار(پرونده_تار، عنصر):
        سرچاپ عنصر.نام، عنصر.اندازه
        اگر عنصر.نام برابر "logs/a.txt":
            سرچاپ بایگانی.استخراج از پرونده تار به پرونده(پرونده_تار، عنصر، "a.out"، 0 برگردان صحیح۶۴) برابر بایگانی.تار موفق
            سرچاپ بایگانی.استخراج از پرونده تار به پرونده(پرونده_تار، عنصر، "a.out"، 5 برگردان صحیح۶۴) برابر بایگانی.تار بیش از حد بزرگ
        پایان
        بایگانی.آزادسازی مدخل(عنصر)
    پایان
    بایگانی.بستن پرونده تار(پرونده_تار)

    سرچاپ بایگانی.استخراج همه از پرونده تار("made.tar"، "out"، 0 برگردان صحیح۶۴) برابر بایگانی.تار موفق
    سیستم عامل.حذف همه("out")
    سیستم عامل.حذف("made.tar")
    سیستم عامل.حذف("a.out")
پایان
خروجیlogs/a.txt 35 true true logs/b.txt 10 true

پرونده‌های RAR بزرگ روی دیسک

RarFileOpen فقط سرآیندهای یک پرونده‌ی RAR 5 را می‌خواند (جابه‌جایی‌ها و اندازه‌ها ۶۴ بیتی‌اند)؛ سپس RarFileExtractTo و RarFileExtractAll روی دیسک باز می‌کنند، نتیجه را تکه‌تکه می‌نویسند و همان‌جا CRC-32 را می‌سنجند. مدخل‌های فشرده، بایگانی‌های یکپارچه و فیلترهای داخلی کار می‌کنند. در حافظه فقط داده‌ی فشرده‌ی یک مدخل و پنجره‌ی رمزگشا می‌ماند، پس اندازه‌ی بازشده هر چه باشد فرق نمی‌کند: مدخلی چند گیگابایتی از پرونده‌ای چند مگابایتی با حافظه‌ی ثابت باز می‌شود. سقف‌ها دست خودتان است: cap برای بایت‌های بازشده و memcap برای آن حافظه، و RAR_TOO_BIG یعنی یکی‌شان رد شده است؛ RAR_WINDOW_TOO_BIG یعنی داده پنجره‌ای بزرگ‌تر از memcap یا ۱ گیبی‌بایت می‌خواهد. گذرواژه و بخش‌ها هم از دیسک کار می‌کنند: RarFileOpenWith بایگانی با پرونده یا نام رمزگذاری‌شده و RarFileOpenVolumes مجموعه‌ی چندبخشی را باز می‌کند و همزمان با باز شدن رمزگشایی و به هم وصل می‌کند. RarFileExtractAll دسترسی‌ها و زمان‌ها را بازمی‌گرداند و پیوندهای نمادین ایمن را می‌سازد. قالب‌های قدیمی RAR (۱٫۵ تا ۴٫x) هم همین‌طور کار می‌کنند، با گذرواژه، نام رمزگذاری‌شده و بخش‌ها: داده‌ی فشرده تکه‌تکه از پرونده خوانده می‌شود و داده‌ی بازشده تکه‌تکه روی دیسک می‌رود (فیلترهای VM در راه اعمال می‌شوند)، پس مدخل یا بخشی بیش از ۴ گیبی‌بایت هم با چند مگابایت حافظه کار می‌کند (اندازه‌ها و جابه‌جایی‌ها ۶۴ بیتی‌اند، با فیلدهای اندازه‌ی بالای سرآیندها). فقط مدخل‌هایی که با رمزهای بسیار قدیمی RAR 1.5 یا 2.0 رمزگذاری شده‌اند هنوز داده‌ی فشرده‌شان را در حافظه می‌خواهند، تا ۲۵۶ مگابایت.

archive-guide-rarfile.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی سیستم عامل

تابع ریشه:
    بدنه := "read from a RAR on disk, entry by entry\n"
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده آر ای آر>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده آر ای آر("notes/a.txt"، بدنه برگردان تهی*، بدنه.طول()، نادرست))
    بایگانی.ساخت پرونده آر ای آر(پرونده‌ها، "made.rar")
    پرونده‌ها.آزادکن()

    ناپایا چارچوب_خواندن := بایگانی.بازکردن پرونده آر ای آر("made.rar")
    سرچاپ چارچوب_خواندن.وضعیت برابر بایگانی.آر ای آر موفق، چارچوب_خواندن.جریانی
    ناپایا ورودی‌ها := بایگانی.مدخل های پرونده آر ای آر(چارچوب_خواندن)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    سرچاپ بایگانی.استخراج از پرونده آر ای آر به پرونده(چارچوب_خواندن، "notes/a.txt"، "a.out"، 0 برگردان صحیح۶۴، 0 برگردان صحیح۶۴) برابر بایگانی.آر ای آر موفق
    سرچاپ بایگانی.استخراج از پرونده آر ای آر به پرونده(چارچوب_خواندن، "notes/a.txt"، "a.out"، 5 برگردان صحیح۶۴، 0 برگردان صحیح۶۴) برابر بایگانی.آر ای آر بیش از حد بزرگ
    بایگانی.بستن پرونده آر ای آر(چارچوب_خواندن)
    سیستم عامل.حذف("made.rar")
    سیستم عامل.حذف("a.out")
پایان
خروجیtrue true notes/a.txt 40 true true

کدام تابع برای کدام کار

کارتابع
پرونده برای کاربران ویندوز یا دانلود از مرورگرساخت زیپ، ساخت پرونده زیپ
پشتیبان یا بسته‌ی انتشار روی یونیکسساخت تار جی زیپ یا ساخت پرونده تار جی زیپ
دیدن محتوای بایگانیفهرست زیپ، فهرست تار، فهرست آر ای آر، سپس آزادسازی فهرست
یک پرونده از بایگانیاستخراج با نام از زیپ، استخراج با نام از تار
همه چیز در یک پوشهاستخراج همه از زیپ، استخراج همه از تار
پرونده‌ی RARفهرست آر ای آر، استخراج آر ای آر (یا استخراج با نام از آر ای آر)، استخراج همه از آر ای آر؛ برای ساختن ساخت آر ای آر
بایگانی 7z، با گذرواژه یا بدون آن؛ ساخت هفت زد یکی می‌سازد (ذخیره‌شده)فهرست هفت زد، استخراج با نام از هفت زد، استخراج همه از هفت زد؛ وقتی گذرواژه دارد بازکردن هفت زد، مدخل‌های هفت زد، خواندن از هفت زد، خواندن همه از هفت زد
یک پرونده‌ی فشرده (.gz)فشرده سازی پرونده جی زیپ، کدگشایی پرونده جی زیپ
یک پرونده‌ی .xz یا .lzmaفشرده سازی پرونده ایکس زد، کدگشایی پرونده ایکس زد، فشرده سازی پرونده الزد ام ای، کدگشایی پرونده الزد ام ای
یک پرونده‌ی کوچک‌تر از جی‌زیپ (.bz2)فشرده سازی پرونده بی زیپ دو، کدگشایی پرونده بی زیپ دو
یک پرونده‌ی تنها با زستد (.zst)فشرده سازی پرونده زستد، کدگشایی پرونده زستد
اطمینان از سالم بودن بایگانیزیپ: بررسی زیپ، استخراج تایید شده از زیپ؛ جی‌زیپ و RAR خودشان می‌سنجند؛ بخش «بررسی یک بایگانی»
RAR گذرواژه‌دار یا چندبخشیبازکردن آر ای آر، بازکردن بخش‌های آر ای آر، سپس مدخل‌های آر ای آر، خواندن از آر ای آر، خواندن همه از آر ای آر
بایت‌ها از دیسک و به دیسکخواندن پرونده دودویی، نوشتن پرونده دودویی از بافر

گونه‌ها

پرونده زیپ ZipFile

ساختار پرونده زیپ
یک پرونده‌ی زیپ روی دیسک که با ZipOpenFile باز شده است. فقط فهرست مرکزی (فهرست مدخل‌ها) در حافظه می‌ماند و داده‌ها در پرونده می‌مانند.
نامانگلیسیگونهتوضیح
مسیرpathرشته = ""مسیری که بایگانی از آن باز شده است.
شمارcountصحیح۶۴ = 0شمار مدخل‌ها.
اندازهsizeصحیح۶۴ = 0اندازه‌ی پرونده به بایت.
وضعیتstatusصحیح = 0اگر بایگانی باز شده باشد ZIP_OK، وگرنه دلیل آن.
گذرواژهpasswordرشته = ""گذرواژه‌ای که با ZipFileSetPassword داده شده، یا رشته‌ی تهی.
فهرست مرکزیcdفشرده سازی.بافر بایتفهرست مرکزی که از پرونده خوانده شده است. آن را خصوصی بدانید؛ فقط برای پر شدن توسط بسته همگانی است.
قطعه هاvolumesوکتور<رشته>قطعه‌های یک بایگانی چندقطعه‌ای به ترتیب، یا فهرست تهی برای پرونده‌ی معمولی.
آغازهاstartsوکتور<صحیح۶۴>جایگاه هر قطعه در بایگانی به‌هم‌پیوسته. آن را خصوصی بدانید.
شماره قرصby_diskمنطقی = نادرستوقتی درست است که قطعه‌ها به سبک .z01 باشند و جابه‌جایی‌های فهرست نسبت به قطعه باشد. آن را خصوصی بدانید.
آغاز فهرستcd_startصحیح۶۴ = 0جایی که فهرست مرکزی در بایگانی به‌هم‌پیوسته شروع می‌شود. آن را خصوصی بدانید.
archive-ZipFile.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی سیستم عامل

تابع ریشه:
    بدنه := "a large file would be unpacked straight to disk\n"
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("data/log.txt"، بدنه برگردان تهی*، بدنه.طول()، 8))
    ناپایا ساخته := بایگانی.ساخت زیپ(پرونده‌ها)
    پرونده‌ها.آزادکن()
    بایگانی.نوشتن پرونده دودویی از بافر("made.zip"، ساخته)
    فشرده سازی.آزادسازی بافر(ساخته)

    ناپایا پرونده_زیپ := بایگانی.بازکردن پرونده زیپ("made.zip")
    ناپایا ورودی‌ها := بایگانی.مدخل های پرونده زیپ(پرونده_زیپ)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    سرچاپ بایگانی.استخراج از پرونده زیپ به پرونده(پرونده_زیپ، "data/log.txt"، "log.out"، 0 برگردان صحیح۶۴) برابر بایگانی.زیپ موفق
    سرچاپ بایگانی.استخراج از پرونده زیپ به پرونده(پرونده_زیپ، "data/log.txt"، "log.out"، 10 برگردان صحیح۶۴) برابر بایگانی.زیپ بیش از حد بزرگ
    بایگانی.بستن پرونده زیپ(پرونده_زیپ)
    سیستم عامل.حذف("made.zip")
    سیستم عامل.حذف("log.out")
پایان
خروجیdata/log.txt 48 true true

بایگانی هفت زد SevenZipArchive

ساختار بایگانی هفت زد
یک بایگانی 7z در حافظه و گذرواژه‌ای برای بازکردنش؛ بازکردن هفت زد آن را می‌سازد. تا وقتی تابعی روی آن صدا نزنید چیزی کپی یا خوانده نمی‌شود.
نامانگلیسیگونهتوضیح
دادهdataتهی*نشانی حافظه‌ی بایگانی.
طولlenصحیح = 0طول بایگانی به بایت.
گذرواژهpasswordرشته = ""گذرواژه، یا رشته‌ی تهی.
وضعیتstatusصحیح = 0آخرین فراخوانی چگونه پیش رفت: هفت زد موفق یا یکی از کدهای دیگر.
حافظه خودیownتهی*بخش‌های به‌هم‌پیوسته، وقتی بایگانی با SevenZipOpenVolumes ساخته شده باشد.
archive-SevenZip.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی

پایا ENCRYPTED := """
377abcaf271c000492b1434900010000000000003e0000000000000075a266e9cc0ca30fca42d412a3e1dd1194db4dd8fc
e2cf1a1d4df4ce0ca88687e1ab395abaa1bbe78d42aa044be8e9373779efdfd2ddd634772d8f0c62fa54d113cc6b3ac143
47c180a90a35752ec2feffd2b46d3a9a3c870cb0fe3a0a301165c3ad2ab69243d4c4aa154bf810ebf8b3e5988d6a3a9e4e
59bd2f4e7ad24baf35ba6aaad91e0b0a82e28a8c70941e255f48219088e4a3df6ae61451a7a0ad953c0d9e191005562c55
a4351cc71942b1bc90035da6a20467642f8d730da31f7a96c473e6f1986d738ecaaf865bbc4984c08559da1d3ace6c445a
6c34f94739a978d845b0f96290becff7b72085916669b917dbc847e2c2f359083aad6a78ac2674231153cb170650010980
b000070b0100022406f1070112530fd1de53f747a979d2abd82144f9abe78423030101055d0010000001000c80ad80de0a
0178dd34010000
"""

تابع nib(c: صحیح): صحیح:
    اگر c بزرگتربرابر 48 و c کوچکتربرابر 57:
        برگشت c - 48
    پایان
    اگر c بزرگتربرابر 97 و c کوچکتربرابر 102:
        برگشت c - 87
    پایان
    برگشت -1
پایان

تابع unhex(s: رشته): فشرده سازی.بافر بایت:
    ناپایا بافر_محلی := فشرده سازی.بافر بایت جدید()
    نشانگر_بایت := s برگردان طبیعی۸*
    ناپایا بالا := -1
    تکرار s.طول() در شمارنده:
        مقدار_محلی := nib(نشانگر_بایت[شمارنده] برگردان صحیح)
        اگر مقدار_محلی کوچکتر 0:
            گذر
        پایان
        اگر بالا کوچکتر 0:
            بالا = مقدار_محلی
        وگرنه:
            فشرده سازی.افزودن بایت(بافر_محلی، بالا * 16 + مقدار_محلی)
            بالا = -1
        پایان
    پایان
    برگشت بافر_محلی
پایان

تابع ریشه:
    بسته_شده := unhex(ENCRYPTED)
    ناپایا بایگانی_داده := بایگانی.بازکردن هفت زد(بسته_شده.داده، بسته_شده.طول، "")
    ناپایا نام‌ها := بایگانی.مدخل‌های هفت زد(بایگانی_داده)
    سرچاپ "بدون گذرواژه:"، نام‌ها.طول()، بایگانی_داده.وضعیت، بایگانی.متن وضعیت هفت زد(بایگانی_داده.وضعیت)

    بایگانی_داده = بایگانی.بازکردن هفت زد(بسته_شده.داده، بسته_شده.طول، "wrong")
    نام‌ها = بایگانی.مدخل‌های هفت زد(بایگانی_داده)
    سرچاپ "گذرواژه نادرست:"، نام‌ها.طول()، بایگانی_داده.وضعیت برابر بایگانی.هفت زد گذرواژه اشتباه

    بایگانی_داده = بایگانی.بازکردن هفت زد(بسته_شده.داده، بسته_شده.طول، "secret")
    نام‌ها = بایگانی.مدخل‌های هفت زد(بایگانی_داده)
    سرچاپ "گذرواژه درست:"، نام‌ها.طول()، بایگانی_داده.وضعیت برابر بایگانی.هفت زد موفق
    تکرار نام‌ها.طول() در شمارنده:
        عنصر := نام‌ها.بگیر(شمارنده)
        سرچاپ " "، عنصر.نام، عنصر.اندازه، عنصر.دسترسی، عنصر.زمان تغییر
    پایان

    داده := بایگانی.خواندن از هفت زد(بایگانی_داده، "src/main.salam"، 0)
    سرچاپ فشرده سازی.بافر به رشته(داده)
    گمشده := بایگانی.خواندن از هفت زد(بایگانی_داده، "nothing.txt"، 0)
    سرچاپ "ناموجود:"، بایگانی_داده.وضعیت برابر بایگانی.هفت زد یافت نشد، گمشده.طول
    متغیر_big := بایگانی.خواندن از هفت زد(بایگانی_داده، "readme.txt"، 10)
    سرچاپ "بیش از حد بزرگ:"، بایگانی_داده.وضعیت برابر بایگانی.هفت زد بیش از حد بزرگ، متغیر_big.طول

    سرچاپ "پشتیبانی نمی‌شود:"، بایگانی.متن وضعیت هفت زد(بایگانی.هفت زد پشتیبانی نمی شود)
    سرچاپ "خراب:"، بایگانی.متن وضعیت هفت زد(بایگانی.هفت زد خراب)
    سرچاپ "چک‌جمع نادرست:"، بایگانی.متن وضعیت هفت زد(بایگانی.هفت زد چک جمع ناهمخوان)
    سرچاپ "ناامن:"، بایگانی.متن وضعیت هفت زد(بایگانی.هفت زد مسیر ناامن)
    سرچاپ "فهرست:"، بایگانی.فهرست هفت زد(بسته_شده.داده، بسته_شده.طول).طول()
    سرچاپ "استخراج:"، بایگانی.استخراج هفت زد(بسته_شده.داده، بسته_شده.طول، "readme.txt"، 0، بایگانی_داده.وضعیت).طول، بایگانی_داده.وضعیت
پایان
خروجیبدون گذرواژه: 0 3 encrypted data and no password گذرواژه نادرست: 0 true گذرواژه درست: 4 true src 0 493 1700000000 empty.log 0 420 1700000000 readme.txt 120 420 1700000000 src/main.salam 35 420 1700000000 func main: println "salam" end ناموجود: true 0 بیش از حد بزرگ: true 0 پشتیبانی نمی‌شود: unsupported format, method or feature خراب: corrupt data چک‌جمع نادرست: checksum mismatch ناامن: entry path or link leaves the target folder فهرست: 0 استخراج: 0 3

ورودی پرونده تار TarFileInput

ساختار ورودی پرونده تار
یک پرونده برای ساختن تار.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام درون بایگانی. نام بیش از ۱۰۰ بایت در پیشوند ustar یا یک رکورد PAX می‌رود، پس هر طولی حفظ می‌شود.
نشانی دادهdata_ptrتهی*نشانی محتوا.
طول دادهdata_lenصحیح = 0طول محتوا.
پوشهis_dirمنطقی = نادرستورودی پوشه است.
دسترسیmodeصحیح = 0دسترسی پرونده مانند 0o755. صفر یعنی دسترسی معمول.
زمان تغییرmtimeصحیح۶۴ = 0زمان تغییر بر حسب ثانیه از مبدأ یونیکس؛ به‌طور پیش‌فرض صفر.
پیوندlinkرشته = ""مقصد مدخل پیوند نمادین یا سخت؛ برای نوع‌های دیگر نادیده گرفته می‌شود.
نوعkindصحیح = 0۰ برای پرونده یا پوشه (به is_dir نگاه کنید)، ۲ برای پیوند نمادین، ۳ برای پیوند سخت.
مسیر منبعpathرشته = ""پرونده‌ای که هنگام نوشتن بایگانی محتوا از آن خوانده می‌شود؛ برای مدخل پرونده‌ی معمولی به جای data_ptr به کار می‌رود.
archive-Tar.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    ب := فشرده سازی.بافر از رشته("خط اول\nخط دوم\n")
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("notes"، پوچ، ۰، درست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("notes/a.txt"، ب.داده، ب.طول، نادرست))
    ت := بایگانی.ساخت تار(پرونده‌ها)
    سرچاپ ت.طول % ۵۱۲
    ناپایا فهرست := بایگانی.فهرست تار(ت.داده، ت.طول)
    هر م در فهرست:
        سرچاپ م.نام، م.اندازه، م.پوشه
    پایان
    بایگانی.آزادسازی فهرست(فهرست)
    ناپایا خوب := نادرست
    الف := بایگانی.استخراج با نام از تار(ت.داده، ت.طول، "notes/a.txt"، خوب)
    سرچاپ خوب، فشرده سازی.بافر به رشته(الف)
    سرچاپ بایگانی.ساخت پرونده تار(پرونده‌ها، "out.tar")، بایگانی.استخراج همه از تار(ت.داده، ت.طول، "untarred")
    سرچاپ بایگانی.فشرده سازی پرونده جی زیپ("out.tar"، "out.tar.gz")، بایگانی.کدگشایی پرونده جی زیپ("out.tar.gz"، "back.tar")
    ک := بایگانی.خواندن پرونده دودویی("back.tar"، خوب)
    سرچاپ خوب، ک.طول == ت.طول
    بایگانی.اطمینان از پوشه("a/b/c")
    سرچاپ بایگانی.نوشتن پرونده دودویی("a/b/c/x.bin"، ب.داده، ۳)، بایگانی.نوشتن پرونده دودویی از بافر("a/b/c/y.bin"، ب)
    ناپایا ب۲ := فشرده سازی.بافر بایت جدید()
    بایگانی.نوشتن شانزده بیتی کم ارزش‌اول(ب۲، ۵۱۳)
    بایگانی.نوشتن عدد۳۲ کم ارزش‌اول(ب۲، ۷۰۰۰۰)
    سرچاپ بایگانی.خواندن شانزده بیتی کم ارزش‌اول(ب۲.داده، ۰)، بایگانی.خواندن عدد۳۲ کم ارزش‌اول(ب۲.داده، ۲)
پایان
خروجی0 notes 0 true notes/a.txt 24 false true خط اول خط دوم true true true true true true true true 513 70000

پرونده تار TarFile

ساختار پرونده تار
یک پرونده‌ی تار روی دیسک که با TarFileOpen باز می‌شود و مدخل‌به‌مدخل خوانده می‌شود. بایگانی هرگز در حافظه بار نمی‌شود.
نامانگلیسیگونهتوضیح
مسیرpathرشته = ""مسیری که بایگانی از آن باز شده است.
اندازهsizeصحیح۶۴ = 0اندازه‌ی پرونده به بایت.
وضعیتstatusصحیح = 0تا وقتی خواندن کار می‌کند TAR_OK، وگرنه دلیل توقف.
جایگاهposصحیح۶۴ = 0جابه‌جایی سرآیند بعدی (۶۴ بیتی).
جایگاه دادهdata_offصحیح۶۴ = 0جابه‌جایی داده‌ی مدخلی که TarFileNext آخرین بار داد (۶۴ بیتی).
پروندهfpتهی*دستگیره‌ی پرونده‌ی باز.
رکورد سراسریg_TarPaxوضعیت سرآیندهای سراسری PAX هنگام خواندن.
archive-TarFile.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی سیستم عامل

تابع ریشه:
    بدنه := "streamed straight from the archive\n"
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("logs/a.txt"، بدنه برگردان تهی*، بدنه.طول()، نادرست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("logs/b.txt"، بدنه برگردان تهی*، 10، نادرست))
    ناپایا ساخته := بایگانی.ساخت تار(پرونده‌ها)
    پرونده‌ها.آزادکن()
    بایگانی.نوشتن پرونده دودویی از بافر("made.tar"، ساخته)
    فشرده سازی.آزادسازی بافر(ساخته)

    ناپایا پرونده_تار := بایگانی.بازکردن پرونده تار("made.tar")
    ناپایا عنصر := بایگانی.مدخل {}
    تا بایگانی.مدخل بعدی پرونده تار(پرونده_تار، عنصر):
        سرچاپ عنصر.نام، عنصر.اندازه
        اگر عنصر.نام برابر "logs/a.txt":
            سرچاپ بایگانی.استخراج از پرونده تار به پرونده(پرونده_تار، عنصر، "a.out"، 0 برگردان صحیح۶۴) برابر بایگانی.تار موفق
            سرچاپ بایگانی.استخراج از پرونده تار به پرونده(پرونده_تار، عنصر، "a.out"، 5 برگردان صحیح۶۴) برابر بایگانی.تار بیش از حد بزرگ
        پایان
        بایگانی.آزادسازی مدخل(عنصر)
    پایان
    بایگانی.بستن پرونده تار(پرونده_تار)

    سرچاپ بایگانی.استخراج همه از پرونده تار("made.tar"، "out"، 0 برگردان صحیح۶۴) برابر بایگانی.تار موفق
    سیستم عامل.حذف همه("out")
    سیستم عامل.حذف("made.tar")
    سیستم عامل.حذف("a.out")
پایان
خروجیlogs/a.txt 35 true true logs/b.txt 10 true

مدخل Entry

ساختار مدخل
یک مدخل بایگانی.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام و مسیر درون بایگانی.
اندازهsizeصحیح۶۴ = 0اندازه‌ی اصلی بر حسب بایت.
اندازه فشردهcompressed_sizeصحیح۶۴ = 0اندازه‌ی فشرده.
پوشهis_dirمنطقی = نادرستمدخل پوشه است.
روشmethodصحیح = 0روش فشرده‌سازی: صفر ذخیره‌ی ساده، ۸ DEFLATE، ۱۲ bzip2، ۱۴ LZMA، ۹۳ zstd.
چک‌جمعcrc32طبیعی۳۲ = 0چک‌جمع محتوا.
زمان تغییرmtimeصحیح۶۴ = 0زمان تغییر بر حسب ثانیه از مبدأ یونیکس: از سرآیند تار یا RAR، و برای زیپ تاریخ و ساعت DOS که UTC خوانده می‌شود (صفر اگر مدخل نداشته باشد).
پیوندlinkرشته = ""مقصد پیوند نمادین یا سخت در تار، وگرنه خالی.
نوعkindصحیح = 0مدخل تار چیست: ۰ پرونده، ۱ پوشه، ۲ پیوند نمادین، ۳ پیوند سخت، ۴ دیگر (دستگاه، لوله). مدخل‌های زیپ و RAR ۰ یا ۱ هستند؛ مدخل‌های 7z ۰، ۱ یا ۲ هستند (پیوند نمادین، با مقصد در link).
دسترسیmodeصحیح = 0بیت‌های دسترسی مدخل تار، مانند 0o644؛ برای مدخل‌های زیپ و RAR صفر.
archive-Zip.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    متن := "سلام بایگانی، سلام بایگانی، سلام بایگانی"
    ب := فشرده سازی.بافر از رشته(متن)
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("docs/"، پوچ، ۰، ۰))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("docs/a.txt"، ب.داده، ب.طول، ۸))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("b.txt"، ب.داده، ۵، ۰))
    ز := بایگانی.ساخت زیپ(پرونده‌ها)
    ناپایا فهرست := بایگانی.فهرست زیپ(ز.داده، ز.طول)
    هر م در فهرست:
        سرچاپ م.نام، م.اندازه، م.اندازه فشرده < م.اندازه، م.پوشه، م.روش
    پایان
    بایگانی.آزادسازی فهرست(فهرست)
    ناپایا خوب := نادرست
    الف := بایگانی.استخراج با نام از زیپ(ز.داده، ز.طول، "docs/a.txt"، خوب)
    سرچاپ خوب، فشرده سازی.بافر به رشته(الف) == متن
    _ := بایگانی.استخراج با نام از زیپ(ز.داده، ز.طول، "نیست"، خوب)
    سرچاپ خوب
    کوچک := بایگانی.استخراج با نام از زیپ با سقف(ز.داده، ز.طول، "docs/a.txt"، ۱۰، خوب)
    سرچاپ خوب، کوچک.طول
    کامل := بایگانی.استخراج با نام از زیپ با سقف(ز.داده، ز.طول، "docs/a.txt"، ۱۰۰، خوب)
    سرچاپ خوب، کامل.طول
    سرچاپ بایگانی.ساخت پرونده زیپ(پرونده‌ها، "out.zip")، بایگانی.استخراج همه از زیپ(ز.داده، ز.طول، "unzipped")
    خوانده := بایگانی.خواندن پرونده دودویی("unzipped/docs/a.txt"، خوب)
    سرچاپ خوب، خوانده.طول == ب.طول
    سرچاپ بایگانی.آر ای آر است(ز.داده، ز.طول)، بایگانی.فهرست آر ای آر(ز.داده، ز.طول).طول()
    _ := بایگانی.استخراج با نام از آر ای آر(ز.داده، ز.طول، "x"، خوب)
    سرچاپ خوب، بایگانی.استخراج همه از آر ای آر(ز.داده، ز.طول، "rar-out")
پایان
خروجیdocs/ 0 false true 0 docs/a.txt 75 true false 8 b.txt 5 false false 0 true true false false 0 true 75 true true true true false 0 false true

ورودی پرونده هفت زد SevenZipFileInput

ساختار ورودی پرونده هفت زد
یک پرونده، پوشه یا پیوند نمادین برای گذاشتن در بایگانی 7z.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام درون بایگانی؛ میان پوشه‌ها / بگذارید. اسلش پایانی حذف می‌شود.
نشانی دادهdata_ptrتهی*نشانی محتوا.
طول دادهdata_lenصحیح = 0طول محتوا. مدخلی بی‌محتوا پرونده‌ی تهی ذخیره می‌شود.
پوشهis_dirمنطقی = نادرستبرای مدخل پوشه درست است؛ محتوا ندارد.
زمان تغییرmtimeصحیح۶۴ = 0زمان تغییر به ثانیه از آغاز یونیکس، یا ۰ برای نگذاشتن.
دسترسیmodeصحیح = 0بیت‌های دسترسی یونیکس (برای نمونه ۴۲۰ برای 0644)، یا ۰ برای نگذاشتن.
پیوندlinkرشته = ""مقصد یک پیوند نمادین. اگر تهی نباشد مدخل پیوند است و محتوا نادیده گرفته می‌شود.
مسیر منبعpathرشته = ""پرونده‌ای که هنگام نوشتن بایگانی محتوا از آن خوانده می‌شود؛ به جای data_ptr به کار می‌رود.
archive-SevenZipCreate.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    الف := فشرده سازی.بافر از رشته("first file\n")
    بافر_محلی := فشرده سازی.بافر از رشته("second file, a little longer\n")
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده هفت زد>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده هفت زد("docs/"، پوچ، 0، درست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده هفت زد("docs/a.txt"، الف.داده، الف.طول، نادرست))
    ناپایا دومی := بایگانی.ساخت ورودی پرونده هفت زد("docs/b.txt"، بافر_محلی.داده، بافر_محلی.طول، نادرست)
    دومی.زمان تغییر = 1700000000 برگردان صحیح۶۴
    دومی.دسترسی = 420
    پرونده‌ها.بیفزا(دومی)
    ناپایا پیوند_محلی := بایگانی.ساخت ورودی پرونده هفت زد("docs/latest"، پوچ، 0، نادرست)
    پیوند_محلی.پیوند = "b.txt"
    پرونده‌ها.بیفزا(پیوند_محلی)
    بسته_شده := بایگانی.ساخت هفت زد(پرونده‌ها)
    سرچاپ بایگانی.هفت زد است(بسته_شده.داده، بسته_شده.طول)، بایگانی.ساخت پرونده هفت زد(پرونده‌ها، "made.7z")

    ناپایا ورودی‌ها := بایگانی.فهرست هفت زد(بسته_شده.داده، بسته_شده.طول)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه، عنصر.پوشه، عنصر.نوع، عنصر.زمان تغییر
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    ناپایا موفق := نادرست
    گرفته := بایگانی.استخراج با نام از هفت زد(بسته_شده.داده، بسته_شده.طول، "docs/b.txt"، موفق)
    سرچاپ موفق، فشرده سازی.بافر به رشته(گرفته) برابر "second file, a little longer\n"
پایان
خروجیtrue true docs 0 true 1 0 docs/a.txt 11 false 0 0 docs/b.txt 29 false 0 1700000000 docs/latest 5 false 2 0 true true

پرونده آر ای آر RarFile

ساختار پرونده آر ای آر
یک پرونده‌ی آر ای آر روی دیسک که با RarFileOpen باز شده است. فقط سرآیندها خوانده می‌شوند و داده در پرونده می‌ماند و مستقیم روی دیسک باز می‌شود، هم برای RAR 5 و هم برای قالب‌های قدیمی‌تر (۱٫۵ تا ۴٫x). قالب‌های قدیمی هم تکه‌تکه خوانده می‌شوند؛ فقط مدخل‌های رمزگذاری‌شده با رمزهای RAR 1.5 یا 2.0 داده‌ی فشرده‌شان را در حافظه نگه می‌دارند (تا ۲۵۶ مگابایت).
نامانگلیسیگونهتوضیح
مسیرpathرشته = ""مسیری که بایگانی از آن باز شده است.
اندازهsizeصحیح۶۴ = 0اندازه‌ی پرونده به بایت.
وضعیتstatusصحیح = 0اگر بایگانی باز شده باشد RAR_OK، وگرنه دلیل آن.
جریانیstreamingمنطقی = نادرستوقتی بایگانی بدون بار کردن کامل از دیسک خوانده شود درست است (همه‌ی قالب‌های RAR).
بایگانیarc_RarArcجدول مدخل‌های تجزیه‌شده. آن را خصوصی بدانید.
جابه جایی هاoffsوکتور<صحیح۶۴>جابه‌جایی ۶۴ بیتی داده‌ی هر مدخل در پرونده. آن را خصوصی بدانید.
کل دادهwholeفشرده سازی.بافر بایتمحتوای پرونده‌ی بایگانی‌ای که باید کامل بار می‌شد (پرونده‌ی خودگشا با کد اجرایی پیش از بایگانی، زیر ۲ گیگابایت). در غیر این صورت خالی است.
گذرواژهpasswordرشته = ""گذرواژه‌ای که به RarFileOpenWith یا RarFileOpenVolumes داده شد. آن را خصوصی بدانید.
بخش هاvols_RarVolsفهرست مسیر بخش‌ها و تکه‌های هر مدخل. آن را خصوصی بدانید.
archive-RarFile.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی سیستم عامل

تابع ریشه:
    بدنه := "read from a RAR on disk, entry by entry\n"
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده آر ای آر>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده آر ای آر("notes/a.txt"، بدنه برگردان تهی*، بدنه.طول()، نادرست))
    بایگانی.ساخت پرونده آر ای آر(پرونده‌ها، "made.rar")
    پرونده‌ها.آزادکن()

    ناپایا چارچوب_خواندن := بایگانی.بازکردن پرونده آر ای آر("made.rar")
    سرچاپ چارچوب_خواندن.وضعیت برابر بایگانی.آر ای آر موفق، چارچوب_خواندن.جریانی
    ناپایا ورودی‌ها := بایگانی.مدخل های پرونده آر ای آر(چارچوب_خواندن)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    سرچاپ بایگانی.استخراج از پرونده آر ای آر به پرونده(چارچوب_خواندن، "notes/a.txt"، "a.out"، 0 برگردان صحیح۶۴، 0 برگردان صحیح۶۴) برابر بایگانی.آر ای آر موفق
    سرچاپ بایگانی.استخراج از پرونده آر ای آر به پرونده(چارچوب_خواندن، "notes/a.txt"، "a.out"، 5 برگردان صحیح۶۴، 0 برگردان صحیح۶۴) برابر بایگانی.آر ای آر بیش از حد بزرگ
    بایگانی.بستن پرونده آر ای آر(چارچوب_خواندن)
    سیستم عامل.حذف("made.rar")
    سیستم عامل.حذف("a.out")
پایان
خروجیtrue true notes/a.txt 40 true true

پرونده هفت زد SevenZipFile

ساختار پرونده هفت زد
یک پرونده‌ی 7z روی دیسک که با SevenZipOpenFile باز شده است. فقط فهرست مدخل‌ها (سرآیند) در حافظه می‌ماند و داده‌ها در پرونده می‌مانند.
نامانگلیسیگونهتوضیح
مسیرpathرشته = ""مسیری که بایگانی از آن باز شد.
اندازهsizeصحیح۶۴ = 0اندازه‌ی پرونده به بایت.
آغازstartصحیح۶۴ = 0جایی از پرونده که بایگانی شروع می‌شود؛ برای برنامه‌ی خودگشا صفر نیست.
گذرواژهpasswordرشته = ""گذرواژه، یا رشته‌ی تهی.
وضعیتstatusصحیح = 0اگر بایگانی باز شد SEVENZIP_OK، وگرنه دلیل آن.
سرایندhdrفشرده سازی.بافر بایتسرآیند رمزگشایی‌شده. آن را خصوصی بدانید؛ فقط برای پر شدن توسط بسته همگانی است.
بخش هاvolumesوکتور<رشته>مسیر تکه‌ها وقتی بایگانی از name.7z.001 باز شده باشد؛ وگرنه یک مسیر. تکه‌ها همان‌جا خوانده می‌شوند و در حافظه به هم چسبانده نمی‌شوند.
داده حافظهmempتهی*بایت‌های بایگانی وقتی بسته یک بایگانی درون حافظه از بازکردن هفت زد را با این گونه می‌خواند؛ برای بایگانی‌ای که از پرونده باز شده تهی است. آن را خصوصی بدانید؛ فقط برای پر شدن توسط بسته همگانی است.
اندازه حافظهmemnصحیح۶۴ = 0طول همان بایت‌ها، و برای پرونده صفر. مثل داده حافظه خصوصی است.
archive-SevenZipFile.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی سیستم عامل

تابع ریشه:
    بدنه := "a large file would be unpacked straight to disk\n"
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده هفت زد>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده هفت زد("data/log.txt"، بدنه برگردان تهی*، بدنه.طول()، نادرست))
    بایگانی.ساخت پرونده هفت زد(پرونده‌ها، "made.7z")
    پرونده‌ها.آزادکن()

    ناپایا پرونده_هفت := بایگانی.بازکردن پرونده هفت زد("made.7z"، "")
    ناپایا ورودی‌ها := بایگانی.مدخل های پرونده هفت زد(پرونده_هفت)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    سرچاپ بایگانی.استخراج از پرونده هفت زد به پرونده(پرونده_هفت، "data/log.txt"، "log.out"، 0 برگردان صحیح۶۴، 0 برگردان صحیح۶۴) برابر بایگانی.هفت زد موفق
    سرچاپ بایگانی.استخراج از پرونده هفت زد به پرونده(پرونده_هفت، "data/log.txt"، "log.out"، 10 برگردان صحیح۶۴، 0 برگردان صحیح۶۴) برابر بایگانی.هفت زد بیش از حد بزرگ
    بایگانی.بستن پرونده هفت زد(پرونده_هفت)
    سیستم عامل.حذف("made.7z")
    سیستم عامل.حذف("log.out")
پایان
خروجیdata/log.txt 48 true true

ورودی پرونده زیپ ZipFileInput

ساختار ورودی پرونده زیپ
یک پرونده برای ساختن زیپ.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام درون بایگانی؛ نام پوشه با / تمام می‌شود. میان پوشه‌ها همیشه / بگذارید، هرگز \.
نشانی دادهdata_ptrتهی*نشانی محتوا.
طول دادهdata_lenصحیح = 0طول محتوا.
روشmethodصحیح = 8صفر برای ذخیره‌ی ساده، ۸ برای DEFLATE، ۱۲ برای bzip2، ۱۴ برای LZMA یا ۹۳ برای zstd. هر عدد دیگر داده را ذخیره‌ی ساده می‌کند، مدخل خالی هم همین‌طور.
زمان تغییرmtimeصحیح۶۴ = 0زمان تغییر بر حسب ثانیه از مبدأ یونیکس. صفر یا زمانی پیش از ۱۹۸۰ تاریخ ۱ ژانویه‌ی ۱۹۸۰ را می‌نویسد؛ قالب DOS از ۲۱۰۷ جلوتر نمی‌رود و گام دو ثانیه‌ای دارد.
سطحlevelصحیح = 0سطح فشرده‌سازی برای bzip2 (۱ تا ۹، پیش‌فرض ۹)، LZMA (۱ تا ۹، پیش‌فرض ۶) یا zstd (۱ تا ۲۲، پیش‌فرض ۳). صفر پیش‌فرض را برمی‌گزیند؛ DEFLATE و ذخیره‌ی ساده آن را نادیده می‌گیرند.
مسیر منبعpathرشته = ""پرونده‌ای که هنگام نوشتن بایگانی محتوا از آن خوانده می‌شود؛ به جای data_ptr به کار می‌رود. با ساخت پرونده زیپ مدخل تکه‌تکه خوانده و فشرده می‌شود، پس هرگز یکجا در حافظه نیست: DEFLATE با توصیف‌گر داده، و مدخل‌های bzip2 و LZMA و zstd با اندازه‌ی جانشین که پس از پایان مدخل در سرایند محلی اصلاح می‌شود.
گذرواژهpasswordرشته = ""گذرواژه‌ی این مدخل؛ تهی یعنی بدون رمزگذاری.
رمزگذاریencryptionصحیح = 0رمزگذاری زیپ خودکار (۰، اگر گذرواژه باشد AES-256)، رمزگذاری زیپ کریپتو (۱، رمزگذاری قدیمی و ضعیف زیپ)، رمزگذاری زیپ ای ای اس۱۲۸، رمزگذاری زیپ ای ای اس۱۹۲ یا رمزگذاری زیپ ای ای اس۲۵۶ (AES وین‌زیپ، نسخه‌ی AE-2). unzip فقط ZipCrypto را می‌خواند؛ ۷-زیپ و وین‌زیپ هر دو را.
archive-Fields.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    متن := "fields of an entry, fields of an entry"
    بافر_محلی := فشرده سازی.بافر از رشته(متن)

    ناپایا متغیر_zin := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    متغیر_zin.بیفزا(بایگانی.ورودی پرونده زیپ { نام = "docs/"، نشانی داده = پوچ، طول داده = 0، روش = 0 })
    متغیر_zin.بیفزا(بایگانی.ورودی پرونده زیپ { نام = "docs/a.txt"، نشانی داده = بافر_محلی.داده، طول داده = بافر_محلی.طول، روش = 8 })
    زد := بایگانی.ساخت زیپ(متغیر_zin)
    ناپایا متغیر_zentries := بایگانی.فهرست زیپ(زد.داده، زد.طول)
    هر عنصر در متغیر_zentries:
        سرچاپ عنصر.نام، عنصر.اندازه، عنصر.اندازه فشرده کوچکتربرابر عنصر.اندازه، عنصر.پوشه، عنصر.روش، عنصر.چک‌جمع برابر فشرده سازی.چک جمع سی آر سی بافر(بافر_محلی) یا عنصر.پوشه، عنصر.زمان تغییر بزرگتربرابر 0
    پایان
    بایگانی.آزادسازی فهرست(متغیر_zentries)

    ناپایا متغیر_tin := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    متغیر_tin.بیفزا(بایگانی.ورودی پرونده تار { نام = "notes/"، نشانی داده = پوچ، طول داده = 0، پوشه = درست })
    متغیر_tin.بیفزا(بایگانی.ورودی پرونده تار { نام = "notes/a.txt"، نشانی داده = بافر_محلی.داده، طول داده = بافر_محلی.طول، پوشه = نادرست })
    موقت := بایگانی.ساخت تار(متغیر_tin)
    ناپایا متغیر_tentries := بایگانی.فهرست تار(موقت.داده، موقت.طول)
    هر عنصر در متغیر_tentries:
        سرچاپ عنصر.نام، عنصر.اندازه، عنصر.پوشه
    پایان
    بایگانی.آزادسازی فهرست(متغیر_tentries)
پایان
خروجیdocs/ 0 true true 0 true true docs/a.txt 38 true false 8 true true notes/ 0 true notes/a.txt 38 false

سقف ها Limits

ساختار سقف ها
سقف‌هایی که ExtractAll و Open اعمال می‌کنند.
نامانگلیسیگونهتوضیح
بیشینه مدخلmax_entriesصحیح = 100000بیشترین تعداد مدخل؛ صفر یعنی بدون سقف. پیش‌فرض 100000.
بیشینه اندازه مدخلmax_entryصحیح۶۴ = 1073741824بیشترین بایتی که یک مدخل می‌تواند باز شود؛ صفر یعنی بدون سقف. پیش‌فرض 1 GiB.
بیشینه اندازه کلmax_totalصحیح۶۴ = 4294967296بیشترین بایت همه‌ی مدخل‌ها با هم، و سقف باز کردن gzip، bzip2 و xz. پیش‌فرض 4 GiB.
بیشینه نسبت فشرده سازیmax_ratioصحیح = 5000بیشترین نسبت مجموع بازشده به اندازه‌ی بایگانی (به علاوه‌ی 1 MiB)؛ صفر یعنی خاموش. پیش‌فرض 5000.
archive-Open.salam
// زبان: فارسی
/*
 * Salam Programming Language (2024-2026)
 *
 *   +-------------------+
 *   |     S A L A M     |
 *   +-------------------+
 *
 * Designed by Seyyed Ali Mohammadiyeh and the Salam Team
 * Born from a decade of language design experience (since 2018)
 *
 * Repository: https://github.com/SalamLang/Salam
 *
 */

بسته ریشه

واردسازی بایگانی
واردسازی فشرده سازی
واردسازی مسیر پرونده
واردسازی سیستم عامل

تابع ریشه:
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده("docs/"، پوچ، 0، درست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده("docs/a.txt"، "hello hello hello hello" برگردان تهی*، 23، نادرست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده("b.txt"، "bee" برگردان تهی*، 3، نادرست))

    ناپایا وضعیت := 0
    ناپایا ساخته_شده := بایگانی.ساخت بایگانی در بافر(بایگانی.قالب تار جی زیپ، پرونده‌ها، وضعیت)
    سرچاپ وضعیت، بایگانی.نام قالب(بایگانی.تشخیص قالب(ساخته_شده.داده، ساخته_شده.طول))

    ناپایا بایگانی_داده := بایگانی.بازکردن بایگانی(ساخته_شده.داده، ساخته_شده.طول، "")
    سرچاپ بایگانی.نام قالب(بایگانی_داده.قالب)، بایگانی_داده.وضعیت
    ناپایا ورودی‌ها := بایگانی.فهرست بایگانی(بایگانی_داده)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه، عنصر.پوشه
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    ناپایا داده := بایگانی.خواندن از بایگانی(بایگانی_داده، "docs/a.txt")
    سرچاپ بایگانی_داده.وضعیت، فشرده سازی.بافر به رشته(داده)
    فشرده سازی.آزادسازی بافر(داده)
    ناپایا گمشده := بایگانی.خواندن از بایگانی(بایگانی_داده، "nope.txt")
    سرچاپ بایگانی_داده.وضعیت، بایگانی.متن وضعیت بایگانی(بایگانی_داده.وضعیت)
    فشرده سازی.آزادسازی بافر(گمشده)

    مقصد := مسیر پرونده.پیوند(سیستم عامل.پوشه موقت()، "salam-open-demo")
    تعداد := بایگانی.استخراج همه از بایگانی(بایگانی_داده، مقصد)
    سرچاپ تعداد، بایگانی.متن وضعیت بایگانی(بایگانی_داده.وضعیت)، سیستم عامل.وجود دارد(مسیر پرونده.پیوند(مقصد، "docs/a.txt"))
    سیستم عامل.حذف همه(مقصد)

    ناپایا متغیر_tight := بایگانی.سقف های پیش فرض()
    متغیر_tight.بیشینه مدخل = 2
    ناپایا کوچک := بایگانی.بازکردن با سقف(ساخته_شده.داده، ساخته_شده.طول، ""، متغیر_tight)
    سرچاپ بایگانی.استخراج همه از بایگانی(کوچک، مقصد)، بایگانی.متن وضعیت بایگانی(کوچک.وضعیت)
    بایگانی.بستن بایگانی(کوچک)
    بایگانی.بستن بایگانی(بایگانی_داده)

    سرچاپ بایگانی.تشخیص قالب از نام("backup.tgz") برابر بایگانی.قالب تار جی زیپ، بایگانی.تشخیص قالب از نام("notes.txt") برابر بایگانی.قالب ناشناخته
    فشرده سازی.آزادسازی بافر(ساخته_شده)
    پرونده‌ها.آزادکن()
پایان
خروجی0 gzip tar.gz 0 docs/ 0 true docs/a.txt 23 false b.txt 3 false 0 hello hello hello hello 1 entry not found 2 ok true 0 too many entries true true

بایگانی Archive

ساختار بایگانی
بایگانی بازشده از هر قالب، ساخته‌ی Open، OpenWith یا OpenFile. با Close آزاد کنید.
نامانگلیسیگونهتوضیح
دادهdataتهی*نشانی بایت‌های بایگانی (مالک آن نیستیم، مگر OpenFile آن را کامل خوانده باشد). برای بایگانی‌ای که OpenFile روی دیسک نگه می‌دارد پوچ است.
طولlenصحیح = 0طول بایت‌های بایگانی.
گذرواژهpasswordرشته = ""گذرواژه‌ای که به Open داده شد.
قالبformatصحیح = 0قالب شناخته‌شده، یکی از کدهای Format.
وضعیتstatusصحیح = 0کد ARCHIVE_ آخرین فراخوانی.
سقف هاlimitsسقف هاسقف‌های اعمال‌شده.
نامnameرشته = "data"نام تنها مدخل در پرونده‌های تک‌جریانی؛ OpenFile آن را از نام پرونده برمی‌دارد، وگرنه data.
شکستfailصحیح = 0دلیل باز نشدن بایگانی، یا صفر.
درونinnerفشرده سازی.بافر بایتبایت‌های بازشده‌ی پرونده‌ی gzip، bzip2 یا xz.
پروندهfileفشرده سازی.بافر بایتمحتوای پرونده، وقتی OpenFile آن را کامل خوانده باشد.
روی دیسکdiskصحیح = 0خواننده‌ی روی دیسکی که بایگانیِ بازشده با OpenFile به کار می‌برد: ۱ زیپ، ۲ 7z، ۳ تار، ۴ RAR، ۵ tar.gz (کدگشایی جریانی) و ۰ وقتی بایگانی در حافظه است.
پرونده موقتtmpرشته = ""اکنون همیشه خالی است؛ tar.gz ای که با OpenFile باز شود به صورت جریان خوانده می‌شود و پرونده‌ی موقتی ساخته نمی‌شود.
مسیر جی زیپgzpathرشته = ""مسیر tar.gz ای که OpenFile آن را به صورت جریان می‌خواند (disk برابر ۵)؛ در غیر این صورت خالی.
پرونده زیپzfپرونده زیپZipFile پشت زیپی که با OpenFile باز شده است.
پرونده هفت زدszپرونده هفت زدSevenZipFile پشت 7z ای که با OpenFile باز شده است.
پرونده تارtfپرونده تارTarFile پشت tar یا tar.gz ای که با OpenFile باز شده است.
پرونده آر ای آرrfپرونده آر ای آرRarFile پشت RAR ای که با OpenFile باز شده است.

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

ورودی پرونده FileInput

ساختار ورودی پرونده
یک پرونده برای گذاشتن در بایگانی با Create یا CreateBuf.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام درون بایگانی. باید مسیر نسبی امن باشد.
نشانی دادهdata_ptrتهی*نشانی محتوا.
طول دادهdata_lenصحیح = 0طول محتوا.
پوشهis_dirمنطقی = نادرستمدخل یک پوشه است.

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

ورودی پرونده آر ای آر RarFileInput

ساختار ورودی پرونده آر ای آر
یک پرونده برای ساختن RAR.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام درون بایگانی؛ نام پوشه با / تمام می‌شود. میان پوشه‌ها همیشه / بگذارید، هرگز \.
نشانی دادهdata_ptrتهی*نشانی محتوا.
طول دادهdata_lenصحیح = 0طول محتوا.
پوشهis_dirمنطقی = نادرستبرای مدخل پوشه درست است؛ محتوایی ندارد.
زمان تغییرmtimeصحیح۶۴ = 0زمان تغییر به ثانیه از آغاز یونیکس، یا ۰ برای نگذاشتن آن.
archive-Rar.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    الف := فشرده سازی.بافر از رشته("first file\n")
    ب := فشرده سازی.بافر از رشته("second file, a little longer\n")
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده آر ای آر>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده آر ای آر("docs/"، پوچ، ۰، درست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده آر ای آر("docs/a.txt"، الف.داده، الف.طول، نادرست))
    ناپایا دوم := بایگانی.ساخت ورودی پرونده آر ای آر("docs/b.txt"، ب.داده، ب.طول، نادرست)
    دوم.زمان تغییر = ۱۷۰۰۰۰۰۰۰۰ برگردان صحیح۶۴
    پرونده‌ها.بیفزا(دوم)
    ر := بایگانی.ساخت آر ای آر(پرونده‌ها)
    سرچاپ بایگانی.آر ای آر است(ر.داده، ر.طول)، بایگانی.ساخت پرونده آر ای آر(پرونده‌ها، "made.rar")

    ناپایا فهرست := بایگانی.فهرست آر ای آر(ر.داده، ر.طول)
    هر م در فهرست:
        سرچاپ م.نام، م.اندازه، م.پوشه، م.زمان تغییر
    پایان
    بایگانی.آزادسازی فهرست(فهرست)

    ناپایا وضعیت := ۰
    گرفته := بایگانی.استخراج آر ای آر(ر.داده، ر.طول، "docs/b.txt"، ۰، وضعیت)
    سرچاپ وضعیت == بایگانی.آر ای آر موفق، فشرده سازی.بافر به رشته(گرفته) == "second file, a little longer\n"
    _ := بایگانی.استخراج آر ای آر(ر.داده، ر.طول، "docs/none.txt"، ۰، وضعیت)
    سرچاپ وضعیت == بایگانی.آر ای آر یافت نشد، بایگانی.متن وضعیت آر ای آر(وضعیت)

    ناپایا خوب := نادرست
    کوچک := بایگانی.استخراج با نام از آر ای آر با سقف(ر.داده، ر.طول، "docs/b.txt"، ۵، خوب)
    سرچاپ خوب، کوچک.طول
    سرچاپ بایگانی.متن وضعیت آر ای آر(بایگانی.آر ای آر بیش از حد بزرگ)

    تعداد := بایگانی.استخراج همه از آر ای آر با وضعیت(ر.داده، ر.طول، "rar-out"، وضعیت)
    سرچاپ تعداد، بایگانی.متن وضعیت آر ای آر(وضعیت)

    خراب := فشرده سازی.کپی بافر(ر)
    پ := خراب.داده برگردان طبیعی۸*
    پ[خراب.طول - ۱۵] = ((پ[خراب.طول - ۱۵] برگردان صحیح) ^ ۱) برگردان طبیعی۸
    _ := بایگانی.استخراج آر ای آر(خراب.داده، خراب.طول، "docs/b.txt"، ۰، وضعیت)
    سرچاپ وضعیت == بایگانی.آر ای آر چک جمع ناهمخوان، بایگانی.متن وضعیت آر ای آر(وضعیت)
پایان
خروجیtrue true docs 0 true 0 docs/a.txt 11 false 0 docs/b.txt 29 false 1700000000 true true true entry not found false 0 entry too large 3 ok true checksum mismatch

بایگانی آر ای آر RarArchive

ساختار بایگانی آر ای آر
یک بایگانی RAR در حافظه همراه با گذرواژه‌ی بازکردن آن. با RarOpen ساخته می‌شود.
نامانگلیسیگونهتوضیح
دادهdataتهی*نشانی بایت‌های بایگانی.
طولlenصحیح = 0طول بایگانی.
گذرواژهpasswordرشته = ""گذرواژه، یا رشته‌ی تهی برای بی‌گذرواژه.
وضعیتstatusصحیح = 0نتیجه‌ی آخرین فراخوانی RarEntries، RarRead یا RarReadAll، یکی از کدهای RAR_.
بخش‌های دیگرmoreوکتور<فشرده سازی.بافر بایت>بخش‌های پس از نخستین، وقتی بایگانی با RarOpenVolumes باز شده باشد.
archive-RarPassword.salam
واردسازی بایگانی
واردسازی فشرده سازی

پایا نمونه := """
526172211a07010038d1db9021040000010fe945634161dc2d7b3e8b87f362874d32048313f00358e483efb2886b026e
590dc3a9e23be3b7cfa25ea1dd6a6c4c4af8702cb2d51eb2f7798221661b321c792f762b84ffbf221b7100d324e8f848
ca96b61074ef27c65ba5a760024e3e27ccd59be9d8047bce7da160956a1dd1ca59d5970613a92c4582b076eb3398a1b7
8ef8151f33cf3665dea91210eaede8f1c08f503c488358eb375bf44e0a7a90b81067d6a6637ae589c00f19b387d3d769
f8cfa327f9b218211f11fe63a7a1783e45656fcc9573869eaf359485c0e2d4d5066ddc9981c7b13390c6d78d0ea24a04
386db10eb6d52567002ad55ebee7f1a172080c6a7bd1c72ac29e74d0480d38934012ee49a5fcd5111ad5899223384b67
b8491eed31431d7295083a332114430d96e4004c3426c450dbd1985644df90632ebb89c94cb9f9000fe8b54e0335aa44
fe401e45aad3727aee1392db44b09094b58754bc5ae4fd2186aeb6790bbf2dc3a4225dd37203f3eeecf02fcfb2f150a1
4293fbab1e38425c7bdd1909e3b24e6882fb38344a28184e8d993d93616aeb3eb57e60b5681280a7d138329a4cda
"""

تابع رقم(ک: صحیح): صحیح:
    اگر ک >= ۴۸ و ک <= ۵۷:
        برگشت ک - ۴۸
    پایان
    اگر ک >= ۹۷ و ک <= ۱۰۲:
        برگشت ک - ۸۷
    پایان
    برگشت -۱
پایان

تابع از هگز(متن: رشته): فشرده سازی.بافر بایت:
    ناپایا خروجی := فشرده سازی.بافر بایت جدید()
    بایت‌ها := متن برگردان طبیعی۸*
    ناپایا بالا := -۱
    تکرار متن.طول() در ای:
        م := رقم(بایت‌ها[ای] برگردان صحیح)
        اگر م < ۰:
            گذر
        پایان
        اگر بالا < ۰:
            بالا = م
        وگرنه:
            فشرده سازی.افزودن بایت(خروجی، بالا * ۱۶ + م)
            بالا = -۱
        پایان
    پایان
    برگشت خروجی
پایان

تابع ریشه:
    ر := از هگز(نمونه)
    ناپایا قفل‌شده := بایگانی.بازکردن آر ای آر(ر.داده، ر.طول، "")
    ناپایا نام‌ها := بایگانی.مدخل‌های آر ای آر(قفل‌شده)
    سرچاپ نام‌ها.طول()، بایگانی.متن وضعیت آر ای آر(قفل‌شده.وضعیت)
    بایگانی.آزادسازی فهرست(نام‌ها)

    ناپایا اشتباه := بایگانی.بازکردن آر ای آر(ر.داده، ر.طول، "guess")
    نام‌ها = بایگانی.مدخل‌های آر ای آر(اشتباه)
    سرچاپ نام‌ها.طول()، اشتباه.وضعیت == بایگانی.آر ای آر گذرواژه اشتباه
    بایگانی.آزادسازی فهرست(نام‌ها)

    ناپایا باز := بایگانی.بازکردن آر ای آر(ر.داده، ر.طول، "secret")
    نام‌ها = بایگانی.مدخل‌های آر ای آر(باز)
    هر م در نام‌ها:
        داده := بایگانی.خواندن از آر ای آر(باز، م.نام، ۰)
        سرچاپ م.نام، م.اندازه، داده.طول، بایگانی.متن وضعیت آر ای آر(باز.وضعیت)
    پایان
    بایگانی.آزادسازی فهرست(نام‌ها)
    سرچاپ بایگانی.خواندن همه از آر ای آر(باز، "unlocked")، بایگانی.متن وضعیت آر ای آر(باز.وضعیت)
پایان
خروجی0 encrypted data and no password 0 true n1.txt 352 352 ok n2.txt 348 348 ok 2 ok

پایاها و متغیرها

هفت زد موفق SEVENZIP_OK

پایا هفت زد موفق: صحیح۳۲ = 0
همه چیز درست پیش رفت.

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

هفت زد یافت نشد SEVENZIP_NOT_FOUND

پایا هفت زد یافت نشد: صحیح۳۲ = 1
مدخلی با نام خواسته‌شده نیست.

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

هفت زد پشتیبانی نمی شود SEVENZIP_UNSUPPORTED

پایا هفت زد پشتیبانی نمی شود: صحیح۳۲ = 2
بایگانی چیزی را به کار برده که پشتیبانی نمی‌شود: روشی که این بسته نمی‌شناسد، نسخه‌ی تازه‌تر قالب، یا تنظیم AES که برای پذیرش بیش از حد کند است.

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

هفت زد رمزگذاری شده SEVENZIP_ENCRYPTED

پایا هفت زد رمزگذاری شده: صحیح۳۲ = 3
داده یا سرآیندها رمزگذاری شده‌اند و گذرواژه‌ای داده نشده.

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

هفت زد خراب SEVENZIP_CORRUPT

پایا هفت زد خراب: صحیح۳۲ = 4
بایگانی خراب یا ناقص است.

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

هفت زد چک جمع ناهمخوان SEVENZIP_BAD_CRC

پایا هفت زد چک جمع ناهمخوان: صحیح۳۲ = 5
یک چک‌جمع نمی‌خواند: سرآیند امضا، سرآیند، یک پوشه‌ی فشرده یا یک پرونده.

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

هفت زد بیش از حد بزرگ SEVENZIP_TOO_BIG

پایا هفت زد بیش از حد بزرگ: صحیح۳۲ = 6
مدخل از max داده‌شده بزرگ‌تر است، یا در فراخوانی‌های درون حافظه مدخلی بیش از cap داده‌شده یا بیش از آنچه یک بافر نگه می‌دارد (حدود دو گیبی‌بایت)؛ در فراخوانی‌های SevenZipFile مدخلی بیش از cap یا کدگشایی که بیش از memcap بخواهد.

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

هفت زد مسیر ناامن SEVENZIP_UNSAFE_PATH

پایا هفت زد مسیر ناامن: صحیح۳۲ = 7
نام یک مدخل از پوشه‌ی مقصد بیرون می‌زند (بخش .. یا مسیر مطلق). استخراج آن را رد می‌کند و ادامه می‌دهد.

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

هفت زد گذرواژه اشتباه SEVENZIP_BAD_PASSWORD

پایا هفت زد گذرواژه اشتباه: صحیح۳۲ = 8
گذرواژه‌ی داده‌شده داده را رمزگشایی نمی‌کند.

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

هفت زد خطای پرونده SEVENZIP_IO

پایا هفت زد خطای پرونده: صحیح۳۲ = 10
خواندن یا نوشتن پرونده شدنی نبود.

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

تار موفق TAR_OK

پایا تار موفق: صحیح۳۲ = 0
وضعیت: فراخوانی موفق بود.

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

تار یافت نشد TAR_NOT_FOUND

پایا تار یافت نشد: صحیح۳۲ = 1
وضعیت: مدخل پرونده‌ی معمولی نیست و چیزی برای باز کردن ندارد.

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

تار خراب TAR_CORRUPT

پایا تار خراب: صحیح۳۲ = 4
وضعیت: بایگانی خراب یا ناقص است.

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

تار بیش از حد بزرگ TAR_TOO_BIG

پایا تار بیش از حد بزرگ: صحیح۳۲ = 6
وضعیت: مدخلی از cap داده‌شده بزرگ‌تر است.

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

تار خطای ورودی خروجی TAR_IO

پایا تار خطای ورودی خروجی: صحیح۳۲ = 7
وضعیت: پرونده‌ای باز، خوانده یا نوشته نشد.

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

تار مسیر ناامن TAR_UNSAFE_PATH

پایا تار مسیر ناامن: صحیح۳۲ = 8
وضعیت: نام مدخل یا مقصد پیوند از پوشه‌ی مقصد بیرون می‌رود و آن مدخل رد شد.

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

زیپ موفق ZIP_OK

پایا زیپ موفق: صحیح۳۲ = 0
وضعیت: مدخل بیرون آمد و چک‌جمعش خواند.
archive-ZipVerify.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    متن := "سلام بایگانی، سلام بایگانی، سلام بایگانی"
    ب := فشرده سازی.بافر از رشته(متن)
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("a.txt"، ب.داده، ب.طول، 0))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("b.txt"، ب.داده، 5، 8))
    ز := بایگانی.ساخت زیپ(پرونده‌ها)
    ناپایا وضعیت := 0
    ناپایا بررسی‌شده := 0
    سالم := بایگانی.استخراج تایید شده از زیپ(ز.داده، ز.طول، "a.txt"، 0، وضعیت)
    سرچاپ وضعیت برابر بایگانی.زیپ موفق، سالم.طول، بایگانی.بررسی زیپ(ز.داده، ز.طول، بررسی‌شده)، بررسی‌شده

    نشانگر := ز.داده برگردان طبیعی۸*
    نشانگر[35] = 0x58 برگردان طبیعی۸
    خراب := بایگانی.استخراج تایید شده از زیپ(ز.داده، ز.طول، "a.txt"، 0، وضعیت)
    سرچاپ وضعیت برابر بایگانی.زیپ چک جمع ناهمخوان، خراب.طول، بایگانی.متن وضعیت زیپ(وضعیت)
    ناپایا خوب := نادرست
    ساده := بایگانی.استخراج با نام از زیپ(ز.داده، ز.طول، "a.txt"، خوب)
    سرچاپ خوب، ساده.طول
    سرچاپ بایگانی.بررسی زیپ(ز.داده، ز.طول، بررسی‌شده)، بررسی‌شده
    ناپایا شکسته := بایگانی.مدخل های خراب زیپ(ز.داده، ز.طول)
    هر م در شکسته:
        سرچاپ "خراب:"، م.نام
    پایان
    بایگانی.آزادسازی فهرست(شکسته)
    _ := بایگانی.استخراج تایید شده از زیپ(ز.داده، ز.طول، "missing.txt"، 0، وضعیت)
    سرچاپ وضعیت برابر بایگانی.زیپ یافت نشد، بایگانی.متن وضعیت زیپ(وضعیت)
پایان
خروجیtrue 75 0 2 true 0 checksum mismatch true 75 1 2 خراب: a.txt true entry not found

زیپ یافت نشد ZIP_NOT_FOUND

پایا زیپ یافت نشد: صحیح۳۲ = 1
وضعیت: مدخلی با این نام نیست.

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

زیپ پشتیبانی نمی شود ZIP_UNSUPPORTED

پایا زیپ پشتیبانی نمی شود: صحیح۳۲ = 2
وضعیت: روش فشرده‌سازی‌ای جز ۰ و ۸.

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

زیپ رمزگذاری شده ZIP_ENCRYPTED

پایا زیپ رمزگذاری شده: صحیح۳۲ = 3
وضعیت: مدخل رمزدار است.

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

زیپ خراب ZIP_CORRUPT

پایا زیپ خراب: صحیح۳۲ = 4
وضعیت: داده خراب یا بریده است، یا زیپ نیست، یا اندازه‌اش نمی‌خواند.

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

زیپ چک جمع ناهمخوان ZIP_BAD_CRC

پایا زیپ چک جمع ناهمخوان: صحیح۳۲ = 5
وضعیت: مدخل بیرون آمد ولی CRC-32 آن با مقدار درون بایگانی نمی‌خواند.

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

زیپ بیش از حد بزرگ ZIP_TOO_BIG

پایا زیپ بیش از حد بزرگ: صحیح۳۲ = 6
وضعیت: مدخل از max (یا cap) داده‌شده بزرگ‌تر است، یا در تابع‌های درون‌حافظه‌ای از ۲ گیگابایت.

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

زیپ خطای ورودی خروجی ZIP_IO

پایا زیپ خطای ورودی خروجی: صحیح۳۲ = 7
وضعیت: پرونده‌ای باز، خوانده یا نوشته نشد.

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

زیپ مسیر ناامن ZIP_UNSAFE_PATH

پایا زیپ مسیر ناامن: صحیح۳۲ = 8
وضعیت: نام مدخل مطلق است یا با .. از پوشه‌ی مقصد بیرون می‌رود و چیزی برایش نوشته نشد.

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

زیپ قطعه گم ZIP_MULTIVOLUME

پایا زیپ قطعه گم: صحیح۳۲ = 9
وضعیت: این زیپ یک قطعه از بایگانی چندقطعه‌ای است و قطعه‌ی دیگری گم شده (یا .zipی که می‌گوید دیسک‌های قبلی دارد بدون آن‌ها باز شده است).
archive-ZipSplit.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی سیستم عامل

تابع ریشه:
    ناپایا داده := فشرده سازی.بافر بایت جدید با ظرفیت(150000)
    تکرار 150000 در شمارنده:
        فشرده سازی.افزودن بایت(داده، 65 + شمارنده % 23)
    پایان
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("big.bin"، داده.داده، داده.طول، 0))
    سرچاپ بایگانی.ساخت پرونده زیپ چندقطعه ای(پرونده‌ها، "split.zip"، 65536 برگردان صحیح۶۴، بایگانی.زیپ قطعه دیسکی)
    پرونده‌ها.آزادکن()
    فشرده سازی.آزادسازی بافر(داده)

    ناپایا پرونده_زیپ := بایگانی.بازکردن پرونده زیپ("split.zip")
    سرچاپ پرونده_زیپ.وضعیت برابر بایگانی.زیپ موفق، پرونده_زیپ.شمار، پرونده_زیپ.قطعه ها.طول()
    سرچاپ بایگانی.استخراج از پرونده زیپ به پرونده(پرونده_زیپ، "big.bin"، "big.out"، 0 برگردان صحیح۶۴) برابر بایگانی.زیپ موفق، سیستم عامل.اندازه پرونده("big.out")
    بایگانی.بستن پرونده زیپ(پرونده_زیپ)
    سیستم عامل.حذف("big.out")
    سیستم عامل.حذف("split.z01")
    سیستم عامل.حذف("split.z02")
    سیستم عامل.حذف("split.zip")
پایان
خروجیtrue true 1 3 true 150000

زیپ گذرواژه اشتباه ZIP_BAD_PASSWORD

پایا زیپ گذرواژه اشتباه: صحیح۳۲ = 11
گذرواژه با مدخل رمزگذاری‌شده نمی‌خواند.
archive-ZipPassword.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی سیستم عامل

پایا HEX := """
504b03041400090008008e48695d898d35803c0100001a0e000005001c00742e74787455540900039c8cf16a9c8cf16a7578
0b000104e903000004e9030000d1f0d56c6d77a28b2c8bf0eb428f8e10e5e2e8b537f0c08b7098af8bf029e1019ab6418c85
29642a576991cd4b6e9b58c19964a4289b96cc6d03b252711d16c78345911dd3b4a42f5941f5b7973607785e47cd00f0c04e
108f76d066cdf3849b3057f9a1153a4d5cd3baa4d1ba0f8423075418234d58c37243b860cf1765cfe9e4f68a905e97fcea1d
3d8078e4ec86af4d4ab806be237be2dbfa7ca7d4275de84a2a5b14cb24a662b01de7cd6ec90e07a443d7b5a1a6c6bb93dae4
163048cb7858f109e1b86f8979a030523faf2a0ffc1418d3677de5d8d63b83a13d8e3678662ede71b68ea595f7f6c5d72fad
c07efab5cb2961d3ea1be139b99bad89180780c7bf434938afbaccfb872ddc1cc576a22b4a9b7588c2fb89d6471cc64260ba
10dada13ce9f424b7be9845a6ae2a5d46ac0f2847078ab7b9d68cdef32504b0708898d35803c0100001a0e0000504b03040a
00090000008e48695d5f0e2f63380100002c01000005001c006e2e62696e55540900039c8cf16a9c8cf16a75780b000104e9
03000004e903000008affb7424492bfe472c296bd4c1dd298f16ef4d0804791cbac1903adbf3baafe39a4279cd76aa8a8b7f
2775e9b747ec50253a355142ec3bb4fa26280ac927900bf382899dae8a90f97fee5b84bafe72e7920263af4dd0b5723703b2
a3b6f4b039e300951f75977d239f5dd1d696e87326a4ca821b61d1922cd22d6d848afd37d5c62fc6f999f53a875dab5f53e7
9fdaffa02bce9d0cafbc49abf967a76095830941e78c509e3bb77318369281375f6cc4224503226bfe1f299eb692920a6863
88953c4eff9540453314b04783ce56f22a3a7484f77493aed1e2edbb0e8473039e8e1dc07278ec3523ec104bf1df862f4b11
5e602276d720eb296bdebb66e0120f5d9e9ce6afbd5d24cf2b1f79191427036849ce561dc8d08b8350db994713a1ed390863
e8fc83728c1255abf786a5ea9034d2b4d6b1c9f3504b07085f0e2f63380100002c010000504b01021e031400090008008e48
695d898d35803c0100001a0e0000050018000000000001000000a48100000000742e74787455540500039c8cf16a75780b00
0104e903000004e9030000504b01021e030a00090000008e48695d5f0e2f63380100002c0100000500180000000000000000
00a4818b0100006e2e62696e55540500039c8cf16a75780b000104e903000004e9030000504b050600000000020002009600
0000120300000000
"""

تابع unhex(s: رشته): فشرده سازی.بافر بایت:
    ناپایا بافر_محلی := فشرده سازی.بافر بایت جدید()
    نشانگر_بایت := s برگردان طبیعی۸*
    ناپایا بالا := -1
    تکرار s.طول() در شمارنده:
        نویسه := نشانگر_بایت[شمارنده] برگردان صحیح
        ناپایا مقدار_محلی := -1
        اگر نویسه بزرگتربرابر 48 و نویسه کوچکتربرابر 57:
            مقدار_محلی = نویسه - 48
        وگرنه نویسه بزرگتربرابر 97 و نویسه کوچکتربرابر 102:
            مقدار_محلی = نویسه - 87
        پایان
        اگر مقدار_محلی کوچکتر 0:
            گذر
        پایان
        اگر بالا کوچکتر 0:
            بالا = مقدار_محلی
        وگرنه:
            فشرده سازی.افزودن بایت(بافر_محلی، بالا * 16 + مقدار_محلی)
            بالا = -1
        پایان
    پایان
    برگشت بافر_محلی
پایان

تابع ریشه:
    بایگانی.نوشتن پرونده دودویی از بافر("secret.zip"، unhex(HEX))
    ناپایا پرونده_زیپ := بایگانی.بازکردن پرونده زیپ("secret.zip")
    سرچاپ بایگانی.استخراج از پرونده زیپ به پرونده(پرونده_زیپ، "t.txt"، "t.out"، 0 برگردان صحیح۶۴) برابر بایگانی.زیپ رمزگذاری شده
    بایگانی.تنظیم گذرواژه پرونده زیپ(پرونده_زیپ، "nope")
    سرچاپ بایگانی.استخراج از پرونده زیپ به پرونده(پرونده_زیپ، "t.txt"، "t.out"، 0 برگردان صحیح۶۴) برابر بایگانی.زیپ گذرواژه اشتباه
    بایگانی.تنظیم گذرواژه پرونده زیپ(پرونده_زیپ، "pw123")
    سرچاپ بایگانی.استخراج از پرونده زیپ به پرونده(پرونده_زیپ، "t.txt"، "t.out"، 0 برگردان صحیح۶۴) برابر بایگانی.زیپ موفق
    بایگانی.بستن پرونده زیپ(پرونده_زیپ)
    سیستم عامل.حذف("secret.zip")
    سیستم عامل.حذف("t.out")
پایان
خروجیtrue true true

روش زیپ ذخیره ZipMethodStore

پایا روش زیپ ذخیره: صحیح۳۲ = 0
روش زیپ ۰: داده همان‌طور که هست ذخیره می‌شود.
archive-ZipMethods.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی رشته

تابع ریشه:
    ناپایا متن := فشرده سازی.بافر بایت جدید()
    تکرار 80 در شمارنده:
        خط := "line " + رشته.از عدد(شمارنده * 7 % 23) + ": zip entries can use several methods\n"
        فشرده سازی.افزودن بایت‌ها(متن، خط برگردان تهی*، خط.طول())
    پایان
    سرچاپ "متن:"، متن.طول، "بایت"
    نام‌ها := ["ذخیره"، "دیفلیت"، "بی‌زیپ۲"، "الزد ام ای"، "زد استاندارد"]
    متغیر_methods := [بایگانی.روش زیپ ذخیره، بایگانی.روش زیپ دیفلیت، بایگانی.روش زیپ بی زیپ دو، بایگانی.روش زیپ الزد ام ای، بایگانی.روش زیپ زد استاندارد]
    تکرار 5 در شمارنده:
        ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
        پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("notes.txt"، متن.داده، متن.طول، متغیر_methods[شمارنده]))
        زد := بایگانی.ساخت زیپ(پرونده‌ها)
        ناپایا متغیر_checked := 0
        ناپایا وضعیت := 0
        بازگشت := بایگانی.استخراج تایید شده از زیپ(زد.داده، زد.طول، "notes.txt"، 0، وضعیت)
        سرچاپ نام‌ها[شمارنده]، "روش"، متغیر_methods[شمارنده]، "زیپ"، زد.طول، "بایت، بررسی"، بایگانی.بررسی زیپ(زد.داده، زد.طول، متغیر_checked)، "متن یکسان"، وضعیت برابر 0 و فشرده سازی.برابری بافر(بازگشت، متن)
    پایان

    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ با سطح("fast.txt"، متن.داده، متن.طول، بایگانی.روش زیپ زد استاندارد، 1))
    ناپایا بهترین := بایگانی.ساخت ورودی پرونده زیپ("best.txt"، متن.داده، متن.طول، بایگانی.روش زیپ زد استاندارد)
    بهترین.سطح = 19
    پرونده‌ها.بیفزا(بهترین)
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("empty.txt"، پوچ، 0، بایگانی.روش زیپ بی زیپ دو))
    زد := بایگانی.ساخت زیپ(پرونده‌ها)
    ناپایا ورودی‌ها := بایگانی.فهرست زیپ(زد.داده، زد.طول)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، "روش"، عنصر.روش، عنصر.اندازه، "←"، عنصر.اندازه فشرده
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)
پایان
خروجیمتن: 3565 بایت ذخیره روش 0 زیپ 3681 بایت، بررسی 0 متن یکسان true دیفلیت روش 8 زیپ 251 بایت، بررسی 0 متن یکسان true بی‌زیپ۲ روش 12 زیپ 297 بایت، بررسی 0 متن یکسان true الزد ام ای روش 14 زیپ 252 بایت، بررسی 0 متن یکسان true زد استاندارد روش 93 زیپ 270 بایت، بررسی 0 متن یکسان true fast.txt روش 93 3565 ← 154 best.txt روش 93 3565 ← 142 empty.txt روش 0 0 ← 0

روش زیپ دیفلیت ZipMethodDeflate

پایا روش زیپ دیفلیت: صحیح۳۲ = 8
روش زیپ ۸: DEFLATE.

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

روش زیپ دیفلیت۶۴ ZipMethodDeflate64

پایا روش زیپ دیفلیت۶۴: صحیح۳۲ = 9
روش زیپ ۹: دیفلیت ۶۴، گونه‌ای از DEFLATE در 7-Zip و ویندوز با پنجره ۶۴ کیلوبایتی و تطبیق‌های بلندتر. زیپ‌هایی که این روش دارند خوانده می‌شوند ولی نوشته نمی‌شوند: خواستن روش ۹ در ZipCreate فایل را ذخیره می‌کند.
archive-ZipDeflate64.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع hex_val(c: صحیح): صحیح:
    اگر c بزرگتربرابر 97: برگشت c - 87 پایان
    برگشت c - 48
پایان

تابع unhex(h: رشته): فشرده سازی.بافر بایت:
    ناپایا بافر_محلی := فشرده سازی.بافر بایت جدید()
    نشانگر_بایت := h برگردان طبیعی۸*
    ناپایا شمارنده := 0
    تا شمارنده + 1 کوچکتر h.طول():
        فشرده سازی.افزودن بایت(بافر_محلی، hex_val(نشانگر_بایت[شمارنده] برگردان صحیح) * 16 + hex_val(نشانگر_بایت[شمارنده + 1] برگردان صحیح))
        شمارنده += 2
    پایان
    برگشت بافر_محلی
پایان

تابع ریشه:
    زد := unhex("504b03041500000009008044695dba1f6638250000003200000005000000742e74787485c8b10d00400405d0fea630c095621f89af1285686c6f04af7c060f6d0813b26b3e5df116504b01023f031500000009008044695dba1f66382500000032000000050024000000000000002080a48100000000742e7478740a00200000000000010018007dda1d582570dd0100000000000000000000000000000000504b0506000000000100010057000000480000000000")
    ناپایا ورودی‌ها := بایگانی.فهرست زیپ(زد.داده، زد.طول)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه، عنصر.اندازه فشرده، عنصر.روش برابر بایگانی.روش زیپ دیفلیت۶۴
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)
    ناپایا وضعیت := 0
    متن := بایگانی.استخراج تایید شده از زیپ(زد.داده، زد.طول، "t.txt"، 0، وضعیت)
    سرچاپ وضعیت برابر بایگانی.زیپ موفق، فشرده سازی.بافر به رشته(متن)
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("t.txt"، متن.داده، متن.طول، بایگانی.روش زیپ دیفلیت۶۴))
    متغیر_written := بایگانی.ساخت زیپ(پرونده‌ها)
    ناپایا بازگشت := بایگانی.فهرست زیپ(متغیر_written.داده، متغیر_written.طول)
    سرچاپ "written with method"، بازگشت.بگیر(0).روش
    بایگانی.آزادسازی فهرست(بازگشت)
پایان
خروجیt.txt 50 37 true true deflate64 entry, deflate64 entry, deflate64 entry written with method 0

روش زیپ بی زیپ دو ZipMethodBzip2

پایا روش زیپ بی زیپ دو: صحیح۳۲ = 12
روش زیپ ۱۲: bzip2. هر خواننده‌ی زیپی که بیش از DEFLATE بداند آن را می‌خواند.

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

روش زیپ الزد ام ای ZipMethodLzma

پایا روش زیپ الزد ام ای: صحیح۳۲ = 14
روش زیپ ۱۴: LZMA. 7-Zip و پایتون می‌خوانند، unzip بسته‌ی Info-ZIP نه.

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

روش زیپ زد استاندارد ZipMethodZstd

پایا روش زیپ زد استاندارد: صحیح۳۲ = 93
روش زیپ ۹۳: زد استاندارد. نسخه‌های تازه‌ی 7-Zip و پایتون ۳٫۱۴ می‌خوانند، unzip بسته‌ی Info-ZIP نه.

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

رمزگذاری زیپ خودکار ZipEncAuto

پایا رمزگذاری زیپ خودکار: صحیح۳۲ = 0
رمزگذاری ۰: اگر مدخل گذرواژه داشته باشد AES-256.
archive-WriteStream.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی مسیر پرونده
واردسازی سیستم عامل

تابع same(path: رشته، want: فشرده سازی.بافر بایت): منطقی:
    ناپایا موفق := نادرست
    گرفته := بایگانی.خواندن پرونده دودویی(path، موفق)
    برگشت موفق و فشرده سازی.برابری بافر(گرفته، want)
پایان

تابع ریشه:
    پوشه := مسیر پرونده.پیوند(سیستم عامل.پوشه موقت()، "salam_write_example")
    سیستم عامل.حذف همه(پوشه)
    سیستم عامل.ساخت پوشه ها(پوشه)
    ساده := مسیر پرونده.پیوند(پوشه، "notes.txt")
    بازگشت := مسیر پرونده.پیوند(پوشه، "back.bin")
    متن := فشرده سازی.بافر از رشته("Salam keeps notes in plain files. ".تکرار(2000))
    بایگانی.نوشتن پرونده دودویی از بافر(ساده، متن)
    بایگانی.تنظیم اندازه قطعه نوشتن(16384)

    سرچاپ "جی زیپ:"، بایگانی.فشرده سازی پرونده جی زیپ(ساده، مسیر پرونده.پیوند(پوشه، "n.gz"))، بایگانی.کدگشایی پرونده جی زیپ(مسیر پرونده.پیوند(پوشه، "n.gz")، بازگشت)، same(بازگشت، متن)
    سرچاپ "بی زیپ دو، سطح ۱:"، بایگانی.فشرده سازی پرونده بی زیپ دو با سطح(ساده، مسیر پرونده.پیوند(پوشه، "n.bz2")، 1)، بایگانی.کدگشایی پرونده بی زیپ دو(مسیر پرونده.پیوند(پوشه، "n.bz2")، بازگشت)، same(بازگشت، متن)
    سرچاپ "ایکس زد، سطح ۹:"، بایگانی.فشرده سازی پرونده ایکس زد با سطح(ساده، مسیر پرونده.پیوند(پوشه، "n.xz")، 9)، بایگانی.کدگشایی پرونده ایکس زد(مسیر پرونده.پیوند(پوشه، "n.xz")، بازگشت)، same(بازگشت، متن)
    سرچاپ "الزد ام ای، سطح ۳:"، بایگانی.فشرده سازی پرونده الزد ام ای با سطح(ساده، مسیر پرونده.پیوند(پوشه، "n.lzma")، 3)، بایگانی.کدگشایی پرونده الزد ام ای(مسیر پرونده.پیوند(پوشه، "n.lzma")، بازگشت)، same(بازگشت، متن)

    ناپایا متغیر_tar_files := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    متغیر_tar_files.بیفزا(بایگانی.ساخت ورودی پرونده تار از مسیر("docs/notes.txt"، ساده))
    متغیر_tar_files.بیفزا(بایگانی.ساخت ورودی پرونده تار("docs/hello.txt"، "hello" برگردان تهی*، 5، نادرست))
    متغیر_tgz := مسیر پرونده.پیوند(پوشه، "n.tar.zst")
    سرچاپ "تار زستد:"، بایگانی.ساخت پرونده تار زستد با سطح(متغیر_tar_files، متغیر_tgz، 5)

    ناپایا متغیر_zip_files := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    متغیر_zip_files.بیفزا(بایگانی.ساخت ورودی پرونده زیپ از مسیر("notes.txt"، ساده، بایگانی.روش زیپ دیفلیت، 0))
    متغیر_secret := "top secret"
    متغیر_zip_files.بیفزا(بایگانی.ساخت ورودی پرونده زیپ رمزدار("secret.txt"، متغیر_secret برگردان تهی*، متغیر_secret.طول()، بایگانی.روش زیپ دیفلیت، 0، "pass"، بایگانی.رمزگذاری زیپ خودکار))
    متغیر_zpath := مسیر پرونده.پیوند(پوشه، "n.zip")
    سرچاپ "زیپ:"، بایگانی.ساخت پرونده زیپ(متغیر_zip_files، متغیر_zpath)، بایگانی.ساخت پرونده زیپ بزرگ(متغیر_zip_files، مسیر پرونده.پیوند(پوشه، "n64.zip"))
    ناپایا پرونده_زیپ := بایگانی.بازکردن پرونده زیپ(متغیر_zpath)
    سرچاپ "مدخل‌ها:"، پرونده_زیپ.شمار، "وضعیت:"، پرونده_زیپ.وضعیت
    سرچاپ "بدون گذرواژه:"، بایگانی.استخراج از پرونده زیپ به پرونده(پرونده_زیپ، "secret.txt"، بازگشت، 0 برگردان صحیح۶۴) برابر بایگانی.زیپ رمزگذاری شده
    بایگانی.تنظیم گذرواژه پرونده زیپ(پرونده_زیپ، "pass")
    سرچاپ "با گذرواژه:"، بایگانی.استخراج از پرونده زیپ به پرونده(پرونده_زیپ، "secret.txt"، بازگشت، 0 برگردان صحیح۶۴) برابر بایگانی.زیپ موفق، same(بازگشت، فشرده سازی.بافر از رشته(متغیر_secret))
    بایگانی.بستن پرونده زیپ(پرونده_زیپ)

    ناپایا متغیر_sz_files := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده هفت زد>
    متغیر_sz_files.بیفزا(بایگانی.ساخت ورودی پرونده هفت زد از مسیر("notes.txt"، ساده))
    متغیر_szpath := مسیر پرونده.پیوند(پوشه، "n.7z")
    سرچاپ "هفت زد، سطح ۵:"، بایگانی.ساخت پرونده هفت زد با سطح(متغیر_sz_files، متغیر_szpath، 5)
    ناپایا پرونده_هفت := بایگانی.بازکردن پرونده هفت زد(متغیر_szpath، "")
    سرچاپ "استخراج هفت زد:"، بایگانی.استخراج از پرونده هفت زد به پرونده(پرونده_هفت، "notes.txt"، بازگشت، 0 برگردان صحیح۶۴، 0 برگردان صحیح۶۴)، same(بازگشت، متن)
    بایگانی.بستن پرونده هفت زد(پرونده_هفت)
    سیستم عامل.حذف همه(پوشه)
پایان
خروجیجی زیپ: true true true بی زیپ دو، سطح ۱: true true true ایکس زد، سطح ۹: true true true الزد ام ای، سطح ۳: true true true تار زستد: true زیپ: true true مدخل‌ها: 2 وضعیت: 0 بدون گذرواژه: true با گذرواژه: true true هفت زد، سطح ۵: true استخراج هفت زد: 0 true

رمزگذاری زیپ کریپتو ZipEncZipCrypto

پایا رمزگذاری زیپ کریپتو: صحیح۳۲ = 1
رمزگذاری ۱: رمزگذاری قدیمی زیپ (ZipCrypto) که ضعیف است و فقط برای خواننده‌های قدیمی.

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

رمزگذاری زیپ ای ای اس۱۲۸ ZipEncAes128

پایا رمزگذاری زیپ ای ای اس۱۲۸: صحیح۳۲ = 2
رمزگذاری ۲: AES وین‌زیپ با کلید ۱۲۸ بیتی.

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

رمزگذاری زیپ ای ای اس۱۹۲ ZipEncAes192

پایا رمزگذاری زیپ ای ای اس۱۹۲: صحیح۳۲ = 3
رمزگذاری ۳: AES وین‌زیپ با کلید ۱۹۲ بیتی.

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

رمزگذاری زیپ ای ای اس۲۵۶ ZipEncAes256

پایا رمزگذاری زیپ ای ای اس۲۵۶: صحیح۳۲ = 4
رمزگذاری ۴: AES وین‌زیپ با کلید ۲۵۶ بیتی.

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

زیپ قطعه دیسکی ZipSplitDisk

پایا زیپ قطعه دیسکی: صحیح۳۲ = 0
شیوه‌ی ZipCreateFileSplit: قطعه‌های .z01، .z02 که با .zip تمام می‌شوند.

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

زیپ قطعه بایتی ZipSplitByte

پایا زیپ قطعه بایتی: صحیح۳۲ = 1
شیوه‌ی ZipCreateFileSplit: بایگانی ساخته‌شده بریده‌شده به .zip.001، .zip.002 و ...

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

بایگانی موفق ARCHIVE_OK

پایا بایگانی موفق: صحیح۳۲ = 0
کد وضعیت: موفق.

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

بایگانی یافت نشد ARCHIVE_NOT_FOUND

پایا بایگانی یافت نشد: صحیح۳۲ = 1
کد وضعیت: مدخل در بایگانی نیست.

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

بایگانی پشتیبانی نمی شود ARCHIVE_UNSUPPORTED

پایا بایگانی پشتیبانی نمی شود: صحیح۳۲ = 2
کد وضعیت: قالب، روش یا ویژگی پشتیبانی نمی‌شود.

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

بایگانی رمزگذاری شده ARCHIVE_ENCRYPTED

پایا بایگانی رمزگذاری شده: صحیح۳۲ = 3
کد وضعیت: داده رمزگذاری شده و گذرواژه‌ای داده نشده است.

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

بایگانی خراب ARCHIVE_CORRUPT

پایا بایگانی خراب: صحیح۳۲ = 4
کد وضعیت: داده خراب است. برای پرونده‌ی gzip، bzip2 یا xz یعنی داده از سقف max_total بزرگ‌تر است.

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

بایگانی چک جمع ناهمخوان ARCHIVE_BAD_CRC

پایا بایگانی چک جمع ناهمخوان: صحیح۳۲ = 5
کد وضعیت: چک‌جمع جور نیست.

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

بایگانی بیش از حد بزرگ ARCHIVE_TOO_BIG

پایا بایگانی بیش از حد بزرگ: صحیح۳۲ = 6
کد وضعیت: یک مدخل یا مجموع از سقف بزرگ‌تر است.

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

بایگانی مسیر ناامن ARCHIVE_UNSAFE_PATH

پایا بایگانی مسیر ناامن: صحیح۳۲ = 7
کد وضعیت: نام، پیوند یا مدخل دستگاه می‌تواند از پوشه‌ی مقصد بیرون برود؛ هیچ چیز نوشته نمی‌شود.

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

بایگانی گذرواژه اشتباه ARCHIVE_BAD_PASSWORD

پایا بایگانی گذرواژه اشتباه: صحیح۳۲ = 8
کد وضعیت: گذرواژه نادرست است.

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

بایگانی چند بخشی ARCHIVE_MULTIVOLUME

پایا بایگانی چند بخشی: صحیح۳۲ = 9
کد وضعیت: یکی از بخش‌های بایگانی چندبخشی نیست.

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

بایگانی خطای ورودی خروجی ARCHIVE_IO_ERROR

پایا بایگانی خطای ورودی خروجی: صحیح۳۲ = 10
کد وضعیت: پرونده خوانده یا نوشته نشد.

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

بایگانی قالب ناشناخته ARCHIVE_UNKNOWN_FORMAT

پایا بایگانی قالب ناشناخته: صحیح۳۲ = 11
کد وضعیت: بایت‌های نخست با هیچ قالب شناخته‌شده‌ای نمی‌خواند.

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

بایگانی مدخل های بسیار ARCHIVE_TOO_MANY_ENTRIES

پایا بایگانی مدخل های بسیار: صحیح۳۲ = 12
کد وضعیت: تعداد مدخل‌ها از max_entries بیشتر است.

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

بایگانی بمب فشرده ARCHIVE_BOMB

پایا بایگانی بمب فشرده: صحیح۳۲ = 13
کد وضعیت: اندازه‌های اعلام‌شده بسیار بزرگ‌تر از خود بایگانی است (بیش از max_ratio).

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

بایگانی پنجره بیش از حد بزرگ ARCHIVE_WINDOW_TOO_BIG

پایا بایگانی پنجره بیش از حد بزرگ: صحیح۳۲ = 14
کد وضعیت: فرهنگ‌لغت یا پنجره‌ی داده‌ی فشرده از سقف حافظه بزرگ‌تر است.

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

قالب ناشناخته FormatUnknown

پایا قالب ناشناخته: صحیح۳۲ = 0
کد قالب: ناشناخته.

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

قالب زیپ FormatZip

پایا قالب زیپ: صحیح۳۲ = 1
کد قالب: زیپ.

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

قالب تار FormatTar

پایا قالب تار: صحیح۳۲ = 2
کد قالب: تار ساده.

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

قالب تار جی زیپ FormatTarGz

پایا قالب تار جی زیپ: صحیح۳۲ = 3
کد قالب: تار فشرده با gzip.

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

قالب تار بی زیپ دو FormatTarBz2

پایا قالب تار بی زیپ دو: صحیح۳۲ = 4
کد قالب: تار فشرده با bzip2.

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

قالب تار ایکس زد FormatTarXz

پایا قالب تار ایکس زد: صحیح۳۲ = 5
کد قالب: تار فشرده با xz.

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

قالب جی زیپ FormatGzip

پایا قالب جی زیپ: صحیح۳۲ = 6
کد قالب: یک پرونده‌ی gzip.

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

قالب بی زیپ دو FormatBzip2

پایا قالب بی زیپ دو: صحیح۳۲ = 7
کد قالب: یک پرونده‌ی bzip2.

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

قالب ایکس زد FormatXz

پایا قالب ایکس زد: صحیح۳۲ = 8
کد قالب: یک پرونده‌ی xz.

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

قالب آر ای آر FormatRar

پایا قالب آر ای آر: صحیح۳۲ = 9
کد قالب: RAR نسخه‌ی 1.5 تا 5.

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

قالب هفت زد FormatSevenZip

پایا قالب هفت زد: صحیح۳۲ = 10
کد قالب: 7z.

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

قالب زد استاندارد FormatZstd

پایا قالب زد استاندارد: صحیح۳۲ = 11
کد قالب: یک پرونده‌ی zstd.

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

قالب تار زد استاندارد FormatTarZstd

پایا قالب تار زد استاندارد: صحیح۳۲ = 12
کد قالب: تار فشرده با zstd.

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

آر ای آر موفق RAR_OK

پایا آر ای آر موفق: صحیح۳۲ = 0
وضعیت: مدخل باز شد و چک‌جمعش درست بود.

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

آر ای آر یافت نشد RAR_NOT_FOUND

پایا آر ای آر یافت نشد: صحیح۳۲ = 1
وضعیت: مدخلی با این نام نیست.

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

آر ای آر پشتیبانی نمی شود RAR_UNSUPPORTED

پایا آر ای آر پشتیبانی نمی شود: صحیح۳۲ = 2
وضعیت: نسخه یا روشی از RAR که این بسته نمی‌تواند باز کند، مثل قالبی از WinRAR جدیدتر از آنچه این بسته می‌شناسد.

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

آر ای آر رمزگذاری شده RAR_ENCRYPTED

پایا آر ای آر رمزگذاری شده: صحیح۳۲ = 3
وضعیت: مدخل یا سرآیندها رمزگذاری شده‌اند و گذرواژه‌ای داده نشده است.

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

آر ای آر خراب RAR_CORRUPT

پایا آر ای آر خراب: صحیح۳۲ = 4
وضعیت: داده خراب یا ناقص است.

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

آر ای آر چک جمع ناهمخوان RAR_BAD_CRC

پایا آر ای آر چک جمع ناهمخوان: صحیح۳۲ = 5
وضعیت: مدخل باز شد ولی CRC-32 آن با مقدار درون بایگانی نمی‌خواند.

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

آر ای آر چند بخشی RAR_MULTIVOLUME

پایا آر ای آر چند بخشی: صحیح۳۲ = 6
وضعیت: مدخل در بخشی ادامه دارد که داده نشده است.

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

آر ای آر بیش از حد بزرگ RAR_TOO_BIG

پایا آر ای آر بیش از حد بزرگ: صحیح۳۲ = 7
وضعیت: مدخل از max داده‌شده بزرگ‌تر است، یا حافظه‌ای بیشتر از حد این بسته می‌خواهد.

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

آر ای آر مسیر ناایمن RAR_UNSAFE_PATH

پایا آر ای آر مسیر ناایمن: صحیح۳۲ = 8
وضعیت: نام مدخل بیرون از پوشه‌ی مقصد می‌نوشت، پس کنار گذاشته شد.

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

آر ای آر گذرواژه اشتباه RAR_BAD_PASSWORD

پایا آر ای آر گذرواژه اشتباه: صحیح۳۲ = 9
وضعیت: گذرواژه اشتباه است (یا در RAR 3 و 4 داده خراب است).

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

آر ای آر پنجره بیش از حد بزرگ RAR_WINDOW_TOO_BIG

پایا آر ای آر پنجره بیش از حد بزرگ: صحیح۳۲ = 10
وضعیت: داده دورتر از پنجره‌ای که رمزگشا می‌تواند نگه دارد (کوچک‌تر از memcap و ۱ گیبی‌بایت) را نشانه می‌رود، یا memcap کمتر از ۱۲۸ کیبی‌بایت است. memcap را تا ۱ گیبی‌بایت بالا ببرید یا با ابزار دیگری باز کنید.
archive-RarFileSet.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی مسیر پرونده
واردسازی حافظه
واردسازی سیستم عامل

پایا PART1 := """
526172211a0701006de128270b01050701060101808080000cf698c92602130b950804b60ea48302e3916346800001086e6f
74652e7478740a03132f8df16a8b8429036469736b2073747265616d20766f6c756d6520766f6c756d652072617220726172
2062797465207061636b2073616c616d20766f6c756d652073747265616d206469736b2073747265616d2073616c616d2076
6f6c756d652073747265616d2073747265616d207061636b2073616c616d207061636b206469736b20726172207061636b20
6469736b207061636b206469736b2072617220726172207261722073616c616d2073616c616d207261722073747265616d20
627974652073747265616d2073616c616d2062797465207061636b206469736b2062797465207061636b2073616c616d2076
6f6c756d6520726172207061636b20726172207061636b2062797465206469736b2073616c616d206279746520766f6c756d
6520726172206469736b20766f6c756d6520766f6c756d6520627974652073616c616d20726172207061636b2073616c616d
206469736b2073616c616d206469736b2062797465206469736b207261722073616c616d20726172206469736b207061636b
20627974652073616c616d2073747265616d2073616c616d2073616c616d20627974652073747265616d2072617220627974
652072617220766f6c756d652073616c616d2073616c616d207261722073747265616d2073616c616d2073747265616d2073
616c616d2073747265616d206469736b2073747265616d20726172206469736b2073616c616d206469736b20726172207061
636b20627974652073616c616d207061636b2073747265616d20726172207261722073747265616d207061636b2073616c61
6d2073616c616d20766f6c756d652073747265616d207061636b2073747265616d206279746520726172207061636b20766f
6c756d65207061636b2073747265616d2073616c616d2073616c616d2062797465207061636b206469736b20726172207261
722073747265616d2073747265616d2073616c616d207061636b20766f6c756d652062797465207061636b2073747265616d
2073747265616d2073747265616d2062797465207061636b2073616c616d206279746520766f6c756d652073616c616d2062
7974652073747265616d20766f6c756d65206469736b20726172206469736b207261722073747265616d207061636b207361
6c616d206469736b20627974652073747265616d20766f6c756d652073616c616d206469736b2073616c616d207261722072
6172206469736b20766f6c756d6520766f6c756d6520627974652073616c616d20766f6c756d65207061636b20766f6c756d
652073616c616d2073747265616d20627974652073616c616d2073616c616d206469736b20627974652073747265616d2062
797465206469736b206469736b20766f6c756d65207061636b2062797465207261722073747265616d207061636b2073616c
616d206469736b207061636b8b47512603050401000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
"""

پایا PART2 := """
526172211a070100a9c2c4ca0c0105070301060101808080004b1a525026020b0ba10604b60ea483023a674699800001086e
6f74652e7478740a03132f8df16a8b842903207261722073616c616d2062797465206469736b2073747265616d20766f6c75
6d6520627974652073747265616d20766f6c756d6520726172207061636b20766f6c756d6520726172207061636b20627974
6520766f6c756d652073616c616d2073616c616d20627974652072617220766f6c756d65207261722073616c616d20737472
65616d207261722073616c616d2073616c616d2073616c616d206469736b207261722062797465206469736b20766f6c756d
652073747265616d2073616c616d206279746520766f6c756d6520766f6c756d6520726172206469736b2073747265616d20
766f6c756d65207261722073616c616d207061636b2073747265616d20766f6c756d65207061636b2073616c616d2073616c
616d206469736b206469736b20726172207061636b2073747265616d20627974652062797465206469736b2073747265616d
206279746520726172207061636b207061636b20766f6c756d6520627974652073747265616d2073747265616d206469736b
20766f6c756d652073616c616d2073616c616d20766f6c756d652073747265616d2072617220726172206279746520706163
6b20627974652073616c616d20726172206279746520627974652072617220627974652073616c616d207261722072617220
6469736b206469736b2073747265616d2073747265616d2073747265616d206469736b2073616c616d207261722073747265
616d206469736b2073747265616d20766f6c756d652073747265616d2073616c616d207061636b2073616c616d2073747265
616d2073747265616d206469736b2073747265616d20766f6c756d652073747265616d2073747265616d2073747265616d20
7061636b20627974652073616c616d207061636b2073747265616d2073747265616d20766f6c756d652073616c616d207061
636b20726172207061636b207261722073616c616d2073616c616d207061636b206469736b206469736b2073616c616d2064
69736b207061636b207061636b2073616c616d207061636b2073747265616d2073616c616d20766f6c756d65207261722064
69736b2072617220766f6c756d6520627974651d77565103050400
"""

پایا LOCKED := """
526172211a0701004f8ffa8e21040000010f34559f3b7ae69dc2dd40a39e1c528aafc2c96a316ce4aff36be1173ec9d29470
b91550fbe3c4c45f4dd2fbfe14bccb7ab7ba028efddec80ddb621bbad04a170343323b71489ad58a5039dca2da3bdf435da5
f52ff84b14deed319e54d2a76603c336bfcac6faecf773864d5f7fcaa7c05eb4570fd2f2e39533c099d50b6d39ce1f5bb90f
3c010d404ad0ec9b31003f9c4892bd41af252ddb3c27a2dbb488f20e33f188f4d2e89a9ae2e4afe566fdbb028936a17201d0
2ec33fba353ca4cb04f7a17ee62a89f3d2b3f20824fe874a07a6def01b09b32f4ce51efc7987f310d37ab074af4521d30448
555e46f5958a3c180c407decc1356d2300731e1e29668ce289433a4dc3700e2f1d9160a523a3f00e3aa545c6ff6f2f1f7e41
c4da6ce567f92813032b06e580080be55bd7002ce6ebe526789958b3173e5cf40ff4e383659b3c9af42ed3da8dfc7ecb32ef
cd6e0a09077414475679bd1465caa15710d438cd48bca4d174b4f58c7ee4d54019ece9757f310d13bed92d2301a1cbf4bcb0
3832dbad74df26f38fabb873e2c1d2a4b05d69fe74e31f6d1b43a1674ef75186a699bb8cfe47b06dd238ef625185e182f8d2
14679ae6739f403a6feae65452d8d3f29a2624ba021af6827e1c07a25af6b70bf82085777474c4ad54bf2d4591b8ecdcabc2
651228c42c7a6b39c36052531820b61b5c12d22b26c884611ecdfb1edc9f4a5b4e0ed808746e0b37817ed8fff2c61b1a1399
99190d89e32a8838
"""

تابع nib(c: صحیح): صحیح:
    اگر c بزرگتربرابر 48 و c کوچکتربرابر 57:
        برگشت c - 48
    پایان
    اگر c بزرگتربرابر 97 و c کوچکتربرابر 102:
        برگشت c - 87
    پایان
    برگشت -1
پایان

تابع save(پوشه: رشته، name: رشته، hex: رشته): رشته:
    ناپایا بافر_محلی := فشرده سازی.بافر بایت جدید()
    نشانگر_بایت := hex برگردان طبیعی۸*
    ناپایا بالا := -1
    تکرار hex.طول() در شمارنده:
        مقدار_محلی := nib(نشانگر_بایت[شمارنده] برگردان صحیح)
        اگر مقدار_محلی کوچکتر 0:
            گذر
        پایان
        اگر بالا کوچکتر 0:
            بالا = مقدار_محلی
        وگرنه:
            فشرده سازی.افزودن بایت(بافر_محلی، بالا * 16 + مقدار_محلی)
            بالا = -1
        پایان
    پایان
    مسیر := مسیر پرونده.پیوند(پوشه، name)
    _ := بایگانی.نوشتن پرونده دودویی از بافر(مسیر، بافر_محلی)
    فشرده سازی.آزادسازی بافر(بافر_محلی)
    برگشت مسیر
پایان

تابع ریشه:
    پوشه := مسیر پرونده.پیوند(سیستم عامل.پوشه موقت()، "salam_rarfile_set")
    سیستم عامل.ساخت پوشه ها(پوشه)
    نخست := save(پوشه، "set.part1.rar"، PART1)
    دومی := save(پوشه، "set.part2.rar"، PART2)
    متغیر_locked := save(پوشه، "locked.rar"، LOCKED)

    ناپایا چارچوب_خواندن := بایگانی.بازکردن بخش های پرونده آر ای آر(نخست، "")
    سرچاپ "volumes"، چارچوب_خواندن.بخش ها.paths.طول()، بایگانی.متن وضعیت آر ای آر(چارچوب_خواندن.وضعیت)
    خروجی_مقدار := مسیر پرونده.پیوند(پوشه، "out")
    سرچاپ بایگانی.متن وضعیت آر ای آر(بایگانی.استخراج همه از پرونده آر ای آر(چارچوب_خواندن، خروجی_مقدار، 0 برگردان صحیح۶۴، 0 برگردان صحیح۶۴))
    بایگانی.بستن پرونده آر ای آر(چارچوب_خواندن)

    ناپایا بد := بایگانی.بازکردن پرونده آر ای آر با گذرواژه(متغیر_locked، "wrong")
    سرچاپ "wrong password"، بایگانی.متن وضعیت آر ای آر(بد.وضعیت)
    بایگانی.بستن پرونده آر ای آر(بد)
    ناپایا متغیر_good := بایگانی.بازکردن پرونده آر ای آر با گذرواژه(متغیر_locked، "secret")
    ناپایا متغیر_es := بایگانی.مدخل های پرونده آر ای آر(متغیر_good)
    سرچاپ "right password"، متغیر_es.طول()، متغیر_es.بگیر(0).نام، متغیر_es.بگیر(0).اندازه
    بایگانی.آزادسازی فهرست(متغیر_es)
    بایگانی.بستن پرونده آر ای آر(متغیر_good)

    حافظه.آزادسازی(خروجی_مقدار برگردان تهی*)
    حافظه.آزادسازی(نخست برگردان تهی*)
    حافظه.آزادسازی(دومی برگردان تهی*)
    حافظه.آزادسازی(متغیر_locked برگردان تهی*)
    سیستم عامل.حذف همه(پوشه)
    حافظه.آزادسازی(پوشه برگردان تهی*)
پایان
خروجیvolumes 2 ok ok wrong password wrong password right password 1 note.txt 1846

تابع‌ها

بازکردن پرونده زیپ ZipOpenFile

تابع بازکردن پرونده زیپ(path: رشته): پرونده زیپ
زیپی را روی دیسک باز می‌کند و فقط انتهای آن و فهرست مرکزی را می‌خواند، پس پرونده‌ای با هر اندازه فوراً باز می‌شود. اندازه‌ها و جابه‌جایی‌ها ۶۴ بیتی‌اند و zip64 هم پشتیبانی می‌شود. مدخل‌های ذخیره‌شده، DEFLATE، DEFLATE64 و LZMA به صورت جریان باز می‌شوند؛ مدخل‌های bzip2 و zstd هم به صورت جریان باز می‌شوند. بایگانی چندقطعه‌ای از هر یک از قطعه‌هایش (.zip، .z01 یا .zip.001) باز می‌شود و همان‌جا مثل یک پرونده خوانده می‌شود، با پایان‌های zip64 و شماره‌ی دیسک؛ قطعه‌ی گم‌شده ZIP_MULTIVOLUME می‌دهد. پیش از استفاده status را بررسی کنید.

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

بستن پرونده زیپ ZipFileClose

تابع بستن پرونده زیپ(zf &: پرونده زیپ)
حافظه‌ای را که یک پرونده‌ی زیپ بازشده نگه داشته آزاد می‌کند.

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

تنظیم گذرواژه پرونده زیپ ZipFileSetPassword

تابع تنظیم گذرواژه پرونده زیپ(zf &: پرونده زیپ، password: رشته)
گذرواژه‌ی مدخل‌های رمزگذاری‌شده را می‌گذارد (رمزگذاری قدیمی زیپ و AES-128، AES-192 و AES-256 وین‌زیپ). گذرواژه‌ی نادرست ZIP_BAD_PASSWORD و نبودن گذرواژه ZIP_ENCRYPTED می‌دهد. داده‌ی رمزگذاری‌شده ابتدا در یک پرونده‌ی موقت رمزگشایی می‌شود، پس دیسک باید جای اندازه‌ی فشرده‌ی یک مدخل را داشته باشد.

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

مدخل های پرونده زیپ ZipFileEntries

تابع مدخل های پرونده زیپ(zf &: پرونده زیپ): وکتور<مدخل>
مدخل‌های یک پرونده‌ی زیپ بازشده را فهرست می‌کند. نتیجه را با FreeEntries آزاد کنید.

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

استخراج از پرونده زیپ به پرونده ZipFileExtractTo

تابع استخراج از پرونده زیپ به پرونده(zf &: پرونده زیپ، name: رشته، destpath: رشته، cap: صحیح۶۴): صحیح
یک مدخل را در پرونده‌ای باز می‌کند و بایگانی را خرد‌خرد می‌خواند و نتیجه را خرد‌خرد می‌نویسد، پس مصرف حافظه به اندازه‌ی مدخل بستگی ندارد. CRC-32 و اندازه در پایان بررسی می‌شوند و در صورت خطا پرونده‌ی نیمه‌نوشته پاک می‌شود. cap سقف داده‌ی بازشده به بایت است (۰ یعنی بدون سقف): مدخلی بزرگ‌تر از آن ZIP_TOO_BIG برمی‌گرداند و چیزی نمی‌نویسد.

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

استخراج همه از پرونده زیپ ZipFileExtractAll

تابع استخراج همه از پرونده زیپ(zf &: پرونده زیپ، destdir: رشته، cap: صحیح۶۴): صحیح
همه‌ی مدخل‌ها را به همین روش و با همین بررسی‌ها و همین cap برای هر مدخل زیر یک پوشه باز می‌کند. نام‌های ناامن رد می‌شوند. نتیجه ZIP_OK است یا وضعیت نخستین مدخلی که شکست خورد.

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

هفت زد است IsSevenZip

تابع هفت زد است(p: تهی*، n: صحیح): منطقی
وقتی درست است که داده با امضای 7z شروع شود.

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

متن وضعیت هفت زد SevenZipStatusText

تابع متن وضعیت هفت زد(status: صحیح): رشته
متن کوتاه انگلیسی برای یک کد SEVENZIP_....

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

بازکردن هفت زد SevenZipOpen

تابع بازکردن هفت زد(p: تهی*، n: صحیح، password: رشته): بایگانی هفت زد
داده‌ی بایگانی و گذرواژه را در یک SevenZipArchive می‌گذارد. هنوز چیزی خوانده نمی‌شود. برای بایگانی‌های رمزگذاری‌نشده گذرواژه‌ی تهی بدهید.

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

خواندن بخش‌های هفت زد SevenZipReadVolumes

تابع خواندن بخش‌های هفت زد(first: رشته، ok &: منطقی): وکتور<فشرده سازی.بافر بایت>
بخش اول (name.7z.001) و هر بخش بعدی را با بالا بردن عدد پایان نام می‌خواند. اگر پرونده‌ی اول خوانده نشود ok نادرست است.
archive-SevenZipVolumes.salam
// زبان: فارسی
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی

پایا PART1 := """
377abcaf271c000457983ded16000000000000004a00000000000000429e4011766f6c756d65206f6e650a766f6c756d6520
74776f0a0104060001091600070b
"""

پایا PART2 := """
01000101000c1600080a014e6ded24000005011113006e006f00740065002e0074007800740000001900140a0100d9199ec4
1c70dd01150601002080a4810000
"""

تابع nib(c: صحیح): صحیح:
    اگر c بزرگتربرابر 48 و c کوچکتربرابر 57:
        برگشت c - 48
    پایان
    اگر c بزرگتربرابر 97 و c کوچکتربرابر 102:
        برگشت c - 87
    پایان
    برگشت -1
پایان

تابع unhex(s: رشته): فشرده سازی.بافر بایت:
    ناپایا بافر_محلی := فشرده سازی.بافر بایت جدید()
    نشانگر_بایت := s برگردان طبیعی۸*
    ناپایا بالا := -1
    تکرار s.طول() در شمارنده:
        مقدار_محلی := nib(نشانگر_بایت[شمارنده] برگردان صحیح)
        اگر مقدار_محلی کوچکتر 0:
            گذر
        پایان
        اگر بالا کوچکتر 0:
            بالا = مقدار_محلی
        وگرنه:
            فشرده سازی.افزودن بایت(بافر_محلی، بالا * 16 + مقدار_محلی)
            بالا = -1
        پایان
    پایان
    برگشت بافر_محلی
پایان

تابع ریشه:
    ناپایا جلدها := وکتور {} برگردان وکتور<فشرده سازی.بافر بایت>
    جلدها.بیفزا(unhex(PART1))
    جلدها.بیفزا(unhex(PART2))
    ناپایا بایگانی_داده := بایگانی.بازکردن بخش‌های هفت زد(جلدها، "")
    نام‌ها := بایگانی.مدخل‌های هفت زد(بایگانی_داده)
    سرچاپ "مدخل‌ها:"، نام‌ها.طول()، بایگانی_داده.وضعیت
    داده := بایگانی.خواندن از هفت زد(بایگانی_داده، "note.txt"، 0)
    چاپ فشرده سازی.بافر به رشته(داده)
    بایگانی.بستن هفت زد(بایگانی_داده)
    بایگانی.آزادسازی بخش‌های هفت زد(جلدها)
پایان
خروجیمدخل‌ها: 1 0 volume one volume two

آزادسازی بخش‌های هفت زد SevenZipFreeVolumes

تابع آزادسازی بخش‌های هفت زد(vols &: وکتور<فشرده سازی.بافر بایت>)
بخش‌هایی را که SevenZipReadVolumes خوانده آزاد می‌کند.

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

بازکردن بخش‌های هفت زد SevenZipOpenVolumes

تابع بازکردن بخش‌های هفت زد(vols: وکتور<فشرده سازی.بافر بایت>، password: رشته): بایگانی هفت زد
مانند SevenZipOpen برای بخش‌های یک بایگانی تکه‌تکه، به ترتیب. تکه‌ها در یک بافر که بایگانی مالک آن است به هم می‌پیوندند؛ آن را با SevenZipClose آزاد کنید.

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

بستن هفت زد SevenZipClose

تابع بستن هفت زد(arc &: بایگانی هفت زد)
حافظه‌ای را که بایگانی ساخته‌ی SevenZipOpenVolumes دارد آزاد می‌کند.

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

مدخل‌های هفت زد SevenZipEntries

تابع مدخل‌های هفت زد(arc &: بایگانی هفت زد): وکتور<مدخل>
مدخل‌ها (پرونده‌ها و پوشه‌ها؛ آیتم‌های ضد کنار می‌مانند) را فهرست می‌کند و status را می‌گذارد. compressed_size اندازه‌ی فشرده‌ی بلوک یکپارچه است و روی نخستین پرونده‌اش می‌آید؛ method: ۰ ذخیره، ۱ LZMA، ۲ LZMA2، ۳ PPMd، ۴ BZip2، ۵ Deflate، ۹ دیگر؛ mode وقتی بایگانی دارد بیت‌های دسترسی یونیکس است. فهرست را با آزادسازی فهرست آزاد کنید.

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

خواندن از هفت زد SevenZipRead

تابع خواندن از هفت زد(arc &: بایگانی هفت زد، name: رشته، max: صحیح): فشرده سازی.بافر بایت
یک مدخل را با نام باز می‌کند، CRC-32 آن را می‌سنجد و status را می‌گذارد. max مدخل‌های بزرگ‌تر از آن بایت را رد می‌کند (۰ یعنی بدون سقف، یعنی همان دو گیبی‌بایتی که یک بافر نگه می‌دارد). داده تکه‌تکه باز می‌شود، پس معمولاً فقط خود مدخل در حافظه است، نه همه‌ی بلوک یکپارچه. برای خواندن پرونده‌های زیاد از خواندن همه از هفت زد استفاده کنید.

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

خواندن همه از هفت زد SevenZipReadAll

تابع خواندن همه از هفت زد(arc &: بایگانی هفت زد، destdir: رشته): صحیح
همه‌ی مدخل‌ها را زیر destdir استخراج می‌کند و تعداد نوشته‌شده‌ها را برمی‌گرداند؛ status نخستین مشکل را می‌گوید. نام‌هایی که از پوشه بیرون می‌زنند رد می‌شوند، پیوند نمادین فقط وقتی ساخته می‌شود که مقصدش درون پوشه بماند و هر بلوک یکپارچه یک بار باز می‌شود. مدخل‌ها تکه‌تکه روی دیسک نوشته می‌شوند، پس اندازه‌شان سقفی ندارد.

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

فهرست هفت زد با وضعیت SevenZipListStatus

تابع فهرست هفت زد با وضعیت(p: تهی*، n: صحیح، status &: صحیح): وکتور<مدخل>
مثل فهرست هفت زد است، و status می‌گوید چرا فهرست تهی است وقتی بایگانی خوانده نشد.

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

فهرست هفت زد SevenZipList

تابع فهرست هفت زد(p: تهی*، n: صحیح): وکتور<مدخل>
مدخل‌های بایگانی 7z را بدون گذرواژه فهرست می‌کند؛ فهرست تهی می‌تواند یعنی بایگانی بد یا رمزگذاری‌شده، به فهرست هفت زد با وضعیت نگاه کنید.

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

استخراج هفت زد SevenZipExtract

تابع استخراج هفت زد(p: تهی*، n: صحیح، name: رشته، max: صحیح، status &: صحیح): فشرده سازی.بافر بایت
یک مدخل را از بایگانی بدون گذرواژه باز می‌کند؛ status یکی از کدهای SEVENZIP_... است.

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

استخراج با نام از هفت زد با سقف SevenZipExtractByNameMax

تابع استخراج با نام از هفت زد با سقف(p: تهی*، n: صحیح، name: رشته، max: صحیح، ok &: منطقی): فشرده سازی.بافر بایت
مثل استخراج با نام از هفت زد است، اما برای مدخل بزرگ‌تر از max بایت ok نادرست است (۰ یعنی بدون سقف).

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

استخراج با نام از هفت زد SevenZipExtractByName

تابع استخراج با نام از هفت زد(p: تهی*، n: صحیح، name: رشته، ok &: منطقی): فشرده سازی.بافر بایت
یک مدخل را با نام باز می‌کند؛ اگر نباشد، خراب باشد یا چک‌جمعش نخواند ok نادرست می‌شود.

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

استخراج همه از هفت زد با وضعیت SevenZipExtractAllStatus

تابع استخراج همه از هفت زد با وضعیت(p: تهی*، n: صحیح، destdir: رشته، status &: صحیح): صحیح
همه‌ی مدخل‌ها را در destdir استخراج می‌کند، تعداد نوشته‌شده‌ها را برمی‌گرداند و status را می‌گذارد.

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

استخراج همه از هفت زد SevenZipExtractAll

تابع استخراج همه از هفت زد(p: تهی*، n: صحیح، destdir: رشته): منطقی
همه‌ی مدخل‌ها را در destdir استخراج می‌کند؛ اگر چیزی شکست خورد یا رد شد نادرست برمی‌گرداند.

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

تنظیم اندازه قطعه نوشتن SetWriteChunk

تابع تنظیم اندازه قطعه نوشتن(n: صحیح)
تعیین می‌کند نویسنده‌های پرونده‌ی gz، bz2، xz، zstd، tar.gz و زیپ هر بار چند بایت نگه دارند و فشرده کنند (پیش‌فرض ۴ مگابایت؛ کمتر از ۴۰۹۶ پیش‌فرض را برمی‌گرداند). نویسنده‌های tar.zst و tar.bz2 آن را نادیده می‌گیرند: کل تار را یک‌جریانی فشرده می‌کنند. تکه‌ی کوچک‌تر حافظه‌ی کمتری می‌گیرد و کمی بدتر فشرده می‌کند.

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

ساخت ورودی پرونده تار MakeTarFileInput

تابع ساخت ورودی پرونده تار(name: رشته، data_ptr: تهی*، data_len: صحیح، is_dir: منطقی): ورودی پرونده تار
یک ورودی تار می‌سازد.

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

ساخت ورودی پرونده تار از مسیر MakeTarFilePath

تابع ساخت ورودی پرونده تار از مسیر(name: رشته، path: رشته): ورودی پرونده تار
ورودی تاری می‌سازد که هنگام نوشتن بایگانی از پرونده‌ای روی دیسک خوانده می‌شود، پس ساخت پرونده تار، ساخت پرونده تار جی زیپ و ساخت پرونده تار زستد هرگز آن را در حافظه نگه نمی‌دارند. مدخل‌های ۸ گیبیبایت و بزرگ‌تر رکورد اندازه‌ی PAX می‌گیرند.

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

تابع ساخت ورودی پیوند نمادین تار(name: رشته، target: رشته): ورودی پرونده تار
یک مدخل پیوند نمادین می‌سازد که به target اشاره می‌کند.
archive-TarLinks.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    محتوا := فشرده سازی.بافر از رشته("hello\n")
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    ناپایا الف := بایگانی.ساخت ورودی پرونده تار("a.txt"، محتوا.داده، محتوا.طول، نادرست)
    الف.زمان تغییر = 1700000000 برگردان صحیح۶۴
    الف.دسترسی = 0o640
    پرونده‌ها.بیفزا(الف)
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پیوند نمادین تار("current"، "a.txt"))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پیوند سخت تار("copy.txt"، "a.txt"))
    عمیق := "reports/".تکرار(20) + "summary.txt"
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار(عمیق، محتوا.داده، محتوا.طول، نادرست))
    ت := بایگانی.ساخت تار(پرونده‌ها)
    ناپایا فهرست := بایگانی.فهرست تار(ت.داده، ت.طول)
    هر م در فهرست:
        سرچاپ م.نوع، م.نام.طول()، م.پیوند، م.اندازه، م.زمان تغییر، م.دسترسی
    پایان
    بایگانی.آزادسازی فهرست(فهرست)
    سرچاپ بایگانی.استخراج همه از تار(ت.داده، ت.طول، "linked")
    ناپایا بد := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    بد.بیفزا(بایگانی.ساخت ورودی پرونده تار("fine.txt"، محتوا.داده، محتوا.طول، نادرست))
    بد.بیفزا(بایگانی.ساخت ورودی پیوند نمادین تار("escape"، "../outside"))
    ب := بایگانی.ساخت تار(بد)
    سرچاپ بایگانی.استخراج همه از تار(ب.داده، ب.طول، "guarded")
پایان
خروجی0 5 6 1700000000 416 2 7 a.txt 0 0 511 3 8 a.txt 0 0 420 0 171 6 0 420 true false
تابع ساخت ورودی پیوند سخت تار(name: رشته، target: رشته): ورودی پرونده تار
یک مدخل پیوند سخت به مدخل دیگری از همین بایگانی می‌سازد، با نام target.

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

ساخت تار TarCreate

تابع ساخت تار(files: وکتور<ورودی پرونده تار>): فشرده سازی.بافر بایت
بایگانی تار (قالب ustar، با رکوردهای PAX برای آنچه ustar نگه نمی‌دارد) را در حافظه می‌سازد؛ تار فشرده نمی‌کند، برای آن جی‌زیپ را روی نتیجه به کار ببرید.

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

ساخت پرونده تار بی زیپ دو TarBz2CreateFile

تابع ساخت پرونده تار بی زیپ دو(files: وکتور<ورودی پرونده تار>، outpath: رشته): منطقی
یک پرونده‌ی .tar.bz2 با سطح ۹ بی‌زیپ۲ می‌نویسد. جریان تار هنگام نوشتن به‌صورت یک جریان bzip2 و بلوک‌به‌بلوک فشرده می‌شود، پس حافظه هر اندازه‌ی ورودی‌ها در حد یک بلوک می‌ماند؛ نتیجه همان است که فشرده سازی بی زیپ دو با سطح روی کل تار می‌دهد. اگر ورودی خوانده نشود نادرست برمی‌گرداند و پرونده‌ای باقی نمی‌گذارد.
archive-TarBz2.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی مسیر پرونده
واردسازی سیستم عامل

تابع ریشه:
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    متغیر_hello := فشرده سازی.بافر از رشته("hello\n")
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("hello.txt"، متغیر_hello.داده، متغیر_hello.طول، نادرست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("notes"، پوچ، 0، درست))
    متغیر_notes := فشرده سازی.بافر از رشته("note\n".تکرار(200))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("notes/list.txt"، متغیر_notes.داده، متغیر_notes.طول، نادرست))

    پوشه := مسیر پرونده.پیوند(سیستم عامل.پوشه موقت()، "salam_tarbz2_example")
    سیستم عامل.حذف همه(پوشه)
    سیستم عامل.ساخت پوشه ها(پوشه)
    مسیر := مسیر پرونده.پیوند(پوشه، "all.tar.bz2")
    سرچاپ "file:"، بایگانی.ساخت پرونده تار بی زیپ دو(پرونده‌ها، مسیر)
    سرچاپ "level 1:"، بایگانی.ساخت پرونده تار بی زیپ دو با سطح(پرونده‌ها، مسیر پرونده.پیوند(پوشه، "fast.tar.bz2")، 1)

    ناپایا موفق := نادرست
    بسته_شده := بایگانی.خواندن پرونده دودویی(مسیر، موفق)
    ساده := بایگانی.ساخت تار(پرونده‌ها)
    متغیر_one := فشرده سازی.فشرده سازی بی زیپ دو با سطح(ساده.داده، ساده.طول، 9)
    سرچاپ "one bzip2 stream:"، فشرده سازی.برابری بافر(بسته_شده، متغیر_one)

    مقصد := مسیر پرونده.پیوند(پوشه، "out")
    سرچاپ "extract:"، بایگانی.استخراج همه از پرونده تار بی زیپ دو(مسیر، مقصد، 0 برگردان صحیح۶۴)
    سرچاپ سیستم عامل.وجود دارد(مسیر پرونده.پیوند(مقصد، "notes/list.txt"))
    سیستم عامل.حذف همه(پوشه)
پایان
خروجیfile: true level 1: true one bzip2 stream: true extract: 0 true

ساخت پرونده تار بی زیپ دو با سطح TarBz2CreateFileLevel

تابع ساخت پرونده تار بی زیپ دو با سطح(files: وکتور<ورودی پرونده تار>، outpath: رشته، level: صحیح): منطقی
مانند ساخت پرونده تار بی زیپ دو با سطح bzip2 که می‌دهید (۱ تا ۹؛ مقدارهای دیگر به این بازه می‌رسند).

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

ساخت پرونده تار TarCreateFile

تابع ساخت پرونده تار(files: وکتور<ورودی پرونده تار>، outpath: رشته): منطقی
بایگانی تار را در پرونده می‌نویسد.

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

فهرست تار TarList

تابع فهرست تار(p: تهی*، n: صحیح): وکتور<مدخل>
مدخل‌های یک تار در حافظه، با نام‌های بلند، پیوندها، زمان‌ها و دسترسی‌ها. فهرست را با آزادسازی فهرست آزاد کنید.

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

استخراج با نام از تار TarExtractByName

تابع استخراج با نام از تار(p: تهی*، n: صحیح، name: رشته، ok &: منطقی): فشرده سازی.بافر بایت
محتوای یک مدخل پرونده‌ی تار؛ اگر نام نباشد یا پرونده نباشد ok نادرست است.

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

استخراج همه از تار TarExtractAll

تابع استخراج همه از تار(p: تهی*، n: صحیح، destdir: رشته): منطقی
همه‌ی مدخل‌های تار را با پیوندها، دسترسی‌ها و زمان‌ها در پوشه‌ی مقصد می‌نویسد. اگر مجبور شود نام یا پیوند ناایمن یا مدخلی را که نمی‌تواند بسازد رد کند، نادرست برمی‌گرداند.

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

ساخت تار جی زیپ TarGzCreate

تابع ساخت تار جی زیپ(files: وکتور<ورودی پرونده تار>): فشرده سازی.بافر بایت
یک تار در حافظه می‌سازد و جی‌زیپ می‌کند.
archive-TarGz.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    متن := "log line\n".تکرار(500)
    محتوا := فشرده سازی.بافر از رشته(متن)
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("app.log"، محتوا.داده، محتوا.طول، نادرست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("empty"، پوچ، 0، درست))
    ز := بایگانی.ساخت تار جی زیپ(پرونده‌ها)
    سرچاپ ز.طول کوچکتر محتوا.طول
    ناپایا خوب := نادرست
    ناپایا فهرست := بایگانی.فهرست تار جی زیپ(ز.داده، ز.طول، خوب)
    سرچاپ خوب، فهرست.طول()
    بایگانی.آزادسازی فهرست(فهرست)
    یکی := بایگانی.استخراج با نام از تار جی زیپ(ز.داده، ز.طول، "app.log"، خوب)
    سرچاپ خوب، یکی.طول برابر محتوا.طول
    کوچک := بایگانی.فهرست تار جی زیپ با سقف(ز.داده، ز.طول، 1000، خوب)
    سرچاپ خوب، کوچک.طول()
    _ := بایگانی.استخراج با نام از تار جی زیپ با سقف(ز.داده، ز.طول، "app.log"، 100000، خوب)
    سرچاپ خوب
    سرچاپ بایگانی.استخراج همه از تار جی زیپ با سقف(ز.داده، ز.طول، "tooSmall"، 1000)
    سرچاپ بایگانی.استخراج همه از تار جی زیپ(ز.داده، ز.طول، "unpacked")
    سرچاپ بایگانی.ساخت پرونده تار جی زیپ(پرونده‌ها، "logs.tar.gz")
پایان
خروجیtrue true 2 true true false 0 true false true true

ساخت پرونده تار جی زیپ TarGzCreateFile

تابع ساخت پرونده تار جی زیپ(files: وکتور<ورودی پرونده تار>، outpath: رشته): منطقی
یک پرونده‌ی .tar.gz می‌نویسد.

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

فهرست تار جی زیپ با سقف TarGzListMax

تابع فهرست تار جی زیپ با سقف(p: تهی*، n: صحیح، max: صحیح، ok &: منطقی): وکتور<مدخل>
مانند TarGzList با سقف max شما بر اندازه‌ی بازشده بر حسب بایت.

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

فهرست تار جی زیپ TarGzList

تابع فهرست تار جی زیپ(p: تهی*، n: صحیح، ok &: منطقی): وکتور<مدخل>
مدخل‌های یک .tar.gz در حافظه؛ اگر جی‌زیپ نامعتبر باشد یا بیش از ۱ گیگابایت باز شود ok نادرست است.

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

استخراج با نام از تار جی زیپ با سقف TarGzExtractByNameMax

تابع استخراج با نام از تار جی زیپ با سقف(p: تهی*، n: صحیح، name: رشته، max: صحیح، ok &: منطقی): فشرده سازی.بافر بایت
مانند TarGzExtractByName با سقف max شما بر اندازه‌ی بازشده بر حسب بایت.

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

استخراج با نام از تار جی زیپ TarGzExtractByName

تابع استخراج با نام از تار جی زیپ(p: تهی*، n: صحیح، name: رشته، ok &: منطقی): فشرده سازی.بافر بایت
محتوای یک پرونده از یک .tar.gz.

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

استخراج همه از تار جی زیپ با سقف TarGzExtractAllMax

تابع استخراج همه از تار جی زیپ با سقف(p: تهی*، n: صحیح، destdir: رشته، max: صحیح): منطقی
مانند TarGzExtractAll با سقف max شما بر اندازه‌ی بازشده بر حسب بایت.

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

استخراج همه از تار جی زیپ TarGzExtractAll

تابع استخراج همه از تار جی زیپ(p: تهی*، n: صحیح، destdir: رشته): منطقی
یک .tar.gz را می‌گشاید و مانند TarExtractAll در پوشه‌ی مقصد می‌نویسد؛ اگر جی‌زیپ نامعتبر یا بیش از حد بزرگ باشد نادرست.

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

ساخت تار زستد TarZstdCreate

تابع ساخت تار زستد(files: وکتور<ورودی پرونده تار>): فشرده سازی.بافر بایت
یک تار را در حافظه می‌سازد و به زستد فشرده می‌کند.
archive-TarZstd.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی مسیر پرونده
واردسازی سیستم عامل

تابع ریشه:
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    متغیر_hello := فشرده سازی.بافر از رشته("hello\n")
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("hello.txt"، متغیر_hello.داده، متغیر_hello.طول، نادرست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("notes"، پوچ، 0، درست))
    متغیر_notes := فشرده سازی.بافر از رشته("note\n".تکرار(200))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("notes/list.txt"، متغیر_notes.داده، متغیر_notes.طول، نادرست))

    متغیر_tz := بایگانی.ساخت تار زستد(پرونده‌ها)
    سرچاپ "تار زستد:"، متغیر_tz.طول، "بایت،"، فشرده سازی.زستد است بافر(متغیر_tz)
    ناپایا موفق := نادرست
    ناپایا ورودی‌ها := بایگانی.فهرست تار زستد(متغیر_tz.داده، متغیر_tz.طول، موفق)
    سرچاپ "ورودی‌ها:"، موفق، ورودی‌ها.طول()
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه
    پایان
    بایگانی.آزادسازی فهرست(ورودی‌ها)
    متغیر_one := بایگانی.استخراج با نام از تار زستد(متغیر_tz.داده، متغیر_tz.طول، "hello.txt"، موفق)
    سرچاپ موفق، فشرده سازی.بافر به رشته(متغیر_one)
    کوچک := بایگانی.فهرست تار زستد با سقف(متغیر_tz.داده، متغیر_tz.طول، 1000، موفق)
    سرچاپ "سقف ۱۰۰۰ بایت:"، موفق، کوچک.طول()

    پوشه := مسیر پرونده.پیوند(سیستم عامل.پوشه موقت()، "salam_tarzstd_example")
    سیستم عامل.حذف همه(پوشه)
    سرچاپ "استخراج:"، بایگانی.استخراج همه از تار زستد(متغیر_tz.داده، متغیر_tz.طول، پوشه)
    سرچاپ سیستم عامل.وجود دارد(مسیر پرونده.پیوند(پوشه، "notes/list.txt"))
    مسیر := مسیر پرونده.پیوند(پوشه، "all.tar.zst")
    سرچاپ "پرونده:"، بایگانی.ساخت پرونده تار زستد(پرونده‌ها، مسیر)
    سیستم عامل.حذف همه(پوشه)
پایان
خروجیتار زستد: 178 بایت، true ورودی‌ها: true 3 hello.txt 6 notes 0 notes/list.txt 1000 true hello سقف ۱۰۰۰ بایت: false 0 استخراج: true true پرونده: true

ساخت پرونده تار زستد TarZstdCreateFile

تابع ساخت پرونده تار زستد(files: وکتور<ورودی پرونده تار>، outpath: رشته): منطقی
یک پرونده‌ی .tar.zst می‌نویسد.

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

ساخت پرونده تار زستد با سطح TarZstdCreateFileLevel

تابع ساخت پرونده تار زستد با سطح(files: وکتور<ورودی پرونده تار>، outpath: رشته، level: صحیح): منطقی
مانند ساخت پرونده تار زستد با سطح زستد که می‌دهید (۱ تا ۲۲؛ پیش‌فرض ۳). کل جریان تار هنگام نوشتن به‌صورت یک قاب zstd فشرده می‌شود، پس حافظه در حد پنجره‌ی رمزگذار می‌ماند و اندازه همان است که فشرده سازی زستد با سطح روی کل تار می‌دهد. پرونده‌های قدیمی که با تکه‌های ۴ مگابایتی ساخته شده‌اند هنوز خوانده می‌شوند.

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

فهرست تار زستد با سقف TarZstdListMax

تابع فهرست تار زستد با سقف(p: تهی*، n: صحیح، max: صحیح، ok &: منطقی): وکتور<مدخل>
مثل فهرست تار زستد، با سقف max خودتان برای اندازه‌ی باز شده بر حسب بایت.

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

فهرست تار زستد TarZstdList

تابع فهرست تار زستد(p: تهی*، n: صحیح، ok &: منطقی): وکتور<مدخل>
ورودی‌های یک .tar.zst در حافظه؛ اگر داده‌ی زستد نامعتبر باشد یا بیش از ۱ گیبی‌بایت باز شود ok نادرست است.

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

استخراج با نام از تار زستد با سقف TarZstdExtractByNameMax

تابع استخراج با نام از تار زستد با سقف(p: تهی*، n: صحیح، name: رشته، max: صحیح، ok &: منطقی): فشرده سازی.بافر بایت
مثل استخراج با نام از تار زستد، با سقف max خودتان برای اندازه‌ی باز شده بر حسب بایت.

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

استخراج با نام از تار زستد TarZstdExtractByName

تابع استخراج با نام از تار زستد(p: تهی*، n: صحیح، name: رشته، ok &: منطقی): فشرده سازی.بافر بایت
محتوای یک پرونده از یک .tar.zst.

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

استخراج همه از تار زستد با سقف TarZstdExtractAllMax

تابع استخراج همه از تار زستد با سقف(p: تهی*، n: صحیح، destdir: رشته، max: صحیح): منطقی
مثل استخراج همه از تار زستد، با سقف max خودتان برای اندازه‌ی باز شده بر حسب بایت.

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

استخراج همه از تار زستد TarZstdExtractAll

تابع استخراج همه از تار زستد(p: تهی*، n: صحیح، destdir: رشته): منطقی
یک .tar.zst را باز می‌کند و مثل استخراج همه از تار در پوشه‌ی مقصد می‌نویسد؛ اگر داده‌ی زستد نامعتبر یا خیلی بزرگ باشد نادرست است.

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

بازکردن پرونده تار TarFileOpen

تابع بازکردن پرونده تار(path: رشته): پرونده تار
پرونده‌ی تاری را برای خواندن باز می‌کند. پیش از ادامه status را ببینید.

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

بستن پرونده تار TarFileClose

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

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

بازگشت به آغاز پرونده تار TarFileRewind

تابع بازگشت به آغاز پرونده تار(tf &: پرونده تار)
به نخستین مدخل برمی‌گردد.

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

آزادسازی مدخل FreeEntry

تابع آزادسازی مدخل(e &: مدخل)
نام و پیوند یک مدخل را که TarFileNext داده آزاد می‌کند.

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

مدخل بعدی پرونده تار TarFileNext

تابع مدخل بعدی پرونده تار(tf &: پرونده تار، e &: مدخل): منطقی
مدخل بعدی را در e می‌خواند و در پایان نادرست برمی‌گرداند. اندازه‌ها و جابه‌جایی‌ها ۶۴ بیتی‌اند، پس مدخل‌های بیش از ۲ گیگابایت هم عادی فهرست می‌شوند. هر مدخل را با FreeEntry آزاد کنید.

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

مدخل های پرونده تار TarFileEntries

تابع مدخل های پرونده تار(tf &: پرونده تار): وکتور<مدخل>
همه‌ی مدخل‌ها را فهرست می‌کند و برمی‌گردد به آغاز. نتیجه را با FreeEntries آزاد کنید.

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

استخراج از پرونده تار به پرونده TarFileExtractTo

تابع استخراج از پرونده تار به پرونده(tf &: پرونده تار، e: مدخل، destpath: رشته، cap: صحیح۶۴): صحیح
داده‌ی مدخلی را که آخرین TarFileNext داد در تکه‌های ۶۴ کیلوبایتی در پرونده‌ای می‌ریزد، پس مصرف حافظه به اندازه‌اش بستگی ندارد. cap سقفی به بایت است (۰ یعنی بدون سقف): مدخل بزرگ‌تر TAR_TOO_BIG می‌دهد و چیزی نمی‌نویسد.

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

استخراج همه از پرونده تار TarFileExtractAll

تابع استخراج همه از پرونده تار(path: رشته، destdir: رشته، cap: صحیح۶۴): صحیح
تاری روی دیسک را با همان قواعد ایمنی TarExtractAll و همان cap برای هر پرونده زیر یک پوشه باز می‌کند. نتیجه TAR_OK است یا وضعیت نخستین مدخلی که شکست خورد.

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

متن وضعیت تار TarStatusText

تابع متن وضعیت تار(status: صحیح): رشته
جمله‌ی کوتاهی برای یک وضعیت TAR_....

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

استخراج همه از پرونده تار جی زیپ TarGzFileExtractAll

تابع استخراج همه از پرونده تار جی زیپ(path: رشته، destdir: رشته، cap: صحیح۶۴): صحیح
یک .tar.gz روی دیسک را بدون نوشتن تار در جایی باز می‌کند: داده‌ی gzip تکه‌تکه باز می‌شود و مستقیم به خواننده‌ی تار می‌رود. بررسی‌ها مثل TarFileExtractAll است و cap هر پرونده را محدود می‌کند. جریان بریده یا خراب TAR_CORRUPT می‌دهد و پرونده‌ای را که نوشته می‌شد پاک می‌کند.
archive-TarStream.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی سیستم عامل

تابع ریشه:
    بدنه := "streamed straight from the compressed file\n"
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده تار>
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("notes/a.txt"، بدنه برگردان تهی*، بدنه.طول()، نادرست))
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده تار("notes/b.txt"، بدنه برگردان تهی*، 10، نادرست))
    سرچاپ بایگانی.ساخت پرونده تار جی زیپ(پرونده‌ها، "pack.tar.gz")
    پرونده‌ها.آزادکن()

    ناپایا سبک_متن := 0
    ناپایا ورودی‌ها := بایگانی.مدخل های پرونده تار فشرده("pack.tar.gz"، بایگانی.قالب تار جی زیپ، سبک_متن)
    هر عنصر در ورودی‌ها:
        سرچاپ عنصر.نام، عنصر.اندازه
    پایان
    سرچاپ سبک_متن
    بایگانی.آزادسازی فهرست(ورودی‌ها)

    سرچاپ بایگانی.استخراج همه از پرونده تار جی زیپ("pack.tar.gz"، "unpacked"، 0 برگردان صحیح۶۴)
    سرچاپ سیستم عامل.اندازه پرونده("unpacked/notes/a.txt")، سیستم عامل.اندازه پرونده("unpacked/notes/b.txt")
    سرچاپ بایگانی.استخراج همه از پرونده تار فشرده("pack.tar.gz"، بایگانی.قالب تار جی زیپ، "capped"، 20 برگردان صحیح۶۴)
    سرچاپ سیستم عامل.وجود دارد("capped/notes/a.txt")، سیستم عامل.وجود دارد("capped/notes/b.txt")
    سیستم عامل.حذف همه("unpacked")
    سیستم عامل.حذف همه("capped")
    سیستم عامل.حذف("pack.tar.gz")
پایان
خروجیtrue notes/a.txt 43 notes/b.txt 10 0 0 43 10 6 false true

خواندن پرونده دودویی ReadBinaryFile

تابع خواندن پرونده دودویی(path: رشته، ok &: منطقی): فشرده سازی.بافر بایت
همه‌ی بایت‌های یک پرونده را در بافر می‌خواند.

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

نوشتن پرونده دودویی WriteBinaryFile

تابع نوشتن پرونده دودویی(path: رشته، p: تهی*، n: صحیح): منطقی
n بایت را در پرونده می‌نویسد.

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

نوشتن پرونده دودویی از بافر WriteBinaryFileBuf

تابع نوشتن پرونده دودویی از بافر(path: رشته، b: فشرده سازی.بافر بایت): منطقی
بافر را در پرونده می‌نویسد.

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

اطمینان از پوشه EnsureDir

تابع اطمینان از پوشه(dir: رشته)
پوشه و پوشه‌های بالاتر را، اگر نباشند، می‌سازد.

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

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

تابع خواندن شانزده بیتی کم ارزش‌اول(p: تهی*، off: صحیح): صحیح
عدد ۱۶ بیتی کوچک‌انتها را از جای داده‌شده‌ی حافظه می‌خواند.

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

خواندن عدد۳۲ کم ارزش‌اول LEGet32

تابع خواندن عدد۳۲ کم ارزش‌اول(p: تهی*، off: صحیح): صحیح
عدد ۳۲ بیتی کوچک‌انتها را می‌خواند.

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

نوشتن شانزده بیتی کم ارزش‌اول LEPut16

تابع نوشتن شانزده بیتی کم ارزش‌اول(b &: فشرده سازی.بافر بایت، v: صحیح)
عدد ۱۶ بیتی را کوچک‌انتها به بافر اضافه می‌کند.

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

نوشتن عدد۳۲ کم ارزش‌اول LEPut32

تابع نوشتن عدد۳۲ کم ارزش‌اول(b &: فشرده سازی.بافر بایت، v: صحیح)
عدد ۳۲ بیتی را کوچک‌انتها اضافه می‌کند.

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

آزادسازی فهرست FreeEntries

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

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

فشرده سازی پرونده جی زیپ GzipCompressFile

تابع فشرده سازی پرونده جی زیپ(inpath: رشته، outpath: رشته): منطقی
یک پرونده را جی‌زیپ می‌کند و تکه‌تکه می‌خواند و فشرده می‌کند (یک عضو جی‌زیپ؛ فشرده‌سازی یک تنظیم دارد، بی سطح).

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

کدگشایی پرونده جی زیپ با سقف GzipDecompressFileCap

تابع کدگشایی پرونده جی زیپ با سقف(inpath: رشته، outpath: رشته، cap: صحیح۶۴): صحیح
پرونده‌ای را در تکه‌های ۶۴ کیلوبایتی به پرونده‌ی دیگر gunzip می‌کند، CRC-32 و اندازه را در پایان بررسی می‌کند و وضعیت ARCHIVE_... می‌دهد. cap خروجی را به بایت محدود می‌کند (۰ یعنی بدون سقف) و در شکست، خروجی نیمه‌نوشته پاک می‌شود.

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

کدگشایی پرونده جی زیپ GzipDecompressFile

تابع کدگشایی پرونده جی زیپ(inpath: رشته، outpath: رشته): منطقی
پرونده‌ی جی‌زیپ را باز می‌کند.

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

ساخت ورودی پرونده هفت زد MakeSevenZipFileInput

تابع ساخت ورودی پرونده هفت زد(name: رشته، data_ptr: تهی*، data_len: صحیح، is_dir: منطقی): ورودی پرونده هفت زد
یک ورودی 7z می‌سازد.

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

ساخت ورودی پرونده هفت زد از مسیر MakeSevenZipFilePath

تابع ساخت ورودی پرونده هفت زد از مسیر(name: رشته، path: رشته): ورودی پرونده هفت زد
ورودی 7z می‌سازد که هنگام نوشتن بایگانی از پرونده‌ای روی دیسک خوانده می‌شود.

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

ساخت هفت زد با سطح SevenZipCreateLevel

تابع ساخت هفت زد با سطح(files: وکتور<ورودی پرونده هفت زد>، level: صحیح): فشرده سازی.بافر بایت
بایگانی 7z را در حافظه با یک سطح می‌سازد: ۰ ذخیره می‌کند (کار ساخت هفت زد)، ۱ تا ۹ هر پرونده را با LZMA در پوشه‌ی خودش فشرده می‌کند.

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

ساخت هفت زد SevenZipCreate

تابع ساخت هفت زد(files: وکتور<ورودی پرونده هفت زد>): فشرده سازی.بافر بایت
یک بایگانی 7z در حافظه می‌سازد. در سطح ۰ (پیش‌فرض) پرونده‌ها بی‌فشرده‌سازی در یک بلوک یکپارچه، هر یک با CRC-32، ذخیره می‌شوند؛ ساخت هفت زد با سطح به جای آن هر پرونده را با LZMA فشرده می‌کند. ۷-زیپ نتیجه را باز می‌کند. نام تهی یا طول منفی بافر تهی می‌دهد.

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

ساخت پرونده هفت زد با سطح SevenZipCreateFileLevel

تابع ساخت پرونده هفت زد با سطح(files: وکتور<ورودی پرونده هفت زد>، path: رشته، level: صحیح): منطقی
بایگانی 7z را با سطحی مانند ساخت هفت زد با سطح روی دیسک می‌نویسد. سطح ۰ پرونده‌ها را بی‌بارگذاری از دیسک رونوشت می‌کند؛ با سطح هر بار فقط یک پرونده در حافظه است.

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

ساخت پرونده هفت زد SevenZipCreateFile

تابع ساخت پرونده هفت زد(files: وکتور<ورودی پرونده هفت زد>، path: رشته): منطقی
بایگانی 7z را روی دیسک می‌نویسد و اگر نشد نادرست برمی‌گرداند.

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

بازکردن پرونده آر ای آر RarFileOpen

تابع بازکردن پرونده آر ای آر(path: رشته): پرونده آر ای آر
پرونده‌ی RAR را باز می‌کند و اگر RAR 5 باشد فقط سرآیندهایش را می‌خواند. جابه‌جایی‌ها و اندازه‌ها ۶۴ بیتی‌اند. بایگانی دارای پرونده یا نام رمزگذاری‌شده به RarFileOpenWith و مجموعه‌ی چندبخشی به RarFileOpenVolumes نیاز دارد؛ بدون آن‌ها چنین پرونده‌هایی RAR_ENCRYPTED یا RAR_MULTIVOLUME می‌دهند.

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

بازکردن پرونده آر ای آر با گذرواژه RarFileOpenWith

تابع بازکردن پرونده آر ای آر با گذرواژه(path: رشته، password: رشته): پرونده آر ای آر
مثل RarFileOpen، با گذرواژه برای بایگانی‌هایی که پرونده‌ها یا نام پرونده‌هایشان رمزگذاری شده است. گذرواژه‌ی اشتباه RAR_BAD_PASSWORD می‌دهد. داده‌ی رمزگذاری‌شده‌ی RAR 5 همزمان با باز شدن رمزگشایی می‌شود و لازم نیست در حافظه جا شود.

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

بازکردن بخش های پرونده آر ای آر RarFileOpenVolumes

تابع بازکردن بخش های پرونده آر ای آر(first: رشته، password: رشته): پرونده آر ای آر
مجموعه‌ی چندبخشی RAR 5 را از بخش نخست (name.part1.rar، name.part01.rar یا name.rar با .r00، .r01 و ...) باز می‌کند و بقیه را از روی نام پیدا می‌کند. پرونده‌ای که میان بخش‌ها تقسیم شده، رمزگذاری‌شده یا نه، یکی‌یکی از همه‌ی بخش‌ها خوانده می‌شود، بی‌آنکه در حافظه به هم چسبانده شود؛ password می‌تواند خالی باشد. نبودِ یک بخش برای پرونده‌هایی که از آن می‌گذرند RAR_MULTIVOLUME می‌دهد.

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

بستن پرونده آر ای آر RarFileClose

تابع بستن پرونده آر ای آر(rf &: پرونده آر ای آر)
حافظه‌ی یک پرونده‌ی RAR بازشده را آزاد می‌کند.

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

مدخل های پرونده آر ای آر RarFileEntries

تابع مدخل های پرونده آر ای آر(rf &: پرونده آر ای آر): وکتور<مدخل>
مدخل‌ها را فهرست می‌کند. نتیجه را با FreeEntries آزاد کنید.

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

استخراج از پرونده آر ای آر به پرونده RarFileExtractTo

تابع استخراج از پرونده آر ای آر به پرونده(rf &: پرونده آر ای آر، name: رشته، destpath: رشته، cap: صحیح۶۴، memcap: صحیح۶۴): صحیح
یک مدخل را در پرونده‌ای باز می‌کند. داده‌ی بازشده تکه‌تکه نوشته می‌شود و همان‌جا با CRC-32 سنجیده می‌شود، پس لازم نیست در حافظه جا شود؛ فقط پنجره‌ی رمزگشا و یک بلوک از داده‌ی فشرده نگه داشته می‌شود، هر چه اندازه‌ی مدخل باشد. cap سقف بایت‌های بازشده است (۰ یعنی بی‌سقف) و مدخل بزرگ‌تر RAR_TOO_BIG می‌دهد. memcap حافظه‌ی پنجره و بلوک را محدود می‌کند (۰ یعنی پیش‌فرض ۱ گیبی‌بایت، که بیشترین اندازه‌ی پنجره هم هست): فرهنگ‌لغت بزرگ‌تر از آن از پیش رد نمی‌شود: مدخل با پنجره‌ای به همان اندازه باز می‌شود و RAR_WINDOW_TOO_BIG فقط وقتی برمی‌گردد که داده واقعاً دورتر از پنجره را نشانه برود (بایگانی RAR 7 ساخته‌شده با فرهنگ‌لغت ۶ گیبی‌بایت اگر تطبیق‌هایش نزدیک بمانند باز می‌شود).

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

استخراج همه از پرونده آر ای آر RarFileExtractAll

تابع استخراج همه از پرونده آر ای آر(rf &: پرونده آر ای آر، destdir: رشته، cap: صحیح۶۴، memcap: صحیح۶۴): صحیح
همه‌ی مدخل‌ها را، بایگانی‌های یکپارچه (solid) هم، با همان سقف‌ها زیر یک پوشه باز می‌کند. نتیجه RAR_OK یا وضعیت نخستین مدخل ناموفق است. دسترسی‌ها و زمان تغییر بازگردانده می‌شوند، پیوندهای نمادین که مقصدشان درون پوشه بماند ساخته می‌شوند و پیوندهای سخت و رونوشت‌ها مثل RarReadAll پرونده‌ی ساده می‌شوند؛ نام‌ها و پیوندهای ناایمن رد می‌شوند و RAR_UNSAFE_PATH گزارش می‌شود.

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

فشرده سازی پرونده زستد ZstdCompressFile

تابع فشرده سازی پرونده زستد(inpath: رشته، outpath: رشته): منطقی
یک پرونده را در سطح ۳ به پرونده‌ی زستد (.zst) فشرده می‌کند؛ اگر نتواند بخواند یا بنویسد نادرست است.
archive-Zstd.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی مسیر پرونده
واردسازی سیستم عامل

تابع ریشه:
    پوشه := مسیر پرونده.پیوند(سیستم عامل.پوشه موقت()، "salam_zstd_example")
    سیستم عامل.حذف همه(پوشه)
    سیستم عامل.ساخت پوشه ها(پوشه)
    ساده := مسیر پرونده.پیوند(پوشه، "notes.txt")
    بسته_شده := مسیر پرونده.پیوند(پوشه، "notes.txt.zst")
    بازگشت := مسیر پرونده.پیوند(پوشه، "notes.back")
    متن := فشرده سازی.بافر از رشته("Salam keeps notes in plain files. ".تکرار(50))
    بایگانی.نوشتن پرونده دودویی از بافر(ساده، متن)

    سرچاپ "فشرده‌سازی:"، بایگانی.فشرده سازی پرونده زستد(ساده، بسته_شده)
    ناپایا موفق := نادرست
    زد := بایگانی.خواندن پرونده دودویی(بسته_شده، موفق)
    سرچاپ موفق، زد.طول، "بایت،"، فشرده سازی.زستد است بافر(زد)
    سرچاپ "کدگشایی:"، بایگانی.کدگشایی پرونده زستد(بسته_شده، بازگشت)
    دوباره := بایگانی.خواندن پرونده دودویی(بازگشت، موفق)
    سرچاپ فشرده سازی.برابری بافر(دوباره، متن)
    سرچاپ "سطح ۱۹:"، بایگانی.فشرده سازی پرونده زستد با سطح(ساده، بسته_شده، 19)
    سرچاپ "قالب نادرست:"، بایگانی.کدگشایی پرونده زستد(ساده، بازگشت)
    سرچاپ "ناموجود:"، بایگانی.کدگشایی پرونده زستد(مسیر پرونده.پیوند(پوشه، "none.zst")، بازگشت)
    سیستم عامل.حذف همه(پوشه)
پایان
خروجیفشرده‌سازی: true true 57 بایت، true کدگشایی: true true سطح ۱۹: true قالب نادرست: false ناموجود: false

فشرده سازی پرونده زستد با سطح ZstdCompressFileLevel

تابع فشرده سازی پرونده زستد با سطح(inpath: رشته، outpath: رشته، level: صحیح): منطقی
مثل فشرده سازی پرونده زستد، در سطحی که می‌دهید (۰ یا کمتر ذخیره، ۱ تا ۲۲ فشرده‌سازی).

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

کدگشایی پرونده زستد با سقف ZstdDecompressFileCap

تابع کدگشایی پرونده زستد با سقف(inpath: رشته، outpath: رشته، cap: صحیح۶۴): صحیح
یک پرونده‌ی .zst را بی‌آنکه هیچ‌کدام را کامل بارگذاری کند به پرونده‌ی دیگری کدگشایی می‌کند؛ پنجره در حافظه می‌ماند. cap خروجی را محدود می‌کند. ARCHIVE_OK، ARCHIVE_TOO_BIG، ARCHIVE_CORRUPT یا ARCHIVE_IO_ERROR برمی‌گرداند و در شکست خروجی را پاک می‌کند.

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

کدگشایی پرونده زستد ZstdDecompressFile

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

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

بازکردن پرونده هفت زد SevenZipOpenFile

تابع بازکردن پرونده هفت زد(path: رشته، password: رشته): پرونده هفت زد
یک 7z را روی دیسک باز می‌کند و فقط سرآیند انتهای آن را می‌خواند (سرآیند رمزگذاری یا فشرده‌شده ابتدا باز می‌شود)، پس پرونده‌ای با هر اندازه فوراً باز می‌شود. تکه‌ی اول (name.7z.001) یک بایگانی تکه‌تکه را بدهید تا تکه‌های بعدی پیدا شوند و مثل یک پرونده خوانده شوند، بی‌آنکه در حافظه چسبانده شوند. پیش از استفاده status را بررسی کنید.

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

بستن پرونده هفت زد SevenZipFileClose

تابع بستن پرونده هفت زد(sf &: پرونده هفت زد)
حافظه‌ی نگه‌داشته‌ی یک پرونده‌ی 7z بازشده را آزاد می‌کند.

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

مدخل های پرونده هفت زد SevenZipFileEntries

تابع مدخل های پرونده هفت زد(sf &: پرونده هفت زد): وکتور<مدخل>
مدخل‌های یک پرونده‌ی 7z بازشده را فهرست می‌کند. نتیجه را با FreeEntries آزاد کنید.

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

استخراج از پرونده هفت زد به پرونده SevenZipFileExtractTo

تابع استخراج از پرونده هفت زد به پرونده(sf &: پرونده هفت زد، name: رشته، destpath: رشته، cap: صحیح۶۴، memcap: صحیح۶۴): صحیح
یک مدخل را در یک پرونده باز می‌کند. LZMA، LZMA2، DEFLATE، DEFLATE64، کپی، دلتا و جابه‌جایی بایت به صورت جریان و با پنجره‌ای به اندازه‌ی واژه‌نامه اجرا می‌شوند، پس حافظه کم می‌ماند و مدخل می‌تواند از ۲ گیگابایت بگذرد (بلوک فشرده‌ی یکپارچه از ابتدا باز می‌شود و بعد از مدخل می‌ایستد). cap بیشترین بایتی است که مدخل می‌تواند داشته باشد (۰ یعنی بدون سقف) و پیش از نوشتن چیزی SEVENZIP_TOO_BIG می‌دهد. memcap بیشترین حافظه‌ی کدگشاست (۰ یعنی بدون سقف). فیلترهای شاخه، BCJ2، PPMd، bzip2 و AES-256 هم جریانی‌اند، تنها یا در زنجیره‌هایی مانند AES و LZMA2 و BCJ. فراتر از cap یا memcap نتیجه SEVENZIP_TOO_BIG است؛ مدل PPMd بزرگ‌تر از ۲ گیگابایت هم با همین وضعیت رد می‌شود.

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

استخراج همه از پرونده هفت زد SevenZipFileExtractAll

تابع استخراج همه از پرونده هفت زد(sf &: پرونده هفت زد، destdir: رشته، cap: صحیح۶۴، memcap: صحیح۶۴): صحیح
همه‌ی مدخل‌ها را زیر یک پوشه باز می‌کند، با یک گذر برای هر بلوک فشرده‌ی یکپارچه و با همان بررسی‌ها، cap و memcap. نام‌های ناامن رد و با SEVENZIP_UNSAFE_PATH گزارش می‌شوند؛ پیوند نمادین وقتی ساخته می‌شود که هدفش درون پوشه بماند. اولین مشکل یا SEVENZIP_OK برمی‌گردد.

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

خواندن از هفت زد با سقف SevenZipReadCap

تابع خواندن از هفت زد با سقف(arc &: بایگانی هفت زد، name: رشته، cap: صحیح۶۴): فشرده سازی.بافر بایت
مانند SevenZipRead با cap ۶۴ بیتی بر حسب بایت (۰ یعنی دو گیبی‌بایتی که یک بافر نگه می‌دارد). مدخل بزرگ‌تر بافر خالی برمی‌گرداند و status را SEVENZIP_TOO_BIG می‌گذارد.

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

خواندن همه از هفت زد با سقف SevenZipReadAllCap

تابع خواندن همه از هفت زد با سقف(arc &: بایگانی هفت زد، destdir: رشته، cap: صحیح۶۴، memcap: صحیح۶۴): صحیح
مانند SevenZipReadAll با سقف: cap بیشترین بایتی است که یک مدخل می‌تواند باز شود (۰ یعنی بدون سقف؛ مدخل بزرگ‌تر رد می‌شود و status برابر SEVENZIP_TOO_BIG می‌شود) و memcap بیشترین حافظه‌ای که یک کدگشا می‌تواند بگیرد (۰ یعنی بدون سقف).

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

مدخل‌های هفت زد در حافظه SevenZipEntriesOf

تابع مدخل‌های هفت زد در حافظه(arc &: بایگانی هفت زد): وکتور<مدخل>
همان SevenZipEntries است؛ نامی که فهرست درون حافظه و فهرست روی دیسک در آن شریکند.

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

ساخت ورودی پرونده زیپ MakeZipFileInput

تابع ساخت ورودی پرونده زیپ(name: رشته، data_ptr: تهی*، data_len: صحیح، method: صحیح): ورودی پرونده زیپ
یک ورودی زیپ می‌سازد.

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

ساخت ورودی پرونده زیپ با سطح MakeZipFileInputLevel

تابع ساخت ورودی پرونده زیپ با سطح(name: رشته، data_ptr: تهی*، data_len: صحیح، method: صحیح، level: صحیح): ورودی پرونده زیپ
یک ورودی زیپ با سطح فشرده‌سازی می‌سازد.

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

ساخت زیپ ZipCreate

تابع ساخت زیپ(files: وکتور<ورودی پرونده زیپ>): فشرده سازی.بافر بایت
بایگانی زیپ را در حافظه می‌سازد. نام‌هایی که بایت غیر ASCII دارند پرچم UTF-8 می‌گیرند. هر روشی جز ۸ پرونده را بی‌فشرده ذخیره می‌کند. نتیجه خالی است اگر ورودی نامعتبر باشد (طول منفی، نشانی تهی همراه با طول، نام بیش از ۶۵۵۳۵ بایت) یا مجموع از حدود ۱٫۹ گیگابایت بیشتر شود. آرشیو با همان نویسنده‌ی مدخلی که ساخت پرونده زیپ دارد در یک بافر رشدکننده نوشته می‌شود، پس هر مدخل تکه‌تکه با رمزگذارها فشرده می‌شود و نسخه‌ی دومی از بدنه‌ی آرشیو ساخته نمی‌شود؛ آنچه در حافظه می‌ماند آرشیو برگشتی و بافرهای ورودی شماست. مدخل‌های رمزدار هم همین راه را می‌روند.

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

ساخت زیپ بزرگ ZipCreate64

تابع ساخت زیپ بزرگ(files: وکتور<ورودی پرونده زیپ>): فشرده سازی.بافر بایت
مانند ZipCreate ولی همیشه شکل zip64 را می‌نویسد: اندازه و جابه‌جایی ۶۴ بیتی در فیلدهای اضافی، رکورد پایانی zip64 و نشانگرش. unzip و 7-Zip آن را می‌خوانند؛ برای آزمودن خواننده‌های zip64 به کار می‌رود. با ورودی نامعتبر خالی است.
archive-ZipTime.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    متن := "سلام، سلام، سلام"
    ب := فشرده سازی.بافر از رشته(متن)
    ناپایا نام‌دار := بایگانی.ساخت ورودی پرونده زیپ("سلام.txt"، ب.داده، ب.طول، 8)
    نام‌دار.زمان تغییر = 1700000000 برگردان صحیح۶۴
    ناپایا پرونده‌ها := وکتور {} برگردان وکتور<بایگانی.ورودی پرونده زیپ>
    پرونده‌ها.بیفزا(نام‌دار)
    پرونده‌ها.بیفزا(بایگانی.ساخت ورودی پرونده زیپ("plain.txt"، ب.داده، ب.طول، 8))
    ز := بایگانی.ساخت زیپ(پرونده‌ها)
    ناپایا فهرست := بایگانی.فهرست زیپ(ز.داده، ز.طول)
    هر م در فهرست:
        سرچاپ م.نام، م.زمان تغییر
    پایان
    بایگانی.آزادسازی فهرست(فهرست)
    سرچاپ "پرچم UTF-8:"، (بایگانی.خواندن شانزده بیتی کم ارزش‌اول(ز.داده، 6) & 0x800) نابرابر 0

    بزرگ := بایگانی.ساخت زیپ بزرگ(پرونده‌ها)
    ناپایا دوباره := بایگانی.فهرست زیپ(بزرگ.داده، بزرگ.طول)
    سرچاپ دوباره.طول()، بزرگ.طول بزرگتر ز.طول، دوباره.بگیر(0).اندازه
    بایگانی.آزادسازی فهرست(دوباره)
    ناپایا بررسی‌شده := 0
    سرچاپ بایگانی.بررسی زیپ(بزرگ.داده، بزرگ.طول، بررسی‌شده)، بررسی‌شده
پایان
خروجیسلام.txt 1700000000 plain.txt 315532800 پرچم UTF-8: true 2 true 30 0 2

ساخت پرونده زیپ ZipCreateFile

تابع ساخت پرونده زیپ(files: وکتور<ورودی پرونده زیپ>، outpath: رشته): منطقی
بایگانی زیپ را در پرونده می‌نویسد.

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

ساخت پرونده زیپ بزرگ ZipCreateFile64

تابع ساخت پرونده زیپ بزرگ(files: وکتور<ورودی پرونده زیپ>، outpath: رشته): منطقی
مانند ساخت پرونده زیپ ولی همیشه شکل zip64 را می‌نویسد. بدون آن هم ساخت پرونده زیپ برای مدخل‌های ۴ گیگابایت و بیشتر، جابه‌جایی بیش از ۴ گیگابایت و ۶۵۵۳۵ مدخل یا بیشتر به zip64 می‌رود.

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

ساخت ورودی پرونده زیپ از مسیر MakeZipFilePath

تابع ساخت ورودی پرونده زیپ از مسیر(name: رشته، path: رشته، method: صحیح، level: صحیح): ورودی پرونده زیپ
ورودی زیپی می‌سازد که هنگام نوشتن بایگانی از پرونده‌ای روی دیسک خوانده می‌شود. مدخل‌های ذخیره‌شده، DEFLATE، bzip2، LZMA و zstd همگی تکه‌تکه خوانده و فشرده می‌شوند.

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

ساخت ورودی پرونده زیپ رمزدار MakeZipFileInputEncrypted

تابع ساخت ورودی پرونده زیپ رمزدار(name: رشته، data_ptr: تهی*، data_len: صحیح، method: صحیح، level: صحیح، password: رشته، encryption: صحیح): ورودی پرونده زیپ
ورودی زیپی با گذرواژه و رمزگذاری می‌سازد (رمزگذاری زیپ خودکار و بقیه‌ی پایین).

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

فهرست زیپ ZipList

تابع فهرست زیپ(p: تهی*، n: صحیح): وکتور<مدخل>
مدخل‌های یک زیپ در حافظه.

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

استخراج با نام از زیپ ZipExtractByName

تابع استخراج با نام از زیپ(p: تهی*، n: صحیح، name: رشته، ok &: منطقی): فشرده سازی.بافر بایت
محتوای یک مدخل را بیرون می‌آورد؛ اگر نام پیدا نشود، مدخل رمزدار باشد یا روشش ۰ یا ۸ نباشد، ok نادرست می‌شود. CRC بررسی نمی‌شود.

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

استخراج با نام از زیپ با سقف ZipExtractByNameMax

تابع استخراج با نام از زیپ با سقف(p: تهی*، n: صحیح، name: رشته، max: صحیح، ok &: منطقی): فشرده سازی.بافر بایت
مانند ZipExtractByName است، ولی اگر مدخل بزرگ‌تر از max بایت شود ok نادرست می‌شود؛ اندازه هنگام باز کردن بررسی می‌شود. برای فایل‌های فشرده‌ای که دیگران می‌فرستند از آن استفاده کنید، چون چند کیلوبایت می‌تواند ادعای چند گیگابایت داشته باشد.

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

استخراج تایید شده از زیپ ZipExtractVerified

تابع استخراج تایید شده از زیپ(p: تهی*، n: صحیح، name: رشته، max: صحیح، status &: صحیح): فشرده سازی.بافر بایت
یک مدخل را بیرون می‌آورد و اندازه و CRC-32 آن را می‌سنجد. status روی یکی از کدهای ZIP_ گذاشته می‌شود، ZIP_OK در موفقیت و در غیر آن دلیل، و بافر خالی است. max سقف اندازه‌ی بازشده است، یا ۰ برای بی‌سقف.

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

بررسی زیپ ZipVerify

تابع بررسی زیپ(p: تهی*، n: صحیح، checked &: صحیح): صحیح
هر مدخل پرونده را باز می‌کند و اندازه و CRC-32 آن را می‌سنجد. checked را روی تعداد بررسی‌شده‌ها می‌گذارد و تعداد خراب‌ها را برمی‌گرداند (رمزدار، پشتیبانی‌نشده یا بسیار بزرگ هم خراب شمرده می‌شود)، ۰ اگر همه سالم باشند و ۱- اگر داده زیپ نباشد.

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

مدخل های خراب زیپ ZipBadEntries

تابع مدخل های خراب زیپ(p: تهی*، n: صحیح): وکتور<مدخل>
مدخل‌هایی که در ZipVerify رد می‌شوند؛ فهرست را با FreeEntries آزاد کنید.

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

متن وضعیت زیپ ZipStatusText

تابع متن وضعیت زیپ(status: صحیح): رشته
شرح کوتاه انگلیسی یک کد وضعیت ZIP_.

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

استخراج همه از زیپ ZipExtractAll

تابع استخراج همه از زیپ(p: تهی*، n: صحیح، destdir: رشته): منطقی
همه‌ی مدخل‌ها را در پوشه‌ی مقصد می‌نویسد، پس از بررسی CRC-32 هر یک. مدخلی با نام ناایمن یا بررسی ناموفق نوشته نمی‌شود و نتیجه نادرست است. اگر داده زیپ نباشد، مدخلی ندارد و چیزی نوشته نمی‌شود.

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

استخراج همه از پرونده تار فشرده TarCompressedFileExtractAll

تابع استخراج همه از پرونده تار فشرده(path: رشته، format: صحیح، destdir: رشته، cap: صحیح۶۴): صحیح
یک تار فشرده روی دیسک را در یک گذر باز می‌کند. format برابر FormatTarGz، FormatTarBz2 یا FormatTarXz است. جز پرونده‌ی جاری چیزی نگه داشته نمی‌شود؛ بررسی‌ها و cap همان TarFileExtractAll است.

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

مدخل های پرونده تار فشرده TarCompressedFileEntries

تابع مدخل های پرونده تار فشرده(path: رشته، format: صحیح، status &: صحیح): وکتور<مدخل>
یک تار فشرده روی دیسک را در یک گذر و بدون باز کردن محتوا فهرست می‌کند. status برابر TAR_OK یا دلیل پایان زودهنگام جریان می‌شود. نتیجه را با FreeEntries آزاد کنید.

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

استخراج همه از پرونده تار بی زیپ دو TarBz2FileExtractAll

تابع استخراج همه از پرونده تار بی زیپ دو(path: رشته، destdir: رشته، cap: صحیح۶۴): صحیح
همین برای یک .tar.bz2: بلوک‌های bzip2 یکی‌یکی کدگشایی و به خواننده‌ی تار فرستاده می‌شوند، پس حافظه به اندازه‌ی یک بلوک است نه کل بایگانی.

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

استخراج همه از پرونده تار ایکس زد TarXzFileExtractAll

تابع استخراج همه از پرونده تار ایکس زد(path: رشته، destdir: رشته، cap: صحیح۶۴): صحیح
همین برای یک .tar.xz: بلوک‌ها با XzFileToSink یکی‌یکی کدگشایی و به خواننده‌ی تار فرستاده می‌شوند.

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

استخراج همه از پرونده تار زستد TarZstdFileExtractAll

تابع استخراج همه از پرونده تار زستد(path: رشته، destdir: رشته، cap: صحیح۶۴): صحیح
همین برای یک .tar.zst: با ZstdFileToSink و پنجره‌ی لغزان کدگشایی و به خواننده‌ی تار فرستاده می‌شود.

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

استخراج یک مدخل از پرونده تار فشرده TarCompressedFileExtractTo

تابع استخراج یک مدخل از پرونده تار فشرده(path: رشته، format: صحیح، name: رشته، destpath: رشته، cap: صحیح۶۴، total: صحیح۶۴): صحیح
یک پرونده‌ی تار فشرده روی دیسک را در یک گذر به destpath باز می‌کند و به محض نوشتن می‌ایستد. cap همان پرونده را و total کل جریان بازشده را محدود می‌کند (۰ یعنی بدون سقف). اگر پرونده‌ای با آن نام نباشد TAR_NOT_FOUND برمی‌گرداند.

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

ساخت پرونده زیپ چندقطعه ای ZipCreateFileSplit

تابع ساخت پرونده زیپ چندقطعه ای(files: وکتور<ورودی پرونده زیپ>، outpath: رشته، part_size: صحیح۶۴، style: صحیح): منطقی
بایگانی زیپ را در قطعه‌هایی با اندازه‌ی حداکثر part_size بایت می‌نویسد (دست‌کم ۶۵۵۳۶ و کمتر از ۴ گیگابایت). با ZipSplitDisk قطعه‌ها name.z01، name.z02 و ... هستند و آخرین name.zip نام دارد، همان‌طور که Info-ZIP و 7-Zip می‌نویسند: شماره‌ی دیسک هر مدخل در فهرست مرکزی است، هیچ سرآیندی بین دو قطعه شکسته نمی‌شود و قطعه‌ی اول با نشان پوشش چندقطعه‌ای شروع می‌شود. با ZipSplitByte بایگانی ساخته‌شده به name.zip.001، name.zip.002 و ... بریده می‌شود که 7-Zip آن را یک پرونده می‌بیند. مدخل‌ها مثل ZipCreateFile جریانی نوشته می‌شوند و هر روش و گذرواژه‌ای ممکن است. بایگانی ابتدا کامل در name.salamsplit.tmp کنار خروجی نوشته می‌شود، پس دیسک دو برابر جا لازم دارد. اگر چیزی شکست بخورد نادرست برمی‌گرداند و قطعه‌ها را پاک می‌کند.

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

ساخت ورودی پرونده MakeFileInput

تابع ساخت ورودی پرونده(name: رشته، data_ptr: تهی*، data_len: صحیح، is_dir: منطقی): ورودی پرونده
یک FileInput می‌سازد.

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

سقف های پیش فرض DefaultLimits

تابع سقف های پیش فرض(): سقف ها
Limits پیش‌فرض را برمی‌گرداند.

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

متن وضعیت بایگانی ArchiveStatusText

تابع متن وضعیت بایگانی(status: صحیح): رشته
توضیح کوتاه انگلیسی یک کد ARCHIVE_.

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

نام قالب FormatName

تابع نام قالب(format: صحیح): رشته
نام کوتاه یک کد Format، مانند tar.gz.

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

تشخیص قالب Detect

تابع تشخیص قالب(p: تهی*، n: صحیح): صحیح
قالب را از بایت‌های نخست پیدا می‌کند (و برای تار از چک‌جمع سرآیند). پرونده‌ی gzip، bzip2 یا xz حتی با تار درونش همان خودش گزارش می‌شود؛ Open درون را می‌بیند.

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

تشخیص قالب از نام DetectName

تابع تشخیص قالب از نام(path: رشته): صحیح
قالب را از پسوند نام پرونده حدس می‌زند؛ اگر چیزی نخواند FormatUnknown.

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

بازکردن با سقف OpenWith

تابع بازکردن با سقف(p: تهی*، n: صحیح، password: رشته، limits: سقف ها): بایگانی
مانند Open با Limits خودتان.

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

بازکردن بایگانی Open

تابع بازکردن بایگانی(p: تهی*، n: صحیح، password: رشته): بایگانی
بایت‌های بایگانی را از هر قالب با سقف پیش‌فرض باز می‌کند. پرونده‌ی gzip، bzip2 یا xz همان لحظه باز می‌شود و تار درونش شناخته می‌شود. پس از آن status را ببینید.

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

بازکردن پرونده بایگانی OpenFile

تابع بازکردن پرونده بایگانی(path: رشته، password: رشته): بایگانی
پرونده‌ای را روی دیسک باز می‌کند. پرونده‌ی zip، tar، tar.gz، 7z یا RAR 5 در حافظه خوانده نمی‌شود: فقط فهرست مدخل‌هایش خوانده می‌شود و هر فراخوانی پس از آن تکه‌تکه می‌خواند و می‌نویسد، پس پرونده می‌تواند هر اندازه‌ای باشد و data پوچ می‌ماند. tar.gz به صورت جریان از gzip خوانده می‌شود و پرونده‌ی موقتی ندارد: فهرست‌کردن و استخراج هر کدام دوباره از آغاز کدگشایی می‌کنند و به محض تمام‌شدن مدخل خواسته‌شده می‌ایستند، و max_total بایت‌های بازشده‌ی یک گذر را محدود می‌کند. قالب‌های دیگر (bzip2، xz، zstd، یک پرونده‌ی gzip تکی، RAR با گذرواژه) کامل خوانده و مانند Open باز می‌شوند. در هر دو حالت Limits اعمال می‌شود.

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

تنظیم سقف ها SetLimits

تابع تنظیم سقف ها(arc &: بایگانی، limits: سقف ها)
سقف‌های بایگانی بازشده را عوض می‌کند.

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

بستن بایگانی Close

تابع بستن بایگانی(arc &: بایگانی)
آنچه بایگانی نگه داشته را آزاد می‌کند.

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

فهرست بایگانی List

تابع فهرست بایگانی(arc &: بایگانی): وکتور<مدخل>
مدخل‌های هر قالب را در یک مدل Entry فهرست می‌کند. با FreeEntries آزاد کنید.

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

خواندن از بایگانی Read

تابع خواندن از بایگانی(arc &: بایگانی، name: رشته): فشرده سازی.بافر بایت
یک مدخل را با نام می‌خواند، تا max_entry بایت. status می‌گوید چه شد؛ جز در ARCHIVE_OK بافر خالی است.

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

استخراج همه از بایگانی ExtractAll

تابع استخراج همه از بایگانی(arc &: بایگانی، destdir: رشته): صحیح
همه را در یک پوشه استخراج می‌کند. ابتدا همه‌ی مدخل‌ها با سقف‌ها و نام‌های ناامن، مسیر مطلق، ..، پیوند بیرون‌رونده، نوشتن از راه پیوند و مدخل دستگاه سنجیده می‌شوند؛ اگر یکی رد شود چیزی نوشته نمی‌شود و status دلیلش را می‌گوید. تعداد پرونده‌ها را برمی‌گرداند، یا 0 در شکست.

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

استخراج یک مدخل Extract

تابع استخراج یک مدخل(arc &: بایگانی، name: رشته، destdir: رشته): منطقی
یک پرونده یا پوشه را با نام استخراج می‌کند، با همان بررسی نام. در شکست false برمی‌گرداند و status را می‌گذارد.

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

فهرست پرونده بایگانی ListFile

تابع فهرست پرونده بایگانی(path: رشته، password: رشته، status &: صحیح): وکتور<مدخل>
پرونده را باز می‌کند، فهرست می‌کند و می‌بندد. نتیجه در status است.

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

استخراج پرونده بایگانی ExtractFile

تابع استخراج پرونده بایگانی(path: رشته، destdir: رشته، password: رشته، status &: صحیح): صحیح
پرونده را باز می‌کند، در پوشه استخراج می‌کند و می‌بندد. تعداد پرونده‌ها را برمی‌گرداند.

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

ساخت بایگانی در بافر CreateBuf

تابع ساخت بایگانی در بافر(format: صحیح، files: وکتور<ورودی پرونده>، status &: صحیح): فشرده سازی.بافر بایت
بایگانی با Format داده‌شده را در حافظه می‌سازد: zip، tar، tar.gz، tar.bz2، rar و 7z (ذخیره‌ای)، یا gzip و bzip2 با دقیقاً یک پرونده. قالب‌های دیگر ARCHIVE_UNSUPPORTED می‌دهند؛ نام ناامن ARCHIVE_UNSAFE_PATH.

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

ساخت بایگانی Create

تابع ساخت بایگانی(path: رشته، files: وکتور<ورودی پرونده>): صحیح
بایگانی را می‌سازد و در مسیر می‌نویسد؛ قالب از پسوند نام می‌آید (DetectName). یک کد ARCHIVE_ برمی‌گرداند.

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

آر ای آر است IsRar

تابع آر ای آر است(p: تهی*، n: صحیح): منطقی
اگر داده با امضای RAR شروع شود، درست برمی‌گرداند.

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

متن وضعیت آر ای آر RarStatusText

تابع متن وضعیت آر ای آر(status: صحیح): رشته
توضیح کوتاه انگلیسی یک کد وضعیت RAR_.

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

فهرست آر ای آر RarList

تابع فهرست آر ای آر(p: تهی*، n: صحیح): وکتور<مدخل>
مدخل‌های یک بایگانی RAR.

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

استخراج آر ای آر RarExtract

تابع استخراج آر ای آر(p: تهی*، n: صحیح، name: رشته، max: صحیح، status &: صحیح): فشرده سازی.بافر بایت
محتوای یک مدخل RAR که با نام دقیقش پیدا می‌شود. status یکی از کدهای RAR_ می‌شود: در موفقیت RAR_OK، وگرنه دلیل، و بافر خالی است. max اندازه‌ی بازشده را محدود می‌کند، یا ۰ برای بی‌محدودیت.

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

استخراج با نام از آر ای آر با سقف RarExtractByNameMax

تابع استخراج با نام از آر ای آر با سقف(p: تهی*، n: صحیح، name: رشته، max: صحیح، ok &: منطقی): فشرده سازی.بافر بایت
مانند RarExtractByName است، ولی اگر مدخل بزرگ‌تر از max بایت باشد ok نادرست می‌شود، و این پیش از باز کردن بررسی می‌شود.

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

استخراج با نام از آر ای آر RarExtractByName

تابع استخراج با نام از آر ای آر(p: تهی*، n: صحیح، name: رشته، ok &: منطقی): فشرده سازی.بافر بایت
محتوای یک مدخل RAR که با نام دقیقش پیدا می‌شود. اگر مدخل نباشد، پشتیبانی نشود، رمزدار یا خراب باشد ok نادرست می‌شود؛ برای فهمیدن دلیل RarExtract را به کار ببرید.

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

استخراج همه از آر ای آر با وضعیت RarExtractAllStatus

تابع استخراج همه از آر ای آر با وضعیت(p: تهی*، n: صحیح، destdir: رشته، status &: صحیح): صحیح
مانند RarExtractAll است، ولی شمار مدخل‌های نوشته‌شده را برمی‌گرداند و status را روی نخستین مشکل می‌گذارد. مدخلی که نامش (یا مقصد پیوند نمادینش) از پوشه‌ی مقصد بیرون می‌زند کنار گذاشته و با RAR_UNSAFE_PATH گزارش می‌شود.

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

استخراج همه از آر ای آر RarExtractAll

تابع استخراج همه از آر ای آر(p: تهی*، n: صحیح، destdir: رشته): منطقی
همه‌ی مدخل‌های RAR را بیرون می‌آورد و هرگز بیرون از پوشه‌ی مقصد نمی‌نویسد.

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

بازکردن آر ای آر RarOpen

تابع بازکردن آر ای آر(p: تهی*، n: صحیح، password: رشته): بایگانی آر ای آر
داده‌ی بایگانی و گذرواژه را در یک RarArchive می‌گذارد. هنوز چیزی کپی یا خوانده نمی‌شود.

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

مدخل‌های آر ای آر RarEntries

تابع مدخل‌های آر ای آر(arc &: بایگانی آر ای آر): وکتور<مدخل>
مدخل‌های بایگانی، با گذرواژه‌ی آن. اگر نام‌ها خوانده نشوند status را RAR_ENCRYPTED یا RAR_BAD_PASSWORD می‌کند.

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

خواندن از آر ای آر RarRead

تابع خواندن از آر ای آر(arc &: بایگانی آر ای آر، name: رشته، max: صحیح): فشرده سازی.بافر بایت
محتوای یک مدخل که با نام دقیقش پیدا می‌شود، با گذرواژه رمزگشایی شده. max اندازه‌ی بازشده را محدود می‌کند، یا ۰ برای بی‌محدودیت. status را می‌گذارد.

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

خواندن همه از آر ای آر RarReadAll

تابع خواندن همه از آر ای آر(arc &: بایگانی آر ای آر، destdir: رشته): صحیح
همه‌ی مدخل‌ها را در پوشه‌ی مقصد می‌نویسد، هرگز بیرون از آن، و شمار نوشته‌شده‌ها را برمی‌گرداند. status را روی نخستین مشکل می‌گذارد.

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

خواندن بخش‌های آر ای آر RarReadVolumes

تابع خواندن بخش‌های آر ای آر(first: رشته، ok &: منطقی): وکتور<فشرده سازی.بافر بایت>
بخش نخست و هر بخش بعدی را که با نام‌های رایج پیدا شود می‌خواند (name.part01.rar، name.part02.rar، یا name.rar، name.r00، name.r01). اگر پرونده‌ی نخست خوانده نشود ok نادرست می‌شود.
archive-RarVolumes.salam
واردسازی بایگانی
واردسازی فشرده سازی

پایا بخش۱ := """
526172211a0701006de128270b01050701060101808080002c64b9412502130be78600048df500a48302c8ac493d8005
0105762e7478740a0313c60bf16a7ed75827cc5dc30845643444334f3565365536a7751848c413a8c1d5a93ff0a349ca
1575f48991859458af2f2ba874489a028b323f09e3cf1e32ffefaf9f97e7e9e9e3edf6f1fa579a7a7d7c3dbdfcbebe3e
7f9f0fa7dbc3d3d3c16d1eff9ff7f7f2fd6ec95fb7f5e3f169de0de1e7efea4f755ebf7e5fe7d7f1fbe5efdec9ebf7f0
ac07f5f8f3ffbd1b1bddbb560ebd7589d7ab57eac6759257a2be6b5bff06db5907b7bfa37e2771d6115e7d65b5b1ead5
bc777f89dd96b66f649d2dbd8d5fb76ce932faf6d637ab6eb48ebc7784ebcd71b4dd9bcee1bd1377eeefbd11bfaa6188
98a280bb6b6d5a47dab204c174a6eafdbcad94b9666ab7f59414fe5a1970fab96f34eaf29a0edb711056b5ceb7494e85
b83775441bc51f56f4dc85bb03667c21d75603e2af914e76c0fb7fb5f428b8fa03bdef2854a35f5ad1273344a09bfacf
3d171047a766aa0d8c11896e85ced5a3fffcee5af7d608ba9d99ccb1aa2be1aa1342ae8b3ae9744562654f1606e38681
3201eddbf1afb701e2c1bbbff9efe02d2e17480a0962ab9b850cc218ea736bad10726ac6adab51e376d55ac13a036d61
8ec3818e63acd5ef5acb6746eae8ead37a7bb694b7a4c144844a6fa10afaf9603e08b482196964dcc8844ab4e013abdb
b4253899ef86069c3bb146ea4f805c057d5d03e101866c22c2413f3901cef35cb2faa62459ed943aafe3345d4aac4411
bb6c32bd58e376ad8393fda6c9ab56441546a250934dc2b662a55ca908f1fb6b12556784fd827901ad81c55caab012f8
0a35c584d114212450a1a8e1dc067711a39dda12659ce0d861a2ce3fafba224e2122c97cd0f5f92425ddfb9c36c9c953
6714555e7051d7dc252c7646f0df25808c58e78b266f0b92b8b917e2c910c0c3af16037381d7939fc090853cdd8df086
7370634378a2c228d4a8c0273788104daf093c9e6dccb0410dceb0215c0610eebaf222187780368a3dd2303226e99cf9
803e25ff56547e270704384ae9021fbc501683ba7cb179dcc0ae76d5600476f4c2ac82942f313d6213c24edbc0445454
d01f0c5e11d1f2ab6437eeafd08d1a3e40e3b6028205a2d7c3383a23c3fad885328bc65c5718d8d8630cfafc1b88c05c
bceb14fad1feaf94c163c9738d355824356adba1ca97a4a959832f630220a908b8b815c8b9acf685c0a255b735826132
911a80b69b45726abd4f52371614f9e267fe5840155b011bb28b47512603050401000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
00000000000000000000000000000000
"""

پایا بخش۲ := """
526172211a070100a9c2c4ca0c01050703010601018080800064563ccc25021b0be68600048df500a483020002230880
050105762e7478740a0313c60bf16a7ed75827046840f3834518cedc2f96f6bbb89190a3b6d9c514aacde7ee173d264c
b8f0692c7ca6b792780ee2bef245c9c3c949222294d2e016d242cd89838cbfa39edcb53775439267227627f0b5b02174
c9d22a0f2190336159b20695cd4c7113ce32dd1e2151829ab73dfea0950912309fda1d69b59f9b6e641be295e0f1f394
d8fd5c492fccc8a69b3426b4ab0d12b035942a0dfc9ca3a2401d11d385b8a8f007ead59f3e1694e6f315576c22200f28
4cd5c4a56653424b06d609611a293322bceeaf554095f3cca784064d2e5174624dd2a741e712bf8435f0a0c44458c205
f0a4b74671b82bb9635e6e10b24863da4475cc8f5a03b84b084d8bbf0834706da6cc792f4240b267a1fc20e04f3f4633
546acb84c2681dee1c00a436b6d9cccfdbffa1cad473bc7540b0002c96977021c9e8b443db4c80abd793bb7bd0d3305d
44416d504a0a9b699832d700ad111e6478d7e798ad90f492f8d248b49cd1380d23cfce8c4692ca5f5c3e8958a9b66477
c2a7d91522b7672ec51114c161dd650d948da76149d23cccc99308d707fc1db5100c4eba404d61309b83bb3c7503742b
a94a7440bae2115fd613fe21302d369c8b24bbe9c988d4eec33d9fbdc7c9038887de34419353b1bf82c0855b6c2277d6
8a8492d6e708fc7de0fa008c102633d12552fcaae7639fa3a0de6daf2336895df8a09169ed7e67ba0af51a4119c1daaa
71d7c254c05abbdab89669a40940e34742bf31a601545cdd2010c7e55016edb49cd2d7073b67d5f9ab38d9c418e76a44
f8394a65a783ab16db093629a33bd2ac91bdfb948263c08a0e4c9a4cae7af9eff46102d7bc913b5cb84a12b623a0a09f
ed11700ead0b984e3e78193ce0190ede74759a8ba34e3cee326dab0b3482d69a9af4f2e125c2d5c85cebccceb0e79c72
862a1f4252f2a18c33614af63cd523378109df9c8408d09c7e1dcc497bf400d082d87505f29af8f49a2034d6e575af9c
0e0ae77f857693f8e11cebcfb19f40a6fd1856362b74b7821b726242542b9c1c9c0add41783d931149e85a37418dba78
73ad990a9a4c7ac61b257db791159b11375886f2655cf56469191a5f853dba4f909dd88210d27dae6335450e4886e1a9
0976178ef226e03a38f420961ab7e866c8e252e62d8d1cd7eaaa2634d2747769c7a19d0e2d6c3c119034c1092a54ae36
4d4888b31633aa9473da001976173bcb5422b5d9d1922d044d8b47512603050401000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
00000000000000000000000000000000
"""

پایا بخش۳ := """
526172211a0701004ac54b440c0105070302060101808080004fb1c48c25020b0bfa8300048df500a4830287c98a0f80
050105762e7478740a0313c60bf16a7ed758276e9e2146d09044d59e5c974bc9e14a51910cdd41b71dcbf4f11fafd98d
16fb2d0683270a40c720ef76ab99b90b355e72e2acf71ea3c079e458b57797a810a9320e5b8f495efd066558b0974909
e6a8cff09481c66b5ee1259c3d36f48eeb7ec0f22fe946721c718c317a6058d161bf759e1c1e9a5b9427d538a4a3aade
0c326b40453c6b35b52d882e9413dbc82c5dc62160fc39a3b92dce54ac533a592fd09af8aba6fc2578f5cf12048671b2
740297a0d81a2d8f87113e877a3d3645e68034c922e7f1af8d0a794f3061e8696f2def1b8d951da84ce31a294f7c79a9
d784db31486ab60718767955e357868e61a57a866f4d072a16d82b283f8370e98ca225dd77dcf92004ea79317d93484a
62722811c2d2124f214fa55393d104c65b346abd4c63ecea91ca5bab74f0eb6af2378bc9734b8ad6ad79745d233884a7
6f99443c8e46eceeb4b9bc79895e4dedea7a4a4a2f1126126cadd27c20d3f24c0fbff173f03b3e4974014f428733869b
7f1b1916980a4335126a67984987f010b31fdcfd33edf46177414ac7a83f0909729736c70710e4bd7fb79cbf1924248d
8a2111eb874fa21f667084ea442d5950d187fd9eb2f066e09224441fbc9f32719e36176cab4d67b74200ba2c55397958
d35451df7777b403b0a724d22cb9a9a5ce7a7d72484b628b53c8b1cb893c158e558776fe1fc54ecdbc7cbe36e87c047d
942702030b8500048500a4830210c43fd080000109736d616c6c2e7478740a0313bd0bf16a5abb310b74696e790a1d77
565103050400
"""

تابع رقم(ک: صحیح): صحیح:
    اگر ک >= ۴۸ و ک <= ۵۷:
        برگشت ک - ۴۸
    پایان
    اگر ک >= ۹۷ و ک <= ۱۰۲:
        برگشت ک - ۸۷
    پایان
    برگشت -۱
پایان

تابع از هگز(متن: رشته): فشرده سازی.بافر بایت:
    ناپایا خروجی := فشرده سازی.بافر بایت جدید()
    بایت‌ها := متن برگردان طبیعی۸*
    ناپایا بالا := -۱
    تکرار متن.طول() در ای:
        م := رقم(بایت‌ها[ای] برگردان صحیح)
        اگر م < ۰:
            گذر
        پایان
        اگر بالا < ۰:
            بالا = م
        وگرنه:
            فشرده سازی.افزودن بایت(خروجی، بالا * ۱۶ + م)
            بالا = -۱
        پایان
    پایان
    برگشت خروجی
پایان

تابع ریشه:
    ناپایا بخش‌ها := وکتور {} برگردان وکتور<فشرده سازی.بافر بایت>
    بخش‌ها.بیفزا(از هگز(بخش۱))
    بخش‌ها.بیفزا(از هگز(بخش۲))
    بخش‌ها.بیفزا(از هگز(بخش۳))

    ناپایا باز := بایگانی.بازکردن بخش‌های آر ای آر(بخش‌ها، "")
    ناپایا نام‌ها := بایگانی.مدخل‌های آر ای آر(باز)
    هر م در نام‌ها:
        داده := بایگانی.خواندن از آر ای آر(باز، م.نام، ۰)
        سرچاپ م.نام، م.اندازه، داده.طول، بایگانی.متن وضعیت آر ای آر(باز.وضعیت)
    پایان
    بایگانی.آزادسازی فهرست(نام‌ها)
    بایگانی.بستن آر ای آر(باز)

    ناپایا ناقص := وکتور {} برگردان وکتور<فشرده سازی.بافر بایت>
    ناقص.بیفزا(بخش‌ها.بگیر(۰))
    ناقص.بیفزا(بخش‌ها.بگیر(۱))
    ناپایا خراب := بایگانی.بازکردن بخش‌های آر ای آر(ناقص، "")
    رفته := بایگانی.خواندن از آر ای آر(خراب، "v.txt"، ۰)
    سرچاپ رفته.طول، خراب.وضعیت == بایگانی.آر ای آر چند بخشی
    بایگانی.بستن آر ای آر(خراب)

    بایگانی.نوشتن پرونده دودویی از بافر("set.part01.rar"، بخش‌ها.بگیر(۰))
    بایگانی.نوشتن پرونده دودویی از بافر("set.part02.rar"، بخش‌ها.بگیر(۱))
    بایگانی.نوشتن پرونده دودویی از بافر("set.part03.rar"، بخش‌ها.بگیر(۲))
    ناپایا خوب := نادرست
    ناپایا یافته := بایگانی.خواندن بخش‌های آر ای آر("set.part01.rar"، خوب)
    سرچاپ خوب، یافته.طول()
    بایگانی.آزادسازی بخش‌های آر ای آر(یافته)
پایان
خروجیv.txt 14989 14989 ok small.txt 5 5 ok 0 true true 3

آزادسازی بخش‌های آر ای آر RarFreeVolumes

تابع آزادسازی بخش‌های آر ای آر(vols &: وکتور<فشرده سازی.بافر بایت>)
بخش‌های خوانده‌شده با RarReadVolumes را آزاد می‌کند.

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

بازکردن بخش‌های آر ای آر RarOpenVolumes

تابع بازکردن بخش‌های آر ای آر(vols: وکتور<فشرده سازی.بافر بایت>، password: رشته): بایگانی آر ای آر
مانند RarOpen، برای فهرستی از بخش‌ها به ترتیب. بافرها باید تا زمان استفاده از بایگانی زنده بمانند.

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

بستن آر ای آر RarClose

تابع بستن آر ای آر(arc &: بایگانی آر ای آر)
آنچه یک RarArchive نگه می‌دارد را آزاد می‌کند؛ خود بخش‌ها با RarFreeVolumes آزاد می‌شوند.

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

ساخت ورودی پرونده آر ای آر MakeRarFileInput

تابع ساخت ورودی پرونده آر ای آر(name: رشته، data_ptr: تهی*، data_len: صحیح، is_dir: منطقی): ورودی پرونده آر ای آر
یک ورودی RAR می‌سازد.

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

ساخت آر ای آر RarCreate

تابع ساخت آر ای آر(files: وکتور<ورودی پرونده آر ای آر>): فشرده سازی.بافر بایت
یک بایگانی RAR 5 را در حافظه می‌سازد. پرونده‌ها بی‌فشرده‌سازی و هر کدام با CRC-32 ذخیره می‌شوند و هر ابزار RAR نتیجه را باز می‌کند.

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

ساخت پرونده آر ای آر RarCreateFile

تابع ساخت پرونده آر ای آر(files: وکتور<ورودی پرونده آر ای آر>، outpath: رشته): منطقی
بایگانی RAR 5 را روی دیسک می‌نویسد و اگر نتواند نادرست برمی‌گرداند.

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

فشرده سازی پرونده ایکس زد XzCompressFile

تابع فشرده سازی پرونده ایکس زد(inpath: رشته، outpath: رشته): منطقی
یک پرونده را به پرونده‌ی .xz (سطح ۶، بررسی CRC-64) فشرده می‌کند؛ اگر نتواند بخواند یا بنویسد نادرست است. پرونده تکه‌تکه (به اندازه‌ی تنظیم اندازه قطعه نوشتن بایت) خوانده و فشرده می‌شود و برای هر تکه یک جریان .xz نوشته می‌شود.
archive-Xz.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی مسیر پرونده
واردسازی سیستم عامل

پایا XZ := """
fd377a585a000004e6d6b44604c05fcf022101160000000000000000bb0ccf6ce0014e00575d0029984986240afb8a34e4
81db780958f3d0144436dd3bb4ca45234051fa042e5be576402f66b72801fb0f3b421e32e3eba071037cdd425338444ede
4cb8c8c742828bc92c1b53df8ea763015d902c3d49f9c602aacf40a000005b35fff6fd65c4e300017bcf020000005e9efc
63b1c467fb020000000004595a
"""

پایا LZMA := """
5d00008000ffffffffffffffff0029984986240afb8a34e481db780958f3d0144436dd3bb4ca45234051fa042e5be57640
2f66b72801fb0f3b421e32e3eba071037cdd425338444ede4cb8c8c742828bc92c1b53df8ea763015d902c3d49f9c602ad
8d68e0bcfed44dc0
"""

تابع nib(c: صحیح): صحیح:
    اگر c بزرگتربرابر 48 و c کوچکتربرابر 57:
        برگشت c - 48
    پایان
    اگر c بزرگتربرابر 97 و c کوچکتربرابر 102:
        برگشت c - 87
    پایان
    برگشت -1
پایان

تابع unhex(s: رشته): فشرده سازی.بافر بایت:
    ناپایا بافر_محلی := فشرده سازی.بافر بایت جدید()
    نشانگر_بایت := s برگردان طبیعی۸*
    ناپایا بالا := -1
    تکرار s.طول() در شمارنده:
        مقدار_محلی := nib(نشانگر_بایت[شمارنده] برگردان صحیح)
        اگر مقدار_محلی کوچکتر 0:
            گذر
        پایان
        اگر بالا کوچکتر 0:
            بالا = مقدار_محلی
        وگرنه:
            فشرده سازی.افزودن بایت(بافر_محلی، بالا * 16 + مقدار_محلی)
            بالا = -1
        پایان
    پایان
    برگشت بافر_محلی
پایان

تابع ریشه:
    پوشه := مسیر پرونده.پیوند(سیستم عامل.پوشه موقت()، "salam_xz_example")
    سیستم عامل.حذف همه(پوشه)
    سیستم عامل.ساخت پوشه ها(پوشه)
    متغیر_xz_path := مسیر پرونده.پیوند(پوشه، "notes.txt.xz")
    متغیر_lzma_path := مسیر پرونده.پیوند(پوشه، "notes.txt.lzma")
    متغیر_out_path := مسیر پرونده.پیوند(پوشه، "notes.txt")
    بایگانی.نوشتن پرونده دودویی از بافر(متغیر_xz_path، unhex(XZ))
    بایگانی.نوشتن پرونده دودویی از بافر(متغیر_lzma_path، unhex(LZMA))

    سرچاپ "ایکس زد:"، بایگانی.کدگشایی پرونده ایکس زد(متغیر_xz_path، متغیر_out_path)
    ناپایا موفق := نادرست
    متن := بایگانی.خواندن پرونده دودویی(متغیر_out_path، موفق)
    سرچاپ موفق، متن.طول، "بایت"
    سرچاپ "الزد ام ای:"، بایگانی.کدگشایی پرونده الزد ام ای(متغیر_lzma_path، متغیر_out_path)
    سرچاپ "قالب نادرست:"، بایگانی.کدگشایی پرونده ایکس زد(متغیر_lzma_path، متغیر_out_path)
    سرچاپ "ناموجود:"، بایگانی.کدگشایی پرونده ایکس زد(مسیر پرونده.پیوند(پوشه، "none.xz")، متغیر_out_path)

    ساده := مسیر پرونده.پیوند(پوشه، "plain.txt")
    بایگانی.نوشتن پرونده دودویی از بافر(ساده، متن)
    بسته_شده := مسیر پرونده.پیوند(پوشه، "plain.txt.xz")
    سرچاپ "فشرده ایکس زد:"، بایگانی.فشرده سازی پرونده ایکس زد(ساده، بسته_شده)، بایگانی.کدگشایی پرونده ایکس زد(بسته_شده، متغیر_out_path)
    سرچاپ "فشرده الزد ام ای:"، بایگانی.فشرده سازی پرونده الزد ام ای(ساده، متغیر_lzma_path)، بایگانی.کدگشایی پرونده الزد ام ای(متغیر_lzma_path، متغیر_out_path)
    سرچاپ "فشرده ناموجود:"، بایگانی.فشرده سازی پرونده ایکس زد(مسیر پرونده.پیوند(پوشه، "none.txt")، بسته_شده)
    سیستم عامل.حذف همه(پوشه)
پایان
خروجیایکس زد: true true 335 بایت الزد ام ای: true قالب نادرست: false ناموجود: false فشرده ایکس زد: true true فشرده الزد ام ای: true true فشرده ناموجود: false

فشرده سازی پرونده ایکس زد با سطح XzCompressFileLevel

تابع فشرده سازی پرونده ایکس زد با سطح(inpath: رشته، outpath: رشته، level: صحیح): منطقی
مانند فشرده سازی پرونده ایکس زد با سطحی که می‌دهید (۰ تا ۹؛ ۰ در تکه‌های LZMA2 ذخیره می‌کند).

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

فشرده سازی پرونده الزد ام ای LzmaCompressFile

تابع فشرده سازی پرونده الزد ام ای(inpath: رشته، outpath: رشته): منطقی
یک پرونده را به پرونده‌ی قدیمی .lzma (سطح ۶) فشرده می‌کند؛ اگر نتواند بخواند یا بنویسد نادرست است.

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

فشرده سازی پرونده الزد ام ای با سطح LzmaCompressFileLevel

تابع فشرده سازی پرونده الزد ام ای با سطح(inpath: رشته، outpath: رشته، level: صحیح): منطقی
مانند فشرده سازی پرونده الزد ام ای با سطحی که می‌دهید (۱ تا ۹، پیش‌فرض ۶). این قالب را نمی‌شود تکه‌تکه کرد، پس همه‌ی پرونده در حافظه می‌ماند.

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

کدگشایی پرونده ایکس زد XzDecompressFile

تابع کدگشایی پرونده ایکس زد(inpath: رشته، outpath: رشته): منطقی
پرونده‌ی .xz را در یک پرونده‌ی تازه باز می‌کند و در صورت موفقیت درست برمی‌گرداند. چک‌های درون پرونده بررسی می‌شوند و اگر یکی بیفتد چیزی نوشته نمی‌شود. همه‌ی نتیجه نخست در حافظه نگه داشته می‌شود.

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

کدگشایی پرونده ایکس زد با سقف XzDecompressFileCap

تابع کدگشایی پرونده ایکس زد با سقف(inpath: رشته، outpath: رشته، cap: صحیح۶۴): صحیح
پرونده‌ی .xz را در یک پرونده‌ی تازه باز می‌کند و وضعیت ARCHIVE_... برمی‌گرداند. cap خروجی را به بایت محدود می‌کند (۰ یعنی بدون سقف)؛ ARCHIVE_TOO_BIG یعنی داده از آن می‌گذرد و ARCHIVE_CORRUPT یعنی پرونده خراب است. در شکست چیزی باقی نمی‌ماند.
archive-FileCap.salam
// زبان: فارسی
واردسازی بایگانی
واردسازی فشرده سازی
واردسازی مسیر پرونده
واردسازی سیستم عامل

تابع ریشه:
    پوشه := مسیر پرونده.پیوند(سیستم عامل.پوشه موقت()، "salam_filecap_example")
    سیستم عامل.ساخت پوشه ها(پوشه)
    مبدأ := مسیر پرونده.پیوند(پوشه، "plain.bin")
    بسته_شده := مسیر پرونده.پیوند(پوشه، "plain.xz")
    بازگشت := مسیر پرونده.پیوند(پوشه، "back.bin")
    ناپایا خام := فشرده سازی.بافر بایت جدید()
    تکرار 20000 در شمارنده:
        فشرده سازی.افزودن بایت(خام، 97 + (شمارنده % 5))
    پایان
    _ := بایگانی.نوشتن پرونده دودویی از بافر(مبدأ، خام)
    _ := بایگانی.فشرده سازی پرونده ایکس زد(مبدأ، بسته_شده)
    سرچاپ بایگانی.متن وضعیت بایگانی(بایگانی.کدگشایی پرونده ایکس زد با سقف(بسته_شده، بازگشت، 1000 برگردان صحیح۶۴))
    سرچاپ بایگانی.متن وضعیت بایگانی(بایگانی.کدگشایی پرونده ایکس زد با سقف(بسته_شده، بازگشت، 0 برگردان صحیح۶۴))
    _ := بایگانی.فشرده سازی پرونده بی زیپ دو(مبدأ، بسته_شده)
    سرچاپ بایگانی.متن وضعیت بایگانی(بایگانی.کدگشایی پرونده بی زیپ دو با سقف(بسته_شده، بازگشت، 1000 برگردان صحیح۶۴))
    سرچاپ بایگانی.متن وضعیت بایگانی(بایگانی.کدگشایی پرونده بی زیپ دو با سقف(بسته_شده، بازگشت، 0 برگردان صحیح۶۴))
    سرچاپ بایگانی.متن وضعیت بایگانی(بایگانی.کدگشایی پرونده الزد ام ای با سقف(مبدأ، بازگشت، 0 برگردان صحیح۶۴))
    سیستم عامل.حذف همه(پوشه)
پایان
خروجیentry too large ok entry too large ok corrupt data

کدگشایی پرونده الزد ام ای با سقف LzmaDecompressFileCap

تابع کدگشایی پرونده الزد ام ای با سقف(inpath: رشته، outpath: رشته، cap: صحیح۶۴): صحیح
پرونده‌ی قدیمی .lzma را مثل XzDecompressFileCap در پرونده‌ی تازه باز می‌کند: وضعیت ARCHIVE_... و ARCHIVE_TOO_BIG بالاتر از cap.

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

کدگشایی پرونده الزد ام ای LzmaDecompressFile

تابع کدگشایی پرونده الزد ام ای(inpath: رشته، outpath: رشته): منطقی
پرونده‌ی قدیمی .lzma را در یک پرونده‌ی تازه باز می‌کند و در صورت موفقیت درست برمی‌گرداند.

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

فشرده سازی پرونده بی زیپ دو Bzip2CompressFile

تابع فشرده سازی پرونده بی زیپ دو(inpath: رشته، outpath: رشته): منطقی
یک پرونده را به پرونده‌ی بی‌زیپ۲ (.bz2) فشرده می‌کند؛ اگر نتواند بخواند یا بنویسد نادرست است.
archive-Bzip2.salam
واردسازی بایگانی
واردسازی فشرده سازی

تابع ریشه:
    متن := فشرده سازی.بافر از رشته("کمک‌های پرونده‌ی بی‌زیپ۲: یک پرونده می‌آید، یک پرونده می‌رود.\n")
    سرچاپ بایگانی.نوشتن پرونده دودویی از بافر("note.txt"، متن)
    سرچاپ بایگانی.فشرده سازی پرونده بی زیپ دو("note.txt"، "note.txt.bz2")
    سرچاپ بایگانی.کدگشایی پرونده بی زیپ دو("note.txt.bz2"، "back.txt")
    ناپایا خوب := نادرست
    برگشتی := بایگانی.خواندن پرونده دودویی("back.txt"، خوب)
    سرچاپ خوب، فشرده سازی.برابری بافر(برگشتی، متن)
    سرچاپ بایگانی.کدگشایی پرونده بی زیپ دو("note.txt"، "bad.txt")
    سرچاپ بایگانی.فشرده سازی پرونده بی زیپ دو("missing.txt"، "missing.txt.bz2")
پایان
خروجیtrue true true true true false false

فشرده سازی پرونده بی زیپ دو با سطح Bzip2CompressFileLevel

تابع فشرده سازی پرونده بی زیپ دو با سطح(inpath: رشته، outpath: رشته، level: صحیح): منطقی
مانند فشرده سازی پرونده بی زیپ دو با سطحی که می‌دهید (۱ تا ۹، اندازه‌ی بلوک به گام‌های ۱۰۰ کیلوبایت؛ عدد بیرون از این بازه به آن برده می‌شود).

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

کدگشایی پرونده بی زیپ دو با سقف Bzip2DecompressFileCap

تابع کدگشایی پرونده بی زیپ دو با سقف(inpath: رشته، outpath: رشته، cap: صحیح۶۴): صحیح
پرونده‌ی بی‌زیپ۲ را مثل XzDecompressFileCap در پرونده‌ی تازه باز می‌کند: وضعیت ARCHIVE_... و ARCHIVE_TOO_BIG بالاتر از cap.

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

کدگشایی پرونده بی زیپ دو Bzip2DecompressFile

تابع کدگشایی پرونده بی زیپ دو(inpath: رشته، outpath: رشته): منطقی
پرونده‌ی بی‌زیپ۲ را باز می‌کند؛ اگر نتواند بخواند یا بنویسد یا داده بی‌زیپ۲ معتبر نباشد نادرست است.

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