Korzystanie z filtrów


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:

Porównanie folderów: maski plików i filtry 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ąć Zobacz → Pokaż pominięte elementy 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.

Porównania plików: filtry liniowe i filtry podstawieniowe

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.

1. Korzystanie z masek plików

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.

1.1. Definiowanie i stosowanie masek plików

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).

1.2. Składnia i przykład maski pliku

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:

    *.ext

    Maska pliku według rozszerzenia (np. *.txt)

    *.

    Pliki bez rozszerzenia (np. README)

    !*.ext

    Wyklucz 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)

    f: regexp

    Dopasuj nazwy plików za pomocą wyrażeń regularnych (dostępne od 2.16.49)

    f!: regexp

    Wyklucz pliki pasujące do wyrażenia regularnego (dostępne od 2.16.49)

    d: regexp

    Dopasuj nazwy folderów za pomocą wyrażenia regularnego (dostępne od 2.16.49)

    d!: regexp

    Wyklucz foldery pasujące do wyrażenia regularnego (dostępne od 2.16.49)

    np: expr

    Wyrażenie filtrujące dla plików (np. fe:Size < 1KB) (Dostępne od 2.16.49)

    fe!: expr

    Wyrażenie filtru wykluczające pliki (dostępne od 2.16.49)

    od: expr

    Wyrażenie filtra dla folderów (dostępne od 2.16.49)

    de!: expr

    Wyrażenie filtru wykluczające foldery (dostępne od 2.16.49)

    pf: file filter name

    Zastosuj 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"


1.3. Składnia wyrażenia filtru

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.

1.3.1. Literały i typy

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.

1.3.2. Dyrektywy

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.

1.3.2.1. Dyrektywy dotyczące uwzględniania przypadków

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.

1.3.2.2. Dyrektywy optymalizacyjne

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, @opt

Włącz optymalizację wyrażeń filtra (zachowanie domyślne). Może to poprawić wydajność złożonych wyrażeń.

@nooptimize, @noopt

Wyłą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ę

1.3.2.3. Dyrektywa dotycząca nazw

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=FilterName

Przypisuje 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"

Note

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.

1.3.3. Atrybuty

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.

1.3.3.1. Podstawowe atrybuty
Exists

Powroty true jeśli plik istnieje, false inaczej

Name

Nazwa pliku

BaseName

Zwraca nazwę pliku bez rozszerzenia. Na przykład „dokument.txt” zwraca „dokument”.

Extension

Rozszerzenie pliku

IsFolder

Zwraca wartość true, jeśli elementem jest folder/katalog, lub false, jeśli jest to plik.

Folder

Zwraca ścieżkę względną z wyłączeniem nazwy pliku i folderu podstawowego

RelPath

Zwraca ś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”.

FullPath

Zwraca pełną ścieżkę pliku

Size

Rozmiar pliku

Date

Ostatnia modyfikacja znacznika czasu

DateStr

Ciąg daty ostatniej modyfikacji w yyyy-MM-dd formatować

CreationTime

Znacznik czasu daty utworzenia

Attributes

Zwraca atrybuty pliku jako wartość całkowitą

AttrStr

Zwraca ciąg atrybutów pliku. Przykłady: "R" tylko do odczytu, "H" dla Ukrytych, "A" dla Archiwum, "S" dla pliku systemowego.

1.3.3.2. Atrybuty tylko dla plików

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.

Content

Treść pliku. Zwraca wartość typu FileContent. Tylko contains i recontains można używać z tym typem.

1.3.3.3. Atrybuty tylko dla folderów

Poniższe atrybuty są dostępne tylko dla elementów porównywania folderów. W przypadku użycia z elementami pliku zachowanie jest niezdefiniowane.

Files

Liczba plików bezpośrednio zawartych w folderze.

RecursiveFiles

Liczba plików zawartych w folderze, łącznie ze wszystkimi podfolderami.

Items

Liczba elementów (plików i podfolderów) bezpośrednio zawartych w folderze.

RecursiveItems

Liczba elementów (plików i podfolderów) zawartych w folderze, łącznie ze wszystkimi podfolderami.

TotalSize

Całkowity rozmiar wszystkich plików znajdujących się bezpośrednio w folderze, w bajtach.

RecursiveTotalSize

Całkowity rozmiar wszystkich plików zawartych w folderze, łącznie ze wszystkimi podfolderami, w bajtach.

1.3.3.4. Prefiksy specyficzne dla strony

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).

1.3.3.5. Atrybuty właściwości systemu Windows

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")

MiddleProp

Wartość właściwości pliku środkowego (w porównaniu trójstronnym).

RightProp

Wartość właściwości pliku po prawej stronie.

1.3.3.6. Wyświetlaj tylko atrybuty filtrów

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.

EOL

Zwraca 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)

