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

کدگذاری.یولید encoding.ulid

شناسه‌های یکتای مرتب‌شونده: متن و شکل دودویی ULID، تولیدکننده‌ی یکنوای ایمن برای نخ‌ها و کران‌های بازه برای پرس‌وجو.

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

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

ULID شناسه‌ای ۱۲۸ بیتی است که از زمان ۴۸ بیتی به میلی‌ثانیه و ۸۰ بیت تصادفی ساخته می‌شود و با ۲۶ نویسه‌ی پایه‌ی ۳۲ کراکفورد نوشته می‌شود. جایگزین مرتب‌شونده‌ی UUID تصادفی است: متن به همان ترتیبی که شناسه‌ها ساخته شده‌اند مرتب می‌شود، پس نمایه‌ی پایگاه داده فشرده می‌ماند و یک بازه‌ی زمانی یک بازه از شناسه‌هاست. این بسته از مشخصات ULID پیروی می‌کند و با سلام نوشته شده است.

متن از رقم‌ها و حرف‌ها بدون I و L و O و U ساخته می‌شود. بزرگ‌ترین شناسه 7ZZZZZZZZZZZZZZZZZZZZZZZZZ است، چون برای ۱۲۸ بیت ۱۳۰ بیت به کار می‌رود. تجزیه حروف کوچک را می‌پذیرد، I و L را ۱ و O را ۰ می‌خواند و U و هر چیز بزرگ‌تر از آن شناسه را رد می‌کند.

بخشچیست
ULIDخود مقدار: time و دو نیمه‌ی ۴۰ بیتی تصادف. با Compare و Equal و Less مقایسه کنید.
New و NewString و NewBatchشناسه از تولیدکننده‌ی پیش‌فرض. در یک برنامه اکیداً صعودی و از هر تعداد نخ ایمن.
Generatorتولیدکننده‌ی یکنوای مشخصات، با یک قفل دور آخرین شناسه. NewGeneratorWith ساعت و تصادف شما را می‌گیرد.
Parse و Stringمتن به شناسه و برعکس. Bytes و FromBytes همان ۱۶ بایت را می‌دهند که بایت‌های یک UUID هم هست.
FromPartsیک زمان و ۱۰ بایت داده‌شده: بدون تصادف، برای آزمون دقیق.
MinAt و MaxAtاولین و آخرین شناسه‌ی یک میلی‌ثانیه، کران‌های پرس‌وجوی بازه‌ای.

ساخت، چاپ و خواندن دوباره

New شناسه‌ی بعدی تولیدکننده‌ی پیش‌فرض را می‌دهد و String ۲۶ نویسه را می‌نویسد. NewAt شناسه‌ای برای زمان دلخواه می‌سازد. هر شناسه یک مقدار است: رونوشتش کنید، مقایسه‌اش کنید و در ساختار نگه دارید.

encoding-ulid-guide-basics.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

تابع ریشه:
    شناسه := یولید.جدید()
    متن := یولید.رشته(شناسه)
    سرچاپ "length:"، متن.طول()
    عقب := یولید.تجزیه(متن)
    سرچاپ "round trip:"، عقب.موفق و یولید.برابر است(عقب.شناسه، شناسه)
    سرچاپ "close to now:"، یولید.زمان شناسه(شناسه) - یولید.اکنون() کوچکتر 5000
    ستامپ := یولید.جدید برای(1469918176385)
    سرچاپ یولید.رشته(ستامپ.شناسه).طول()، یولید.زمان شناسه(ستامپ.شناسه)
پایان
خروجیlength: 26 round trip: true close to now: true 26 1469918176385

تجزیه و قاعده‌های متن

Parse از مشخصات پیروی می‌کند: حروف کوچک و I و L و O پذیرفته می‌شوند، U نه، و نویسه‌ی اول نباید بیشتر از ۷ باشد چون مقدار در ۱۲۸ بیت جا نمی‌شود. ParseStrict دقیقاً همان چیزی را می‌خواهد که String می‌نویسد. خطاها کدند و ErrorText پیامش را می‌دهد.

encoding-ulid-guide-parse.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

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

تابع ریشه:
    نمایش("01ARYZ6S41TSV4RRFFQ69G5FAV")
    نمایش("01aryz6s41tsv4rrffq69g5fav")
    نمایش("O1ARYZ6S41TSV4RRFFQ69G5FAV")
    نمایش("7ZZZZZZZZZZZZZZZZZZZZZZZZZ")
    نمایش("80000000000000000000000000")
    نمایش("01ARYZ6S41TSV4RRFFQ69G5FAU")
    نمایش("01ARYZ6S41")
    سرچاپ یولید.تجزیه سخت گیرانه("01aryz6s41tsv4rrffq69g5fav").موفق
    سرچاپ یولید.تجزیه سخت گیرانه("01ARYZ6S41TSV4RRFFQ69G5FAV").موفق
