رشته str
هر کاری که با متن دارید: جستجو، برش، جایگزینی، رقم فارسی، حروف بزرگ و کوچک و ساختن رشتههای بلند.
واردسازی رشته
نام آرگومانها شناسهی خود کد است و معادل فارسی ندارد؛ گونهها، کلیدواژهها و نام بستهها با معادل فارسی نوشته میشوند.
بستهی رشته پرکاربردترین بستهی سلام است. هر جا با متن سروکار دارید، از خواندن ورودی کاربر تا ساختن خروجی، تابعهای این بسته به کارتان میآیند.
پیش از شروع یک نکته را بدانید: رشتههای سلام UTF-8 هستند. در UTF-8 هر حرف انگلیسی یک بایت است، اما هر حرف فارسی دو بایت. برای همین بیشتر تابعها دو نسخه دارند: تابعهایی مثل طول، زیررشته و اندیس با بایت کار میکنند و سریعاند، و تابعهایی مثل شمارنویسه، زیررشته نویسه و بیاب نویسه با حرف کار میکنند. برای متن فارسی، هر جا شمارش یا برش به چشم کاربر مهم است، نسخهی حرفی را به کار ببرید.
یک قدم دورتر، «خوشه» است: آنچه خواننده یک حرف میبیند. «کَ» دو نویسه است (ک و فتحه) اما یک خوشه، و شکلک خانواده هفت نویسه است اما یک خوشه. برای برعکس کردن یا بریدن متنی که اعراب یا شکلک دارد، تابعهای خوشهای مطمئنترند.
سه روش هم روی خود هر رشته هست و واردسازی نمیخواهد: متن.شروع با("سلام")، متن.ختم با(".txt") و متن.دربردارد("دنیا"). هر سه درست یا نادرست برمیگردانند و در همهی پشتیبانها یکسان کار میکنند.
بستههای همسایه: یونیکد تکتک نقطههای کد را دستهبندی و تبدیل میکند، قالب بندی متن را پر میکند و قالب میسازد، تبدیل عدد را از متن میخواند، عبارت باقاعده الگو پیدا میکند و عربی حرفهای فارسی و عربی را یکسان میکند.
چند نکته که معمولاً غافلگیر میکند:
بزرگوکوچکفقط حرفهای ASCII یعنی A تا Z را عوض میکنند:بزرگ("café")میشودCAFé. برای خطهای دیگر، هر نقطهی کد را با تابعهای تبدیل بزرگی و کوچکی بستهی یونیکد عوض کنید؛ برای مقایسه بدون حساسیت به بزرگی حرف،یکسان بدون حساسیترا به کار ببرید که قاعدههای کامل یونیکد را رعایت میکند.پیرایشو همخانوادههایش فقط فاصله، تب، بازگشت به سر سطر و خط تازهی ASCII را برمیدارند. فاصلهی نشکن (U+00A0)، که در متن کپیشده از وب زیاد است، میماند.رشتهدر نخستین بایت صفر تمام میشود؛ پس دادهی دودویی که از این تابعها رد شود همانجا بریده میشود.- هر تابعی که رشته برمیگرداند رشتهای تازه میسازد و ورودی را هرگز تغییر نمیدهد.
ساختن نامک نشانی از روی عنوان
نامک بخش خوانای یک نشانی وب است، مثل /blog/hello-world. برای ساختنش حروف را کوچک کنید، حرف و رقم را نگه دارید و هر رشتهای از چیزهای دیگر را به یک خط تیره تبدیل کنید. کار با نقطههای کد، با کدنقطه ها و الفبایی عددی است، حرفهای همهی خطها را نگه میدارد؛ پس عنوان فارسی نامک فارسی میدهد، نه نامک خالی.
واردسازی رشته
تابع نامک(عنوان: رشته): رشته:
ناپایا ب := رشته.سازنده()
دیرکن رشته.آزادسازی بافر(ب)
کدها := رشته.کدنقطه ها(رشته.کوچک(رشته.پیرایش(عنوان)))
دیرکن کدها.آزادکن()
ناپایا خط تیره := نادرست
هر کد در کدها:
اگر رشته.الفبایی عددی است(کد):
اگر خط تیره و وارونه رشته.بافر خالی است(ب):
رشته.افزودن به بافر(ب، "-")
پایان
رشته.افزودن کدنقطه به بافر(ب، کد)
خط تیره = نادرست
وگرنه:
خط تیره = درست
پایان
پایان
برگشت رشته.رشته بافر(ب)
پایان
تابع ریشه:
سرچاپ نامک("Hello, World!")
سرچاپ نامک(" 10 Tips for Faster Builds ")
سرچاپ نامک("سلام ۰.۵: چه چیزهایی تازه است؟")
سرچاپ نامک("سلام دنیا، به سلام خوش آمدید")
پایانسازنده رشته نتیجه را جمع میکند بیآنکه برای هر حرف رشتهی تازهای بسازد؛ افزودن کدنقطه به بافر یک نقطهی کد را به شکل UTF-8 میافزاید و رشته بافر متن نهایی را برمیگرداند. در متن فارسی یک چیز را بپایید: نیمفاصله (U+200C) درون واژهای مثل میشود حرف نیست، پس این تابع واژه را همانجا دو تکه میکند. اگر میخواهید نگهش دارید، در شرط، کد ۸۲۰۴ را هم مثل حرف حساب کنید.
شمردن واژهها
واژه ها روی هر رشتهای از فاصلهها میشکند و تکههای خالی را دور میریزد؛ برای واژهها همین را میخواهید. تفکیک کردن با " " برای هر فاصلهی دوتایی یک واژهی خالی میدهد. اول نشانهگذاری را به فاصله تبدیل کنید (برای متن لاتین حروف را هم کوچک کنید)، بعد با یک نگاشت بشمارید. یک وکتور جداگانه ترتیب نخستین دیدهشدن واژهها را نگه میدارد، چون نگاشت ترتیبی از خودش ندارد.
واردسازی رشته
تابع ریشه:
متن := "گربه نشست. سگ هم نشست، و گربه دوید! سگ ماند."
پاک := رشته.جایگزینی(رشته.جایگزینی(رشته.جایگزینی(متن، "."، " ")، "،"، " ")، "!"، " ")
واژهها := رشته.واژه ها(پاک)
دیرکن واژهها.آزادکن()
ناپایا شمار := نگاشت {} برگردان نگاشت<رشته، صحیح>
دیرکن شمار.آزادکن()
ناپایا ترتیب := وکتور {} برگردان وکتور<رشته>
دیرکن ترتیب.آزادکن()
هر و۱ در واژهها:
اگر شمار.دارد(و۱):
شمار.درج(و۱، شمار.بگیر(و۱) + ۱)
وگرنه:
شمار.درج(و۱، ۱)
ترتیب.بیفزا(و۱)
پایان
پایان
سرچاپ واژهها.طول()، "واژه،"، ترتیب.طول()، "واژهی متفاوت"
هر و۱ در ترتیب:
اگر شمار.بگیر(و۱) > ۱:
سرچاپ و۱، شمار.بگیر(و۱)
پایان
پایان
پایانهر جایگزینی رشتهی تازهای برمیگرداند. برای فهرست بلندی از نویسههایی که باید حذف شوند، یک بار گذشتن از کدنقطه ها با نشانه نگارشی است از زنجیرهی جایگزینی تمیزتر است. متن فارسی را پیش از شمردن از عربی.کلید جستجو بگذرانید تا املاهای گوناگون یک واژه با هم شمرده شوند.
ساختن CSV با سازندهی رشته
هر فیلدی که ویرگول، گیومه یا شکست خط دارد باید داخل گیومه برود و هر گیومهی درونش دوتا شود. شامل است تشخیص میدهد فیلد به این کار نیاز دارد یا نه، و جایگزینی گیومهها را دوتا میکند. یک سازنده رشته ردیفها را جمع میکند، که وقتی متن به هزاران خط میرسد خیلی سریعتر از + است.
واردسازی رشته
تابع فیلد سی اس وی(ر: رشته): رشته:
اگر رشته.شامل است(ر، ",") یا رشته.شامل است(ر، "\"") یا رشته.شامل است(ر، "\n"):
برگشت "\"" + رشته.جایگزینی(ر، "\""، "\"\"") + "\""
پایان
برگشت ر
پایان
تابع افزودن ردیف(ب &: رشته.سازنده رشته، خانهها: رشته[]):
هر ش، خانه در خانهها:
اگر ش > ۰:
رشته.افزودن به بافر(ب، ",")
پایان
رشته.افزودن به بافر(ب، فیلد سی اس وی(خانه))
پایان
رشته.افزودن به بافر(ب، "\n")
پایان
تابع ریشه:
ناپایا ب := رشته.سازنده()
دیرکن رشته.آزادسازی بافر(ب)
افزودن ردیف(ب، ["نام"، "شهر"، "یادداشت"])
افزودن ردیف(ب، ["علی"، "تهران"، "چای دوست دارد"])
افزودن ردیف(ب، ["سارا"، "شیراز, فارس"، "گفت \"سلام\""])
چاپ رشته.رشته بافر(ب)
پایانسازنده با &: فرستاده میشود تا افزودن ردیف به سازندهی صدازننده بیفزاید، نه به یک رونوشت. وقتی کارتان تمام شد یک بار با آزادسازی بافر آزادش کنید. ویرگول CSV همان ویرگول لاتین , است، نه ، فارسی. برای خواندن دوبارهی CSV یا پروندههایی با گیومهگذاری عجیب، از encoding.csv استفاده کنید.
تجزیهی فرمانهای گفتگو
یک ربات یا یک کنسول خطهایی مثل /say صبح بخیر میخواند. پیرایش فاصلههای اضافهی دو سر خط را برمیدارد، شروع با فرمان را از پیام عادی جدا میکند و اندیس نخستین فاصله را پیدا میکند که فرمان را از آرگومانش جدا میکند. یکسان بدون حساسیت بیتوجه به حروف بزرگ و کوچک مقایسه میکند، پس /HELP و /help یک کار میکنند.
واردسازی رشته
تابع رسیدگی(خط: رشته): رشته:
متن := رشته.پیرایش(خط)
اگر وارونه رشته.شروع با(متن، "/"):
برگشت "گفتگو: " + متن
پایان
فاصله := رشته.اندیس(متن، " ")
ناپایا نام := متن
ناپایا باقی := ""
اگر فاصله > ۰:
نام = رشته.زیررشته(متن، ۰، فاصله)
باقی = رشته.پیرایش(رشته.زیررشته(متن، فاصله + ۱، متن.طول() - فاصله - ۱))
پایان
اگر رشته.یکسان بدون حساسیت(نام، "/help"):
برگشت "فرمانها: /help، /say متن، /shout متن"
وگرنه رشته.یکسان بدون حساسیت(نام، "/say"):
برگشت "ربات میگوید: " + باقی
وگرنه رشته.یکسان بدون حساسیت(نام، "/shout"):
برگشت "ربات فریاد میزند: " + رشته.بزرگ(باقی)
پایان
برگشت "فرمان ناشناخته: " + رشته.حذف پیشوند(نام، "/")
پایان
تابع ریشه:
هر خط در ["سلام به همه"، "/HELP"، " /say صبح بخیر "، "/Shout fire drill"، "/dance"]:
سرچاپ رسیدگی(خط)
پایان
پایاناندیس و زیررشته بر حسب بایت میشمارند. اینجا خطری ندارد، چون فاصلهای که دنبالش میگردیم یک بایت است و برش همیشه روی مرز حرف میافتد، حتی وقتی آرگومان فارسی است. اگر جای برش از شمردن حرفها میآید، از بیاب نویسه و زیررشته نویسه استفاده کنید.
پیشوند، پسوند، دربردارد
سه پرسش همیشه پیش میآید: متن با چیزی شروع میشود؟ با چیزی تمام میشود؟ چیزی در آن هست؟ روشهای s.شروع با(p)، s.ختم با(p) و s.دربردارد(sub) بدون واردسازی جواب درست یا نادرست میدهند. شروع با، پایان با و شامل است در این بسته همان بررسیها به شکل تابعاند و وقتی میخواهید تابعی را به جای دیگر بدهید به کار میآیند. در کد تازه روشها را ترجیح دهید.
حالتهای مرزی همهجا یکی است. پیشوند، پسوند یا زیررشتهی خالی همیشه جور است، پیشوند بلندتر از متن هرگز جور نیست و مقایسه بر حسب بایت است؛ پس به بزرگی و کوچکی حرف حساس است و واژهی فارسی فقط وقتی جور میشود که همهی حرفهایش یکی باشد. رشته در نخستین بایت صفر تمام میشود، پس برای دادهی دودویی شروع بایتی و پایان بایتی را به کار ببرید که نشانگر و طول میگیرند.
وقتی باقیماندهی متن را هم میخواهید، برش پیشوند و برش پسوند آن را برمیگردانند و پرچم ok را تنظیم میکنند، پس لازم نیست اول بسنجید و بعد با دست ببرید. برای چند گزینه با هم شروع با یکی از و پایان با یکی از هست، و برای نام پروتکل، نام سرایند و پسوند فایل که ممکن است با هر حروفی بیاید شروع با بدون حساسیت و پایان با بدون حساسیت.
واردسازی رشته
تابع توصیف(نشانی: رشته): رشته:
ناپایا متغیر_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")
پایاندو خط آخر نسخههای بدون حساسیت را نشان میدهند: HTTPS:// و .JPG با اینکه با حروف بزرگ نوشته شدهاند جور میشوند. بررسی نشانی بالا HTTPS://Example.org را رد میکند چون شروع با یکی از دقیق است؛ اگر میخواهید پذیرفته شود از بررسی بدون حساسیت استفاده کنید.
کدام تابع برای کدام کار
| کار | تابعها |
|---|---|
| پیدا کردن متن | شامل است، شروع با، پایان با، اندیس، آخرین اندیس، شمارش |
| شروع، پایان یا دربردارد، با حساسیت به حروف یا بیآن | شروع با، ختم با، دربردارد، شروع با بدون حساسیت، پایان با بدون حساسیت، شروع با یکی از، پایان با یکی از |
| بریدن متن | زیررشته (بایت)، زیررشته نویسه (حرف)، پیرایش، حذف پیشوند، حذف پسوند، برش پیشوند، برش پسوند |
| شکستن به تکهها و چسباندن دوباره | تفکیک کردن، واژه ها، بپیوند |
| مقایسه بیتوجه به بزرگی و کوچکی حروف | یکسان بدون حساسیت، مقایسه بدون حساسیت |
| تغییر بزرگی و کوچکی حروف | بزرگ، کوچک، حالت عنوانی |
| رقم فارسی، عربی و انگلیسی | به رقم انگلیسی، به رقم فارسی، دارای رقم فارسی است |
| بررسی تکتک حرفها | کدنقطه ها، نویسه ها، الفبایی عددی است، فاصله است، نشانه نگارشی است |
| ساختن رشتهی بلند | سازنده، افزودن به بافر، رشته بافر، آزادسازی بافر |
| مقایسهی متنی که ممکن است با شکلهای یونیکد متفاوت نوشته شده باشد | ترکیب متعارف، تجزیه متعارف، ترکیب سازگاری |
گونهها
سازنده رشته StringBuilder
ساختار سازنده رشتهسازنده() بسازید و با تابعهای «بافر» به کار ببرید؛ فیلدهایش را مستقیم تغییر ندهید.| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| داده | data | تهی* | نشانی حافظهای که متن در آن نوشته میشود. |
| طول | len | صحیح۶۴ = 0 | تعداد بایتهایی که تا حالا نوشته شده. |
| ظرفیت | cap | صحیح۶۴ = 0 | اندازهی حافظهی گرفتهشده، بر حسب بایت. وقتی پر شود، خودبهخود بزرگتر میشود. |
واردسازی رشته
تابع ریشه:
ناپایا ب := رشته.سازنده()
دیرکن رشته.آزادسازی بافر(ب)
سرچاپ رشته.بافر خالی است(ب)
تکرار ۱ تا ۳ در ای:
رشته.افزودن به بافر(ب، "بخش ")
رشته.افزودن عدد به بافر(ب، ای)
رشته.افزودن نویسه به بافر(ب، ۴۴)
پایان
رشته.افزودن کدنقطه به بافر(ب، ۱۷۷۶)
سرچاپ رشته.رشته بافر(ب)
سرچاپ رشته.طول بافر(ب)، رشته.بافر خالی است(ب)
رشته.بازنشانی بافر(ب)
سرچاپ رشته.طول بافر(ب)
پایانتابعها
پیرایش چپ TrimLeft
تابع پیرایش چپ(s: رشته): رشتهواردسازی رشته
تابع ریشه:
م := " سلام دنیا "
سرچاپ "[" + رشته.پیرایش(م) + "]"
سرچاپ "[" + رشته.پیرایش چپ(م) + "]"
سرچاپ "[" + رشته.پیرایش راست(م) + "]"
سرچاپ رشته.حذف پیشوند("https://salamlang.ir"، "https://")
سرچاپ رشته.حذف پسوند("گزارش.txt"، ".txt")
پایانپیرایش راست TrimRight
تابع پیرایش راست(s: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: str-Trim.salam
حذف پیشوند TrimPrefix
تابع حذف پیشوند(s: رشته، prefix: رشته): رشتهprefix شروع شود، آن را برمیدارد؛ وگرنه رشته را دستنخورده برمیگرداند.نمونهی این مورد همراه با موارد بالاتر آمده است: str-Trim.salam
حذف پسوند TrimSuffix
تابع حذف پسوند(s: رشته، suffix: رشته): رشتهsuffix تمام شود، آن را برمیدارد؛ برای جدا کردن پسوند پرونده مناسب است.نمونهی این مورد همراه با موارد بالاتر آمده است: str-Trim.salam
مقدار رقم DigitValue
تابع مقدار رقم(cp: صحیح): صحیحواردسازی رشته
تابع ریشه:
سرچاپ رشته.به رقم فارسی("سفارش 1403")
سرچاپ رشته.به رقم انگلیسی("کد ۱۲۳ و ٤٥٦")
سرچاپ رشته.به رقم عربی("2025")
سرچاپ رشته.دارای رقم فارسی است("۱۲")، رشته.دارای رقم عربی است("۱۲")، رشته.دارای رقم انگلیسی است("12")
ر := رشته.کدنقطه ها("۷").بگیر(۰)
سرچاپ رشته.رقم فارسی است(ر)، رشته.رقم عربی است(ر)، رشته.رقم فارسی عربی انگلیسی است(ر)
سرچاپ رشته.مقدار رقم(ر)، رشته.مقدار رقم(۶۵)
پایانرقم عربی است 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: رشته): رشتهواردسازی رشته
تابع ریشه:
ترکیبی := "آ"
تجزیه := رشته.تجزیه متعارف(ترکیبی)
سرچاپ ترکیبی.طول()، تجزیه.طول()، ترکیبی == تجزیه
سرچاپ رشته.ترکیب متعارف(تجزیه) == ترکیبی
سرچاپ رشته.متعارف است(ترکیبی)، رشته.متعارف است(تجزیه)
نمایشی := "ﻼ"
سرچاپ رشته.تجزیه سازگاری(نمایشی)، رشته.ترکیب سازگاری(نمایشی)
پایانترکیب متعارف NFC
تابع ترکیب متعارف(s: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: str-NFC.salam
تجزیه سازگاری NFKD
تابع تجزیه سازگاری(s: رشته): رشتهﻻ به حرفهای معمولی تبدیل میشوند.نمونهی این مورد همراه با موارد بالاتر آمده است: str-NFC.salam
ترکیب سازگاری NFKC
تابع ترکیب سازگاری(s: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: str-NFC.salam
متعارف است IsNFC
تابع متعارف است(s: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: str-NFC.salam
کدنقطه در CodePointAt
تابع کدنقطه در(s: رشته، i: صحیح، cp &: صحیح): صحیحi شروع میشود میخواند، کدنقطهاش را در cp میگذارد و تعداد بایتهایش را برمیگرداند. برای پیمایش دستی رشته، نویسه به نویسه.واردسازی رشته
تابع ریشه:
م := "سلام"
سرچاپ رشته.طول(م)، رشته.شمارنویسه(م)
سرچاپ رشته.نویسه شماره(م، ۱)، رشته.زیررشته نویسه(م، ۱، ۲)
سرچاپ رشته.بیاب نویسه(م، "ام")، رشته.برعکس(م)
سرچاپ رشته.نویسه در(م، ۲)
ناپایا کد := ۰
ط := رشته.کدنقطه در(م، ۰، کد)
سرچاپ کد، ط، رشته.طول نویسه(۲۱۶)
کدها := رشته.کدنقطه ها(م)
سرچاپ کدها
سرچاپ رشته.از کدنقطه ها(کدها)
سرچاپ رشته.نویسه ها("ab۱")
سرچاپ رشته.همه اسکی("salam")، رشته.همه اسکی("سلام")
پایانطول نویسه 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 بار پشتسرهم تکرار میکند؛ برای کشیدن خط جداکننده در خروجی.واردسازی رشته
تابع ریشه:
سرچاپ رشته.تکرار("=-"، ۵)
واژهها := رشته.واژه ها(" زبان برنامهنویسی\tسلام \n")
سرچاپ واژهها.طول()، واژهها
پایانواژه ها Fields
تابع واژه ها(s: رشته): وکتور<رشته>نمونهی این مورد همراه با موارد بالاتر آمده است: str-Fields.salam
شامل است Contains
تابع شامل است(s: رشته، sub: رشته): منطقیsub جایی در رشته باشد، درست برمیگرداند.واردسازی رشته
تابع ریشه:
م := "سلام، دنیای سلام"
سرچاپ رشته.شامل است(م، "دنیا")، رشته.شروع با(م، "سلام")، رشته.پایان با(م، "سلام")
سرچاپ رشته.اندیس(م، "سلام")، رشته.آخرین اندیس(م، "سلام")، رشته.جستجو(م، "نیست")
سرچاپ رشته.اندیس از(م، "سلام"، ۱)، رشته.شمارش(م، "سلام")
پایانشروع با StartsWith
تابع شروع با(s: رشته، prefix: رشته): منطقیprefix شروع شود، درست برمیگرداند.نمونهی این مورد همراه با موارد بالاتر آمده است: str-Contains.salam
پایان با EndsWith
تابع پایان با(s: رشته، suffix: رشته): منطقیsuffix تمام شود، درست برمیگرداند.نمونهی این مورد همراه با موارد بالاتر آمده است: str-Contains.salam
جستجو Search
تابع جستجو(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: وکتور<رشته>): منطقیواردسازی رشته
تابع ریشه:
نام := "Report-2026.TXT"
سرچاپ نام.شروع با("Report")، نام.ختم با(".txt")، نام.دربردارد("2026")
سرچاپ رشته.شروع با بدون حساسیت(نام، "report")، رشته.پایان با بدون حساسیت(نام، ".txt")
ناپایا متغیر_exts := وکتور {} برگردان وکتور<رشته>
متغیر_exts.بیفزا(".csv")
متغیر_exts.بیفزا(".TXT")
سرچاپ رشته.پایان با یکی از(نام، متغیر_exts)، رشته.شروع با یکی از(نام، متغیر_exts)
ناپایا موفق := نادرست
سرچاپ رشته.برش پیشوند(نام، "Report-"، موفق)، موفق
سرچاپ رشته.برش پسوند(نام، ".md"، موفق)، موفق
پایانپایان با یکی از 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 جا نمیشود.واردسازی رشته
واردسازی حافظه
تابع ریشه:
داده := حافظه.تخصیص صفرشده حتمی(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 برگردان تهی*)
پایانپایان بایتی EndsWithBytes
تابع پایان بایتی(data: تهی*، n: صحیح، suffix: تهی*، m: صحیح): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: str-AffixBytes.salam
اسکی است IsAscii
تابع اسکی است(code: صحیح): منطقیواردسازی رشته
تابع ریشه:
هر م در ["A"، "z"، "7"، " "، "!"، "ب"، "۷"، "\t"]:
ک := رشته.کدنقطه ها(م).بگیر(۰)
سرچاپ "[" + م + "]"، رشته.اسکی است(ک)، رشته.حرف است(ک)، رشته.رقم است(ک)، رشته.فاصله است(ک)، رشته.نشانه نگارشی است(ک)
پایان
سرچاپ رشته.بزرگ اسکی است(۶۵)، رشته.کوچک اسکی است(۶۵)، رشته.بزرگ است(۱۰۴۰)، رشته.کوچک است(۱۰۷۲)
سرچاپ رشته.رقم اسکی است(۵۰)، رشته.حرف اسکی است(۵۰)، رشته.الفبایی عددی اسکی است(۵۰)، رشته.فاصله اسکی است(۳۲)
سرچاپ رشته.الفبایی عددی است(۱۷۷۶)، رشته.نشانه است(۱۶۱۴)، رشته.کنترلی است(۱۰)
پایانفاصله اسکی است 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: رشته): صحیحشمارنویسه را ببینید.واردسازی رشته
تابع ریشه:
الف := "سیب"
ب := "انار"
سرچاپ رشته.طول(الف)، رشته.خالی است("")، رشته.خالی است(الف)
سرچاپ رشته.پیوست(الف، ب)
سرچاپ رشته.مقایسه(الف، ب)، رشته.مقایسه(ب، الف)، رشته.مقایسه(الف، "سیب")
سرچاپ رشته.یکسان است(الف، "سیب")
سرچاپ رشته.زیررشته("salam donya"، ۶، ۵)، رشته.زیررشته درون("salam"، ۳، ۱۰)
سرچاپ رشته.یافتن("salam donya"، "donya")
ر := رشته.رونوشت(الف)
سرچاپ ر
پایانطول بایتی ByteLen
تابع طول بایتی(s: رشته): صحیحطول یکای utf-16 را میشمارد، پس برای کار بایتی این را به کار ببرید.واردسازی رشته
تابع ریشه:
متن := "سلام"
سرچاپ رشته.طول بایتی(متن)، رشته.شمارنویسه(متن)
سرچاپ رشته.زیررشته بایتی(متن، ۰، ۴)
سرچاپ رشته.زیررشته نویسه(متن، ۰، ۲)
پایانزیررشته بایتی 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 باشد میشکند و تکهها را در یک وکتور برمیگرداند. وکتور را پس از کار آزاد کنید.واردسازی رشته
تابع ریشه:
تکهها := رشته.تفکیک کردن("سیب,انار,انگور"، ",")
دیرکن تکهها.آزادکن()
سرچاپ تکهها.طول()، تکهها.بگیر(۱)
سرچاپ رشته.بپیوند(تکهها، " / ")
پایانبپیوند Join
تابع بپیوند(parts: وکتور<رشته>، sep: رشته): رشتهsep بینشان به هم میچسباند؛ برعکس تفکیک کردن.نمونهی این مورد همراه با موارد بالاتر آمده است: str-Split.salam
پیرایش Trim
تابع پیرایش(s: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: str-Trim.salam
تبدیل به عدد ToInt
تابع تبدیل به عدد(s: رشته): صحیحواردسازی رشته
تابع ریشه:
سرچاپ رشته.تبدیل به عدد("۴۲") + ۱، رشته.تبدیل به عدد("abc")
سرچاپ رشته.تبدیل به اعشار("2.5") * ۲
سرچاپ "[" + رشته.از عدد(-۱۵) + "]"، "[" + رشته.از اعشار(۱.۲۵) + "]"
پایانتبدیل به اعشار ToFloat
تابع تبدیل به اعشار(s: رشته): اعشار۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: str-ToInt.salam
خالی است IsEmpty
تابع خالی است(s: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: str-Len.salam
رونوشت Clone
تابع رونوشت(s: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: str-Len.salam
جایگزینی Replace
تابع جایگزینی(s: رشته، find: رشته، replacement: رشته): رشتهfind را با replacement جایگزین میکند.واردسازی رشته
تابع ریشه:
سرچاپ رشته.جایگزینی("من سیب دوست دارم، سیب قرمز"، "سیب"، "انار")
پایاناز عدد FromInt
تابع از عدد(i: صحیح۶۴): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: str-ToInt.salam
از اعشار FromFloat
تابع از اعشار(f: اعشار۶۴): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: str-ToInt.salam
بزرگ Upper
تابع بزرگ(s: رشته): رشته"café" میشود "CAFé". حرفهای فارسی هم که بزرگ و کوچک ندارند.واردسازی رشته
تابع ریشه:
سرچاپ رشته.بزرگ("salam")، رشته.کوچک("SALAM")، رشته.حالت عنوانی("hello world")
سرچاپ رشته.یکسان بدون حساسیت("Straße"، "STRASSE")
سرچاپ رشته.مقایسه بدون حساسیت("abc"، "ABX")
سرچاپ رشته.بزرگ("سلام")
پایانکوچک Lower
تابع کوچک(s: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: str-Upper.salam
حالت عنوانی Title
تابع حالت عنوانی(s: رشته): رشته"élan VITAL" میشود "Élan Vital". واژهها فقط با فاصلههای سفید از هم جدا میشوند.نمونهی این مورد همراه با موارد بالاتر آمده است: str-Upper.salam
یکسان بدون حساسیت EqualFold
تابع یکسان بدون حساسیت(a: رشته، b: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: 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: رشته): صحیحواردسازی رشته
تابع ریشه:
م := "کَتاب👨👩👧"
سرچاپ رشته.شمارنویسه(م)، رشته.شمار خوشه(م)
سرچاپ رشته.خوشه ها(م)
سرچاپ رشته.برعکس خوشه ای("سَلام")
پایانخوشه ها Graphemes
تابع خوشه ها(s: رشته): وکتور<رشته>نمونهی این مورد همراه با موارد بالاتر آمده است: str-Graphemes.salam
برعکس خوشه ای ReverseGraphemes
تابع برعکس خوشه ای(s: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: str-Graphemes.salam