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

دودویی encoding.binary

نوشتن و خواندن عددها به شکل بایت، با ترتیب بزرگ‌انتها یا کوچک‌انتها.

واردسازی کدگذاری.دودویی

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

قالب‌های دودویی پرونده و پروتکل‌های شبکه هر عدد را با تعداد ثابتی بایت و به ترتیبی ثابت ذخیره می‌کنند. این بسته چنین فیلدهایی را می‌نویسد و می‌خواند: عددهای صحیح ۸، ۱۶، ۳۲ و ۶۴ بیتی، با علامت یا بی‌علامت، و عددهای اعشاری ۳۲ یا ۶۴ بیتی IEEE 754. بزرگ‌انتها (BE) پرارزش‌ترین بایت را اول می‌گذارد و ترتیب رایج در شبکه و در PNG است؛ کوچک‌انتها (LE) برعکس است و همان چیزی است که پردازنده‌های x86 و ARM و قالب‌هایی مثل ZIP و WAV به کار می‌برند.

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

برای دسترسی تصادفی به بایت‌هایی که از پیش دارید، مثل پرونده‌ای که کامل خوانده‌اید یا یک باینری نگاشت‌شده در حافظه، از نمای بایت استفاده کنید: گرفتن طبیعی۳۲ کوچک‌انتها(نما، جابه‌جایی) و هم‌خانواده‌هایش عدد را در هر جابه‌جایی می‌خوانند، گذاشتن طبیعی۳۲ کوچک‌انتها و هم‌خانواده‌هایش می‌نویسند و رشته با صفر پایانی و رشته با پهنای ثابت نام‌هایی را می‌خوانند که قالب‌های اجرایی نگه می‌دارند. نما هر دسترسی را با طولش می‌سنجد: گیرنده بیرون از آن ۰ برمی‌گرداند و نشاننده نادرست، پس سرآیند خراب نمی‌تواند از بافر بیرون بخواند؛ وقتی ۰ مقدار ممکن است اول دارد را بزنید.

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

  • همه‌ی تابع‌های خواندن ... خطاداراند. وقتی بایت‌های مانده از اندازه‌ی مقدار کمتر باشد، یک خطای هسته از نوع اتمام ناگهانی با کد binary.unexpected_end و جایگاه خواننده در جایگاه پرتاب می‌شود و خواننده جابه‌جا نمی‌شود. آن را با تلاش درون کدگشایی صدا بزنید که خودش خطادار است، تا پرونده‌ی بریده به جای کدگشایی صفرها با خطا بایستد. این بررسی برای هر مقدار یک مقایسه است؛ حلقه‌ای با ۱۰ میلیون خواندن طبیعی۳۲ کوچک‌انتها روی یک دستگاه x86-64 شش‌هسته‌ای پرمشغله با پشتوانه‌ی LLVM حدود ۳ میلی‌ثانیه و با پشتوانه‌ی C (gcc یا tcc) حدود ۱۰۰ میلی‌ثانیه طول کشید.
  • مقدارهای بی‌علامت ۳۲ بیتی در یک صحیح برمی‌گردند که علامت‌دار است، پس مقدارهای ۲٬۱۴۷٬۴۸۳٬۶۴۸ به بالا منفی دیده می‌شوند. خواندن طبیعی۳۲ بزرگ‌انتها و خواندن صحیح۳۲ بزرگ‌انتها همان بیت‌ها را برمی‌گردانند. با (v برگردان صحیح۶۴) & 4294967295 پهنش کنید.
  • بی‌علامت ۶۴ بیتی هم یک صحیح۶۴ است، پس مقدارهای بیش از ۹٬۲۲۳٬۳۷۲٬۰۳۶٬۸۵۴٬۷۷۵٬۸۰۷ منفی می‌شوند.
  • تابع‌های نوشتن بازه را بررسی نمی‌کنند. نوشتن ۳۰۰ با نوشتن طبیعی۸ عدد ۴۴ را می‌نویسد، یعنی ۸ بیت پایینی را.
  • گزینه‌های دودویی هنوز در هیچ تابعی به کار نمی‌رود؛ تابع‌های اعشاری به جایش یک مقدار منطقی big_endian می‌گیرند و تابع‌های صحیح ترتیب را در نامشان دارند.

راهنما: قالب پرونده‌ی خودتان

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

encoding-binary-guide-header.salam
واردسازی کدگذاری.دودویی
واردسازی فشرده سازی
واردسازی رشته