پایان
خروجی01ARYZ6S41TSV4RRFFQ69G5FAV -> 1469918176385 01ARYZ6S41TSV4RRFFQ69G5FAV 01aryz6s41tsv4rrffq69g5fav -> 1469918176385 01ARYZ6S41TSV4RRFFQ69G5FAV O1ARYZ6S41TSV4RRFFQ69G5FAV -> 1469918176385 01ARYZ6S41TSV4RRFFQ69G5FAV 7ZZZZZZZZZZZZZZZZZZZZZZZZZ -> 281474976710655 7ZZZZZZZZZZZZZZZZZZZZZZZZZ 80000000000000000000000000 -> ULID value is larger than 7ZZZZZZZZZZZZZZZZZZZZZZZZZ 01ARYZ6S41TSV4RRFFQ69G5FAU -> invalid character in ULID 01ARYZ6S41 -> a ULID is 26 characters false true

ترتیب و پرس‌وجوی بازه‌ای

ترتیب متن همان ترتیب زمان است، پس شناسه‌ها با یک مرتب‌سازی ساده‌ی رشته مرتب می‌شوند. برای انتخاب شناسه‌های یک بازه‌ی زمانی هر چه میان MinAt(start) و MaxAt(end) است را بخواهید؛ در SQL یک BETWEEN روی ستون شناسه است.

encoding-ulid-guide-order.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

تابع ریشه:
    ناپایا یدس := وکتور {} برگردان وکتور<یولید.شناسه یولید>
    دیرکن یدس.آزادسازی()
    ناپایا مارک := 1700000000000 برگردان صحیح۶۴
    تکرار 4:
        یدس.افزودن(یولید.کمینه برای(مارک))
        مارک += 1500
    پایان
    تکرار یدس.طول() در ی:
        سرچاپ یولید.رشته(یدس.دریافت(ی))
    پایان

    لوو := یولید.کمینه برای(1700000001000)
    هیگه := یولید.بیشینه برای(1700000003000)
    سرچاپ "range:"، یولید.رشته(لوو)، یولید.رشته(هیگه)
    تکرار یدس.طول() در ی:
        ینسیدی := یولید.مقایسه(یدس.دریافت(ی)، لوو) بزرگتربرابر 0 و یولید.مقایسه(یدس.دریافت(ی)، هیگه) کوچکتربرابر 0
        سرچاپ ی، ینسیدی
    پایان
پایان
خروجی01HF7YAT000000000000000000 01HF7YAVEW0000000000000000 01HF7YAWXR0000000000000000 01HF7YAYCM0000000000000000 range: 01HF7YATZ80000000000000000 01HF7YAWXRZZZZZZZZZZZZZZZZ 0 false 1 true 2 true 3 false

تولیدکننده‌ی یکنوا

دو شناسه‌ای که در یک میلی‌ثانیه ساخته شوند باید به همان ترتیب ساخته‌شدن مرتب شوند. Generator همان کاری را می‌کند که مشخصات می‌گوید: در میلی‌ثانیه‌ی تازه تصادف تازه می‌گیرد، در همان میلی‌ثانیه یک واحد به بخش تصادفی آخر می‌افزاید و وقتی ساعت عقب می‌رود زمان آخر را نگه می‌دارد. اگر ۸۰ بیت سرریز شود، به‌جای شکست زمان یک میلی‌ثانیه جلو می‌رود. نمونه ساعت جعلی و تابع تصادف ثابت دارد تا همه‌ی نویسه‌ها معلوم باشند.

encoding-ulid-guide-monotonic.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

ناپایا اکنون مس := 1000 برگردان صحیح۶۴
ناپایا کهونک := 7 برگردان صحیح۶۴

تابع کلوکک(): صحیح۶۴:
    برگشت اکنون مس
پایان

تابع سوورکی(): صحیح۶۴:
    برگشت کهونک
پایان