EOLStr

Zwraca 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.

1.3.3.7. Ocena tablicy

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.

1.3.3.7.1. Tablica kontra skalar

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.

Example 7. Przykład

[3, 5, 8] > 6 -> [fałsz, fałsz, prawda] -> prawda

1.3.3.7.2. Tablica kontra tablica

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)
              

1.3.3.7.3. Podsumowanie
  • 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.

1.3.4. Operatorzy

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, not

Operatory logiczne

like

Dopasowanie ciągu znaków wieloznacznych

Możesz także użyć not like aby wykonać odwrotne dopasowanie.

matches

Pasuje do wyrażeń regularnych

Możesz także użyć not matches aby wykonać odwrotne dopasowanie.

contains

Sprawdza, czy ciąg zawiera podciąg

Możesz także użyć not contains aby sprawdzić brak podciągu.

recontains

Sprawdza, czy dowolny podciąg pasuje do wyrażenia regularnego

Możesz także użyć not recontains aby upewnić się, że nie ma dopasowania.

1.3.5. Funkcje

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.

1.3.5.1. Funkcje ciągów
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"

1.3.5.2. Funkcje zawartości pliku
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.

1.3.5.3. Funkcje konwersji typu
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()

1.3.5.4. Funkcje daty/czasu
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.

1.3.5.5. Funkcje matematyczne i porównawcze
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)

1.3.5.6. Funkcje tablicowe
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

1.3.5.7. Funkcje warunkowe
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")

1.3.5.8. Elementowe funkcje logiczne
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

1.3.5.9. Funkcje diagnostyczne i rejestrujące
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ę

1.3.6. Jednostki

Rozmiary plików obsługują następujące przyrostki:

KB, MB, GB, gruźlica

Czasy 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, pani

1.3.7. Przykłady

  • Size < 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)

2. Korzystanie z filtrów plików

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.

2.1. Lokalizacje filtrów plików

WinMerge automatycznie wykrywa filtry plików w następujących lokalizacjach:

Podfolder Filters w folderze instalacyjnym WinMerge

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.

Domyślny folder filtrów prywatnych

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ć.

2.2. Stosowanie filtrów plików

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:

    1. Po wybraniu 1 i 2 foldery, kliknij Wybierz obok Filtruj pole.

    2. W oknie dialogowym Filtry użyj karty Filtry plików, aby wybrać filtr plików i załadować go do pliku Filtruj pole.

      Note

      Jeśli filtr plików jest aktualnie włączony, wybrany filtr plików jest już załadowany w pliku Filtruj pole.

    3. 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):

    1. Kliknij Narzędzia → Filtry.

    2. W oknie dialogowym Filtry skonfiguruj nowe ustawienie filtra plików i kliknij OK.

    3. 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.

2.3. Składnia filtra 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:

imię

Nazwa filtra wyświetlana w oknie dialogowym Pliki

def

Typ filtrowania, który ma zostać zastosowany. Określ jedną z tych wartości:

zawierać

Zawiera wszystko oprócz elementów pasujących do określonej reguły.

wykluczyć

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

Tip

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:

f: regexp

Dopasuj nazwy plików za pomocą wyrażeń regularnych

f!: regexp

Wyklucz pliki pasujące do wyrażenia regularnego (dostępne od 2.16.19)

d: regexp

Dopasuj nazwy folderów za pomocą wyrażenia regularnego

d!: regexp

Wyklucz foldery pasujące do wyrażenia regularnego (dostępne od 2.16.19)

np: expr

Wyrażenie filtrujące dla plików (np. fe:Size < 1KB) (Dostępne od 2.16.49)

fe!: expr

Wyrażenie filtru wykluczające pliki (dostępne od 2.16.49)

od: expr

Wyrażenie filtra dla folderów (dostępne od 2.16.49)

de!: expr

Wyrażenie filtru wykluczające foldery (dostępne od 2.16.49)

mi: expr

Wyrażenie filtru stosowane zarówno do plików, jak i folderów (np. e:Nazwa typu „Common*.*”) (dostępne od 2.16.56)

e!: expr

Wyraż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:

^ (początek linii)

Często wymagane do prawidłowego działania reguł.

$ (koniec linii)

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ę od c, jak cpp i com.
\ (ucieczka)

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 *.cpp pliki
f: \.h$ ## Dopasowanie *.h pliki
f: ^Mój ## mecz My*.* pliki
f: Dlg\. ## Dopasuj *Dlg.* pliki
d: \\test$ ## Dopasowanie test foldery
d: ^\\Buduj$ ## Dopasuj Build foldery
d: Temp$ ## Dopasuj *Temp foldery (np. FirstTemp)
d: Src ## Dopasowanie *Src* foldery

Niektóre reguły z bardziej złożonymi wyrażeniami regularnymi:

f: ^\.#.*$ ## .#filename.version pliki
f: Dlg\.c(pp)?$ ## *Dlg.c i *Dlg.cpp pliki
f: ^I.*\.h$ ## I*.h pliki
f: Srv[1-9]\.def$ ## *Srv1.def do *Srv9.def pliki
f: ^[h,k,m] ## h*.*, k*.*, i m*.* pliki

3. Korzystanie z filtrów liniowych

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.

3.1. Stosowanie filtrów liniowych

Filtry liniowe można zastosować dowolną z następujących metod:

  • Po uruchomieniu porównywania plików w oknie dialogowym Wybierz pliki lub foldery

    1. Po wybraniu 1 i 2 pliki, kliknij Wybierz obok Filtruj pole.

    2. 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.

      Note

      The Filtruj pole nie wskazuje, jakie filtry liniowe są włączone.

    3. 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)

    1. Kliknij Narzędzia → Filtry.

    2. Otwórz kartę Filtry plików.

    3. 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 Nowy, Edytuj, i Usuń przyciski.

    4. Aby włączyć filtrowanie linii, zaznacz opcję Włącz filtry liniowe. Aby wyłączyć filtrowanie linii, odznacz tę opcję.

    5. Kliknij OK , aby zamknąć okno dialogowe Filtry plików.

    6. Kliknij F5 , aby zastosować zmiany i odświeżyć okno Porównywanie plików.

3.2. Składnia filtru liniowego

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.

Tip

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:

^#

4. Korzystanie z filtra liniowego wyświetlacza

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.

4.1. Otwieranie paska filtra wyświetlania

Użyj dowolnej z poniższych metod, aby otworzyć pasek filtra wyświetlania:

  • Kliknij Zobacz → Wyświetl pasek filtralub naciśnij Ctrl+Przesunięcie+L.

  • Kliknij prawym przyciskiem myszy zaznaczony tekst w oknie Porównaj pliki i wybierz Dodaj do filtrów → Dodaj do filtrów wyświetlania. 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.

4.2. Wejście do filtra

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:

Zwykły ciąg znaków (bez przedrostka)

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"

Important

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".

4.3. Składnia wyrażenia filtrującego

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.

4.3.1. Atrybuty linii

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.

Line

Treść tekstowa bieżącego wiersza. Obsługuje prefiksy specyficzne dla strony. Przykład: Line contains "TODO"

LineLength

Długość bieżącej linii w znakach. Obsługuje prefiksy specyficzne dla strony. Przykład: LineLength > 120

LineNumber

Rzeczywisty numer linii w pliku (oparty na 1), nie licząc linii duchów. Obsługuje prefiksy specyficzne dla strony. Przykład: LineNumber <= 50

ViewLineNumber

Wyświetl numer linii, w tym linie widma (w oparciu o 1). Atrybut globalny (bez bocznego przedrostka). Przykład: ViewLineNumber <= 100

Different

Prawda, jeśli linia jest częścią bloku różnicowego. Atrybut globalny. Przykład: Different

Identical

Prawda, jeśli linia jest identyczna we wszystkich panelach. Atrybut globalny.

Trivial

Prawda, jeśli linia różni się jedynie odstępami lub inną ignorowaną treścią. Atrybut globalny. Przykład: Different or Trivial

Exists

Prawda, jeśli linia istnieje w panelu (nie jest to linia widmo). Obsługuje prefiksy specyficzne dla strony. Przykład: LeftExists and not RightExists

Missing

Prawda, jeśli linia jest linią widmową w okienku. Przeciwieństwo Exists. Obsługuje prefiksy specyficzne dla strony.

Moved

Prawda, jeśli linia zostanie wykryta jako linia przesunięta. Obsługuje prefiksy specyficzne dla strony.

Bookmarked

Prawda, jeśli linia ma zakładkę. Obsługuje prefiksy specyficzne dla strony.

DifferentLeftMiddle, DifferentMiddleRight, DifferentLeftRight

Prawda, 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

EOL

Styl 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

EOLStr

Styl 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")

4.3.2. Funkcje liniowe

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”.

4.3.3. Przykłady

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)

5. Korzystanie z wyświetlanego filtra plików/folderów

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 Zobacz → Wyświetl pasek filtralub 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

6. Używanie wyrażeń filtrujących w potokach wtyczek

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ę.

7. Korzystanie z filtrów podstawieniowych

do ustalenia

8. Korzystanie z okna dialogowego Filtry

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 Wybierz na prawo od Filtruj pole. Tej metody używasz, jeśli chcesz zastosować filtr plików do operacji porównywania folderów.

  • Kliknij Narzędzia → Filtry. 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:

Filtry plików

Wybierz tę kartę, aby pracować z filtrami plików podczas operacji porównywania folderów.

Filtry liniowe