تابع نوشتن پرونده(امتیازها: وکتور<صحیح>): فشرده سازی.بافر بایت:
    ناپایا ب := فشرده سازی.بافر بایت جدید()
    فشرده سازی.افزودن بایت‌ها(ب، "SLM1" برگردان تهی*، ۴)
    دودویی.نوشتن طبیعی۱۶ کوچک‌انتها(ب، ۲)
    دودویی.نوشتن طبیعی۳۲ کوچک‌انتها(ب، امتیازها.طول())
    هر ا در امتیازها:
        دودویی.نوشتن صحیح۳۲ کوچک‌انتها(ب، ا)
    پایان
    برگشت ب
پایان

تابع خواندن پرونده(داده: فشرده سازی.بافر بایت، اندازه: صحیح): رشته خطادار:
    ناپایا خ := فشرده سازی.خواننده بایت جدید(داده.داده، اندازه)
    ناپایا سر := فشرده سازی.خواندن بایت‌ها(خ، ۴)
    دیرکن فشرده سازی.آزادسازی بافر(سر)
    اگر فشرده سازی.بافر به رشته(سر) != "SLM1":
        پرتاب خطا خطا.در جایگاه(نوع خطا.نحو، "پرونده‌ی ما نیست"، ۰)
    پایان
    نسخه := تلاش دودویی.خواندن طبیعی۱۶ کوچک‌انتها(خ)
    اگر نسخه != ۲:
        پرتاب خطا خطا.در جایگاه(نوع خطا.پشتیبانی نشده، "نسخه‌ی ناشناخته‌ی " + رشته.از عدد(نسخه)، ۴)
    پایان
    تعداد := تلاش دودویی.خواندن طبیعی۳۲ کوچک‌انتها(خ)
    اگر تعداد < ۰ یا تعداد > ۱۰۰۰۰۰:
        پرتاب خطا خطا.در جایگاه(نوع خطا.خارج از بازه، "تعداد باورنکردنی"، ۶)
    پایان
    ناپایا جمع := ۰ برگردان صحیح۶۴
    تکرار تعداد:
        جمع += (تلاش دودویی.خواندن صحیح۳۲ کوچک‌انتها(خ)) برگردان صحیح۶۴
    پایان
    برگشت رشته.از عدد(تعداد) + " امتیاز، جمع " + رشته.از عدد(جمع)
پایان

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

تابع ریشه:
    ناپایا امتیازها := وکتور {} برگردان وکتور<صحیح>
    امتیازها.بیفزا(۱۲۰)
    امتیازها.بیفزا(-۱۵)
    امتیازها.بیفزا(۹۸۰۰۰)
    ناپایا داده := نوشتن پرونده(امتیازها)
    سرچاپ "پرونده"، فشرده سازی.طول بافر(داده)، "بایت است"

    نمایش("کل پرونده:"، داده، فشرده سازی.طول بافر(داده))
    نمایش("۱۸ بایت نخست:"، داده، ۱۸)
    فشرده سازی.تنظیم بایت(داده، ۴، ۹)
    نمایش("ویرایش‌شده:"، داده، فشرده سازی.طول بافر(داده))
    فشرده سازی.آزادسازی بافر(داده)
پایان
خروجیپرونده 22 بایت است کل پرونده: 3 امتیاز، جمع 98105 ۱۸ بایت نخست: unexpected end of data: needed 4 bytes, 0 left (offset 18) ویرایش‌شده: نسخه‌ی ناشناخته‌ی 9 (offset 4)

خواندن پرونده پیش از اعتماد به بقیه، بایت‌های جادویی و نسخه را بررسی می‌کند و تعدادی را که برای واقعی بودن زیادی بزرگ است رد می‌کند، تا پرونده‌ی خراب نتواند آن را به حلقه‌ای طولانی بیندازد. بعد همه‌ی رکوردها را با تلاش می‌خواند، پس رونوشت ۱۸ بایتی که فقط برای دو امتیاز از سه امتیاز جا دارد، در سومی با جایگاهی که داده در آن تمام شد می‌ایستد. بررسی‌های خودش هم خطا پرتاب می‌کنند، پس صدازننده همه‌ی شکست‌ها را در یک گرفتن خطا می‌گیرد. تغییر بایت ۴ نسخه را ۹ می‌کند که پذیرفته نمی‌شود. برای کل قالب یک ترتیب بایت نگه دارید و آن را در توصیف قالب بنویسید.

راهنما: خواندن سرآیند یک قالب واقعی

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

encoding-binary-guide-png.salam
واردسازی کدگذاری.دودویی
واردسازی فشرده سازی

