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
-1
pResult
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.