Developer Reference

  • 2020
  • 07/15/2020
  • 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

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804