strcmp
Description:
Function strcmp compares two strings to see if they are the same.
This function name starts with a lowercase letter. |
|
Parameters:
(const string1[], const string2[], bool:ignorecase = false, length = cellmax)
string | string1 | The first string to compare. |
string | string2 | The second string to compare. |
bool | ignorecase | When set to true, the case doesn't matter - HeLLo is the same as Hello. When false, they're not the same. |
int | length | When this length is set, the first x chars will be compared - doing "Hello" and "Hell No" with a length of 4 will say it's the same string. |
Return Values:
- 0 if strings match each other on given length;
- 1 or -1 if some character do not match: string1[i] - string2[i] ('i' represents character index starting from 0);
- difference in number of characters if one string matches only part of another string.
Examples:
new string1[] = "Hello World"; new string2[] = "Hello World"; // Check if the strings are the same if(!strcmp(string1, string2)) new string3[] = "Hell"; // Check if the first 4 characters match if(!strcmp(string2, string3, false, 4)) // Check for null strings with isnull() if(!strcmp(string1, string2) && !isnull(string1) && !isnull(string2)) // Definition for isnull(): #if !defined isnull #define isnull(%1) ((!(%1[0])) || (((%1[0]) == '\1') && (!(%1[1])))) #endif
Related Functions
The following functions may be useful, as they are related to this function in one way or another.
- strlen: Get the length of a string.
- strpack: Pack a string. Packed strings use 75% less memory.
- strunpack: Unpack a string.
- strcat: Concatenates (joins together) two strings into the destination string.
- strmid: Extract a range of characters from a string.
- strins: Insert a string into another string.
- strdel: Delete part of a string.
- strfind: Search for a sub string in a string.
- strval: Convert a string to an integer.
- valstr: Convert an integer into a string.
- ispacked: Checks if the given string is packed.
- uudecode: Decode an UU-encoded string.
- uuencode: Encode a string to an UU-decoded string.
- memcpy: Copy bytes from one location to another.