309 lines
12 KiB
C
309 lines
12 KiB
C
/***
|
|
*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 <cruntime.h>
|
|
* 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 <cruntime.h>
|
|
#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 */
|