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

رشته str

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

واردسازی رشته

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

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

پیش از شروع یک نکته را بدانید: رشته‌های سلام UTF-8 هستند. در UTF-8 هر حرف انگلیسی یک بایت است، اما هر حرف فارسی دو بایت. برای همین بیشتر تابع‌ها دو نسخه دارند: تابع‌هایی مثل طول، زیررشته و اندیس با بایت کار می‌کنند و سریع‌اند، و تابع‌هایی مثل شمارنویسه، زیررشته نویسه و بیاب نویسه با حرف کار می‌کنند. برای متن فارسی، هر جا شمارش یا برش به چشم کاربر مهم است، نسخه‌ی حرفی را به کار ببرید.

یک قدم دورتر، «خوشه» است: آنچه خواننده یک حرف می‌بیند. «کَ» دو نویسه است (ک و فتحه) اما یک خوشه، و شکلک خانواده هفت نویسه است اما یک خوشه. برای برعکس کردن یا بریدن متنی که اعراب یا شکلک دارد، تابع‌های خوشه‌ای مطمئن‌ترند.

سه روش هم روی خود هر رشته هست و واردسازی نمی‌خواهد: متن.شروع با("سلام")، متن.ختم با(".txt") و متن.دربردارد("دنیا"). هر سه درست یا نادرست برمی‌گردانند و در همه‌ی پشتیبان‌ها یکسان کار می‌کنند.

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

چند نکته که معمولاً غافلگیر می‌کند:

  • بزرگ و کوچک فقط حرف‌های ASCII یعنی A تا Z را عوض می‌کنند: بزرگ("café") می‌شود CAFé. برای خط‌های دیگر، هر نقطه‌ی کد را با تابع‌های تبدیل بزرگی و کوچکی بسته‌ی یونیکد عوض کنید؛ برای مقایسه بدون حساسیت به بزرگی حرف، یکسان بدون حساسیت را به کار ببرید که قاعده‌های کامل یونیکد را رعایت می‌کند.
  • پیرایش و هم‌خانواده‌هایش فقط فاصله، تب، بازگشت به سر سطر و خط تازه‌ی ASCII را برمی‌دارند. فاصله‌ی نشکن (U+00A0)، که در متن کپی‌شده از وب زیاد است، می‌ماند.
  • رشته در نخستین بایت صفر تمام می‌شود؛ پس داده‌ی دودویی که از این تابع‌ها رد شود همان‌جا بریده می‌شود.
  • هر تابعی که رشته برمی‌گرداند رشته‌ای تازه می‌سازد و ورودی را هرگز تغییر نمی‌دهد.

ساختن نامک نشانی از روی عنوان

نامک بخش خوانای یک نشانی وب است، مثل /blog/hello-world. برای ساختنش حروف را کوچک کنید، حرف و رقم را نگه دارید و هر رشته‌ای از چیزهای دیگر را به یک خط تیره تبدیل کنید. کار با نقطه‌های کد، با کدنقطه ها و الفبایی عددی است، حرف‌های همه‌ی خط‌ها را نگه می‌دارد؛ پس عنوان فارسی نامک فارسی می‌دهد، نه نامک خالی.

str-guide-slug.salam
واردسازی رشته

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

تابع ریشه:
    سرچاپ نامک("Hello, World!")
    سرچاپ نامک("  10 Tips for Faster   Builds ")
    سرچاپ نامک("سلام ۰.۵: چه چیزهایی تازه است؟")
    سرچاپ نامک("سلام دنیا، به سلام خوش آمدید")
پایان
خروجیhello-world 10-tips-for-faster-builds سلام-۰-۵-چه-چیزهایی-تازه-است سلام-دنیا-به-سلام-خوش-آمدید

سازنده رشته نتیجه را جمع می‌کند بی‌آن‌که برای هر حرف رشته‌ی تازه‌ای بسازد؛ افزودن کدنقطه به بافر یک نقطه‌ی کد را به شکل UTF-8 می‌افزاید و رشته بافر متن نهایی را برمی‌گرداند. در متن فارسی یک چیز را بپایید: نیم‌فاصله (U+200C) درون واژه‌ای مثل می‌شود حرف نیست، پس این تابع واژه را همان‌جا دو تکه می‌کند. اگر می‌خواهید نگهش دارید، در شرط، کد ۸۲۰۴ را هم مثل حرف حساب کنید.

شمردن واژه‌ها

واژه ها روی هر رشته‌ای از فاصله‌ها می‌شکند و تکه‌های خالی را دور می‌ریزد؛ برای واژه‌ها همین را می‌خواهید. تفکیک کردن با " " برای هر فاصله‌ی دوتایی یک واژه‌ی خالی می‌دهد. اول نشانه‌گذاری را به فاصله تبدیل کنید (برای متن لاتین حروف را هم کوچک کنید)، بعد با یک نگاشت بشمارید. یک وکتور جداگانه ترتیب نخستین دیده‌شدن واژه‌ها را نگه می‌دارد، چون نگاشت ترتیبی از خودش ندارد.

str-guide-words.salam
واردسازی رشته

تابع ریشه:
    متن := "گربه نشست. سگ هم نشست، و گربه دوید! سگ ماند."
    پاک := رشته.جایگزینی(رشته.جایگزینی(رشته.جایگزینی(متن، "."، " ")، "،"، " ")، "!"، " ")
    واژه‌ها := رشته.واژه ها(پاک)
    دیرکن واژه‌ها.آزادکن()
    ناپایا شمار := نگاشت {} برگردان نگاشت<رشته، صحیح>
    دیرکن شمار.آزادکن()
    ناپایا ترتیب := وکتور {} برگردان وکتور<رشته>
    دیرکن ترتیب.آزادکن()
    هر و۱ در واژه‌ها:
        اگر شمار.دارد(و۱):
            شمار.درج(و۱، شمار.بگیر(و۱) + ۱)
        وگرنه:
            شمار.درج(و۱، ۱)
            ترتیب.بیفزا(و۱)
        پایان
    پایان
    سرچاپ واژه‌ها.طول()، "واژه،"، ترتیب.طول()، "واژه‌ی متفاوت"
    هر و۱ در ترتیب:
        اگر شمار.بگیر(و۱) > ۱:
            سرچاپ و۱، شمار.بگیر(و۱)
        پایان
    پایان
