|
|
/*++
Copyright (c) 1991 Microsoft Corporation
Module Name:
tstring.h
Abstract:
This include file contains manifests and macros to be used to integrate the TCHAR and LPTSTR definitions
Note that our naming convention is that a "size" indicates a number of bytes whereas a "length" indicates a number of characters.
Author:
Richard Firth (rfirth) 02-Apr-1991
Environment:
Portable (Win/32). Requires ANSI C extensions: slash-slash comments, long external names.
Revision History:
22-May-1991 Danl Added STRSIZE macro 19-May-1991 JohnRo Changed some parm names to make things easier to read. 15-May-1991 rfirth Added TCHAR_SPACE and MAKE_TCHAR() macro 15-Jul-1991 RFirth Added STRING_SPACE_REQD() and DOWN_LEVEL_STRSIZE 05-Aug-1991 JohnRo Added MEMCPY macro. 19-Aug-1991 JohnRo Added character type stuff: ISDIGIT(), TOUPPER(), etc. 20-Aug-1991 JohnRo Changed strnicmp to _strnicmp to keep PC-LINT happy. Ditto stricmp. 13-Sep-1991 JohnRo Need UNICODE STRSIZE() too. 13-Sep-1991 JohnRo Added UNICODE STRCMP() and various others. 07-May-1992 beng Use official wchar.h header file
--*/
#ifndef _TSTRING_H_INCLUDED
#define _TSTRING_H_INCLUDED
#include <ctype.h> // isdigit(), iswdigit() eventually, etc.
#ifdef LM20_COMPATIBLE
#define MAKE_STR_FUNCTION(s) s##f
#else
#define MAKE_STR_FUNCTION(s) s
#endif
#if defined(UNICODE)
#include <wchar.h> // wcslen(), etc.
//
// function macro prototypes
//
#define ISALNUM(tchar) iswalnum(tchar) // locale-dependent.
#define ISALPHA(tchar) iswalpha(tchar) // locale-dependent.
#define ISCNTRL(tchar) iswcntrl(tchar) // locale-dependent.
#define ISDIGIT(tchar) iswdigit(tchar)
#define ISGRAPH(tchar) iswgraph(tchar) // locale-dependent.
#define ISLOWER(tchar) iswlower(tchar) // locale-dependent.
#define ISPRINT(tchar) iswprint(tchar) // locale-dependent.
#define ISPUNCT(tchar) iswpunct(tchar) // locale-dependent.
#define ISSPACE(tchar) iswspace(tchar) // locale-dependent.
#define ISUPPER(tchar) iswupper(tchar) // locale-dependent.
#define ISXDIGIT(tchar) iswxdigit(tchar)
#define STRCAT(dest, src) wcscat((dest), (src))
#define STRCHR(s1, c) (LPTSTR)MAKE_STR_FUNCTION(wcschr)((s1), (c))
#define STRCPY(dest, src) wcscpy((dest), (src))
#define STRCSPN(s, c) (DWORD)MAKE_STR_FUNCTION(wcscspn)((s), (c))
// STRLEN: Get character count of s.
#define STRLEN(s) wcslen(s)
#define STRNCAT(dest, src, n) \
(LPTSTR)MAKE_STR_FUNCTION(wcsncat)((dest), (src), (n))#define STRNCPY(dest, src, n) \
(LPTSTR)MAKE_STR_FUNCTION(wcsncpy)((dest), (src), (n))#define STRSPN(s1, s2) (DWORD)MAKE_STR_FUNCTION(wcsspn)((s1), (s2))
#define STRRCHR (LPTSTR)MAKE_STR_FUNCTION(wcsrchr)
#define STRTAIL(s1, s2) (LPTSTR)MAKE_STR_FUNCTION(wcstail)((s1), (s2))
#define STRUPR(s) (LPTSTR)MAKE_STR_FUNCTION(wcsupr)(s)
// these don't have formal parameters because we want to take the address of
// the mapped function in certain cases. Modify as appropriate.
// Note that for these functions, lengths are in characters.
// compare functions: len is maximum number of characters being compared.
#define STRCMP wcscmp
#define STRICMP (LONG)MAKE_STR_FUNCTION(_wcsicmp)
#define STRNCMP (LONG)MAKE_STR_FUNCTION(wcsncmp)
#define STRNICMP (LONG)MAKE_STR_FUNCTION(_wcsnicmp)
#define TOLOWER(tchar) towlower(tchar) // locale-dependent.
#define TOUPPER(tchar) towupper(tchar) // locale-dependent.
//
// manifests
//
#define _CHAR_TYPE WCHAR
#else // not UNICODE
#include <string.h> // strlen(), etc.
//
// function macro prototypes
//
#define ISALNUM(tchar) isalnum(tchar) // locale-dependent.
#define ISALPHA(tchar) isalpha(tchar) // locale-dependent.
#define ISCNTRL(tchar) iscntrl(tchar) // locale-dependent.
#define ISDIGIT(tchar) isdigit(tchar)
#define ISGRAPH(tchar) isgraph(tchar) // locale-dependent.
#define ISLOWER(tchar) islower(tchar) // locale-dependent.
#define ISPRINT(tchar) isprint(tchar) // locale-dependent.
#define ISPUNCT(tchar) ispunct(tchar) // locale-dependent.
#define ISSPACE(tchar) isspace(tchar) // locale-dependent.
#define ISUPPER(tchar) isupper(tchar) // locale-dependent.
#define ISXDIGIT(tchar) isxdigit(tchar)
#define STRCAT(dest, src) (LPTSTR)MAKE_STR_FUNCTION(strcat)((dest), (src))
#define STRNCAT(dest, src, n) \
(LPTSTR)MAKE_STR_FUNCTION(strncat)((dest), (src), (n))// STRLEN: Get character count of s.
#define STRLEN(s) (DWORD)MAKE_STR_FUNCTION(strlen)(s)
#define STRSPN(s1, s2) (DWORD)MAKE_STR_FUNCTION(strspn)((s1), (s2))
#define STRCSPN(s, c) (DWORD)MAKE_STR_FUNCTION(strcspn)((s), (c))
#define STRCPY(dest, src) (LPTSTR)MAKE_STR_FUNCTION(strcpy)((dest), (src))
#define STRNCPY(dest, src, n) \
(LPTSTR)MAKE_STR_FUNCTION(strncpy)((dest), (src), (n))#define STRCHR(s1, c) (LPTSTR)MAKE_STR_FUNCTION(strchr)((s1), (c))
#define STRRCHR (LPTSTR)MAKE_STR_FUNCTION(strrchr)
#define STRTAIL(s1, s2) (LPTSTR)MAKE_STR_FUNCTION(strtail)((s1), (s2))
#define STRUPR(s) (LPTSTR)MAKE_STR_FUNCTION(strupr)(s)
// these don't have formal parameters because we want to take the address of
// the mapped function in certain cases. Modify as appropriate.
// Note that for these functions, lengths are in characters.
// compare functions: len is maximum number of characters being compared.
#define STRCMP (LONG)MAKE_STR_FUNCTION(strcmp)
#define STRICMP (LONG)MAKE_STR_FUNCTION(_stricmp)
#define STRNCMP (LONG)MAKE_STR_FUNCTION(strncmp)
#define STRNICMP (LONG)MAKE_STR_FUNCTION(_strnicmp)
#define TOLOWER(tchar) tolower(tchar) // locale-dependent.
#define TOUPPER(tchar) toupper(tchar) // locale-dependent.
//
// manifests
//
#define _CHAR_TYPE TCHAR
#endif // not UNICODE
//
// For the memory routines, the counts are always BYTE counts.
//
#define MEMCPY memcpy
#define MEMMOVE memmove
//
// This is used to determine the number of bytes (including the NUL
// terminator) in a unicode string. This will generally be used when
// calculating the size of a string for allocation purposes.
//
#define STRSIZE(p) ((STRLEN(p)+1) * sizeof(TCHAR))
//
// character literals (both types)
//
#define TCHAR_EOS ((_CHAR_TYPE)'\0')
#define TCHAR_STAR ((_CHAR_TYPE)'*')
#define TCHAR_BACKSLASH ((_CHAR_TYPE)'\\')
#define TCHAR_FWDSLASH ((_CHAR_TYPE)'/')
#define TCHAR_COLON ((_CHAR_TYPE)':')
#define TCHAR_DOT ((_CHAR_TYPE)'.')
#define TCHAR_SPACE ((_CHAR_TYPE)' ')
//
// General purpose macro for casting character types to whatever type in vogue
// (as defined in this file)
//
#define MAKE_TCHAR(c) ((_CHAR_TYPE)(c))
//
// IS_PATH_SEPARATOR
//
// lifted from curdir.c and changed to use TCHAR_ character literals, checks
// if a character is a path separator i.e. is a member of the set [\/]
//
#define IS_PATH_SEPARATOR(ch) ((ch == TCHAR_BACKSLASH) || (ch == TCHAR_FWDSLASH))
//
// The following 2 macros lifted from I_Net canonicalization files
//
#define IS_DRIVE(c) ISALPHA(c)
#define IS_NON_ZERO_DIGIT(c) (((c) >= MAKE_TCHAR('1')) && ((c) <= MAKE_TCHAR('9')))
//
// STRING_SPACE_REQD returns a number (of bytes) corresponding to the space
// required in which (n) characters can be accomodated
//
#define STRING_SPACE_REQD(n) ((n) * sizeof(_CHAR_TYPE))
//
// DOWN_LEVEL_STRLEN returns the number of single-byte characters necessary to
// store a converted _CHAR_TYPE string. This will be WCHAR (or wchar_t) if
// UNICODE is defined or TCHAR (or char) otherwise
//
#define DOWN_LEVEL_STRSIZE(n) ((n) / sizeof(_CHAR_TYPE))
#endif // _TSTRING_H_INCLUDED
|
