החזרת משתנה (מספר שלם) המציין את התוצאה של ביטוי מחרוזת.
תחביר
StrComp ( string1, string2 [, compare ] )
תחביר הפונקציה StrComp מכיל את הארגומנטים הבאים:
|
ארגומנט |
תיאור |
|
מחרוזת1 |
נדרש. כל ביטוי מחרוזת חוקי. |
|
מחרוזת 2 |
נדרש. כל ביטוי מחרוזת חוקי. |
|
להשוות |
אופציונלי. מציין את סוג השוואת המחרוזת. אם ערך ארגומנט הוא Null, תתרחש שגיאה. אם compare מושמט, ההגדרה Option Compare קובעת את סוג ההשוואה. |
הגדרות
הגדרות ארגומנט ההשוואה הן:
|
קבוע |
Value |
תיאור |
|
vbBinaryCompare |
0 |
ביצוע השוואה בינארית. |
|
vbTextCompare |
1 |
ביצוע השוואה טקסטואלית. |
|
vbDatabaseCompare |
2 |
Microsoft Office Access 2007 בלבד. ביצוע השוואה בהתבסס על מידע במסד הנתונים שלך. |
ערכי החזרה
הפונקציה StrComp מכילה את ערכי ההחזרה הבאים:
|
אם |
הפונקציה StrComp מחזירה |
|
string1 קטן מ- string2 |
-1 |
|
string1 שווה ל- string2 |
0 |
|
string1 גדול מ- string2 |
1 |
|
string1 או string2 הוא Null |
Null |
דוגמה לשאילתה
|
Expression |
תוצאות |
|
SELECT ProductSales.ProductID, StrComp(ProductID,"PRO_XYZ10") AS ComparisonResult FROM ProductSales; |
הפונקציה מחזירה את הערכים מהשדות "ProductID", משווה את הערכים ב- "ProductID" ל- "PRO_XYZ1" ומחזירה את התוצאות בעמודה ComparisonResult. "ProductID" שווה ל- "PRO_XYZ10", הפונקציה StrComp תחזיר 0. אם "ProductID" קטן מ- "PRO_XYZ10", הפונקציה StrComp תחזיר -1. אם "ProductID" גדול מ- "PRO_XYZ10", הפונקציה StrComp תחזיר 1. אם "ProductID" או "PRO_XYZ10" הוא NULL, הפונקציה StrComp תחזיר NULL. |
דוגמה ל- VBA
הערה: הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications (VBA).
דוגמה זו משתמשת בפונקציה StrComp כדי להחזיר את התוצאות של השוואת מחרוזות. אם הארגומנט השלישי הוא 1, מתבצעת השוואה טקסטואלית; אם הארגומנט השלישי הוא 0 או מושמט, מתבצעת השוואה בינארית.
Dim MyStr1, MyStr2, MyComp
MyStr1 = "ABCD": MyStr2 = "abcd" ' Define variables.
MyComp = StrComp(MyStr1, MyStr2, 1) ' Returns 0.
MyComp = StrComp(MyStr1, MyStr2, 0) ' Returns -1.
MyComp = StrComp(MyStr2, MyStr1) ' Returns 1.
