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

عبارت باقاعده regex

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

واردسازی عبارت باقاعده

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

عبارت باقاعده زبانی کوچک برای توصیف الگوی متن است؛ [0-9]+ یعنی «یک یا چند رقم». با آن می‌توانید بپرسید متنی با الگو جور است یا نه، همه‌ی جاهای جور را پیدا کنید، بخش‌هایی از آن را بیرون بکشید یا جایگزین کنید.

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

این بسته برای الگوهاست: بررسی ورودی، بیرون کشیدن فیلدها از خط‌های گزارش و بازنویسی متن. برای یک تکه‌متن ثابت، تابع‌های ساده‌ی رشته (شامل است، نمایه، جایگزینی، تفکیک) ساده‌تر و سریع‌ترند. برای کار واژه‌به‌واژه و آگاه از یونیکد روی متن فارسی به unicode سر بزنید.

پرانتز در الگو یک «گروه» می‌سازد و (?P<نام>...) گروهی نام‌دار. گروه صفر کل بخش جورشده است. در جایگزینی، $1 و $2 جای گروه‌ها را می‌گیرند.

محدودیت‌هایی که غافلگیر می‌کنند

  • موتور با بایت کار می‌کند. . و هر دسته یک بایت را جور می‌کنند، پس \w هیچ‌وقت با حرف فارسی جور نمی‌شود، بازه‌ای مثل [آ-ی] کار نمی‌کند و ب+ فقط بایت آخر ب را تکرار می‌کند. برای تکرار یک حرف فارسی آن را در گروه بگذارید، (ب)+، یا از دسته‌ی منفی مثل [^ ]+ استفاده کنید. واژه‌های فارسی ثابت و انتخاب‌هایی مثل (تهران|شیراز) درست کار می‌کنند.
  • \b نیست (حرف b خوانده می‌شود)، (?i) نیست، نگاه به جلو و ارجاع به گروه هم نیست (\1 یعنی رقم ۱). ^ و $ آغاز و پایان کل متن‌اند، هیچ‌وقت آغاز و پایان یک خط.
  • حداکثر ۱۶ گروه و شمار تکرار حداکثر ۶۴: a{100} الگوی نادرستی است.
  • الگوی نادرست خطاست، نه الگویی که هیچ‌وقت جور نمی‌شود: کامپایل و همه‌ی تابع‌های «رشته» یک خطا از نوع نحو با کد regex.invalid پرتاب می‌کنند، با پیامی مثل group has no closing ')'، و در جایگاه بایتی که الگو از آن‌جا خراب می‌شود (یا منفی یک وقتی الگو فقط بیش از اندازه بلند است). فراخوانی را با تلاش نشان بزنید، یا جایی که الگو از کاربر می‌آید خطا را بگیرید.
  • تطبیقی که بیش از ۴۰۰۰۰۰ گام لازم داشته باشد رها می‌شود و «جور نشد» گزارش می‌شود. تکرار تودرتو مثل (a+)+ روی ورودی بلند ممکن است به این حد برسد.
  • تابع‌ها وضعیت را در متغیرهای سراسری نگه می‌دارند، پس از این بسته هم‌زمان در چند نخ استفاده نکنید.

بررسی ورودی

رایج‌ترین کار این است که بفهمیم مقداری شکل درستی دارد یا نه: نشانی ایمیل، شماره‌ی موبایل یا کد پستی. تطبیق وقتی درست است که الگو هر جای متن پیدا شود؛ پس الگویی که برای بررسی ورودی به کار می‌رود باید با ^ شروع شود و با $ تمام شود، وگرنه "abc 09121234567 xyz" هم شماره‌ی موبایل حساب می‌شود. نام دادن به هر الگو با کامپایل، بیرون از حلقه یا تابع پاسخ به درخواست، الگوها را یک جا نگه می‌دارد.

regex-guide-validate.salam
واردسازی عبارت باقاعده

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

