מפרט RE2 למפות של כתובות URL

כדי להגדיר מפות של כתובות URL עם כללים להפניית תנועה שמשתמשים בביטויים רגולריים, צריך להבין את הדרישות והמגבלות של תחביר הביטויים הרגולריים של RE2.

ל-RE2 יש את המגבלות המובנות הבאות:

  • ‫RE2 לא תומך בטענות שרירותיות של lookahead או lookbehind, וגם לא בהפניות חוזרות. באופן ספציפי, אין תמיכה באופרטורים הבאים של הפניה חוזרת:
    • ‫(?=) - positive lookahead
    • ‫(?!) – חיפוש קדימה שלילי
    • ‫(?<=) - positive lookbehind
    • ‫(?<!) – negative lookbehind
    • ‫\N – הפניה חוזרת, כאשר N הוא מספר שלם
  • ‫RE2 לא מזהה את \cx כתו Control-X.
  • ‫RE2 לא מזהה את אופרטורי הקיבוץ האטומי (?>...) ו-++
  • ‫RE2 לא מזהה את \C, ‏ \G או \X.
  • ‫RE2 לא מזהה תת-תבניות מותנות (?(...)...), הערות (?#...), הפניות לתבניות (?R) (?1) (?P>foo) או קריאות ל-C (?C...).

בנוסף להגבלות RE2 שמתוארות למעלה, אנחנו מטילים הגבלות נוספות על תחביר של ביטויים רגולריים באמצעות רשימת ההיתרים הבאה:

מחרוזת ריקה ואנלוגים של מחרוזות ריקות

אופרטור תיאור
^ בתחילת הטקסט או השורה (m=true)
$ בסוף הטקסט (כמו ‎\z ולא ‎\Z) או השורה (m=true)
\A בתחילת הטקסט
\b בגבול מילה ב-ASCII ‏ (\w בצד אחד ו-‎\W, ‏‎\A או ‎\z בצד השני)
\B לא בגבול מילה של ASCII
\g בתחילת הכתוביות שמחפשים בהן
\G בסוף המשחק האחרון
\z בסוף הטקסט

חזרות

אופרטור תיאור
x* אפס או יותר מופעים של x, עדיף יותר
x+ אחד או יותר x, עדיף יותר
x? אפס או אחד x, עדיף אחד
x{n,m} ‫N או n+1 או … או m x, עדיף יותר
x{n,} ‫N או יותר x, עדיף יותר
x{n} בדיוק n x
x*? אפס או יותר x, עדיפות לפחות
x+? אחת או יותר אפשרויות x, עדיפות לפחות
x?? אפס או x אחד, עדיף אפס
x{n,m}? ‫N או n+1 או ... או m x, עדיפות לפחות
x{n,}? ‫N או יותר x, עדיפות לפחות
x{n}? בדיוק n x

תת-התאמה

אופרטור תיאור
(re) קבוצה ממוספרת לחילוץ (תת-התאמה)
(?P<name>re) קבוצה לחילוץ עם שם ומספר (תת-התאמה)
(?<name>re) קבוצה לחילוץ עם שם ומספר (תת-התאמה)
(?:re) קבוצה שלא מיועדת לחילוץ
(?flags) הגדרת דגלים בקבוצה הנוכחית; לא מתבצעת לכידה
(?flags:re) הגדרת דגלים במהלך re; non-capturing

טווחים

אופרטור תיאור
[] טווחים
\d ספרות (≡ [0-9])
\D לא ספרות (≡ [^0-9])
\s רווח לבן (≡ [\t\n\f\r ])
\S לא רווח לבן (≡ [^\t\n\f\r ])
\w תווים במילה (≡ [0-9A-Za-z_])
\W לא תו במילה (≡ [^0-9A-Za-z_])
[[:alnum:]] אלפאנומרי (≡ [0-9A-Za-z])
[[:alpha:]] אלפביתי (≡ [A-Za-z])
[[:ascii:]] ‫ASCII (≡ [\x00-\x7F])
[[:blank:]] ריק (≡ [\t ])
[[:cntrl:]] תווי בקרה (≡ [\x00-\x1F\x7F])
[[:digit:]] ספרות (≡ [0-9])
[[:lower:]] אותיות קטנות (≡ [a-z])
[[:space:]] רווח לבן (≡ [\t\n\v\f\r ])
[[:upper:]] אותיות רישיות (≡ [A-Z])
[[:word:]] תווים במילה (≡ [0-9A-Za-z_])
[[:xdigit:]] ספרה הקסדצימלית (≡ [0-9A-Fa-f])

התווים שמותרים בטווחים

טווח התווים תיאור
0-9, A-Z, a-z אלפאנומרי
\x00-\x7F ASCII
0-9A-Fa-f ספרות הקסדצימליות
\t\n\v\f\r רווח לבן
^ שלילת טווח
!"#$%&'()*+,\-.:;<=>?@[\\\]^_`{|}~ תווים אחרים