تابع ریشه:
    گ := یولید.تولیدکننده جدید با((): برگشت کلوکک() پایان، (): برگشت سوورکی() پایان)
    دیرکن یولید.آزادکن(گ)
    تکرار 3:
        سرچاپ یولید.رشته(یولید.بعدی(گ).شناسه)
    پایان
    اکنون مس = 1001
    کهونک = 9
    سرچاپ یولید.رشته(یولید.بعدی(گ).شناسه)
    اکنون مس = 900
    آخر := یولید.بعدی(گ)
    سرچاپ "clock went back:"، یولید.زمان شناسه(آخر.شناسه)، یولید.رشته(آخر.شناسه)
    سرچاپ یولید.رشته(یولید.افزایش(آخر.شناسه).شناسه)
پایان
خروجی00000000Z80000000700000007 00000000Z80000000700000008 00000000Z80000000700000009 00000000Z90000000900000009 clock went back: 1001 00000000Z9000000090000000A 00000000Z9000000090000000B

چند نخ

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

encoding-ulid-guide-threads.salam
// زبان: فارسی
واردسازی کدگذاری.یولید
واردسازی استخر
واردسازی حافظه

پایا وورکیرس := 8
پایا یاکه := 500

تابع ریشه:
    ووت := حافظه.تخصیص صفرشده((وورکیرس * یاکه * 3 * 8) برگردان طبیعی۶۴) برگردان صحیح۶۴*
    سهارید := یولید.پیش فرض()
    استخر.برای موازی(وورکیرس برگردان صحیح۶۴، 4 برگردان صحیح۶۴، (تاسک: صحیح۶۴):
        تکرار یاکه در ک:
            شناسه := یولید.جدید()
            سلوت := ((تاسک * یاکه + ک) * 3) برگردان صحیح
            ووت[سلوت] = شناسه.زمان
            ووت[سلوت + 1] = شناسه.بالا
            ووت[سلوت + 2] = شناسه.پایین
        پایان
    پایان)
    ناپایا سیین := نگاشت {} برگردان نگاشت<رشته، منطقی>
    دیرکن سیین.آزادسازی()
    تکرار وورکیرس * یاکه در ن:
        شناسه := یولید.شناسه یولید { زمان = ووت[ن * 3]، بالا = ووت[ن * 3 + 1]، پایین = ووت[ن * 3 + 2] }
        سیین.قراردادن(یولید.رشته(شناسه)، درست)
    پایان
    سرچاپ "ids:"، وورکیرس * یاکه، "distinct:"، سیین.اندازه()
    سرچاپ یولید.آخرین(سهارید).موفق
    حافظه.آزادسازی(ووت برگردان تهی*)
پایان
خروجیids: 4000 distinct: 4000 true

وقتی منبع تصادف شکست می‌خورد

منبع داخلی مولد تصادف سیستم‌عامل را با crypto.RandomBytes می‌خواند، که اگر سیستم بایت تصادفی ندهد برنامه را متوقف می‌کند: شناسه‌ی ضعیف هرگز ساخته نمی‌شود. منبع خودتان که به NewGeneratorWith می‌دهید می‌تواند با برگرداندن عدد منفی مؤدبانه شکست بخورد. آنگاه Next کد ERR_ENTROPY برمی‌گرداند و تولیدکننده را دست‌نخورده می‌گذارد، پس فراخوانی بعدی می‌تواند موفق شود.

encoding-ulid-guide-entropy.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

ناپایا فایلینگ := درست

تابع کلوکک(): صحیح۶۴:
    برگشت 5000
پایان

تابع سوورکی(): صحیح۶۴:
    اگر فایلینگ:
        برگشت -1
    پایان
    برگشت 123456
پایان

تابع ریشه:
    گ := یولید.تولیدکننده جدید با((): برگشت کلوکک() پایان، (): برگشت سوورکی() پایان)
    دیرکن یولید.آزادکن(گ)
    ر := یولید.بعدی(گ)
    سرچاپ ر.موفق، ر.خطا برابر یولید.خطای تصادف، یولید.متن خطا(ر.خطا)
    سرچاپ "state untouched:"، یولید.آخرین(گ).موفق
    فایلینگ = نادرست
    وک := یولید.بعدی(گ)
    سرچاپ وک.موفق، یولید.رشته(وک.شناسه)
پایان
خروجیfalse true the entropy source failed state untouched: false true 00000004W800003RJ000003RJ0

بایت‌ها، UUID و شناسه‌های ثابت

Bytes ۱۶ بایت بزرگ‌پایان می‌دهد، هم‌اندازه‌ی یک UUID، و FromBytes آن را برمی‌گرداند؛ بسته به نوع UUID وابسته نیست و فقط به بایت‌ها کار دارد. FromParts از یک زمان و ۱۰ بایت دلخواه شناسه می‌سازد که آزمون‌ها با آن جواب دقیق می‌گیرند. بردارهای بایت را آزاد کنید.