تابع پی ان جی ساختگی(): فشرده سازی.بافر بایت:
    ناپایا ب := فشرده سازی.بافر بایت جدید()
    امضا := [۱۳۷، ۸۰، ۷۸، ۷۱، ۱۳، ۱۰، ۲۶، ۱۰]
    هر ایکس در امضا:
        دودویی.نوشتن طبیعی۸(ب، ایکس)
    پایان
    دودویی.نوشتن طبیعی۳۲ بزرگ‌انتها(ب، ۱۳)
    فشرده سازی.افزودن بایت‌ها(ب، "IHDR" برگردان تهی*، ۴)
    دودویی.نوشتن طبیعی۳۲ بزرگ‌انتها(ب، ۱۲۸۰)
    دودویی.نوشتن طبیعی۳۲ بزرگ‌انتها(ب، ۷۲۰)
    دودویی.نوشتن طبیعی۸(ب، ۸)
    دودویی.نوشتن طبیعی۸(ب، ۶)
    برگشت ب
پایان

تابع ریشه خطادار:
    ناپایا تصویر := پی ان جی ساختگی()
    دیرکن فشرده سازی.آزادسازی بافر(تصویر)
    ناپایا خ := فشرده سازی.خواننده از بافر(تصویر)
    ب۰ := تلاش دودویی.خواندن طبیعی۸(خ)
    ب۱ := تلاش دودویی.خواندن طبیعی۸(خ)
    اگر ب۰ != ۱۳۷ یا ب۱ != ۸۰:
        پرتاب خطا "PNG نیست"
    پایان
    تکرار ۶:
        _ := تلاش دودویی.خواندن طبیعی۸(خ)
    پایان
    طول تکه := تلاش دودویی.خواندن طبیعی۳۲ بزرگ‌انتها(خ)
    ناپایا نوع تکه := فشرده سازی.خواندن بایت‌ها(خ، ۴)
    سرچاپ "نخستین تکه:"، فشرده سازی.بافر به رشته(نوع تکه)، "با"، طول تکه، "بایت"
    فشرده سازی.آزادسازی بافر(نوع تکه)
    پهنا := تلاش دودویی.خواندن طبیعی۳۲ بزرگ‌انتها(خ)
    بلندی := تلاش دودویی.خواندن طبیعی۳۲ بزرگ‌انتها(خ)
    سرچاپ "اندازه:"، پهنا، "x"، بلندی
    عمق := تلاش دودویی.خواندن طبیعی۸(خ)
    رنگ := تلاش دودویی.خواندن طبیعی۸(خ)
    سرچاپ "عمق بیت:"، عمق، "نوع رنگ:"، رنگ
    تلاش:
        دودویی.خواندن طبیعی۸(خ)
    گرفتن خطا خطای خواندن:
        سرچاپ "باقی IHDR نیامده است:"، خطای خواندن.به رشته()
    پایان
پایان
خروجینخستین تکه: IHDR با 13 بایت اندازه: 1280 x 720 عمق بیت: 8 نوع رنگ: 6 باقی IHDR نیامده است: unexpected end of data: needed 1 byte, 0 left (offset 26)

راهنما: پیام‌های با پیشوند طول

یک اتصال TCP جریانی از بایت‌ها می‌رساند، نه پیام‌های جدا. راه معمول این است که هر پیام با طولش در جلو فرستاده شود، اینجا به شکل عددی ۱۶ بیتی بزرگ‌انتها. خواننده طول را می‌گیرد، با باقیمانده بررسی می‌کند که کل پیام رسیده و تنها آن وقت آن را می‌خواند.

encoding-binary-guide-frames.salam
واردسازی کدگذاری.دودویی
واردسازی فشرده سازی

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

تابع ریشه خطادار:
    ناپایا سیم := فشرده سازی.بافر بایت جدید()
    فرستادن(سیم، "HELLO")
    فرستادن(سیم، "سلام")
    فرستادن(سیم، "")
    فرستادن(سیم، "BYE")
    دودویی.نوشتن طبیعی۱۶ بزرگ‌انتها(سیم، ۱۰)
    فشرده سازی.افزودن بایت‌ها(سیم، "par" برگردان تهی*، ۳)
    سرچاپ "روی سیم:"، فشرده سازی.طول بافر(سیم)، "بایت"

    ناپایا خ := فشرده سازی.خواننده از بافر(سیم)
    تا فشرده سازی.باقیمانده(خ) >= ۲:
        ن := تلاش دودویی.خواندن طبیعی۱۶ بزرگ‌انتها(خ)
        اگر فشرده سازی.باقیمانده(خ) < ن:
            سرچاپ "قاب ناقص است، منتظر داده‌ی بیشتر بمانید"
            بشکن
        پایان
        ناپایا بدنه := فشرده سازی.خواندن بایت‌ها(خ، ن)
        سرچاپ ن، "بایت: [" + فشرده سازی.بافر به رشته(بدنه) + "]"
        فشرده سازی.آزادسازی بافر(بدنه)
    پایان
    فشرده سازی.آزادسازی بافر(سیم)
