Developer Reference

  • 2020
  • 10/21/2020
  • Public Content
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
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!

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