הפונקציות Replace ו- Substitute‏

חל על: יישומי בד ציור Dataverse עמודות נוסחה זרימות שולחן עבודה יישומים מונחי-דגמים Power Pages Power Platform CLI

מחליפה חלק במחרוזת טקסט במחרוזת אחרת.

Description

הפונקציה Replace מזהה את הטקסט המיועד להחלפה לפי המיקום ההתחלתי והאורך.

הפונקציה Substitute מזהה את הטקסט להחלפה על-ידי התאמת מחרוזת. אם נמצאה יותר מהתאמה אחת, ניתן להחליף את כולן או לציין התאמה אחת להחלפה.

אם אתה מעביר מחרוזת יחידה, ערך ההחזרה הוא המחרוזת שהשתנתה. אם אתה מעביר טבלה בעלת עמודה יחידה המכילה מחרוזות, ערך ההחזרה הוא טבלה בעלת עמודה יחידה עם העמודה ערך של מחרוזות שהשתנו. אם יש לך טבלה מרובת עמודות, באפשרותך לעצב אותה לטבלה בעלת עמודה יחידה, כפי שמתאר הנושא עבודה עם טבלאות.

תחביר

Replace( String, StartingPosition, NumberOfCharacters, NewString )

• String - נדרש. המחרוזת שיש לפעול בה.
• StartingPosition - נדרש. מיקום תו כדי להתחיל בהחלפה. התו הראשון של מחרוזת הוא במיקום 1.
• NumberOfCharacters - נדרש. מספר התווים שיש להחליף במחרוזת.
• NewString - נדרש. המחרוזת החלופית. מספר התווים בארגומנט זה עשוי להיות שונה מהארגומנט NumberOfCharacters.

Substitute( String, OldString, NewString [, InstanceNumber ] )

• String - נדרש. המחרוזת שיש לפעול בה.
• OldString - נדרש. המחרוזת שיש להחליף.
• NewString - נדרש. המחרוזת החלופית. OldString ו- NewString עשויים להיות בעלי אורכים שונים.
• InstanceNumber - אופציונלי. השתמש בארגומנט זה כדי לציין איזה מופע של OldString יש להחליף אם String מכיל יותר ממופע אחד. אם לא תציין ארגומנט זה, כל המופעים יוחלפו.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

• SingleColumnTable - נדרש. טבלת מחרוזות בעלת עמודה יחידה שיש לפעול בה.
• StartingPosition - נדרש. מיקום תו כדי להתחיל בהחלפה. התו הראשון של כל מחרוזת בטבלה הוא במיקום 1.
• NumberOfCharacters - נדרש. מספר התווים שיש להחליף בכל מחרוזת.
• NewString - נדרש. המחרוזת החלופית. מספר התווים בארגומנט זה עשוי להיות שונה מהארגומנט NumberOfCharacters.

Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

• SingleColumnTable - נדרש. טבלת מחרוזות בעלת עמודה יחידה שיש לפעול בה.
• OldString - נדרש. המחרוזת שיש להחליף.
• NewString - נדרש. המחרוזת החלופית. OldString ו- NewString עשויים להיות בעלי אורכים שונים.
• InstanceNumber - אופציונלי. השתמש בארגומנט זה כדי לציין איזה מופע של OldString יש להחליף אם String מכיל יותר ממופע אחד. אם לא תציין ארגומנט זה, כל המופעים יוחלפו.

דוגמאות

נוסחה	תיאור	תוצאה
Replace( "abcdefghijk",6,5,"*" )	מחליף את חמשת התווים ב- "abcdefghijk" בתו "*" יחיד, החל מהתו השישי ("f").	"abcde*k"
Replace( "2019", 3, 2, "20" )	מחליף את שני התווים האחרונים של "2019" ב- "20".	"2020"
Replace( "123456", 1, 3, "_" )	מחליף את שלושת התווים הראשונים של "123456" בתו "_" יחיד.	"_456"
Substitute( "Sales Data", "Sales", "Cost" )	מחליף את המחרוזת "עלות" ב"מכירות".	"Cost Data"
Substitute( "Quarter 1, 2018", "1", "2", 1 )	מחליף רק את המופע הראשון של "1" ב- "2" מכיוון שהארגומנט הרביעי (InstanceNumber) מסופק עם 1.	"Quarter 2, 2018"
Substitute( "Quarter 1, 2011", "1", "2", 3 )	מחליף רק את המופע השלישי של "1" ב- "2" מכיוון שהארגומנט הרביעי (InstanceNumber) מסופק עם 3.	"Quarter 1, 2012"
Substitute( "Quarter 1, 2011", "1", "2" )	מחליף את כל המופעים של "1" ב- "2" מכיוון שהארגומנט הרביעי (InstanceNumber) אינו מסופק.	"Quarter 2, 2022"
Replace( [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" )	מחליף את התו התשיעי בכל רשומה בטבלה בעלת העמודה היחידה ב- "3".	טבלה של עמודה אחת עם עמודה Value המכילה את הערכים הבאים: [ "Quarter 3, 2018", "Quarter 3, 2011", "Quarter 3, 2019" ]
תחליף( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 )	מכיוון שהארגומנט הרביעי (InstanceNumber) מסופק עם ערך 1, מחליף רק את המופע הראשון של "1" בכל רשומה בטבלה בעלת העמודה היחידה ב- "3".	טבלה של עמודה אחת עם עמודה Value המכילה את הערכים הבאים: [ "Qtr 3, 2018", "Quarter 3, 2011", "Q3,2019"]
תחליף( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" )	מכיוון שהארגומנט הרביעי (InstanceNumber) אינו מסופק, מחליף את כל המופעים של "1" בכל רשומה בטבלה בעלת העמודה היחידה ב- "3".	טבלה של עמודה אחת עם עמודה Value המכילה את הערכים הבאים: [ "Qtr 3, 2038", "Quarter 3, 2033", "Q3,2039"]