پایان
خروجی10 واژه، 7 واژه‌ی متفاوت گربه 2 نشست 2 سگ 2

هر جایگزینی رشته‌ی تازه‌ای برمی‌گرداند. برای فهرست بلندی از نویسه‌هایی که باید حذف شوند، یک بار گذشتن از کدنقطه ها با نشانه نگارشی است از زنجیره‌ی جایگزینی تمیزتر است. متن فارسی را پیش از شمردن از عربی.کلید جستجو بگذرانید تا املاهای گوناگون یک واژه با هم شمرده شوند.

ساختن CSV با سازنده‌ی رشته

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

str-guide-csv.salam
واردسازی رشته

تابع فیلد سی اس وی(ر: رشته): رشته:
    اگر رشته.شامل است(ر، ",") یا رشته.شامل است(ر، "\"") یا رشته.شامل است(ر، "\n"):
        برگشت "\"" + رشته.جایگزینی(ر، "\""، "\"\"") + "\""
    پایان
    برگشت ر
پایان

تابع افزودن ردیف(ب &: رشته.سازنده رشته، خانه‌ها: رشته[]):
    هر ش، خانه در خانه‌ها:
        اگر ش > ۰:
            رشته.افزودن به بافر(ب، ",")
        پایان
        رشته.افزودن به بافر(ب، فیلد سی اس وی(خانه))
    پایان
    رشته.افزودن به بافر(ب، "\n")
پایان

تابع ریشه:
    ناپایا ب := رشته.سازنده()
    دیرکن رشته.آزادسازی بافر(ب)
    افزودن ردیف(ب، ["نام"، "شهر"، "یادداشت"])
    افزودن ردیف(ب، ["علی"، "تهران"، "چای دوست دارد"])
    افزودن ردیف(ب، ["سارا"، "شیراز, فارس"، "گفت \"سلام\""])
    چاپ رشته.رشته بافر(ب)
پایان
خروجینام,شهر,یادداشت علی,تهران,چای دوست دارد سارا,"شیراز, فارس","گفت ""سلام"""

سازنده با &: فرستاده می‌شود تا افزودن ردیف به سازنده‌ی صدازننده بیفزاید، نه به یک رونوشت. وقتی کارتان تمام شد یک بار با آزادسازی بافر آزادش کنید. ویرگول CSV همان ویرگول لاتین , است، نه ، فارسی. برای خواندن دوباره‌ی CSV یا پرونده‌هایی با گیومه‌گذاری عجیب، از encoding.csv استفاده کنید.

تجزیه‌ی فرمان‌های گفتگو

یک ربات یا یک کنسول خط‌هایی مثل /say صبح بخیر می‌خواند. پیرایش فاصله‌های اضافه‌ی دو سر خط را برمی‌دارد، شروع با فرمان را از پیام عادی جدا می‌کند و اندیس نخستین فاصله را پیدا می‌کند که فرمان را از آرگومانش جدا می‌کند. یکسان بدون حساسیت بی‌توجه به حروف بزرگ و کوچک مقایسه می‌کند، پس /HELP و /help یک کار می‌کنند.

str-guide-commands.salam
واردسازی رشته

تابع رسیدگی(خط: رشته): رشته:
    متن := رشته.پیرایش(خط)
    اگر وارونه رشته.شروع با(متن، "/"):
        برگشت "گفتگو: " + متن
    پایان
    فاصله := رشته.اندیس(متن، " ")
    ناپایا نام := متن
    ناپایا باقی := ""
    اگر فاصله > ۰:
        نام = رشته.زیررشته(متن، ۰، فاصله)
        باقی = رشته.پیرایش(رشته.زیررشته(متن، فاصله + ۱، متن.طول() - فاصله - ۱))
    پایان
    اگر رشته.یکسان بدون حساسیت(نام، "/help"):
        برگشت "فرمان‌ها: /help، /say متن، /shout متن"
    وگرنه رشته.یکسان بدون حساسیت(نام، "/say"):
        برگشت "ربات می‌گوید: " + باقی
    وگرنه رشته.یکسان بدون حساسیت(نام، "/shout"):
        برگشت "ربات فریاد می‌زند: " + رشته.بزرگ(باقی)
    پایان
    برگشت "فرمان ناشناخته: " + رشته.حذف پیشوند(نام، "/")
پایان

تابع ریشه:
    هر خط در ["سلام به همه"، "/HELP"، "  /say صبح بخیر "، "/Shout fire drill"، "/dance"]:
        سرچاپ رسیدگی(خط)
    پایان
پایان
خروجیگفتگو: سلام به همه فرمان‌ها: /help، /say متن، /shout متن ربات می‌گوید: صبح بخیر ربات فریاد می‌زند: FIRE DRILL فرمان ناشناخته: dance

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

پیشوند، پسوند، دربردارد

سه پرسش همیشه پیش می‌آید: متن با چیزی شروع می‌شود؟ با چیزی تمام می‌شود؟ چیزی در آن هست؟ روش‌های s.شروع با(p)، s.ختم با(p) و s.دربردارد(sub) بدون واردسازی جواب درست یا نادرست می‌دهند. شروع با، پایان با و شامل است در این بسته همان بررسی‌ها به شکل تابع‌اند و وقتی می‌خواهید تابعی را به جای دیگر بدهید به کار می‌آیند. در کد تازه روش‌ها را ترجیح دهید.

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

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

str-guide-affix.salam
واردسازی رشته

