/*
- * Copyright (C) 2006-2013 Andre Noll <maan@systemlinux.org>
+ * Copyright (C) 2006 Andre Noll <maan@tuebingen.mpg.de>
*
* Licensed under the GPL v2. For licencing details see COPYING.
*/
-/** \file string.h exported sybmols from string.c */
+/** \file string.h exported symbols from string.c */
/** Flags that change how content is printed into the buffer. */
enum para_buffer_flags {
size_t size;
/** The maximal size this buffer may grow. Zero means unlimited. */
size_t max_size;
- /** \sa para_buffer_flags. */
+ /** \sa \ref para_buffer_flags. */
unsigned flags;
/** The next para_printf() will write at this offset. */
size_t offset;
/**
* Controls the behavior of for_each_line().
*
- * \sa for_each_line().
+ * \sa \ref for_each_line().
*/
enum for_each_line_flags {
/** Activate read-only mode. */
line_handler_t *line_handler, void *private_data);
/**
- * Write the contents of a status item to a para_buffer.
- *
- * \param b The para_buffer.
- * \param n The number of the status item.
- * \param f A format string.
- *
- * \return The return value of the underlying call to para_printf().
- */
+ * Write the contents of a status item to a para_buffer.
+ *
+ * \param b The para_buffer.
+ * \param n The number of the status item.
+ * \param f A format string.
+ *
+ * \return The return value of the underlying call to \ref para_printf().
+ */
#define WRITE_STATUS_ITEM(b, n, f, ...) (\
{ \
- int _ret; \
if ((b)->flags & PBF_SIZE_PREFIX) { \
- _ret = para_printf((b), "%02x:" f, n, ## __VA_ARGS__); \
+ para_printf((b), "%02x:" f, (unsigned)n, ## __VA_ARGS__); \
} else { \
- _ret = para_printf((b), "%s: " f, status_item_list[(n)], \
+ para_printf((b), "%s: " f, status_item_list[(n)], \
## __VA_ARGS__); \
} \
- _ret; \
} \
)
__must_check __malloc char *para_strcat(char *a, const char *b);
__must_check __malloc char *para_dirname(const char *name);
__must_check char *para_basename(const char *name);
-void chop(char *buf);
__must_check __malloc char *para_logname(void);
__must_check __malloc char *para_homedir(void);
__malloc char *para_hostname(void);
char *key_value_copy(const char *src, size_t len, const char *key);
int skip_cells(const char *s, size_t cells_to_skip, size_t *result);
__must_check int strwidth(const char *s, size_t *result);
+__must_check int sanitize_str(const char *src, size_t max_width,
+ char **result, size_t *width);