מפרט 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	רווח לבן
^	שלילת טווח
!"#$%&'()*+,\-.:;<=>?@[\\\]^_`{|}~	תווים אחרים