Shell String Handling Functions
This section describes the Windows Shell string handling functions. The programming elements explained in this documentation are exported by Shlwapi.dll and defined in Shlwapi.h and Shlwapi.lib.
In this section
| Topic | Description |
|---|---|
| ChrCmpI |
Performs a comparison between two characters. The comparison is not case-sensitive. |
| GetAcceptLanguages |
Retrieves a string used with websites when specifying language preferences. |
| 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. |
| IsCharSpace |
Determines whether a character represents a space. |
| SHLoadIndirectString |
Extracts a specified text resource when given that resource in the form of an indirect string (a string that begins with the '@' symbol). |
| 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. |