Wybierz tę kartę, aby pracować z filtrami liniowymi podczas operacji porównywania plików.

Filtry zastępcze

Wybierz tę kartę, aby pracować z filtrami podstawiania dla operacji porównywania plików.

Wyświetl filtr liniowy

W tym oknie dialogowym nie można skonfigurować filtra linii wyświetlacza. Otwórz przez Zobacz → Wyświetl pasek filtra. Zobacz Korzystanie z filtra liniowego wyświetlacza.

8.1. Korzystanie z karty Filtry plików

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.

8.1.1. Włączanie i wyłączanie 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:

  1. Otwórz okno dialogowe Filtry, jeśli nie jest jeszcze otwarte.

  2. Wybierz filtr plików lub <Żadne> z listy.

  3. Kliknij OK , 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.

8.1.2. Konfigurowanie filtrów plików

Użyj tych przycisków, aby zarządzać swoimi Filtry plików wylistuj i utwórz nowe filtry plików:

Testuj

Wybierz filtr plików z listy i kliknij Testuj aby szybko sprawdzić działanie filtra. Zobacz Testowanie reguł filtrowania plików po szczegóły.

Zainstaluj

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.

Nowy

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.

Edytuj

Wybierz filtr plików z listy i kliknij Edytuj aby otworzyć plik w domyślnym edytorze.

Usuń

Wybierz filtr plików z listy i kliknij Usuń , aby usunąć plik i usunąć go z listy. Tak, plik został naprawdę usunięty!

Zmiany zostaną zapisane po kliknięciu OK , aby zamknąć okno dialogowe Filtry. Filtry linii są przechowywane w rejestrze systemu Windows.

8.1.3. Tworzenie filtra plików

Jeśli filtry plików zainstalowane z WinMerge nie zapewniają wymaganego filtrowania, możesz utworzyć własne:

  1. Kliknij Narzędzia → Filtry. Możesz też kliknąć w oknie dialogowym Wybierz pliki lub foldery Wybierz na prawo od Filtruj pole.

  2. W oknie dialogowym Filtry, na karcie Filtry plików kliknij Nowy.

  3. 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).

  4. W oknie dialogowym Wybierz nazwę pliku dla nowego filtra wprowadź nową nazwę pliku i kliknij Zapisz.

    Note

    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.

  5. 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.

    Tip

    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.

  6. 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ąć OK aby je zamknąć, a następnie kliknij Narzędzia → Filtry 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:

    1. Kliknij Zainstaluj w oknie dialogowym Filtry.

    2. W oknie dialogowym Znajdź plik filtru do zainstalowania przejdź do flt plik w systemie i kliknij Otwórz. Lista filtrów plików powinna teraz zawierać zainstalowany filtr plików.

8.1.4. Testowanie reguł filtrowania 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:

  1. Na karcie Filtry plików wybierz filtr plików, który chcesz przetestować.

  2. Jeśli chcesz zobaczyć reguły, które będziesz testować, kliknij Edytuj teraz, aby otworzyć plik, aby móc go wyświetlić w kolejnych krokach.

  3. Kliknij Testuj.

  4. 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.

  5. 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.

8.2. Korzystanie z karty Filtry linii

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.

8.2.1. Konfigurowanie filtrów liniowych

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łę:

  1. Kliknij Nowy. Kursor edycji jest automatycznie włączany w polu edycji.

  2. Wprowadź wyrażenie w polu edycji poniżej Wyrażenia regularne lista.

  3. Kliknij Zapisz aby załadować wyrażenie w nowej linii na liście.

Aby edytować istniejącą regułę:

  1. Wybierz linię i kliknij Edytuj.

  2. Edytuj wyrażenie w polu edycji.

  3. Kliknij Zapisz kiedy skończysz.

Aby usunąć istniejącą regułę, wybierz (zaznacz) regułę i kliknij Usuń.

8.2.2. Włączanie i wyłączanie filtrów liniowych

  1. w Wyrażenia regularne na liście, zaznacz tylko te filtry, które chcesz zastosować i odznacz wszystkie filtry, których nie chcesz stosować.

  2. 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.

  3. Kliknij OK , 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.

8.3. Korzystanie z zakładki Filtry zastępcze

do ustalenia

8.3.1. Konfiguracja filtrów podstawieniowych

do ustalenia

8.3.2. Włączanie i wyłączanie filtrów zastępczych

do ustalenia

9. Uzyskiwanie pomocy dotyczącej wyrażeń regularnych

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:

Dobra strona poświęcona wyrażeniom regularnym:
https://www.regular-expressions.info/
Samouczek:
http://www.zvon.org/comp/r/tut-Regexp.html
Krótkie informacje w formacie PDF:
https://github.com/GordonMcKinney/gist-assets/raw/master/regex.pdf