שימוש במסננים

שימוש במסננים
הקודם		הבא

כשאתה משווה קבצים או תיקיות, אתה יכול להשתמש במסננים כדי לצמצם את היקף ההשוואה. זה יכול להיות שימושי כשאתה רוצה לפשט את תוצאת ההשוואה על ידי ביטול הבדלים שאינך מעוניין בהם. מסננים הם כללים המבוססים על ביטויים רגולריים. WinMerge משתמש במנוע הביטויים הרגולריים הפופולרי PCRE (ביטויים רגולריים תואמי Perl).

הפונקציה הבסיסית של סינון היא פשוטה: הערכת כל פריט שבדרך כלל יושווה (תיקייה, קובץ או שורה בתוך קובץ), ואם ביטוי המסנן תואם לפריט היעד, החל את המסנן. בהתאם לסוג המסנן, הפריט נכלל או לא נכלל בהשוואה.

ישנם מסנני WinMerge שונים עבור פעולות השוואת תיקיות והשוואת קבצים:

השוואת תיקיות: מסיכות קבצים ומסנני קבצים

You can specify files to include in a folder comparison by using simple file masks, or, for more complex filtering, by applying multiple rules specified in a file filter.

קבצים ותיקיות שמסוננים מוסתרים בתוצאה כברירת מחדל, וזה בדרך כלל מה שאתה רוצה. אתה יכול ללחוץ על תצוגה → הצג פריטים שדולגו כדי לבטל את ההסתרה של פריטים מסוננים, אך חלון השוואת התיקיות מציג רק מידע מינימלי עליהם. לדוגמה, אינך יכול לדעת אם קובץ שדולג הוא קובץ טקסט או בינארי.

השוואות קבצים: מסנני שורות ומסנני החלפה

מסנני שורות מוחלים רק על פעולות השוואת קבצים. הם מאפשרים לך להתעלם מהבדלי שורה בודדים.

מסנני החלפה מוחלים רק על פעולות השוואת קבצים. הם מחליפים את המחרוזות בגוש ה-diff במחרוזות שצוינו, משווים אותן ומתעלמים מגוש ה-diff אם תוצאות ההחלפה תואמות. הם שימושיים להתעלמות ממספר רב של שינויים לא מעניינים.

1. שימוש במסיכות קבצים

אתה יכול להשתמש במסיכות קבצים אחת או יותר שמציינות סיומות קבצים שיכללו בהשוואת תיקיות. כל שאר הקבצים מושמטים מהבחירה שלך.

1.1. הגדרה והחלה של מסיכות קבצים

הגדר והחל מסיכת קבצים בזמן שאתה מפעיל את פעולת השוואת התיקיות שלך:

אם אתה משתמש בתיבת הדו-שיח בחר קבצים או תיקיות, לאחר בחירת התיקיות 1 ו-2, הזן מסיכת קבצים אחת או יותר בשדה מסנן. המסכות מוחלות כשאתה מתחיל את פעולת השוואת התיקיות.
אם אתה משתמש בשורת הפקודה של WinMerge, השתמש בדגל -f כדי לציין מסיכות קבצים (ראה את הדוגמה בסעיף הבא).

1.2. תחביר ודוגמה של מסיכת קבצים

You can specify file masks and extended filters using this format:

        Filter1 of Group1;Filter2 ...|Filter1 of Group2;Filter2 ...|...

The | character separates filter groups and acts as a logical AND.
Filters within the same group are separated by ; and are interpreted with a logical OR.
A file is included only if it matches at least one filter in each group.
To include a literal | (pipe) character in a regular expression that is not enclosed in double quotes (such as in f: or f!: filters), use || instead.

Example: f:(abc||def)\.txt$
Each filter (e.g., Filter1, Filter2) can be one of the following types:

*.ext

File mask by extension (e.g., *.txt)

*.

Files with no extension (e.g., README)

!*.ext

Exclude files matching the extension (Available since 2.16.19)

folder\

Target folders (must end with \) (Available since 2.16.19)

!folder\

Exclude matching folders (Available since 2.16.19)

f: regexp

Match file names using regular expressions (Available since 2.16.49)

f!: regexp

Exclude files matching regex (Available since 2.16.49)

d: regexp

Match folder names using regex (Available since 2.16.49)

d!: regexp

Exclude folders matching regex (Available since 2.16.49)

fe: expr

Filter expression for files (e.g. fe:Size < 1KB) (Available since 2.16.49)

fe!: expr

Filter expression to exclude files (Available since 2.16.49)

de: expr

Filter expression for folders (Available since 2.16.49)

de!: expr

Filter expression to exclude folders (Available since 2.16.49)

pf: file filter name

Apply a file filter by name (Available since 2.16.49)

דוגמה 1. מסיכת קבצים

