کدگذاری encoding
تبدیل متن و داده به پایه۶۴، شانزدهشانزدهی و کدگذاری نشانی وب.
واردسازی کدگذاری
نام آرگومانها شناسهی خود کد است و معادل فارسی ندارد؛ گونهها، کلیدواژهها و نام بستهها با معادل فارسی نوشته میشوند.
این بسته راههای رایج نوشتن بایتها به شکل متن ساده را دارد: پایه۶۴ برای جا دادن دادهی دودویی در جیسون یا ایمیل، شانزدهشانزدهی (هگز) برای نمایش بایتها، و کدگذاری نشانی برای گذاشتن متن فارسی یا نویسههای خاص در نشانی وب.
قالبهای بزرگتر، مثل جیسون، یامل و اکسامال، زیربستههای خودشان را دارند که در همین گروه فهرست شدهاند.
همهی تابعها رشته میگیرند و برمیگردانند، بهجز دو شکل «بایت» که برای دادهی دودویی با اشارهگر و طول کار میکنند. بستههای همسایه: دودویی برای عددهایی که در بایتها بستهبندی میشوند، رمزنگاری برای چکیدههایی که سپس به شکل هگز نشانشان میدهید، و جی دبلیو تی برای توکنها.
کدگذارها هیچوقت شکست نمیخورند. کدگشاها، یعنی کدگشایی پایه۶۴، کدگشایی پایه۶۴ به بایت، کدگشایی شانزده و کدگشایی نشانی، خطادار هستند: با ورودی خراب یک خطا پرتاب میکنند که نوع آن نحو (نویسهای که جایش آنجا نیست)، اتمام ناگهانی (متن وسط یک گروه، یک جفت یا یک گریز تمام شده) یا خارج از بازه (میانگیر کوچک است) است، همراه با جایگاه بایتی و خط و ستون مشکل.
اشتباههای رایج:
- کدگشایی دادهی دودویی به
رشته.رشتهدر نخستین بایت صفر تمام میشود، پسکدگشایی پایه۶۴وکدگشایی شانزدهدادهی دودویی را ناقص برمیگردانند؛کدگشایی پایه۶۴ به بایترا با یک میانگیر به کار ببرید. - فراموش کردن اینکه کدگشایی میتواند شکست بخورد. هر فراخوانی کدگشا
تلاشمیخواهد: درون بلوکتلاش:برای رسیدگی به خطا، یا پیش از فراخوانی در تابعی که خودشخطاداراست تا خطا به بالا برود. - انتظار اینکه
کدگشایی شانزدهاز فاصله یا پیشوند0xبگذرد. این تابع برای هر بایت دقیقاً دو رقم هگز میخواند و چیز دیگری نمیپذیرد؛ جداکنندهها را اول بردارید. کدگذاری نشانیفاصله را%20مینویسد، ولیکدگشایی نشانیهم%20و هم+را فاصله میخواند.%ای که دو رقم هگز پس از آن نیاید، مثل50%، خطاست؛ آن را%25بفرستید.
راهنما: سرآیند ورود پایهی HTTP
احراز هویت پایهی HTTP عبارت کاربر:گذرواژه را پس از واژهی Basic به شکل پایه۶۴ میفرستد. پایه۶۴ رمزنگاری نیست و هر کسی میتواند آن را بگشاید، پس این روش فقط روی HTTPS جا دارد. ساختن سرآیند یک فراخوانی است؛ خواندنش در سمت کارساز یعنی گشودن با کدگشایی پایه۶۴ و جدا کردن در نخستین دونقطه، چون خود گذرواژه ممکن است دونقطههای دیگری داشته باشد.
واردسازی کدگذاری
تابع سرآیند پایه(کاربر: رشته، گذرواژه: رشته): رشته:
برگشت "Basic " + کدگذاری.کدگذاری پایه۶۴(کاربر + ":" + گذرواژه)
پایان
تابع خواندن سرآیند(سرآیند: رشته، کاربر &: رشته، گذرواژه &: رشته): منطقی:
اگر سرآیند.بیاب("Basic ") != ۰:
برگشت نادرست
پایان
ناپایا جفت := ""
تلاش:
جفت = کدگذاری.کدگشایی پایه۶۴(سرآیند.زیررشته(۶، سرآیند.طول() - ۶))
گرفتن خطا خ:
سرچاپ "رد شد:"، خ.به رشته()
برگشت نادرست
پایان
دونقطه := جفت.بیاب(":")
اگر دونقطه < ۰:
برگشت نادرست
پایان
کاربر = جفت.زیررشته(۰، دونقطه)
گذرواژه = جفت.زیررشته(دونقطه + ۱، جفت.طول() - دونقطه - ۱)
برگشت درست
پایان
تابع ریشه:
س := سرآیند پایه("sara"، "p@ss:2026")
سرچاپ "Authorization:"، س
ناپایا کاربر := ""
ناپایا گذرواژه := ""
اگر خواندن سرآیند(س، کاربر، گذرواژه):
سرچاپ "کاربر:"، کاربر
سرچاپ "گذرواژه:"، گذرواژه
پایان
سرچاپ "سرآیند خراب پذیرفته شد:"، خواندن سرآیند("Basic !!not-base64!!"، کاربر، گذرواژه)
پایانکدگشایی پایه۶۴ وقتی متن پایه۶۴ معتبر نباشد خطا پرتاب میکند، پس سرآیند خراب رد میشود و به یک نام کاربری بیمعنی تبدیل نمیشود.
راهنما: کدگشای پایه۶۴ چه میپذیرد
کدگشایی پایه۶۴ شکلهایی را که پایه۶۴ در عمل دارد میپذیرد: با پرکننده یا بی آن، با الفبای استاندارد (+ و /) یا الفبای امن برای نشانی (- و _)، و فاصله، تب و شکستن خط در هر جا، چون پروندههای MIME و PEM پایه۶۴ را در ۷۶ یا ۶۴ نویسه میشکنند. هر چیز دیگری خطاست، پس یک غلط تایپی هیچوقت به بایتهای خراب تبدیل نمیشود.
واردسازی کدگذاری
تابع بررسی(برچسب: رشته، متن: رشته):
تلاش:
سرچاپ برچسب، "درست:"، کدگذاری.کدگشایی پایه۶۴(متن)
گرفتن خطا خ:
سرچاپ برچسب، "رد شد:"، خ.نام نوع()، "در ستون"، خ.ستون
پایان
پایان
تابع ریشه:
بررسی("با پرکننده "، "U2FsYW0=")
بررسی("بی پرکننده "، "U2FsYW0")
بررسی("شکسته در خط"، "U2Fs\nYW0=")
بررسی("نشانیامن "، "Pz8_")
بررسی("فارسی "، کدگذاری.کدگذاری پایه۶۴("سلام"))
بررسی("غلط تایپی "، "U2Fs*W0=")
بررسی("نیمهکاره "، "U2FsY")
بررسی("= اضافه "، "U2E===")
پایاننویسهای بیرون از هر دو الفبا خطای نحو در جای خودش است؛ هر چیزی پس از پرکنندهی =، یا = بیش از نیاز گروه آخر، هم همینطور. متنی که یک نویسه پس از شروع یک گروه چهارتایی تمام شود، یا پرکننده را شروع کند و یک = را جا بیندازد، اتمام ناگهانی است. برای دادهی دودویی از کدگذاری بایتها پایه۶۴ و کدگشایی پایه۶۴ به بایت استفاده کنید که با اشارهگر و طول کار میکنند، چون یک رشته در نخستین بایت صفر تمام میشود.
راهنما: دیدن بایتها با شانزدهشانزدهی
شانزدهشانزدهی هر بایت را با دو رقم مینویسد و سادهترین راه برای دیدن محتوای واقعی یک رشته است. حروف فارسی در UTF-8 هر کدام دو بایتاند، پس طول یک واژهی فارسی تعداد بایتها را میشمارد، نه حروف را. شانزدهشانزدهی شکل رایج نوشتن چکیدهها، کلیدها و رنگها هم هست.
واردسازی کدگذاری
تابع ریشه:
واژهها := ["A"، "é"، "س"، "سلام"]
هر واژه در واژهها:
سرچاپ واژه، "برابر"، واژه.طول()، "بایت است:"، کدگذاری.کدگذاری شانزده(واژه)
پایان
ذخیره := "d8b3d984d8a7d985"
تلاش:
سرچاپ "کدگشاییشده:"، کدگذاری.کدگشایی شانزده(ذخیره)
سرچاپ "حروف بزرگ هم کار میکند:"، کدگذاری.کدگشایی شانزده("D8B3D984D8A7D985")
سرچاپ کدگذاری.کدگشایی شانزده("d8b3d")
گرفتن خطا خ:
سرچاپ "خطا:"، خ.به رشته()
پایان
پایانکدگذاری شانزده با حروف کوچک مینویسد و کدگشایی شانزده هر دو شکل را میخواند و با تعداد فرد رقم یا نویسهای که رقم هگز نیست خطا پرتاب میکند.
راهنما: گذاشتن متن در نشانی
مقدار یک پرسش در نشانی نمیتواند فاصله، &، = یا حروف غیر اَسکی را همانطور که هستند داشته باشد. کدگذاری نشانی همه چیز را جز حروف، ارقام و - _ . ~ میگریزاند، پس نتیجه در هر جای نشانی بیخطر است. کدگشایی نشانی کار را برمیگرداند و + را هم مثل فرمهای HTML فاصله میخواند؛ گریز خرابی مثل 50%off آن را به پرتاب خطا وا میدارد.
واردسازی کدگذاری
تابع پیوند(پایه: رشته، پرسش: رشته، شهر: رشته): رشته:
برگشت پایه + "?q=" + کدگذاری.کدگذاری نشانی(پرسش) + "&city=" + کدگذاری.کدگذاری نشانی(شهر)
پایان
تابع ریشه:
نشانی := پیوند("https://example.com/search"، "coffee & cake"، "تهران")
سرچاپ نشانی
تلاش:
تکه := "coffee%20%26%20cake"
سرچاپ "q برابر است با"، کدگذاری.کدگشایی نشانی(تکه)
سرچاپ "بهعلاوه یعنی فاصله:"، کدگذاری.کدگشایی نشانی("tea+time")
سرچاپ "رفت و برگشت:"، کدگذاری.کدگشایی نشانی(کدگذاری.کدگذاری نشانی("a/b?c=d")) == "a/b?c=d"
سرچاپ کدگذاری.کدگشایی نشانی("50%off")
گرفتن خطا خ:
سرچاپ "خطا:"، خ.به رشته()
پایان
پایانهر مقدار را جدا کدگذاری کنید و با & به هم بچسبانید، همانطور که پیوند میکند: کدگذاری کل نشانی یکجا ? و & را هم که ساختار نشانیاند میگریزاند. برای رشتههای پرسش کامل با کلیدهای تکراری بستهی پرسوجو حسابوکتاب را انجام میدهد و بستهی نشانی وب نشانیهای کامل را تجزیه میکند و دوباره میسازد.
کدام کدگذاری برای کدام کار
| کار | به کار ببرید |
|---|---|
| دادهی دودویی درون جیسون، ایمیل یا سرآیند | کدگذاری پایه۶۴، کدگذاری بایتها پایه۶۴ |
| خواندن پایه۶۴ از کاربر یا پرونده | کدگشایی پایه۶۴، کدگشایی پایه۶۴ به بایت |
| چکیدهها، کلیدها، خروجی اشکالزدایی | کدگذاری شانزده، کدگشایی شانزده |
| یک مقدار در مسیر یا پرسش نشانی | کدگذاری نشانی، کدگشایی نشانی |
تابعها
کدگذاری پایه۶۴ Base64Encode
تابع کدگذاری پایه۶۴(data: رشته): رشته= در انتها) تبدیل میکند.واردسازی کدگذاری
واردسازی حافظه
تابع ریشه:
ک := کدگذاری.کدگذاری پایه۶۴("سلام دنیا")
سرچاپ ک
ب := حافظه.تخصیص(۳ برگردان طبیعی۶۴)
حافظه.تنظیم(ب، ۲۵۵، ۳ برگردان طبیعی۶۴)
سرچاپ کدگذاری.کدگذاری بایتها پایه۶۴(ب، ۳)
خروجی := حافظه.تخصیص(۸ برگردان طبیعی۶۴)
تلاش:
سرچاپ کدگذاری.کدگشایی پایه۶۴(ک)
سرچاپ کدگذاری.کدگشایی پایه۶۴("YWJj")، کدگذاری.کدگشایی پایه۶۴("YQ")، کدگذاری.کدگشایی پایه۶۴("Pz8_")
سرچاپ کدگذاری.کدگشایی پایه۶۴ به بایت("AAEC"، خروجی، ۸)
سرچاپ کدگذاری.کدگشایی پایه۶۴("***")
گرفتن خطا خ:
سرچاپ خ.نام نوع() + ": " + خ.به رشته()
پایان
تلاش:
_ := کدگذاری.کدگشایی پایه۶۴ به بایت("AAECAwQF"، خروجی، ۴)
گرفتن خطا خ:
سرچاپ خ.به رشته()
پایان
حافظه.آزادسازی(ب)
حافظه.آزادسازی(خروجی)
پایانکدگذاری بایتها پایه۶۴ Base64EncodeBytes
تابع کدگذاری بایتها پایه۶۴(data: تهی*، n: صحیح): رشتهn بایت از حافظه را به پایه۶۴ تبدیل میکند.نمونهی این مورد همراه با موارد بالاتر آمده است: encoding-Base64.salam
کدگشایی پایه۶۴ Base64Decode
تابع کدگشایی پایه۶۴(s: رشته): Throws<رشته>+/) و امن برای نشانی (-_) خوانده میشوند، پرکننده اختیاری است و فاصله نادیده گرفته میشود. برای هر نویسهی دیگر، داده پس از پرکنندهی = یا پرکنندهی بیش از اندازه نحو پرتاب میکند، و وقتی متن یک نویسه پس از شروع گروه تمام شود یا یک = کم داشته باشد اتمام ناگهانی؛ خطا جایگاه، خط و ستون را دارد.نمونهی این مورد همراه با موارد بالاتر آمده است: encoding-Base64.salam
کدگذاری شانزده HexEncode
تابع کدگذاری شانزده(data: رشته): رشتهواردسازی کدگذاری
تابع ریشه:
ش := کدگذاری.کدگذاری شانزده("Hi!")
سرچاپ کدگذاری.مقدار شانزده("f")، کدگذاری.مقدار شانزده("A")، کدگذاری.مقدار شانزده("z")
ن := کدگذاری.کدگذاری نشانی("نام=علی & سن=۳۰")
سرچاپ ن
تلاش:
سرچاپ ش، کدگذاری.کدگشایی شانزده(ش)
سرچاپ کدگذاری.کدگشایی نشانی(ن)
سرچاپ کدگذاری.کدگشایی شانزده("4869z1")
گرفتن خطا خ:
سرچاپ خ.به رشته()
پایان
تلاش:
سرچاپ کدگذاری.کدگشایی نشانی("100%")
گرفتن خطا خ:
سرچاپ خ.به رشته()
پایان
پایانمقدار شانزده HexVal
تابع مقدار شانزده(c: رشته): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: encoding-Hex.salam
کدگشایی شانزده HexDecode
تابع کدگشایی شانزده(s: رشته): Throws<رشته>نحو و وقتی تعداد رقمها فرد باشد اتمام ناگهانی پرتاب میکند.نمونهی این مورد همراه با موارد بالاتر آمده است: encoding-Hex.salam
کدگذاری نشانی URLEncode
تابع کدگذاری نشانی(s: رشته): رشته-_.~ دستنخورده میمانند و فاصله %20 میشود.نمونهی این مورد همراه با موارد بالاتر آمده است: encoding-Hex.salam
کدگشایی نشانی URLDecode
تابع کدگشایی نشانی(s: رشته): Throws<رشته>+ را فاصله میکند. وقتی پس از % دو رقم هگز نیاید نحو و وقتی متن وسط یک گریز تمام شود اتمام ناگهانی پرتاب میکند.نمونهی این مورد همراه با موارد بالاتر آمده است: encoding-Hex.salam
کدگشایی پایه۶۴ به بایت Base64DecodeBytes
تابع کدگشایی پایه۶۴ به بایت(s: رشته، out: تهی*، cap: صحیح): Throws<صحیح>کدگشایی پایه۶۴ میخواند، در حافظهی out با ظرفیت cap کدگشایی میکند و تعداد بایتهای نوشتهشده را برمیگرداند. همان خطاهای کدگشایی پایه۶۴ را پرتاب میکند، و وقتی داده بیش از cap بایت لازم داشته باشد خارج از بازه.نمونهی این مورد همراه با موارد بالاتر آمده است: encoding-Base64.salam