-
-/*
- * utils.c -- various utility routines
+/* utils.c -- various utility routines
*
* This code is Copyright (c) 2006, by the authors of nmh. See the
* COPYRIGHT file in the root directory of the nmh distribution for
* complete copyright information.
*/
-#include <h/mh.h>
-#include <h/utils.h>
+#include "h/mh.h"
+#include "read_yes_or_no_if_tty.h"
+#include "concat.h"
+#include "r1bindex.h"
+#include "context_foil.h"
+#include "context_replace.h"
+#include "context_read.h"
+#include "context_find.h"
+#include "print_help.h"
+#include "error.h"
+#include "h/utils.h"
+#include "h/signals.h"
+#include "m_mktemp.h"
+#include "makedir.h"
#include <fcntl.h>
-
-/* sbr/signals.c */
-extern int setup_signal_handlers();
-
-/* sbr/m_mktemp.c */
-extern void remove_registered_files_atexit();
+#include <limits.h>
+#include "read_line.h"
extern char *mhdocdir;
+/* plurals gives the letter ess to indicate a plural noun, or an empty
+ * string as plurals+1 for the singular noun. Used by the PLURALS
+ * macro. */
+const char plurals[] = "s";
+
/*
* We allocate space for messages (msgs array)
* this number of elements at a time.
#define MAXMSGS 256
/* Call malloc(3), exiting on NULL return. */
-void *mh_xmalloc(size_t size)
+void *
+mh_xmalloc(size_t size)
{
void *p;
size = 1; /* Some mallocs don't like 0. */
p = malloc(size);
if (!p)
- adios(NULL, "malloc failed, size wanted: %zu", size);
+ die("malloc failed, size wanted: %zu", size);
return p;
}
/* Call realloc(3), exiting on NULL return. */
-void *mh_xrealloc(void *ptr, size_t size)
+void *
+mh_xrealloc(void *ptr, size_t size)
{
void *new;
/* Copy POSIX behaviour, coping with non-POSIX systems. */
if (size == 0) {
- mh_xfree(ptr);
+ free(ptr);
return mh_xmalloc(1); /* Get a unique pointer. */
}
if (!ptr)
new = realloc(ptr, size);
if (!new)
- adios(NULL, "realloc failed, size wanted: %zu", size);
+ die("realloc failed, size wanted: %zu", size);
return new;
}
/* Call calloc(3), exiting on NULL return. */
-void *mh_xcalloc(size_t nelem, size_t elsize)
+void *
+mh_xcalloc(size_t nelem, size_t elsize)
{
void *p;
p = calloc(nelem, elsize);
if (!p)
- adios(NULL, "calloc failed, size wanted: %zu * %zu", nelem, elsize);
+ die("calloc failed, size wanted: %zu * %zu", nelem, elsize);
return p;
}
/* Duplicate a NUL-terminated string, exit on failure. */
-char *mh_xstrdup(const char *src)
+char *
+mh_xstrdup(const char *src)
{
size_t n;
char *dest;
return dest;
}
-/* Call free(3), if ptr isn't NULL. */
-void mh_xfree(void *ptr)
-{
- if (ptr)
- free(ptr); /* Some very old platforms can't cope with NULL. */
-}
-
/*
* Return the present working directory, if the current directory does not
* exist, or is too long, make / the pwd.
static char curwd[PATH_MAX];
if (!getcwd (curwd, PATH_MAX)) {
- admonish (NULL, "unable to determine working directory");
+ inform("unable to determine working directory, continuing...");
if (!mypath || !*mypath
|| (strcpy (curwd, mypath), chdir (curwd)) == -1) {
strcpy (curwd, "/");
return curwd;
}
-/*
- * add -- If "s1" is NULL, this routine just creates a
- * -- copy of "s2" into newly malloc'ed memory.
- * --
- * -- If "s1" is not NULL, then copy the concatenation
- * -- of "s1" and "s2" (note the order) into newly
- * -- malloc'ed memory. Then free "s1".
+/* add returns a newly malloc'd string, exiting on failure. The order
+ * of the parameters is unusual. A NULL parameter is treated as an
+ * empty string. s1 is free'd. Use mh_xstrdup(s) rather than add(s,
+ * NULL), with FENDNULL() if s might be NULL.
+ *
+ * add(NULL, NULL) -> ""
+ * add(NULL, "foo") -> "foo"
+ * add("bar", NULL) -> "bar"
+ * add("bar", "foo") -> "foobar"
*/
char *
add (const char *s2, char *s1)
* folder_exists
* Check to see if a folder exists.
*/
-int folder_exists(const char *folder)
+int
+folder_exists(const char *folder)
{
struct stat st;
- int exists = 0;
-
- if (stat (folder, &st) == -1) {
- /* The folder either doesn't exist, or we hit an error. Either way
- * return a failure.
- */
- exists = 0;
- } else {
- /* We can see a folder with the right name */
- exists = 1;
- }
- return exists;
+ return stat(folder, &st) != -1;
}
-
/*
* create_folder
* Check to see if a folder exists, if not, prompt the user to create
* it.
*/
-void create_folder(char *folder, int autocreate, void (*done_callback)(int))
+void
+create_folder(char *folder, int autocreate, void (*done_callback)(int))
{
struct stat st;
extern int errno;
done_callback (1);
}
if (!makedir (folder))
- adios (NULL, "unable to create folder %s", folder);
+ die("unable to create folder %s", folder);
}
}
/* Sanity check */
if (n < 0)
- adios (NULL, "oops, num_digits called with negative value");
+ die("oops, num_digits called with negative value");
if (n == 0)
return 1;
msgs->msgnums[msgs->size++] = msgnum;
}
-/* Open a form or components file */
-int
-open_form(char **form, char *def)
-{
- int in;
- if (*form) {
- if ((in = open (etcpath (*form), O_RDONLY)) == NOTOK)
- adios (*form, "unable to open form file");
- } else {
- if ((in = open (etcpath (def), O_RDONLY)) == NOTOK)
- adios (def, "unable to open default components file");
- *form = def;
- }
- return in;
-}
-
/*
* Finds first occurrence of str in buf. buf is not a C string but a
* pointer so that the caller can modify it.
*/
char *
-find_str (const char buf[], size_t buflen, const char *str) {
+find_str (const char buf[], size_t buflen, const char *str)
+{
const size_t len = strlen (str);
size_t i;
* pointer so that the caller can modify it.
*/
char *
-rfind_str (const char buf[], size_t buflen, const char *str) {
+rfind_str (const char buf[], size_t buflen, const char *str)
+{
const size_t len = strlen (str);
size_t i;
/* POSIX doesn't have strcasestr() so emulate it. */
char *
-nmh_strcasestr (const char *s1, const char *s2) {
+nmh_strcasestr (const char *s1, const char *s2)
+{
const size_t len = strlen (s2);
if (isupper ((unsigned char) s2[0]) || islower ((unsigned char)s2[0])) {
}
-/* HasPrefix returns true if non-NULL s starts with non-NULL prefix. */
-bool HasPrefix(const char *s, const char *prefix)
+/* truncpy copies at most size - 1 chars from non-NULL src to non-NULL,
+ * non-overlapping, dst, and ensures dst is NUL terminated. If size is
+ * zero then it aborts as dst cannot be NUL terminated.
+ *
+ * It's to be used when truncation is intended and correct, e.g.
+ * reporting a possibly very long external string back to the user. One
+ * of its advantages over strncpy(3) is it doesn't pad in the common
+ * case of no truncation. */
+void
+trunccpy(char *dst, const char *src, size_t size)
+{
+ if (!size) {
+ inform("trunccpy: zero-length destination: \"%.20s\"",
+ src ? src : "null");
+ abort();
+ }
+
+ if (strnlen(src, size) < size) {
+ strcpy(dst, src);
+ } else {
+ memcpy(dst, src, size - 1);
+ dst[size - 1] = '\0';
+ }
+}
+
+
+/* has_prefix returns true if non-NULL s starts with non-NULL prefix. */
+bool
+has_prefix(const char *s, const char *prefix)
{
while (*s && *s == *prefix) {
s++;
}
-/* HasSuffixC returns true if non-NULL string s ends with a c before the
+/* has_suffix returns true if non-NULL s ends with non-NULL suffix. */
+bool
+has_suffix(const char *s, const char *suffix)
+{
+ size_t ls, lsuf;
+
+ ls = strlen(s);
+ lsuf = strlen(suffix);
+
+ return lsuf <= ls && !strcmp(s + ls - lsuf, suffix);
+}
+
+
+/* has_suffix_c returns true if non-NULL string s ends with a c before the
* terminating NUL. */
-bool HasSuffixC(char *s, int c)
+bool
+has_suffix_c(const char *s, int c)
{
return *s && s[strlen(s) - 1] == c;
}
-/* TrimSuffixC deletes c from the end of non-NULL string s if it's
+/* trim_suffix_c deletes c from the end of non-NULL string s if it's
* present, shortening s by 1. Only one instance of c is removed. */
-void TrimSuffixC(char *s, int c)
+void
+trim_suffix_c(char *s, int c)
{
if (!*s)
return;
}
-/* ToLower runs all of s through tolower(3). */
-void ToLower(char *s)
+/* to_lower runs all of s through tolower(3). */
+void
+to_lower(char *s)
{
unsigned char *b;
}
-/* ToUpper runs all of s through toupper(3). */
-void ToUpper(char *s)
+/* to_upper runs all of s through toupper(3). */
+void
+to_upper(char *s)
{
unsigned char *b;
int
-nmh_init(const char *argv0, int read_context) {
+nmh_init(const char *argv0, bool read_context, bool check_version)
+{
int status = OK;
char *locale;
/* Read context, if supposed to. */
if (read_context) {
- int allow_version_check = 1;
- int check_older_version = 0;
char *cp;
context_read();
- if (read_context != 1 ||
+ bool allow_version_check = true;
+ bool check_older_version = false;
+ if (!check_version ||
((cp = context_find ("Welcome")) && strcasecmp (cp, "disable") == 0)) {
- allow_version_check = 0;
+ allow_version_check = false;
} else if ((cp = getenv ("MHCONTEXT")) != NULL && *cp != '\0') {
/* Context file comes from $MHCONTEXT, so only print the message
if the context file has an older version. If it does, or if it
doesn't have a version at all, update the version. */
- check_older_version = 1;
+ check_older_version = true;
}
/* Check to see if the user is running a different (or older, if
- specified) version of nmh than they had run bfore, and notify them
- if so. But only if read_context was set to a value to enable. */
+ specified) version of nmh than they had run before, and notify them
+ if so. */
if (allow_version_check && isatty (fileno (stdin)) &&
isatty (fileno (stdout)) && isatty (fileno (stderr))) {
if (nmh_version_changed (check_older_version)) {
}
if (! setlocale (LC_ALL, locale)) {
- admonish (NULL, "setlocale failed, check your LC_ALL, LC_CTYPE, and "
- "LANG environment variables");
+ inform("setlocale failed, check your LC_ALL, LC_CTYPE, and LANG "
+ "environment variables, continuing...");
}
return status;
* use that prefix here.
*/
int
-nmh_version_changed (int older) {
+nmh_version_changed (int older)
+{
const char *const context_version = context_find("Version");
if (older) {
break for versions with multiple decimal points, etc. */
const float current_version = strtof (VERSION, NULL);
const float old_version =
- context_version && strncmp (context_version, "nmh-", 4) == 0
+ context_version && has_prefix(context_version, "nmh-")
? strtof (context_version + 4, NULL)
: 99999999;
context_replace ("Version", "nmh-" VERSION);
}
- return old_version < current_version ? 1 : 0;
+ return old_version < current_version;
}
if (context_version == NULL || strcmp(context_version, "nmh-" VERSION) != 0) {
}
-/* Returns copy of argument str with all characters converted to upper
- case, and trimmed whitespace (see cpytrim()) . */
-char *
-upcase (const char *str) {
- char *up = cpytrim (str);
-
- ToUpper(up);
-
- return up;
-}
-
-
-/*
- * Scan for any 8-bit characters. Return 1 if they exist.
- *
- * Scan up until the given endpoint (but not the actual endpoint itself).
- * If the endpoint is NULL, scan until a '\0' is reached.
- */
-
-int
+/* contains8bit returns true if any byte from start onwards fails
+ * isascii(3), i.e. is outside [0, 0x7f]. If start is NULL it returns
+ * false. Bytes are examined until a NUL byte, or, if end is not NULL,
+ * whilst start is before end. */
+bool
contains8bit(const char *start, const char *end)
{
- if (! start)
- return 0;
+ const char *p;
+ char c;
- while (*start != '\0' && (!end || (start < end)))
- if (! isascii((unsigned char) *start++))
- return 1;
+ if (!start)
+ return false;
- return 0;
+ p = start;
+ if (end) {
+ while (p < end && (c = (*p++)))
+ if (!isascii((unsigned char)c))
+ return true;
+ } else {
+ while ((c = (*p++)))
+ if (!isascii((unsigned char)c))
+ return true;
+ }
+
+ return false;
}
* See if input has any 8-bit bytes.
*/
int
-scan_input (int fd, int *eightbit) {
+scan_input (int fd, int *eightbit)
+{
int state;
char buf[BUFSIZ];
*eightbit = 0;
- lseek (fd, (off_t) 0, SEEK_SET);
+ lseek(fd, 0, SEEK_SET);
while ((state = read (fd, buf, sizeof buf)) > 0) {
if (contains8bit (buf, buf + state)) {
return state == NOTOK ? NOTOK : OK;
}
+
+
+/*
+ * Convert an int to a char string.
+ */
+char *
+m_str(int value)
+{
+ return m_strn(value, 0);
+}
+
+
+/*
+ * Convert an int to a char string, of limited width if > 0.
+ */
+#define STR(s) #s
+/* SIZE(n) includes NUL. n must just be digits, not an equation. */
+#define SIZE(n) (sizeof STR(n))
+
+char *
+m_strn(int value, unsigned int width)
+{
+ /* Need to include space for negative sign. But don't use INT_MIN
+ because it could be a macro that would fool SIZE(n). */
+ static char buffer[SIZE(-INT_MAX)];
+ const int num_chars = snprintf(buffer, sizeof buffer, "%d", value);
+
+ return num_chars > 0 && (width == 0 || (unsigned int) num_chars <= width)
+ ? buffer
+ : "?";
+}
projects / nmh / blobdiff