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

نوع‌ها types

تشخیص نوع مقدار از روی متن: عدد صحیح است، اعشاری، منطقی یا متن معمولی؟

واردسازی نوع‌ها

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

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

بررسی‌ها اول فاصله‌های دو سر را برمی‌دارند و رقم‌های فارسی و عربی را انگلیسی می‌کنند، پس ۳۴ عدد صحیح است. هر نوع یکی از پنج ثابت صحیح است: خالی (متن تهی)، منطقی، صحیح، اعشاری و رشته. نوعِ آن‌ها را به همین ترتیب امتحان می‌کند، پس true منطقی است و 12 صحیح، هیچ‌وقت اعشاری.

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

  • گمان این‌که گذشتن از بررسی یعنی مقدار جا می‌شود. صحیح است فقط نویسه‌ها را می‌بیند، پس عددی ۲۰ رقمی می‌گذرد و بعد تبدیل.تجزیه عدد روی آن خطای خارج از بازه پرتاب می‌کند.
  • انتظار این‌که yes، 1، on یا «بله» منطقی باشند. فقط true و false با هر بزرگی و کوچکی حرف پذیرفته می‌شوند.
  • انتظار این‌که متنِ فقط فاصله، خالی حساب شود. فقط متن با طول صفر نوع خالی است؛ سه فاصله یک رشته است.

بررسی ورودی فرم پیش از تبدیل

فیلد فرم متن است و تبدیل.تجزیه عدد روی متن نادرستی مثل 12abc یا abc خطای نحو پرتاب می‌کند. بررسی‌های این بسته به همان پرسش بی‌آن‌که خطایی برای گرفتن باشد پاسخ می‌دهند: صحیح است، عددی است و منطقی است می‌گویند تبدیل معنا دارد یا نه، تا بتوانید پیش از آن پیام روشنی به کاربر نشان دهید. رقم فارسی از این بررسی‌ها رد می‌شود و تابع‌های بسته‌ی تبدیل هم آن را می‌خوانند؛ این نمونه باز هم رشته.به رقم انگلیسی را اجرا می‌کند تا متنی که نگه می‌دارد فقط رقم انگلیسی داشته باشد. ممیز فارسی ٫ را عددی است می‌پذیرد ولی به رقم انگلیسی عوضش نمی‌کند، پس خودتان آن را با نقطه جایگزین کنید.

types-guide-form.salam
واردسازی رشته
واردسازی تبدیل
واردسازی نوع‌ها

تابع ریشه خطادار:
    سن := "۳۴"
    قیمت := "۱۲٫۵"
    تعداد := "12.0"
    عضویت := " بله "
    اگر نوع‌ها.صحیح است(سن):
        سرچاپ "سن:"، تلاش تبدیل.تجزیه عدد(رشته.به رقم انگلیسی(سن))
    پایان
    اگر نوع‌ها.عددی است(قیمت):
        پاک := رشته.جایگزینی(رشته.به رقم انگلیسی(قیمت)، "٫"، ".")
        سرچاپ "قیمت دو تا:"، (تلاش تبدیل.تجزیه اعشار(پاک)) * ۲.۰
    پایان
    اگر نوع‌ها.صحیح است(تعداد) برابر نادرست:
        سرچاپ "تعداد باید عدد صحیح باشد، ولی"، تعداد، "آمده که از نوع"، نوع‌ها.نام نوع(نوع‌ها.نوعِ(تعداد))، "است"
    پایان
    اگر نوع‌ها.منطقی است(عضویت) برابر نادرست:
        سرچاپ "عضویت باید true یا false باشد، ولی [" + عضویت + "] آمده"
    پایان
پایان
خروجیسن: 34 قیمت دو تا: 25 تعداد باید عدد صحیح باشد، ولی 12.0 آمده که از نوع float است عضویت باید true یا false باشد، ولی [ بله ] آمده

بررسی‌ها درباره‌ی نویسه‌ها سخت‌گیرند: 12.0 اعشاری است نه صحیح، و «بله» منطقی نیست. فاصله‌ی دور مقدار را هم بررسی‌ها نادیده می‌گیرند و هم تبدیل.تجزیه عدد، ولی پیش از ذخیره کردن، متن را خودتان با رشته.پیرایش تمیز کنید.

شاخه زدن بر اساس نوع مقدار

نوعِ یکی از پنج ثابت نوع را برمی‌گرداند که برای ترابرد مناسب است. متن خالی نوع خودش را دارد، نوع خالی، پس مقدار جاافتاده می‌تواند به جای متن حساب شدن، به مقدار پیش‌فرض برگردد. نماد علمی مثل 1e3 اعشاری حساب می‌شود.

