בורר

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

מתי להשתמש

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

התחלה מהירה

קלטים ופלטים

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

הפלטים נבחרים ונותרים מכסים יחד תמיד את כל פריטי הקלט, ואף פריט לא נמצא בשניהם. רכיב בורר מחלק לפי מיקום ולא לפי ערך, ולכן פריטים כפולים מגיעים לצד הנכון. למשל, עם a, b, a, c וטווח מ-2 עד 3, בפלט נבחרים יהיו b, a ובפלט נותרים יהיו a, c.

מצבים

פריט

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

טווח

הערכים בשדות מ־ ועד כלולים בטווח, והספירה מתחילה מ-1. ערך שלילי בשדה צעד הולך אחורה, מערך גבוה יותר בשדה מ־ לערך נמוך יותר בשדה עד. הפריטים שנבחרו שומרים על הסדר המקורי של הרשימה: ברשימה a, b, c, d, טווח מ-last עד 1 עם צעד -2 בוחר את b, d. צעד 0 נחשב כ-1. טווח שהולך קדימה עם צעד שלילי, או אחורה עם צעד חיובי, לא בוחר אף פריט.

רשימה

בשדה ביטוי אפשר לשלב מיקומים בודדים וטווחים, מופרדים בפסיקים, למשל 1, 3..5, last. הפריטים שנבחרו שומרים על הסדר המקורי של הרשימה, בלי קשר לסדר שבו כתבתם אותם, ומיקום שכתוב פעמיים נבחר פעם אחת. דוגמאות נוספות: 1..5, 1..10:2 לכל פריט שני ו-1..last-1 לכל הפריטים חוץ מהאחרון. כשאי אפשר לפענח חלק מהביטוי, הרכיב בוחר את כל הפריטים.

אקראי

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

מודולו

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

תנאי

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

מפתח בשם

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

שימוש בערך מרכיב אחר

ארבעה שדות מקבלים תווית של רכיב אחר בסוגריים מסולסלים, כגון {CharacterName}. כשרכיב בורר רץ, הסוגריים מוחלפים בערך של אותו רכיב.

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

כשהגדרה שגויה

רכיב בורר אף פעם לא עוצר תהליך בגלל הגדרה. לכל בעיה יש תוצאה בטוחה:

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

בורר או הגדרת חיבור

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

ראו את הדף רשימות ואצוות לכל מצבי החיבור.

קרדיטים

רכיב בורר לא עולה כלום, בכל מהדורה.

טיפים

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