בדוגמה זו של שורת הפקודה, פעולת השוואת התיקיות כוללת רק קבצים עם סיומות xml או txt. כל שאר הקבצים מושמטים:

WinMergeU c:\project\docs c:\temp /f *.xml;*.txt

דוגמה 2. Excluding folders (since version 2.16.19)

בדוגמה זו של שורת הפקודה, פעולת השוואת התיקיות אינה כוללת תיקיות .git ו-.vs:

WinMergeU c:\project\docs c:\temp /f !.git\;!.vs\

דוגמה 3. Filter expression (since version 2.16.49)

In this command-line example, the folder compare operation includes only files with cpp or h extensions and a file size less than 1KB:

WinMergeU c:\project\docs c:\temp /f "*.cpp;*.h|fe:Size < 1KB"

1.3. Filter Expression Syntax

WinMerge allows powerful filtering using expressions that operate on file metadata, contents, and comparison context. This section describes the supported attributes, operators, functions, data types, and evaluation rules.

1.3.1. Literals and Types

Supported literal types include:

Boolean: true, false
Integer: 64-bit signed integers (e.g., 1024, or with units like 100KB, 7days)
Real (Double): Floating-point numbers with optional decimal or exponent (e.g., 3.14, .5, 1e6)
String: Enclosed in double quotes (e.g., "example")

Internally, values may be of the following types: Boolean, Integer, Real, Timestamp, String, File Content, Array, or undefined.

1.3.2. Attributes

Filter expressions support a variety of attributes referring to file metadata and content. Attribute names are case-insensitive. You can optionally specify which side of the comparison (Left, Right, or Middle) an attribute applies to by using a prefix.

1.3.2.1. Core Attributes

Exists: Returns true if the file exists, false otherwise
Name: File name
Extension: File extension
תיקייה: Returns the relative path excluding the file name and base folder
FullPath: Returns the full path of the file
Size: File size
Date: Last modified timestamp
DateStr: Last modified date string in yyyy-MM-dd format
CreationTime: Creation date timestamp
Attributes: Returns the file attributes as an integer value
AttrStr: Returns file attribute string. Examples: "R" for Read-only, "H" for Hidden, "A" for Archive, "S" for System file.
Content: Content of the file. Returns a FileContent-type value. Only contains and recontains can be used with this type.

1.3.2.2. Side-Specific Prefixes

Prefixes may be added to specify the comparison side:

Left: Applies to the file on the left side (e.g., LeftSize)
Right: Applies to the file on the right side (e.g., RightDate)
Middle: Applies to the middle file in 3-way comparison (e.g., MiddleName)

Attributes without a prefix (e.g., Size) return an array of values from all available sides (Left, Middle, Right).

1.3.2.3. Windows Property Attributes

These attributes provide access to Windows Property System values, such as metadata defined by the Windows Property System schema (e.g., System.Title, System.FileOwner, System.Image.HorizontalResolution).

Prop: Returns an array of property values (Left, Middle, Right) for the specified canonical property name. Example: prop("System.Title")
LeftProp: Property value of the left-side file. Example: leftprop("System.FileOwner")
MiddleProp: Property value of the middle file (in 3-way comparison).
RightProp: Property value of the right-side file.

1.3.2.4. Array Evaluation

Attributes without a side prefix (e.g., Size) return an array of values from all available sides (Left, Middle, Right). When applying an operator to such arrays, behavior differs depending on whether the comparison is with a scalar or another array.

1.3.2.4.1. Array vs Scalar

When comparing an array to a scalar, the operation is applied to each array element individually. This results in a boolean array. If any element in this boolean array is true, the overall expression evaluates to true. Otherwise, it evaluates to false.

דוגמה 4. דוגמה

[3, 5, 8] > 6 -> [false, false, true] -> true

1.3.2.4.2. Array vs Array

When comparing two arrays, the behavior depends on the operator:

For = and !=: The arrays must have the same length. The result is a single boolean value, not an array. = returns true only if all elements are equal. != returns true if any element differs.
For all other operators (e.g., >, <): the operation is applied element-wise, producing a boolean array. The final result of the expression is true if any element in the boolean array is true, and false if all elements are false.

דוגמה 5. Examples

[2, 4] = [2, 4] -> true

[2, 4] != [2, 5] -> true (because 4 != 5)

[3, 5, 8] > [6, 4, 2]
 -> [false, true, true]
 -> true (because at least one comparison is true)

1.3.2.4.3. Summary

Array vs scalar comparisons produce a boolean array. The overall expression result is true if at least one element is true.
Array vs array with = or != returns a single boolean value.
Array vs array with other operators produces a boolean array. The final result is true if any element is true.

1.3.3. Operators

All string comparison operators (such as =, !=, like, matches, contains, and recontains) are currently case-insensitive.