encoding-ulid-guide-bytes.salam
// زبان: فارسی
واردسازی کدگذاری.یولید
واردسازی رشته

تابع هیکس(داده: وکتور<طبیعی۸>): رشته:
    دیگیتس := "0123456789abcdef"
    ناپایا ووت := ""
    تکرار داده.طول() در ی:
        کودی := داده.دریافت(ی) برگردان صحیح
        ووت = ووت + رشته.زیررشته(دیگیتس، کودی / 16، 1) + رشته.زیررشته(دیگیتس، کودی % 16، 1)
    پایان
    برگشت ووت
پایان

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

    ناپایا سیید := وکتور {} برگردان وکتور<طبیعی۸>
    دیرکن سیید.آزادسازی()
    تکرار 10 در ی:
        سیید.افزودن((ی * 3) برگردان طبیعی۸)
    پایان
    مادی := یولید.از اجزا(1469918176385، سیید)
    سرچاپ یولید.رشته(مادی.شناسه)
    پارت := یولید.بخش تصادفی(مادی.شناسه)
    دیرکن پارت.آزادکن()
    سرچاپ هیکس(پارت)
پایان
خروجی16 01563df36481d6764c61efb99302bd5b true 01ARYZ6S41TSV4RRFFQ69G5FAV 01ARYZ6S41001GC28C1W91A60V 000306090c0f1215181b

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

  • انتظار ترتیب از NewAt در یک میلی‌ثانیه. وضعیتی نگه نمی‌دارد؛ از Generator استفاده کنید.
  • راز دانستن زمان. ۱۰ نویسه‌ی اول زمان ساخت است و هر کس شناسه را ببیند می‌خواندش.
  • مقایسه‌ی متن با حروف کوچک یا نام‌های جایگزین بدون Parse: 01arz و 01ARZ یک شناسه‌اند اما دو رشته‌ی متفاوت.
  • فراموش کردن Free برای تولیدکننده یا آزاد نکردن بردارهای Bytes و Entropy و Batch.
  • مقایسه‌ی شناسه‌های تولیدکننده‌ها یا ماشین‌های گوناگون برای ترتیب دقیق: ساعت‌ها فرق دارند، پس فقط شناسه‌های یک تولیدکننده اکیداً مرتب‌اند.

گونه‌ها

شناسه یولید ULID

ساختار شناسه یولید
شناسه‌ای ۱۲۸ بیتی: زمان ۴۸ بیتی به میلی‌ثانیه و ۸۰ بیت تصادفی. یک مقدار ساده است و آزادانه رونوشت می‌شود. ترتیب شناسه‌ها همان ترتیب زمان آن‌هاست.
نامانگلیسیگونهتوضیح
زمانtimeصحیح۶۴ = 0زمان به میلی‌ثانیه از مبدأ یونیکس.
بالاhiصحیح۶۴ = 0۴۰ بیت بالای ۸۰ بیت تصادفی.
پایینloصحیح۶۴ = 0۴۰ بیت پایین ۸۰ بیت تصادفی.
encoding-ulid-Bytes.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

تابع ریشه:
    ر := یولید.تجزیه("01ARYZ6S41TSV4RRFFQ69G5FAV")
    ناپایا خام := یولید.بایت ها(ر.شناسه)
    دیرکن خام.آزادکن()
    سرچاپ خام.طول()، خام.بگیر(0)، خام.بگیر(15)
    برگشته := یولید.از بایت ها(خام)
    سرچاپ برگشته.موفق، یولید.برابر است(برگشته.شناسه، ر.شناسه)
    ناپایا سیم := یولید.به بایت های یو یو آی دی(ر.شناسه)
    دیرکن سیم.آزادکن()
    سرچاپ سیم.طول()، یولید.برابر است(یولید.از بایت های یو یو آی دی(سیم).شناسه، ر.شناسه)
    ناپایا دم := یولید.بخش تصادفی(ر.شناسه)
    دیرکن دم.آزادکن()
    سرچاپ دم.طول()، ر.شناسه.بالا، ر.شناسه.پایین
    ناپایا کوتاه := وکتور {} برگردان وکتور<طبیعی۸>
    دیرکن کوتاه.آزادکن()
    کوتاه.افزودن(1 برگردان طبیعی۸)
    سرچاپ یولید.از بایت ها(کوتاه).خطا برابر یولید.خطای بایت