تابع توصیف(نشانی: رشته): رشته:
    ناپایا متغیر_schemes := وکتور {} برگردان وکتور<رشته>
    متغیر_schemes.بیفزا("http://")
    متغیر_schemes.بیفزا("https://")
    اگر وارونه رشته.شروع با یکی از(نشانی، متغیر_schemes):
        برگشت نشانی + ": not a web address"
    پایان
    ناپایا موفق := نادرست
    آرام := رشته.برش پیشوند(نشانی، "https://"، موفق)
    متغیر_secure := موفق
    میزبان := رشته.برش پیشوند(آرام، "http://"، موفق)
    ناپایا گونه := "page"
    اگر میزبان.ختم با(".png") یا میزبان.ختم با(".jpg"):
        گونه = "image"
    پایان
    اگر میزبان.دربردارد("?"):
        گونه += " with a query"
    پایان
    ناپایا برچسب := "plain"
    اگر متغیر_secure:
        برچسب = "secure"
    پایان
    برگشت برچسب + " " + گونه + " at " + میزبان
پایان

تابع ریشه:
    هر نشانی در ["https://salamlang.ir/logo.png"، "http://example.org/a?x=1"، "ftp://example.org/file"، "HTTPS://Example.org"]:
        سرچاپ توصیف(نشانی)
    پایان
    سرچاپ رشته.شروع با بدون حساسیت("HTTPS://Example.org"، "https://")
    سرچاپ رشته.پایان با بدون حساسیت("Photo.JPG"، ".jpg")
پایان
خروجیsecure image at salamlang.ir/logo.png plain page with a query at example.org/a?x=1 ftp://example.org/file: not a web address HTTPS://Example.org: not a web address true true

دو خط آخر نسخه‌های بدون حساسیت را نشان می‌دهند: HTTPS:// و .JPG با این‌که با حروف بزرگ نوشته شده‌اند جور می‌شوند. بررسی نشانی بالا HTTPS://Example.org را رد می‌کند چون شروع با یکی از دقیق است؛ اگر می‌خواهید پذیرفته شود از بررسی بدون حساسیت استفاده کنید.

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

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

گونه‌ها

سازنده رشته StringBuilder

ساختار سازنده رشته
سازنده‌ی رشته: حافظه‌ای که رشته را کم‌کم در آن می‌سازید. همیشه آن را با سازنده() بسازید و با تابع‌های «بافر» به کار ببرید؛ فیلدهایش را مستقیم تغییر ندهید.
نامانگلیسیگونهتوضیح
دادهdataتهی*نشانی حافظه‌ای که متن در آن نوشته می‌شود.
طولlenصحیح۶۴ = 0تعداد بایت‌هایی که تا حالا نوشته شده.
ظرفیتcapصحیح۶۴ = 0اندازه‌ی حافظه‌ی گرفته‌شده، بر حسب بایت. وقتی پر شود، خودبه‌خود بزرگ‌تر می‌شود.
str-StringBuilder.salam
واردسازی رشته

تابع ریشه:
    ناپایا ب := رشته.سازنده()
    دیرکن رشته.آزادسازی بافر(ب)
    سرچاپ رشته.بافر خالی است(ب)
    تکرار ۱ تا ۳ در ای:
        رشته.افزودن به بافر(ب، "بخش ")
        رشته.افزودن عدد به بافر(ب، ای)
        رشته.افزودن نویسه به بافر(ب، ۴۴)
    پایان
    رشته.افزودن کدنقطه به بافر(ب، ۱۷۷۶)
    سرچاپ رشته.رشته بافر(ب)
    سرچاپ رشته.طول بافر(ب)، رشته.بافر خالی است(ب)
    رشته.بازنشانی بافر(ب)
    سرچاپ رشته.طول بافر(ب)
پایان
خروجیtrue بخش 1,بخش 2,بخش 3,۰ 29 false 0

تابع‌ها

پیرایش چپ TrimLeft

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

تابع ریشه:
    م := "   سلام دنیا   "
    سرچاپ "[" + رشته.پیرایش(م) + "]"
    سرچاپ "[" + رشته.پیرایش چپ(م) + "]"
    سرچاپ "[" + رشته.پیرایش راست(م) + "]"
    سرچاپ رشته.حذف پیشوند("https://salamlang.ir"، "https://")
    سرچاپ رشته.حذف پسوند("گزارش.txt"، ".txt")
پایان
خروجی[سلام دنیا] [سلام دنیا ] [ سلام دنیا] salamlang.ir گزارش

پیرایش راست TrimRight

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

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

حذف پیشوند TrimPrefix

تابع حذف پیشوند(s: رشته، prefix: رشته): رشته
اگر رشته با prefix شروع شود، آن را برمی‌دارد؛ وگرنه رشته را دست‌نخورده برمی‌گرداند.

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

حذف پسوند TrimSuffix

تابع حذف پسوند(s: رشته، suffix: رشته): رشته
اگر رشته با suffix تمام شود، آن را برمی‌دارد؛ برای جدا کردن پسوند پرونده مناسب است.

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

مقدار رقم DigitValue

تابع مقدار رقم(cp: صحیح): صحیح
مقدار عددی یک رقم را برمی‌گرداند، چه انگلیسی باشد، چه فارسی، چه عربی. برای نویسه‌ای که رقم نیست منفی یک برمی‌گرداند.
str-Digits.salam
واردسازی رشته

تابع ریشه:
    سرچاپ رشته.به رقم فارسی("سفارش 1403")
    سرچاپ رشته.به رقم انگلیسی("کد ۱۲۳ و ٤٥٦")
    سرچاپ رشته.به رقم عربی("2025")
    سرچاپ رشته.دارای رقم فارسی است("۱۲")، رشته.دارای رقم عربی است("۱۲")، رشته.دارای رقم انگلیسی است("12")
    ر := رشته.کدنقطه ها("۷").بگیر(۰)
    سرچاپ رشته.رقم فارسی است(ر)، رشته.رقم عربی است(ر)، رشته.رقم فارسی عربی انگلیسی است(ر)
    سرچاپ رشته.مقدار رقم(ر)، رشته.مقدار رقم(۶۵)