types-guide-config.salam
واردسازی رشته
واردسازی نوع‌ها

تابع ریشه:
    خط‌ها := ["port = 8080"، "ratio = 0.75"، "debug = false"، "name = فروشگاه"، "retries = -3"، "timeout ="، "limit = 1e3"]
    هر خط در خط‌ها:
        بخش‌ها := رشته.تفکیک کردن(خط، "=")
        کلید := رشته.پیرایش(بخش‌ها.بگیر(۰))
        مقدار := رشته.پیرایش(بخش‌ها.بگیر(۱))
        ن := نوع‌ها.نوعِ(مقدار)
        ترابرد ن:
            نوع‌ها.نوع صحیح:
                سرچاپ کلید، "عدد صحیح است:"، مقدار
                بشکن
            پایان
            نوع‌ها.نوع اعشاری:
                سرچاپ کلید، "عدد اعشاری است:"، مقدار
                بشکن
            پایان
            نوع‌ها.نوع منطقی:
                سرچاپ کلید، "کلید روشن و خاموش است:"، رشته.کوچک(مقدار)
                بشکن
            پایان
            نوع‌ها.نوع خالی:
                سرچاپ کلید، "مقدار ندارد، پیش‌فرض به کار می‌رود"
                بشکن
            پایان
            وگرنه:
                سرچاپ کلید، "متن است:"، مقدار
            پایان
        پایان
    پایان
پایان
خروجیport عدد صحیح است: 8080 ratio عدد اعشاری است: 0.75 debug کلید روشن و خاموش است: false name متن است: فروشگاه retries عدد صحیح است: -3 timeout مقدار ندارد، پیش‌فرض به کار می‌رود limit عدد اعشاری است: 1e3

حدس زدن نوع ستون‌های CSV

پیش از وارد کردن یک پرونده‌ی CSV به پایگاه داده، برای هر ستون یک نوع لازم دارید. همه‌ی خانه‌ها را ببینید و حدس را در طول کار گسترده‌تر کنید: عدد صحیح و اعشاری با هم ستون اعشاری می‌سازند، هر متنی ستون را متنی می‌کند و خانه‌ی خالی حدس را تغییر نمی‌دهد. نام نوع نتیجه را به نامی برای گزارش یا دستور CREATE TABLE تبدیل می‌کند.

types-guide-columns.salam
واردسازی رشته
واردسازی نوع‌ها

تابع گسترده‌تر(قبلی: صحیح، خانه: رشته): صحیح:
    ن := نوع‌ها.نوعِ(رشته.پیرایش(خانه))
    اگر ن برابر نوع‌ها.نوع خالی: برگشت قبلی پایان
    اگر قبلی برابر نوع‌ها.نوع خالی یا قبلی برابر ن: برگشت ن پایان
    اگر (قبلی برابر نوع‌ها.نوع صحیح و ن برابر نوع‌ها.نوع اعشاری) یا (قبلی برابر نوع‌ها.نوع اعشاری و ن برابر نوع‌ها.نوع صحیح):
        برگشت نوع‌ها.نوع اعشاری
    پایان
    برگشت نوع‌ها.نوع رشته
پایان

تابع ریشه:
    ردیف‌ها := ["id,name,price,stock,active"، "1,چای,4.5,120,true"، "2,قهوه,7,,false"، "3,کاکائو,5.25,80,TRUE"، "4,ماته,۶,n/a,true"]
    سرستون := رشته.تفکیک کردن(ردیف‌ها[۰]، ",")
    ناپایا نوع ستون‌ها := وکتور {} برگردان وکتور<صحیح>
    دیرکن نوع ستون‌ها.آزادکن()
    تکرار سرستون.طول():
        نوع ستون‌ها.بیفزا(نوع‌ها.نوع خالی)
    پایان
    تکرار ۱ تا ردیف‌ها.طول() - ۱ در ر:
        خانه‌ها := رشته.تفکیک کردن(ردیف‌ها[ر]، ",")
        هر س، خانه در خانه‌ها:
            نوع ستون‌ها.بنشان(س، گسترده‌تر(نوع ستون‌ها.بگیر(س)، خانه))
        پایان
    پایان
    هر س، نام در سرستون:
        سرچاپ نام، "->"، نوع‌ها.نام نوع(نوع ستون‌ها.بگیر(س))
    پایان
پایان
خروجیid -> int name -> string price -> float stock -> string active -> bool

مقایسه‌ی دو وکتور

