פונקציית SCAN‏

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

דוגמאות לשימוש

‎SCAN(5, A1:A3, LAMBDA(accumulator, current_value, accumulator+current_value))‏

‎SCAN(2, A1:A3, LAMBDA(accumulator, current_value, accumulator*current_value))‏

תחביר

SCAN(first_value, array_or_range, LAMBDA)‏

  • initial_value: הערך הראשוני מסוג accumulator.‏
  • array_or_range: מערך או טווח שייסרקו.
  • LAMBDA: פונקציית LAMBDA שתחול על כל ערך ב-array_or_range כדי לסרוק אותו.
    • תחביר: ‎LAMBDA(name1, name2, formula_expression)
    • דרישות:
      • ל-LAMBDA חייבים להיות בדיוק 2 ארגומנטי name, וגם formula_expression (ביטוי נוסחה) שמשתמש ב-names האלה. כאשר מחילים את פונקציית LAMBDA, ‏name1 נהייה תואם לערך הנוכחי שב-accumulator ו-name2 נהייה תואם ל-current_value שב-array_or_range. ה-accumulator מעודכן בכל שלב לערך הביניים שהתקבל בשלב הקודם.

הערות

  • פונקציית LAMBDA המועברת צריכה לקבל בדיוק 2 ארגומנטי name, אחרת תוחזר השגיאה ‎#N/A.‏ הארגומנטים האלה תואמים ל-accumulator ול-current_value, לפי הסדר. הם מוסברים כך:
    • name1: נהייה תואם לערך שב-accumulator.
    • name2: נהייה תואם ל-current_value במערך הקלט.
  • ה-accumulator מופעל על ידי initial_value ומעודכן בכל שלב לערך הביניים שהתקבל בשלב הקודם.
  • בזמן שמחילים את LAMBDA, ניתן למצוא את ה-current_value שורה אחר שורה במערך הקלט.

  • אפשר להעביר פונקציה בעלת שם לפרמטר LAMBDA והיא תתפקד כמו LAMBDA במקרה הזה. מידע נוסף על פונקציות בעלות שם
    • התחביר של הפונקציה בעלת השם חייב להיות תואם לתחביר של LAMBDA ל-SCAN, עם בדיוק 2 placeholders לארגומנטים שמוגדרים לה.
    • אין להוסיף סוגריים אחרי הפונקציה בעלת השם.

דוגמאות

החזרת הסכום הכולל של מערך

נתונים לדוגמה:

 

A

1

4

2

2

3

1

דוגמה: ‎=SCAN(5, A1:A3, LAMBDA(accumulator, current_value, accumulator+current_value))‏ 


תוצאה:

9

11

12

החזרת האחוז המצטבר של הערך הכולל

נתונים לדוגמה:

 

A

1

4

2

2

3

1

דוגמה: ‎=SCAN(0, A1:A3, LAMBDA(accumulator, current_value, accumulator + Current_value/SUM(A1:A3)))

תוצאה:

0.57

0.85

1

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

יצירת עותק

נתונים לדוגמה:

 

A

1

4

2

2

3

1

4

0

5

3

6

6

דוגמה: ‎=SCAN(0, A1:A6, RUNNING_TOTAL_0)‏

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

הגדרת הנוסחה: ‎=if(current_value=0, Current_value, accumulator+current_value), כאשר accumulator ו-current_value הם placeholders לארגומנטים שהוגדרו עבור RUNNING_TOTAL_0.


תוצאה:

4

6

7

0

3

9

שגיאות נפוצות

ב-LAMBDA המועברת אין בדיוק 2 ארגומנטי name

אם לפונקציית LAMBDA אין 2 ארגומנטי name, מתרחשת השגיאה הבאה:

"מספר הארגומנטים ל-LAMBDA שגוי. היו אמורים להתקבל 3 ארגומנטים ובפועל התקבלו 2."

דוגמה: ‎=SCAN(5, C1:C4, LAMBDA(current_value, current_value+1))‏

בדוגמה הזו, פונקציית LAMBDA קיבלה רק ארגומנט name אחד, כשהיה צורך ב-2.

הפרמטר האחרון של SCAN לא היה LAMBDA

אם הפרמטר האחרון של פונקציית SCAN לא היה פונקציית LAMBDA, מתרחשת השגיאה הבאה:

"הארגומנט חייב להיות LAMBDA."

דוגמה: ‎=SCAN(5, C1:C4, 3)‏

בדוגמה הזו, הפונקציה האחרונה היא 3, במקום פונקציית LAMBDA.

פונקציית LAMBDA שהועברה ל-SCAN הייתה שגויה

אם ארגומנט name אחד או יותר אינו תקני, מתרחשת השגיאה הבאה:

"ארגומנט אחד של פונקציית LAMBDA אינו שם תקני."

דוגמה: ‎=SCAN(5, C1:C4, LAMBDA(C1, v, C1+v))‏

בדוגמה הזו, C1 הוא name לא תקני כי הוא מתנגש עם טווח.

ערך ביניים אחד או יותר שנוצר על ידי ההחלה של LAMBDA אינו ערך בודד

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

"היה אמור להתקבל ערך בודד. אין תמיכה בתוצאות של מערך בתוך מערך."

דוגמה: ‎=SCAN(5, C1:C4, LAMBDA(accumulator, value, {accumulator, value}))‏

כל החלה של LAMBDA חייבת לייצר ערך ביניים שהוא ערך בודד בלבד ולא מערך אחר.

ראו בנוסף

true
Visit the Learning Center

Using Google products, like Google Docs, at work or school? Try powerful tips, tutorials, and templates. Learn to work on Office files without installing Office, create dynamic project plans and team calendars, auto-organize your inbox, and more.

חיפוש
ניקוי החיפוש
סגירת החיפוש
התפריט הראשי
11192116395392232779
true
חיפוש במרכז העזרה
true
true
true
true
true
35
false
false