پایان
خروجی16 1 91 true true 16 true 10 921107718639 797035380059 true

نتیجه Result

ساختار نتیجه
آنچه تجزیه و تولیدکننده‌ها برمی‌گردانند: ok، id و کد err.
نامانگلیسیگونهتوضیح
موفقokمنطقی = نادرستدرست اگر کار انجام شد.
شناسهidشناسه یولیدشناسه؛ اگر ok نادرست باشد شناسه‌ی صفر.
خطاerrصحیح = 0یکی از کدهای خطا، و OK در حالت موفق.
encoding-ulid-Parse.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

تابع ریشه:
    ر := یولید.تجزیه("01arYz6s41TsV4RrffQ69g5fav")
    سرچاپ ر.موفق، یولید.زمان شناسه(ر.شناسه)، یولید.رشته(ر.شناسه)
    باد := یولید.تجزیه("01ARYZ6S41TSV4RRFFQ69G5FAU")
    سرچاپ باد.موفق، باد.خطا برابر یولید.خطای نویسه
    سرچاپ یولید.تجزیه سخت گیرانه("01arYz6s41TsV4RrffQ69g5fav").موفق
    سرچاپ یولید.معتبر است("7ZZZZZZZZZZZZZZZZZZZZZZZZZ")، یولید.معتبر است("8ZZZZZZZZZZZZZZZZZZZZZZZZZ")
پایان
خروجیtrue 1469918176385 01ARYZ6S41TSV4RRFFQ69G5FAV false true false true false

تولیدکننده Generator

ساختار تولیدکننده
یک تولیدکننده‌ی یکنوا. قفل و آخرین شناسه‌اش را نگه می‌دارد، پس رونوشت‌های یک تولیدکننده وضعیت را به اشتراک می‌گذارند و هر تعداد نخ می‌تواند آن را صدا بزند. با Free آزادش کنید.
نامانگلیسیگونهتوضیح
وضعیتstateصحیح۶۴*آخرین زمان و بخش‌های تصادفی مشترک، پشت قفل.
قفلmuهمگام سازی.قفلقفلی که از وضعیت نگهبانی می‌کند.
ساعتclockتابع(): صحیح۶۴تابعی که زمان فعلی را به میلی‌ثانیه برمی‌گرداند.
تصادفentropyتابع(): صحیح۶۴تابعی که ۴۰ بیت تصادفی برمی‌گرداند یا هنگام خطا عددی منفی.
encoding-ulid-Next.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

ناپایا تیکک := 100 برگردان صحیح۶۴

تابع کلوکک(): صحیح۶۴:
    برگشت تیکک
پایان

تابع سوورکی(): صحیح۶۴:
    برگشت 1
پایان

تابع ریشه:
    گ := یولید.تولیدکننده جدید با((): برگشت کلوکک() پایان، (): برگشت سوورکی() پایان)
    دیرکن یولید.آزادکن(گ)
    اول := یولید.بعدی(گ)
    سیکوند := یولید.بعدی(گ)
    سرچاپ یولید.رشته(اول.شناسه)
    سرچاپ یولید.رشته(سیکوند.شناسه)
    سرچاپ یولید.کوچکتر است(اول.شناسه، سیکوند.شناسه)
    فورکید := یولید.بعدی برای(گ، 50)
    سرچاپ یولید.زمان شناسه(فورکید.شناسه)، یولید.کوچکتر است(سیکوند.شناسه، فورکید.شناسه)
پایان
خروجی00000000340000000100000001 00000000340000000100000002 true 100 true

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

بیشینه زمان MAX_TIME

پایا بیشینه زمان: صحیح۶۴ = 281474976710655
بزرگ‌ترین زمانی که یک ULID نگه می‌دارد: ۲۸۱۴۷۴۹۷۶۷۱۰۶۵۵ میلی‌ثانیه (۴۸ بیت)، یعنی سال ۱۰۸۸۹.
encoding-ulid-Errors.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

تابع ریشه:
    هر کد در [یولید.بدون خطا، یولید.خطای طول، یولید.خطای نویسه، یولید.خطای سرریز، یولید.خطای زمان، یولید.خطای تصادف، یولید.خطای بایت، 99]:
        سرچاپ کد، یولید.متن خطا(کد)
    پایان
    ر := یولید.تجزیه("short")
    سرچاپ ر.موفق، ر.خطا، یولید.صفر است(ر.شناسه)
    سرچاپ یولید.بیشینه زمان
    بالا := یولید.بیشینه برای(یولید.بیشینه زمان)
    سرچاپ بالا.زمان، بالا.بالا، بالا.پایین