تابع ریشه خطادار:
    ایمیل := تلاش عبارت باقاعده.کامپایل("^[a-z0-9._]+@[a-z0-9-]+(\\.[a-z0-9-]+)+$")
    موبایل := تلاش عبارت باقاعده.کامپایل("^09[0-9]{9}$")
    کد پستی := تلاش عبارت باقاعده.کامپایل("^[0-9]{5}-?[0-9]{5}$")
    بررسی("ایمیل"، ایمیل، "sara.k@mail.example.com")
    بررسی("ایمیل"، ایمیل، "sara@localhost")
    بررسی("موبایل"، موبایل، "09121234567")
    بررسی("موبایل"، موبایل، "0912123456")
    بررسی("کد پستی"، کد پستی، "13145-67890")
    بررسی("کد پستی"، کد پستی، "1314567890")
    بررسی("کد پستی"، کد پستی، "13145 67890")
پایان
خروجیایمیل sara.k@mail.example.com درست ایمیل sara@localhost رد شد موبایل 09121234567 درست موبایل 0912123456 رد شد کد پستی 13145-67890 درست کد پستی 1314567890 درست کد پستی 13145 67890 رد شد

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

بیرون کشیدن فیلدها از هر خط

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

regex-guide-logs.salam
واردسازی عبارت باقاعده

تابع ریشه خطادار:
    خط‌ها := ["2026-10-01 12:00:01 INFO server started on :8080"،
        "2026-10-01 12:00:07 WARN slow query took 1200ms"،
        "2026-10-01 12:01:13 ERROR db: connection refused"،
        "این خط گزارش نیست"،
        "2026-10-01 12:02:40 ERROR db: connection refused"]
    الگو := تلاش عبارت باقاعده.کامپایل("^(?P<date>[0-9-]+) (?P<time>[0-9:]+) (?P<level>[A-Z]+) (?P<msg>.*)$")
    شمار := نگاشت {} برگردان نگاشت<رشته، صحیح>
    هر خط در خط‌ها:
        ت := عبارت باقاعده.یافتن تطبیق(الگو، خط)
        اگر وارونه ت.موفق:
            سرچاپ "رد شد:"، خط
            گذر
        پایان
        سطح := عبارت باقاعده.گروه با نام(ت، "level")
        اگر شمار.دارد(سطح):
            شمار.درج(سطح، شمار.بگیر(سطح) + ۱)
        وگرنه:
            شمار.درج(سطح، ۱)
        پایان
        اگر سطح برابر "ERROR":
            سرچاپ عبارت باقاعده.گروه با نام(ت، "time")، عبارت باقاعده.گروه با نام(ت، "msg")
        پایان
    پایان
    سرچاپ "INFO"، شمار.بگیر("INFO")، "WARN"، شمار.بگیر("WARN")، "ERROR"، شمار.بگیر("ERROR")
پایان
خروجی12:01:13 db: connection refused رد شد: این خط گزارش نیست 12:02:40 db: connection refused INFO 1 WARN 1 ERROR 2

بازنویسی متن

جایگزینی همه به جای هر مورد جور یک متن ثابت می‌گذارد و برای یکی کردن فاصله‌های پشت سر هم کافی است. وقتی متن جایگزین به خود مورد پیدا شده بستگی دارد، از جایگزینی همه با بسط استفاده کنید: در قالب آن $1 و $2 و بقیه گروه‌ها هستند و $0 کل مورد جور. این‌جا تاریخی که سال اولش آمده برعکس می‌شود و فقط تاریخ اول علامت می‌خورد. تفکیک کردن با یک دسته‌ی نویسه، متن را با هر ترکیبی از جداکننده‌ها می‌شکند.

regex-guide-rewrite.salam
واردسازی عبارت باقاعده

تابع ریشه خطادار:
    متن := "Invoice   2026-10-17,  due 2026-11-01.   Paid:  no"
    مرتب := تلاش عبارت باقاعده.جایگزینی همه رشته("[ \t]+"، متن، " ")
    سرچاپ مرتب
    تاریخ‌ها := تلاش عبارت باقاعده.کامپایل("([0-9]{4})-([0-9]{2})-([0-9]{2})")
    سرچاپ عبارت باقاعده.جایگزینی همه با بسط(تاریخ‌ها، مرتب، "$3/$2/$1")
    سرچاپ عبارت باقاعده.جایگزینی با بسط(تاریخ‌ها، مرتب، "[$0]")
    واژه‌ها := عبارت باقاعده.تفکیک کردن(تلاش عبارت باقاعده.کامپایل("[ ,.:]+")، "red, green.  blue: yellow")
    سرچاپ واژه‌ها.طول()، واژه‌ها
