Regex – Reguláris kifejezések

fájlnevek felismerése és átnevezése mintával

A reguláris kifejezés (röviden regex) egy rövid szöveges minta, amellyel megmondjuk a rendszernek, hogy „milyen nevű fájlokat keresünk”, vagy „hogyan alakítsuk át ezt a nevet”. A BroAdminban a Script modul Loader, Syncer, Remote és Purger oldalának Minta mezője ilyen, a Loader Fájlnév mezője pedig a minta alapján építi fel az új nevet.

Első ránézésre ijesztőnek tűnhet, de a leggyakoribb esetekhez néhány alapszabály elég — ebben segít ez az oldal.

Szabály Részletek
A minta csak a fájl nevére illeszkedik A mappa útvonala nem része a vizsgált szövegnek
A kis- és nagybetű nem számít A ^.*\.wav$ a HIREK.WAV fájlra is illeszkedik
A minta a név bármely részére illeszkedhet Ha a teljes névre akarunk illeszteni, használjuk a ^ és $ jelet

Ha minden fájlnak illeszkednie kell, a legegyszerűbb minta a ^.*$.

Alapok

Speciális karakterek

Csoportok és elnevezett csoportok

A zárójelek () nemcsak csoportosítanak, hanem a bennük lévő találatot is elmentik, amit később fel lehet használni — pl. egy fájl átnevezésénél. Ha névvel akarunk hivatkozni egy csoportra (nem csak sorszámmal), a (?<name>…) szintaxist használjuk.

Példa — egy fájl neve alapján állítjuk elő az új nevét:

Minta:

^(?<time>\w{4})[-_](bkkinfo)[-_]*(?<date>.*)\.(?<ext>mp3|wav)$

Cél fájlnév: bkkinfo_${time}.${ext}

Eredmény: A 1020-bkkinfo.mp3 fájlból a rendszer bkkinfo_1020.mp3 nevet hoz létre.

Lépésről lépésre:

  1. ^ - A fájlnév elejét jelöli. Biztosítja, hogy az illesztés a string legelején kezdődjön.
  2. (?<time>\w{4}) - Négy darab word karaktert vár (betű, szám vagy aláhúzás). Ezeket a karaktereket a time nevű csoportba menti. (A 1020-bkkinfo.mp3 esetén a time értéke 1020.)
  3. [-_] - Pontosan egy kötőjel (-) vagy aláhúzás (_). Ez választja el az időrészt a fix szövegtől.
  4. (bkkinfo) - Szó szerint a bkkinfo szöveget várja. Ez egy fix, kötelező azonosító a fájlnévben.
  5. [-_]* - Opcionálisan 0 vagy több kötőjel vagy aláhúzás. Tehát elfogadja, ha van, de ha nincs, azt is.
  6. (?<date>.*) - Bármilyen karakterláncot elfogad (akár üreset is). Az egészet a date nevű csoportba menti.
  7. \. - Egy literál pont, ami elválasztja a fájlnevet a kiterjesztéstől.
  8. (?<ext>mp3|wav) - A fájl kiterjesztése — csak mp3 vagy wav lehet. Az értéket az ext nevű csoportba menti.
  9. $ - A fájlnév végét jelöli.

A Fájlnév mezőben a csoportokra így hivatkozunk:

Hivatkozás Jelentés
${név} A név nevű csoport tartalma
$1, $2, … Az első, második, … zárójeles csoport tartalma
$0 A minta által illesztett teljes szöveg

Minél több elnevezett csoportot ((?<name>…)) használunk a Mintában, annál kényelmesebben építhető fel az új fájlnév ${name} hivatkozásokkal — nem kell fejben tartani a csoportok sorszámát.

Dinamikus minták

Előfordul, hogy a mintát nem fix dátummal vagy órával, hanem dinamikusan szeretnénk megadni — pl. „mindig a mostani idő + 30 perc” alapján. Ehhez a minta szövegébe PowerShell-kifejezést ágyazhatunk: a rendszer minden futáskor kiértékeli, és az eredmény kerül a tényleges regexbe. A $( … ) részek tehát nem a regex részei, hanem PowerShell-kifejezések. Hogy mely mezőkben használható, azt a Script modul oldala sorolja fel.

 ^(?<date>$((Get-Date).AddMinutes(30).ToString('yyyyMMdd')))_HIREK-(?<hour>$((Get-Date).AddMinutes(30).ToString('HH')))30\.(?<ext>.+)$ 

Részletesen:

A leggyakrabban a Get-Date függvényt és annak módosítóit használjuk (AddSeconds, AddMinutes, AddHours, AddDays), de minden szabvány PowerShell szintaxis működik. Negatív érték esetén a rendszer kivon, nem hozzáad. Az “előre gondolkodáshoz” (pl. hogy egy fájlt már a tényleges időpont előtt keressünk) pozitív értéket adunk meg.

Gyakorlati példa — reggel nyolcas hírblokk: A rendszer egy 20251231_0800_HIREK.wav formátumú fájlnevet vár. 7:15-kor már biztosan lement az előző hírblokk, tehát ettől a pillanattól kezdve bármikor beolvashatjuk az újat, amint elkészül. Ehhez a 20251231_08 részt kell felismernünk — ezt egyszerű Get-Date-tel így fejezhetjük ki:

(Get-Date).ToString('yyyyMMdd_HH')

Ha ezt lefuttatjuk, 7:15-kor a kimenete 20251231_07 lenne — de nekünk már a nyolcasra végződő fájl kell. Ezért hozzáadunk 45 percet, így 7:15-kor a kifejezés már 8 órát fog mutatni:

(Get-Date).AddMinutes(45).ToString('yyyyMMdd_HH')

Több kész, gyakorlatban bevált dinamikus minta (fél órás/egész órás hírblokk, napi műsor, több adóra szétosztott feldolgozás) megtalálható a Loader dokumentációjában.

Lookahead és lookbehind (haladóknak)

Ezekre ritkán van szükség, de jó tudni, hogy léteznek: a néző (lookaround) kifejezések lehetővé teszik, hogy egy minta megelőző vagy követő feltételt vizsgáljunk anélkül, hogy az része lenne a tényleges egyezésnek.

Jelölők (flag-ek)

A regex viselkedése jelölőkkel (flag) is módosítható — ezekkel online regex-tesztelőkben és programozási nyelvekben találkozhatunk, jellemzően /minta/gi formában:

A BroAdmin Minta mezőibe csak magát a mintát kell beírni, perjelek és jelölők nélkül — tehát ^.*\.wav$, nem /^.*\.wav$/i. Külső regex-tesztelőből csak a perjelek közötti részt másoljuk át; a kis- és nagybetű-érzéketlenséget a BroAdmin magától alkalmazza.

Gyakori, kész minták

Mintákat legkényelmesebben a regex101 oldalon lehet összerakni és kipróbálni (a .NET változatot válasszuk): rögtön látszik, mire illeszkedik a minta, és csoportonként ki is színezi a találatot. A kész mintát perjelek és jelölők nélkül másoljuk be a BroAdmin mezőjébe.

Egy AI chat asszisztens is gyorsan összeállít regex mintát, ha megadjuk neki a fájlnevek formáját és azt, mit szeretnénk kiemelni belőle. A PowerShell-kifejezések egy PowerShell-ablakban, idézőjelek között próbálhatók ki, pl. “$( (Get-Date).AddMinutes(45).ToString('yyyyMMdd_HH') )”.