חיפושים — מדריך

1. מה הסקריפט עושה

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

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

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

מריצים את הסקריפט בפקודה run file "zf.lib", והיא פותחת את תיבת השיחה. אפשר להשאיר את התיבה פתוחה ולהמשיך לעבוד. התיבה זוכרת את המקום שלה על המסך, ואת מה שכתבת בה בפעם האחרונה.

2. התחלה מהירה ↑ לתוכן

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

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

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

3. תיבת השיחה ↑ לתוכן

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

4. קובץ החיפושים ↑ לתוכן

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

(ג'וקרים)(מה לחפש)=()

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

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

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

()(משה)=()

()(אהרן)=()

(ד)(מרים)=()

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

הערות והסברים בתוך הקובץ

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

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

לבטל קטע שלם

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

()(משה)=()

התחל_דילוג

()(אהרן)=()

()(מרים)=()

סיים_דילוג

רק "משה" יחופש.

לחפש סוגריים

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

להקליד לוכסן הפוך, ומיד אחריו את הסוגר. בתג זה נראה $ ו-$: הלוכסן מימין, והסוגר משמאלו.
לכתוב את המספר של התו (ראו בהמשך): #40 ו-#41.

לכתוב תו לפי המספר שלו

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

קודים

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

חלוקת קובץ החיפושים לעמודים

כשרוצים לשמור בקובץ אחד כמה קבוצות של חיפושים, לשימושים שונים, מחלקים אותו לעמודים: עמוד לכל קבוצה. בשדה רק מעמודים כותבים את מספרי העמודים שרוצים להפעיל, וכל השאר לא יבוצעו. אפשר לכתוב כמה מספרים עם פסיקים, וגם טווח עם מקף. למשל, 2-4,7 מפעיל רק את השורות שבעמודים 2, 3, 4 ו-7. כשהשדה ריק, כל הקובץ פועל.

5. ג'וקרים — אפשרויות החיפוש ↑ לתוכן

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

עברית	אנגלית	מה זה עושה
*	*	מפעיל את התווים המיוחדים של תג, כמו `*` ו-`?` בתוך מה שמחפשים. בלי זה כל תו נחשב כמו שהוא.
א	c	מבחין בין אותיות גדולות לקטנות באנגלית.
ב	n	מתעלם מניקוד: מלך ימצא גם מילה מנוקדת.
ג	s	מתעלם מרווחים כפולים ומסוף שורה בין המילים.
ד	w	מילה שלמה: בית לא ימצא את "חבית" ולא את "ביתך".
ה	H	מתייחס לתכונות של האותיות (גופן, גודל וכו') בטקסט עברי. משתמשים בה יחד עם האותיות שבשורות הבאות.
ס	E	כמו ה, אבל לטקסט באנגלית.
ו	F	מדויק בגופן.
ז	S	מדויק בסוג האות: שמן, קו תחתי, נטוי, צבע.
ח	Z	מדויק בגודל.
ט	X	מדויק בהצרה.
—	/	מדויק בהטייה.
י	A	מדויק בפיזור.
כ	D	מדויק בגוף.
ל	U	מדויק בהרמה.
מ	L	מדויק בשפה.
נ	e	מדויק (בסקריפט ההחלפות: החלפה מדויקת).
ע	K	רווח קשיח, סרגל, הוספת גוף.
ף	o	ג'וקרים נוספים. ראו ג'וקרים נוספים.

לאותיות ו עד ל (תכונות האות) צריך להוסיף גם ה או ס. לאותיות מ, נ ו-ע לא צריך.

(בד)(מלך)=()

מוצא "מלך" כמילה שלמה, עם ניקוד או בלי.

סימנים מיוחדים בסוגריים הראשונים

סימן	משמעות
ר או &	שורת חובה: הקובץ יוצג רק אם השורה הזאת נמצאה בו. ראו סינון קבצים.
רר או &&	שורת איסור: הקובץ יוצג רק אם השורה הזאת לא נמצאה בו.
%	שליפה: כל מה שהשורה מוצאת נאסף לקובץ חדש. ראו שליפות.
ת	לשורה יש תנאים. ראו תנאים.
$	בסקריפט ההחלפות $ בתוך הסוגריים הראשונים מסמן שורה של פקודה להרצה, ולא שורת חיפוש. לפקודה אין משמעות בחיפוש, ולכן השורה לא מבוצעת, ובסוף החיפוש מתקבלת הודעה דולגו עם השורה. (זה שונה מ-$ בתחילת השורה, לפני הסוגריים הראשונים, שמבטל את השורה בשקט. ראו לבטל שורה זמנית.)
# ? + . ! : וספרות	יש להם משמעות בסקריפט ההחלפות, אבל לא כאן. הסקריפט מתעלם מהם, וכך אפשר להריץ קובץ החלפות בלי לשנות אותו.

6. התווים המיוחדים של תג ↑ לתוכן

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

תו	משמעות	דוגמה
*	כל רצף של תווים.	`א*ב` מוצא אב, אגב, ארנב.
?	תו אחד, כל תו שהוא.	`א?ב` מוצא אהב.
\|	או.	`משה\|אהרן` מוצא משה או אהרן.
[ ]	תו אחד מתוך קבוצה. עם `~` בהתחלה: תו שאינו בקבוצה.	`[0-9]` ספרה אחת. `[~א-ת]` כל מה שאינו אות.
< >	אפס או יותר תווים מתוך קבוצה.	`א<0-9>ב` מוצא אב, א0ב, א453ב.
<< >>	תו אחד או יותר מתוך קבוצה.	`<<0-9>>` מוצא מספר שלם.
_	קובע איזה חלק ממה שנמצא ייבחר ויוצג.	`רבי _משה_` מוצא "רבי משה", ומסמן רק את "משה".
\	מבטל את המשמעות המיוחדת של התו שאחריו.	`\*` מחפש כוכבית.

(*)( _-_ )=()

מוצא מקף שיש רווח משני צדדיו, ומסמן רק את המקף.

7. סינון קבצים: שורות חובה ואיסור ↑ לתוכן

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

בסוגריים הראשונים	משמעות
ר או &	הקובץ יוצג רק אם השורה הזאת נמצאה בו. כשהקובץ מוצג, גם המקומות שהשורה הזאת מצאה מוצגים ברשימת המופעים.
רר או &&	הקובץ יוצג רק אם השורה הזאת לא נמצאה בו. השורה הזאת עצמה לא מוצגת ברשימת המופעים (הרי אין מה להציג).

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

(ר)(שבת)=()

(רר)(חול)=()

()(קידוש)=()

יוצגו רק קבצים שיש בהם "שבת", אין בהם "חול", ויש בהם "קידוש".

אפשר לשלב עם ג'וקריםהאותיות ר ו-רר נכתבות יחד עם שאר האותיות, למשל (רד)(שבת)=(): שורת חובה, ו"שבת" כמילה שלמה.

8. שליפות ↑ לתוכן

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

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

עיצוב מה שנשלף — הסוגריים השלישיים

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

(*%)(<<0-9>> ש"ח)=(מחיר: %)

מוצא כל מספר שאחריו "ש"ח", וכותב בקובץ שליפות, למשל: מחיר: 150 ש"ח

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

9. תאי זיכרון ↑ לתוכן

כשאותו חלק חוזר בהרבה שורות חיפוש, אפשר להגדיר אותו פעם אחת בתא זיכרון, ולהשתמש בו בכל מקום. יש 100 תאים, מ-00 עד 99. גם כאן כותבים לפי סדר ההקלדה: את !ף01 מקלידים !, ף, 0, 1, ובתג ה-0 נראה מימין וה-1 משמאלו.

הגדרה

פיסקה בפני עצמה, בצורה הזאת:

(!ף01=א-ת)

מקלידים !ף, אחריו מספר התא בשתי ספרות, סימן =, ואחריו התוכן. אפשר לכתוב בתוכן גם תווים לפי המספר שלהם. הסדר לא משנה: אפשר להגדיר תא אחרי השורה שמשתמשת בו.

שימוש

כותבים !ף ומספר התא, בכל מקום שבו רוצים את התוכן שלו:

(!ף00=#13#32.,)

תא 00: סוף פיסקה, רווח, נקודה ופסיק — כל מה שיכול לבוא אחרי סוף מילה.

(!ף01=א-ת)

תא 01: כל האותיות.

(*)([!ף01]_[:.,?]_[!ף01])=()

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

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

10. ג'וקרים נוספים — למתקדמים ↑ לתוכן

כשכותבים ף או o בסוגריים הראשונים, לחמישה תווים יש משמעות מיוחדת בתוך מה שמחפשים:

תו	משמעות
$	תחילת עמוד
^	תחילת פיסקה
&	תחילת שורה
+	תחילת מילה
=	סוף מילה

(ף)(^משה)=()

מוצא "משה" רק בתחילת פיסקה.

אפשר לשנות את התווים האלה, ולהגדיר עוד הגדרות של החיפוש, בקובץ zf.ini, במחלקה [search_def]. המילים שאפשר לכתוב שם מוסברות בקובץ command.txt של תג. למשל:

1[search_def]

2bchar=0-9

11. תנאים ↑ לתוכן

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

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

שלב א: הגדרת התנאי

[שם התנאי](איפה לחפש)(ג'וקרים)(מה לחפש)

חלק	מה כותבים
[שם התנאי]	שם לבחירתך, בסוגריים מרובעים. כל מחרוזת שהיא, למשל `[אהרן_בפיסקה]`.
(איפה לחפש)	באיזה חלק של הטקסט, סביב המקום שנמצא, לבדוק את התנאי. ראו בטבלה הבאה.
(ג'וקרים)	אותן אותיות כמו בשורת חיפוש רגילה (ג'וקרים), ועוד אחת: ש הופכת את התנאי לשלילי — התנאי מתקיים רק אם הדבר לא נמצא.
(מה לחפש)	מה צריך להימצא (או לא להימצא) כדי שהתנאי יתקיים.

ב"איפה לחפש" מספיק לכתוב את האות הראשונה, או מילה שלמה. הסקריפט מסתכל רק על האות הראשונה:

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

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

שלב ב: שימוש בתנאי

בשורת החיפוש כותבים ת בסוגריים הראשונים, ואחרי הסוגריים השלישיים את שם התנאי, בסוגריים מרובעים:

[אהרן_בפיסקה](פיסקה)()(אהרן)

(ת)(משה)=()[אהרן_בפיסקה]

מוצא "משה" רק בפיסקאות שיש בהן גם "אהרן".

[בלי_אהרן](פיסקה)(ש)(אהרן)

(ת)(משה)=()[בלי_אהרן]

מוצא "משה" רק בפיסקאות שאין בהן "אהרן".

כמה תנאים יחד

כותבים	משמעות
`[א,ב]`	פסיק: וגם. שני התנאים צריכים להתקיים.
`[א\|ב]`	קו עומד: או. מספיק שאחד מהם מתקיים.
`[א\|ב,ג]`	(א או ב) וגם ג.
`[!א]`	סימן קריאה לפני השם הופך את התנאי, רק בשורה הזאת: תנאי רגיל נעשה שלילי, ותנאי שלילי נעשה רגיל.

אפשר לכתוב עד 10 שמות של תנאים בשורה אחת.

מתי תנאי נחשב "לא מתקיים"

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

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

12. תנאי בסקריפט חיצוני ↑ לתוכן

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

[חמישים_תווים]()(סקריפט)(a)

(ת)(משה)=()[חמישים_תווים]

מוצא "משה" רק בפיסקאות שיש בהן יותר מ-50 תווים.

בקובץ zf.ini, במחלקה [scripts], כותבים את הסקריפט עצמו:

1[scripts]

2a=if len(this para of zf_found) > 50 then zf_OK := true

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

משתנה	מה יש בו
`zf_found`	המקום שנמצא (בחירה בטקסט).
`zf_ptxt`	מצביע לטקסט שבו מחפשים.
`zf_OK`	התשובה. הסקריפט כותב בו `true` אם התנאי מתקיים. בהתחלה הוא `false`.

הסקריפט יכול להיות כמה שורות. מפרידים ביניהן ב-\r.
אפשר גם להריץ ממנו קובץ סקריפט שלם, למשל a=run file "50.prg".
גם כאן אפשר להפוך את התנאי עם ש בג'וקרים, או עם ! לפני השם.

13. איפה לחפש ↑ לתוכן

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

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

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

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

סינון שמות קבצים

בשדה שמות קבצים כותבים אילו קבצים לבדוק. * הוא כל רצף של תווים, ו-? הוא תו אחד. אפשר לכתוב כמה תבניות, מופרדות בנקודה ופסיק:

כותבים	נבדקים
`*.i`	כל קבצי תג. זו ברירת המחדל.
`ra*.i`	רק קבצים ששמם מתחיל ב-ra.
`*a.i;?.i`	קבצים ששמם נגמר ב-a, וגם קבצים ששמם אות אחת.

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

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

רשימה מקובץ

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

בכל שורה שם של קובץ אחד. אפשר לכתוב מסלול מלא, או רק שם. אם כתוב רק שם, הקובץ נלקח מהתיקייה הנוכחית.
אפשר לכתוב את השם בלי הסיומת .i.
סימן ; בשורה אומר שכל מה שאחריו, עד סוף השורה, הוא הערה.
סימן + לבדו בשורה עוצר את הקריאה: הקבצים שאחריו לא נבדקים.

1c:\tag\sfarim\breshit.i

2shmot ; from the current folder

4vaikra ; not checked

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

רק בקטע הבחור

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

14. מיון רשימת הקבצים ↑ לתוכן

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

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

15. תיבת תוצאות החיפוש ↑ לתוכן

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

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

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

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

16. תיבת המופעים ↑ לתוכן

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

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

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

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

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

17. הלחצנים ↑ לתוכן

לחצן	מה הוא עושה
חפש	מפעיל את החיפוש. בזמן החיפוש שורת המצב מראה כמה קבצים כבר נבדקו.
עצור	בזמן החיפוש הלחצן חפש הופך לעצור. לחיצה עוצרת את החיפוש, ומה שנמצא עד אותו רגע מוצג כרגיל.
`Ctrl` + חפש	מציג שוב את התוצאות של החיפוש הקודם, בלי לחפש מחדש. בשורה העליונה של תיבת התוצאות נוספת המילה שמור. שימושי אם סגרת את תיבת התוצאות ורוצה לחזור אליה.
חדש	יוצר קובץ חיפושים חדש. ראו התחלה מהירה.
צור קובץ רשימה	ראו רשימה מקובץ.
בדוק תחביר של קובץ החיפושים	ראו בדיקת תחביר.
צא	סוגר את התיבה, וגם את תיבות התוצאות והעזרה.
עזרה	עזרה קצרה בתוך תג.
`Ctrl` או `Shift` + עזרה	פותח את המדריך הזה בדפדפן. הקובץ `zf_help.html` צריך להיות בתיקייה הנוכחית של תג, או בתיקייה של תג.

18. בדיקת תחביר ↑ לתוכן

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

שלב א: שגיאה שתג לא מקבל

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

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

שלב ב: אזהרות

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

אזהרה	מה היא אומרת
שורה מתחילה עם סוגריים...	השורה נראית כמו שורת חיפוש, אבל משהו בה לא בנוי נכון, ולכן היא לא תבוצע. בדרך כלל חסר סוגר, או חסר הסימן =.
התנאי "..." לא הוגדר	בשורה יש שם של תנאי שאין לו הגדרה. כנראה טעות כתיב.
יש שימוש בתא זיכרון !ף.. שלא הוגדר	ראו תאי זיכרון.
סוגריים מסולסלות לא מאוזנות	מספר ה-`{` שונה ממספר ה-`}`.
יש "התחל_דילוג" ואין סגירה	חסר `סיים_דילוג`. כל השורות עד סוף הקובץ מדולגות.
יש "סיים_דילוג" בלי פתיחה	חסר `התחל_דילוג` לפניו.

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

בדיקה עם `Alt`

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

הבדיקה עם Alt משנה את קובץ החיפושיםה-$ בתחילת השורה מבטל אותה, והיא לא תבוצע יותר. אחרי שמתקנים שורה, חייבים למחוק את ה-$ שבתחילתה.

19. הגדרות בקובץ zf.ini ↑ לתוכן

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

1[netunim]

2max_show=20

3max_res=1000

5[search_def]

6bchar=0-9

8[scripts]

9a=if len(this para of zf_found) > 50 then zf_OK := true

הגדרה	משמעות
`max_show`	כמה שורות מוצגות בכל דף של תיבת התוצאות ושל תיבת המופעים. ברירת המחדל 20, והמקסימום 100. מספר גדול יותר מאט את פתיחת התיבות.
`max_res`	כמה מופעים לכל היותר נספרים בכל קובץ, לכל שורת חיפוש, וכמה מופעים לכל היותר מוצגים בתיבת המופעים. ברירת המחדל והמקסימום: 1000.
`[search_def]`	הגדרות של הג'וקרים הנוספים.
`[scripts]`	סקריפטים של תנאים חיצוניים.

קובץ החיפושים בתיקייה של תג

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

1func f()

2 global int "zf_haf_can_be_in_tag_dir"

3end func

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

20. הודעות ופתרון בעיות ↑ לתוכן

ההודעה או התופעה	הסיבה והפתרון
"לא ניתן שם של קובץ החיפושים"	השדה קובץ החיפושים ריק. בוחרים קובץ, או לוחצים חדש.
"חסר קובץ החיפושים"	הקובץ שבשדה לא פתוח, ולא נמצא בתיקייה הנוכחית. פותחים אותו, או בודקים את השם. ראו גם קובץ החיפושים בתיקייה של תג.
"לא נמצאו שורות חיפוש בקובץ"	אין בקובץ אף שורה במבנה הנכון, או שכל השורות דולגו (בגלל רק מעמודים, $ או קטע דילוג). כדאי להריץ בדיקת תחביר.
"צריך קובץ פתוח"	נבחר בקובץ זה, ואין קובץ פתוח.
"לא עובד על קובץ החיפושים עצמו"	הקובץ הפעיל הוא קובץ החיפושים. עוברים לקובץ שרוצים לחפש בו, ולוחצים שוב.
"קודם הרץ רב-טקסט ובצע פתיחת קבצים"	נבחר קבצי רב-טקסט, אבל רב-טקסט לא פתוח.
"לא ניתן שם קובץ רשימה" · "לא מוצא קובץ רשימה"	נבחר רשימה מקובץ, והשדה קובץ רשימה ריק, או שהקובץ לא קיים.
"לא נוצרה רשימת הקבצים של התיקייה"	לא ניתן היה לקרוא את התיקייה. בודקים שהתיקייה קיימת, ושהשם בשדה תיקייה לחיפוש נכון.
"בקובץ החיפושים כבר יש קוד סגנון של סוגריים"	הסקריפט משתמש בעצמו בקודי סגנון בשם ( ו-), כדי לטפל ב-`$` וב-`$`. אם יש קודים כאלה בקובץ החיפושים, מוחקים אותם.
"לא נמצאו תוצאות"	שום שורה לא נמצאה באף קובץ. בודקים את שמות קבצים, את איפה לחפש, ואת רק בקטע הבחור.
"דולגו:" ורשימת שמות	שורות עם $ בסוגריים הראשונים, או קבצים שלא הצליחו להיפתח. השאר בוצע כרגיל.
"לא ניתן לפתוח את הקובץ"	בלחיצה על קובץ בתיבת התוצאות: הקובץ נמחק, הועבר, או שתג לא מצליח לפתוח אותו.
"לא נמצאו מופעים בקובץ"	הקובץ השתנה מאז החיפוש, ומה שנמצא בו כבר לא שם.
קובץ שאני יודע שיש בו תוצאה לא מופיע	בודקים שהשם שלו מתאים לשמות קבצים, ושאין שורה עם ר או רר שמסננת אותו החוצה.
מילה שקיימת בטקסט לא נמצאת	אולי יש באמצע המילה קוד, ניקוד (ואז מוסיפים ב), או רווח כפול (ואז מוסיפים ג). ראו ג'וקרים.
תנאי לא עושה כלום	חסר ת בסוגריים הראשונים, או שיש טעות בשם התנאי. בדיקת התחביר מזהירה על שם שלא הוגדר.

חיפושים — מדריך מורחב. העזרה הקצרה שבתוך תג (הלחצן עזרה) מכילה את עיקרי הדברים בתמצית. לחיצה על עזרה עם Ctrl או Shift פותחת את המדריך הזה.