diplodocus.org Git - nmh/blob - h/utils.h

   1
   2 /*
   3  * utils.h -- utility prototypes
   4  */
   5
   6 /* Call malloc(3), exiting on NULL return. */
   7 void *mh_xmalloc(size_t size);
   8
   9 /* Call realloc(3), exiting on NULL return. */
  10 void *mh_xrealloc(void *ptr, size_t size);
  11
  12 /* Call calloc(3), exiting on NULL return. */
  13 void *mh_xcalloc(size_t nelem, size_t elsize);
  14
  15 /* Duplicate a NUL-terminated string, exit on failure. */
  16 char *mh_xstrdup(const char *src);
  17
  18 /* Call free(3), if ptr isn't NULL. */
  19 void mh_xfree(void *ptr);
  20
  21 /* Set p to point to newly allocated, uninitialised, memory. */
  22 #define NEW(p) ((p) = mh_xmalloc(sizeof *(p)))
  23
  24 /* Set p to point to newly allocated, zeroed, memory. */
  25 #define NEW0(p) ((p) = mh_xcalloc(1, sizeof *(p)))
  26
  27 char *pwd(void);
  28 char *add(const char *, char *);
  29 char *addlist(char *, const char *);
  30 int folder_exists(const char *);
  31 void create_folder(char *, int, void (*)(int));
  32 int num_digits(int);
  33
  34 /*
  35  * A vector of char array, used to hold a list of string message numbers
  36  * or command arguments.
  37  */
  38
  39 struct msgs_array {
  40         int max, size;
  41         char **msgs;
  42 };
  43
  44 /*
  45  * Same as msgs_array, but for a vector of ints
  46  */
  47
  48 struct msgnum_array {
  49         int max, size;
  50         int *msgnums;
  51 };
  52
  53 /*
  54  * Add a argument to the given msgs_array or msgnum_array structure; extend
  55  * the array size if necessary
  56  */
  57
  58 void app_msgarg(struct msgs_array *, char *);
  59 void app_msgnum(struct msgnum_array *, int);
  60
  61 int open_form(char **, char *);
  62 char *find_str (const char [], size_t, const char *);
  63 char *rfind_str (const char [], size_t, const char *);
  64 char *nmh_strcasestr (const char *, const char *);
  65
  66 bool HasPrefix(const char *s, const char *prefix);
  67 bool HasSuffix(const char *s, const char *suffix);
  68 bool HasSuffixC(const char *s, int c);
  69 void TrimSuffixC(char *s, int c);
  70 void ToLower(char *s);
  71 void ToUpper(char *s);
  72
  73 /*
  74  * See if a string contains 8 bit characters (use isascii() for the test).
  75  * Arguments include:
  76  *
  77  * start        - Pointer to start of string to test.
  78  * end          - End of string to test (test will stop before reaching
  79  *                this point).  If NULL, continue until reaching '\0'.
  80  *
  81  * This function always stops at '\0' regardless of the value of 'end'.
  82  * Returns 1 if the string contains an 8-bit character, 0 if it does not.
  83  */
  84 int contains8bit(const char *start, const char *end);
  85
  86 /*
  87  * See if file has any 8-bit bytes.
  88  * Arguments include:
  89  *
  90  * fd           - file descriptor
  91  * eightbit     - address of result, will be set to 1 if the file contains
  92  *                any 8-bit bytes, 0 otherwise.
  93  *
  94  * Returns OK on success, NOTOK on read failure.
  95  *
  96  */
  97 int scan_input (int fd, int *eightbit);
  98
  99
 100 /*
 101  * Compares prior version of nmh with current version.  Returns 1
 102  * if they compare the be the same, 0 if not.
 103  *
 104  * older        - 0 for difference comparison, 1 for only if older
 105  */
 106 int nmh_version_changed (int older);