Regex-diagram (railroad)

Sådan visualiserer du et regulært udtryk

1. Skriv eller indsæt dit mønster i Regulært udtryk. Du kan også indsætte en hel JavaScript-literal som /^\d{3}-\d{4}$/gm: skråstregerne fjernes, og flagene flyttes automatisk over i flagfeltet.
2. Tilføj flag, hvis du har brug for dem (vilkårlige af d g i m s u v y). Flag ændrer, hvordan nogle dele tegnes: med m bliver ^ og $ til »linjens start« og »linjens slutning«; med s bliver punktummet til »vilkårligt tegn«.
3. Diagrammet opdateres, mens du skriver. Tegn diagram tegner det om efter behov, og Næste eksempel går gennem nogle almindelige mønstre (e-mail, telefonnummer, hex-farve, pris, HTML-tag, webadresse).
4. Læs diagrammet fra venstre mod højre, fra den udfyldte prik til prikken med ring. Hver sti, du kan følge, er en streng, som mønsteret kan matche.
5. Brug Download SVG til et skarpt vektorbillede (dokumentation, slides), Download PNG til et billede i dobbelt opløsning, eller Kopiér SVG-kode for at indsætte koden på en webside.

Hold musen over en boks for at se den del af mønsteret, den stammer fra, og dens position.

Sådan læser du et railroad-diagram

Railroad-diagrammer, også kaldet syntaksdiagrammer, beskriver en grammatik som et sæt spor. Et regulært udtryk er netop sådan en grammatik, så tegningen viser dets opbygning langt bedre end en tæt række af symboler:

• Blå bokse er literal tekst, der skal stå, som den er skrevet, for eksempel »@«.
• Grønne bokse er tegntyper (\d ciffer, \w ordtegn, . vilkårligt tegn …) og tegnklasser. En klasse som [\w.+-] bliver til en boks med overskriften »et af«, der opregner hvert element; en negeret klasse [^…] er rød med overskriften »ingen af«.
• Lilla piller er ankre og grænser: tekstens eller linjens start og slutning, \b ordgrænse. De matcher en position, ikke et tegn.
• Orange stiplede bokse er tilbagehenvisninger som \1 eller \k<name>: den samme tekst, som en tidligere gruppe har matchet.
• Stiplede rammer er grupper. Indfangende grupper nummereres efter rækkefølgen af deres startparentes (»gruppe nr. 2 »domain««); ikke-indfangende grupper (?:…) får ingen ramme. Lookaheads og lookbehinds får en lyserød ramme med teksten »efterfulgt af« eller »forudgået af«, fordi de tjekker teksten uden at bruge den.
• Parallelle spor er alternativer adskilt af |.
• Et spor over et element lader dig springe det over (?, *, {0,n}). Et spor under med en pil går tilbage og gentager det (+, *, {n,m}). Andre antal end de sædvanlige står under løkken, for eksempel »2 til 5 gange«, og dovne kvantorer (+?, *?) er markeret »doven«.

Fejlmeddelelser med position

Mønsteret kontrolleres af din browsers egen motor til regulære udtryk i JavaScript, så det, værktøjet accepterer, er præcis det, new RegExp() accepterer med de samme flag. Når motoren afviser det, peger værktøjet på det fejlbehæftede tegn med dets position og en markør under mønsteret. Det genkender en ) uden makker, en gruppe, der aldrig lukkes, en tegnklasse, der mangler sin ], en kvantor uden noget at gentage (*a, a|+), en enlig omvendt skråstreg til sidst og {n,m}-kvantorer, hvor n er større end m. Andre fejl, for eksempel en tilbagehenvisning til et gruppenavn, der ikke findes, vises med browserens egen meddelelse.

Udtrykket kompileres kun for at blive valideret: det køres aldrig mod nogen tekst, og intet forlader din browser.