Developer Reference

  • 2021
  • 03/26/2021
  • Public Content
Contents

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
len
elements of two strings
pSrc1
and
pSrc2
. The value
pResult
=
pSrc1
[
i
]-
pSrc2
[
i
]
is computed successively for each
i
-th element,
i
=0,...
len
-1
. When the first pair of non-matching elements occurs (that is, when
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
]
and negative when
pSrc1
[
i
]<
pSrc2
[
i
]
. If the strings are equal, the function returns
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 is
NULL
.
ippStsLengthErr
Indicates an error condition if
len
is 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.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.