پایان
خروجیروی سیم: 29 بایت 5 بایت: [HELLO] 8 بایت: [سلام] 0 بایت: [] 3 بایت: [BYE] قاب ناقص است، منتظر داده‌ی بیشتر بمانید

طول بایت‌ها را می‌شمارد، پس سلام ۸ است، نه ۴. قاب آخر می‌گوید ۱۰ بایت دارد ولی فقط ۳ بایت رسیده؛ یک کارساز واقعی این بایت‌ها را نگه می‌دارد و وقتی داده‌ی بیشتری رسید دوباره تلاش می‌کند.

راهنما: اشتباه‌های ترتیب بایت و علامت

خواندن با ترتیب بایت نادرست شکست نمی‌خورد، فقط عدد نادرستی می‌دهد، پس این اشکال‌ها به آسانی از چشم می‌افتند. مقدارهای ۳۲ بیتی بی‌علامت دام دیگری‌اند: در یک صحیح برمی‌گردند، پس هر چیزی از ۲٬۱۴۷٬۴۸۳٬۶۴۸ به بالا منفی دیده می‌شود. آن را به صحیح۶۴ گسترش دهید و با پوشش بیت، مقدار بی‌علامت را بگیرید.

encoding-binary-guide-endian.salam
واردسازی کدگذاری.دودویی
واردسازی فشرده سازی
واردسازی رشته

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

تابع ریشه خطادار:
    ناپایا بزرگ := فشرده سازی.بافر بایت جدید()
    دودویی.نوشتن طبیعی۳۲ بزرگ‌انتها(بزرگ، ۱۰۰۰)
    ناپایا کوچک := فشرده سازی.بافر بایت جدید()
    دودویی.نوشتن طبیعی۳۲ کوچک‌انتها(کوچک، ۱۰۰۰)
    سرچاپ "۱۰۰۰ بزرگ‌انتها: "، بایت‌های(بزرگ)
    سرچاپ "۱۰۰۰ کوچک‌انتها:"، بایت‌های(کوچک)

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

    ناپایا همه یک := فشرده سازی.بافر بایت جدید()
    دودویی.نوشتن طبیعی۳۲ بزرگ‌انتها(همه یک، -۱)
    ناپایا خ۲ := فشرده سازی.خواننده از بافر(همه یک)
    م := تلاش دودویی.خواندن طبیعی۳۲ بزرگ‌انتها(خ۲)
    سرچاپ "u32 0xFFFFFFFF به شکل صحیح:"، م، "بی علامت:"، (م برگردان صحیح۶۴) & ۴۲۹۴۹۶۷۲۹۵

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

    فشرده سازی.آزادسازی بافر(همه یک)
    فشرده سازی.آزادسازی بافر(کوچک)
    فشرده سازی.آزادسازی بافر(بزرگ)
پایان
خروجی۱۰۰۰ بزرگ‌انتها: 0 0 3 232 ۱۰۰۰ کوچک‌انتها: 232 3 0 0 خواندن با ترتیب نادرست: -402456576 u32 0xFFFFFFFF به شکل صحیح: -1 بی علامت: 4294967295 بایت‌های مانده پس از خواندن: 0 یک خواندن دیگر: unexpected end of data: needed 2 bytes, 0 left (offset 4) binary.unexpected_end

در عوض خواندن پس از پایان داده هیچ‌وقت بی‌صدا نیست: آخرین خواندن binary.unexpected_end پرتاب می‌کند. وقتی تمام شدن داده طبیعی است و خطا نیست، اول فشرده سازی.باقیمانده را بررسی کنید، همان‌طور که نمونه‌ی قاب‌ها برای قابی که کامل نرسیده می‌کند.

گونه‌ها

نمای بایت View

ساختار نمای بایت
یک اشاره‌گر و یک طول: پنجره‌ای روی بایت‌هایی که مالکشان چیز دیگری است، مثل یک ByteBuf یا حافظه‌ی mem. گیرنده‌ها و نشاننده‌ها هر دسترسی را با طول می‌سنجند.
نامانگلیسیگونهتوضیح
دادهdataتهی*اولین بایت پنجره.
طولlenصحیح = 0شمار بایت‌های پنجره.
encoding-binary-View.salam
واردسازی کدگذاری.دودویی
واردسازی حافظه

