X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=string.h;h=77e62e907263b6c15e4d470f2dc86951d9581269;hp=a2dfa4229c3c619207aee5b2af37811802d59023;hb=de9a70360fcd3b5285d280ad1f229f679d453603;hpb=2cfb78331c33cb74c6abf357e8221604c3c9ec47 diff --git a/string.h b/string.h index a2dfa422..77e62e90 100644 --- a/string.h +++ b/string.h @@ -1,15 +1,29 @@ /* - * Copyright (C) 2006-2007 Andre Noll + * Copyright (C) 2006-2009 Andre Noll * * Licensed under the GPL v2. For licencing details see COPYING. */ /** \file string.h exported sybmols from string.c */ +/** A string buffer used for para_printf(). */ struct para_buffer { + /** The buffer. May be \p NULL. */ char *buf; + /** The size of \a buf. */ size_t size; + /** The maximal size this buffer may grow. Zero means unlimited. */ + size_t max_size; + /** The next para_printf() will write at this offset. */ size_t offset; + /** + * If an attempt to print into this buffer is made that would need to + * grow \a buf to a size larger than \a max_size, then this function is + * called. + */ + int (*max_size_handler)(char *buf, size_t size, void *private_data); + /** Passed to max_size_handler(). */ + void *private_data; }; __must_check __malloc void *para_realloc(void *p, size_t size); @@ -19,19 +33,20 @@ __must_check __malloc char *para_strdup(const char *s); __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 __malloc char *para_basename(const char *name); -void chop(char* buf); +__must_check const char *para_basename(const char *name); +void chop(char *buf); __must_check __malloc char *para_tmpname(void); -__must_check int para_mkstemp(char *template, mode_t mode); __must_check __malloc char *para_logname(void); __must_check __malloc char *para_homedir(void); __must_check unsigned split_args(char *args, char *** const argv_ptr, const char *delim); __malloc char *para_hostname(void); -void valid_fd_012(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, +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);