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