تابع ریشه:
    raw := حافظه.تخصیص صفرشده(32 برگردان طبیعی۶۴)
    دیرکن حافظه.آزادسازی(raw)
    v := دودویی.نمای بایت جدید(raw، 32)
    دودویی.گذاشتن طبیعی۳۲ کوچک‌انتها(v، 0، 0xFEEDFACF برگردان صحیح۶۴)
    دودویی.گذاشتن طبیعی۱۶ بزرگ‌انتها(v، 4، 0x0102 برگردان صحیح۶۴)
    دودویی.گذاشتن طبیعی۸(v، 8، 65 برگردان صحیح۶۴)
    دودویی.گذاشتن طبیعی۸(v، 9، 66 برگردان صحیح۶۴)
    سرچاپ دودویی.گرفتن طبیعی۳۲ کوچک‌انتها(v، 0)، دودویی.گرفتن طبیعی۱۶ بزرگ‌انتها(v، 4)، دودویی.گرفتن طبیعی۱۶ کوچک‌انتها(v، 4)
    سرچاپ دودویی.رشته با صفر پایانی(v، 8)، دودویی.رشته با پهنای ثابت(v، 8، 1)
    سرچاپ دودویی.دارد(v، 30، 2)، دودویی.دارد(v، 31، 2)، دودویی.گرفتن طبیعی۳۲ کوچک‌انتها(v، 31)
پایان
خروجی4277009103 258 513 AB A true false 0

گزینه‌های دودویی BinaryOptions

ساختار گزینه‌های دودویی
گزینه‌های ترتیب بایت. هنوز هیچ تابعی در این بسته این ساختار را نمی‌گیرد.
نامانگلیسیگونهتوضیح
بزرگ‌انتهاbig_endianمنطقی = نادرستاگر درست باشد بزرگ‌انتها؛ پیش‌فرض نادرست.
encoding-binary-ReadWrite.salam
واردسازی کدگذاری.دودویی
واردسازی فشرده سازی

تابع ریشه خطادار:
    ناپایا ب := فشرده سازی.بافر بایت جدید()
    دودویی.نوشتن طبیعی۸(ب، ۲۵۵)
    دودویی.نوشتن طبیعی۱۶ بزرگ‌انتها(ب، ۴۶۶۰)
    دودویی.نوشتن طبیعی۱۶ کوچک‌انتها(ب، ۴۶۶۰)
    دودویی.نوشتن طبیعی۳۲ بزرگ‌انتها(ب، ۱)
    دودویی.نوشتن صحیح۱۶ کوچک‌انتها(ب، -۲)
    سرچاپ فشرده سازی.بافر به پایه۶۴(ب)
    دودویی.نوشتن طبیعی۳۲ کوچک‌انتها(ب، ۷)
    دودویی.نوشتن طبیعی۶۴ بزرگ‌انتها(ب، ۸)
    دودویی.نوشتن طبیعی۶۴ کوچک‌انتها(ب، ۹)
    دودویی.نوشتن صحیح۱۶ بزرگ‌انتها(ب، -۳)
    دودویی.نوشتن صحیح۳۲ بزرگ‌انتها(ب، -۴)
    دودویی.نوشتن صحیح۳۲ کوچک‌انتها(ب، -۵)
    دودویی.نوشتن صحیح۶۴ بزرگ‌انتها(ب، -۶)
    دودویی.نوشتن صحیح۶۴ کوچک‌انتها(ب، -۷)
    دودویی.نوشتن اعشار۶۴(ب، ۱.۵، درست)
    دودویی.نوشتن اعشار۳۲(ب، ۰.۲۵، نادرست)
    سرچاپ فشرده سازی.طول بافر(ب)
    ناپایا خ := فشرده سازی.خواننده از بافر(ب)
    سرچاپ تلاش دودویی.خواندن طبیعی۸(خ)، تلاش دودویی.خواندن طبیعی۱۶ بزرگ‌انتها(خ)، تلاش دودویی.خواندن طبیعی۱۶ کوچک‌انتها(خ)، تلاش دودویی.خواندن طبیعی۳۲ بزرگ‌انتها(خ)، تلاش دودویی.خواندن صحیح۱۶ کوچک‌انتها(خ)
    سرچاپ تلاش دودویی.خواندن طبیعی۳۲ کوچک‌انتها(خ)، تلاش دودویی.خواندن طبیعی۶۴ بزرگ‌انتها(خ)، تلاش دودویی.خواندن طبیعی۶۴ کوچک‌انتها(خ)
    سرچاپ تلاش دودویی.خواندن صحیح۱۶ بزرگ‌انتها(خ)، تلاش دودویی.خواندن صحیح۳۲ بزرگ‌انتها(خ)، تلاش دودویی.خواندن صحیح۳۲ کوچک‌انتها(خ)، تلاش دودویی.خواندن صحیح۶۴ بزرگ‌انتها(خ)، تلاش دودویی.خواندن صحیح۶۴ کوچک‌انتها(خ)
    سرچاپ تلاش دودویی.خواندن اعشار۶۴(خ، درست)، تلاش دودویی.خواندن اعشار۳۲(خ، نادرست)
    تلاش:
        دودویی.خواندن طبیعی۸(خ)
    گرفتن خطا خطای خواندن:
        سرچاپ خطای خواندن.نام نوع()، خطای خواندن.جایگاه، خطای خواندن.کد
    پایان
    گ := دودویی.گزینه‌های دودویی {}
    سرچاپ گ.بزرگ‌انتها
    فشرده سازی.آزادسازی بافر(ب)
