Shell String Handling Functions

CharLowerWrapW

Converts a Unicode character string or a single character to lowercase. If the operand is a character string, the function converts the characters in place.

Note  CharLowerWrapW is a wrapper for the CharLowerW function. See the CharLower page for further usage notes.

Note  CharLowerWrapW is available for use in Windows XP. It may not be available in subsequent versions. You should use CharLowerW in its place.

CharUpperBuffWrapW

Converts lowercase characters in a buffer to uppercase characters. The function converts the characters in place.

Note  CharUpperBuffWrapW is a wrapper for the CharUpperBuffW function. See the CharUpperBuff page for further usage notes.

Note  CharUpperBuffWrapW is available for use in Windows XP. It may not be available in subsequent versions. You should use CharUpperBuffW in its place.

ChrCmpI

Performs a comparison between two characters. The comparison is not case-sensitive.

CompareStringWrapW

Compares two Unicode character strings, using a specified locale.

Note  CompareStringWrapW is a wrapper for the CompareStringW function. See the CompareString page for further usage notes.

Note  CompareStringWrapW is available for use in Windows XP. It will not be available in subsequent versions. You should use CompareStringW in its place.

GetAcceptLanguages

Retrieves a string used with websites when specifying language preferences.

GetDateFormatWrapW

Formats a date as a date string for a specified locale. The function formats either a specified date or the local system date.

Note  GetDateFormatWrapW is a wrapper for the GetDateFormatW function. See the GetDateFormat page for further usage notes.

Note  GetDateFormatWrapW is available for use in Windows XP. It will not be available in subsequent versions. You should use GetDateFormatW in its place.

GetTimeFormatWrapW

Formats time as a time string for a specified locale. The function formats either a specified time or the local system time.

Note  GetTimeFormatWrapW is a wrapper for the GetTimeFormatW function. See the GetTimeFormat page for further usage notes.

Note  GetTimeFormatWrapW is available for use in Windows XP. It may not be available in subsequent versions. You should use GetTimeFormatW in its place.

IntlStrEqN

Performs a case-sensitive comparison of a specified number of characters from the beginning of two localized strings.

IntlStrEqNI

Performs a case-insensitive comparison of a specified number of characters from the beginning of two localized strings.

IntlStrEqWorker

Compares a specified number of characters from the beginning of two localized strings.

IsCharAlphaNumericWrapW

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.

Note  IsCharAlphaNumericWrapW is a wrapper for the IsCharAlphaNumericW function. See the IsCharAlphaNumeric page for further usage notes.

Note  IsCharAlphaNumericWrapW is available for use in Windows XP. It will not be available in subsequent versions. You should use IsCharAlphaNumericW in its place.

IsCharSpace

Determines whether a character represents a space.

OutputDebugStringWrapW

Sends a Unicode string to the debugger for display.

Note   OutputDebugStringWrapW is a wrapper for the OutputDebugStringW function. See the OutputDebugString page for further usage notes.

Note  This function is available for use in Windows XP. It may not be available in subsequent versions. Use OutputDebugStringW in its place.

SHLoadIndirectString

Extracts the string from the specified resource when given an indirect string (a string beginning with the @ symbol). All other strings copy to the output buffer unaltered.

SHStrDup

Makes a copy of a string in newly allocated memory.

StrCat

Appends one string to another.

Note  Do not use. See Remarks for alternative functions.

StrCatBuff

Copies and appends characters from one string to the end of another.

Note  Do not use. See Remarks for alternative functions.

StrCatChainW

Concatenates two Unicode strings. Used when repeated concatenations to the same buffer are required.

StrChr

Searches a string for the first occurrence of a character that matches the specified character. The comparison is case-sensitive.

StrChrI

Searches a string for the first occurrence of a character that matches the specified character. The comparison is not case-sensitive.

StrChrNIW

Searches a string for the first occurrence of a specified character. The comparison is not case-sensitive.

StrChrNW

Searches a string for the first occurrence of a specified character. The comparison is case-sensitive.

StrCmp

Compares two strings to determine if they are the same. The comparison is case-sensitive.

StrCmpC

Compares strings using C run-time (ASCII) collation rules. The comparison is case-sensitive.

StrCmpI

Compares two strings to determine if they are the same. The comparison is not case-sensitive.

StrCmpIC

Compares two strings using C run-time (ASCII) collation rules. The comparison is not case-sensitive.

StrCmpLogicalW

Compares two Unicode strings. Digits in the strings are considered as numerical content rather than text. This test is not case-sensitive.