پایان
خروجیسفارش ۱۴۰۳ کد 123 و 456 ٢٠٢٥ true false true true false true 7 -1

رقم عربی است IsArabicDigit

تابع رقم عربی است(cp: صحیح): منطقی
اگر نویسه یکی از رقم‌های عربی ٠ تا ٩ باشد، درست برمی‌گرداند. رقم‌های فارسی شکل دیگری دارند و اینجا حساب نمی‌شوند.

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

رقم فارسی است IsPersianDigit

تابع رقم فارسی است(cp: صحیح): منطقی
اگر نویسه یکی از رقم‌های فارسی ۰ تا ۹ باشد، درست برمی‌گرداند.

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

رقم فارسی عربی انگلیسی است IsAnyDigit

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

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

به رقم انگلیسی ToEnglishDigits

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

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

به رقم عربی ToArabicDigits

تابع به رقم عربی(s: رشته): رشته
همه‌ی رقم‌های رشته را به رقم عربی تبدیل می‌کند.

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

به رقم فارسی ToPersianDigits

تابع به رقم فارسی(s: رشته): رشته
همه‌ی رقم‌های رشته را به رقم فارسی تبدیل می‌کند؛ برای نمایش عدد به کاربر فارسی‌زبان.

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

دارای رقم انگلیسی است HasEnglishDigits

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

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

دارای رقم عربی است HasArabicDigits

تابع دارای رقم عربی است(s: رشته): منطقی
اگر رشته دست‌کم یک رقم عربی داشته باشد، درست برمی‌گرداند.

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

دارای رقم فارسی است HasPersianDigits

تابع دارای رقم فارسی است(s: رشته): منطقی
اگر رشته دست‌کم یک رقم فارسی داشته باشد، درست برمی‌گرداند.

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

سازنده NewBuilder

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

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

افزودن به بافر BufAppend

تابع افزودن به بافر(b &: سازنده رشته، s: رشته)
یک رشته را به انتهای سازنده اضافه می‌کند.

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

افزودن نویسه به بافر BufAppendChar

تابع افزودن نویسه به بافر(b &: سازنده رشته، code: صحیح)
یک بایت را با کد عددی‌اش اضافه می‌کند؛ برای نویسه‌های انگلیسی مثل ویرگول (۴۴).

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

افزودن کدنقطه به بافر BufAppendCp

تابع افزودن کدنقطه به بافر(b &: سازنده رشته، cp: صحیح)
یک نویسه‌ی یونیکد را با کدنقطه‌اش اضافه می‌کند؛ برای حرف‌ها و رقم‌های فارسی.

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

افزودن عدد به بافر BufAppendInt

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

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

طول بافر BufLen

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

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

بافر خالی است BufIsEmpty

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

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

رشته بافر BufStr

تابع رشته بافر(b &: سازنده رشته): رشته
متن ساخته‌شده را به شکل یک رشته‌ی تازه برمی‌گرداند. سازنده بعد از آن هم قابل استفاده است.

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

بازنشانی بافر BufReset

تابع بازنشانی بافر(b &: سازنده رشته)
سازنده را خالی می‌کند، اما حافظه‌اش را نگه می‌دارد تا برای متن بعدی دوباره به کار برود.

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

آزادسازی بافر BufFree

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

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

تجزیه متعارف NFD

تابع تجزیه متعارف(s: رشته): رشته
رشته را به شکل «تجزیه‌ی متعارف» یونیکد درمی‌آورد: هر نویسه‌ی ترکیبی، مثل «آ»، به پایه و نشانه‌هایش (ا و مدّ) شکسته می‌شود.
str-NFC.salam
واردسازی رشته

تابع ریشه:
    ترکیبی := "آ"
    تجزیه := رشته.تجزیه متعارف(ترکیبی)
    سرچاپ ترکیبی.طول()، تجزیه.طول()، ترکیبی == تجزیه
    سرچاپ رشته.ترکیب متعارف(تجزیه) == ترکیبی
    سرچاپ رشته.متعارف است(ترکیبی)، رشته.متعارف است(تجزیه)
    نمایشی := "ﻼ"
    سرچاپ رشته.تجزیه سازگاری(نمایشی)، رشته.ترکیب سازگاری(نمایشی)
پایان
خروجی2 4 false true true false لا لا

ترکیب متعارف NFC

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

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

تجزیه سازگاری NFKD

تابع تجزیه سازگاری(s: رشته): رشته
مثل تجزیه‌ی متعارف، ولی شکل‌های «سازگاری» را هم باز می‌کند؛ مثلاً شکل‌های نمایشی عربی مثل ﻻ به حرف‌های معمولی تبدیل می‌شوند.

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

ترکیب سازگاری NFKC

تابع ترکیب سازگاری(s: رشته): رشته
تجزیه‌ی سازگاری و سپس ترکیب متعارف. برای یکسان کردن متنی که از منبع‌های ناهمگون، مثل PDF، آمده مناسب است.

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

متعارف است IsNFC

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

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

کدنقطه در CodePointAt

تابع کدنقطه در(s: رشته، i: صحیح، cp &: صحیح): صحیح
نویسه‌ای را که از بایت i شروع می‌شود می‌خواند، کدنقطه‌اش را در cp می‌گذارد و تعداد بایت‌هایش را برمی‌گرداند. برای پیمایش دستی رشته، نویسه به نویسه.
str-CharCount.salam
واردسازی رشته