پایان
خروجی/xI0NBIAAAAB/v8= 69 255 4660 4660 1 -2 7 8 9 -3 -4 -5 -6 -7 1.5 0.25 unexpected end of input 69 binary.unexpected_end false

تابع‌ها

نمای بایت جدید NewView

تابع نمای بایت جدید(p: تهی*، n: صحیح): نمای بایت
نمایی از n بایت می‌سازد که از p شروع می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

نمای بافر ViewOf

تابع نمای بافر(b: فشرده سازی.بافر بایت): نمای بایت
نمایی از بایت‌های یک ByteBuf می‌سازد. کپی نمی‌کند؛ تا وقتی از نما استفاده می‌کنید بافر را زنده نگه دارید و اندازه‌اش را عوض نکنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

دارد Has

تابع دارد(v: نمای بایت، off: صحیح، n: صحیح): منطقی
درست وقتی n بایت از جابه‌جایی off درون نما می‌افتد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گرفتن طبیعی۸ GetU8

تابع گرفتن طبیعی۸(v: نمای بایت، off: صحیح): صحیح
بایت در off؛ بیرون از نما ۰. وقتی ۰ مقدار ممکن است دارد را بزنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گرفتن طبیعی۱۶ کوچک‌انتها GetU16LE

تابع گرفتن طبیعی۱۶ کوچک‌انتها(v: نمای بایت، off: صحیح): صحیح
عدد طبیعی ۱۶ بیتی در off، کوچک‌انتها؛ بیرون از نما ۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گرفتن طبیعی۱۶ بزرگ‌انتها GetU16BE

تابع گرفتن طبیعی۱۶ بزرگ‌انتها(v: نمای بایت، off: صحیح): صحیح
عدد طبیعی ۱۶ بیتی در off، بزرگ‌انتها؛ بیرون از نما ۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گرفتن طبیعی۳۲ کوچک‌انتها GetU32LE

تابع گرفتن طبیعی۳۲ کوچک‌انتها(v: نمای بایت، off: صحیح): صحیح۶۴
عدد طبیعی ۳۲ بیتی در off، کوچک‌انتها، به‌صورت i64 تا مقدارهای بالاتر از 2^31 مثبت بمانند؛ بیرون از نما ۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گرفتن طبیعی۳۲ بزرگ‌انتها GetU32BE

تابع گرفتن طبیعی۳۲ بزرگ‌انتها(v: نمای بایت، off: صحیح): صحیح۶۴
عدد طبیعی ۳۲ بیتی در off، بزرگ‌انتها؛ بیرون از نما ۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گرفتن طبیعی۶۴ کوچک‌انتها GetU64LE

تابع گرفتن طبیعی۶۴ کوچک‌انتها(v: نمای بایت، off: صحیح): صحیح۶۴
عدد ۶۴ بیتی در off، کوچک‌انتها (مقدارهای بالاتر از 2^63 منفی دیده می‌شوند)؛ بیرون از نما ۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گرفتن طبیعی۶۴ بزرگ‌انتها GetU64BE

تابع گرفتن طبیعی۶۴ بزرگ‌انتها(v: نمای بایت، off: صحیح): صحیح۶۴
عدد ۶۴ بیتی در off، بزرگ‌انتها؛ بیرون از نما ۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گذاشتن طبیعی۸ PutU8

تابع گذاشتن طبیعی۸(v: نمای بایت، off: صحیح، x: صحیح۶۴): منطقی
۸ بیت پایین x را در off می‌نویسد؛ نادرست، بدون نوشتن، وقتی در نما جا نشود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گذاشتن طبیعی۱۶ کوچک‌انتها PutU16LE

تابع گذاشتن طبیعی۱۶ کوچک‌انتها(v: نمای بایت، off: صحیح، x: صحیح۶۴): منطقی
۱۶ بیت پایین x را کوچک‌انتها در off می‌نویسد؛ نادرست وقتی جا نشود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گذاشتن طبیعی۱۶ بزرگ‌انتها PutU16BE

