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