<, <=, >, >=

Numeric, timestamp, or string comparison

=

Equality comparison

!=

Inequality comparison

+, -, *, /, %

Arithmetic operators. + and - perform addition and subtraction. * and / perform multiplication and division. % is the modulo operator (remainder).

and, or, not

Logical operators

like

Wildcard string match

You can also use not like to perform the inverse match.

matches

Matches regular expressions

You can also use not matches to perform the inverse match.

contains

Checks if a string contains a substring

You can also use not contains to check for absence of the substring.

recontains

Checks if any substring matches a regular expression

You can also use not recontains to ensure no match exists.

1.3.4. Functions

lineCount(content): Returns the number of lines in the file content or file content array as an Integer. If content is an array, the result is an integer array. Example: lineCount(Content)
sublines(content, start, count): Extracts the specified number of lines starting from the given line index in the file content or file content array, and returns them as a single concatenated string. If content is an array, the result is an array of strings.
strlen(source): Returns the length of the string as an Integer. If source is a string array, the result is an integer array. Example: strlen(Name)
substr(source, start, count): Returns a specific range of text from the string or string array as a String. If source is a string array, the result is a string array. Example: substr(Name, 0, 3)
now(): Returns the current date and time as a Timestamp value.
today(): Returns today's date as a Timestamp value representing 00:00:00.000 at the start of the day.
startOfWeek(timestamp): Returns the first day of the week, which is always Sunday regardless of locale.
startOfMonth(timestamp): Returns the first day of the month.
startOfYear(timestamp): Returns the first day of the year.
toDateStr(timestamp): Converts the given timestamp to a date string in yyyy-MM-dd format. If timestamp is a timestamp array, the result is a string array.
abs(value): Returns the absolute value of the integer or integer array. If value is an integer array, the result is an integer array.
allof(booleans): Returns true if all elements in the boolean array satisfy the condition.
allequal(array): Returns true if all values in the array are equal.

1.3.5. Units

File sizes support these suffixes:

KB, MB, GB, TB

Time durations support these suffixes:

weeks, week, w, days, day, d, hours, hour, hr, h, minutes, minute, min, m, seconds, second, sec, s, milliseconds, millisecond, msec, ms

1.3.6. Examples

Size < 10KB - Any side's size is less than 10KB
LeftSize >= 10MB - Left side file is at least 10MB
allof(Size < 1MB) - All sides are under 1MB
abs(LeftSize - RightSize) < 1KB - Size difference is small
DateStr = "2025-07-20" - File was last modified on that date
Date >= today() - Modified today or later
AttrStr contains "R" - File is read-only
Name matches "file[0-9]\.txt" - Regex on filename
Content contains "Test" - File content includes keyword
sublines(Content, 0, 1) contains "XML" - First line contains "XML"
(Extension = "log" and Size > 10MB) or (Date < today() - 7days) - Large log files or files older than a week
AttrStr not contains "H" and Name like "*.tmp" - Non-hidden temporary files

2. שימוש במסנני קבצים

מסנני קבצים הם קבצי טקסט עם סיומת של flt. הם מאפשרים לך להחיל כללי סינון מרובים על השוואת תיקיות. בניגוד למסיכות קבצים, מסנני קבצים יכולים לכלול או לא לכלול התאמות.

WinMerge מתקין מספר מסנני קבצים מוגדרים מראש. אם מסנני קבצים אלה אינם מספקים את הסינון הדרוש לך, תוכל ליצור מסננים משלך. כדי להקל על משימה זו, WinMerge מספק גם קובץ תבנית בשם FileFilter.tmpl. סעיף זה מתאר כיצד להחיל מסנני קבצים על השוואות, ומתעד את תחביר מסנן הקבצים. סעיף 5, “שימוש בתיבת הדו-שיח מסננים” מתאר כיצד להוסיף, לערוך ולנהל מסננים.

2.1. מיקומי מסנני קבצים

WinMerge מזהה אוטומטית מסנני קבצים במיקומים אלה:

תיקיית המשנה מסננים בתיקיית ההתקנה של WinMerge

כאן מותקנים מסנני הקבצים המוגדרים מראש. לדוגמה, C:\Program Files\WinMerge\Filters. אתה יכול ליצור או להעתיק קבצי מסנן במיקום זה כדי להפוך אותם לזמינים לכל המשתמשים במערכת שלך.

לפני יצירת מסנן קבצים חדש, בדוק אם המסננים המוגדרים מראש כבר מכילים את מה שאתה צריך. אם לא, ייתכן שתמצא דוגמאות שימושיות לכללים בקבצים הקיימים.

תיקיית מסננים פרטית ברירת מחדל