تابع گذاشتن طبیعی۱۶ بزرگ‌انتها(v: نمای بایت، off: صحیح، x: صحیح۶۴): منطقی
۱۶ بیت پایین x را بزرگ‌انتها در off می‌نویسد؛ نادرست وقتی جا نشود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گذاشتن طبیعی۳۲ کوچک‌انتها PutU32LE

تابع گذاشتن طبیعی۳۲ کوچک‌انتها(v: نمای بایت، off: صحیح، x: صحیح۶۴): منطقی
۳۲ بیت پایین x را کوچک‌انتها در off می‌نویسد؛ نادرست وقتی جا نشود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گذاشتن طبیعی۳۲ بزرگ‌انتها PutU32BE

تابع گذاشتن طبیعی۳۲ بزرگ‌انتها(v: نمای بایت، off: صحیح، x: صحیح۶۴): منطقی
۳۲ بیت پایین x را بزرگ‌انتها در off می‌نویسد؛ نادرست وقتی جا نشود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گذاشتن طبیعی۶۴ کوچک‌انتها PutU64LE

تابع گذاشتن طبیعی۶۴ کوچک‌انتها(v: نمای بایت، off: صحیح، x: صحیح۶۴): منطقی
x را ۶۴ بیتی و کوچک‌انتها در off می‌نویسد؛ نادرست وقتی جا نشود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

گذاشتن طبیعی۶۴ بزرگ‌انتها PutU64BE

تابع گذاشتن طبیعی۶۴ بزرگ‌انتها(v: نمای بایت، off: صحیح، x: صحیح۶۴): منطقی
x را ۶۴ بیتی و بزرگ‌انتها در off می‌نویسد؛ نادرست وقتی جا نشود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

رشته با صفر پایانی CStringAt

تابع رشته با صفر پایانی(v: نمای بایت، off: صحیح): رشته
متنی که از off شروع می‌شود و به اولین بایت صفر یا پایان نما می‌رسد، به‌صورت رشته‌ی تازه. بیرون از نما خالی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

رشته با پهنای ثابت FixedStringAt

تابع رشته با پهنای ثابت(v: نمای بایت، off: صحیح، width: صحیح): رشته
متن یک فیلد دقیقاً width بایتی در off، بریده در اولین بایت صفر (مثلاً نام قطعه‌ی Mach-O یا نام بخش ELF). وقتی فیلد جا نشود خالی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-View.salam

نوشتن طبیعی۸ WriteU8

تابع نوشتن طبیعی۸(b &: فشرده سازی.بافر بایت، v: صحیح)
یک بایت می‌نویسد: ۸ بیت پایینی v.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن طبیعی۱۶ بزرگ‌انتها WriteU16BE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن طبیعی۱۶ کوچک‌انتها WriteU16LE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن طبیعی۳۲ بزرگ‌انتها WriteU32BE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن طبیعی۳۲ کوچک‌انتها WriteU32LE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن طبیعی۶۴ بزرگ‌انتها WriteU64BE

تابع نوشتن طبیعی۶۴ بزرگ‌انتها(b &: فشرده سازی.بافر بایت، v: صحیح۶۴)
عدد بدون علامت ۶۴ بیتی را بزرگ‌انتها (پرارزش‌ترین بایت اول) می‌نویسد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن طبیعی۶۴ کوچک‌انتها WriteU64LE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن صحیح۱۶ بزرگ‌انتها WriteI16BE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن صحیح۱۶ کوچک‌انتها WriteI16LE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن صحیح۳۲ بزرگ‌انتها WriteI32BE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن صحیح۳۲ کوچک‌انتها WriteI32LE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن صحیح۶۴ بزرگ‌انتها WriteI64BE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن صحیح۶۴ کوچک‌انتها WriteI64LE

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن اعشار۶۴ WriteF64

تابع نوشتن اعشار۶۴(b &: فشرده سازی.بافر بایت، v: اعشار۶۴، big_endian: منطقی)
عدد اعشاری ۶۴ بیتی IEEE 754 را می‌نویسد؛ big_endian ترتیب بایت را تعیین می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

نوشتن اعشار۳۲ WriteF32

تابع نوشتن اعشار۳۲(b &: فشرده سازی.بافر بایت، v: اعشار۶۴، big_endian: منطقی)
عدد اعشاری ۳۲ بیتی را می‌نویسد؛ هنگام نوشتن، دقت به ۳۲ بیت کم می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن طبیعی۸ ReadU8