تابع ریشه:
    م := "سلام"
    سرچاپ رشته.طول(م)، رشته.شمارنویسه(م)
    سرچاپ رشته.نویسه شماره(م، ۱)، رشته.زیررشته نویسه(م، ۱، ۲)
    سرچاپ رشته.بیاب نویسه(م، "ام")، رشته.برعکس(م)
    سرچاپ رشته.نویسه در(م، ۲)
    ناپایا کد := ۰
    ط := رشته.کدنقطه در(م، ۰، کد)
    سرچاپ کد، ط، رشته.طول نویسه(۲۱۶)
    کدها := رشته.کدنقطه ها(م)
    سرچاپ کدها
    سرچاپ رشته.از کدنقطه ها(کدها)
    سرچاپ رشته.نویسه ها("ab۱")
    سرچاپ رشته.همه اسکی("salam")، رشته.همه اسکی("سلام")
پایان
خروجی8 4 ل لا 2 مالس ل 1587 2 2 [1587, 1604, 1575, 1605] سلام ["a", "b", "۱"] true false

طول نویسه CharLen

تابع طول نویسه(lead: صحیح): صحیح
از روی نخستین بایت یک نویسه می‌گوید آن نویسه چند بایت است (۱ تا ۴).

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

نویسه در CharAt

تابع نویسه در(s: رشته، i: صحیح): رشته
نویسه‌ای را برمی‌گرداند که از بایت i شروع می‌شود. شماره‌ی بایت است، نه شماره‌ی حرف؛ برای شماره‌ی حرف نویسه شماره را ببینید.

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

برعکس Reverse

تابع برعکس(s: رشته): رشته
ترتیب نویسه‌های رشته را برعکس می‌کند. اگر متن اعراب یا شکلک دارد، برعکس خوشه ای درست‌تر است.

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

شمارنویسه CharCount

تابع شمارنویسه(s: رشته): صحیح
تعداد نویسه‌های رشته را برمی‌گرداند، نه بایت‌ها را. برای «سلام» چهار است، در حالی که طول هشت می‌گوید.

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

زیررشته نویسه CharSubstr

تابع زیررشته نویسه(s: رشته، start: صحیح، n: صحیح): رشته
از نویسه‌ی شماره‌ی start، به اندازه‌ی n نویسه برش می‌زند. نسخه‌ی امن زیررشته برای متن فارسی است.

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

نویسه شماره CharAtIndex

تابع نویسه شماره(s: رشته، i: صحیح): رشته
نویسه‌ی شماره‌ی i را برمی‌گرداند؛ شماره‌ها از صفر شروع می‌شوند.

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

بیاب نویسه CharFind

تابع بیاب نویسه(s: رشته، sub: رشته): صحیح
جای نخستین تکرار sub را بر حسب شماره‌ی نویسه برمی‌گرداند، یا منفی یک اگر نباشد.

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

کدنقطه ها CodePoints

تابع کدنقطه ها(s: رشته): وکتور<صحیح>
کدنقطه‌ی همه‌ی نویسه‌های رشته را در یک وکتور برمی‌گرداند.

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

از کدنقطه ها FromCodePoints

تابع از کدنقطه ها(cps: وکتور<صحیح>): رشته
برعکس کدنقطه ها: از وکتوری از کدنقطه‌ها یک رشته می‌سازد.

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

همه اسکی AllAscii

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

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

نویسه ها Chars

تابع نویسه ها(s: رشته): وکتور<رشته>
هر نویسه‌ی رشته را به شکل یک رشته‌ی جدا در وکتور برمی‌گرداند.

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

تکرار Repeat

تابع تکرار(s: رشته، n: صحیح): رشته
رشته را n بار پشت‌سرهم تکرار می‌کند؛ برای کشیدن خط جداکننده در خروجی.
str-Fields.salam
واردسازی رشته

تابع ریشه:
    سرچاپ رشته.تکرار("=-"، ۵)
    واژه‌ها := رشته.واژه ها("  زبان   برنامه‌نویسی\tسلام \n")
    سرچاپ واژه‌ها.طول()، واژه‌ها
پایان
خروجی=-=-=-=-=- 3 ["زبان", "برنامه‌نویسی", "سلام"]

واژه ها Fields

تابع واژه ها(s: رشته): وکتور<رشته>
رشته را با هر تعداد فاصله، تب یا خط تازه به واژه‌ها می‌شکند و تکه‌های خالی را کنار می‌گذارد.

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

شامل است Contains

تابع شامل است(s: رشته، sub: رشته): منطقی
اگر sub جایی در رشته باشد، درست برمی‌گرداند.
str-Contains.salam
واردسازی رشته

تابع ریشه:
    م := "سلام، دنیای سلام"
    سرچاپ رشته.شامل است(م، "دنیا")، رشته.شروع با(م، "سلام")، رشته.پایان با(م، "سلام")
    سرچاپ رشته.اندیس(م، "سلام")، رشته.آخرین اندیس(م، "سلام")، رشته.جستجو(م، "نیست")
    سرچاپ رشته.اندیس از(م، "سلام"، ۱)، رشته.شمارش(م، "سلام")
پایان
خروجیtrue true true 0 22 -1 22 2

شروع با StartsWith

تابع شروع با(s: رشته، prefix: رشته): منطقی
اگر رشته با prefix شروع شود، درست برمی‌گرداند.

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

پایان با EndsWith

تابع پایان با(s: رشته، suffix: رشته): منطقی
اگر رشته با suffix تمام شود، درست برمی‌گرداند.

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

تابع جستجو(s: رشته، sub: رشته): صحیح
جای نخستین تکرار sub را بر حسب بایت برمی‌گرداند، یا منفی یک. همان اندیس است.

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

اندیس IndexOf

تابع اندیس(s: رشته، sub: رشته): صحیح
جای نخستین تکرار sub را بر حسب بایت برمی‌گرداند، یا منفی یک اگر پیدا نشود.

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

اندیس از IndexFrom

تابع اندیس از(s: رشته، sub: رشته، from: صحیح): صحیح
مثل اندیس، ولی جستجو را از بایت from شروع می‌کند؛ برای پیدا کردن تکرار بعدی.

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

شمارش Count

تابع شمارش(s: رشته، sub: رشته): صحیح
تعداد تکرارهای جدا از هم sub در رشته را برمی‌گرداند.

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

