Piezīme: MyDocSafe lietotnes saskarne ir pieejama angļu valodā. Ekrānuzņēmumi un saskarnes nosaukumi ir norādīti angļu valodā, tulkojums dots iekavās.
MyDocSafe veidlapas atbalsta regulārās izteiksmes.
Kas ir regulārās izteiksmes un kā tās izmantot?
Regulārā izteiksme jeb saīsināti regex ir paraugs, kas apraksta noteiktu teksta kopu. Piemēram, ja vēlaties nodrošināt, lai veidlapas aizpildītājs ievadītu tieši tādu tekstu, kādu pieprasāt, varat izmantot regulāro izteiksmi, lai pieprasītu noteiktu ievades formātu vai validētu datus.
Piemēram, pieņemsim, ka vēlaties pieprasīt Apvienotās Karalistes valsts apdrošināšanas numuru (NIN). Tā formāts ir 2 rakstzīmes, kam seko 6 cipari un vēl viena rakstzīme. Šim formātam atbilstošā regulārā izteiksme būtu:
[a-z|A-Z]{2}[0-9]{6}[a-z|A-Z]
Šeit [a-z] nozīmē "jebkurš mazais burts", [A-Z] nozīmē "jebkurš lielais burts", | nozīmē "vai", tātad [a-z|A-Z] nozīmē "jebkura rakstzīme", {2} nozīmē "atkārtot divreiz" utt.
Dažu valstu valdības nodrošina regulārās izteiksmes bieži lietotiem formātiem. Piemēram, skatiet šo Wikipedia rakstu par Apvienotās Karalistes pasta indeksiem.
Lai atrastu īsu regulāro izteiksmju uzziņu materiālu, meklējiet 'regulāro izteiksmju ceļvedi' vai lasiet tālāk.
Rakstzīme | Skaidrojums | Piemērs | Atbilstības piemērs |
\d | Lielākajā daļā dzinēju: viens cipars | file_\d\d | file_25 |
\d | .NET, Python 3: viens Unicode cipars jebkurā rakstības sistēmā | file_\d\d | file_9੩ |
\w | Lielākajā daļā dzinēju: "vārda rakstzīme": ASCII burts, cipars vai pasvītrojums | \w-\w\w\w | A-b_1 |
\w | .Python 3: "vārda rakstzīme": Unicode burts, ideogramma, cipars vai pasvītrojums | \w-\w\w\w | 字-ま_۳ |
\w | .NET: "vārda rakstzīme": Unicode burts, ideogramma, cipars vai savienotājzīme | \w-\w\w\w | 字-ま‿۳ |
\s | Lielākajā daļā dzinēju: "tukšumzīme": atstarpe, tabulācija, jaunas rindas rakstzīme, atgriešanās rindas sākumā, vertikālā tabulācija | a\sb\sc | a b |
\s | .NET, Python 3, JavaScript: "tukšumzīme": jebkurš Unicode atdalītājs | a\sb\sc | a b |
\D | Viena rakstzīme, kas nav cipars atbilstoši jūsu dzinēja \d definīcijai | \D\D\D | ABC |
\W | Viena rakstzīme, kas nav vārda rakstzīme atbilstoši jūsu dzinēja \w definīcijai | \W\W\W\W\W | *-+=) |
\S | Viena rakstzīme, kas nav tukšumzīme atbilstoši jūsu dzinēja \s definīcijai | \S\S\S\S | Yoyo |
Kvantifikatori
Kvantifikators | Skaidrojums | Piemērs | Atbilstības piemērs |
+ | Vienu vai vairāk reižu | Version \w-\w+ | Version A-b1_1 |
{3} | Tieši trīs reizes | \D{3} | ABC |
{2,4} | Divas līdz četras reizes | \d{2,4} | 156 |
{3,} | Trīs vai vairāk reižu | \w{3,} | regex_tutorial |
* | Nulli vai vairāk reižu | A*B*C* | AAACC |
? | Vienu reizi vai nevienu | plurals? | plural |
Citas rakstzīmes
Rakstzīme | Skaidrojums | Piemērs | Atbilstības piemērs |
. | Jebkura rakstzīme, izņemot rindas pārtraukumu | a.c | abc |
. | Jebkura rakstzīme, izņemot rindas pārtraukumu | .* | whatever, man. |
\. | Punkts (speciālā rakstzīme: jāekranē ar \) | a\.c | a.c |
\ | Ekranē speciālo rakstzīmi | \.\*\+\? \$\^\/\\ | .*+? $^/\ |
\ | Ekranē speciālo rakstzīmi | \[\{\(\)\}\] | [{()}] |
Loģika
Loģika | Skaidrojums | Piemērs | Atbilstības piemērs |
| | Alternatīva / VAI operands | 22|33 | 33 |
( … ) | Grupa ar satura saglabāšanu | A(nt|pple) | Apple (saglabā "pple") |
\1 | Grupas 1 saturs | r(\w)g\1x | regex |
\2 | Grupas 2 saturs | (\d\d)\+(\d\d)=\2\+\1 | 12+65=65+12 |
(?: … ) | Grupa bez satura saglabāšanas | A(?:nt|pple) | Apple |
Citas tukšumzīmes
Rakstzīme | Skaidrojums | Piemērs | Atbilstības piemērs |
\t | Tabulācija | T\t\w{2} | T ab |
\r | Atgriešanās rindas sākumā rakstzīme | skatiet tālāk |
|
\n | Rindpadeves rakstzīme | skatiet tālāk |
|
\r\n | Rindu atdalītājs sistēmā Windows | AB\r\nCD | AB |
\N | Perl, PCRE (C, PHP, R…): viena rakstzīme, kas nav rindas pārtraukums | \N+ | ABC |
\h | Perl, PCRE (C, PHP, R…), Java: viena horizontāla tukšumzīme: tabulācija vai Unicode atstarpes atdalītājs |
|
|
\H | Viena rakstzīme, kas nav horizontāla tukšumzīme |
|
|
\v | .NET, JavaScript, Python, Ruby: vertikālā tabulācija |
|
|
\v | Perl, PCRE (C, PHP, R…), Java: viena vertikāla tukšumzīme: rindpadeve, atgriešanās rindas sākumā, vertikālā tabulācija, lappuses padeve, rindkopas vai rindas atdalītājs |
|
|
\V | Perl, PCRE (C, PHP, R…), Java: jebkura rakstzīme, kas nav vertikāla tukšumzīme |
|
|
\R | Perl, PCRE (C, PHP, R…), Java: viens rindas pārtraukums (atgriešanās rindas sākumā un rindpadeves pāris, kā arī visas rakstzīmes, kurām atbilst \v) |
|
|
Citi kvantifikatori
Kvantifikators | Skaidrojums | Piemērs | Atbilstības piemērs |
+ | + (vienu vai vairāk reižu) ir "alkatīgs" | \d+ | 12345 |
? | Padara kvantifikatorus "slinkus" | \d+? | 1 virknē 12345 |
* | * (nulli vai vairāk reižu) ir "alkatīgs" | A* | AAA |
? | Padara kvantifikatorus "slinkus" | A*? | tukša virkne virknē AAA |
{2,4} | Divas līdz četras reizes, "alkatīgs" | \w{2,4} | abcd |
? | Padara kvantifikatorus "slinkus" | \w{2,4}? | ab virknē abcd |
Rakstzīmju klases
Rakstzīme | Skaidrojums | Piemērs | Atbilstības piemērs |
[ … ] | Viena no iekavās norādītajām rakstzīmēm | [AEIOU] | Viens lielais patskaņa burts |
[ … ] | Viena no iekavās norādītajām rakstzīmēm | T[ao]p | Tap vai Top |
- | Diapazona apzīmējums | [a-z] | Viens mazais burts |
[x-y] | Viena no rakstzīmēm diapazonā no x līdz y | [A-Z]+ | GREAT |
[ … ] | Viena no iekavās norādītajām rakstzīmēm | [AB1-5w-z] | Viena no šīm rakstzīmēm: A,B,1,2,3,4,5,w,x,y,z |
[x-y] | Viena no rakstzīmēm diapazonā no x līdz y | [ -~]+ | Rakstzīmes ASCII tabulas drukājamo rakstzīmju sadaļā. |
[^x] | Viena rakstzīme, kas nav x | [^a-z]{3} | A1! |
[^x-y] | Viena rakstzīme, kas nav diapazonā no x līdz y | [^ -~]+ | Rakstzīmes, kas nav ASCII tabulas drukājamo rakstzīmju sadaļā. |
[\d\D] | Viena rakstzīme, kas ir cipars vai nav cipars | [\d\D]+ | Jebkuras rakstzīmes, tostarp |
[\x41] | Atbilst rakstzīmei ASCII tabulas heksadecimālajā pozīcijā 41, t. i., A | [\x41-\x45]{3} | ABE |
Enkuri un robežas
Enkurs | Skaidrojums | Piemērs | Atbilstības piemērs |
^ | Virknes sākums vai rindas sākums atkarībā no vairākrindu režīma. (Taču [^iekavās] tas nozīmē "ne") | ^abc .* | abc (rindas sākums) |
$ | Virknes beigas vai rindas beigas atkarībā no vairākrindu režīma. Daudzas nianses ir atkarīgas no dzinēja. | .*? the end$ | this is the end |
\A | Virknes sākums | \Aabc[\d\D]* | abc (virknes... |
\z | Pašas virknes beigas | the end\z | this is...\n...the end |
\Z | Virknes beigas vai (izņemot Python) pirms pēdējā rindas pārtraukuma | the end\Z | this is...\n...the end\n |
\G | Virknes sākums vai iepriekšējās atbilstības beigas |
|
|
\b | Vārda robeža | Bob.*\bcat\b | Bob ate the cat |
\b | Vārda robeža | Bob.*\b\кошка\b | Bob ate the кошка |
\B | c.*\Bcat\B.* | copycats |
