Visible to Intel only — GUID: GUID-6A522946-F44F-4678-BCF0-0AEFB3EE7988
Visible to Intel only — GUID: GUID-6A522946-F44F-4678-BCF0-0AEFB3EE7988
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
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!