آخرین اندیس LastIndex

تابع آخرین اندیس(s: رشته، sub: رشته): صحیح
جای آخرین تکرار sub را بر حسب بایت برمی‌گرداند، یا منفی یک.

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

شروع با یکی از StartsWithAny

تابع شروع با یکی از(s: رشته، prefixes: وکتور<رشته>): منطقی
اگر رشته با دست‌کم یکی از پیشوندهای وکتور شروع شود، درست برمی‌گرداند. وکتور خالی نادرست می‌دهد و پیشوند خالی در آن با همه‌چیز جور است.
str-Affix.salam
واردسازی رشته

تابع ریشه:
    نام := "Report-2026.TXT"
    سرچاپ نام.شروع با("Report")، نام.ختم با(".txt")، نام.دربردارد("2026")
    سرچاپ رشته.شروع با بدون حساسیت(نام، "report")، رشته.پایان با بدون حساسیت(نام، ".txt")
    ناپایا متغیر_exts := وکتور {} برگردان وکتور<رشته>
    متغیر_exts.بیفزا(".csv")
    متغیر_exts.بیفزا(".TXT")
    سرچاپ رشته.پایان با یکی از(نام، متغیر_exts)، رشته.شروع با یکی از(نام، متغیر_exts)
    ناپایا موفق := نادرست
    سرچاپ رشته.برش پیشوند(نام، "Report-"، موفق)، موفق
    سرچاپ رشته.برش پسوند(نام، ".md"، موفق)، موفق
پایان
خروجیtrue false true true true true false 2026.TXT true Report-2026.TXT false

پایان با یکی از EndsWithAny

تابع پایان با یکی از(s: رشته، suffixes: وکتور<رشته>): منطقی
اگر رشته با دست‌کم یکی از پسوندهای وکتور تمام شود، درست برمی‌گرداند. برای فهرست پسوند فایل‌ها به کار می‌آید.

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

برش پیشوند CutPrefix

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

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

برش پسوند CutSuffix

تابع برش پسوند(s: رشته، suffix: رشته، ok &: منطقی): رشته
اگر رشته با suffix تمام شود، بخش پیش از آن را برمی‌گرداند و ok را درست می‌کند؛ وگرنه رونوشتی از رشته می‌دهد و ok نادرست می‌شود.

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

شروع بایتی StartsWithBytes

تابع شروع بایتی(data: تهی*، n: صحیح، prefix: تهی*، m: صحیح): منطقی
بایت‌های آغاز یک بافر را با یک پیشوند می‌سنجد؛ هر دو با نشانگر و طول داده می‌شوند، پس بایت صفر هم مثل بقیه سنجیده می‌شود. برای داده‌ی دودویی که در str جا نمی‌شود.
str-AffixBytes.salam
واردسازی رشته
واردسازی حافظه

تابع ریشه:
    داده := حافظه.تخصیص صفرشده حتمی(6 برگردان طبیعی۶۴) برگردان صحیح۸*
    متغیر_mark := حافظه.تخصیص صفرشده حتمی(3 برگردان طبیعی۶۴) برگردان صحیح۸*
    داده[0] = 80 برگردان صحیح۸
    داده[1] = 75 برگردان صحیح۸
    داده[2] = 0 برگردان صحیح۸
    داده[3] = 1 برگردان صحیح۸
    داده[4] = 2 برگردان صحیح۸
    متغیر_mark[0] = 0 برگردان صحیح۸
    متغیر_mark[1] = 1 برگردان صحیح۸
    متغیر_mark[2] = 2 برگردان صحیح۸
    سرچاپ رشته.شروع بایتی(داده برگردان تهی*، 5، داده برگردان تهی*، 2)
    سرچاپ رشته.شروع بایتی(داده برگردان تهی*، 1، داده برگردان تهی*، 2)
    سرچاپ رشته.پایان بایتی(داده برگردان تهی*، 5، متغیر_mark برگردان تهی*، 3)
    سرچاپ رشته.پایان بایتی(داده برگردان تهی*، 2، متغیر_mark برگردان تهی*، 3)
    حافظه.آزادسازی(داده برگردان تهی*)
    حافظه.آزادسازی(متغیر_mark برگردان تهی*)
پایان
خروجیtrue false true false

پایان بایتی EndsWithBytes

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

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

اسکی است IsAscii

تابع اسکی است(code: صحیح): منطقی
اگر کد در بازه‌ی اسکی (صفر تا ۱۲۷) باشد، درست برمی‌گرداند.
str-IsAscii.salam
واردسازی رشته

تابع ریشه:
    هر م در ["A"، "z"، "7"، " "، "!"، "ب"، "۷"، "\t"]:
        ک := رشته.کدنقطه ها(م).بگیر(۰)
        سرچاپ "[" + م + "]"، رشته.اسکی است(ک)، رشته.حرف است(ک)، رشته.رقم است(ک)، رشته.فاصله است(ک)، رشته.نشانه نگارشی است(ک)
    پایان
    سرچاپ رشته.بزرگ اسکی است(۶۵)، رشته.کوچک اسکی است(۶۵)، رشته.بزرگ است(۱۰۴۰)، رشته.کوچک است(۱۰۷۲)
    سرچاپ رشته.رقم اسکی است(۵۰)، رشته.حرف اسکی است(۵۰)، رشته.الفبایی عددی اسکی است(۵۰)، رشته.فاصله اسکی است(۳۲)
    سرچاپ رشته.الفبایی عددی است(۱۷۷۶)، رشته.نشانه است(۱۶۱۴)، رشته.کنترلی است(۱۰)
پایان
خروجی[A] true true false false false [z] true true false false false [7] true false true false false [ ] true false false true false [!] true false false false true [ب] false true false false false [۷] false false true false false [ ] true false false true false true false true true true false true true true true true

فاصله اسکی است IsAsciiSpace

