TAHA
10-29-2009, 12:24 AM
String API
1- تابع CharLower
هدف: از اين تابع براي تبديل يك حرف به حرف كوچك استفاده ميشود. ورودي اين تابع يك كاراكتر و خروجي آن نيز يك كاراكتر مي باشد.
پارامترها : lpsz : اين پارامتر از نوع String مي باشد كه از نوع ختم به null ميباشد و به همين دليل در VB بصورت ByVal بيان شده است.
خروجي تابع : از نوع رشته بوده String
فراخواني در VB :
Private Declare Function CharLower Lib "user32" Alias "CharLowerA" (ByVal lpsz As String) As String
2- تابع CharUpper
هدف: از اين تابع براي تبديل يك حرف به حرف بزرگ استفاده ميشود. ورودي اين تابع يك كاراكتر و خروجي آن نيز يك كاراكتر مي باشد.
پارامترها : lpsz : اين پارامتر از نوع String مي باشد كه از نوع ختم به null ميباشد و به همين دليل در VB بصورت ByVal بيان شده است.
خروجي تابع : از نوع رشته بوده String
فراخواني در VB :
Private Declare Function CharUpper Lib "user32" Alias "CharUpperA" (ByVal lpsz As String) As String
3- تابع CompareString
هدف: از اين تابع براي مقايسه دو رشته با امكانات مختلف مي توان استفاده كرد.
پارامترها : Locale : اين پارامتر براي تعيين نوع مقايسه به كار ميرود و دو حالت دارد:
LOCALE_SYSTEM_DEFAULT : كه برابر با مقدار عددي H400 ميباشد و پيشفرض سيستم ميباشد.
LOCALE_USER_DEFAULT : كه برابر با مقدار عددي H800 ميباشد و پيش فرض تعريف شده توسط كاربر ميباشد. اين پيشفرض ميتواند با ماكروي MakeLCID توليد شود.
dwCmpflags : از اين پارامتر براي تعيين نوع مقايسه استفاده ميشود و پيشفرضي ندارد اين پارامتر شامل شش حالت است :
1- NORM_IGNORECASE : كه برابر مقدار عددي H1 ميباشد. تابع به بزرگي و كوچكي حروف توجه نميكند.
2- NORM_NIGNOREKANATYPE : كه برابر با مقدار عددي H10000 ميباشد. تابع به بزرگي و كوچكي حروف توجه ميكند.
3- NORM_IGNORENONSPACE : كه برابر با مقدار عددي H2 ميباشد. Space يا Blank عامل مقايسه ميباشد. هر چه Blank بيشتر باشد آن رشته كوچكتر است از رشته اي كه Blnak كمتري دارد.
4- NORM_IGNORESYMBOLS : كه برابر با مقدار عددي H4 ميباشد. علائم (% و # و $ و ^ و & و ...) داراي ارزشي در مقايسه نخواهند بود. در حقيقت تابع فرض ميكند كه آنها وجود ندارند.
5- NORM_IGNOREWIDTH : كه برابر با مقدار عددي H20000 ميباشد. تابع هيچ تفاوتي بين كاراكترهاي يك بيتي و دو بيتي قائل نميشود.
6- SORT_STRINGSORT : كه برابر با مقدار عددي H1000 ميباشد. علاوه بر اينكه بزرگ و كوچكي حروف اهميت دارند، علائم هم اهميت دارند.
lpString1 : از نوع رشته است كه همان رشته اول مقايسه است.
cchcount1 : برابر با طول رشته اول (lpString1) ميباشد.
lpString2 : از نوع رشته است كه همان رشته دوم مقايسه است.
cchcount2 : برابر با طول رشته دوم (lpString2) ميباشد.
خروجي تابع : از نوع عدد Integer ميباشد كه سه حالت دارد :
CSTR_LESSTHAN : برابر با مقدار عددي يك ميباشد و مفهوم آن اينست كه رشته اول از رشته دوم كوچكتر است.
CSTR_EQUAL : كه برابر با مقدار عددي 2 ميباشد و مفهوم آن اينست كه رشته اول و رشته دوم با هم برابرند.
CSTR_GREATERTHAN : كه برابر با مقدار عددي 3 ميباشد و مفهوم آن اينست كه رشته اول از رشته دوم بزرگتر است.
فراخواني در VB :
Public Declare Function CompareString Lib "kernel32" Alias "CompareStringA" (ByVal Locale As Long, ByVal dwCmpFlags As Long, ByVal lpString1 As String, ByVal cchCount1 As Long, ByVal lpString2 As String, ByVal cchCount2 As Long) As Long
4- تابع IsCharAlpha
هدف: اين تابع تشخيص ميدهد كه كاراكتري كه به آن فرستاده شده است جزو حروف است يا خير.
پارامترها : cChar : اين پارامتر از نوع Char مي باشد و در حقيقت كاراكتري است كه مورد آزمايش قرار ميگيرد. اين متغير در VB از نوع Byte ميباشد. چون VB متغيري از نوع Char ندارد. به همين دليل كد Ascii كاراكتر به تابع فرستاده مي شود.
خروجي تابع : از نوع Boolean بوده و دو حالت دارد:
True : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف الفبايي ميباشد.
False : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف الفبايي نميباشد.
فراخواني در VB :
Public Declare Function IsCharAlpha Lib "user32" Alias "IsCharAlphaA" (ByVal cChar As Byte) As Long
5- تابع IsCharAlphaNumeric
هدف: اين تابع تشخيص ميدهد كه كاراكتري كه به آن فرستاده شده است جزو حروف و عدد است يا خير.
پارامترها : cChar : اين پارامتر از نوع Char مي باشد و در حقيقت كاراكتري است كه مورد آزمايش قرار ميگيرد. اين متغير در VB از نوع Byte ميباشد. چون VB متغيري از نوع Char ندارد. به همين دليل كد Ascii كاراكتر به تابع فرستاده مي شود.
خروجي تابع : از نوع Boolean بوده و دو حالت دارد:
True : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف ويا اعداد ميباشد.
False : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف ويا اعداد نميباشد.
فراخواني در VB :
Public Declare Function IsCharAlphaNumeric Lib "user32" Alias "IsCharAlphaNumericA" (ByVal cChar As Byte) As Long
6- تابع IsCharLower
هدف: اين تابع مشخص ميكند كاراكتري كه به آن فرستاده شده است جزو حروف كوچك است يا خير.
پارامترها : cChar : اين پارامتر از نوع Char مي باشد و در حقيقت كاراكتري است كه مورد آزمايش قرار ميگيرد. اين متغير در VB از نوع Byte ميباشد. چون VB متغيري از نوع Char ندارد. به همين دليل كد Ascii كاراكتر به تابع فرستاده مي شود.
خروجي تابع : از نوع Boolean بوده و دو حالت دارد:
True : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف كوچك ميباشد.
False : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف كوچك نميباشد.
فراخواني در VB :
Public Declare Function IsCharLower Lib "user32" Alias "IsCharLowerA" (ByVal cChar As Byte) As Long
7- تابع IsCharUpper
هدف: اين تابع مشخص ميكند كاراكتري كه به آن فرستاده شده است جزو حروف بزرگ است يا خير.
پارامترها : cChar : اين پارامتر از نوع Char مي باشد و در حقيقت كاراكتري است كه مورد آزمايش قرار ميگيرد. اين متغير در VB از نوع Byte ميباشد. چون VB متغيري از نوع Char ندارد. به همين دليل كد Ascii كاراكتر به تابع فرستاده مي شود.
خروجي تابع : از نوع Boolean بوده و دو حالت دارد:
True : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف بزرگ ميباشد.
False : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف بزرگ نميباشد.
فراخواني در VB :
Public Declare Function IsCharUpper Lib "user32" Alias "IsCharUpperA" (ByVal cChar As Byte) As Long
8- تابع LStrCmp
هدف: اين تابع دو رشته كه به آن فرستاده ميشود را از نظر الگوي Case Sensitive با هم مقايسه ميكند.
پارامترها :
lpString1: اين پارامتر يك متغير از نوع String بوده و همان رشته اول مورد مقايسه است.
lpString2 : اين پارامتر يك متغير از نوع String بوده و همان رشته دوم مورد مقايسه است.
خروجي تابع : خروجي اين تابع يك عدد از نوع Integer ميباشد كه سه حالت دارد:
1-: مشخص ميكند كه رشته اول از رشته دوم كوچكتر است.
0 : مشخص ميكند كه رشته اول با رشته دوم برابر است.
1 : مشخص ميكند كه رشته اول از رشته دوم بزرگتر است.
فراخواني در VB :
Public Declare Function lstrcmp Lib "kernel32" Alias "lstrcmpA" (ByVal lpString1 As String, ByVal lpString2 As String) As Long
9- تابع lStrLen
هدف: اين تابع طول رشته اي كه به آن فرستاده شده را برميگرداند.
پارامترها :
lpString: اين پارامتر يك متغير از نوع String بوده و در حقيقت رشته اي است كه بايد طولش محاسبه شود.
خروجي تابع : خروجي اين تابع يك عدد از نوع Integer ميباشد كه طول رشته است.
فراخواني در VB :
Public Declare Function lstrlen Lib "kernel32" Alias "lstrlenA" (ByVal lpString As String) As Long
1- تابع CharLower
هدف: از اين تابع براي تبديل يك حرف به حرف كوچك استفاده ميشود. ورودي اين تابع يك كاراكتر و خروجي آن نيز يك كاراكتر مي باشد.
پارامترها : lpsz : اين پارامتر از نوع String مي باشد كه از نوع ختم به null ميباشد و به همين دليل در VB بصورت ByVal بيان شده است.
خروجي تابع : از نوع رشته بوده String
فراخواني در VB :
Private Declare Function CharLower Lib "user32" Alias "CharLowerA" (ByVal lpsz As String) As String
2- تابع CharUpper
هدف: از اين تابع براي تبديل يك حرف به حرف بزرگ استفاده ميشود. ورودي اين تابع يك كاراكتر و خروجي آن نيز يك كاراكتر مي باشد.
پارامترها : lpsz : اين پارامتر از نوع String مي باشد كه از نوع ختم به null ميباشد و به همين دليل در VB بصورت ByVal بيان شده است.
خروجي تابع : از نوع رشته بوده String
فراخواني در VB :
Private Declare Function CharUpper Lib "user32" Alias "CharUpperA" (ByVal lpsz As String) As String
3- تابع CompareString
هدف: از اين تابع براي مقايسه دو رشته با امكانات مختلف مي توان استفاده كرد.
پارامترها : Locale : اين پارامتر براي تعيين نوع مقايسه به كار ميرود و دو حالت دارد:
LOCALE_SYSTEM_DEFAULT : كه برابر با مقدار عددي H400 ميباشد و پيشفرض سيستم ميباشد.
LOCALE_USER_DEFAULT : كه برابر با مقدار عددي H800 ميباشد و پيش فرض تعريف شده توسط كاربر ميباشد. اين پيشفرض ميتواند با ماكروي MakeLCID توليد شود.
dwCmpflags : از اين پارامتر براي تعيين نوع مقايسه استفاده ميشود و پيشفرضي ندارد اين پارامتر شامل شش حالت است :
1- NORM_IGNORECASE : كه برابر مقدار عددي H1 ميباشد. تابع به بزرگي و كوچكي حروف توجه نميكند.
2- NORM_NIGNOREKANATYPE : كه برابر با مقدار عددي H10000 ميباشد. تابع به بزرگي و كوچكي حروف توجه ميكند.
3- NORM_IGNORENONSPACE : كه برابر با مقدار عددي H2 ميباشد. Space يا Blank عامل مقايسه ميباشد. هر چه Blank بيشتر باشد آن رشته كوچكتر است از رشته اي كه Blnak كمتري دارد.
4- NORM_IGNORESYMBOLS : كه برابر با مقدار عددي H4 ميباشد. علائم (% و # و $ و ^ و & و ...) داراي ارزشي در مقايسه نخواهند بود. در حقيقت تابع فرض ميكند كه آنها وجود ندارند.
5- NORM_IGNOREWIDTH : كه برابر با مقدار عددي H20000 ميباشد. تابع هيچ تفاوتي بين كاراكترهاي يك بيتي و دو بيتي قائل نميشود.
6- SORT_STRINGSORT : كه برابر با مقدار عددي H1000 ميباشد. علاوه بر اينكه بزرگ و كوچكي حروف اهميت دارند، علائم هم اهميت دارند.
lpString1 : از نوع رشته است كه همان رشته اول مقايسه است.
cchcount1 : برابر با طول رشته اول (lpString1) ميباشد.
lpString2 : از نوع رشته است كه همان رشته دوم مقايسه است.
cchcount2 : برابر با طول رشته دوم (lpString2) ميباشد.
خروجي تابع : از نوع عدد Integer ميباشد كه سه حالت دارد :
CSTR_LESSTHAN : برابر با مقدار عددي يك ميباشد و مفهوم آن اينست كه رشته اول از رشته دوم كوچكتر است.
CSTR_EQUAL : كه برابر با مقدار عددي 2 ميباشد و مفهوم آن اينست كه رشته اول و رشته دوم با هم برابرند.
CSTR_GREATERTHAN : كه برابر با مقدار عددي 3 ميباشد و مفهوم آن اينست كه رشته اول از رشته دوم بزرگتر است.
فراخواني در VB :
Public Declare Function CompareString Lib "kernel32" Alias "CompareStringA" (ByVal Locale As Long, ByVal dwCmpFlags As Long, ByVal lpString1 As String, ByVal cchCount1 As Long, ByVal lpString2 As String, ByVal cchCount2 As Long) As Long
4- تابع IsCharAlpha
هدف: اين تابع تشخيص ميدهد كه كاراكتري كه به آن فرستاده شده است جزو حروف است يا خير.
پارامترها : cChar : اين پارامتر از نوع Char مي باشد و در حقيقت كاراكتري است كه مورد آزمايش قرار ميگيرد. اين متغير در VB از نوع Byte ميباشد. چون VB متغيري از نوع Char ندارد. به همين دليل كد Ascii كاراكتر به تابع فرستاده مي شود.
خروجي تابع : از نوع Boolean بوده و دو حالت دارد:
True : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف الفبايي ميباشد.
False : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف الفبايي نميباشد.
فراخواني در VB :
Public Declare Function IsCharAlpha Lib "user32" Alias "IsCharAlphaA" (ByVal cChar As Byte) As Long
5- تابع IsCharAlphaNumeric
هدف: اين تابع تشخيص ميدهد كه كاراكتري كه به آن فرستاده شده است جزو حروف و عدد است يا خير.
پارامترها : cChar : اين پارامتر از نوع Char مي باشد و در حقيقت كاراكتري است كه مورد آزمايش قرار ميگيرد. اين متغير در VB از نوع Byte ميباشد. چون VB متغيري از نوع Char ندارد. به همين دليل كد Ascii كاراكتر به تابع فرستاده مي شود.
خروجي تابع : از نوع Boolean بوده و دو حالت دارد:
True : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف ويا اعداد ميباشد.
False : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف ويا اعداد نميباشد.
فراخواني در VB :
Public Declare Function IsCharAlphaNumeric Lib "user32" Alias "IsCharAlphaNumericA" (ByVal cChar As Byte) As Long
6- تابع IsCharLower
هدف: اين تابع مشخص ميكند كاراكتري كه به آن فرستاده شده است جزو حروف كوچك است يا خير.
پارامترها : cChar : اين پارامتر از نوع Char مي باشد و در حقيقت كاراكتري است كه مورد آزمايش قرار ميگيرد. اين متغير در VB از نوع Byte ميباشد. چون VB متغيري از نوع Char ندارد. به همين دليل كد Ascii كاراكتر به تابع فرستاده مي شود.
خروجي تابع : از نوع Boolean بوده و دو حالت دارد:
True : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف كوچك ميباشد.
False : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف كوچك نميباشد.
فراخواني در VB :
Public Declare Function IsCharLower Lib "user32" Alias "IsCharLowerA" (ByVal cChar As Byte) As Long
7- تابع IsCharUpper
هدف: اين تابع مشخص ميكند كاراكتري كه به آن فرستاده شده است جزو حروف بزرگ است يا خير.
پارامترها : cChar : اين پارامتر از نوع Char مي باشد و در حقيقت كاراكتري است كه مورد آزمايش قرار ميگيرد. اين متغير در VB از نوع Byte ميباشد. چون VB متغيري از نوع Char ندارد. به همين دليل كد Ascii كاراكتر به تابع فرستاده مي شود.
خروجي تابع : از نوع Boolean بوده و دو حالت دارد:
True : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف بزرگ ميباشد.
False : مشخص ميكند كه كاراكتر فرستاده شده به تابع جزو حروف بزرگ نميباشد.
فراخواني در VB :
Public Declare Function IsCharUpper Lib "user32" Alias "IsCharUpperA" (ByVal cChar As Byte) As Long
8- تابع LStrCmp
هدف: اين تابع دو رشته كه به آن فرستاده ميشود را از نظر الگوي Case Sensitive با هم مقايسه ميكند.
پارامترها :
lpString1: اين پارامتر يك متغير از نوع String بوده و همان رشته اول مورد مقايسه است.
lpString2 : اين پارامتر يك متغير از نوع String بوده و همان رشته دوم مورد مقايسه است.
خروجي تابع : خروجي اين تابع يك عدد از نوع Integer ميباشد كه سه حالت دارد:
1-: مشخص ميكند كه رشته اول از رشته دوم كوچكتر است.
0 : مشخص ميكند كه رشته اول با رشته دوم برابر است.
1 : مشخص ميكند كه رشته اول از رشته دوم بزرگتر است.
فراخواني در VB :
Public Declare Function lstrcmp Lib "kernel32" Alias "lstrcmpA" (ByVal lpString1 As String, ByVal lpString2 As String) As Long
9- تابع lStrLen
هدف: اين تابع طول رشته اي كه به آن فرستاده شده را برميگرداند.
پارامترها :
lpString: اين پارامتر يك متغير از نوع String بوده و در حقيقت رشته اي است كه بايد طولش محاسبه شود.
خروجي تابع : خروجي اين تابع يك عدد از نوع Integer ميباشد كه طول رشته است.
فراخواني در VB :
Public Declare Function lstrlen Lib "kernel32" Alias "lstrlenA" (ByVal lpString As String) As Long