پایان
خروجی0 ok 1 a ULID is 26 characters 2 invalid character in ULID 3 ULID value is larger than 7ZZZZZZZZZZZZZZZZZZZZZZZZZ 4 timestamp is outside 0 to 281474976710655 5 the entropy source failed 6 wrong number of bytes 99 unknown error false 1 true 281474976710655 281474976710655 1099511627775 1099511627775

بدون خطا OK

پایا بدون خطا: صحیح۳۲ = 0
کد خطای ۰: خطایی رخ نداده است.

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

خطای طول ERR_LENGTH

پایا خطای طول: صحیح۳۲ = 1
متن ۲۶ نویسه نیست.

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

خطای نویسه ERR_CHAR

پایا خطای نویسه: صحیح۳۲ = 2
متن نویسه‌ای بیرون از الفبای کراکفورد دارد، مثل U.

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

خطای سرریز ERR_OVERFLOW

پایا خطای سرریز: صحیح۳۲ = 3
مقدار از 7ZZZZZZZZZZZZZZZZZZZZZZZZZ بزرگ‌تر است (نویسه‌ی اول بیشتر از ۷) یا افزایش از ۸۰ بیت تصادفی بیرون می‌زند.

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

خطای زمان ERR_TIME

پایا خطای زمان: صحیح۳۲ = 4
زمان بیرون از بازه‌ی ۰ تا MAX_TIME است.

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

خطای تصادف ERR_ENTROPY

پایا خطای تصادف: صحیح۳۲ = 5
منبع تصادف خطا داد؛ شناسه‌ای ساخته نشد و وضعیت تولیدکننده تغییر نکرد.

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

خطای بایت ERR_BYTES

پایا خطای بایت: صحیح۳۲ = 6
فهرست بایت‌ها طول نادرست دارد (۱۶ برای FromBytes و ۱۰ برای FromParts).

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

تابع‌ها

از اجزا FromParts

تابع از اجزا(ms: صحیح۶۴، entropy: وکتور<طبیعی۸>): نتیجه
از یک زمان و دقیقاً ۱۰ بایت تصادف شناسه می‌سازد، بدون هیچ تصادفی، تا آزمون‌ها همه‌ی نویسه‌ها را بدانند.
encoding-ulid-FromParts.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

تابع ریشه:
    ناپایا سیید := وکتور {} برگردان وکتور<طبیعی۸>
    دیرکن سیید.آزادسازی()
    تکرار 10 در ی:
        سیید.افزودن((ی + 1) برگردان طبیعی۸)
    پایان
    ر := یولید.از اجزا(1469918176385، سیید)
    سرچاپ ر.موفق، یولید.رشته(ر.شناسه)
    سرچاپ یولید.از اجزا(-1، سیید).موفق، یولید.از اجزا(یولید.بیشینه زمان + 1، سیید).موفق
    سرچاپ یولید.رشته(یولید.از اجزا(یولید.بیشینه زمان، سیید).شناسه)
پایان
خروجیtrue 01ARYZ6S41041061050R3GG28A false false 7ZZZZZZZZZ041061050R3GG28A

از بایت ها FromBytes

تابع از بایت ها(b: وکتور<طبیعی۸>): نتیجه
شکل دودویی ۱۶ بایتی را می‌خواند (۶ بایت زمان و ۱۰ بایت تصادف، بزرگ‌پایان).

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

از بایت های یو یو آی دی FromUUIDBytes

تابع از بایت های یو یو آی دی(b: وکتور<طبیعی۸>): نتیجه
همان FromBytes: یک ULID در ۱۶ بایت یک UUID جا می‌شود.

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

رشته String

تابع رشته(id: شناسه یولید): رشته
متن استاندارد ۲۶ نویسه‌ای، پایه‌ی ۳۲ کراکفورد با حروف بزرگ.
encoding-ulid-New.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

تابع ریشه:
    الف := یولید.جدید()
    ب := یولید.رشته جدید()
    سرچاپ یولید.رشته(الف).طول()، ب.طول()
    سرچاپ یولید.کوچکتر است(الف، یولید.تجزیه(ب).شناسه)
    ی := یولید.جدید برای(1469918176385)
    سرچاپ ی.موفق، یولید.زمان شناسه(ی.شناسه)، ی.شناسه.زمان
    سرچاپ یولید.جدید برای(یولید.بیشینه زمان + 1).خطا برابر یولید.خطای زمان
    سرچاپ یولید.اکنون() بزرگتر 1700000000000
    پایانی := یولید.آخرین(یولید.پیش فرض())
    سرچاپ پایانی.موفق، یولید.کوچکتر است(الف، پایانی.شناسه)
    تازه := یولید.تولیدکننده جدید()
    دیرکن یولید.آزادکن(تازه)
    سرچاپ یولید.آخرین(تازه).خطا برابر یولید.خطای زمان