تابع فاصله اسکی است(code: صحیح): منطقی
فقط فاصله‌های اسکی: فاصله، تب، خط تازه و مانند آن‌ها.

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

رقم اسکی است IsAsciiDigit

تابع رقم اسکی است(code: صحیح): منطقی
فقط رقم‌های انگلیسی 0 تا 9.

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

بزرگ اسکی است IsAsciiUpper

تابع بزرگ اسکی است(code: صحیح): منطقی
فقط حرف‌های بزرگ انگلیسی A تا Z.

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

کوچک اسکی است IsAsciiLower

تابع کوچک اسکی است(code: صحیح): منطقی
فقط حرف‌های کوچک انگلیسی a تا z.

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

حرف اسکی است IsAsciiAlpha

تابع حرف اسکی است(code: صحیح): منطقی
فقط حرف‌های انگلیسی، بزرگ یا کوچک.

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

الفبایی عددی اسکی است IsAsciiAlnum

تابع الفبایی عددی اسکی است(code: صحیح): منطقی
حرف یا رقم انگلیسی.

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

فاصله است IsSpace

تابع فاصله است(code: صحیح): منطقی
هر نوع فاصله در یونیکد، از جمله فاصله‌های اسکی و فاصله‌ی ژاپنی.

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

رقم است IsDigit

تابع رقم است(code: صحیح): منطقی
هر رقم دهدهی یونیکد، از جمله فارسی و عربی.

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

بزرگ است IsUpper

تابع بزرگ است(code: صحیح): منطقی
حرف بزرگ در هر خطی که حرف بزرگ دارد، مثل لاتین، یونانی و سیریلیک.

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

کوچک است IsLower

تابع کوچک است(code: صحیح): منطقی
حرف کوچک در هر خطی که حرف کوچک دارد.

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

حرف است IsAlpha

تابع حرف است(code: صحیح): منطقی
هر حرف در هر خطی، از جمله فارسی.

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

الفبایی عددی است IsAlnum

تابع الفبایی عددی است(code: صحیح): منطقی
هر حرف یا رقم در هر خطی.

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

نشانه نگارشی است IsPunct

تابع نشانه نگارشی است(code: صحیح): منطقی
هر نشانه‌ی نگارشی، مثل نقطه، ویرگول فارسی و علامت سؤال.

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

نشانه است IsMark

تابع نشانه است(code: صحیح): منطقی
نشانه‌های ترکیبی مثل اعراب عربی و فارسی (فتحه، کسره و…).

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

کنترلی است IsControl

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

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

طول Len

تابع طول(s: رشته): صحیح
طول رشته را بر حسب بایت برمی‌گرداند. برای تعداد حرف‌ها شمارنویسه را ببینید.
str-Len.salam
واردسازی رشته

تابع ریشه:
    الف := "سیب"
    ب := "انار"
    سرچاپ رشته.طول(الف)، رشته.خالی است("")، رشته.خالی است(الف)
    سرچاپ رشته.پیوست(الف، ب)
    سرچاپ رشته.مقایسه(الف، ب)، رشته.مقایسه(ب، الف)، رشته.مقایسه(الف، "سیب")
    سرچاپ رشته.یکسان است(الف، "سیب")
    سرچاپ رشته.زیررشته("salam donya"، ۶، ۵)، رشته.زیررشته درون("salam"، ۳، ۱۰)
    سرچاپ رشته.یافتن("salam donya"، "donya")
    ر := رشته.رونوشت(الف)
    سرچاپ ر
پایان
خروجی6 true false سیبانار 1 -1 0 true donya am 6 سیب

طول بایتی ByteLen

تابع طول بایتی(s: رشته): صحیح
طول رشته را بر حسب بایت می‌دهد و روی همه‌ی پشتوانه‌ها یک‌سان است. در پشتوانه‌ی جاوااسکریپت طول یکای utf-16 را می‌شمارد، پس برای کار بایتی این را به کار ببرید.
str-ByteLen.salam
واردسازی رشته

تابع ریشه:
    متن := "سلام"
    سرچاپ رشته.طول بایتی(متن)، رشته.شمارنویسه(متن)
    سرچاپ رشته.زیررشته بایتی(متن، ۰، ۴)
    سرچاپ رشته.زیررشته نویسه(متن، ۰، ۲)
پایان
خروجی8 4 سل سل

زیررشته بایتی ByteSub

تابع زیررشته بایتی(s: رشته، start: صحیح، n: صحیح): رشته
از بایت start به اندازه‌ی n بایت برش می‌زند. پشتوانه‌های سی و LLVM بایت‌ها را دست‌نخورده برمی‌گردانند، ولی پشتوانه‌ی جاوااسکریپت آن‌ها را با UTF-8 رمزگشایی می‌کند؛ پس برشی که از میان یک نویسه‌ی چندبایتی بگذرد نویسه‌ی جایگزین می‌سازد و طول بایتی‌اش عوض می‌شود. برای برش نویسه‌ای از زیررشته نویسه استفاده کنید.

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

پیوست Concat

تابع پیوست(a: رشته، b: رشته): رشته
دو رشته را پشت‌سرهم می‌چسباند؛ همان کار +.

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

مقایسه Compare

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

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

یکسان است Equals

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

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

زیررشته Substr

تابع زیررشته(s: رشته، start: صحیح، n: صحیح): رشته
از بایت start به اندازه‌ی n بایت برش می‌زند. برای متن فارسی مراقب باشید وسط یک حرف را نبرید، یا از زیررشته نویسه استفاده کنید.

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

زیررشته درون SubstrIn

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

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

یافتن Find

تابع یافتن(s: رشته، sub: رشته): صحیح
جای نخستین تکرار sub را بر حسب بایت برمی‌گرداند، یا منفی یک.

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

تفکیک کردن Split

