/*** *string.h - declarations for string manipulation functions * * Copyright (c) 1985-2001, Microsoft Corporation. All rights reserved. * *Purpose: * This file contains the function declarations for the string * manipulation functions. * [ANSI/System V] * * [Public] * *Revision History: * 10/20/87 JCR Removed "MSC40_ONLY" entries * 12-11-87 JCR Added "_loadds" functionality * 12-18-87 JCR Added _FAR_ to declarations * 02-10-88 JCR Cleaned up white space * 08-19-88 GJF Modified to also work for the 386 (small model only) * 03-22-88 JCR Added strcoll and strxfrm * 05-03-89 JCR Added _INTERNAL_IFSTRIP for relinc usage * 08-03-89 GJF Cleanup, now specific to OS/2 2.0 (i.e., 386 flat model) * 10-30-89 GJF Fixed copyright, removed dummy args from strcoll and * strxfrm * 11-02-89 JCR Changed "DLL" to "_DLL" * 11-17-89 GJF Added const to appropriate arg types for memccpy(), * memicmp() and _strerror(). * 02-27-90 GJF Added #ifndef _INC_STRING, #include * and _CALLTYPE1 stuff. Also, some cleanup. * 03-21-90 GJF Got rid of movedata() prototype. * 08-14-90 SBM Added NULL definition for ANSI compliance * 11-12-90 GJF Changed NULL to (void *)0. * 01-18-91 GJF ANSI naming. * 02-12-91 GJF Only #define NULL if it isn't #define-d. * 03-21-91 KRS Added wchar_t type, also in stdlib.h and stddef.h. * 08-20-91 JCR C++ and ANSI naming * 09-28-91 JCR ANSI names: DOSX32=prototypes, WIN32=#defines for now * 10-07-91 ETC Prototypes for wcs functions and _stricoll under _INTL. * 04-06-92 KRS Rip out _INTL switches again. * 06-23-92 GJF // is non-ANSI comment limiter. * 08-05-92 GJF Function calling type and variable type macros. * 08-18-92 KRS Activate wcstok. * 08-21-92 GJF Merged last two changes. * 01-21-93 GJF Removed support for C6-386's _cdecl. * 04-07-93 SKS Add _CRTIMP keyword for CRT DLL model * Use link-time aliases for old names, not #define's * Intrinsic functions cannot use __declspec(dllimport) * 10-06-93 GJF Merged NT SDK and Cuda versions. * 11-22-93 CFW wcsxxx defines in SDK, prototypes in !SDK. * 12-07-93 CFW Move wide defs outside __STDC__ check. * 01-14-94 CFW Add _strnicoll, _wcsnicoll. * 04-11-94 CFW Add _NLSCMPERROR. * 05-17-94 GJF Compiler for DEC Alpha provides implementation of * memmove as an intrinsic. Thus, Alpha version of * prototype cannot be _CRTIMP. * 05-26-94 CFW Add _strncoll, _wcsncoll. * 12-28-94 JCF Merged with mac header. * 02-11-95 CFW Add _CRTBLD to avoid users getting wrong headers. * 02-14-95 CFW Clean up Mac merge. * 03-01-95 SAH add _CRTIMP to MIPS intrinsics * 12-14-95 JWM Add "#pragma once". * 02-05-97 GJF Cleaned out obsolete support for _CRTAPI* and _NTSDK. * 09-30-97 JWM Restored not-so-obsolete _CRTAPI1 support. * 10-07-97 RDL Added IA64. * 08-27-98 GJF Added __ascii_memicmp, __ascii_stricmp and * __ascii_strnicmp. * 12-15-98 GJF Changes for 64-bit size_t. * 05-13-99 PML Remove _CRTAPI1 * 05-17-99 PML Remove all Macintosh support. * 10-06-99 PML Add _W64 modifier to types which are 32 bits in Win32, * 64 bits in Win64. * 10-27-99 PML unsigned int -> size_t in memccpy, memicmp * 11-30-99 GB Add _wcserror and __wcserror * 05-01-01 PML memmove isn't _CRTIMP on IA64 * ****/ #if _MSC_VER > 1000 /*IFSTRIP=IGN*/ #pragma once #endif #ifndef _INC_STRING #define _INC_STRING #if !defined(_WIN32) #error ERROR: Only Win32 target supported! #endif #ifndef _CRTBLD /* This version of the header files is NOT for user programs. * It is intended for use when building the C runtimes ONLY. * The version intended for public use will not have this message. */ #error ERROR: Use of C runtime library internal header file. #endif /* _CRTBLD */ #ifdef __cplusplus extern "C" { #endif #ifndef _INTERNAL_IFSTRIP_ #include #endif /* _INTERNAL_IFSTRIP_ */ #if !defined(_W64) #if !defined(__midl) && (defined(_X86_) || defined(_M_IX86)) && _MSC_VER >= 1300 /*IFSTRIP=IGN*/ #define _W64 __w64 #else #define _W64 #endif #endif /* Define _CRTIMP */ #ifndef _CRTIMP #ifdef CRTDLL #define _CRTIMP __declspec(dllexport) #else /* ndef CRTDLL */ #ifdef _DLL #define _CRTIMP __declspec(dllimport) #else /* ndef _DLL */ #define _CRTIMP #endif /* _DLL */ #endif /* CRTDLL */ #endif /* _CRTIMP */ /* Define __cdecl for non-Microsoft compilers */ #if ( !defined(_MSC_VER) && !defined(__cdecl) ) #define __cdecl #endif #ifndef _SIZE_T_DEFINED #ifdef _WIN64 typedef unsigned __int64 size_t; #else typedef _W64 unsigned int size_t; #endif #define _SIZE_T_DEFINED #endif #ifndef _WCHAR_T_DEFINED typedef unsigned short wchar_t; #define _WCHAR_T_DEFINED #endif #ifndef _NLSCMP_DEFINED #define _NLSCMPERROR 2147483647 /* currently == INT_MAX */ #define _NLSCMP_DEFINED #endif /* Define NULL pointer value */ #ifndef NULL #ifdef __cplusplus #define NULL 0 #else #define NULL ((void *)0) #endif #endif /* Function prototypes */ #ifdef _M_MRX000 _CRTIMP void * __cdecl memcpy(void *, const void *, size_t); _CRTIMP int __cdecl memcmp(const void *, const void *, size_t); _CRTIMP void * __cdecl memset(void *, int, size_t); _CRTIMP char * __cdecl _strset(char *, int); _CRTIMP char * __cdecl strcpy(char *, const char *); _CRTIMP char * __cdecl strcat(char *, const char *); _CRTIMP int __cdecl strcmp(const char *, const char *); _CRTIMP size_t __cdecl strlen(const char *); #else void * __cdecl memcpy(void *, const void *, size_t); int __cdecl memcmp(const void *, const void *, size_t); void * __cdecl memset(void *, int, size_t); char * __cdecl _strset(char *, int); char * __cdecl strcpy(char *, const char *); char * __cdecl strcat(char *, const char *); int __cdecl strcmp(const char *, const char *); size_t __cdecl strlen(const char *); #endif _CRTIMP void * __cdecl _memccpy(void *, const void *, int, size_t); _CRTIMP void * __cdecl memchr(const void *, int, size_t); _CRTIMP int __cdecl _memicmp(const void *, const void *, size_t); #if defined(_M_IA64) || defined(_M_ALPHA) void * __cdecl memmove(void *, const void *, size_t); #else _CRTIMP void * __cdecl memmove(void *, const void *, size_t); #endif _CRTIMP char * __cdecl strchr(const char *, int); _CRTIMP int __cdecl _strcmpi(const char *, const char *); _CRTIMP int __cdecl _stricmp(const char *, const char *); _CRTIMP int __cdecl strcoll(const char *, const char *); _CRTIMP int __cdecl _stricoll(const char *, const char *); _CRTIMP int __cdecl _strncoll(const char *, const char *, size_t); _CRTIMP int __cdecl _strnicoll(const char *, const char *, size_t); _CRTIMP size_t __cdecl strcspn(const char *, const char *); _CRTIMP char * __cdecl _strdup(const char *); _CRTIMP char * __cdecl _strerror(const char *); _CRTIMP char * __cdecl strerror(int); _CRTIMP char * __cdecl _strlwr(char *); _CRTIMP char * __cdecl strncat(char *, const char *, size_t); _CRTIMP int __cdecl strncmp(const char *, const char *, size_t); _CRTIMP int __cdecl _strnicmp(const char *, const char *, size_t); _CRTIMP char * __cdecl strncpy(char *, const char *, size_t); _CRTIMP char * __cdecl _strnset(char *, int, size_t); _CRTIMP char * __cdecl strpbrk(const char *, const char *); _CRTIMP char * __cdecl strrchr(const char *, int); _CRTIMP char * __cdecl _strrev(char *); _CRTIMP size_t __cdecl strspn(const char *, const char *); _CRTIMP char * __cdecl strstr(const char *, const char *); _CRTIMP char * __cdecl strtok(char *, const char *); _CRTIMP char * __cdecl _strupr(char *); _CRTIMP size_t __cdecl strxfrm (char *, const char *, size_t); #if !__STDC__ /* prototypes for oldnames.lib functions */ _CRTIMP void * __cdecl memccpy(void *, const void *, int, size_t); _CRTIMP int __cdecl memicmp(const void *, const void *, size_t); _CRTIMP int __cdecl strcmpi(const char *, const char *); _CRTIMP int __cdecl stricmp(const char *, const char *); _CRTIMP char * __cdecl strdup(const char *); _CRTIMP char * __cdecl strlwr(char *); _CRTIMP int __cdecl strnicmp(const char *, const char *, size_t); _CRTIMP char * __cdecl strnset(char *, int, size_t); _CRTIMP char * __cdecl strrev(char *); char * __cdecl strset(char *, int); _CRTIMP char * __cdecl strupr(char *); #endif /* !__STDC__ */ #ifndef _WSTRING_DEFINED /* wide function prototypes, also declared in wchar.h */ _CRTIMP wchar_t * __cdecl wcscat(wchar_t *, const wchar_t *); _CRTIMP wchar_t * __cdecl wcschr(const wchar_t *, wchar_t); _CRTIMP int __cdecl wcscmp(const wchar_t *, const wchar_t *); _CRTIMP wchar_t * __cdecl wcscpy(wchar_t *, const wchar_t *); _CRTIMP size_t __cdecl wcscspn(const wchar_t *, const wchar_t *); _CRTIMP size_t __cdecl wcslen(const wchar_t *); _CRTIMP wchar_t * __cdecl wcsncat(wchar_t *, const wchar_t *, size_t); _CRTIMP int __cdecl wcsncmp(const wchar_t *, const wchar_t *, size_t); _CRTIMP wchar_t * __cdecl wcsncpy(wchar_t *, const wchar_t *, size_t); _CRTIMP wchar_t * __cdecl wcspbrk(const wchar_t *, const wchar_t *); _CRTIMP wchar_t * __cdecl wcsrchr(const wchar_t *, wchar_t); _CRTIMP size_t __cdecl wcsspn(const wchar_t *, const wchar_t *); _CRTIMP wchar_t * __cdecl wcsstr(const wchar_t *, const wchar_t *); _CRTIMP wchar_t * __cdecl wcstok(wchar_t *, const wchar_t *); _CRTIMP wchar_t * __cdecl _wcserror(int); _CRTIMP wchar_t * __cdecl __wcserror(const wchar_t *); _CRTIMP wchar_t * __cdecl _wcsdup(const wchar_t *); _CRTIMP int __cdecl _wcsicmp(const wchar_t *, const wchar_t *); _CRTIMP int __cdecl _wcsnicmp(const wchar_t *, const wchar_t *, size_t); _CRTIMP wchar_t * __cdecl _wcsnset(wchar_t *, wchar_t, size_t); _CRTIMP wchar_t * __cdecl _wcsrev(wchar_t *); _CRTIMP wchar_t * __cdecl _wcsset(wchar_t *, wchar_t); _CRTIMP wchar_t * __cdecl _wcslwr(wchar_t *); _CRTIMP wchar_t * __cdecl _wcsupr(wchar_t *); _CRTIMP size_t __cdecl wcsxfrm(wchar_t *, const wchar_t *, size_t); _CRTIMP int __cdecl wcscoll(const wchar_t *, const wchar_t *); _CRTIMP int __cdecl _wcsicoll(const wchar_t *, const wchar_t *); _CRTIMP int __cdecl _wcsncoll(const wchar_t *, const wchar_t *, size_t); _CRTIMP int __cdecl _wcsnicoll(const wchar_t *, const wchar_t *, size_t); #if !__STDC__ /* old names */ #define wcswcs wcsstr /* prototypes for oldnames.lib functions */ _CRTIMP wchar_t * __cdecl wcsdup(const wchar_t *); _CRTIMP int __cdecl wcsicmp(const wchar_t *, const wchar_t *); _CRTIMP int __cdecl wcsnicmp(const wchar_t *, const wchar_t *, size_t); _CRTIMP wchar_t * __cdecl wcsnset(wchar_t *, wchar_t, size_t); _CRTIMP wchar_t * __cdecl wcsrev(wchar_t *); _CRTIMP wchar_t * __cdecl wcsset(wchar_t *, wchar_t); _CRTIMP wchar_t * __cdecl wcslwr(wchar_t *); _CRTIMP wchar_t * __cdecl wcsupr(wchar_t *); _CRTIMP int __cdecl wcsicoll(const wchar_t *, const wchar_t *); #endif /* !__STDC__ */ #define _WSTRING_DEFINED #endif #ifndef _INTERNAL_IFSTRIP_ int __cdecl __ascii_memicmp(const void *, const void *, size_t); int __cdecl __ascii_stricmp(const char *, const char *); int __cdecl __ascii_strnicmp(const char *, const char *, size_t); #endif /* _INTERNAL_IFSTRIP_ */ #ifdef __cplusplus } #endif #endif /* _INC_STRING */