پایان
خروجی26 26 true true 1469918176385 1469918176385 true true true true true

بایت ها Bytes

تابع بایت ها(id: شناسه یولید): وکتور<طبیعی۸>
شکل دودویی ۱۶ بایتی. بردار را آزاد کنید.

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

به بایت های یو یو آی دی ToUUIDBytes

تابع به بایت های یو یو آی دی(id: شناسه یولید): وکتور<طبیعی۸>
همان ۱۶ بایت، برای کدی که آن را به شکل UUID نگه می‌دارد یا می‌فرستد.

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

بخش تصادفی Entropy

تابع بخش تصادفی(id: شناسه یولید): وکتور<طبیعی۸>
۱۰ بایت تصادفی. بردار را آزاد کنید.

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

زمان شناسه Time

تابع زمان شناسه(id: شناسه یولید): صحیح۶۴
زمان به میلی‌ثانیه.

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

مقایسه Compare

تابع مقایسه(a: شناسه یولید، b: شناسه یولید): صحیح
-1 و 0 یا 1 نخست بر پایه‌ی زمان و سپس بخش تصادفی.
encoding-ulid-Compare.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

تابع ریشه:
    یارلی := یولید.کمینه برای(1000)
    لاتی := یولید.بیشینه برای(1000)
    سرچاپ یولید.مقایسه(یارلی، لاتی)، یولید.مقایسه(لاتی، یارلی)، یولید.مقایسه(یارلی، یارلی)
    سرچاپ یولید.رشته(یارلی)
    سرچاپ یولید.رشته(لاتی)
    سرچاپ یولید.صفر است(یولید.کمینه برای(0))، یولید.صفر است(یارلی)
    گام := یولید.افزایش(یارلی)
    سرچاپ یولید.رشته(گام.شناسه)
    سرچاپ یولید.افزایش(لاتی).موفق
پایان
خروجی-1 1 0 00000000Z80000000000000000 00000000Z8ZZZZZZZZZZZZZZZZ true false 00000000Z80000000000000001 false

برابر است Equal

تابع برابر است(a: شناسه یولید، b: شناسه یولید): منطقی
درست اگر دو شناسه یکی باشند.

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

کوچکتر است Less

تابع کوچکتر است(a: شناسه یولید، b: شناسه یولید): منطقی
درست اگر شناسه‌ی اول قدیمی‌تر باشد یا در همان زمان بخش تصادفی کوچک‌تری داشته باشد.

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

صفر است IsZero

تابع صفر است(id: شناسه یولید): منطقی
درست برای شناسه‌ی تماماً صفر.

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

کمینه برای MinAt

تابع کمینه برای(ms: صحیح۶۴): شناسه یولید
کوچک‌ترین شناسه‌ی یک میلی‌ثانیه (بخش تصادفی همه صفر). کران پایین پرس‌وجوی بازه‌ای. زمان به بازه‌ی ۰ تا MAX_TIME بریده می‌شود.

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

بیشینه برای MaxAt

تابع بیشینه برای(ms: صحیح۶۴): شناسه یولید
بزرگ‌ترین شناسه‌ی یک میلی‌ثانیه (بخش تصادفی همه یک)، کران بالای پرس‌وجوی بازه‌ای.

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

افزایش Increment

تابع افزایش(id: شناسه یولید): نتیجه
شناسه‌ی بلافاصله بعد از این، با بخش تصادفی یکی بیشتر. اگر از قبل همه یک باشد با ERR_OVERFLOW شکست می‌خورد.

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

تجزیه Parse

تابع تجزیه(s: رشته): نتیجه
۲۶ نویسه را می‌خواند. حروف کوچک پذیرفته می‌شوند، I و L یعنی ۱ و O یعنی ۰، U رد می‌شود و نویسه‌ی اول بیشتر از ۷ خطای ERR_OVERFLOW است.

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

تجزیه سخت گیرانه ParseStrict

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

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

تجزیه با پیش فرض ParseOr

تابع تجزیه با پیش فرض(s: رشته، fallback: شناسه یولید): شناسه یولید
Parse، یا شناسه‌ی جایگزین اگر متن معتبر نباشد.

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