دو وکتور را نمی‌شود با برابر مقایسه کرد؛ کامپایلر آن را نمی‌پذیرد (خطای E021). یکسان مقایسه‌شان می‌کند: طول برابر و عضوهای برابر به همان ترتیب. این تابع عمومی است، پس برای وکتور<صحیح>، وکتور<رشته> و دیگر گونه‌هایی که برابر دارند کار می‌کند و در آزمون‌های کوچک به درد می‌خورد.

types-guide-equal.salam
واردسازی رشته
واردسازی نوع‌ها

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

تابع بسنج(برچسب: رشته، گرفته: وکتور<رشته>، خواسته: وکتور<رشته>):
    اگر نوع‌ها.یکسان(گرفته، خواسته):
        سرچاپ "قبول"، برچسب
    وگرنه:
        سرچاپ "رد"، برچسب، "گرفته"، گرفته.طول()، "واژه، خواسته"، خواسته.طول()
    پایان
پایان

تابع ریشه:
    ناپایا خواسته := وکتور {} برگردان وکتور<رشته>
    دیرکن خواسته.آزادکن()
    خواسته.بیفزا("سلام")
    خواسته.بیفزا("دنیا")
    الف := واژه‌ها("سلام دنیا")
    ب := واژه‌ها("  سلام   دنیا ")
    ج := واژه‌ها("سلام دنیای بزرگ")
    دیرکن الف.آزادکن()
    دیرکن ب.آزادکن()
    دیرکن ج.آزادکن()
    بسنج("فاصله‌ی تکی"، الف، خواسته)
    بسنج("فاصله‌ی اضافه"، ب، خواسته)
    بسنج("سه واژه"، ج، خواسته)
پایان
خروجیقبول فاصله‌ی تکی قبول فاصله‌ی اضافه رد سه واژه گرفته 3 واژه، خواسته 2

آن‌چه بررسی‌ها نمی‌گیرند

بررسی به این پرسش جواب می‌دهد که «این متن شبیه عدد است؟»، نه این‌که «برای این فیلد مقدار درستی است؟». درگاه شبکه، سن یا تعداد پس از بررسی نوع، بررسی بازه‌ی جداگانه‌ای لازم دارد، و بررسی طول پیش از تجزیه جلوی عددهای بزرگ‌تر از صحیح را می‌گیرد. اول رقم‌ها را انگلیسی کنید، چون هر رقم فارسی دو بایت است و طول را دو برابر نشان می‌دهد. تابع زیر تنظیم درگاه را به عدد تبدیل می‌کند: برای مقدار خالی پیش‌فرض و برای هر مقدار نادرست -۱ برمی‌گرداند.

types-guide-limits.salam
واردسازی رشته
واردسازی تبدیل
واردسازی نوع‌ها

تابع درگاه از(متن: رشته، پیش‌فرض: صحیح): صحیح:
    م := رشته.به رقم انگلیسی(رشته.پیرایش(متن))
    اگر م.طول() برابر ۰: برگشت پیش‌فرض پایان
    اگر نوع‌ها.صحیح است(م) برابر نادرست یا م.طول() بزرگتر ۵: برگشت -۱ پایان
    ع := تبدیل.تجزیه عدد با پیش فرض(م، -۱)
    اگر ع کوچکتر ۱ یا ع بزرگتر ۶۵۵۳۵: برگشت -۱ پایان
    برگشت ع برگردان صحیح
پایان

تابع ریشه:
    سرچاپ "متن فقط فاصله:"، نوع‌ها.نام نوع(نوع‌ها.نوعِ("   "))
    سرچاپ "1e اعشاری است:"، نوع‌ها.اعشاری است("1e")
    سرچاپ "عدد ۲۰ رقمی صحیح است:"، نوع‌ها.صحیح است("99999999999999999999")
    سرچاپ "بله منطقی است:"، نوع‌ها.منطقی است("بله")
    هر خام در ["8080"، " ۴۴۳ "، ""، "70000"، "99999999999999999999"، "80a"]:
        سرچاپ "[" + خام + "] ->"، درگاه از(خام، ۳۰۰۰)
    پایان
پایان
خروجیمتن فقط فاصله: string 1e اعشاری است: true عدد ۲۰ رقمی صحیح است: true بله منطقی است: false [8080] -> 8080 [ ۴۴۳ ] -> 443 [] -> 3000 [70000] -> -1 [99999999999999999999] -> -1 [80a] -> -1

1e از اعشاری است می‌گذرد، چون بررسی توانِ بدون رقم پس از e را هم می‌پذیرد؛ اما تبدیل.تجزیه اعشار آن را با خطای نحو رد می‌کند، چون توان باید رقم داشته باشد. به جای اعتماد به این بررسی به تنهایی، تجزیه را درون تلاش انجام دهید.

