החזרת מחרוזת שבה מחרוזת משנה שצוינה הוחלפה במחרוזת משנה אחרת מספר פעמים שצוין.
תחביר
Replace(expression, find, replace [, start ] [, count ] [, compare ] [, compare ] )
תחביר הפונקציה Replace מכיל את הארגומנטים הבאים:
| ארגומנט | תיאור |
|---|---|
| ביטוי | נדרש. ביטוי מחרוזת המכיל מחרוזת משנה להחלפה. |
| חיפוש | נדרש. מחרוזת משנה שמתבצע חיפוש. |
| החלפה | נדרש. מחרוזת משנה חלופית. |
| התחלה | אופציונלי. המיקום בתוך ביטוי שבו אמור להתחיל החיפוש של מחרוזת משנה. אם הוא מושמט, מניחים כי הערך 1. |
| ספירה | אופציונלי. מספר ההחלפות של מחרוזות משנה שיש לבצע. אם יושמט, ערך ברירת המחדל הוא –1, כלומר לבצע את כל ההחלפות האפשריות. |
| השווה | אופציונלי. ערך מספרי המציין את סוג ההשוואה שבה יש להשתמש בעת הערכת מחרוזות משנה. לערכים, עיין בסעיף 'הגדרות'. |
הגדרות
הארגומנט compare יכול להכיל את הערכים הבאים:
| קבוע | Value | תיאור |
|---|---|---|
| vbUseCompareOption | –1 | מבצע השוואה באמצעות ההגדרה של משפט Option Compare . |
| vbBinaryCompare | 0 | מבצעת השוואה בינארית. |
| vbTextCompare | 1 | מבצע השוואה טקסטואלית. |
| vbDatabaseCompare | 2 | Microsoft Office Access 2007 בלבד. מבצע השוואה בהתבסס על מידע במסד הנתונים. |
ערכי החזרה
הפונקציה Replace מחזירה את הערכים הבאים:
| אם | החזרות Replace |
|---|---|
| הביטוי הוא באורך אפס | מחרוזת באורך אפס ("") |
| expression is null | שגיאה. |
| החיפוש באורך אפס | עותק של ביטוי. |
| 'החלף ' באורך אפס | עותק של ביטוי עם הסרת כל מופעי החיפוש . |
| התחלה>Len(ביטוי) | מחרוזת באורך אפס. החלפת מיתרים מתחילה במיקום המצוין על ידי התחלה. |
| הספירה היא 0 | עותק של ביטוי. |
הערות
הערך המוחזר של הפונקציה Replace הוא מחרוזת, עם החלפות שבוצעו, המתחילה במיקום שצוין על-ידי התחלה ומסתיימת בסוף מחרוזת הביטוי . זה לא עותק של המחרוזת המקורית מההתחלה ועד הסוף.
דוגמה
| ביטוי | תוצאות |
|---|---|
| בחר ProductID, Replace(ProductID,"PRO","Product") AS ReplacedID מ-ProductSales; | החזרת "ProductID", איתור "PRO" ב- "ProductID" והחלפתו ב- "Product" והצגת התוצאה בעמודה ReplacedID. |