b9aef704ea83512a7fbb46fdccf88266dad4845b
[users/jgh/exim.git] / src / src / mytypes.h
1 /*************************************************
2 *     Exim - an Internet mail transport agent    *
3 *************************************************/
4
5 /* Copyright (c) University of Cambridge 1995 - 2012 */
6 /* See the file NOTICE for conditions of use and distribution. */
7
8
9 /* This header file contains type definitions and macros that I use as
10 "standard" in the code of Exim and its utilities. Make it idempotent because
11 local_scan.h includes it and exim.h includes them both (to get this earlier). */
12
13 #ifndef MYTYPES_H
14 #define MYTYPES_H
15
16 #ifndef FALSE
17 #define FALSE         0
18 #endif
19
20 #ifndef TRUE
21 #define TRUE          1
22 #endif
23
24 #ifndef TRUE_UNSET
25 #define TRUE_UNSET    2
26 #endif
27
28
29 /* If gcc is being used to compile Exim, we can use its facility for checking
30 the arguments of printf-like functions. This is done by a macro. */
31
32 #if defined(__GNUC__) || defined(__clang__)
33 #define PRINTF_FUNCTION(A,B)  __attribute__((format(printf,A,B)))
34 #define ARG_UNUSED  __attribute__((__unused__))
35 #else
36 #define PRINTF_FUNCTION(A,B)
37 #define ARG_UNUSED  /**/
38 #endif
39
40 #ifdef WANT_DEEPER_PRINTF_CHECKS
41 #define ALMOST_PRINTF(A, B) PRINTF_FUNCTION(A, B)
42 #else
43 #define ALMOST_PRINTF(A, B)
44 #endif
45
46
47 /* Some operating systems (naughtily, imo) include a definition for "uchar" in
48 the standard header files, so we use "uschar". Solaris has u_char in
49 sys/types.h. This is just a typing convenience, of course. */
50
51 typedef unsigned char uschar;
52 typedef int BOOL;
53 /* We also have SIGNAL_BOOL, which requires signal.h be included, so is defined
54 elsewhere */
55
56
57 /* These macros save typing for the casting that is needed to cope with the
58 mess that is "char" in ISO/ANSI C. Having now been bitten enough times by
59 systems where "char" is actually signed, I've converted Exim to use entirely
60 unsigned chars, except in a few special places such as arguments that are
61 almost always literal strings. */
62
63 #define CS   (char *)
64 #define CCS  (const char *)
65 #define CSS  (char **)
66 #define US   (unsigned char *)
67 #define CUS  (const unsigned char *)
68 #define USS  (unsigned char **)
69 #define CUSS (const unsigned char **)
70
71 /* The C library string functions expect "char *" arguments. Use macros to
72 avoid having to write a cast each time. We do this for string and file
73 functions that are called quite often; for other calls to external libraries
74 (which are on the whole special-purpose) we just use individual casts. */
75
76 #define Uatoi(s)           atoi(CCS(s))
77 #define Uatol(s)           atol(CCS(s))
78 #define Uchdir(s)          chdir(CCS(s))
79 #define Uchmod(s,n)        chmod(CCS(s),n)
80 #define Uchown(s,n,m)      chown(CCS(s),n,m)
81 #define Ufgets(b,n,f)      fgets(CS(b),n,f)
82 #define Ufopen(s,t)        fopen(CCS(s),CCS(t))
83 #define Ulink(s,t)         link(CCS(s),CCS(t))
84 #define Ulstat(s,t)        lstat(CCS(s),t)
85
86 #ifdef O_BINARY                                        /* This is for Cygwin,  */
87 #define Uopen(s,n,m)       open(CCS(s),(n)|O_BINARY,m) /* where all files must */
88 #else                                                  /* be opened as binary  */
89 #define Uopen(s,n,m)       open(CCS(s),n,m)            /* to avoid problems    */
90 #endif                                                 /* with CRLF endings.   */
91 #define Uread(f,b,l)       read(f,CS(b),l)
92 #define Urename(s,t)       rename(CCS(s),CCS(t))
93 #define Ustat(s,t)         stat(CCS(s),t)
94 #define Ustrcat(s,t)       strcat(CS(s),CCS(t))
95 #define Ustrchr(s,n)       US strchr(CCS(s),n)
96 #define CUstrchr(s,n)      CUS strchr(CCS(s),n)
97 #define CUstrerror(n)      CUS strerror(n)
98 #define Ustrcmp(s,t)       strcmp(CCS(s),CCS(t))
99 #define Ustrcpy(s,t)       strcpy(CS(s),CCS(t))
100 #define Ustrcspn(s,t)      strcspn(CCS(s),CCS(t))
101 #define Ustrftime(s,m,f,t) strftime(CS(s),m,f,t)
102 #define Ustrlen(s)         (int)strlen(CCS(s))
103 #define Ustrncat(s,t,n)    strncat(CS(s),CCS(t),n)
104 #define Ustrncmp(s,t,n)    strncmp(CCS(s),CCS(t),n)
105 #define Ustrncpy(s,t,n)    strncpy(CS(s),CCS(t),n)
106 #define Ustrpbrk(s,t)      strpbrk(CCS(s),CCS(t))
107 #define Ustrrchr(s,n)      US strrchr(CCS(s),n)
108 #define CUstrrchr(s,n)     CUS strrchr(CCS(s),n)
109 #define Ustrspn(s,t)       strspn(CCS(s),CCS(t))
110 #define Ustrstr(s,t)       US strstr(CCS(s),CCS(t))
111 #define CUstrstr(s,t)      CUS strstr(CCS(s),CCS(t))
112 #define Ustrtod(s,t)       strtod(CCS(s),CSS(t))
113 #define Ustrtol(s,t,b)     strtol(CCS(s),CSS(t),b)
114 #define Ustrtoul(s,t,b)    strtoul(CCS(s),CSS(t),b)
115 #define Uunlink(s)         unlink(CCS(s))
116 #endif
117
118 /* End of mytypes.h */