معتبر است IsValid

تابع معتبر است(s: رشته): منطقی
درست اگر Parse متن را بپذیرد.

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

تولیدکننده جدید NewGenerator

تابع تولیدکننده جدید(): تولیدکننده
تولیدکننده با ساعت سیستم و منبع تصادف سیستم‌عامل.

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

تولیدکننده جدید با NewGeneratorWith

تابع تولیدکننده جدید با(clock: تابع(): صحیح۶۴، entropy: تابع(): صحیح۶۴): تولیدکننده
تولیدکننده با تابع‌های ساعت و تصادف خودتان، برای آزمون و منبع‌هایی که می‌توانند شکست بخورند. تابع تصادف ۴۰ بیت تصادفی (۰ تا ۱۰۹۹۵۱۱۶۲۷۷۷۵) یا هنگام خطا عددی منفی برمی‌گرداند که Next را به ERR_ENTROPY می‌رساند.

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

بعدی Next

تابع بعدی(g: تولیدکننده): نتیجه
شناسه‌ی بعدی یک تولیدکننده. در میلی‌ثانیه‌ی تازه بخش تصادفی تازه است؛ در همان میلی‌ثانیه یا هنگام عقب رفتن ساعت، بخش تصادفی قبلی یکی زیاد می‌شود. اگر ۸۰ بیت تمام شود زمان یک میلی‌ثانیه جلو می‌رود. از چند نخ ایمن است.

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

بعدی برای NextAt

تابع بعدی برای(g: تولیدکننده، ms: صحیح۶۴): نتیجه
مانند Next اما زمان داده می‌شود و از ساعت خوانده نمی‌شود. زمانی پیش از آخرین شناسه، زمان آخرین شناسه را نگه می‌دارد.

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

دسته Batch

تابع دسته(g: تولیدکننده، n: صحیح): وکتور<شناسه یولید>
n شناسه زیر یک قفل و با یک بار خواندن ساعت می‌سازد. منبع تصادفِ خراب دسته را زودتر تمام می‌کند، پس طول را بررسی کنید. بردار را آزاد کنید.
encoding-ulid-Batch.salam
// زبان: فارسی
واردسازی کدگذاری.یولید

تابع ریشه:
    یدس := یولید.دسته جدید(5)
    دیرکن یدس.آزادکن()
    ناپایا ینکریاسینگ := یدس.طول() برابر 5
    تکرار یدس.طول() - 1 در ی:
        اگر وارونه یولید.کوچکتر است(یدس.بگیر(ی)، یدس.بگیر(ی + 1)):
            ینکریاسینگ = نادرست
        پایان
    پایان
    سرچاپ یدس.طول()، ینکریاسینگ
پایان
خروجی5 true

آخرین Last

تابع آخرین(g: تولیدکننده): نتیجه
آخرین شناسه‌ای که تولیدکننده ساخته، یا ERR_TIME اگر هنوز نساخته باشد.

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

آزادکن Free

تابع آزادکن(g: تولیدکننده)
تولیدکننده‌ی ساخته‌شده با NewGenerator یا NewGeneratorWith را آزاد می‌کند.

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

پیش فرض Default

تابع پیش فرض(): تولیدکننده
تولیدکننده‌ی سراسری برنامه که پشت New و NewString و NewBatch است. آزادش نکنید.

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

جدید New

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

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

رشته جدید NewString

تابع رشته جدید(): رشته
کوتاه‌شده‌ی String(New()).

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

جدید برای NewAt

تابع جدید برای(ms: صحیح۶۴): نتیجه
شناسه برای میلی‌ثانیه‌ی دلخواه با بیت‌های تصادفی تازه. وضعیتی نگه نمی‌دارد، پس دو فراخوانی در یک میلی‌ثانیه مرتب نیستند؛ اگر ترتیب مهم است از Generator استفاده کنید. بیرون از ۰ تا MAX_TIME با ERR_TIME شکست می‌خورد.

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

دسته جدید NewBatch

تابع دسته جدید(n: صحیح): وکتور<شناسه یولید>
n شناسه از تولیدکننده‌ی پیش‌فرض زیر یک قفل می‌سازد، پس پشت‌سرهم و صعودی‌اند. بردار را آزاد کنید.

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

متن خطا ErrorText

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

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

اکنون Now

تابع اکنون(): صحیح۶۴
ساعت سیستم به میلی‌ثانیه از مبدأ یونیکس، در بازه‌ی ۰ تا MAX_TIME.

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