Strings

This section describes the string functions and explains how to use them in your applications.

In This Section

Name	Description
About Strings	Discusses the string functions.
About Strsafe.h	Discusses the string functions in Strsafe.h.
String Reference	Contains the API reference.

String Functions

Name	Description
CharLower	Converts a character string or a single character to lowercase. If the operand is a character string, the function converts the characters in place.
CharLowerBuff	Converts uppercase characters in a buffer to lowercase characters. The function converts the characters in place.
CharNext	Retrieves a pointer to the next character in a string. This function can handle strings consisting of either single- or multi-byte characters.
CharNextExA	Retrieves the pointer to the next character in a string. This function can handle strings consisting of either single- or multi-byte characters.
CharPrev	Retrieves a pointer to the preceding character in a string. This function can handle strings consisting of either single- or multi-byte characters.
CharPrevExA	Retrieves the pointer to the preceding character in a string. This function can handle strings consisting of either single- or multi-byte characters.
CharToOem	Translates a string into the OEM-defined character set.
CharToOemBuff	Translates a specified number of characters in a string into the OEM-defined character set.
CharUpper	Converts a character string or a single character to uppercase. If the operand is a character string, the function converts the characters in place.
CharUpperBuff	Converts lowercase characters in a buffer to uppercase characters. The function converts the characters in place.
CompareString	Compares two character strings, using the specified locale. Note: For compatibility with Unicode, use CompareStringEx or the Unicode version of CompareString.
CompareStringEx	Compares two Unicode (wide character) strings, using the specified locale.
FoldString	Maps one string to another, performing a specified transformation option.
GetStringTypeA	Retrieves character-type information for the characters in the specified source string. For each character in the string, the function sets one or more bits in the corresponding 16-bit element of the output array. Each bit identifies a given character type, such as whether the character is a letter, a digit, or neither.
GetStringTypeEx	Retrieves character-type information for the characters in the specified source string. For each character in the string, the function sets one or more bits in the corresponding 16-bit element of the output array. Each bit identifies a given character type, such as whether the character is a letter, a digit, or neither. Unlike its close relatives GetStringTypeA and GetStringTypeW, GetStringTypeEx exhibits standard behavior through the use of the #define UNICODE switch. It is the recommended function.
GetStringTypeW	Retrieves character-type information for the characters in the specified source string. For each character in the string, the function sets one or more bits in the corresponding 16-bit element of the output array. Each bit identifies a given character type, such as whether the character is a letter, a digit, or neither.
IsCharAlpha	Determines whether a character is an alphabetical character. This determination is based on the semantics of the language selected by the user during setup or through Control Panel.
IsCharAlphaNumeric	Determines whether a character is either an alphabetical or a numeric character. This determination is based on the semantics of the language selected by the user during setup or through Control Panel.
IsCharLower	Determines whether a character is lowercase. This determination is based on the semantics of the language selected by the user during setup or through Control Panel.
IsCharUpper	Determines whether a character is uppercase. This determination is based on the semantics of the language selected by the user during setup or through Control Panel.
LoadString	Loads a string resource from the executable file associated with a specified module, copies the string into a buffer, and appends a terminating NULL character.
lstrcat	Appends one string to another.
lstrcmp	Compares two character strings. The comparison is case-sensitive.
lstrcmpi	Compares two character strings. The comparison is not case-sensitive.
lstrcpy	Copies a string to a buffer.
lstrcpyn	Copies a specified number of characters from a source string into a buffer.
lstrlen	Determines the length of the specified string (not including the terminating null character).
OemToChar	Translates a string from the OEM-defined character set into either an ANSI or a wide-character string.
OemToCharBuff	Translates a specified number of characters in a string from the OEM-defined character set into either an ANSI or a wide-character string.
wsprintf	Writes formatted data to the specified buffer.
wvsprintf	Writes formatted data to the specified buffer using a pointer to a list of arguments.

Strsafe Functions

Name	Description
StringCbCat	Concatenates one string to another string.
StringCbCatEx	Concatenates one string to another string.
StringCbCatN	Concatenates the specified number of bytes from one string to another string.
StringCbCatNEx	Concatenates the specified number of bytes from one string to another string.
StringCbCopy	Copies one string to another.
StringCbCopyEx	Copies one string to another.
StringCbCopyN	Copies the specified number of bytes from one string to another.
StringCbCopyNEx	Copies the specified number of bytes from one string to another.
StringCbGets	Gets one line of text from stdin, up to and including the newline character ('\n').
StringCbGetsEx	Gets one line of text from stdin, up to and including the newline character ('\n').
StringCbLength	Determines whether a string exceeds the specified length, in bytes.
StringCbPrintf	Writes formatted data to the specified string.
StringCbPrintfEx	Writes formatted data to the specified string.
StringCbVPrintf	Writes formatted data to the specified string using a pointer to a list of arguments.
StringCbVPrintfEx	Writes formatted data to the specified string using a pointer to a list of arguments.
StringCchCat	Concatenates one string to another string.
StringCchCatEx	Concatenates one string to another string.
StringCchCatN	Concatenates the specified number of characters from one string to another string.
StringCchCatNEx	Concatenates the specified number of characters from one string to another string.
StringCchCopy	Copies one string to another.
StringCchCopyEx	Copies one string to another.
StringCchCopyN	Copies the specified number of characters from one string to another.
StringCchCopyNEx	Copies the specified number of characters from one string to another.
StringCchGets	Gets one line of text from stdin, up to and including the newline character ('\n').
StringCchGetsEx	Gets one line of text from stdin, up to and including the newline character ('\n').
StringCchLength	Determines whether a string exceeds the specified length, in characters.
StringCchPrintf	Writes formatted data to the specified string.
StringCchPrintfEx	Writes formatted data to the specified string.
StringCchVPrintf	Writes formatted data to the specified string using a pointer to a list of arguments.
StringCchVPrintfEx	Writes formatted data to the specified string using a pointer to a list of arguments.