Strings

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

In This Section

NameDescription
About Strings

Discusses the string functions.

About Strsafe.h

Discusses the string functions in Strsafe.h.

String Reference

Contains the API reference.

 

String Functions

NameDescription
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

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

 

 

 

Community Additions

ADD
Show:
© 2014 Microsoft