تابع تفکیک کردن(s: رشته، delim: رشته): وکتور<رشته>
رشته را هر جا delim باشد می‌شکند و تکه‌ها را در یک وکتور برمی‌گرداند. وکتور را پس از کار آزاد کنید.
str-Split.salam
واردسازی رشته

تابع ریشه:
    تکه‌ها := رشته.تفکیک کردن("سیب,انار,انگور"، ",")
    دیرکن تکه‌ها.آزادکن()
    سرچاپ تکه‌ها.طول()، تکه‌ها.بگیر(۱)
    سرچاپ رشته.بپیوند(تکه‌ها، " / ")
پایان
خروجی3 انار سیب / انار / انگور

بپیوند Join

تابع بپیوند(parts: وکتور<رشته>، sep: رشته): رشته
تکه‌های وکتور را با sep بینشان به هم می‌چسباند؛ برعکس تفکیک کردن.

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

پیرایش Trim

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

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

تبدیل به عدد ToInt

تابع تبدیل به عدد(s: رشته): صحیح
رشته را به عدد صحیح تبدیل می‌کند؛ رقم فارسی و عربی هم پذیرفته است. اگر عددی پیدا نشود، صفر برمی‌گرداند.
str-ToInt.salam
واردسازی رشته

تابع ریشه:
    سرچاپ رشته.تبدیل به عدد("۴۲") + ۱، رشته.تبدیل به عدد("abc")
    سرچاپ رشته.تبدیل به اعشار("2.5") * ۲
    سرچاپ "[" + رشته.از عدد(-۱۵) + "]"، "[" + رشته.از اعشار(۱.۲۵) + "]"
پایان
خروجی43 0 5 [-15] [1.25]

تبدیل به اعشار ToFloat

تابع تبدیل به اعشار(s: رشته): اعشار۶۴
رشته را به عدد اعشاری تبدیل می‌کند.

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

خالی است IsEmpty

تابع خالی است(s: رشته): منطقی
اگر رشته هیچ نویسه‌ای نداشته باشد، درست برمی‌گرداند.

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

رونوشت Clone

تابع رونوشت(s: رشته): رشته
یک رونوشت مستقل از رشته می‌سازد.

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

جایگزینی Replace

تابع جایگزینی(s: رشته، find: رشته، replacement: رشته): رشته
همه‌ی تکرارهای find را با replacement جایگزین می‌کند.
str-Replace.salam
واردسازی رشته

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

از عدد FromInt

تابع از عدد(i: صحیح۶۴): رشته
یک عدد صحیح را به متن تبدیل می‌کند.

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

از اعشار FromFloat

تابع از اعشار(f: اعشار۶۴): رشته
یک عدد اعشاری را به متن تبدیل می‌کند.

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

بزرگ Upper

تابع بزرگ(s: رشته): رشته
حرف‌های ASCII یعنی a تا z را بزرگ می‌کند. هر چیز دیگری، از جمله حرف‌های تکیه‌دار و غیرلاتین، دست‌نخورده می‌ماند؛ پس "café" می‌شود "CAFé". حرف‌های فارسی هم که بزرگ و کوچک ندارند.
str-Upper.salam
واردسازی رشته

تابع ریشه:
    سرچاپ رشته.بزرگ("salam")، رشته.کوچک("SALAM")، رشته.حالت عنوانی("hello world")
    سرچاپ رشته.یکسان بدون حساسیت("Straße"، "STRASSE")
    سرچاپ رشته.مقایسه بدون حساسیت("abc"، "ABX")
    سرچاپ رشته.بزرگ("سلام")
پایان
خروجیSALAM salam Hello World true -21 سلام

کوچک Lower

تابع کوچک(s: رشته): رشته
حرف‌های ASCII یعنی A تا Z را کوچک می‌کند و بقیه‌ی نویسه‌ها را دست نمی‌زند.

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

حالت عنوانی Title

تابع حالت عنوانی(s: رشته): رشته
نخستین حرف هر واژه را بزرگ و بقیه را کوچک می‌کند و برای این کار جدول‌های یونیکد را به کار می‌برد؛ پس "élan VITAL" می‌شود "Élan Vital". واژه‌ها فقط با فاصله‌های سفید از هم جدا می‌شوند.

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

یکسان بدون حساسیت EqualFold

تابع یکسان بدون حساسیت(a: رشته، b: رشته): منطقی
دو رشته را بدون توجه به بزرگی و کوچکی حرف‌ها مقایسه می‌کند؛ قاعده‌های کامل یونیکد را هم رعایت می‌کند، پس «Straße» با «STRASSE» برابر است.

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

مقایسه بدون حساسیت CompareFold

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

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

شروع با بدون حساسیت StartsWithFold

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

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

پایان با بدون حساسیت EndsWithFold

تابع پایان با بدون حساسیت(s: رشته، suffix: رشته): منطقی
مثل پایان با ولی بدون توجه به بزرگی و کوچکی حرف‌ها. پایان با بدون حساسیت(نام، ".jpg") نام PHOTO.JPG را هم می‌پذیرد.

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

شمار خوشه GraphemeCount

تابع شمار خوشه(s: رشته): صحیح
تعداد خوشه‌ها را برمی‌گرداند؛ یعنی تعداد «حرف‌هایی» که خواننده می‌بیند.
str-Graphemes.salam
واردسازی رشته

تابع ریشه:
    م := "کَتاب👨‍👩‍👧"
    سرچاپ رشته.شمارنویسه(م)، رشته.شمار خوشه(م)
    سرچاپ رشته.خوشه ها(م)
    سرچاپ رشته.برعکس خوشه ای("سَلام")
پایان
خروجی10 5 ["کَ", "ت", "ا", "ب", "👨‍👩‍👧"] مالسَ

خوشه ها Graphemes

تابع خوشه ها(s: رشته): وکتور<رشته>
رشته را به خوشه‌ها می‌شکند؛ هر حرف با اعرابش، یا هر شکلک ترکیبی، یک تکه است.

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

برعکس خوشه ای ReverseGraphemes

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

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