Compare
Compare
DEPRECATED. Compares two strings of the fixed length.
Syntax
IppStatus ippsCompare_8u(const Ipp8u*
pSrc1
, const Ipp8u*
pSrc2
, int
len
, int*
pResult
);
Include Files
ippch.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
Parameters
- pSrc1
- Pointer to the first source string.
- pSrc2
- Pointer to the second source string.
- len
- Maximum number of elements to be compared.
- pResult
- Pointer to the result.
Description
This function is deprecated and will be removed in a future release. If you have concerns, open a ticket and provide feedback at
https://supporttickets.intel.com/.
This function compares first is computed successively for each . When the first pair of non-matching elements occurs (that is, when and negative when . If the strings are equal, the function returns
len
elements of two strings pSrc1
and pSrc2
. The value pResult
= pSrc1
[i
]- pSrc2
[i
]i
-th element, i
=0,...len
-1pResult
is not equal to zero), the function stops operation and returns the value pResult
. The returned value is positive when pSrc1
[i
]> pSrc2
[i
]pSrc1
[i
]< pSrc2
[i
]pResult
= 0. The comparison is case-sensitive.Return Values
- ippStsNoErr
- Indicates no error.
- ippStsNullPtrErr
- Indicates an error condition if at least one of the specified pointers isNULL.
- ippStsLengthErr
- Indicates an error condition iflenis negative.
Example
The code example below shows how to use the function
ippsCompare_8u
.Ipp8u string0[] = "These functions compare two strings"; Ipp8u string1[] = "These FUNCTIONS compare two strings"; int result; ippsCompare_8u( string0, string1, sizeof (string0) - 1, &result ); printf ( "ippsCompare_8u said: " ); printf ( "string0 is %s string1.\n", (result < 0) ? "less than" : ((result > 0) ? "greater than" : "equal to") ); ippsCompareIgnoreCaseLatin_8u( string0, string1, sizeof (string0) - 1, &result ); printf ( "ippsCompareIgnoreCaseLatin_8u said: " ); printf ( "string0 is %s string1.\n", (result < 0) ? "less than" : ((result > 0) ? "greater than" : "equal to") ); Output: ippsCompare_8u said: string0 is greater than string1. ippsCompareIgnoreCaseLatin_8u said: string0 is equal to string1.