تابع خواندن طبیعی۸(r &: فشرده سازی.خواننده بایت): Throws<صحیح>
یک بایت، از ۰ تا ۲۵۵، می‌خواند. مانند همه‌ی خواننده‌های این بسته، وقتی داده تمام شده باشد اتمام ناگهانی (binary.unexpected_end، با جایگاه) پرتاب می‌کند و خواننده را جابه‌جا نمی‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن طبیعی۱۶ بزرگ‌انتها ReadU16BE

تابع خواندن طبیعی۱۶ بزرگ‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح>
عدد بدون علامت ۱۶ بیتی را بزرگ‌انتها (پرارزش‌ترین بایت اول) می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن طبیعی۱۶ کوچک‌انتها ReadU16LE

تابع خواندن طبیعی۱۶ کوچک‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح>
عدد بدون علامت ۱۶ بیتی را کوچک‌انتها (کم‌ارزش‌ترین بایت اول) می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن طبیعی۳۲ بزرگ‌انتها ReadU32BE

تابع خواندن طبیعی۳۲ بزرگ‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح>
عدد ۳۲ بیتی را بزرگ‌انتها (پرارزش‌ترین بایت اول) می‌خواند. خروجی یک صحیح است، پس مقدارهای ۲۳۱ به بالا منفی برمی‌گردند؛ با (v برگردان صحیح۶۴) & 4294967295 آن را بی‌علامت کنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن طبیعی۳۲ کوچک‌انتها ReadU32LE

تابع خواندن طبیعی۳۲ کوچک‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح>
عدد ۳۲ بیتی را کوچک‌انتها (کم‌ارزش‌ترین بایت اول) می‌خواند. مثل خواندن طبیعی۳۲ بزرگ‌انتها، مقدارهای ۲۳۱ به بالا منفی برمی‌گردند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن طبیعی۶۴ بزرگ‌انتها ReadU64BE

تابع خواندن طبیعی۶۴ بزرگ‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح۶۴>
عدد بدون علامت ۶۴ بیتی را بزرگ‌انتها (پرارزش‌ترین بایت اول) می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن طبیعی۶۴ کوچک‌انتها ReadU64LE

تابع خواندن طبیعی۶۴ کوچک‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح۶۴>
عدد بدون علامت ۶۴ بیتی را کوچک‌انتها (کم‌ارزش‌ترین بایت اول) می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن صحیح۱۶ بزرگ‌انتها ReadI16BE

تابع خواندن صحیح۱۶ بزرگ‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح>
عدد علامت‌دار ۱۶ بیتی را بزرگ‌انتها (پرارزش‌ترین بایت اول) می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن صحیح۱۶ کوچک‌انتها ReadI16LE

تابع خواندن صحیح۱۶ کوچک‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح>
عدد علامت‌دار ۱۶ بیتی را کوچک‌انتها (کم‌ارزش‌ترین بایت اول) می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن صحیح۳۲ بزرگ‌انتها ReadI32BE

تابع خواندن صحیح۳۲ بزرگ‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح>
عدد علامت‌دار ۳۲ بیتی را بزرگ‌انتها (پرارزش‌ترین بایت اول) می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن صحیح۳۲ کوچک‌انتها ReadI32LE

تابع خواندن صحیح۳۲ کوچک‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح>
عدد علامت‌دار ۳۲ بیتی را کوچک‌انتها (کم‌ارزش‌ترین بایت اول) می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن صحیح۶۴ بزرگ‌انتها ReadI64BE

تابع خواندن صحیح۶۴ بزرگ‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح۶۴>
عدد علامت‌دار ۶۴ بیتی را بزرگ‌انتها (پرارزش‌ترین بایت اول) می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن صحیح۶۴ کوچک‌انتها ReadI64LE

تابع خواندن صحیح۶۴ کوچک‌انتها(r &: فشرده سازی.خواننده بایت): Throws<صحیح۶۴>
عدد علامت‌دار ۶۴ بیتی را کوچک‌انتها (کم‌ارزش‌ترین بایت اول) می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن اعشار۶۴ ReadF64

تابع خواندن اعشار۶۴(r &: فشرده سازی.خواننده بایت، big_endian: منطقی): Throws<اعشار۶۴>
عدد اعشاری ۶۴ بیتی IEEE 754 را می‌خواند؛ big_endian ترتیب بایت را تعیین می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam

خواندن اعشار۳۲ ReadF32

تابع خواندن اعشار۳۲(r &: فشرده سازی.خواننده بایت، big_endian: منطقی): Throws<اعشار۶۴>
عدد اعشاری ۳۲ بیتی را می‌خواند و آن را به‌صورت اعشار ۶۴ بیتی برمی‌گرداند؛ big_endian ترتیب بایت را تعیین می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-binary-ReadWrite.salam