X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=string.h;h=61bb7c25b04998ed1c6616240f2e51f6627a5360;hp=9dbe9420e27dbf5989a6f18d4eb4e0d48d51d581;hb=a7b65e41e2062c44c535f7cb4609e7988fc8ac0d;hpb=63c4f3404cfb3aea943949d81b03bca14dbea559 diff --git a/string.h b/string.h index 9dbe9420..61bb7c25 100644 --- a/string.h +++ b/string.h @@ -1,10 +1,10 @@ /* - * Copyright (C) 2006-2009 Andre Noll + * Copyright (C) 2006 Andre Noll * * 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 { @@ -34,6 +34,23 @@ struct para_buffer { void *private_data; }; +/** + * Controls the behavior of for_each_line(). + * + * \sa for_each_line(). + */ +enum for_each_line_flags { + /** Activate read-only mode. */ + FELF_READ_ONLY = 1 << 0, + /** Don't call line handler for the first input line. */ + FELF_DISCARD_FIRST = 1 << 1, +}; + +/** Used for \ref for_each_line(). */ +typedef int line_handler_t(char *, void *); +int for_each_line(unsigned flags, char *buf, size_t size, + line_handler_t *line_handler, void *private_data); + /** * Write the contents of a status item to a para_buffer. * @@ -45,14 +62,12 @@ struct para_buffer { */ #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, 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; \ } \ ) @@ -60,26 +75,29 @@ __must_check __malloc void *para_realloc(void *p, size_t size); __must_check __malloc void *para_malloc(size_t size); __must_check __malloc void *para_calloc(size_t size); __must_check __malloc char *para_strdup(const char *s); + +__printf_2_0 unsigned xvasprintf(char **result, const char *fmt, va_list ap); +__printf_2_3 unsigned xasprintf(char **result, const char *fmt, ...); __must_check __malloc __printf_1_2 char *make_message(const char *fmt, ...); __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); __printf_2_3 int para_printf(struct para_buffer *b, const char *fmt, ...); -/** Used for for_each_line() and for_each_line_ro(). */ -typedef int line_handler_t(char *, void *); -int for_each_line(char *buf, size_t size, line_handler_t *line_handler, - void *private_data); -int for_each_line_ro(char *buf, size_t size, line_handler_t *line_handler, - void *private_data); int para_atoi64(const char *str, int64_t *result); int para_atoi32(const char *str, int32_t *value); int get_loglevel_by_name(const char *txt); int read_size_header(const char *buf); int create_argv(const char *buf, const char *delim, char ***result); +int create_shifted_argv(const char *buf, const char *delim, char ***result); +int find_arg(const char *arg, char **argv); void free_argv(char **argv); int para_regcomp(regex_t *preg, const char *regex, int cflags); void freep(void *arg); +int compute_word_num(const char *buf, const char *delim, int offset); +char *safe_strdup(const char *src, size_t len); +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);