המיקום של תיקייה זו מוגדר בדף מערכת של אפשרויות WinMerge. כברירת מחדל, הוא מצוין כתיקיית משנה בתיקיית פרופיל המשתמש שלך (לדוגמה, Documents ב-Windows 10). מסננים שנוצרים או מועתקים לכאן בדרך כלל גלויים רק לך. אם אתה יוצר מסנני קבצים חדשים, אתה יכול להעתיק אותם לכאן כדי לשמור אותם פרטיים.

לפני שתוכל להחיל מסנני קבצים הקיימים בכל תיקייה אחרת, עליך להתקין אותם תחילה.

2.2. החלת מסנני קבצים

אתה יכול להחיל מסנן קבצים באמצעות אחת מהשיטות הבאות:

כשאתה מפעיל השוואת תיקיות מתיבת הדו-שיח בחר קבצים או תיקיות:
1. לאחר בחירת התיקיות 1 ו-2, לחץ על בחר ליד השדה מסנן.
2. בתיבת הדו-שיח מסננים, השתמש בכרטיסייה מסנני קבצים כדי לבחור מסנן קבצים ולטעון אותו בשדה מסנן.
  
  שים לב
  
  אם מסנן קבצים מופעל כעת, מסנן הקבצים שנבחר כבר נטען בשדה מסנן.
3. המשך בפעולת ההשוואה. הקובץ בשדה מסנן מוחל כשאתה מתחיל את הפעולה.
כדי לשנות את סינון הקבצים לאחר שכבר הפעלת פעולת השוואת תיקיות (לדוגמה, החלת מסנן אחר או השבתת סינון):
1. לחץ על כלים → מסננים.
2. בתיבת הדו-שיח מסננים, הגדר את הגדרת מסנן הקבצים החדשה שלך ולחץ על אישור.
3. הסינון החדש לא מוחל אוטומטית כשאתה סוגר את תיבת הדו-שיח מסננים: הקש F5 כדי לראות את התוצאות החדשות בחלון השוואת התיקיות.
כשאתה מפעיל השוואת תיקיות משורת הפקודה של WinMerge, השתמש בדגל -f כדי לציין מסנן קבצים.

2.3. תחביר מסנן קבצים

סעיף זה מתאר את התחביר של מסנני קבצים של WinMerge ומספק הנחיות לכתיבתם.

תו המפריד להערות הוא ##. לאחר מפריד הערות, כל התווים בשורה מתעלמים מהם. WinMerge מתעלם מרוב תווי הרווח הלבן בכללים. עם זאת, הערה חייבת תמיד להיות מוקדמת על ידי תו רווח לבן (רווח או טאב) אחד או יותר. כדי להשתמש ב-## כתווים בכלל, השמט את קידומת הרווח הלבן.

שתי השורות הנדרשות הראשונות של מסנן קבצים הן:

שם

שם המסנן המופיע בתיבת הדו-שיח קבצים

def

סוג הסינון שיש להחיל. ציין אחד מהערכים הבאים:

כלול

כולל הכל מלבד פריטים התואמים לכלל שצוין.

אל תכלול

לא כולל הכל מלבד פריטים התואמים לכלל שצוין.

כשאתה בוחר בשיטת החרגה, עליך גם להוסיף כלל d (ספרייה) שמציין את תיקיות המשנה. בדרך כלל כדאי לציין את כל תיקיות המשנה, כך:

d: \\*$ ## תיקיות משנה

עצה

אל תבלבל בין מונחים אלה. זכור, במסנני קבצים, כלל כלול לא מציין מה לכלול, הוא מציין מה לא לכלול. באופן דומה, אל תכלול לא מציין מה לא לכלול, הוא מציין מה לא לא לכלול.

Next, your file should contain one or more filter rules. You can add as many rules as you like. There must be one rule per line, and each rule must be entirely on one line (no line breaks are allowed in a rule). A rule begins with a type designator, followed by either a regular expression or a filter expression. The supported type designators are:

f: regexp: Match file names using regular expressions
f!: regexp: Exclude files matching regex (Available since 2.16.19)
d: regexp: Match folder names using regex
d!: regexp: Exclude folders matching regex (Available since 2.16.19)
fe: expr: Filter expression for files (e.g. fe:Size < 1KB) (Available since 2.16.49)
fe!: expr: Filter expression to exclude files (Available since 2.16.49)
de: expr: Filter expression for folders (Available since 2.16.49)
de!: expr: Filter expression to exclude folders (Available since 2.16.49)

בין רבים מתווים מיוחדים של regexp, הבאים חשובים במיוחד בכללי מסנן קבצים:

^ (תחילת שורה)

נדרש לעתים קרובות כדי שהכללים יעבדו כראוי.

$ (סוף שורה)

נדרש לעתים קרובות כדי שהכללים יעבדו כראוי. לדוגמה:

\.c$ ## תואם רק לשמות קבצים עם הסיומת c.
\.c ## תואם לכל סיומת שמתחילה ב-c, כמו cpp ו-com.

\ (בריחה)

מכריח תווים מיוחדים להתאים לתווים רגילים. לדוגמה, כדי להתאים שם תיקייה, הקדם את תו המפריד של קו נטוי הפוך של התיקייה עם קו נטוי הפוך (\\). כדי להתאים את הנקודה בשם קובץ, ציין קו נטוי הפוך ואחריו נקודה (\.).

לא נעשה שימוש בתווים מיוחדים או בתווים כלליים כדי להתאים לשמות קבצים. כדי להתאים את כל שמות הקבצים מסוג מסוים, פשוט השמט את שם הקובץ.

הכללים אינם תלויי אותיות רישיות/קטנות. לדוגמה, f: \.bat$ תואם ל-winmerge.bat ו-compare.BAT.

דוגמה 6. דוגמאות לכללי סינון קבצים

כמה כללי סינון קבצים פשוטים:

f: \.cpp$ ## התאם לקבצי *.cpp
f: \.h$ ## התאם לקבצי *.h
f: ^My ## התאם לקבצי My*.*
f: Dlg\. ## התאם לקבצי *Dlg.*
d: \\test$ ## התאם לתיקיות test
d: ^\\Build$ ## התאם לתיקיות Build
d: Temp$ ## התאם לתיקיות *Temp (לדוגמה, FirstTemp)
d: Src ## התאם לתיקיות *Src*

כמה כללים עם ביטויים רגולריים מורכבים יותר:

f: ^\.#.*$ ## קבצי .#filename.version
f: Dlg\.c(pp)?$ ## קבצי *Dlg.c ו-*Dlg.cpp
f: ^I.*\.h$ ## קבצי I*.h
f: Srv[1-9]\.def$ ## קבצי *Srv1.def עד *Srv9.def
f: ^[h,k,m] ## קבצי h*.*, k*.* ו-m*.*

3. שימוש במסנני שורות

בהשוואת קבצים, אתה יכול להשתמש במסנני שורות כדי להתעלם משורות בודדות. לדוגמה, אתה עשוי להשתמש במסנני שורות כדי להתעלם מהערות או מסוג קוד שנוצר מסוים, כמו חותמות זמן של מערכת בקרת גרסאות. כל מסנן שורות הוא כלל, ואתה יכול להחיל כל מספר של מסנני שורות על השוואת קבצים.

כדי ללמוד כיצד להוסיף, לערוך ולנהל מסננים, ראה סעיף 5, “שימוש בתיבת הדו-שיח מסננים”.

3.1. החלת מסנני שורות

אתה יכול להחיל מסנני שורות באמצעות אחת מהשיטות הבאות:

כשאתה מפעיל השוואת קבצים מתיבת הדו-שיח בחר קבצים או תיקיות
1. לאחר בחירת הקבצים 1 ו-2, לחץ על בחר ליד השדה מסנן.
2. בתיבת הדו-שיח מסננים, השתמש בכרטיסייה מסנני שורות כדי להפעיל את מסנני השורות שבהם ברצונך להשתמש (אם יש), או כדי לראות אילו מסנני שורות מופעלים כעת.
  
  שים לב
  
  השדה מסנן לא מציין אילו מסנני שורות מופעלים.
3. המשך בפעולת השוואת הקבצים. מסנני השורות המופעלים מוחלים כשאתה מתחיל את הפעולה.
לאחר שכבר הפעלת פעולת השוואת קבצים (לדוגמה, כדי להחיל מסננים שונים או להשבית סינון)
1. לחץ על כלים → מסננים.
2. פתח את הכרטיסייה מסנני קבצים.
3. סמן את מסנני השורות הבודדים שברצונך להחיל ובטל את הסימון של מסננים שאינך רוצה להחיל.
  
  אתה יכול גם להוסיף, לערוך ולהסיר מסננים מהרשימה באמצעות הכפתורים חדש, ערוך ו-הסר.
4. כדי להפעיל סינון שורות, סמן את אפשר מסנני שורות. כדי לכבות סינון שורות, בטל את הסימון של האפשרות.
5. לחץ על אישור כדי לסגור את תיבת הדו-שיח מסנני קבצים.
6. לחץ על F5 כדי להחיל את השינויים שלך ולרענן את חלון השוואת הקבצים.

3.2. תחביר מסנן שורות

מסנן שורות הוא כלל המוערך כנגד כל הבדל בשורה בודדת בקבצים המושווים שלך, אם כללי מסנן שורות מופעלים. כאשר כלל תואם להבדל בשורה בודדת, ההבדל מתעלם ממנו.

