החזרת מחרוזת שבה מחרוזת משנה שצוינה הוחלפה במחרוזת משנה אחרת מספר פעמים שצוין.
תחביר
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. |
