String Manipulation (CRT)

These routines operate on null-terminated single-byte character, wide-character, and multibyte-character strings. Use the buffer-manipulation routines, described in Buffer Manipulation, to work with character arrays that do not end with a null character.

String-Manipulation Routines

Routine	Use	.NET Framework equivalent
strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l, _stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l, _strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l, _strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l	Compare two character strings using code page information (_mbsicoll and _mbsnicoll are case-insensitive)	System::String::Compare
_mbsdec, _mbsdec_l, _strdec, _wcsdec	Move string pointer back one character	Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.
_mbsinc, _mbsinc_l, _strinc, _wcsinc	Advance string pointer by one character	Not applicable.
_mbsnbcat, _mbsnbcat_l, _mbsnbcat_s, _mbsnbcat_s_l	Append, at most, first n bytes of one character string to another	Not applicable.
_mbsnbcmp, _mbsnbcmp_l	Compare first n bytes of two character strings	Not applicable.
_mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l, _strncnt, _wcsncnt	Return number of character bytes within supplied character count	Not applicable.
_mbsnbcpy, _mbsnbcpy_l, _mbsnbcpy_s, _mbsnbcpy_s_l	Copy n bytes of string	Not applicable.
_mbsnbicmp, _mbsnbicmp_l	Compare n bytes of two character strings, ignoring case	Not applicable.
_mbsnbset, _mbsnbset_l	Set first n bytes of character string to specified character	Not applicable.
_mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l, _strncnt, _wcsncnt	Return number of characters within supplied byte count	Not applicable.
_mbsnextc, _mbsnextc_l, _strnextc, _wcsnextc	Find next character in string	Not applicable.
_mbsninc, _mbsninc_l, _strninc, _wcsninc	Advance string pointer by n characters	Not applicable.
_mbsspnp, _mbsspnp_l, _strspnp, _wcsspnp	Return pointer to first character in given string that is not in another given string	Not applicable.
_scprintf, _scprintf_l, _scwprintf, _scwprintf_l	Return the number of characters in a formatted string	Not applicable.
_snscanf, _snscanf_l, _snwscanf, _snwscanf_l, _snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l	Read formatted data of a specified length from the standard input stream.	Not applicable.
sscanf, _sscanf_l, swscanf, _swscanf_l, sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l	Read formatted data of a specified length from the standard input stream.	Not applicable.
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l, sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l, _sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l	Write formatted data to a string	System::String::Format
strcat, wcscat, _mbscat, strcat_s, wcscat_s, _mbscat_s	Append one string to another	System::String::Concat
strchr, wcschr, _mbschr, _mbschr_l	Find first occurrence of specified character in string	System::String::IndexOf
strcmp, wcscmp, _mbscmp	Compare two strings	System::String::CompareOrdinal
strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l, _stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l, _strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l, _strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l	Compare two strings using current locale code page information (_stricoll, _wcsicoll, _strnicoll, and _wcsnicoll are case-insensitive)	System::String::Compare
strcpy, wcscpy, _mbscpy, strcpy_s, wcscpy_s, _mbscpy_s	Copy one string to another	System::String::Copy
strcspn, wcscspn, _mbscspn, _mbscspn_l	Find first occurrence of character from specified character set in string	System::String::Substring
_strdup, _wcsdup, _mbsdup, _strdup_dbg, _wcsdup_dbg	Duplicate string	System::String::Clone
strerror, _strerror, _wcserror, __wcserror, strerror_s, _strerror_s, _wcserror_s, __wcserror_s	Map error number to message string	System::Exception::Message
strftime, wcsftime, _strftime_l, _wcsftime_l	Format date-and-time string	System::Convert::ToString
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l	Compare two strings without regard to case	System::String::Compare
strlen, strlen_l, wcslen, wcslen_l, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l, strnlen, strnlen_s, strnlen_l, wcsnlen, wcsnlen_s, wcsnlen_l, _mbsnlen, _mbsnlen_l, _mbstrnlen, _mbstrnlen_l	Find length of string	System::String::Length
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l, _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l	Convert string to lowercase	System::String::ToLower
strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l, strncat_s, _strncat_s_l, wcsncat_s, _wcsncat_s_l, _mbsncat_s, _mbsncat_s_l	Append characters of string	System::String::Concat
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l	Compare characters of two strings	System::String::Compare
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l, strncpy_s, _strncpy_s_l, wcsncpy_s, _wcsncpy_s_l, _mbsncpy_s, _mbsncpy_s_l	Copy characters of one string to another	System::String::Copy
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l	Compare characters of two strings without regard to case	System::String::Compare
_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l	Set first n characters of string to specified character	System::String::Replace
strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l	Find first occurrence of character from one string in another string	System::String::IndexOfAny
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l	Find last occurrence of given character in string	System::String::LastIndexOf
_strrev, _wcsrev, _mbsrev, _mbsrev_l	Reverse string	Not applicable.
_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l	Set all characters of string to specified character	Not applicable.
strspn, wcsspn, _mbsspn, _mbsspn_l	Find first substring from one string in another string	System::String::Substring
strstr, wcsstr, _mbsstr, _mbsstr_l	Find first occurrence of specified string in another string	System::String::IndexOf
strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l, strtok_s, _strtok_s_l, wcstok_s, _wcstok_s_l, _mbstok_s, _mbstok_s_l	Find next token in string	Not applicable.
_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr, _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l	Convert string to uppercase	System::String::ToUpper
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l	Transform string into collated form based on locale-specific information	Not applicable.
vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l, vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l, _vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l	Write formatted output using a pointer to a list of arguments	System::String::Format
vsnprintf, _vsnprintf, _vsnprintf_l, _vsnwprintf, _vsnwprintf_l, vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l	Write formatted output using a pointer to a list of arguments	System::String::Format

See Also

Concepts

Run-Time Routines by Category