הבדלים שמתעלמים מהם מסומנים בחלון השוואת הקבצים בצבע הבדל שמתעלמים ממנו (כפי שהוגדר בדף צבעים של אפשרויות WinMerge). זה מאפשר לך להבחין בין הבדלים שמתעלמים מהם מסוגים אחרים. עם זאת, אינך יכול לבחור או למזג הבדל שמתעלמים ממנו.

התאמת מסנן שורות ניתנת לתיאור במונחים של שני רעיונות:

כאשר כלל תואם לכל חלק מהשורה, ההבדל כולו מתעלמים ממנו. לכן, אינך יכול לסנן רק חלק משורה. לדוגמה, נניח שלשני קבצים יש את ההבדל הבא בשורה בודדת:

קובץ 1:
```
# Jean Sibelius
```
קובץ 2:
```
# Janne Sibelius
```
ללא סינון, השורה מזוהה כהבדל. אבל אם נחיל כלל מסנן שורות עם הביטוי, ^#, השורות מדווחות כזהות, מכיוון שהביטוי מציין רק את התו הראשון, התואם בשני הקבצים.
כלל מוחל על הבדל מרובה שורות רק אם כל השורות תואמות. לדוגמה, שקול את ההבדל הזה בשתי שורות:

קובץ 1:
```
# Jean Sibelius
# Pekka Himanen
```
קובץ 2:
```
# Janne Sibelius
Pekka Himanen
```
אותו כלל ^# תואם לשורה הראשונה, אך לא לשורה השנייה. לכן, לא מתעלמים מההבדל.

עצה

בדרך כלל מומלץ להשתמש בסמן תחילת שורה ( ^ ) וסוף שורה ( $ ) כדי לשלוט בדפוסים שלך במדויק, מכיוון שהכלל מוחל אם כל חלק משורה תואם לביטוי.

דוגמה 7. מסנני שורות לדוגמה

^MYTAG$

מסנן שורות שתואמות בדיוק ל-MYTAG

^::

מסנן שורות שמתחילות ב-::

^/\*.*\*/$

מסנן שורות שמתחילות ב-/* ומסתיימות ב-*/

^[1-5]00

מסנן שורות שמתחילות במספרים 100, 200, 300, 400 ו-500

דוגמה 8. כלל מסנן שורות התואם לשורות CVS Id

שורות CVS Id נראות כך:

// $Id: Filters.xml 7591 2013-01-20 15:47:42Z christianlist $

... וניתן לסנן עם כלל זה:

^// \WId: .*\$

דוגמה 9. סנן הערות מספרי שורות בקבצי po

הערות מספרי שורות של po נראות כך:

#: src/filename.c:766

... וניתן לסנן עם כלל זה:

^#

4. שימוש במסנני החלפה

TBD

5. שימוש בתיבת הדו-שיח מסננים

סעיף זה מתאר את תיבת הדו-שיח מסננים, המספקת פונקציות ליצירה וניהול של מסנני קבצים ומסנני שורות.

כדי לפתוח את תיבת הדו-שיח מסננים, השתמש באחת מהשיטות הבאות:

בתיבת הדו-שיח בחר קבצים או תיקיות, לחץ על בחר מימין לשדה מסנן. אתה משתמש בשיטה זו כשאתה רוצה להחיל מסנן קבצים על פעולת השוואת תיקיות.
לחץ על כלים → מסננים. ניתן להשתמש בשיטה זו בכל עת, למעט כאשר תיבת הדו-שיח בחר קבצים או תיקיות פתוחה.

בתיבת הדו-שיח מסננים יש כרטיסייה לכל סוג של מסנן WinMerge:

מסנני קבצים: בחר כרטיסייה זו כדי לעבוד עם מסנני קבצים עבור פעולות השוואת תיקיות.
מסנני שורות: בחר כרטיסייה זו כדי לעבוד עם מסנני שורות עבור פעולות השוואת קבצים.
מסנני החלפה: בחר כרטיסייה זו כדי לעבוד עם מסנני החלפה עבור פעולות השוואת קבצים.

5.1. שימוש בכרטיסייה מסנני קבצים

החלק העיקרי של כרטיסייה זו הוא רשימה של מסנני קבצים הזמינים עבור פעולות השוואת תיקיות. הרשימה כוללת מסנני קבצים משותפים, פרטיים ומוגדרים ש-WinMerge מכיר, כמתואר ב-סעיף 2.1, “מיקומי מסנני קבצים”.

5.1.1. הפעלה והשבתה של מסנני קבצים

עליך להפעיל מסנן קבצים כדי להפוך אותו לזמין בפעולת השוואת תיקיות, או להשבית מסנן נוכחי כדי למנוע את השימוש בו:

פתח את תיבת הדו-שיח מסננים, אם היא עדיין לא פתוחה.
בחר מסנן קבצים או <ללא> מהרשימה.
לחץ על אישור כדי לסגור את תיבת הדו-שיח מסננים.

ישנן מספר דרכים להחיל מסנני קבצים לאחר הפעלתם. לפרטים, ראה סעיף 2.2, “החלת מסנני קבצים”.

5.1.2. הגדרת מסנני קבצים

השתמש בלחצנים אלה כדי לנהל את רשימת מסנני קבצים שלך וליצור מסנני קבצים חדשים:

בדוק: בחר מסנן קבצים ברשימה ולחץ על בדוק כדי לראות במהירות כיצד המסנן עובד. ראה סעיף 5.1.4, “בדיקת כללי מסנן קבצים” לפרטים.
התקן: מאפשר לך לאתר מסנן קבצים ומוסיף אותו לרשימת המסננים. מסנני קבצים שאינם בתיקייה המשותפת או הפרטית המוגדרת כברירת מחדל אינם מזוהים אלא אם אתה מתקין אותם.
חדש: יוצר עותק חדש של תבנית קבצים בתיקיות המסננים המשותפות או הפרטיות, ופותח אותו בעורך ברירת המחדל שלך. ערוך את התבנית והוסף את הכללים שלך, כמתואר ב-סעיף 5.1.3, “יצירת מסנן קבצים”.
ערוך: בחר מסנן קבצים ברשימה ולחץ על ערוך כדי לפתוח את הקובץ בעורך ברירת המחדל שלך.
מחק: בחר מסנן קבצים ברשימה ולחץ על מחק כדי למחוק את הקובץ ולהסיר אותו מהרשימה. כן, הקובץ באמת נמחק!

השינויים שלך נשמרים כשאתה לוחץ על אישור כדי לסגור את תיבת הדו-שיח מסננים. מסנני שורות מאוחסנים ברישום של Windows.

5.1.3. יצירת מסנן קבצים

אם מסנני הקבצים המותקנים עם WinMerge אינם מספקים את הסינון הדרוש לך, אתה יכול ליצור מסננים משלך:

לחץ על כלים → מסננים. או, מתיבת הדו-שיח בחר קבצים או תיקיות, לחץ על בחר מימין לשדה מסנן.
בכרטיסייה מסנני קבצים של תיבת הדו-שיח מסננים, לחץ על חדש.
בתיבת הדו-שיח מסנן משותף או פרטי, בחר מסנן משותף או מסנן פרטי (ראה סעיף 2.1, “מיקומי מסנני קבצים” לשימושים בהם) ולחץ על אישור.

תיבת הדו-שיח בחר שם קובץ למסנן חדש נפתחת בתיקיית הקבצים המשותפת או הפרטית במערכת שלך (אם התיקייה הפרטית אינה קיימת, WinMerge יוצר אותה).
בתיבת הדו-שיח בחר שם קובץ למסנן חדש, הזן שם קובץ חדש ולחץ על שמור.

שים לב

אל תבחר שם קובץ קיים: כדי לערוך קובץ קיים, חזור לשלב 2 ולחץ על ערוך במקום על חדש.

WinMerge מאתחל את הקובץ החדש עם התוכן של התבנית FileFilter.tmpl, ופותח אותו בעורך הטקסט המוגדר כברירת מחדל שלך.
פעל בהתאם להוראות התבנית כדי לערוך את התבנית, לעדכן את שם מציין המיקום והתיאור ולהוסיף כללי מסנן כמתואר ב-סעיף 2.3, “תחביר מסנן קבצים”. שמור את הקובץ בעורך הטקסט שלך.

עצה

אם אתה רוצה לבדוק במהירות כלל שאתה מגדיר, נסה ללחוץ על בדוק בתיבת הדו-שיח מסננים. ראה סעיף 5.1.4, “בדיקת כללי מסנן קבצים” לפרטים.
אם יצרת את מסנן הקבצים שלך באחת מתיקיות מסננים הסטנדרטיות, ותיבת הדו-שיח מסננים אינה מציגה את מסנן הקבצים החדש שלך, נסה ללחוץ על אישור כדי לסגור אותה, ואז לחץ על כלים → מסננים שוב כדי לפתוח אותה מחדש. רשימת מסנני קבצים צריכה לכלול כעת את מסנן הקבצים החדש.

אם שמרת את הקובץ במיקום חלופי במערכת הקבצים שלך), WinMerge לא יכול לזהות אותו אלא אם אתה מתקין אותו. כדי להפוך מסנן קבצים לניתן לזיהוי בכל מקום במערכת שלך:
1. לחץ על התקן בתיבת הדו-שיח מסננים.
2. בתיבת הדו-שיח אתר קובץ מסנן להתקנה, נווט לקובץ flt במערכת שלך ולחץ על פתח. רשימת מסנני הקבצים צריכה לכלול כעת את מסנן הקבצים המותקן.

