X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=string.h;h=d28b0ac4633e5457f97da5b00465973f3c6bba6c;hp=e5033db2b91bd3ca4f0e4a6b27474f924f74343f;hb=bc086fe5537bd3078b920454958b61287a75c568;hpb=69f0930489da9ace5af8aee104ad21d188aed387 diff --git a/string.h b/string.h index e5033db2..d28b0ac4 100644 --- a/string.h +++ b/string.h @@ -1,33 +1,61 @@ /* - * Copyright (C) 2006 Andre Noll + * Copyright (C) 2006-2009 Andre Noll * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. + * Licensed under the GPL v2. For licencing details see COPYING. */ /** \file string.h exported sybmols from string.c */ -/** contains name/replacement pairs used by s_a_r_list() - * - * \sa s_a_r() - */ -struct para_macro { - /** the name of the macro */ - const char *name; - /** the replacement text */ - const char *replacement; +/** Flags that change how content is printed into the buffer. */ +enum para_buffer_flags { + /** Prefix each buffer with its length. */ + PBF_SIZE_PREFIX = 1, }; + +/** 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; + /** \sa para_buffer_flags. */ + unsigned flags; + /** 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; +}; + +/** + * 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(). + */ +#define WRITE_STATUS_ITEM(b, n, f, ...) (\ +{ \ + int _ret; \ + if ((b)->flags & PBF_SIZE_PREFIX) { \ + _ret = para_printf((b), "%02x:" f, n, ## __VA_ARGS__); \ + } else { \ + _ret = para_printf((b), "%s: " f, status_item_list[(n)], \ + ## __VA_ARGS__); \ + } \ + _ret; \ +} \ +) + __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); @@ -35,15 +63,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); -__must_check __malloc char *s_a_r(const char *src, const char* regex, const char *replacement); -__must_check __malloc char *s_a_r_list(struct para_macro *pm, char *src); -void chop(char* buf); -__must_check __malloc char *para_tmpname(void); -__must_check int para_mkstemp(char *template, mode_t mode); +__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); -__must_check unsigned split_args(char *args, char ***argv_ptr, const char *delim); +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, + 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);