Author: akhaldi Date: Thu Mar 7 16:45:18 2013 New Revision: 58439
URL: http://svn.reactos.org/svn/reactos?rev=58439&view=rev Log: [CRT] * Annotate string.h.
Modified: trunk/reactos/include/crt/string.h
Modified: trunk/reactos/include/crt/string.h URL: http://svn.reactos.org/svn/reactos/trunk/reactos/include/crt/string.h?rev=58... ============================================================================== --- trunk/reactos/include/crt/string.h [iso-8859-1] (original) +++ trunk/reactos/include/crt/string.h [iso-8859-1] Thu Mar 7 16:45:18 2013 @@ -27,163 +27,1114 @@
#ifndef _CRT_MEMORY_DEFINED #define _CRT_MEMORY_DEFINED - _CRTIMP void *__cdecl _memccpy(void *_Dst,const void *_Src,int _Val,size_t _MaxCount); - _CRTIMP _CONST_RETURN void *__cdecl memchr(const void *_Buf ,int _Val,size_t _MaxCount); - _CRTIMP int __cdecl _memicmp(const void *_Buf1,const void *_Buf2,size_t _Size); - _CRTIMP int __cdecl _memicmp_l(const void *_Buf1,const void *_Buf2,size_t _Size,_locale_t _Locale); - int __cdecl memcmp(const void *_Buf1,const void *_Buf2,size_t _Size); - _CRT_INSECURE_DEPRECATE_MEMORY(memcpy_s) void *__cdecl memcpy(void *_Dst,const void *_Src,size_t _Size); - void *__cdecl memset(void *_Dst,int _Val,size_t _Size); -#ifndef NO_OLDNAMES - _CRTIMP _CRT_NONSTDC_DEPRECATE(_memccpy) void *__cdecl memccpy(void *_Dst,const void *_Src,int _Val,size_t _Size); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_memicmp) int __cdecl memicmp(const void *_Buf1,const void *_Buf2,size_t _Size); -#endif -#endif - - char *__cdecl _strset(char *_Str,int _Val); - char *__cdecl strcpy(char *_Dest,const char *_Source); - char *__cdecl strcat(char *_Dest,const char *_Source); - int __cdecl strcmp(const char *_Str1,const char *_Str2); - size_t __cdecl strlen(const char *_Str); - _CRTIMP size_t __cdecl strnlen(const char *_Str,size_t _MaxCount); - - _CRT_INSECURE_DEPRECATE_MEMORY(memmove_s) void *__cdecl memmove(void *_Dst,const void *_Src,size_t _Size); - _CRTIMP char *__cdecl _strdup(const char *_Src); - _CRTIMP _CONST_RETURN char *__cdecl strchr(const char *_Str,int _Val); - _CRTIMP int __cdecl _stricmp(const char *_Str1,const char *_Str2); - _CRTIMP int __cdecl _strcmpi(const char *_Str1,const char *_Str2); - _CRTIMP int __cdecl _stricmp_l(const char *_Str1,const char *_Str2,_locale_t _Locale); - _CRTIMP int __cdecl strcoll(const char *_Str1,const char *_Str2); - _CRTIMP int __cdecl _strcoll_l(const char *_Str1,const char *_Str2,_locale_t _Locale); - _CRTIMP int __cdecl _stricoll(const char *_Str1,const char *_Str2); - _CRTIMP int __cdecl _stricoll_l(const char *_Str1,const char *_Str2,_locale_t _Locale); - _CRTIMP int __cdecl _strncoll (const char *_Str1,const char *_Str2,size_t _MaxCount); - _CRTIMP int __cdecl _strncoll_l(const char *_Str1,const char *_Str2,size_t _MaxCount,_locale_t _Locale); - _CRTIMP int __cdecl _strnicoll (const char *_Str1,const char *_Str2,size_t _MaxCount); - _CRTIMP int __cdecl _strnicoll_l(const char *_Str1,const char *_Str2,size_t _MaxCount,_locale_t _Locale); - _CRTIMP size_t __cdecl strcspn(const char *_Str,const char *_Control); - _CRTIMP _CRT_INSECURE_DEPRECATE(_strerror_s) char *__cdecl _strerror(const char *_ErrMsg); - _CRTIMP _CRT_INSECURE_DEPRECATE(strerror_s) char *__cdecl strerror(int); - _CRTIMP char *__cdecl _strlwr(char *_String); - char *strlwr_l(char *_String,_locale_t _Locale); - char *__cdecl strncat(char *_Dest,const char *_Source,size_t _Count); - int __cdecl strncmp(const char *_Str1,const char *_Str2,size_t _MaxCount); - _CRTIMP int __cdecl _strnicmp(const char *_Str1,const char *_Str2,size_t _MaxCount); - _CRTIMP int __cdecl _strnicmp_l(const char *_Str1,const char *_Str2,size_t _MaxCount,_locale_t _Locale); - char *strncpy(char *_Dest,const char *_Source,size_t _Count); - _CRTIMP _CRT_INSECURE_DEPRECATE_CORE(_strnset_s) char *__cdecl _strnset(char *_Str,int _Val,size_t _MaxCount); - _CRTIMP _CONST_RETURN char *__cdecl strpbrk(const char *_Str,const char *_Control); - _CRTIMP _CONST_RETURN char *__cdecl strrchr(const char *_Str,int _Ch); - _CRTIMP char *__cdecl _strrev(char *_Str); - _CRTIMP size_t __cdecl strspn(const char *_Str,const char *_Control); - _CRTIMP _CONST_RETURN char *__cdecl strstr(const char *_Str,const char *_SubStr); - _CRTIMP _CRT_INSECURE_DEPRECATE_CORE(strtok_s) char *__cdecl strtok(char *_Str,const char *_Delim); - _CRTIMP char *__cdecl _strupr(char *_String); - _CRTIMP char *_strupr_l(char *_String,_locale_t _Locale); - _CRTIMP size_t __cdecl strxfrm(char *_Dst,const char *_Src,size_t _MaxCount); - _CRTIMP size_t __cdecl _strxfrm_l(char *_Dst,const char *_Src,size_t _MaxCount,_locale_t _Locale); + + _CRTIMP + void* + __cdecl + _memccpy( + _Out_writes_bytes_opt_(_MaxCount) void *_Dst, + _In_ const void *_Src, + _In_ int _Val, + _In_ size_t _MaxCount); + + _Must_inspect_result_ + _CRTIMP + _CONST_RETURN + void* + __cdecl + memchr( + _In_reads_bytes_opt_(_MaxCount) const void *_Buf, + _In_ int _Val, + _In_ size_t _MaxCount); + + _Must_inspect_result_ + _CRTIMP + int + __cdecl + _memicmp( + _In_reads_bytes_opt_(_Size) const void *_Buf1, + _In_reads_bytes_opt_(_Size) const void *_Buf2, + _In_ size_t _Size); + + _Must_inspect_result_ + _CRTIMP + int + __cdecl + _memicmp_l( + _In_reads_bytes_opt_(_Size) const void *_Buf1, + _In_reads_bytes_opt_(_Size) const void *_Buf2, + _In_ size_t _Size, + _In_opt_ _locale_t _Locale); + + _Must_inspect_result_ + int + __cdecl + memcmp( + _In_reads_bytes_(_Size) const void *_Buf1, + _In_reads_bytes_(_Size) const void *_Buf2, + _In_ size_t _Size); + + _Post_equal_to_(_Dst) + _At_buffer_((unsigned char*)_Dst, + _Iter_, + _MaxCount, + _Post_satisfies_(((unsigned char*)_Dst)[_Iter_] == ((unsigned char*)_Src)[_Iter_])) + _CRT_INSECURE_DEPRECATE_MEMORY(memcpy_s) + void* + __cdecl + memcpy( + _Out_writes_bytes_all_(_MaxCount) void *_Dst, + _In_reads_bytes_(_MaxCount) const void *_Src, + _In_ size_t _MaxCount); + + _Post_equal_to_(_Dst) + _At_buffer_((unsigned char*)_Dst, + _Iter_, + _Size, + _Post_satisfies_(((unsigned char*)_Dst)[_Iter_] == _Val)) + void* + __cdecl + memset( + _Out_writes_bytes_all_(_Size) void *_Dst, + _In_ int _Val, + _In_ size_t _Size); + +#ifndef NO_OLDNAMES + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_memccpy) + void* + __cdecl + memccpy( + _Out_writes_bytes_opt_(_Size) void *_Dst, + _In_reads_bytes_opt_(_Size) const void *_Src, + _In_ int _Val, + _In_ size_t _Size); + + _Check_return_ + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_memicmp) + int + __cdecl + memicmp( + _In_reads_bytes_opt_(_Size) const void *_Buf1, + _In_reads_bytes_opt_(_Size) const void *_Buf2, + _In_ size_t _Size); + +#endif /* NO_OLDNAMES */ + +#endif /* _CRT_MEMORY_DEFINED */ + + char* + __cdecl + _strset( + _Inout_z_ char *_Str, + _In_ int _Val); + + char* + __cdecl + strcpy( + _Out_writes_z_(_String_length_(_Source) + 1) char *_Dest, + _In_z_ const char *_Source); + + char* + __cdecl + strcat( + _Inout_updates_z_(_String_length_(_Dest) + _String_length_(_Source) + 1) char *_Dest, + _In_z_ const char *_Source); + + _Check_return_ + int + __cdecl + strcmp( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2); + + size_t + __cdecl + strlen( + _In_z_ const char *_Str); + + _When_(_MaxCount > _String_length_(_Str), + _Post_satisfies_(return == _String_length_(_Str))) + _When_(_MaxCount <= _String_length_(_Str), + _Post_satisfies_(return == _MaxCount)) + _CRTIMP + size_t + __cdecl + strnlen( + _In_reads_or_z_(_MaxCount) const char *_Str, + _In_ size_t _MaxCount); + + _CRT_INSECURE_DEPRECATE_MEMORY(memmove_s) + void* + __cdecl + memmove( + _Out_writes_bytes_all_opt_(_MaxCount) void *_Dst, + _In_reads_bytes_opt_(_MaxCount) const void *_Src, + _In_ size_t _MaxCount); + + _Check_return_ + _CRTIMP + char* + __cdecl + _strdup( + _In_opt_z_ const char *_Src); + + _Check_return_ + _CRTIMP + _CONST_RETURN + char* + __cdecl + strchr( + _In_z_ const char *_Str, + _In_ int _Val); + + _Check_return_ + _CRTIMP + int + __cdecl + _stricmp( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2); + + _Check_return_ + _CRTIMP + int + __cdecl + _strcmpi( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2); + + _Check_return_ + _CRTIMP + int + __cdecl + _stricmp_l( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2, + _In_opt_ _locale_t _Locale); + + _Check_return_ + _CRTIMP + int + __cdecl + strcoll( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2); + + _Check_return_ + _CRTIMP + int + __cdecl + _strcoll_l( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2, + _In_opt_ _locale_t _Locale); + + _Check_return_ + _CRTIMP + int + __cdecl + _stricoll( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2); + + _Check_return_ + _CRTIMP + int + __cdecl + _stricoll_l( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2, + _In_opt_ _locale_t _Locale); + + _Check_return_ + _CRTIMP + int + __cdecl + _strncoll( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2, + _In_ size_t _MaxCount); + + _Check_return_ + _CRTIMP + int + __cdecl + _strncoll_l( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2, + _In_ size_t _MaxCount, + _In_opt_ _locale_t _Locale); + + _Check_return_ + _CRTIMP + int + __cdecl + _strnicoll( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2, + _In_ size_t _MaxCount); + + _Check_return_ + _CRTIMP + int + __cdecl + _strnicoll_l( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2, + _In_ size_t _MaxCount, + _In_opt_ _locale_t _Locale); + + _Check_return_ + _CRTIMP + size_t + __cdecl + strcspn( + _In_z_ const char *_Str, + _In_z_ const char *_Control); + + _Check_return_ + _CRTIMP + _CRT_INSECURE_DEPRECATE(_strerror_s) + char* + __cdecl + _strerror( + _In_opt_z_ const char *_ErrMsg); + + _Check_return_ + _CRTIMP + _CRT_INSECURE_DEPRECATE(strerror_s) + char* + __cdecl + strerror( + _In_ int); + + _CRTIMP + char* + __cdecl + _strlwr( + _Inout_z_ char *_String); + + char* + strlwr_l( + char *_String, + _locale_t _Locale); + + char* + __cdecl + strncat( + char *_Dest, + const char *_Source, + size_t _Count); + + _Check_return_ + int + __cdecl + strncmp( + _In_reads_or_z_(_MaxCount) const char *_Str1, + _In_reads_or_z_(_MaxCount) const char *_Str2, + _In_ size_t _MaxCount); + + _Check_return_ + _CRTIMP + int + __cdecl + _strnicmp( + _In_reads_or_z_(_MaxCount) const char *_Str1, + _In_reads_or_z_(_MaxCount) const char *_Str2, + _In_ size_t _MaxCount); + + _Check_return_ + _CRTIMP + int + __cdecl + _strnicmp_l( + _In_reads_or_z_(_MaxCount) const char *_Str1, + _In_reads_or_z_(_MaxCount) const char *_Str2, + _In_ size_t _MaxCount, + _In_opt_ _locale_t _Locale); + + char* + strncpy( + char *_Dest, + const char *_Source, + size_t _Count); + + _CRTIMP + _CRT_INSECURE_DEPRECATE_CORE(_strnset_s) + char* + __cdecl + _strnset( + char *_Str, + int _Val, + size_t _MaxCount); + + _Check_return_ + _CRTIMP + _CONST_RETURN + char* + __cdecl + strpbrk( + _In_z_ const char *_Str, + _In_z_ const char *_Control); + + _Check_return_ + _CRTIMP + _CONST_RETURN + char* + __cdecl + strrchr( + _In_z_ const char *_Str, + _In_ int _Ch); + + _CRTIMP + char* + __cdecl + _strrev( + _Inout_z_ char *_Str); + + _Check_return_ + _CRTIMP + size_t + __cdecl + strspn( + _In_z_ const char *_Str, + _In_z_ const char *_Control); + + _Check_return_ + _CRTIMP + _CONST_RETURN + char* + __cdecl + strstr( + _In_z_ const char *_Str, + _In_z_ const char *_SubStr); + + _Check_return_ + _CRTIMP + _CRT_INSECURE_DEPRECATE_CORE(strtok_s) + char* + __cdecl + strtok( + _Inout_opt_z_ char *_Str, + _In_z_ const char *_Delim); + + _CRTIMP + char* + __cdecl + _strupr( + _Inout_z_ char *_String); + + _CRTIMP + char* + _strupr_l( + char *_String, + _locale_t _Locale); + + _Check_return_opt_ + _CRTIMP + size_t + __cdecl + strxfrm( + _Out_writes_opt_(_MaxCount) _Post_maybez_ char *_Dst, + _In_z_ const char *_Src, + _In_ size_t _MaxCount); + + _Check_return_opt_ + _CRTIMP + size_t + __cdecl + _strxfrm_l( + _Out_writes_opt_(_MaxCount) _Post_maybez_ char *_Dst, + _In_z_ const char *_Src, + _In_ size_t _MaxCount, + _In_opt_ _locale_t _Locale); + #if __STDC_WANT_SECURE_LIB__ - _CRTIMP errno_t __cdecl _strset_s(char *_Dst,size_t _DstSize,int _Value); - _CRTIMP errno_t __cdecl _strerror_s(char *_Buf,size_t _SizeInBytes,const char *_ErrMsg); - _CRTIMP errno_t __cdecl _strlwr_s(char *_Str,size_t _Size); - _CRTIMP errno_t __cdecl _strlwr_s_l(char *_Str,size_t _Size,_locale_t _Locale); - _CRTIMP errno_t __cdecl _strnset_s(char *_Str,size_t _Size,int _Val,size_t _MaxCount); - _CRTIMP errno_t __cdecl _strupr_s(char *_Str,size_t _Size); - _CRTIMP errno_t __cdecl _strupr_s_l(char *_Str,size_t _Size,_locale_t _Locale); - _CRTIMP errno_t __cdecl strcpy_s(char *_Dst, size_t _Size, const char *_Src); - _CRTIMP errno_t __cdecl strcat_s(char *_Dst, size_t _Size, const char *_Src); -#endif - -#ifndef NO_OLDNAMES - _CRTIMP _CRT_NONSTDC_DEPRECATE(_strdup) char *__cdecl strdup(const char *_Src); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_strcmpi) int __cdecl strcmpi(const char *_Str1,const char *_Str2); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_stricmp) int __cdecl stricmp(const char *_Str1,const char *_Str2); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_strlwr) char *__cdecl strlwr(char *_Str); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_strnicmp) int __cdecl strnicmp(const char *_Str1,const char *_Str,size_t _MaxCount); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _strset_s( + _Inout_updates_z_(_DstSize) char *_Dst, + _In_ size_t _DstSize, + _In_ int _Value); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _strerror_s( + _Out_writes_z_(_SizeInBytes) char *_Buf, + _In_ size_t _SizeInBytes, + _In_opt_z_ const char *_ErrMsg); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _strlwr_s( + _Inout_updates_z_(_Size) char *_Str, + _In_ size_t _Size); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _strlwr_s_l( + _Inout_updates_z_(_Size) char *_Str, + _In_ size_t _Size, + _In_opt_ _locale_t _Locale); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _strnset_s( + _Inout_updates_z_(_Size) char *_Str, + _In_ size_t _Size, + _In_ int _Val, + _In_ size_t _MaxCount); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _strupr_s( + _Inout_updates_z_(_Size) char *_Str, + _In_ size_t _Size); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _strupr_s_l( + _Inout_updates_z_(_Size) char *_Str, + _In_ size_t _Size, + _locale_t _Locale); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + strcpy_s( + _Out_writes_z_(_Size) char *_Dst, + _In_ size_t _Size, + _In_z_ const char *_Src); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + strcat_s( + _Inout_updates_z_(_Size) char *_Dst, + _In_ size_t _Size, + _In_z_ const char *_Src); + +#endif /* __STDC_WANT_SECURE_LIB__ */ + +#ifndef NO_OLDNAMES + + _Check_return_ + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_strdup) + char* + __cdecl + strdup( + _In_opt_z_ const char *_Src); + + _Check_return_ + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_strcmpi) + int + __cdecl + strcmpi( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2); + + _Check_return_ + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_stricmp) + int + __cdecl + stricmp( + _In_z_ const char *_Str1, + _In_z_ const char *_Str2); + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_strlwr) + char* + __cdecl + strlwr( + _Inout_z_ char *_Str); + + _Check_return_ + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_strnicmp) + int + __cdecl + strnicmp( + _In_z_ const char *_Str1, + _In_z_ const char *_Str, + _In_ size_t _MaxCount); + // __CRT_INLINE int __cdecl strncasecmp (const char *__sz1, const char *__sz2, size_t __sizeMaxCompare) { return _strnicmp (__sz1, __sz2, __sizeMaxCompare); } // __CRT_INLINE int __cdecl strcasecmp (const char *__sz1, const char *__sz2) { return _stricmp (__sz1, __sz2); } - _CRTIMP _CRT_NONSTDC_DEPRECATE(_strnset) char *__cdecl strnset(char *_Str,int _Val,size_t _MaxCount); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_strrev) char *__cdecl strrev(char *_Str); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_strset) char *__cdecl strset(char *_Str,int _Val); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_strupr) char *__cdecl strupr(char *_Str); -#endif + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_strnset) + char* + __cdecl + strnset( + _Inout_updates_z_(_MaxCount) char *_Str, + _In_ int _Val, + _In_ size_t _MaxCount); + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_strrev) + char* + __cdecl + strrev( + _Inout_z_ char *_Str); + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_strset) + char* + __cdecl + strset( + _Inout_z_ char *_Str, + _In_ int _Val); + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_strupr) + char* + __cdecl + strupr( + _Inout_z_ char *_Str); + +#endif /* NO_OLDNAMES */
#ifndef _WSTRING_DEFINED #define _WSTRING_DEFINED
- _CRTIMP wchar_t *__cdecl _wcsdup(const wchar_t *_Str); - _CRTIMP _CRT_INSECURE_DEPRECATE(wcsat_s) wchar_t *__cdecl wcscat(wchar_t *_Dest,const wchar_t *_Source); - _CRTIMP _CONST_RETURN wchar_t *__cdecl wcschr(const wchar_t *_Str,wchar_t _Ch); - _CRTIMP int __cdecl wcscmp(const wchar_t *_Str1,const wchar_t *_Str2); - _CRTIMP _CRT_INSECURE_DEPRECATE(wcscpy_s) wchar_t *__cdecl wcscpy(wchar_t *_Dest,const wchar_t *_Source); - _CRTIMP size_t __cdecl wcscspn(const wchar_t *_Str,const wchar_t *_Control); - _CRTIMP wchar_t *wcsncat(wchar_t *_Dest,const wchar_t *_Source,size_t _Count); - -_Ret_range_(==,_String_length_(_Str)) -_CRTIMP -size_t -__cdecl -wcslen( + _Check_return_ + _CRTIMP + wchar_t* + __cdecl + _wcsdup( _In_z_ const wchar_t *_Str);
- _CRTIMP _CRT_INSECURE_DEPRECATE(wcsnlen_s) size_t __cdecl wcsnlen(const wchar_t *_Src,size_t _MaxCount); - _CRTIMP int __cdecl wcsncmp(const wchar_t *_Str1,const wchar_t *_Str2,size_t _MaxCount); - _CRTIMP _CRT_INSECURE_DEPRECATE(wcsncpy_s) wchar_t *wcsncpy(wchar_t *_Dest,const wchar_t *_Source,size_t _Count); - _CRTIMP _CONST_RETURN wchar_t *__cdecl wcspbrk(const wchar_t *_Str,const wchar_t *_Control); - _CRTIMP _CONST_RETURN wchar_t *__cdecl wcsrchr(const wchar_t *_Str,wchar_t _Ch); - _CRTIMP size_t __cdecl wcsspn(const wchar_t *_Str,const wchar_t *_Control); - _CRTIMP _CONST_RETURN wchar_t *__cdecl wcsstr(const wchar_t *_Str,const wchar_t *_SubStr); - _CRTIMP _CRT_INSECURE_DEPRECATE_CORE(wcstok_s) wchar_t *__cdecl wcstok(wchar_t *_Str,const wchar_t *_Delim); - _CRTIMP _CRT_INSECURE_DEPRECATE(_wcserror_s) wchar_t *__cdecl _wcserror(int _ErrNum); - _CRTIMP _CRT_INSECURE_DEPRECATE(__wcserror_s) wchar_t *__cdecl __wcserror(const wchar_t *_Str); - _CRTIMP int __cdecl _wcsicmp(const wchar_t *_Str1,const wchar_t *_Str2); - _CRTIMP int __cdecl _wcsicmp_l(const wchar_t *_Str1,const wchar_t *_Str2,_locale_t _Locale); - _CRTIMP int __cdecl _wcsnicmp(const wchar_t *_Str1,const wchar_t *_Str2,size_t _MaxCount); - _CRTIMP int __cdecl _wcsnicmp_l(const wchar_t *_Str1,const wchar_t *_Str2,size_t _MaxCount,_locale_t _Locale); - _CRTIMP _CRT_INSECURE_DEPRECATE_CORE(_wcsnset_s) wchar_t *__cdecl _wcsnset(wchar_t *_Str,wchar_t _Val,size_t _MaxCount); - _CRTIMP wchar_t *__cdecl _wcsrev(wchar_t *_Str); - _CRTIMP _CRT_INSECURE_DEPRECATE_CORE(_wcsset_s) wchar_t *__cdecl _wcsset(wchar_t *_Str,wchar_t _Val); - _CRTIMP wchar_t *__cdecl _wcslwr(wchar_t *_String); - _CRTIMP wchar_t *_wcslwr_l(wchar_t *_String,_locale_t _Locale); - _CRTIMP wchar_t *__cdecl _wcsupr(wchar_t *_String); - _CRTIMP wchar_t *_wcsupr_l(wchar_t *_String,_locale_t _Locale); - _CRTIMP size_t __cdecl wcsxfrm(wchar_t *_Dst,const wchar_t *_Src,size_t _MaxCount); - _CRTIMP size_t __cdecl _wcsxfrm_l(wchar_t *_Dst,const wchar_t *_Src,size_t _MaxCount,_locale_t _Locale); - _CRTIMP int __cdecl wcscoll(const wchar_t *_Str1,const wchar_t *_Str2); - _CRTIMP int __cdecl _wcscoll_l(const wchar_t *_Str1,const wchar_t *_Str2,_locale_t _Locale); - _CRTIMP int __cdecl _wcsicoll(const wchar_t *_Str1,const wchar_t *_Str2); - _CRTIMP int __cdecl _wcsicoll_l(const wchar_t *_Str1,const wchar_t *_Str2,_locale_t _Locale); - _CRTIMP int __cdecl _wcsncoll(const wchar_t *_Str1,const wchar_t *_Str2,size_t _MaxCount); - _CRTIMP int __cdecl _wcsncoll_l(const wchar_t *_Str1,const wchar_t *_Str2,size_t _MaxCount,_locale_t _Locale); - _CRTIMP int __cdecl _wcsnicoll(const wchar_t *_Str1,const wchar_t *_Str2,size_t _MaxCount); - _CRTIMP int __cdecl _wcsnicoll_l(const wchar_t *_Str1,const wchar_t *_Str2,size_t _MaxCount,_locale_t _Locale); + _CRTIMP + _CRT_INSECURE_DEPRECATE(wcsat_s) + wchar_t* + __cdecl + wcscat( + _Inout_updates_z_(_String_length_(_Dest) + _String_length_(_Source) + 1) wchar_t *_Dest, + _In_z_ const wchar_t *_Source); + + _Check_return_ + _When_(return != 0, _Ret_range_(_Str, _Str + _String_length_(_Str) - 1)) + _CRTIMP + _CONST_RETURN + wchar_t* + __cdecl + wcschr( + _In_z_ const wchar_t *_Str, + wchar_t _Ch); + + _Check_return_ + _CRTIMP + int + __cdecl + wcscmp( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2); + + _CRTIMP + _CRT_INSECURE_DEPRECATE(wcscpy_s) + wchar_t* + __cdecl + wcscpy( + _Out_writes_z_(_String_length_(_Source) + 1) wchar_t *_Dest, + _In_z_ const wchar_t *_Source); + + _Check_return_ + _CRTIMP + size_t + __cdecl + wcscspn( + _In_z_ const wchar_t *_Str, + _In_z_ const wchar_t *_Control); + + _CRTIMP + wchar_t* + wcsncat( + wchar_t *_Dest, + const wchar_t *_Source, + size_t _Count); + + _Ret_range_(==,_String_length_(_Str)) + _CRTIMP + size_t + __cdecl + wcslen( + _In_z_ const wchar_t *_Str); + + _When_(_MaxCount > _String_length_(_Src), + _Post_satisfies_(return == _String_length_(_Src))) + _When_(_MaxCount <= _String_length_(_Src), + _Post_satisfies_(return == _MaxCount)) + _CRTIMP + _CRT_INSECURE_DEPRECATE(wcsnlen_s) + size_t + __cdecl + wcsnlen( + _In_reads_or_z_(_MaxCount) const wchar_t *_Src, + _In_ size_t _MaxCount); + + _Check_return_ + _CRTIMP + int + __cdecl + wcsncmp( + _In_reads_or_z_(_MaxCount) const wchar_t *_Str1, + _In_reads_or_z_(_MaxCount) const wchar_t *_Str2, + _In_ size_t _MaxCount); + + _CRTIMP + _CRT_INSECURE_DEPRECATE(wcsncpy_s) + wchar_t* + wcsncpy( + wchar_t *_Dest, + const wchar_t *_Source, + size_t _Count); + + _Check_return_ + _CRTIMP + _CONST_RETURN + wchar_t* + __cdecl + wcspbrk( + _In_z_ const wchar_t *_Str, + _In_z_ const wchar_t *_Control); + + _Check_return_ + _CRTIMP + _CONST_RETURN + wchar_t* + __cdecl + wcsrchr( + _In_z_ const wchar_t *_Str, + _In_ wchar_t _Ch); + + _Check_return_ + _CRTIMP + size_t + __cdecl + wcsspn( + _In_z_ const wchar_t *_Str, + _In_z_ const wchar_t *_Control); + + _When_(return != 0, + _Ret_range_(_Str, _Str + _String_length_(_Str) - 1)) + _CRTIMP + _CONST_RETURN + wchar_t* + __cdecl + wcsstr( + _In_z_ const wchar_t *_Str, + _In_z_ const wchar_t *_SubStr); + + _Check_return_ + _CRTIMP + _CRT_INSECURE_DEPRECATE_CORE(wcstok_s) + wchar_t* + __cdecl + wcstok( + _Inout_opt_z_ wchar_t *_Str, + _In_z_ const wchar_t *_Delim); + + _Check_return_ + _CRTIMP + _CRT_INSECURE_DEPRECATE(_wcserror_s) + wchar_t* + __cdecl + _wcserror( + _In_ int _ErrNum); + + _Check_return_ + _CRTIMP + _CRT_INSECURE_DEPRECATE(__wcserror_s) + wchar_t* + __cdecl + __wcserror( + _In_opt_z_ const wchar_t *_Str); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcsicmp( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcsicmp_l( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2, + _In_opt_ _locale_t _Locale); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcsnicmp( + _In_reads_or_z_(_MaxCount) const wchar_t *_Str1, + _In_reads_or_z_(_MaxCount) const wchar_t *_Str2, + _In_ size_t _MaxCount); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcsnicmp_l( + _In_reads_or_z_(_MaxCount) const wchar_t *_Str1, + _In_reads_or_z_(_MaxCount) const wchar_t *_Str2, + _In_ size_t _MaxCount, + _In_opt_ _locale_t _Locale); + + _CRTIMP + _CRT_INSECURE_DEPRECATE_CORE(_wcsnset_s) + wchar_t* + __cdecl + _wcsnset( + wchar_t *_Str, + wchar_t _Val, + size_t _MaxCount); + + _CRTIMP + wchar_t* + __cdecl + _wcsrev( + _Inout_z_ wchar_t *_Str); + + _CRTIMP + _CRT_INSECURE_DEPRECATE_CORE(_wcsset_s) + wchar_t* + __cdecl + _wcsset( + wchar_t *_Str, + wchar_t _Val); + + _CRTIMP + wchar_t* + __cdecl + _wcslwr( + _Inout_z_ wchar_t *_String); + + _CRTIMP + wchar_t* + _wcslwr_l( + wchar_t *_String, + _locale_t _Locale); + + _CRTIMP + wchar_t* + __cdecl + _wcsupr( + _Inout_z_ wchar_t *_String); + + _CRTIMP + wchar_t* + _wcsupr_l( + wchar_t *_String, + _locale_t _Locale); + + _Check_return_opt_ + _CRTIMP + size_t + __cdecl + wcsxfrm( + _Out_writes_opt_(_MaxCount) _Post_maybez_ wchar_t *_Dst, + _In_z_ const wchar_t *_Src, + _In_ size_t _MaxCount); + + _Check_return_opt_ + _CRTIMP + size_t + __cdecl + _wcsxfrm_l( + _Out_writes_opt_(_MaxCount) _Post_maybez_ wchar_t *_Dst, + _In_z_ const wchar_t *_Src, + _In_ size_t _MaxCount, + _In_opt_ _locale_t _Locale); + + _Check_return_ + _CRTIMP + int + __cdecl + wcscoll( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcscoll_l( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2, + _In_opt_ _locale_t _Locale); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcsicoll( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcsicoll_l( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2, + _In_opt_ _locale_t _Locale); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcsncoll( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2, + _In_ size_t _MaxCount); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcsncoll_l( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2, + _In_ size_t _MaxCount, + _In_opt_ _locale_t _Locale); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcsnicoll( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2, + _In_ size_t _MaxCount); + + _Check_return_ + _CRTIMP + int + __cdecl + _wcsnicoll_l( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2, + _In_ size_t _MaxCount, + _In_opt_ _locale_t _Locale); + #if __STDC_WANT_SECURE_LIB__ - _CRTIMP errno_t __cdecl wcsat_s(wchar_t * Dest, size_t SizeInWords, const wchar_t * _Source); - _CRTIMP errno_t __cdecl wcscpy_s(wchar_t * Dest, size_t SizeInWords, const wchar_t * _Source); - _CRTIMP errno_t __cdecl wcsnlen_s(wchar_t **_Src, size_t _MaxCount); - _CRTIMP errno_t __cdecl wcsncpy_s(wchar_t *_Dest, size_t SizeInWords, const wchar_t *_Source ,size_t _Count); - _CRTIMP errno_t __cdecl _wcserror_s(wchar_t *_Buf,size_t _SizeInWords,int _ErrNum); - _CRTIMP errno_t __cdecl __wcserror_s(wchar_t *_Buffer,size_t _SizeInWords,const wchar_t *_ErrMsg); - _CRTIMP errno_t __cdecl _wcsnset_s(wchar_t *_Dst,size_t _DstSizeInWords,wchar_t _Val,size_t _MaxCount); - _CRTIMP errno_t __cdecl _wcsset_s(wchar_t *_Str,size_t _SizeInWords,wchar_t _Val); - _CRTIMP errno_t __cdecl _wcslwr_s(wchar_t *_Str,size_t _SizeInWords); - _CRTIMP errno_t __cdecl _wcslwr_s_l(wchar_t *_Str,size_t _SizeInWords,_locale_t _Locale); - _CRTIMP errno_t __cdecl _wcsupr_s(wchar_t *_Str,size_t _Size); - _CRTIMP errno_t __cdecl _wcsupr_s_l(wchar_t *_Str,size_t _Size,_locale_t _Locale); -#endif - -#ifndef NO_OLDNAMES - _CRTIMP _CRT_NONSTDC_DEPRECATE(_wcsdup) wchar_t *__cdecl wcsdup(const wchar_t *_Str); + + _CRTIMP + errno_t + __cdecl + wcsat_s( + wchar_t *Dest, + size_t SizeInWords, + const wchar_t *_Source); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + wcscpy_s( + _Out_writes_z_(SizeInWords) wchar_t *Dest, + _In_ size_t SizeInWords, + _In_z_ const wchar_t *_Source); + + _CRTIMP + errno_t + __cdecl + wcsnlen_s( + wchar_t **_Src, + size_t _MaxCount); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + wcsncpy_s( + _Out_writes_z_(SizeInWords) wchar_t *_Dest, + _In_ size_t SizeInWords, + _In_z_ const wchar_t *_Source, + _In_ size_t _Count); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _wcserror_s( + _Out_writes_opt_z_(_SizeInWords) wchar_t *_Buf, + _In_ size_t _SizeInWords, + _In_ int _ErrNum); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + __wcserror_s( + _Out_writes_opt_z_(_SizeInWords) wchar_t *_Buffer, + _In_ size_t _SizeInWords, + _In_z_ const wchar_t *_ErrMsg); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _wcsnset_s( + _Inout_updates_z_(_DstSizeInWords) wchar_t *_Dst, + _In_ size_t _DstSizeInWords, + _In_ wchar_t _Val, + _In_ size_t _MaxCount); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _wcsset_s( + _Inout_updates_z_(_SizeInWords) wchar_t *_Str, + _In_ size_t _SizeInWords, + _In_ wchar_t _Val); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _wcslwr_s( + _Inout_updates_z_(_SizeInWords) wchar_t *_Str, + _In_ size_t _SizeInWords); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _wcslwr_s_l( + _Inout_updates_z_(_SizeInWords) wchar_t *_Str, + _In_ size_t _SizeInWords, + _In_opt_ _locale_t _Locale); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _wcsupr_s( + _Inout_updates_z_(_Size) wchar_t *_Str, + _In_ size_t _Size); + + _Check_return_wat_ + _CRTIMP + errno_t + __cdecl + _wcsupr_s_l( + _Inout_updates_z_(_Size) wchar_t *_Str, + _In_ size_t _Size, + _In_opt_ _locale_t _Locale); + +#endif /* __STDC_WANT_SECURE_LIB__ */ + +#ifndef NO_OLDNAMES + + _Check_return_ + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_wcsdup) + wchar_t* + __cdecl + wcsdup( + _In_z_ const wchar_t *_Str); + #define wcswcs wcsstr - _CRTIMP _CRT_NONSTDC_DEPRECATE(_wcsicmp) int __cdecl wcsicmp(const wchar_t *_Str1,const wchar_t *_Str2); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_wcsnicmp) int __cdecl wcsnicmp(const wchar_t *_Str1,const wchar_t *_Str2,size_t _MaxCount); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_wcsnset) wchar_t *__cdecl wcsnset(wchar_t *_Str,wchar_t _Val,size_t _MaxCount); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_wcsrev) wchar_t *__cdecl wcsrev(wchar_t *_Str); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_wcsset) wchar_t *__cdecl wcsset(wchar_t *_Str,wchar_t _Val); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_wcslwr) wchar_t *__cdecl wcslwr(wchar_t *_Str); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_wcsupr) wchar_t *__cdecl wcsupr(wchar_t *_Str); - _CRTIMP _CRT_NONSTDC_DEPRECATE(_wcsicoll) int __cdecl wcsicoll(const wchar_t *_Str1,const wchar_t *_Str2); -#endif + + _Check_return_ + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_wcsicmp) + int + __cdecl + wcsicmp( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2); + + _Check_return_ + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_wcsnicmp) + int + __cdecl + wcsnicmp( + _In_reads_or_z_(_MaxCount) const wchar_t *_Str1, + _In_reads_or_z_(_MaxCount) const wchar_t *_Str2, + _In_ size_t _MaxCount); + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_wcsnset) + wchar_t* + __cdecl + wcsnset( + _Inout_updates_z_(_MaxCount) wchar_t *_Str, + _In_ wchar_t _Val, + _In_ size_t _MaxCount); + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_wcsrev) + wchar_t* + __cdecl + wcsrev( + _Inout_z_ wchar_t *_Str); + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_wcsset) + wchar_t* + __cdecl + wcsset( + _Inout_z_ wchar_t *_Str, + wchar_t _Val); + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_wcslwr) + wchar_t* + __cdecl + wcslwr( + _Inout_z_ wchar_t *_Str); + + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_wcsupr) + wchar_t* + __cdecl + wcsupr( + _Inout_z_ wchar_t *_Str); + + _Check_return_ + _CRTIMP + _CRT_NONSTDC_DEPRECATE(_wcsicoll) + int + __cdecl + wcsicoll( + _In_z_ const wchar_t *_Str1, + _In_z_ const wchar_t *_Str2); + +#endif /* NO_OLDNAMES */
#endif /* !_WSTRING_DEFINED */