lib-lib/str.h

   1 /*
   2  *  This program is free software; you can redistribute it and/or modify
   3  *  it under the terms of the GNU General Public License as published by
   4  *  the Free Software Foundation; either version 2 of the License, or (at
   5  *  your option) any later version.
   6  *
   7  *  This program is distributed in the hope that it will be useful, but
   8  *  WITHOUT ANY WARRANTY; without even the implied warranty of
   9  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  10  *  General Public License for more details.
  11  *
  12  *  You should have received a copy of the GNU General Public License
  13  *  along with this program; if not, write to the Free Software
  14  *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
  15  *  MA 02110-1301, USA.
  16  *
  17  *  Copyright © 2006 Pierre Habouzit
  18  */
  19
  20 #ifndef MUTT_LIB_LIB_STR_H
  21 #define MUTT_LIB_LIB_STR_H
  22
  23 #include <string.h>
  24 #include <ctype.h>
  25
  26 #include "mem.h"
  27
  28 #define HUGE_STRING     5120
  29 #define LONG_STRING     1024
  30 #define STRING          256
  31 #define SHORT_STRING    128
  32
  33 #define NONULL(x) (x?x:"")
  34 #define ISSPACE(c) isspace((unsigned char)c)
  35
  36 extern unsigned char const __m_strdigits[128];
  37 extern signed char const __m_b64digits[128];
  38 extern char const __m_b64chars[64];
  39
  40 extern char const __m_b36chars_lower[36];
  41 extern char const __m_b36chars_upper[36];
  42
  43 /****************************************************************************/
  44 /* conversions                                                              */
  45 /****************************************************************************/
  46
  47 static inline int hexval(int c) {
  48     return !(c & ~127) && __m_strdigits[c] < 16 ? __m_strdigits[c] : -1;
  49 }
  50
  51 static inline int base64val(int c) {
  52     return (c & ~127) ? -1 : __m_b64digits[c];
  53 }
  54
  55 static inline void m_strtolower(char *p) {
  56     for (; *p; p++)
  57         *p = tolower((unsigned char)*p);
  58 }
  59
  60 /****************************************************************************/
  61 /* length related                                                           */
  62 /****************************************************************************/
  63
  64 static inline int m_strisempty(const char *s) {
  65     return !s || !*s;
  66 }
  67
  68 static inline ssize_t m_strlen(const char *s) {
  69     return s ? strlen(s) : 0;
  70 }
  71
  72 static inline ssize_t m_strnlen(const char *s, ssize_t n) {
  73     const char *p = memchr(s, '\0', n);
  74     return p ? p - s : n;
  75 }
  76
  77 /****************************************************************************/
  78 /* comparisons                                                              */
  79 /****************************************************************************/
  80
  81 static inline int m_strcmp(const char *a, const char *b) {
  82     return strcmp(NONULL(a), NONULL(b));
  83 }
  84
  85 static inline int m_strcasecmp(const char *a, const char *b) {
  86     return strcasecmp(NONULL(a), NONULL(b));
  87 }
  88
  89 static inline int m_strncmp(const char *a, const char *b, ssize_t n) {
  90     return strncmp (NONULL(a), NONULL(b), n);
  91 }
  92
  93 static inline int m_strncasecmp(const char *a, const char *b, ssize_t n) {
  94     return strncasecmp(NONULL(a), NONULL(b), n);
  95 }
  96
  97 /****************************************************************************/
  98 /* making copies                                                            */
  99 /****************************************************************************/
 100
 101 static inline char *m_strdup(const char *s) {
 102     ssize_t len = m_strlen(s);
 103     return len ? p_dup(s, len + 1) : NULL;
 104 }
 105
 106 static inline char *m_substrdup(const char *s, const char *end) {
 107     return p_dupstr(s, end ? end - s : m_strlen(s));
 108 }
 109
 110 static inline char *m_strreplace(char **p, const char *s) {
 111     p_delete(p);
 112     return (*p = m_strdup(s));
 113 }
 114
 115 ssize_t m_strcpy(char *dst, ssize_t n, const char *src);
 116 ssize_t m_strncpy(char *dst, ssize_t n, const char *src, ssize_t l);
 117
 118 static inline ssize_t m_strcat(char *dst, ssize_t n, const char *src) {
 119     ssize_t dlen = m_strnlen(dst, n - 1);
 120     return dlen + m_strcpy(dst + dlen, n - dlen, src);
 121 }
 122
 123 static inline ssize_t
 124 m_strncat(char *dst, ssize_t n, const char *src, ssize_t l) {
 125     ssize_t dlen = m_strnlen(dst, n - 1);
 126     return dlen + m_strncpy(dst + dlen, n - dlen, src, l);
 127 }
 128
 129 /****************************************************************************/
 130 /* parsing related                                                          */
 131 /****************************************************************************/
 132
 133 static inline const char *skipspaces(const char *s) {
 134     while (*s && isspace((unsigned char)*s))
 135         s++;
 136     return s;
 137 }
 138 static inline char *vskipspaces(const char *s) {
 139     return (char *)skipspaces(s);
 140 }
 141
 142 char *m_strrtrim(char *s);
 143
 144 /****************************************************************************/
 145 /* search                                                                   */
 146 /****************************************************************************/
 147
 148 const char *
 149 m_stristrn(const char *haystack, const char *needle, ssize_t nlen);
 150
 151 static inline const char *
 152 m_stristr(const char *haystack, const char *needle) {
 153     return m_stristrn(haystack, needle, m_strlen(needle));
 154 }
 155
 156 #endif /* MUTT_LIB_LIB_STR_H */