پایان
خروجیInvoice 2026-10-17, due 2026-11-01. Paid: no Invoice 17/10/2026, due 01/11/2026. Paid: no Invoice [2026-10-17], due 2026-11-01. Paid: no 4 ["red", "green", "blue", "yellow"]

الگوهایی که کاربر می‌نویسد

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

regex-guide-user.salam
واردسازی عبارت باقاعده

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

تابع ریشه:
    متن := "cat catalog concat dog"
    جستجو("cat"، متن)
    جستجو("\\w*cat\\w*"، متن)
    جستجو("[a-z]+og"، متن)
    جستجو("cat("، متن)
    جستجو("[a-z"، متن)
پایان
خروجیcat <- 3 مورد در 0 cat در 4 cat در 15 cat \w*cat\w* <- 3 مورد در 0 cat در 4 catalog در 12 concat [a-z]+og <- 2 مورد در 4 catalog در 19 dog الگوی نادرست: cat( <- group has no closing ')' در بایت 3 الگوی نادرست: [a-z <- character class has no closing ']' در بایت 0

موتور نحو رایج را می‌شناسد: دسته‌هایی مثل [a-z]، کوتاه‌نوشت‌های \d و \w و \s و وارونه‌ی بزرگشان، تکرار با * و + و ? و {n,m}، انتخاب با |، و گروه‌های ساده و نام‌دار. پرچم (?i) نیست؛ برای جستجوی بی‌توجه به بزرگی و کوچکی حروف، اول متن را با رشته کوچک کنید و الگو را با حروف کوچک بنویسید. جاها به بایت شمرده می‌شوند، پس هر حرف فارسی دو بایت جا می‌گیرد.

متن فارسی

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

regex-guide-persian.salam
واردسازی عبارت باقاعده
واردسازی رشته

تابع نمایش(برچسب: رشته، یافته‌ها: وکتور<رشته>):
    سرچاپ برچسب، یافته‌ها.طول()، "|"، رشته.بپیوند(یافته‌ها، "، ")
پایان

تابع ریشه خطادار:
    پست := "سفر به #تهران و #اصفهان با #قطار_شبانه"
    نمایش("#\\w+ پیدا می‌کند"، تلاش عبارت باقاعده.یافتن همه رشته("#\\w+"، پست))
    نمایش("#[^ ]+ پیدا می‌کند"، تلاش عبارت باقاعده.یافتن همه رشته("#[^ ]+"، پست))
    نمایش("هه+ پیدا می‌کند"، تلاش عبارت باقاعده.یافتن همه رشته("هه+"، "عالیههههه"))
    نمایش("ه(ه)+ پیدا می‌کند"، تلاش عبارت باقاعده.یافتن همه رشته("ه(ه)+"، "عالیههههه"))
    شهر := تلاش عبارت باقاعده.یافتن تطبیق رشته("(تهران|اصفهان|شیراز)"، پست)
    سرچاپ "نخستین شهر:"، عبارت باقاعده.گروه(شهر، ۰)، "در بایت"، شهر.آغاز
پایان
خروجی#\w+ پیدا می‌کند 0 | #[^ ]+ پیدا می‌کند 3 | #تهران، #اصفهان، #قطار_شبانه هه+ پیدا می‌کند 2 | هه، هه ه(ه)+ پیدا می‌کند 1 | ههههه نخستین شهر: تهران در بایت 13

\w فقط حرف‌ها و رقم‌های ASCII و _ را می‌شناسد، پس #\w+ چیزی پیدا نمی‌کند؛ «هر چیزی تا فاصله» با [^ ]+ برای هر خطی کار می‌کند. هه+ دو تکه پیدا می‌کند، چون + فقط روی بایت دوم ه اثر دارد؛ گروه در ه(ه)+ کل حرف را تکرار می‌کند. جای ۱۳ به بایت است: پنج حرف فارسی پیش از نام شهر هر کدام دو بایت و دو فاصله و # هر کدام یک بایت می‌گیرند.

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

کارتابع
متن این شکل را دارد؟تطبیق با ^...$
اولین مورد کجاست؟یافتن، یا یافتن تطبیق برای گروه‌ها
همه‌ی موردها به شکل متنیافتن همه، و یافتن چند برای حداکثر n مورد
همه‌ی موردها با جا و گروهیافتن همه تطبیق ها
خواندن فیلدهای یک خطیافتن تطبیق و بعد گروه یا گروه با نام
جایگزینی با متن ثابتجایگزینی، جایگزینی همه
جایگزینی با کمک گروه‌هاجایگزینی با بسط، جایگزینی همه با بسط
شکستن متن با یک الگوی جداکنندهتفکیک کردن، تفکیک کردن چند
الگویی که کاربر نوشتهکامپایل درون تلاش:، یا معتبر است

هر کدام از این‌ها یک همزاد با پسوند «رشته» دارد که الگو را به شکل متن می‌گیرد، همان رفتار را دارد و برای الگوی نادرست خطا پرتاب می‌کند.

گونه‌ها

نتیجه تطبیق MatchResult

ساختار نتیجه تطبیق
نتیجه‌ی یک جستجو. به‌جای خواندن مستقیم فیلدها، بیشتر وقت‌ها تابع‌های «گروه» ساده‌ترند.
نامانگلیسیگونهتوضیح
موفقokمنطقی = نادرستاگر جوری پیدا شده باشد، درست است.
آغازstartصحیح = -1جای شروع بخش جورشده، بر حسب بایت.
پایانstopصحیح = -1جای پایان بخش جورشده، بر حسب بایت (خود این جایگاه جزو آن نیست).
تعداد گروه‌هاcountصحیح = 0تعداد گروه‌ها، به‌جز گروه صفر.
متنtextرشته = ""کل متنی که در آن جستجو شده؛ نه فقط بخش جورشده. بخش جورشده را با گروه(ت، ۰) بگیرید.
الگوpatternرشته = ""الگویی که جستجو با آن انجام شده.
آغاز گروه‌هاgsصحیح[]جای شروع هر گروه.
انتهای گروه‌هاgeصحیح[]جای پایان هر گروه.
regex-Group.salam
واردسازی عبارت باقاعده

تابع ریشه خطادار:
    ع := تلاش عبارت باقاعده.کامپایل("(?P<year>[0-9]{4})-(?P<month>[0-9]{2})")
    ت := عبارت باقاعده.یافتن تطبیق(ع، "تاریخ: 2025-09")
    سرچاپ ت.موفق، ت.آغاز، ت.پایان، ت.متن
    سرچاپ عبارت باقاعده.تعداد گروه(ت)، عبارت باقاعده.گروه هست(ت، ۱)
    سرچاپ عبارت باقاعده.گروه(ت، ۰)، عبارت باقاعده.گروه(ت، ۱)، عبارت باقاعده.گروه(ت، ۲)
    سرچاپ عبارت باقاعده.شروع گروه(ت، ۲)، عبارت باقاعده.پایان گروه(ت، ۲)
    سرچاپ عبارت باقاعده.شماره گروه(ت، "month")، عبارت باقاعده.گروه با نام(ت، "year")
    ت۲ := عبارت باقاعده.یافتن تطبیق از(ع، "2024-01 و 2025-02"، ۵)
    سرچاپ عبارت باقاعده.گروه(ت۲، ۰)
    سرچاپ عبارت باقاعده.گروه(تلاش عبارت باقاعده.یافتن تطبیق رشته("b+"، "aabbbc")، ۰)
    سرچاپ عبارت باقاعده.یافتن زیرتطبیق(ع، "2025-09")
    سرچاپ تلاش عبارت باقاعده.یافتن زیرتطبیق رشته("(a)(b)"، "xab")
پایان
خروجیtrue 12 19 تاریخ: 2025-09 2 true 2025-09 2025 09 17 19 2 2025 2025-02 bbb ["2025-09", "2025", "09"] ["ab", "a", "b"]

عبارت باقاعده Regex

ساختار عبارت باقاعده
الگویی سنجیده که با کامپایل ساخته می‌شود. تابع‌هایی که آن را می‌گیرند شکست نمی‌خورند. اگر دستی و با الگوی نادرست ساخته شود، هیچ‌وقت جور نمی‌شود.
نامانگلیسیگونهتوضیح
الگوpatternرشته = ""متن الگو.
regex-Compile.salam
واردسازی عبارت باقاعده

تابع ریشه خطادار:
    ع := تلاش عبارت باقاعده.کامپایل("[0-9]+")
    سرچاپ ع.الگو، عبارت باقاعده.معتبر است("[0-9]+")، عبارت باقاعده.معتبر است("[0-9")
    سرچاپ عبارت باقاعده.تطبیق(ع، "abc123")، عبارت باقاعده.یافتن(ع، "abc123")
    سرچاپ عبارت باقاعده.جایگزینی(ع، "a1 b22 c333"، "#")
    سرچاپ عبارت باقاعده.جایگزینی همه(ع، "a1 b22 c333"، "#")
    سرچاپ تلاش عبارت باقاعده.تطبیق رشته("^[a-z]+$"، "salam")، تلاش عبارت باقاعده.یافتن رشته("o"، "salam donya")
    سرچاپ تلاش عبارت باقاعده.جایگزینی رشته("a"، "banana"، "o")، تلاش عبارت باقاعده.جایگزینی همه رشته("a"، "banana"، "o")
    تلاش:
        بد := عبارت باقاعده.کامپایل("[0-9")
        سرچاپ بد.الگو
    گرفتن خطا خ:
        سرچاپ خ.نام نوع()، خ.کد، خ.جایگاه، خ.پیام
    پایان
پایان
خروجی[0-9]+ true false true 3 a# b22 c333 a# b# c# true 7 bonana bonono syntax error regex.invalid 0 character class has no closing ']'

تابع‌ها

یافتن تطبیق FindMatch

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

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

یافتن تطبیق رشته FindMatchStr

تابع یافتن تطبیق رشته(pattern: رشته، text: رشته): Throws<نتیجه تطبیق>
مثل یافتن تطبیق، با الگوی متنی. برای الگوی نادرست نحو پرتاب می‌کند.

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

یافتن تطبیق از FindMatchFrom

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

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

تعداد گروه GroupCount

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

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

گروه هست GroupOk

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

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

گروه Group

تابع گروه(m: نتیجه تطبیق، i: صحیح): رشته
متن گروه شماره‌ی i را برمی‌گرداند؛ گروه صفر کل بخش جورشده است.

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

شروع گروه GroupStart

تابع شروع گروه(m: نتیجه تطبیق، i: صحیح): صحیح
جای شروع گروه، بر حسب بایت.

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

پایان گروه GroupEnd

تابع پایان گروه(m: نتیجه تطبیق، i: صحیح): صحیح
جای پایان گروه، بر حسب بایت.

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

شماره گروه GroupIndex

تابع شماره گروه(m: نتیجه تطبیق، name: رشته): صحیح
شماره‌ی یک گروه نام‌دار را برمی‌گرداند.

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

گروه با نام GroupByName

تابع گروه با نام(m: نتیجه تطبیق، name: رشته): رشته
متن یک گروه نام‌دار را برمی‌گرداند.

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

یافتن زیرتطبیق FindSubmatch

تابع یافتن زیرتطبیق(re: عبارت باقاعده، text: رشته): وکتور<رشته>
متن جورشده و همه‌ی گروه‌هایش را در یک وکتور برمی‌گرداند؛ عضو صفر کل بخش جورشده است.

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

یافتن زیرتطبیق رشته FindSubmatchStr

تابع یافتن زیرتطبیق رشته(pattern: رشته، text: رشته): Throws<وکتور<رشته>>
مثل یافتن زیرتطبیق، با الگوی متنی. برای الگوی نادرست نحو پرتاب می‌کند.

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

یافتن همه تطبیق ها FindAllMatches

تابع یافتن همه تطبیق ها(re: عبارت باقاعده، text: رشته، limit: صحیح): وکتور<نتیجه تطبیق>
همه‌ی جاهای جور را، با جزئیات، برمی‌گرداند. limit منفی یعنی بدون محدودیت.
regex-FindAll.salam
واردسازی عبارت باقاعده

تابع ریشه خطادار:
    ع := تلاش عبارت باقاعده.کامپایل("[0-9]+")
    متن := "سال 1403، ماه 7، روز 12"
    سرچاپ عبارت باقاعده.یافتن همه(ع، متن)
    سرچاپ عبارت باقاعده.یافتن چند(ع، متن، ۲)
    سرچاپ تلاش عبارت باقاعده.یافتن همه رشته("[a-z]+"، "one two three")
    سرچاپ عبارت باقاعده.تفکیک کردن(تلاش عبارت باقاعده.کامپایل(" *, *")، "a , b,c ,  d")
    سرچاپ عبارت باقاعده.تفکیک کردن چند(تلاش عبارت باقاعده.کامپایل(",")، "a,b,c,d"، ۲)
    سرچاپ تلاش عبارت باقاعده.تفکیک کردن رشته("-+"، "2025--09---29")
    همه := عبارت باقاعده.یافتن همه تطبیق ها(ع، متن، -۱)
    هر ت در همه:
        سرچاپ عبارت باقاعده.گروه(ت، ۰)، ت.آغاز، ت.پایان
    پایان
پایان
خروجی["1403", "7", "12"] ["1403", "7"] ["one", "two", "three"] ["a", "b", "c", "d"] ["a", "b,c,d"] ["2025", "09", "29"] 1403 7 11 7 21 22 12 32 34

یافتن چند FindAllN

تابع یافتن چند(re: عبارت باقاعده، text: رشته، limit: صحیح): وکتور<رشته>
متن حداکثر limit مورد جور را برمی‌گرداند.

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

یافتن همه FindAll

تابع یافتن همه(re: عبارت باقاعده، text: رشته): وکتور<رشته>
متن همه‌ی موارد جور را در یک وکتور برمی‌گرداند.

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

یافتن همه رشته FindAllStr

تابع یافتن همه رشته(pattern: رشته، text: رشته): Throws<وکتور<رشته>>
مثل یافتن همه، با الگوی متنی. برای الگوی نادرست نحو پرتاب می‌کند.

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

تفکیک کردن چند SplitN

تابع تفکیک کردن چند(re: عبارت باقاعده، text: رشته، limit: صحیح): وکتور<رشته>
متن را هر جا با الگو جور شود می‌شکند، ولی حداکثر به limit تکه؛ تکه‌ی آخر بقیه‌ی متن است.

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

تفکیک کردن Split

تابع تفکیک کردن(re: عبارت باقاعده، text: رشته): وکتور<رشته>
متن را هر جا با الگو جور شود می‌شکند. برای جداکننده‌هایی که فاصله‌ی دورشان متغیر است، از رشته.تفکیک کردن انعطاف‌پذیرتر است.

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

تفکیک کردن رشته SplitStr

تابع تفکیک کردن رشته(pattern: رشته، text: رشته): Throws<وکتور<رشته>>
مثل تفکیک کردن، با الگوی متنی. برای الگوی نادرست نحو پرتاب می‌کند.

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

بسط Expand

تابع بسط(m: نتیجه تطبیق، template: رشته): رشته
یک قالب را با گروه‌های یک نتیجه پر می‌کند؛ $1، $2 و… جای گروه‌ها را می‌گیرند.
regex-Expand.salam
واردسازی عبارت باقاعده

تابع ریشه خطادار:
    ع := تلاش عبارت باقاعده.کامپایل("([a-z]+)@([a-z]+)")
    متن := "ali@home, sara@work"
    ت := عبارت باقاعده.یافتن تطبیق(ع، متن)
    سرچاپ عبارت باقاعده.بسط(ت، "$2 <- $1")
    سرچاپ عبارت باقاعده.جایگزینی با بسط(ع، متن، "$2:$1")
    سرچاپ عبارت باقاعده.جایگزینی همه با بسط(ع، متن، "$2:$1")
    سرچاپ تلاش عبارت باقاعده.جایگزینی با بسط رشته("(\\w+) (\\w+)"، "hello world"، "$2 $1")
    سرچاپ تلاش عبارت باقاعده.جایگزینی همه با بسط رشته("(a)(b)"، "abab"، "$2$1")
پایان
خروجیhome <- ali home:ali, sara@work home:ali, work:sara world hello baba

جایگزینی با بسط ReplaceExpand

تابع جایگزینی با بسط(re: عبارت باقاعده، text: رشته، template: رشته): رشته
نخستین مورد جور را با قالب جایگزین می‌کند؛ در قالب می‌توانید از $1 و… استفاده کنید.

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

جایگزینی همه با بسط ReplaceAllExpand

تابع جایگزینی همه با بسط(re: عبارت باقاعده، text: رشته، template: رشته): رشته
همه‌ی موارد جور را با قالب جایگزین می‌کند.

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

جایگزینی با بسط رشته ReplaceExpandStr

تابع جایگزینی با بسط رشته(pattern: رشته، text: رشته، template: رشته): Throws<رشته>
مثل جایگزینی با بسط، با الگوی متنی. برای الگوی نادرست نحو پرتاب می‌کند.

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

جایگزینی همه با بسط رشته ReplaceAllExpandStr

تابع جایگزینی همه با بسط رشته(pattern: رشته، text: رشته، template: رشته): Throws<رشته>
مثل جایگزینی همه با بسط، با الگوی متنی. برای الگوی نادرست نحو پرتاب می‌کند.

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

کامپایل Compile

تابع کامپایل(pattern: رشته): Throws<عبارت باقاعده>
الگو را می‌سنجد و در یک عبارت باقاعده می‌پیچد. اگر الگو نادرست یا بیرون از محدوده‌ها باشد، یک خطا از نوع نحو با کد regex.invalid پرتاب می‌کند؛ جایگاه بایتی است که الگو از آن‌جا خراب می‌شود، یا منفی یک وقتی کل الگو بیش از اندازه بلند است.

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

معتبر است IsValid

تابع معتبر است(pattern: رشته): منطقی
اگر الگو درست نوشته شده و در محدوده‌ها باشد درست برمی‌گرداند: حداکثر ۱۶ گروه و شمار تکرار تا ۶۴. همان سنجش کامپایل است، بی خطا.

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

تطبیق Match

تابع تطبیق(re: عبارت باقاعده، text: رشته): منطقی
اگر جایی از متن با الگو جور شود، درست برمی‌گرداند. برای جور شدن کل متن، الگو را با ^ و $ محصور کنید.

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

یافتن Find

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

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

جایگزینی Replace

تابع جایگزینی(re: عبارت باقاعده، text: رشته، replacement: رشته): رشته
فقط نخستین مورد جور را با متن تازه جایگزین می‌کند.

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

جایگزینی همه ReplaceAll

تابع جایگزینی همه(re: عبارت باقاعده، text: رشته، replacement: رشته): رشته
همه‌ی موارد جور را با متن تازه جایگزین می‌کند.

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

تطبیق رشته MatchStr

تابع تطبیق رشته(pattern: رشته، text: رشته): Throws<منطقی>
مثل تطبیق، با الگوی متنی. برای الگوی نادرست نحو پرتاب می‌کند.

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

یافتن رشته FindStr

تابع یافتن رشته(pattern: رشته، text: رشته): Throws<صحیح>
مثل یافتن، با الگوی متنی. برای الگوی نادرست نحو پرتاب می‌کند.

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

جایگزینی رشته ReplaceStr

تابع جایگزینی رشته(pattern: رشته، text: رشته، replacement: رشته): Throws<رشته>
مثل جایگزینی، با الگوی متنی. برای الگوی نادرست نحو پرتاب می‌کند.

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

جایگزینی همه رشته ReplaceAllStr

تابع جایگزینی همه رشته(pattern: رشته، text: رشته، replacement: رشته): Throws<رشته>
مثل جایگزینی همه، با الگوی متنی. برای الگوی نادرست نحو پرتاب می‌کند.

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