5.1.4. בדיקת כללי מסנן קבצים

השתמש בתיבת הדו-שיח בדוק מסנן כדי לבדוק במהירות מסנן קבצים כנגד נתוני דוגמה, כדי לעזור לך לפתח כללים חדשים או כדי להבין כיצד כללים קיימים עובדים. זה יכול להיות קל יותר מאשר הפעלת פעולת השוואה מלאה.

החל מתיבת הדו-שיח מסננים:

בכרטיסייה מסנני קבצים, בחר את מסנן הקבצים שברצונך לבדוק.
אם אתה רוצה לראות את הכללים שאתה הולך לבדוק, לחץ על ערוך עכשיו כדי לפתוח את הקובץ כדי שתוכל לצפות בו במהלך השלבים הבאים.
לחץ על בדוק.
בתיבת הדו-שיח בדוק מסנן, בחר את סוג הכלל לבדיקה:
- כדי לבדוק כלל קובץ f: במסנן הקבצים שלך, בטל את הסימון של האפשרות שם תיקייה.
- כדי לבדוק כלל תיקייה d:, סמן את האפשרות שם תיקייה.
הזן את הטקסט לבדיקה.

הטקסט צריך להיות מתאים לסוג הכלל שאתה בודק. לדוגמה, אם סימנת את האפשרות שם תיקייה, סביר להניח שתרצה להזין שם תיקייה, כגון \temp.

התיבה תוצאה מציגה את הערך שהזנת, ואחריו את הסטטוס שלו: עבר או נכשל.

5.2. שימוש בכרטיסייה מסנני שורות

השתמש בכרטיסייה זו כדי להגדיר ולהפעיל מסנני שורות עבור פעולות השוואת קבצים. הכרטיסייה כוללת רשימה של כללים. כל כלל מכיל ביטוי רגולרי יחיד. אתה יכול להחיל כל שילוב של כללים מהרשימה על השוואת קבצים.

5.2.1. הגדרת מסנני שורות

מתחת לרשימת ביטויים רגולריים יש תיבת עריכה ולחצנים שבהם תוכל להשתמש כדי לתחזק את הרשימה בכל עת על ידי הוספה, עריכה והסרה של כללים.

כדי להוסיף כלל חדש:

לחץ על חדש. סמן העריכה שלך מופעל אוטומטית בתיבת העריכה.
הזן ביטוי בתיבת העריכה שמתחת לרשימת ביטויים רגולריים.
לחץ על שמור כדי לטעון את הביטוי בשורה חדשה ברשימה.

כדי לערוך כלל קיים:

בחר את השורה ולחץ על ערוך.
ערוך את הביטוי בתיבת העריכה.
לחץ על שמור כשסיימת.

כדי למחוק כלל קיים, בחר (סמן) את הכלל ולחץ על הסר.

5.2.2. הפעלה והשבתה של מסנני שורות

ברשימת ביטויים רגולריים, סמן רק את המסננים שברצונך להחיל ובטל את הסימון של כל המסננים שאינך רוצה להחיל.
סמן או בטל את הסימון של האפשרות אפשר מסנני שורות. אם תפעיל סינון, כל הכללים המסומנים כעת ברשימת ביטוי רגולרי ישמשו. אם הסינון כבוי, לא ישמשו כללים גם אם הם מסומנים.
לחץ על אישור כדי לסגור את תיבת הדו-שיח מסננים ולשמור את ההגדרות שלך.

ישנן מספר דרכים להחיל מסנני קבצים לאחר הפעלתם. לפרטים, ראה סעיף 3.1, “החלת מסנני שורות”.

5.3. שימוש בכרטיסייה מסנני החלפה

TBD

5.3.1. הגדרת מסנני החלפה

TBD

5.3.2. הפעלה והשבתה של מסנני החלפה

TBD

6. קבלת עזרה בביטויים רגולריים

ביטויים רגולריים יכולים להיות מורכבים מאוד. למרבה המזל, רוב מסנני הקבצים ב-WinMerge כוללים ביטויי סיומת פשוטים, כפי שמוצג בדוגמאות בנושא זה. קבצי המסנן המותקנים עם WinMerge כוללים דוגמאות שימושיות רבות אחרות.

לבסוף, ישנם משאבים רבים באינטרנט לעזרה ב-regexps, כולל אתרים אלה:

אתר טוב המוקדש ל-regexps:: https://www.regular-expressions.info/
הדרכה:: http://www.zvon.org/comp/r/tut-Regexp.html
עיון מהיר ב-PDF:: https://github.com/GordonMcKinney/gist-assets/raw/master/regex.pdf

הקודם		הבא
תוספים	ראשי	שורת פקודה