پرسشتابع
این متن می‌تواند صحیح شود؟صحیح است
می‌تواند به هر نوع عددی تبدیل شود؟عددی است
true است یا false؟منطقی است
از چه نوعی است، برای ترابرد؟نوعِ و برای چاپ نام نوع
دو وکتور مقدارهای یکسان دارند؟یکسان

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

نوع خالی TypeKindNull

پایا نوع خالی: صحیح۳۲ = 0
نوع متن خالی، ۰. متنی که فقط فاصله دارد نوع رشته است، نه این.
types-KindOf.salam
واردسازی نوع‌ها

تابع ریشه:
    هر م در ["۴۲"، "3.5"، "true"، "سلام"، ""]:
        ن := نوع‌ها.نوعِ(م)
        سرچاپ "[" + م + "]"، ن، نوع‌ها.نام نوع(ن)، نوع‌ها.صحیح است(م)، نوع‌ها.اعشاری است(م)، نوع‌ها.عددی است(م)، نوع‌ها.منطقی است(م)
    پایان
    سرچاپ نوع‌ها.نوعِ("7") == نوع‌ها.نوع صحیح، نوع‌ها.نوع خالی، نوع‌ها.نوع منطقی، نوع‌ها.نوع اعشاری، نوع‌ها.نوع رشته
پایان
خروجی[۴۲] 2 int true false true false [3.5] 3 float false true true false [true] 1 bool false false false true [سلام] 4 string false false false false [] 0 null false false false false true 0 1 3 4

نوع منطقی TypeKindBool

پایا نوع منطقی: صحیح۳۲ = 1
نوع مقدار منطقی (true یا false)، ۱.

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

نوع صحیح TypeKindInt

پایا نوع صحیح: صحیح۳۲ = 2
نوع عدد صحیح، ۲.

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

نوع اعشاری TypeKindFloat

پایا نوع اعشاری: صحیح۳۲ = 3
نوع عدد اعشاری، ۳.

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

نوع رشته TypeKindStr

پایا نوع رشته: صحیح۳۲ = 4
هر متن دیگر، ۴.

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

تابع‌ها

صحیح است IsInt

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

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

اعشاری است IsFloat

تابع اعشاری است(s: رشته): منطقی
اگر متن عدد اعشاری باشد درست برمی‌گرداند: رقم‌ها با یک . یا ممیز فارسی ٫ (هم .5 و هم 5.)، یا نماد علمی مثل 2e5. عدد صحیح این‌جا حساب نمی‌شود. توانِ بی‌رقم مثل 1e را هم می‌پذیرد.

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

عددی است IsNumeric

تابع عددی است(s: رشته): منطقی
اگر متن عدد صحیح یا اعشاری باشد، یعنی صحیح است یا اعشاری است، درست برمی‌گرداند. inf و nan این‌جا عدد نیستند.

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

منطقی است IsBool

تابع منطقی است(s: رشته): منطقی
اگر متن پس از پیرایش true یا false باشد، با هر بزرگی و کوچکی حرف، درست برمی‌گرداند. yes، 1 و واژه‌های فارسی پذیرفته نیستند.

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

نوعِ KindOf

تابع نوعِ(s: رشته): صحیح
نوع متن را به شکل یکی از ثابت‌های بالا برمی‌گرداند و خالی، منطقی، صحیح و اعشاری را به همین ترتیب امتحان می‌کند.

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

نام نوع KindName

تابع نام نوع(k: صحیح): رشته
نام انگلیسی یک نوع را برمی‌گرداند: null، bool، int، float یا string. هر عدد دیگری هم string می‌دهد.

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

یکسان Equal

تابع یکسان<T>(a: وکتور<T>، b: وکتور<T>): منطقی
اگر دو وکتور هم‌طول باشند و عضوهایشان به همان ترتیب برابر، درست برمی‌گرداند. تابعی عمومی است و گونه‌ای از عضو می‌خواهد که برابر داشته باشد.
types-Equal.salam
واردسازی نوع‌ها

تابع ریشه:
    ناپایا الف := وکتور {} برگردان وکتور<صحیح>
    ناپایا ب := وکتور {} برگردان وکتور<صحیح>
    دیرکن الف.آزادکن()
    دیرکن ب.آزادکن()
    الف.بیفزا(۱)
    الف.بیفزا(۲)
    ب.بیفزا(۱)
    ب.بیفزا(۲)
    سرچاپ نوع‌ها.یکسان(الف، ب)
    ب.بیفزا(۳)
    سرچاپ نوع‌ها.یکسان(الف، ب)
پایان
خروجیtrue false