StrCmpN

Compares a specified number of characters from the beginning of two strings to determine if they are the same. The comparison is case-sensitive. The StrNCmp macro differs from this function in name only.

StrCmpNC

Compares a specified number of characters from the beginning of two strings using C run-time (ASCII) collation rules. The comparison is case-sensitive.

StrCmpNI

Compares a specified number of characters from the beginning of two strings to determine if they are the same. The comparison is not case-sensitive. The StrNCmpI macro differs from this function in name only.

StrCmpNIC

Compares a specified number of characters from the beginning of two strings using C run-time (ASCII) collation rules. The comparison is not case-sensitive.

StrCpy

Copies one string to another.

Note  Do not use. See Remarks for alternative functions.

StrCpyN

Copies a specified number of characters from the beginning of one string to another.

Note  Do not use this function or the StrNCpy macro. See Remarks for alternative functions.

StrCSpn

Searches a string for the first occurrence of any of a group of characters. The search method is case-sensitive, and the terminating NULL character is included within the search pattern match.

StrCSpnI

Searches a string for the first occurrence of any of a group of characters. The search method is not case-sensitive, and the terminating NULL character is included within the search pattern match.

StrDup

Duplicates a string.

StrFormatByteSize64

Converts a numeric value into a string that represents the number expressed as a size value in bytes, kilobytes, megabytes, or gigabytes, depending on the size.

StrFormatByteSizeA

Converts a numeric value into a string that represents the number expressed as a size value in bytes, kilobytes, megabytes, or gigabytes, depending on the size. Differs from StrFormatByteSizeW in one parameter type.

StrFormatByteSizeEx

Converts a numeric value into a string that represents the number in bytes, kilobytes, megabytes, or gigabytes, depending on the size. Extends StrFormatByteSizeW by offering the option to round to the nearest displayed digit or to discard undisplayed digits.

StrFormatByteSizeW

Converts a numeric value into a string that represents the number expressed as a size value in bytes, kilobytes, megabytes, or gigabytes, depending on the size. Differs from StrFormatByteSizeA in one parameter type.

StrFormatKBSize

Converts a numeric value into a string that represents the number expressed as a size value in kilobytes.

StrFromTimeInterval

Converts a time interval, specified in milliseconds, to a string.

StrIsIntlEqual

Compares a specified number of characters from the beginning of two strings to determine if they are equal.

StrNCat

Appends a specified number of characters from the beginning of one string to the end of another.

Note  Do not use this function or the StrCatN macro. See Remarks for alternative functions.

StrPBrk

Searches a string for the first occurrence of a character contained in a specified buffer. This search does not include the terminating null character.

StrRChr

Searches a string for the last occurrence of a specified character. The comparison is case-sensitive.

StrRChrI

Searches a string for the last occurrence of a specified character. The comparison is not case-sensitive.

StrRetToBSTR

Accepts a STRRET structure returned by IShellFolder::GetDisplayNameOf that contains or points to a string, and returns that string as a BSTR.

StrRetToBuf

Converts an STRRET structure returned by IShellFolder::GetDisplayNameOf to a string, and places the result in a buffer.

StrRetToStr

Takes an STRRET structure returned by IShellFolder::GetDisplayNameOf and returns a pointer to an allocated string containing the display name.

StrRetToStrN

Takes an STRRET structure returned by IShellFolder::GetDisplayNameOf, converts it to a string, and places the result in a buffer.

StrRStrI

Searches for the last occurrence of a specified substring within a string. The comparison is not case-sensitive.

StrSpn

Obtains the length of a substring within a string that consists entirely of characters contained in a specified buffer.

StrStr

Finds the first occurrence of a substring within a string. The comparison is case-sensitive.

StrStrI

Finds the first occurrence of a substring within a string. The comparison is not case-sensitive.

StrToInt

Converts a string that represents a decimal value to an integer. The StrToLong macro is identical to this function.

StrToInt64Ex

Converts a string representing a decimal or hexadecimal value to a 64-bit integer.

StrToIntEx

Converts a string representing a decimal or hexadecimal number to an integer.

StrTrim

Removes specified leading and trailing characters from a string.

wnsprintf

Takes a variable-length argument list and returns the values of the arguments as a printf-style formatted string.

Note  Do not use this function. See Remarks for alternative functions.

wvnsprintf

Takes a list of arguments and returns the values of the arguments as a printf-style formatted string.

Note  Do not use this function. See Remarks for alternative functions.