Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public
Document Table of 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

NOTE:
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.