Porównując pliki lub foldery, możesz użyć filtrów, aby zawęzić zakres porównania. Może to być przydatne, gdy chcesz uprościć wynik porównania, eliminując różnice, które Cię nie interesują. Filtry to reguły oparte na wyrażeniach regularnych. WinMerge korzysta z popularnego silnika wyrażeń regularnych PCRE (Perl Integrated Regular Expressions).
Podstawowa funkcja filtrowania jest prosta: oceń każdy element, który normalnie byłby porównywany (folder, plik lub wiersz w pliku) i jeśli wyrażenie filtru pasuje do elementu docelowego, zastosuj filtr. W zależności od rodzaju filtra, pozycja jest uwzględniana lub wykluczana z porównania.
Istnieją różne filtry WinMerge do operacji porównywania folderów i plików:
Można określić pliki do uwzględnienia w porównaniu folderów, używając prostych masek plików lub, w przypadku bardziej złożonego filtrowania, stosując wiele reguł określonych w filtrze plików.
Odfiltrowane pliki i foldery są domyślnie ukryte w wynikach, co zazwyczaj jest pożądane. Możesz kliknąć → aby odkryć odfiltrowane elementy, ale okno Porównywanie folderów pokazuje tylko minimalne informacje na ich temat. Na przykład nie można stwierdzić, czy pominięty plik jest plikiem tekstowym, czy binarnym.
Dla operacji porównywania folderów dostępny jest także filtr wyświetlania plików/folderów. W przeciwieństwie do filtrów plików nie wpływa to na wynik porównania; kontroluje tylko, które elementy są widoczne w oknie porównywania folderów. Zobacz Korzystanie z wyświetlanego filtra plików/folderów.
Filtry liniowe są stosowane tylko do operacji porównywania plików. Pozwalają zignorować różnice w pojedynczych liniach.
Filtry podstawienia są stosowane tylko do operacji porównywania plików. Zamieniają ciągi w bloku diff na określone ciągi, porównują je i ignorują blok diff, jeśli wyniki zamiany są zgodne. Są przydatne do ignorowania dużej liczby nieinteresujących zmian.
Filtr linii wyświetlania jest również stosowany tylko do operacji porównywania plików. W przeciwieństwie do filtrów liniowych nie wpływa to na wynik porównania; kontroluje tylko, które linie są widoczne w oknie Porównania plików. Zobacz Korzystanie z filtra liniowego wyświetlacza.
Możesz użyć jednego lub więcej maski plików które określają rozszerzenia plików, które należy uwzględnić przy porównaniu folderów. Wszystkie inne pliki zostaną pominięte przy wyborze.
Zdefiniuj i zastosuj maskę pliku w momencie uruchomienia operacji porównywania folderów:
Jeśli korzystasz z okna dialogowego Wybierz pliki lub foldery, po wybraniu 1 i 2 folderów, wprowadź jedną lub więcej masek plików w pliku Filtruj pole. Maski są stosowane po rozpoczęciu operacji porównywania folderów.
Jeśli używasz wiersza poleceń WinMerge, użyj -f flagę
określającą maski plików (zobacz przykład w następnej sekcji).
Możesz określić maski plików i filtry rozszerzone, używając tego formatu:
Filter1 of Group1;Filter2 ...|Filter1 of Group2;Filter2 ...|...
The | znak oddziela grupy filtrów i działa jak logiczny
AND.
Filtry w tej samej grupie są oddzielone znakiem ; i są
interpretowane za pomocą logicznego OR.
Plik jest uwzględniany tylko wtedy, gdy pasuje do co najmniej jednego filtra w każdej grupie.
Aby uwzględnić literał | (potok) w wyrażeniu
regularnym, które nie jest ujęte w cudzysłów (np f: lub
f!: filtry), użyj || zamiast tego.
Przykład: f:(abc||def)\.txt$
Każdy filtr (np. Filtr1, Filtr2) może należeć do jednego z następujących typów:
*.extMaska pliku według rozszerzenia (np. *.txt)
*.Pliki bez rozszerzenia (np. README)
*.extWyklucz pliki pasujące do rozszerzenia (dostępne od 2.16.19)
folder\Foldery docelowe (muszą kończyć się \) (dostępne od 2.16.19)
folder\Wyklucz pasujące foldery (dostępne od 2.16.19)
regexpDopasuj nazwy plików za pomocą wyrażeń regularnych (dostępne od 2.16.49)
regexpWyklucz pliki pasujące do wyrażenia regularnego (dostępne od 2.16.49)
regexpDopasuj nazwy folderów za pomocą wyrażenia regularnego (dostępne od 2.16.49)
regexpWyklucz foldery pasujące do wyrażenia regularnego (dostępne od 2.16.49)
exprWyrażenie filtrujące dla plików (np. fe:Size < 1KB) (Dostępne od 2.16.49)
exprWyrażenie filtru wykluczające pliki (dostępne od 2.16.49)
exprWyrażenie filtra dla folderów (dostępne od 2.16.49)
exprWyrażenie filtru wykluczające foldery (dostępne od 2.16.49)
file filter nameZastosuj filtr plików według nazwy (dostępne od 2.16.49)
Example 1. Maska pliku
W tym przykładzie wiersza poleceń operacja porównywania folderów obejmuje
tylko pliki z xml lub txt
rozszerzenia. Wszystkie pozostałe pliki są pomijane:
WinMergeU c:\project\docs c:\temp /f *.xml;*.txt
Example 2. Z wyłączeniem folderów (od wersji 2.16.19)
W tym przykładzie wiersza poleceń operacja porównywania folderów wyklucza
.git i .vs foldery:
WinMergeU c:\project\docs c:\temp /f !.git\;!.vs\
Example 3. Wyrażenie filtra (od wersji 2.16.49)
W tym przykładzie wiersza poleceń operacja porównywania folderów obejmuje
tylko pliki z cpp lub h
rozszerzenia i rozmiar pliku mniejszy niż 1 KB:
WinMergeU c:\project\docs c:\temp /f "*.cpp;*.h|fe:Size <
1KB"
WinMerge umożliwia zaawansowane filtrowanie przy użyciu wyrażeń operujących na metadanych plików, zawartości i kontekście porównania. W tej sekcji opisano obsługiwane atrybuty, operatory, funkcje, typy danych i reguły oceny.
Obsługiwane typy literałów obejmują:
Wartość logiczna: true,
false
Zero: none (reprezentuje wartość
null lub brakującą wartość)
Liczba całkowita: 64-bitowe liczby całkowite ze znakiem
(np. 1024lub z jednostkami takimi jak
100KB, 7days)
Prawdziwe (podwójne): Liczby zmiennoprzecinkowe z
opcjonalnym ułamkiem dziesiętnym lub wykładnikiem
(np. 3.14, .5, 1e6)
Sznurek: Ujęte w cudzysłów
(np. "example")
Data/godzina: Z prefiksem d i ująć w
cudzysłów (np. d"2026-05-21 07:16:33",
d"2026-05-21")
Wewnętrznie wartości mogą być następujących typów: Boolean, Integer, Real,
Timestamp, String, File Content, Array lub none.
Wyrażenia filtrujące obsługują dyrektywy kontrolujące sposób oceniania
wyrażenia. Dyrektywy są określone na początku wyrażenia, poprzedzone
prefiksem @i oddzielone od wyrażenia spacjami.
Domyślnie wszystkie operatory porównania ciągów (=,
!=, <, <=,
>, >=,
contains, recontains,
like, matches) nie uwzględniają
wielkości liter. Możesz kontrolować to zachowanie za pomocą następujących
dyrektyw:
@cs, @casesensitive
Włącz porównanie uwzględniające wielkość liter. Dzięki tym dyrektywom
"ABC" i "abc" są uważane za różne.
@ci, @caseinsensitive
Włącz porównanie bez rozróżniania wielkości liter (zachowanie
domyślne). Dzięki tym dyrektywom "ABC" i
"abc" są uważane za identyczne.
Example 4. Przykłady uwzględniania wielkości liter
@cs Nazwa = „README.txt” ## Wielkość liter ma znaczenie: pasuje tylko do „README.txt” @ci Name = „readme.txt” ## Wielkość liter nie jest uwzględniana: pasuje do „README.txt”, „readme.txt”, „ReadMe.TXT” itp. @caseprotection Extension = "TXT" ## Uwzględniana jest wielkość liter: dopasowuje tylko pliki z rozszerzeniem ".TXT". @caseinprotection Treść zawiera „błąd” ## Wielkość liter nie jest uwzględniana: dopasowuje „Błąd”, „BŁĄD”, „błąd” itp.
Domyślnie wyrażenia filtrów są zoptymalizowane w celu poprawy wydajności. Możesz kontrolować to zachowanie za pomocą następujących dyrektyw:
@optimize, @optWłącz optymalizację wyrażeń filtra (zachowanie domyślne). Może to poprawić wydajność złożonych wyrażeń.
@nooptimize, @nooptWyłącz optymalizację wyrażeń filtra. Jest to przydatne podczas debugowania lub gdy optymalizacja powoduje nieoczekiwane wyniki.
Example 5. Przykłady optymalizacji
@optymalizuj rozmiar > 10 MB i rozszerzenie = „log” ## Włącz optymalizację (domyślnie) @noopt Nazwa pasuje do „complex[0-9]+pattern” ## Wyłącz optymalizację na potrzeby debugowania @nooptimize Treść zawiera „przypadek specjalny” ## Wyłącz optymalizację
The @name Dyrektywa umożliwia przypisanie opisowej nazwy
do wyrażenia filtrującego. Ta nazwa jest przeznaczona do stosowania w
komunikatach o błędach i dziennikach, aby pomóc zidentyfikować, które
wyrażenie filtru spowodowało problem.
@name="Filter Name", @name=FilterNamePrzypisuje nazwę do wyrażenia filtru. Jeżeli nazwa zawiera spacje lub znaki specjalne, należy ją ująć w cudzysłów. Nazwy bez spacji można podawać bez cudzysłowów.
Podana nazwa będzie używana w komunikatach o błędach i wynikach diagnostycznych w celu identyfikacji filtra. Jest to szczególnie przydatne podczas pracy z wieloma złożonymi wyrażeniami filtrującymi.
Example 6. Przykłady dyrektyw nazw
@name="Rozmiar dużych plików obrazów". > 10 MB i rozszerzenie = „png” @name=Rozmiar małego pliku tekstowego < 1 KB i rozszerzenie = „txt” @name="Dzisiaj zmodyfikowano" Data >= dzisiaj() @name="Filtr testowy" @cs Nazwa typu "test_*.cpp"
The @name dyrektywę można łączyć z innymi dyrektywami.
Gdy używanych jest wiele dyrektyw, wszystkie powinny pojawić się na początku
wyrażenia, oddzielone białymi znakami.
Wyrażenia filtrujące obsługują różnorodne atrybuty odnoszące się do metadanych i zawartości plików. W nazwach atrybutów wielkość liter nie jest rozróżniana. Opcjonalnie możesz określić, której strony porównania (lewej, prawej lub środkowej) dotyczy atrybut, używając przedrostka.
ExistsPowroty true jeśli plik istnieje,
false inaczej
NameNazwa pliku
BaseNameZwraca nazwę pliku bez rozszerzenia. Na przykład „dokument.txt” zwraca „dokument”.
ExtensionRozszerzenie pliku
IsFolderZwraca wartość true, jeśli elementem jest folder/katalog, lub false, jeśli jest to plik.
FolderZwraca ścieżkę względną z wyłączeniem nazwy pliku i folderu podstawowego
RelPathZwraca ścieżkę względną z katalogu głównego porównania, zawierającą zarówno ścieżkę folderu, jak i nazwę pliku. Na przykład, jeśli porównasz „C:\Project”, a plik znajduje się w „C:\Project\src\main.cpp”, RelPath zwróci „src\main.cpp”.
FullPathZwraca pełną ścieżkę pliku
SizeRozmiar pliku
DateOstatnia modyfikacja znacznika czasu
DateStrCiąg daty ostatniej modyfikacji w yyyy-MM-dd formatować
CreationTimeZnacznik czasu daty utworzenia
AttributesZwraca atrybuty pliku jako wartość całkowitą
AttrStrZwraca ciąg atrybutów pliku. Przykłady: "R" tylko do
odczytu, "H" dla Ukrytych, "A" dla
Archiwum, "S" dla pliku systemowego.
Poniższe atrybuty są dostępne tylko dla elementów porównania plików. W przypadku użycia z elementami folderów zachowanie jest niezdefiniowane.
ContentTreść pliku. Zwraca wartość typu FileContent. Tylko
contains i recontains można używać z
tym typem.
Poniższe atrybuty są dostępne tylko dla elementów porównywania folderów. W przypadku użycia z elementami pliku zachowanie jest niezdefiniowane.
FilesLiczba plików bezpośrednio zawartych w folderze.
RecursiveFilesLiczba plików zawartych w folderze, łącznie ze wszystkimi podfolderami.
ItemsLiczba elementów (plików i podfolderów) bezpośrednio zawartych w folderze.
RecursiveItemsLiczba elementów (plików i podfolderów) zawartych w folderze, łącznie ze wszystkimi podfolderami.
TotalSizeCałkowity rozmiar wszystkich plików znajdujących się bezpośrednio w folderze, w bajtach.
RecursiveTotalSizeCałkowity rozmiar wszystkich plików zawartych w folderze, łącznie ze wszystkimi podfolderami, w bajtach.
Można dodać przedrostki, aby określić stronę porównania:
Lewy: dotyczy pliku po lewej stronie
(np. LeftSize)
Jasne: Dotyczy pliku po prawej stronie
(np. RightDate)
Środkowy: Dotyczy pliku środkowego w porównaniu
trójstronnym (np. MiddleName)
Atrybuty bez przedrostka (np. Size) zwraca tablicę
wartości ze wszystkich dostępnych stron (lewa, środkowa, prawa).
Te atrybuty zapewniają dostęp do wartości systemu właściwości systemu
Windows, takich jak metadane zdefiniowane przez schemat systemu właściwości
systemu Windows (np. System.Title,
System.FileOwner,
System.Image.HorizontalResolution).
Prop
Zwraca tablicę wartości właściwości (lewa, środkowa, prawa) dla określonej
nazwy właściwości kanonicznej. Przykład:
prop("System.Title")
LeftProp
Wartość właściwości pliku po lewej stronie. Przykład:
leftprop("System.FileOwner")
MiddlePropWartość właściwości pliku środkowego (w porównaniu trójstronnym).
RightPropWartość właściwości pliku po prawej stronie.
Poniższe atrybuty są przeznaczone do użycia w Wyświetl
tylko filtry (określone przez mi:,
e!:, np:,
fe!:, od:lub
de!: prefiksy w polu Filtr). Nie należy ich używać w
filtrze plików (.flt) reguły włączania/wyłączania,
ponieważ wymagają one najpierw zakończenia porównania i mogą prowadzić do
nieoczekiwanego zachowania.
Identical
Powroty true jeżeli wynik porównania wskazuje, że pozycje
są identyczne, false inaczej. Jest to atrybut globalny
(nie obsługuje przedrostków specyficznych dla strony). Przykład:
Identical aby wyświetlić tylko identyczne pliki.
Different
Powroty true jeżeli wynik porównania wskazuje, że pozycje
są różne, false inaczej. Jest to atrybut globalny (nie
obsługuje przedrostków specyficznych dla strony). Przykład:
Different aby wyświetlić tylko różne pliki.
Skipped
Powroty true jeżeli porównanie zostało pominięte ze
względu na błąd lub regułę filtrowania, false inaczej.
Jest to atrybut globalny (nie obsługuje przedrostków specyficznych dla
strony). Przykład: Skipped aby wyświetlić tylko
pominięte elementy.
Binary
Powroty true jeśli plik zostanie wykryty jako binarny,
false jeśli jest to tekst, lub none
jeśli plik nie istnieje. Ten atrybut obsługuje przedrostki specyficzne dla
strony (np. LeftBinary, RightBinary).
Przykład: allof(Binary) aby wyświetlić pliki binarne ze
wszystkich stron.
DifferentLeftMiddle
Powroty true jeśli lewy i środkowy plik różnią się w
porównaniu trójstronnym, false inaczej. Powroty
none w porównaniach dwukierunkowych. Jest to atrybut
globalny (nie obsługuje przedrostków specyficznych dla strony). Przykład:
DifferentLeftMiddle and not DifferentMiddleRight aby
znaleźć pliki, w których tylko lewa strona różni się od środka.
DifferentMiddleRight
Powroty true jeśli plik środkowy i prawy różnią się w
porównaniu trójstronnym, false inaczej. Powroty
none w porównaniach dwukierunkowych. Jest to atrybut
globalny (nie obsługuje przedrostków specyficznych dla strony). Przykład:
DifferentMiddleRight aby pokazać pliki, w których środek
i prawy różnią się.
DifferentLeftRight
W porównaniach trójstronnych zwraca true jeśli lewy i
prawy plik są różne, false inaczej. W porównaniach
dwukierunkowych zwraca true jeśli oba pliki istnieją i są
różne. Jest to atrybut globalny (nie obsługuje przedrostków specyficznych
dla strony). Przykład: DifferentLeftRight aby pokazać
pliki, w których lewy i prawy różnią się.
Differences
Zwraca liczbę różnic tekstowych w porównaniu plików. Ten atrybut ma
znaczenie tylko w przypadku porównywanych plików tekstowych. Jest to
atrybut globalny (nie obsługuje przedrostków specyficznych dla strony).
Przykład: Differences > 0 aby pokazać pliki z
różnicami, lub Differences > 10 aby wyświetlić pliki z
więcej niż 10 różnicami.
IgnoredDiffs
Zwraca liczbę zignorowanych różnic w porównaniu plików (różnice odfiltrowane
przez filtry liniowe lub ustawienia białych znaków). Ten atrybut ma
znaczenie tylko w przypadku porównywanych plików tekstowych. Jest to
atrybut globalny (nie obsługuje przedrostków specyficznych dla strony).
Przykład: IgnoredDiffs > 0 aby wyświetlić pliki z
zignorowanymi różnicami, lub Differences = 0 and IgnoredDiffs >
0 aby pokazać pliki, które są identyczne, z wyjątkiem ignorowanych
różnic.
Unpacker
Zwraca nazwę wtyczki rozpakowującej użytej do porównania plików lub pusty
ciąg znaków, jeśli nie użyto żadnego programu rozpakowującego. Jest to
atrybut globalny (nie obsługuje przedrostków specyficznych dla strony).
Przykład: Unpacker = "CompareMSExcelFiles" aby wyświetlić
pliki porównane za pomocą narzędzia do rozpakowywania programu Excel, lub
Unpacker != "" aby wyświetlić wszystkie pliki, w których
użyto narzędzia rozpakowującego.
Prediffer
Zwraca nazwę wtyczki prediffera użytej do porównania plików lub pusty ciąg
znaków, jeśli nie użyto prediffera. Jest to atrybut globalny (nie obsługuje
przedrostków specyficznych dla strony). Przykład: Prediffer =
"IgnoreColumns" aby wyświetlić pliki porównane przy użyciu
predyferentu IgnoreColumns, lub Prediffer != "" aby
wyświetlić wszystkie pliki, w których użyto preróżnicy.
EOLZwraca styl końca linii (EOL) jako wartość całkowitą. W przypadku plików zwraca dominujący styl EOL; w przypadku linii zwraca styl EOL tej konkretnej linii.
Wartości: 0 = Brak, 1 = LF (Unix), 2 = CR (Mac), 3 = CRLF (Windows), 4 = Mieszane (wiele stylów EOL w pliku)
EOLStrZwraca styl końca linii (EOL) jako ciąg znaków. W przypadku plików zwraca dominujący styl EOL; w przypadku linii zwraca styl EOL tej konkretnej linii.
Wartości: „Brak”, „LF”, „CR”, „CRLF”, „Mieszane”
Codepage
Zwraca stronę kodową pliku (kodowanie znaków) jako wartość całkowitą. Ten
atrybut obsługuje przedrostki specyficzne dla strony
(np. LeftCodepage, RightCodepage).
Przykład: Codepage = 65001 aby wyświetlić pliki UTF-8 lub
allof(Codepage = 65001) aby wyświetlić pliki w formacie
UTF-8 ze wszystkich stron.
HasBOM
Powroty true jeśli plik ma znacznik kolejności bajtów
(BOM), false inaczej. Ten atrybut obsługuje przedrostki
specyficzne dla strony (np. LeftHasBOM,
RightHasBOM). Przykład: HasBOM aby
wyświetlić pliki z BOM, lub not HasBOM aby wyświetlić
pliki bez BOM.
Atrybuty bez bocznego przedrostka (np. Size) zwraca
tablicę wartości ze wszystkich dostępnych stron (lewa, środkowa,
prawa). Podczas stosowania operatora do takich tablic zachowanie różni się w
zależności od tego, czy porównanie dotyczy tablicy skalarnej, czy innej.
Podczas porównywania tablicy ze skalarem operacja jest wykonywana
indywidualnie dla każdego elementu tablicy. Wynikiem tego jest tablica
logiczna. Jeśli jakikolwiek element w tej tablicy logicznej to
true, ogólne wyrażenie ma wartość
true. W przeciwnym razie ocenia się
false.
Podczas porównywania dwóch tablic zachowanie zależy od operatora:
Dla = i !=: Tablice muszą mieć tę samą
długość. Wynikiem jest pojedyncza wartość logiczna, a nie tablica.
= powraca true tylko wtedy, gdy
wszystkie elementy są równe. != powraca
true jeśli jakikolwiek element się różni.
W przypadku wszystkich innych operatorów (np. >,
<): operacja jest stosowana elementarnie, tworząc
tablicę boolowską. Ostatecznym wynikiem wyrażenia jest
true jeśli jakikolwiek element w tablicy logicznej jest
true, i false jeśli wszystkie elementy
są false.
Example 8. Przykłady
[2, 4] = [2, 4] -> prawda
[2, 4] != [2, 5] -> prawda (ponieważ 4 != 5)
[3, 5, 8] > [6, 4, 2]
-> [fałsz, prawda, prawda]
-> prawda (ponieważ przynajmniej jedno porównanie jest prawdziwe)
Porównania tablicowe i skalarne dają tablicę boolowską. Ogólny wynik
wyrażenia to true jeśli przynajmniej jeden element jest
true.
Tablica vs tablica z = lub != zwraca
pojedynczą wartość logiczną.
Tablica vs tablica z innymi operatorami tworzy tablicę boolowską.
Ostateczny wynik jest true jeśli jakikolwiek element jest
true.
Domyślnie wszystkie operatory porównania ciągów (takie jak
=, !=, <,
<=, >, >=,
like, matches,
contains, i recontains) nie
uwzględniają wielkości liter. Możesz kontrolować to zachowanie za pomocą
dyrektyw (patrz Dyrektywy dotyczące uwzględniania przypadków).
<, <=, >,
>=Porównanie numeryczne, sygnatury czasowej lub ciągów
=Porównanie równości
!=Porównanie nierówności
+, -, *,
/, %
Operatory arytmetyczne. + i - wykonaj
dodawanie i odejmowanie. * i /
wykonywać mnożenie i dzielenie. % jest operatorem modulo
(reszta).
and, or, notOperatory logiczne
likeDopasowanie ciągu znaków wieloznacznych
Możesz także użyć not like aby wykonać odwrotne
dopasowanie.
matchesPasuje do wyrażeń regularnych
Możesz także użyć not matches aby wykonać odwrotne
dopasowanie.
containsSprawdza, czy ciąg zawiera podciąg
Możesz także użyć not contains aby sprawdzić brak
podciągu.
recontainsSprawdza, czy dowolny podciąg pasuje do wyrażenia regularnego
Możesz także użyć not recontains aby upewnić się, że nie
ma dopasowania.
Wyrażenia filtrujące obsługują różne funkcje służące do manipulowania i analizowania danych. Funkcje są uporządkowane według kategorii, aby ułatwić korzystanie z nich.
strlen(source)Zwraca długość ciągu jako Integer. Jeśli
source jest tablicą ciągów, wynikiem jest tablica
liczb całkowitych. Przykład: strlen(Name)
strCount(str,
substr)
Liczy, ile razy podciąg substr pojawia się w
str. Domyślnie w wyszukiwaniu nie jest
uwzględniana wielkość liter (respects
@cs/@ci dyrektywy). Jeśli
str jest tablicą, wynikiem jest tablica liczb
całkowitych zawierająca liczniki dla każdego elementu. Nakładające się
dopasowania są liczone osobno (np. strCount("aaaa", "aa")
zwraca 2).
Przykłady:
strCount("hello hello world", "hello") zwraca 2
strCount("Test TEST test", "test") zwraca 3 (wielkość
liter nie ma znaczenia)
@cs strCount("Test TEST test", "test") zwraca 1 (wielkość
liter ma znaczenie)
le:strCount(Line, "ERROR") > 2 pokazuje linie zawierające
„ERROR” więcej niż dwa razy
regexCount(str,
pattern)
Liczy, ile razy wyrażenie regularne pattern
pasuje do str. Domyślnie w wyszukiwaniu nie jest
uwzględniana wielkość liter (respects
@cs/@ci dyrektywy). Jeśli
str jest tablicą, wynikiem jest tablica liczb
całkowitych zawierająca liczniki dla każdego elementu. Dopasowania o
zerowej długości są obsługiwane z wdziękiem, aby uniknąć nieskończonych
pętli.
Przykłady:
regexCount("test123abc456", "\d+") zwraca 2
regexCount("AAA BBB CCC", "[A-Z]+") zwraca 3
@cs regexCount("Test TEST", "TEST") zwraca 1
le:regexCount(Line, "\b(error|warning)\b") > 0 pokazuje
linie zawierające słowa kluczowe zawierające błędy lub ostrzeżenia
strFind(str,
substr[, occurrence])
Znajduje pozycję (w oparciu o 0) N-tego wystąpienia podciągu
substr w str.
Opcjonalne occurrence parametr określa, które
wystąpienie ma zostać znalezione (na podstawie 0, domyślnie jest to 0 dla
pierwszego wystąpienia). Domyślnie w wyszukiwaniu nie jest uwzględniana
wielkość liter (respects @cs/@ci
dyrektywy). Powroty none jeśli podciąg nie zostanie
znaleziony lub jeśli indeks wystąpienia jest poza zakresem. Jeśli
str jest tablicą, wynikiem jest tablica pozycji
(lub brak wartości).
Przykłady:
strFind("hello world", "o") zwraca 4 (pierwsze „o”)
strFind("hello world", "o", 1) zwraca 7 (drugie „o”)
@cs strFind("Test TEST test", "test") zwraca 10 (wielkość
liter ma znaczenie)
strFind(array("abc", "def"), "b") powraca
array(1, none)
regexFind(str,
pattern[, group[,
occurrence]])
Znajduje pozycję (od 0) N-tego wystąpienia dopasowania wyrażenia regularnego
w str. Opcjonalne
group parametr określa, którą grupę
przechwytywania należy zlokalizować (na podstawie 0, wartość domyślna to 0
dla całego dopasowania). Opcjonalne occurrence
parametr określa, które wystąpienie wzorca ma zostać znalezione (na
podstawie 0, domyślnie jest to 0 dla pierwszego wystąpienia). Domyślnie w
wyszukiwaniu nie jest uwzględniana wielkość liter (respects
@cs/@ci dyrektywy). Powroty
none jeśli wzorzec nie pasuje, indeks grupy jest poza
zakresem lub indeks wystąpienia jest poza zakresem. Jeśli
str jest tablicą, wynikiem jest tablica pozycji
(lub brak wartości).
Przykłady:
regexFind("test123abc456", "\d+") zwraca 4 (pozycja
„123”)
regexFind("test123abc456", "\d+", 0, 1) zwraca 10
(pozycja „456”, drugie dopasowanie)
regexFind("abc-def-ghi", "([a-z]+)-([a-z]+)", 1) zwraca 0
(pozycja pierwszej grupy przechwytywania „abc”)
regexFind("v1.0 and v2.5", "v(\d+)\.(\d+)", 1, 1) zwraca
10 (wersja główna „2” w drugim wystąpieniu)
regexFind(array("test123", "abc"), "\d+") powraca
array(4, none)
substr(source,
start, count)Zwraca określony zakres tekstu z ciąg lub tablica
ciągów jako String. Jeśli
source jest tablicą ciągów, wynikiem jest tablica
ciągów. Przykład: substr(Name, 0, 3)
replace(str, od, do)
Zastępuje wszystkie wystąpienia ciągu from z
to. Jeśli str jest
tablicą, wynikiem jest tablica ciągów znaków z zastosowanymi zamianami.
Przykład: replace(name, ".bak", ".txt")
regexReplace(str, wzór, zamiana)
Zastępuje wszystkie dopasowania wzorca wyrażenia regularnego ciągiem
zastępczym. Obsługuje odniesienia wsteczne (1 $, 2 $ itp.) w ciągu
zastępczym. Jeśli str jest tablicą, wynikiem
jest tablica ciągów znaków z zastosowanymi zamianami. Przykład:
regexReplace(name, "^(\w+)_(\w+)$", "$2_$1") zamienia
słowa oddzielone podkreśleniem.
replaceWithList(str, ścieżka pliku)
Zastępuje wiele ciągów znaków w str przy użyciu
reguł zastępowania załadowanych z pliku rozdzielonego tabulatorami. Format
pliku to jedna reguła zastępowania w każdym wierszu:
search_string<TAB>replacement_string. Linie
zaczynające się od # są traktowane jako komentarze i
ignorowane. Puste linie są również ignorowane. Jeśli
str jest tablicą, wynikiem jest tablica ciągów
znaków z zastosowanymi zamianami.
Przykład formatu pliku:
# Linia komentarza jabłko, pomarańcza kot pies stary nowy
Przykłady:
replaceWithList(Name, "C:\Filters\replacements.txt") -
stosuje zamianę z pliku na nazwę pliku
regexReplaceWithList(str, ścieżka pliku)
Zastępuje ciągi znaków str przy użyciu wzorców
wyrażeń regularnych załadowanych z pliku rozdzielonego tabulatorami. Format
pliku to jeden wzór w linii:
regex_pattern<TAB>replacement_string. Łańcuch
zastępczy może zawierać odniesienia wsteczne (1 $, 2 $ itp.) do
przechwyconych grup. Linie zaczynające się od # są
traktowane jako komentarze i ignorowane. Puste linie są również
ignorowane. Jeśli str jest tablicą, wynikiem
jest tablica ciągów znaków z zastosowanymi zamianami.
Przykład formatu pliku:
# Linia komentarza
\d+ LICZBA
(\d{4})-(\d{2})-(\d{2}) 1_$2_3$
Przykłady:
regexReplaceWithList(Name,
"C:\Filters\regex_replacements.txt") - stosuje zamianę wyrażeń
regularnych do nazwy pliku
regexExtract(str,
pattern[, group[,
offset]])
Przechwytuje tekst pasujący do wzorca wyrażenia regularnego z ciągu.
Opcjonalne group parametr określa, która grupa
przechwytywania ma zostać wyodrębniona (na podstawie 0). Grupa 0 (domyślna)
zwraca całe dopasowanie; grupy 1, 2 itd. zwracają odpowiednie grupy
przechwytywania zdefiniowane w nawiasach we wzorcu. Opcjonalne
offset parametr określa, które wystąpienie wzorca
ma zostać przechwycone (w oparciu o 0). Offset 0 (domyślnie) zwraca
pierwsze dopasowanie; offset 1 zwraca drugie dopasowanie itp. Jest to
przydatne do przechwytywania N-tego wystąpienia w linii, na przykład drugiej
liczby w ciągu. Powroty none jeśli wzorzec nie pasuje,
indeks grupy jest poza zakresem lub przesunięcie przekracza liczbę
dopasowań. Jeśli str jest tablicą, wynikiem jest
tablica z przechwyceniami dla każdego elementu. Domyślnie w wyszukiwaniu
nie jest uwzględniana wielkość liter (respects
@cs/@ci dyrektywy).
Przykłady:
regexExtract("abc123", "[a-z]+\d+") powraca
"abc123" (cały mecz)
regexExtract("abc123", "([a-z]+)(\d+)", 1) powraca
"abc" (pierwsza grupa przechwytująca)
regexExtract("abc123", "([a-z]+)(\d+)", 2) powraca
"123" (druga grupa przechwytująca)
regexExtract("2025-05-16", "(\d{4})-(\d{2})-(\d{2})", 1)
powraca "2025"
regexExtract("user@example.com", "([^@]+)@([^@]+)", 1)
powraca "user"
regexExtract("user@example.com", "([^@]+)@([^@]+)", 2)
powraca "example.com"
regexExtract("value 123 and value 456", "(\d+)", 0, 0)
powraca "123" (pierwsza liczba)
regexExtract("value 123 and value 456", "(\d+)", 0, 1)
powraca "456" (drugi numer)
regexExtract("v1.0.0 and v2.0.0", "v(\d+)\.(\d+)\.(\d+)", 1,
1) powraca "2" (główna wersja drugiego
wystąpienia)
regexExtract("test", "\d+") powraca
none (brak dopasowania)
regexExtract("abc", "([a-z])", 5) powraca
none (grupa poza zasięgiem)
regexExtract(array("abc123", "def456"), "([a-z]+)(\d+)",
1) powraca array("abc", "def")
@cs regexExtract("ABC123", "([a-z]+)", 1) powraca
none (wielkość liter ma znaczenie, brak dopasowania)
le:regexExtract(Line, "error:\s+(\w+)", 1) wyodrębnia typ
błędu z linii dziennika
fe:regexExtract(Name, "v(\d+)\.(\d+)\.(\d+)", 1) = "2"
filtruje pliki w wersji głównej 2
normalizeUnicode(str[, formularz])
Normalizuje ciąg Unicode. Opcjonalny parametr formularza określa formę
normalizacji: „NFC” lub „C” (domyślnie), „NFD” lub „D”, „NFKC” lub „KC”,
„NFKD” lub „KD”. Można także używać form numerycznych: 1=NFC, 2=NFD,
5=NFKC, 6=NFKD. Jeśli str jest tablicą, wynikiem
jest tablica znormalizowanych ciągów. Przykład:
normalizeUnicode(name, "NFC")
toLower(str)
Konwertuje wszystkie znaki w ciągu na małe litery. Jeśli
str jest tablicą, wynikiem jest tablica ciągów
znaków zawierających małe litery. Przykład: toLower("Hello
World") powraca "hello world"
toUpper(str)
Konwertuje wszystkie znaki w ciągu na wielkie litery. Jeśli
str jest tablicą, wynikiem jest tablica ciągów
zawierających wielkie litery. Przykład: toUpper("Hello
World") powraca "HELLO WORLD"
toHalfWidth(str)
Konwertuje znaki o pełnej szerokości na znaki o połowie szerokości. Używany
głównie do konwersji znaków alfanumerycznych i katakana o pełnej szerokości
na znaki o połowie szerokości. Jeśli str jest
tablicą, wynikiem jest tablica przekonwertowanych ciągów.
toFullWidth(str)
Konwertuje znaki o połowie szerokości na znaki o pełnej szerokości. Używany
głównie do konwersji znaków alfanumerycznych i katakana o połowie szerokości
na znaki o pełnej szerokości. Jeśli str jest
tablicą, wynikiem jest tablica przekonwertowanych ciągów.
toKatakana(str)
Konwertuje znaki hiragany na katakanę. Znaki inne niż hiragana pozostają
niezmienione. Jeśli str jest tablicą, wynikiem
jest tablica przekonwertowanych ciągów.
toHiragana(str)
Konwertuje znaki katakana na hiragana. Znaki inne niż katakana pozostają
niezmienione. Jeśli str jest tablicą, wynikiem
jest tablica przekonwertowanych ciągów.
toSimplifiedChinese(str)
Konwertuje tradycyjne chińskie znaki na uproszczone znaki chińskie. Znaki,
które nie mają uproszczonej formy, pozostają niezmienione. Jeśli
str jest tablicą, wynikiem jest tablica
przekonwertowanych ciągów.
toTraditionalChinese(str)
Konwertuje uproszczone znaki chińskie na tradycyjne znaki chińskie.
Postacie nie posiadające tradycyjnej formy pozostają niezmienione. Jeśli
str jest tablicą, wynikiem jest tablica
przekonwertowanych ciągów.
trim(str)
Usuwa początkowe i końcowe białe znaki (spacja, tabulator, znak nowej linii,
powrót karetki) z ciągu. Jeśli str jest tablicą,
wynikiem jest tablica przyciętych ciągów.
Przykłady:
trim(" hello ") powraca "hello"
trim(array(" test ", " data ")) powraca
array("test", "data")
trimLeft(str)
Usuwa wiodące białe znaki (spacja, tabulator, nowa linia, powrót karetki) z
początku ciągu. Końcowe białe znaki są zachowywane. Jeśli
str jest tablicą, wynikiem jest tablica ciągów
obciętych do lewej strony.
Przykłady:
trimLeft(" hello ") powraca "hello "
trimRight(str)
Usuwa końcowe białe znaki (spacja, tabulator, nowa linia, powrót karetki) z
końca ciągu. Wiodące białe znaki zostają zachowane. Jeśli
str jest tablicą, wynikiem jest tablica ciągów
obciętych do prawej strony.
Przykłady:
trimRight(" hello ") powraca " hello"
lineCount(content)Zwraca liczbę wierszy zawartości pliku lub tablicy zawartości pliku jako
Integer. Jeśli content jest
tablicą, wynikiem jest tablica liczb całkowitych. Przykład:
lineCount(Content)
sublines(content,
start, count)
Wyodrębnia określoną liczbę wierszy, zaczynając od podanego indeksu wiersza
w treści pliku lub tablicy zawartości pliku i zwraca je jako pojedynczy
połączony ciąg znaków. Jeśli content jest
tablicą, wynikiem jest tablica ciągów.
toNumber(str),
toInt(str),
toDouble(str)Konwertuj ciąg na liczbę. toNumber zwraca liczbę
całkowitą lub zmiennoprzecinkową w zależności od formatu wejściowego;
toInt zwraca tylko liczby całkowite;
toDouble zwraca tylko liczby zmiennoprzecinkowe.
Przecinki na wejściu są ignorowane. Powroty nonew
przypadku niepowodzenia analizy. Przykład:
le:toInt(Column("Count")) > 100
toDateTime(str)
Konwertuje ciąg na wartość znacznika czasu. Obsługuje wiele formatów
daty/godziny. Powroty nonejeśli nie można przeanalizować
ciągu. Przykład: toDateTime("2025-01-15") > today()
now()Zwraca bieżącą datę i godzinę w postaci a Timestamp
wartość.
today()Zwraca dzisiejszą datę jako a Timestamp wartość
reprezentująca 00:00:00.000 na początku dnia.
startOfWeek(timestamp)Zwraca pierwszy dzień tygodnia, którym zawsze jest niedziela, niezależnie od ustawień regionalnych.
startOfMonth(timestamp)Zwraca pierwszy dzień miesiąca.
startOfYear(timestamp)Zwraca pierwszy dzień roku.
toDateStr(timestamp)Konwertuje podany znacznik czasu na ciąg daty yyyy-MM-dd
formatować. Jeśli timestamp jest tablicą
znaczników czasu, wynikiem jest tablica ciągów.
abs(value)Zwraca wartość bezwzględną liczba całkowita lub tablica liczb
całkowitych. Jeśli value jest tablicą
liczb całkowitych, wynikiem jest tablica liczb całkowitych.
isWithin(value,
min, max)
Powroty true jeśli value jest
w zasięgu [min, max] (włącznie na obu końcach).
Obsługuje liczby całkowite, liczby zmiennoprzecinkowe, znaczniki czasu i
ciągi znaków (porównanie bez uwzględniania wielkości liter). Jeśli
value jest tablicą, wynikiem jest tablica
logiczna, w której każdy element jest sprawdzany indywidualnie.
Przykłady:
isWithin(5, 1, 10) powraca true
isWithin(Size, 1KB, 10MB) sprawdza, czy rozmiar pliku
mieści się w przedziale od 1 KB do 10 MB
isWithin(Date, today() - 7days, today()) sprawdza, czy
plik został zmodyfikowany w ciągu ostatniego tygodnia
allof(isWithin(Size, 1KB, 10MB)) sprawdza, czy wszystkie
rozmiary plików mieszczą się w przedziale od 1 KB do 10 MB
inRange(value,
min, max)
Powroty true jeśli value jest
w zasięgu [min, max) (włącznie w dolnej granicy,
wyłącznie w górnej granicy). Obsługuje liczby całkowite, liczby
zmiennoprzecinkowe, znaczniki czasu i ciągi znaków (porównanie bez
uwzględniania wielkości liter). Jeśli value jest
tablicą, wynikiem jest tablica logiczna, w której każdy element jest
sprawdzany indywidualnie.
Przykłady:
inRange(5, 1, 10) powraca true
inRange(10, 1, 10) powraca false
inRange(Size, 0, 1MB) sprawdza, czy rozmiar pliku jest
mniejszy niż 1 MB
anyof(inRange(Date, startOfMonth(today()), today()))
sprawdza, czy jakiś plik został zmodyfikowany w tym miesiącu (z wyjątkiem
dzisiejszego)
array(value1,
value2, ...)Tworzy tablicę na podstawie podanych wartości. Przykład: array(1,
2, 3)
at(array,
index)Zwraca element o określonym indeksie (opartym na 0). Wskaźniki ujemne liczą
się od końca. Przykład: at(array(1, 2, 3), -1) zwraca 3
anyof(booleans)Powroty true jeśli jakikolwiek element w
tablica logiczna spełnia warunek.
allof(booleans)Powroty true jeśli wszystkie elementy w tablica
logiczna spełnić warunek.
allequal(array)Powroty true jeśli wszystkie wartości w tablicy są równe.
len(value)Zwraca długość wartości jako Integer.
Zachowanie:
Tablica: Zwraca liczbę elementów w tablicy
Sznurek: Zwraca liczbę znaków UTF-8
Brak (monostanowy): Zwraca 0
Inne wartości skalarne (Liczba całkowita, rzeczywista, logiczna, znacznik czasu itp.): Zwraca 1
Przykłady:
len(array(1, 2, 3)) - zwraca 3
len("hello") - zwraca 5
len(123) - zwraca 1
len(Size) - zwraca liczbę boków (2 lub 3) w porównaniu
folderów
if(condition,
trueValue, falseValue)
Powroty trueValue jeśli
condition zwraca wartość true, w przeciwnym razie
zwraca falseValue. Funkcja ta dokonuje oceny
zwarcia (ocenia tylko gałąź, która zostanie zwrócona).
Przykłady:
if(Size > 1MB, "large", "small") - zwraca „duży” lub
„mały” w zależności od rozmiaru pliku
if(Extension = "txt", "text file", "other file") -
klasyfikuje pliki według rozszerzenia
if(Exists, Size, 0) - zwraca rozmiar pliku lub 0, jeśli
plik nie istnieje
ifEach(conditionArray,
trueValue, falseValue)
Wybór warunkowy oparty na elementach. Dla każdego elementu w
conditionArray, zwraca odpowiedni element z
trueValue jeśli warunek jest spełniony, w
przeciwnym razie zwraca odpowiedni element z
falseValue. Jeśli
trueValue lub
falseValue jest skalarem, jest transmitowany do
wszystkich elementów.
Przykłady:
ifEach(Size > 1MB, "large", "small") - zwraca tablicę
„dużych”/„małych” etykiet dla każdego pliku
ifEach(array(true, false, true), array("a", "b", "c"), array("x",
"y", "z")) - powraca array("a", "y", "c")
anyof(ifEach(Size > 100KB, Size < 10MB, false)) -
sprawdza, czy dowolny plik ma rozmiar pomiędzy 100 KB a 10 MB
choose(index,
value0, value1, ...)
Wybiera wartość spośród argumentów, na podstawie których
index. Jeśli index
wynosi 0, zwraca value0; jeśli 1, zwraca
value1itp. Indeksy ujemne są ograniczane do
0. Indeksy poza ostatnią wartością zwracają ostatnią wartość.
Przykłady:
choose(0, "first", "second", "third") - zwraca „pierwszy”
choose(DiffCode % 3, "equal", "different", "unique") -
mapuje kody różnicowe na etykiety
choose(5, "a", "b", "c") - zwraca „c” (poza zakresem,
zwraca ostatnią wartość)
chooseEach(indexArray,
value0, value1, ...)
Wybór wartości według elementu. Dla każdego indeksu w
indexArray, wybiera odpowiednią wartość spośród
pozostałych argumentów. Jeśli indexArray jest
skalarem, zachowuje się jak choose.
Przykłady:
chooseEach(array(0, 1, 2), "a", "b", "c") - powraca
array("a", "b", "c")
chooseEach(array(0, 0, 1), "x", "y") - powraca
array("x", "x", "y")
chooseEach(array(2, 0, 1), "first", "second", "third") -
powraca array("third", "first", "second")
andEach(value1,
value2),
orEach(value1,
value2),
notEach(value)Operacje logiczne na elementach. Funkcje te działają na wartościach boolowskich, tablicach boolowskich lub kombinacji obu:
andEach - Operacja logiczna AND
orEach - Operacja logiczna OR
notEach - Operacja logiczna NOT (pojedynczy argument)
Gdy argumenty są skalarami, zwraca skalarny wynik logiczny. Gdy jeden argument jest tablicą, a drugi skalarem, skalar jest rozgłaszany do wszystkich elementów. Gdy oba argumenty są tablicami, wykonuje operację na elementach.
Przykłady:
andEach(Size > 1KB, Size < 1MB) - pliki o wielkości
od 1KB do 1MB
orEach(Extension = "txt", Extension = "log") - txt lub
pliki dziennika
notEach(Exists) - pliki, które nie istnieją
allof(andEach(Exists, Size > 0)) - wszystkie pliki
istnieją w rozmiarze niezerowym
anyof(notEach(Size > 1MB)) - dowolny plik o rozmiarze
1MB lub mniejszym
logError(value1,
value2, ...),
logWarn(value1,
value2, ...),
logInfo(value1,
value2, ...)Wysyła do dziennika połączoną reprezentację ciągów wszystkich argumentów (odpowiednio na poziomie błędu, ostrzeżenia lub informacji), oddzieloną spacjami i zwraca wartość ostatniego argumentu. Funkcje te są przydatne do debugowania wyrażeń filtrujących.
Przykłady (przy użyciu wartości zwracanej):
logInfo("File size:", Size) > 1MB - rejestruje rozmiar
pliku i sprawdza, czy jest większy niż 1MB
logWarn("Processing:", Name) like "*.tmp" - rejestruje
nazwy plików i sprawdza, czy jest to plik tymczasowy
Size > 1KB and logInfo("Large file:", Name) contains
"test" - rejestruje tylko wtedy, gdy warunek rozmiaru jest
prawdziwy, następnie sprawdza nazwę
Rozmiary plików obsługują następujące przyrostki:
KB, MB, GB, gruźlicaCzasy trwania obsługują następujące przyrostki:
tygodnie, tydzień, w, dni, dzień, d, godziny, godzina, godz, godz, minuty, minuta, min, m, sekundy, drugi, sek, s, milisekundy, milisekunda, msek, paniSize < 10KB - Rozmiar dowolnej strony jest mniejszy
niż 10 KB
LeftSize >= 10MB - Plik po lewej stronie ma rozmiar co
najmniej 10 MB
allof(Size < 1MB) - Wszystkie strony mają mniej niż
1MB
abs(LeftSize - RightSize) < 1KB - Różnica w wielkości
jest niewielka
DateStr = "2025-07-20" - Plik był ostatnio modyfikowany w
tym dniu
Date >= today() - Zmodyfikowano dzisiaj lub później
Date > d"2026-05-21 07:16:33" - Zmodyfikowano po
określonej dacie i godzinie
isWithin(Date, d"2026-01-01", d"2026-12-31 23:59:59") -
Zmodyfikowano w roku 2026
isWithin(Date, today() - 7days, today()) - Plik
zmodyfikowano w ciągu ostatniego tygodnia
inRange(Size, 1KB, 10MB) - Rozmiar pliku wynosi od 1 KB
(włącznie) do 10 MB (wyłącznie)
allof(isWithin(Size, 100KB, 1MB)) - Wszystkie rozmiary
plików mieszczą się w przedziale od 100 KB do 1 MB
AttrStr contains "R" - Plik jest tylko do odczytu
Name matches "file[0-9]\.txt" - Regex na nazwie pliku
Content contains "Test" - Zawartość pliku zawiera słowo
kluczowe
sublines(Content, 0, 1) contains "XML" - Pierwsza linia
zawiera „XML”
strCount(Content, "TODO") > 5 - Plik zawiera więcej
niż 5 komentarzy do zrobienia
regexCount(Content, "\bFIXME\b") > 0 - Plik zawiera co
najmniej jeden znacznik FIXME
strFind(Name, "_test") != none - Pliki zawierające w
nazwie „_test”.
strFind(Name, ".", 1) > 0 - Pliki z wieloma kropkami w
nazwie (istnieje druga kropka)
regexFind(Name, "\d{4}") < 5 - Pliki, w których w
ciągu pierwszych 5 znaków występuje 4-cyfrowa liczba
regexExtract(Name, "v(\d+)\.(\d+)\.(\d+)", 1) = "2" -
Pliki z wersją główną 2 (np. „v2.16.48”)
regexExtract(Name, "([^_]+)_([^_]+)\.txt", 2) like
"test*" - Pliki, w których druga część nazwy zaczyna się od „test”
le:regexExtract(Line, "(\d+)", 0, 1) - Wyodrębnia drugą
liczbę w każdej linii (offset=1)
(Extension = "log" and Size > 10MB) or (Date < today() -
7days) - Duże pliki dziennika lub pliki starsze niż tydzień
AttrStr not contains "H" and Name like "*.tmp" -
Nieukryte pliki tymczasowe
isWithin(Extension, "a", "m") and inRange(Size, 0, 1MB) -
Pliki z rozszerzeniami od „a” do „m” i wielkości mniejszej niż 1MB
toLower(Name) = "readme.txt" - Dopasowywanie nazw plików
bez uwzględniania wielkości liter
toHalfWidth(Name) like "*.txt" - Dopasuj po konwersji
pełnej szerokości na połowę szerokości
trim(Name) = "readme.txt" - Dopasuj nazwę pliku po
usunięciu początkowych/końcowych białych znaków
trimLeft(Column("Value")) = "123" - Dopasuj wartość
kolumny po usunięciu wiodących białych znaków (tryb tabeli)
trimRight(Line) contains "end" - Sprawdź, czy linia (bez
końcowych białych znaków) zawiera „koniec”
EOL = 3 - Pliki z końcówkami linii CRLF (Windows).
EOLStr = "LF" - Pliki z końcówkami linii LF (Unix).
allof(EOL = 1) - Sprawdza, czy wszystkie porównywane
pliki korzystają z końcówek linii LF
leftprop("System.Title") != none - Lewy plik ma ustawioną
właściwość tytułu
prop("System.Author") = none - Żadna właściwość autora
nie jest ustawiona po żadnej stronie
if(LeftExists, LeftSize, 0) == 0 - Sprawdza, czy brakuje
lewego pliku lub czy jest on pusty
Different - Pokaż tylko różne pliki/foldery (tylko filtr
wyświetlania)
Identical - Pokaż tylko identyczne pliki/foldery (tylko
filtr wyświetlania)
allof(Binary) - Pokaż tylko pliki binarne ze wszystkich
stron (tylko filtr wyświetlania)
DifferentLeftMiddle and not DifferentMiddleRight - W
porównaniu trójstronnym pokaż pliki, w których różni się tylko para
lewa-środkowa (tylko filtr wyświetlania)
Filtry plików to pliki tekstowe z rozszerzeniem
flt. Umożliwiają zastosowanie wielu reguł filtrowania
do porównania folderów. W przeciwieństwie do masek plików, filtry plików
mogą uwzględniać lub wykluczać dopasowania.
WinMerge instaluje wiele
predefiniowanych filtrów plików. Jeśli te filtry plików nie zapewniają
wymaganego filtrowania, możesz utworzyć własne. Aby ułatwić to zadanie,
WinMerge udostępnia również plik szablonu o nazwie
FileFilter.tmpl. W tej sekcji opisano sposób stosowania
filtrów plików do porównań i dokumentowano składnię filtrów plików. Korzystanie z okna dialogowego Filtry opisuje, jak dodawać, edytować i zarządzać
filtrami.
WinMerge automatycznie wykrywa filtry plików w następujących lokalizacjach:
W tym miejscu instalowane są predefiniowane filtry plików. Na przykład
C:\Program Files\WinMerge\Filters. Możesz tworzyć lub
kopiować pliki filtrów w tej lokalizacji, aby udostępnić je wszystkim
użytkownikom w systemie.
Przed utworzeniem nowego filtra plików sprawdź, czy predefiniowane filtry zawierają już to, czego potrzebujesz. Jeśli nie, przydatne przykłady reguł możesz znaleźć w istniejących plikach.
Lokalizacja tego folderu jest zdefiniowana na stronie System w opcjach
WinMerge. Domyślnie jest on określony jako podfolder w folderze profilu
użytkownika (na przykład Documents w Windowsie
10). Filtry utworzone lub skopiowane w tym miejscu są zwykle widoczne tylko
dla Ciebie. Jeśli utworzysz nowe filtry plików, możesz je tutaj skopiować,
aby zachować prywatność.
Zanim będzie można zastosować filtry plików istniejące w jakimkolwiek innym folderze, należy je najpierw zainstalować.
Filtr plików można zastosować dowolną z następujących metod:
Po uruchomieniu porównywania folderów w oknie dialogowym Wybierz pliki lub foldery:
Po wybraniu 1 i 2 foldery, kliknij obok Filtruj pole.
W oknie dialogowym Filtry użyj karty Filtry plików, aby wybrać filtr plików i załadować go do pliku Filtruj pole.
Jeśli filtr plików jest aktualnie włączony, wybrany filtr plików jest już załadowany w pliku Filtruj pole.
Kontynuuj operację porównywania. Plik w Filtruj pole jest stosowane w momencie rozpoczęcia operacji.
Aby zmienić filtrowanie plików po uruchomieniu operacji porównywania folderów (na przykład zastosowaniu innego filtra lub wyłączeniu filtrowania):
Kliknij → .
W oknie dialogowym Filtry skonfiguruj nowe ustawienie filtra plików i kliknij .
Nowe filtrowanie nie zostanie automatycznie zastosowane po zamknięciu okna dialogowego Filtry: naciśnij F5 , aby zobaczyć nowe wyniki w oknie Porównanie folderów.
Po uruchomieniu porównywania folderów
z wiersza poleceń WinMerge użyj metody -f flaga określająca
filtr plików.
W tej sekcji opisano składnię filtrów plików WinMerge i podano wskazówki dotyczące ich pisania.
Ogranicznik komentarza to ##. Po ograniczniku komentarza
wszystkie znaki w wierszu są ignorowane. WinMerge ignoruje większość białych
znaków w regułach. Jednakże komentarz musi być zawsze poprzedzony co
najmniej jednym znakiem odstępu (spacją lub tabulatorem). Do użycia
## jako znaki w regule, pomiń przedrostek białych znaków.
Pierwsze dwie wymagane linie filtra plików to:
Nazwa filtra wyświetlana w oknie dialogowym Pliki
Typ filtrowania, który ma zostać zastosowany. Określ jedną z tych wartości:
Zawiera wszystko oprócz elementów pasujących do określonej reguły.
Wyklucza wszystko z wyjątkiem elementów pasujących do określonej reguły.
Kiedy wybierzesz metodę wykluczania, musisz także dodać d (katalog) reguła określająca podfoldery. Zwykle dobrym pomysłem jest określenie wszystkich podfolderów, w ten sposób:
d: \\*$ ## Podfoldery
Nie myl tych terminów. Pamiętaj, że w filtrach plików an zawierać reguła nie określa, co należy uwzględnić, określa co nie uwzględnić. Podobnie, wykluczyć nie określa, co należy wykluczyć, określa, czego nie należy wykluczać.
Następnie plik powinien zawierać jedną lub więcej reguł filtrowania. Możesz dodać dowolną liczbę reguł. W każdym wierszu musi znajdować się jedna reguła, a każda reguła musi znajdować się w całości w jednym wierszu (w regule nie są dozwolone żadne podziały wierszy). Reguła zaczyna się od oznaczenia typu, po którym następuje wyrażenie regularne lub wyrażenie filtrujące. Obsługiwane oznaczenia typów to:
regexpDopasuj nazwy plików za pomocą wyrażeń regularnych
regexpWyklucz pliki pasujące do wyrażenia regularnego (dostępne od 2.16.19)
regexpDopasuj nazwy folderów za pomocą wyrażenia regularnego
regexpWyklucz foldery pasujące do wyrażenia regularnego (dostępne od 2.16.19)
exprWyrażenie filtrujące dla plików (np. fe:Size < 1KB) (Dostępne od 2.16.49)
exprWyrażenie filtru wykluczające pliki (dostępne od 2.16.49)
exprWyrażenie filtra dla folderów (dostępne od 2.16.49)
exprWyrażenie filtru wykluczające foldery (dostępne od 2.16.49)
exprWyrażenie filtru stosowane zarówno do plików, jak i folderów (np. e:Nazwa typu „Common*.*”) (dostępne od 2.16.56)
exprWyrażenie filtru, aby wykluczyć zarówno pliki, jak i foldery (dostępne od 2.16.56)
Spośród wielu znaków specjalnych wyrażeń regularnych następujące są szczególnie ważne w regułach filtrowania plików:
Często wymagane do prawidłowego działania reguł.
Często wymagane do prawidłowego działania reguł. Na przykład:
\.c$ ## dopasowuje tylko nazwy plików z rozszerzeniem,c. \.c ## pasuje do dowolnego rozszerzenia rozpoczynającego się odc, jakcppicom.
Wymusza dopasowanie znaków specjalnych do normalnych znaków. Na przykład,
aby dopasować nazwę folderu, poprzedź ogranicznik ukośnika odwrotnego
folderu ukośnikiem odwrotnym (\\). Aby dopasować kropkę w
nazwie pliku, określ ukośnik odwrotny, po którym następuje kropka
(\.).
Do dopasowywania nazw plików nie są używane żadne znaki specjalne ani symbole wieloznaczne. Aby dopasować wszystkie nazwy plików określonego typu, po prostu pomiń nazwę pliku.
W regułach nie jest rozróżniana wielkość liter. Na przykład f:
\.bat$ mecze winmerge.bat i
compare.BAT.
Example 9. Przykłady reguł filtrowania plików
Kilka prostych reguł filtrowania plików:
f: \.cpp$ ## Dopasowanie*.cpppliki f: \.h$ ## Dopasowanie*.hpliki f: ^Mój ## meczMy*.*pliki f: Dlg\. ## Dopasuj*Dlg.*pliki d: \\test$ ## Dopasowanietestfoldery d: ^\\Buduj$ ## DopasujBuildfoldery d: Temp$ ## Dopasuj*Tempfoldery (np.FirstTemp) d: Src ## Dopasowanie*Src*foldery
Niektóre reguły z bardziej złożonymi wyrażeniami regularnymi:
f: ^\.#.*$ ##.#filename.versionpliki f: Dlg\.c(pp)?$ ##*Dlg.ci*Dlg.cpppliki f: ^I.*\.h$ ##I*.hpliki f: Srv[1-9]\.def$ ##*Srv1.defdo*Srv9.defpliki f: ^[h,k,m] ##h*.*,k*.*, im*.*pliki
Podczas porównywania plików możesz użyć filtrów linii, aby zignorować pojedyncze linie. Na przykład możesz użyć filtrów liniowych, aby zignorować komentarze lub określony typ wygenerowanego kodu, na przykład znaczniki czasu systemu kontroli wersji. Każdy filtr liniowy jest regułą i do porównania plików można zastosować dowolną liczbę filtrów liniowych.
Aby dowiedzieć się, jak dodawać, edytować i zarządzać filtrami, zobacz Korzystanie z okna dialogowego Filtry.
Filtry liniowe można zastosować dowolną z następujących metod:
Po uruchomieniu porównywania plików w oknie dialogowym Wybierz pliki lub foldery
Po wybraniu 1 i 2 pliki, kliknij obok Filtruj pole.
W oknie dialogowym Filtry użyj karty Filtry liniowe, aby włączyć filtry liniowe, których chcesz użyć (jeśli istnieją) lub sprawdzić, jakie filtry liniowe są aktualnie włączone.
The Filtruj pole nie wskazuje, jakie filtry liniowe są włączone.
Kontynuuj operację porównywania plików. Włączone filtry liniowe zostaną zastosowane po rozpoczęciu operacji.
Po uruchomieniu operacji porównywania plików (na przykład w celu zastosowania różnych filtrów lub wyłączenia filtrowania)
Kliknij → .
Otwórz kartę Filtry plików.
Zaznacz poszczególne filtry liniowe, które chcesz zastosować, i odznacz filtry, których nie chcesz stosować.
Możesz także dodawać, edytować i usuwać filtry z listy, korzystając z opcji , , i przyciski.
Aby włączyć filtrowanie linii, zaznacz opcję Włącz filtry liniowe. Aby wyłączyć filtrowanie linii, odznacz tę opcję.
Kliknij , aby zamknąć okno dialogowe Filtry plików.
Kliknij F5 , aby zastosować zmiany i odświeżyć okno Porównywanie plików.
Filtr liniowy to reguła, która jest oceniana na podstawie każdej pojedynczej różnicy w porównywanych plikach, jeśli reguły filtru liniowego są włączone. Gdy reguła pasuje do różnicy jednowierszowej, różnica ta jest ignorowana.
Zignorowane różnice są zaznaczane w oknie Porównania plików za pomocą Ignorowana różnica kolor (zgodnie z definicją na stronie Kolory w Opcjach WinMerge). Umożliwia to odróżnienie ignorowanych różnic od innych typów. Nie można jednak wybrać ani scalić zignorowanych różnic.
Dopasowanie filtra liniowego można opisać dwoma pomysłami:
Gdy reguła pasuje do dowolnej części linii, cała różnica jest ignorowana. Dlatego nie można filtrować tylko części linii. Załóżmy na przykład, że dwa pliki mają następującą różnicę w jednej linii:
Plik1:
#Jean Sibelius
Plik2:
# Janne Sibelius
Bez filtrowania linia jest wykrywana jako różnica. Ale jeśli zastosujemy
regułę filtru liniowego z wyrażeniem, ^#, linie są raportowane
jako identyczne, ponieważ wyrażenie określa tylko pierwszy znak, który
pasuje w obu plikach.
Reguła jest stosowana do różnicy wieloliniowej tylko wtedy, gdy wszystkie linie są zgodne. Rozważmy na przykład tę dwuliniową różnicę:
Plik1:
#Jean Sibelius # Pekka Himanen
Plik2:
# Janne Sibelius Pekka Himanena
To samo ^# reguła pasuje do pierwszej linii, ale nie do drugiej
linii. Dlatego różnica nie jest ignorowana.
Zwykle dobrą praktyką jest używanie początku linii ( ^ ) i
koniec linii ( $ ) znaczniki umożliwiające precyzyjną kontrolę
wzorców, ponieważ reguła jest stosowana, jeśli jakakolwiek część linii
pasuje do wyrażenia.
Example 10. Filtry linii próbnej
^MYTAG$
Filtruje dokładnie pasujące linie MYTAG
^::
Filtruje linie zaczynające się od ::
^/\*.*\*/$
Filtruje linie zaczynające się od
i kończąc na /**/
^[1-5]00
Filtruje linie zaczynające się od liczb 100, 200, 300, 400 i 500
Example 11. Reguła filtrowania linii pasująca do linii identyfikatora CVS
Linie CVS Id wyglądają następująco:
// $Id: Filters.xml 7591 2013-01-20 15:47:42Z christianlist $
... i można je filtrować za pomocą tej reguły:
^// \WId: .*\$
Example 12. Filtruj komentarze dotyczące numerów linii w plikach po
komentarze do numerów linii po wyglądają następująco:
#: src/nazwa pliku.c:766
... i można je filtrować za pomocą tej reguły:
^#
Filtr linii wyświetlania kontroluje, które linie są widoczne w oknie Porównywanie plików. Linie niepasujące do filtra są ukrywane, ale nie ma to wpływu na sam wynik porównania.
Użyj dowolnej z poniższych metod, aby otworzyć pasek filtra wyświetlania:
Kliknij → lub naciśnij Ctrl+Przesunięcie+L.
Kliknij prawym przyciskiem myszy zaznaczony tekst w oknie Porównaj pliki i
wybierz → . WinMerge automatycznie
tworzy plik Line contains "..." wyrażenie z zaznaczonego
tekstu i otwiera pasek filtrów.
Aby usunąć filtr, wyczyść pole wprowadzania i naciśnij Wejdź. Aby ukryć pasek filtra, pozostawiając filtr aktywny, kliknij przycisk zamykania.
Pasek filtra wyświetlania akceptuje dane wejściowe w dwóch postaciach,
zależnych od tego, czy dane wejściowe zaczynają się od
le: przedrostek:
Wejście bez le: prefiks jest traktowany jako ciąg
znaków. WinMerge wyświetla tylko linie zawierające ten ciąg. Wewnętrznie
dane wejściowe są równoważne le:Line contains
".input"
Przykład: wejście TODO pokazuje wszystkie linie
zawierające tekst TODO.
le: przedrostek (wyrażenie filtrujące)Jeśli dane wejściowe zaczynają się od le:, reszta jest
interpretowana jako wyrażenie filtrujące. Pełna składnia wyrażeń opisana w
Składnia wyrażenia filtrującego jest dostępny.
Przykład: le:Different and Line contains "ERROR"
The le: prefiks musi pojawić się na samym początku
wejścia. Jeśli pojawi się gdziekolwiek indziej, całe dane wejściowe są
traktowane jako zwykły ciąg znaków.
Na przykład Hello or le:Line contains "Hello" robi
nie zawierają wyrażenie filtrujące. Całość danych
wejściowych jest traktowana jako dosłowne wyszukiwanie ciągu znaków
Hello or le:Line contains "Hello".
Wyrażenia filtrów linii wyświetlania korzystają z tego samego silnika, co wyrażenia filtrów porównywania folderów (zobacz Składnia wyrażenia filtru), z następującymi dodatkowymi atrybutami i funkcjami działającymi na poszczególnych liniach.
Atrybuty oznaczone jako obsługujące przedrostki specyficzne dla strony są
akceptowane Left, Middle, i
Right przedrostki (np. LeftLine,
RightLineLength). Atrybuty bez przedrostka są oceniane
we wszystkich okienkach.
LineTreść tekstowa bieżącego wiersza. Obsługuje prefiksy specyficzne dla
strony. Przykład: Line contains "TODO"
LineLengthDługość bieżącej linii w znakach. Obsługuje prefiksy specyficzne dla
strony. Przykład: LineLength > 120
LineNumberRzeczywisty numer linii w pliku (oparty na 1), nie licząc linii duchów.
Obsługuje prefiksy specyficzne dla strony. Przykład: LineNumber
<= 50
ViewLineNumberWyświetl numer linii, w tym linie widma (w oparciu o 1). Atrybut globalny
(bez bocznego przedrostka). Przykład: ViewLineNumber <=
100
DifferentPrawda, jeśli linia jest częścią bloku różnicowego. Atrybut globalny.
Przykład: Different
IdenticalPrawda, jeśli linia jest identyczna we wszystkich panelach. Atrybut globalny.
TrivialPrawda, jeśli linia różni się jedynie odstępami lub inną ignorowaną
treścią. Atrybut globalny. Przykład: Different or
Trivial
ExistsPrawda, jeśli linia istnieje w panelu (nie jest to linia widmo). Obsługuje
prefiksy specyficzne dla strony. Przykład: LeftExists and not
RightExists
MissingPrawda, jeśli linia jest linią widmową w okienku. Przeciwieństwo
Exists. Obsługuje prefiksy specyficzne dla strony.
MovedPrawda, jeśli linia zostanie wykryta jako linia przesunięta. Obsługuje prefiksy specyficzne dla strony.
BookmarkedPrawda, jeśli linia ma zakładkę. Obsługuje prefiksy specyficzne dla strony.
DifferentLeftMiddle,
DifferentMiddleRight,
DifferentLeftRightPrawda, jeśli wskazana para szyb różni się w tej linii. Tylko porównania
trójstronne (z wyjątkiem DifferentLeftRight który działa
również w trybie 2-kierunkowym). Atrybuty globalne. Przykład:
DifferentLeftMiddle and not DifferentMiddleRight
EOLStyl końca linii dla bieżącej linii jako wartość całkowita. Obsługuje
prefiksy specyficzne dla strony. Wartości: 0 = brak, 1 = LF, 2 = CR, 3 =
CRLF Przykład: le:EOL = 3 pokazuje tylko linie z
zakończeniami CRLF
EOLStrStyl końca linii dla bieżącej linii jako ciąg. Obsługuje prefiksy
specyficzne dla strony. Wartości: „Brak”, „LF”, „CR”, „CRLF” Przykład:
le:EOLStr = "LF" pokazuje tylko linie z zakończeniami LF
Column, ColumnCount (tylko tryb
tabeli)Zawartość komórek i liczba kolumn w trybie CSV/tabeli. Obsługa prefiksów
specyficznych dla strony. Przykład: Column("Status") =
"FAIL"
LineAt(lineNumber),
LineOffsetAt(offset)Tekst linii pod bezwzględnym numerem linii lub względnym przesunięciem od
bieżącej linii. Obsługuje funkcje prefiksów specyficzne dla strony.
Przykład: le:Different and RightLineOffsetAt(-1) matches
"^//"
Column(indexOrName),
ColumnRange(specification),
ColumnAt(line,
indexOrName),
ColumnOffsetAt(offset,
indexOrName) (tylko tryb tabeli)Zawartość komórki według indeksu lub nazwy, w linii bieżącej, bezwzględnej
lub względnej. Dla Column, ciąg liczbowy jest zawsze
traktowany jako nazwa kolumny. Argument numeryczny to indeks kolumny oparty
na 1. Użyj ColumnRange aby określić wiele kolumn i
zakresów, oddzielając je przecinkami N,
N-M, i N- przedmioty; białe znaki są
ignorowane, na przykład ColumnRange("1, 3, 5-10, 13-").
Poprzedź zakres znakiem ! aby to wykluczyć; na przykład
ColumnRange("!1") wyklucza kolumnę 1 i
ColumnRange("1-10,!4-5") wybiera kolumny 1-10 z wyjątkiem
kolumn 4-5. Jeśli nie określono zakresu uwzględnionego, wszystkie kolumny
zostaną uwzględnione przed zastosowaniem wykluczeń. Istniejące formy nazw i
formularze z pojedynczym indeksem zwracają jedną komórkę; formularze
zakresów zwracają wartości wybranych komórek połączone za pomocą
ogranicznika tabeli. Przykład: le:RightColumn("Category") !=
ColumnOffsetAt(-1, "Category")
Wyrażenia filtru linii wyświetlania mogą również korzystać z funkcji opisanych w Funkcje.
matchContext(expr,
linesBefore,
linesAfter)Prawda, jeśli bieżąca linia znajduje się w obrębie
linesBefore linie przed lub
linesAfter linie po dowolnym dopasowaniu linii
expr. Przykład:
le:matchContext(Different, 3, 3)
matchNumber(expr)Indeks bieżącego wiersza oparty na liczbie 1 we wszystkich pasujących
wierszach. Powroty nonejeśli linia nie pasuje. Przykład:
le:matchNumber(Different) = 1 pokazuje tylko pierwszą
pasującą linię (pierwszą linię różnicową).
matchCount(expr)Łączna liczba pasujących linii expr w całym
pliku. Przykład: le:matchNumber(Different) =
matchCount(Different) pokazuje tylko ostatnią pasującą linię
(ostatnią linię różnicową).
matchBlockNumber(expr)Zwraca numer bloku odpowiadającego liczbie 1 zawierającego bieżący
wiersz. Powroty none jeśli bieżąca linia nie znajduje się
w żadnym pasującym bloku. Przykład: le:matchBlockNumber(Different)
= 1 pokazuje tylko linie w pierwszym bloku różnicowym.
matchBlockOffset(expr)Zwraca przesunięcie bieżącej linii w pasującym bloku w oparciu o 1. Powroty
none jeśli bieżąca linia nie znajduje się w żadnym
pasującym bloku. Przykład: le:matchBlockOffset(Different) =
1 pokazuje tylko pierwszą linię każdego bloku różnicowego.
matchBlockSize(expr)Zwraca rozmiar (liczbę linii) pasującego bloku zawierającego bieżącą
linię. Powroty none jeśli bieżąca linia nie znajduje się
w żadnym pasującym bloku. Przykład: le:matchBlockSize(Different)
> 5 pokazuje tylko linie w blokach różnicowych większych niż 5
linii.
matchBlockCount(expr)Całkowita liczba pasujących bloków w pliku. Przykład:
le:matchBlockNumber(Different) =
matchBlockCount(Different) pokazuje tylko linie w ostatnim bloku
różnicowym.
matchDistance(expr),
matchDistanceBefore(expr),
matchDistanceAfter(expr)Odległość w liniach do najbliższego pasującego zakresu (w obu kierunkach,
tylko przed lub tylko po). Przykład: le:matchDistance(Different)
<= 5
matchInside(beginExpr,
endExpr)Prawda, jeśli bieżąca linia mieści się w pasującym wierszu
beginExpr i dopasowanie następnej linii
endExpr (włącznie). Przykład:
le:matchInside(Line matches "^#ifdef", Line matches
"^#endif")
average(expr),
average(expr,
condition)Oblicza średnią (średnią arytmetyczną) wartości liczbowych uzyskanych w
wyniku oceny expr dla wszystkich linii w pliku.
Jeśli condition jest podane, tylko linie gdzie
condition wartości true są uwzględniane w
obliczeniach. Wyniki inne niż numeryczne są ignorowane. Powroty
nonejeśli nie zostaną znalezione żadne wartości
liczbowe. Przykład: le:toInt(Column("Price")) >
average(toInt(Column("Price"))) pokazuje wiersze, w których cena
przekracza cenę średnią. Przykład z warunkiem:
le:average(toInt(Column("Score")), Column("Status") =
"PASS") oblicza średni wynik dla wierszy ze statusem „PASS”.
maximum(expr),
maximum(expr,
condition)Zwraca maksymalną wartość spośród wszystkich wyników uzyskanych w wyniku
oceny expr dla wszystkich linii w pliku. Jeśli
condition jest podane, tylko linie gdzie
condition brane jest pod uwagę, że ma wartość
true. Działa z wartościami numerycznymi, ciągami znaków (porównanie
alfabetyczne) i znacznikami czasu. Powroty nonejeśli nie
zostaną znalezione żadne wartości. Przykład:
le:toInt(Column("Quantity")) =
maximum(toInt(Column("Quantity"))) pokazuje wiersze z największą
liczbą.
minimum(expr),
minimum(expr,
condition)Zwraca minimalną wartość spośród wszystkich wyników uzyskanych w wyniku
oceny expr dla wszystkich linii w pliku. Jeśli
condition jest podane, tylko linie gdzie
condition brane jest pod uwagę, że ma wartość
true. Działa z wartościami numerycznymi, ciągami znaków (porównanie
alfabetyczne) i znacznikami czasu. Powroty nonejeśli nie
zostaną znalezione żadne wartości. Przykład: le:Column("Status") =
minimum(Column("Status")) pokazuje wiersze z alfabetycznie
pierwszą wartością statusu.
sum(expr),
sum(expr,
condition)Oblicza sumę wszystkich wartości liczbowych uzyskanych w wyniku oceny
expr dla wszystkich linii w pliku. Jeśli
condition jest podane, tylko linie gdzie
condition wartości true są uwzględniane w
obliczeniach. Wyniki inne niż numeryczne są ignorowane. Powroty
nonejeśli nie zostaną znalezione żadne wartości
liczbowe. Przykład: le:toInt(Column("Quantity")) /
sum(toInt(Column("Quantity"))) * 100 oblicza procent każdego
wiersza całkowitej ilości. Przykład z warunkiem:
le:sum(toInt(Column("Sales")), Column("Region") = "East")
oblicza całkowitą sprzedaż dla regionu „Wschód”.
| Wejście | Efekt |
|---|---|
TODO |
Pokazuje linie zawierające tekst „TODO” (zwykły ciąg znaków) |
le:Different |
Pokazuje tylko linie w blokach różnicowych |
le:Different or Trivial |
Pokazuje wszystkie różnice, łącznie z ignorowanymi różnicami |
le:matchContext(Different, 3, 3) |
Pokazuje bloki różnic z 3 liniami kontekstu po każdej stronie |
le:matchNumber(Different) = 1 |
Pokazuje tylko pierwszą linię różnicy |
le:matchBlockNumber(Different) <= 3 |
Pokazuje tylko linie w pierwszych 3 blokach różnicowych |
le:matchBlockOffset(Different) = 1 |
Pokazuje tylko pierwszą linię każdego bloku różnicowego |
le:matchBlockSize(Different) > 10 |
Pokazuje tylko linie w blokach różnic większych niż 10 linii |
le:Different and Line contains "ERROR" |
Pokazuje linie, które są różne i zawierają „BŁĄD” |
le:strFind(Line, "TODO") < 10 |
Pokazuje wiersze, w których w ciągu pierwszych 10 znaków pojawia się „TODO”. |
le:regexFind(Line, "\d{4}") != none |
Pokazuje linie zawierające 4-cyfrową liczbę |
le:matchContext(Bookmarked, 2, 2) |
Pokazuje zaznaczone linie z 2 linijkami kontekstu |
le:LineNumber <= 50 |
Pokazuje tylko pierwsze 50 linii |
le:EOL = 3 |
Wyświetla tylko linie z zakończeniami linii CRLF (Windows). |
le:EOLStr = "LF" |
Pokazuje tylko linie z zakończeniami linii LF (Unix). |
le:allof(EOL = 1) |
Pokazuje linie, w których wszystkie szyby korzystają z zakończeń linii LF |
le:toInt(Column("Count")) > 100 |
Pokazuje wiersze, w których wartość w kolumnie „Count” przekracza 100 (tryb tabeli) |
Filtr wyświetlanych plików/folderów w oknie Porównywanie folderów działa w taki sam sposób, jak filtr liniowy wyświetlany w oknie Porównywanie plików, ale działa na plikach i folderach, a nie na liniach. Kontroluje, które elementy są widoczne, bez wpływu na wynik porównania.
Aby otworzyć pasek filtra wyświetlania, kliknij → lub naciśnij Ctrl+Przesunięcie+L.
Pasek filtra akceptuje tę samą składnię co pasek filtra Filtruj w oknie dialogowym Wybierz pliki lub foldery. Zobacz Składnia i przykład maski pliku i Składnia wyrażenia filtru po szczegóły.
Aby usunąć filtr, wyczyść pole wprowadzania i naciśnij Wejdź. Aby ukryć pasek filtra, pozostawiając filtr aktywny, kliknij przycisk zamykania.
Przykłady:
*.cpp;*.h - pokazuje pliki źródłowe i nagłówkowe C++
!.git\;!.vs\ - wyklucza foldery .git i .vs
fe:Different - pokazuje tylko różne pliki
de:Items > 10 - pokazuje foldery zawierające
więcej niż 10 elementów
e:Date > today() - 7days - pokazuje elementy
zmodyfikowane w ciągu ostatniego tygodnia
Począwszy od wersji 2.16.59, wyrażeń filtrujących można używać jako
elementów w potokach wtyczek, poprzedzając je znakiem
le:. Na przykład:
le:toUpper(Linia)|Sortuj rosnąco
Zobacz Składnia wyrażenia filtru dla dostępnych funkcji i operatorów wyrażeń filtrów.
Kiedy wyrażenia filtrujące są używane w potokach wtyczek, działają one w
danym momencie w jednej linii (wartość skalarna), co różni się od filtrów
linii wyświetlania. W filtrach linii wyświetlania atrybuty takie jak
Line reprezentują pary wartości (porównywana jest lewa i
prawa strona), zwykle wyrażane jako tablice, np [Left,
Right]. W potokach wtyczek te same atrybuty, jak
Line są wartościami skalarnymi reprezentującymi aktualnie
przetwarzaną linię.
W tej sekcji opisano okno dialogowe Filtry, które udostępnia funkcje umożliwiające tworzenie filtrów plików i filtrów liniowych oraz zarządzanie nimi.
Aby otworzyć okno dialogowe Filtry, użyj jednej z następujących metod:
W oknie dialogowym Wybierz pliki lub foldery kliknij na prawo od Filtruj pole. Tej metody używasz, jeśli chcesz zastosować filtr plików do operacji porównywania folderów.
Kliknij → . Tej metody można użyć w dowolnym momencie, z wyjątkiem sytuacji, gdy otwarte jest okno dialogowe Wybierz pliki lub foldery.
Okno dialogowe Filtry zawiera zakładkę dla każdego typu filtra WinMerge:
Wybierz tę kartę, aby pracować z filtrami plików podczas operacji porównywania folderów.
Wybierz tę kartę, aby pracować z filtrami liniowymi podczas operacji porównywania plików.
Wybierz tę kartę, aby pracować z filtrami podstawiania dla operacji porównywania plików.
W tym oknie dialogowym nie można skonfigurować filtra linii wyświetlacza. Otwórz przez → . Zobacz Korzystanie z filtra liniowego wyświetlacza.
Główną częścią tej zakładki jest lista filtrów plików dostępnych dla operacji porównywania folderów. Lista zawiera filtry plików współdzielonych, prywatnych i zainstalowanych, o których wie WinMerge, jak opisano w Lokalizacje filtrów plików.
Musisz włączyć filtr plików, aby był on dostępny w operacji porównywania folderów, lub wyłączyć bieżący filtr, aby uniemożliwić jego użycie:
Otwórz okno dialogowe Filtry, jeśli nie jest jeszcze otwarte.
Wybierz filtr plików lub z listy.
Kliknij , aby zamknąć okno dialogowe Filtry.
Istnieje kilka sposobów zastosowania filtrów plików po ich włączeniu. Aby uzyskać szczegółowe informacje, zobacz Stosowanie filtrów plików.
Użyj tych przycisków, aby zarządzać swoimi Filtry plików wylistuj i utwórz nowe filtry plików:
Wybierz filtr plików z listy i kliknij aby szybko sprawdzić działanie filtra. Zobacz Testowanie reguł filtrowania plików po szczegóły.
Umożliwia zlokalizowanie filtru plików i dodanie go do listy Filtry. Filtry plików, które nie znajdują się ani w folderze udostępnionym, ani w domyślnym folderze prywatnym, nie zostaną wykryte, chyba że je zainstalujesz.
Tworzy nową kopię szablonu pliku w folderze filtrów udostępnionych lub prywatnych i otwiera ją w domyślnym edytorze. Edytuj szablon i dodaj swoje reguły zgodnie z opisem w Tworzenie filtra plików.
Wybierz filtr plików z listy i kliknij aby otworzyć plik w domyślnym edytorze.
Wybierz filtr plików z listy i kliknij , aby usunąć plik i usunąć go z listy. Tak, plik został naprawdę usunięty!
Zmiany zostaną zapisane po kliknięciu , aby zamknąć okno dialogowe Filtry. Filtry linii są przechowywane w rejestrze systemu Windows.
Jeśli filtry plików zainstalowane z WinMerge nie zapewniają wymaganego filtrowania, możesz utworzyć własne:
Kliknij → . Możesz też kliknąć w oknie dialogowym Wybierz pliki lub foldery na prawo od Filtruj pole.
W oknie dialogowym Filtry, na karcie Filtry plików kliknij .
W oknie dialogowym Filtr udostępniony lub prywatny wybierz Udostępniony filtr lub Filtr prywatny (patrz Lokalizacje filtrów plików do ich zastosowań) i kliknij OK.
W folderze plików udostępnionych lub prywatnych w systemie zostanie otwarte okno dialogowe Wybierz nazwę pliku dla nowego filtra (jeśli folder prywatny nie istnieje, WinMerge go utworzy).
W oknie dialogowym Wybierz nazwę pliku dla nowego filtra wprowadź nową nazwę pliku i kliknij .
Nie wybieraj istniejącej nazwy pliku: aby edytować istniejący plik, wróć do kroku 2 i kliknij Edytuj zamiast Nowy.
WinMerge inicjuje nowy plik zawartością FileFilter.tmpl
szablon i otwiera go w domyślnym edytorze tekstu.
Postępuj zgodnie z instrukcjami szablonu, aby edytować szablon, aktualizując nazwę i opis obiektu zastępczego oraz dodając reguły filtrowania zgodnie z opisem w sekcji Składnia filtra plików. Zapisz plik w swoim edytorze tekstu.
Jeśli chcesz szybko przetestować definiowaną regułę, spróbuj kliknąć opcję Testuj w oknie dialogowym Filtry. Zobacz Testowanie reguł filtrowania plików po szczegóły.
Jeśli utworzyłeś filtr plików w jednym ze standardów
Filters folderów, a w oknie dialogowym Filtry nie jest
wyświetlany nowy filtr plików, spróbuj kliknąć aby
je zamknąć, a następnie kliknij → ponownie, aby je ponownie
otworzyć. The Filtry plików lista powinna teraz
zawierać nowy filtr plików.
Jeśli zapisałeś plik w alternatywnej lokalizacji w systemie plików), WinMerge nie będzie w stanie go wykryć, chyba że go zainstalujesz. Aby filtr plików był wykrywalny w dowolnym miejscu systemu:
Kliknij w oknie dialogowym Filtry.
W oknie dialogowym Znajdź plik filtru do zainstalowania przejdź do
flt plik w systemie i kliknij
. Lista filtrów plików powinna teraz zawierać
zainstalowany filtr plików.
Użyj okna dialogowego Testuj filtr, aby szybko przetestować filtr plików na podstawie przykładowych danych, aby pomóc w opracowaniu nowych reguł lub zrozumieniu, jak działają istniejące reguły. Może to być łatwiejsze niż przeprowadzenie operacji pełnego porównania.
Zaczynając od okna dialogowego Filtry:
Na karcie Filtry plików wybierz filtr plików, który chcesz przetestować.
Jeśli chcesz zobaczyć reguły, które będziesz testować, kliknij teraz, aby otworzyć plik, aby móc go wyświetlić w kolejnych krokach.
Kliknij .
W oknie dialogowym Filtr testowy wybierz typ reguły do przetestowania:
Aby przetestować f: regułę pliku w filtrze plików, odznacz opcję Nazwa folderu opcja.
Aby przetestować d: regułę folderu, sprawdź Nazwa folderu opcja.
Wpisz tekst do przetestowania.
Tekst powinien być odpowiedni dla typu testowanej reguły. Na przykład, jeśli zaznaczyłeś Nazwa folderu opcję, prawdopodobnie chcesz wprowadzić nazwę folderu, na przykład \temp.
The Wynik wyświetla Twój wpis i jego status: albo
passed lub
failed.
Użyj tej karty, aby skonfigurować i włączyć filtry liniowe dla operacji porównywania plików. W zakładce znajduje się lista reguł. Każda reguła zawiera jedno wyrażenie regularne. Do porównywania plików możesz zastosować dowolną kombinację reguł z listy.
Poniżej Wyrażenia regularne lista to pole edycji i przyciski, których możesz używać do zarządzania listą w dowolnym momencie poprzez dodawanie, edytowanie i usuwanie reguł.
Aby dodać nową regułę:
Kliknij . Kursor edycji jest automatycznie włączany w polu edycji.
Wprowadź wyrażenie w polu edycji poniżej Wyrażenia regularne lista.
Kliknij aby załadować wyrażenie w nowej linii na liście.
Aby edytować istniejącą regułę:
Wybierz linię i kliknij .
Edytuj wyrażenie w polu edycji.
Kliknij kiedy skończysz.
Aby usunąć istniejącą regułę, wybierz (zaznacz) regułę i kliknij .
w Wyrażenia regularne na liście, zaznacz tylko te filtry, które chcesz zastosować i odznacz wszystkie filtry, których nie chcesz stosować.
Zaznacz lub odznacz Włącz filtry liniowe opcja. Jeśli włączysz filtrowanie, wszystkie reguły aktualnie zaznaczone w pliku Wyrażenie regularne lista jest używana. Jeśli filtrowanie jest wyłączone, żadne reguły nie są używane, nawet jeśli są zaznaczone.
Kliknij , aby zamknąć okno dialogowe Filtry i zapisać ustawienia.
Istnieje kilka sposobów zastosowania filtrów plików po ich włączeniu. Aby uzyskać szczegółowe informacje, zobacz Stosowanie filtrów liniowych.
Wyrażenia regularne mogą być bardzo złożone. Na szczęście większość filtrów plików w WinMerge obejmuje proste wyrażenia rozszerzeń, jak pokazano w przykładach w tym temacie. Pliki filtrów instalowane z WinMerge zawierają wiele innych przydatnych przykładów.
Wreszcie, w Internecie istnieje wiele zasobów pomocy dotyczących wyrażeń regularnych, w tym następujące witryny: