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

ID 790148
Date 3/22/2024
Public
Document Table of Contents

Lowercase, LowercaseLatin

DEPRECATED. Converts alphabetic characters of a string to all lowercase symbols.

Syntax

IppStatus ippsLowercaseLatin_8u(const Ipp8u* pSrc, Ipp8u* pDst, int len);

IppStatus ippsLowercaseLatin_8u_I(Ipp8u* pSrcDst, int len);

Include Files

ippch.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

pSrc

Pointer to the source string.

pDst

Pointer to the destination string.

pSrcDst

Pointer to the source and destination string for the in-place operation.

len

Number of elements in the string.

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/.

These functions convert each alphabetic character of the source string pSrc to lower case and store the result in pDst.

The in-place flavors of these functions convert each alphabetic character of the source string pSrcDst to lower case and store the result in pSrcDst.

The function ippsLowercase operates with Unicode characters. The function ippsLowercaseLatin operates with ASCII characters.

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 ippsLowercaseLatin_8u_I.

 Ipp8u string[] = "These Functions Vary the Case!";
 ippsLowercaseLatin_8u_I( string, sizeof (string) - 1 );
 printf ( "Lower: %s\n", (char*)string );
 ippsUppercaseLatin_8u_I( string, sizeof (string) - 1 );
 printf ( "Upper: %s\n", (char*)string );

Result:

 Lower: these functions vary the case!
 Upper: THESE FUNCTIONS VARY THE CASE!