From b382b968ab7b4b011070c3df449d72ae852c9869 Mon Sep 17 00:00:00 2001 From: kpfleming Date: Fri, 24 Jun 2005 22:50:07 +0000 Subject: add new header files git-svn-id: http://svn.digium.com/svn/asterisk/trunk@6009 f38db490-d61c-443f-a65b-d21fe96a405b --- include/asterisk/compiler.h | 19 ++++ include/asterisk/strings.h | 226 ++++++++++++++++++++++++++++++++++++++++++++ include/asterisk/time.h | 35 +++++++ 3 files changed, 280 insertions(+) create mode 100755 include/asterisk/compiler.h create mode 100755 include/asterisk/strings.h create mode 100755 include/asterisk/time.h diff --git a/include/asterisk/compiler.h b/include/asterisk/compiler.h new file mode 100755 index 000000000..137e9e146 --- /dev/null +++ b/include/asterisk/compiler.h @@ -0,0 +1,19 @@ +/* + * Asterisk -- A telephony toolkit for Linux. + * + * Compiler-specific macros and other items + * + * Copyright (C) 2005, Digium, Inc. + * + * This program is free software, distributed under the terms of + * the GNU General Public License + */ + +#ifndef _ASTERISK_COMPILER_H +#define _ASTERISK_COMPILER_H + +#if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 96) +#define __builtin_expect(exp, c) (exp) +#endif + +#endif /* _ASTERISK_COMPILER_H */ diff --git a/include/asterisk/strings.h b/include/asterisk/strings.h new file mode 100755 index 000000000..eee85a551 --- /dev/null +++ b/include/asterisk/strings.h @@ -0,0 +1,226 @@ +/* + * Asterisk -- A telephony toolkit for Linux. + * + * String manipulation functions + * + * Copyright (C) 2005, Digium, Inc. + * + * This program is free software, distributed under the terms of + * the GNU General Public License + */ + +#ifndef _ASTERISK_STRINGS_H +#define _ASTERISK_STRINGS_H + +#include + +#include "asterisk/compiler.h" + +static inline int ast_strlen_zero(const char *s) +{ + return (*s == '\0'); +} + +/*! + \brief Gets a pointer to the first non-whitespace character in a string. + \param str the input string + \return a pointer to the first non-whitespace character + */ +char *ast_skip_blanks(char *str); +#if !defined(LOW_MEMORY) && !defined(AST_API_MODULE) +extern inline +#endif +#if !defined(LOW_MEMORY) || defined(AST_API_MODULE) +char *ast_skip_blanks(char *str) +{ + while (*str && *str < 33) + str++; + return str; +} +#endif + +/*! + \brief Trims trailing whitespace characters from a string. + \param str the input string + \return a pointer to the NULL following the string + */ +char *ast_trim_blanks(char *str); +#if !defined(LOW_MEMORY) && !defined(AST_API_MODULE) +extern inline +#endif +#if !defined(LOW_MEMORY) || defined(AST_API_MODULE) +char *ast_trim_blanks(char *str) +{ + char *work = str; + + if (work) { + work += strlen(work) - 1; + /* It's tempting to only want to erase after we exit this loop, + but since ast_trim_blanks *could* receive a constant string + (which we presumably wouldn't have to touch), we shouldn't + actually set anything unless we must, and it's easier just + to set each position to \0 than to keep track of a variable + for it */ + while ((work >= str) && *work < 33) + *(work--) = '\0'; + } + return str; +} +#endif + +/*! + \brief Gets a pointer to first whitespace character in a string. + \param str the input string + \return a pointer to the first whitespace character + */ +char *ast_skip_nonblanks(char *str); +#if !defined(LOW_MEMORY) && !defined(AST_API_MODULE) +extern inline +#endif +#if !defined(LOW_MEMORY) || defined(AST_API_MODULE) +char *ast_skip_nonblanks(char *str) +{ + while (*str && *str > 32) + str++; + return str; +} +#endif + +/*! + \brief Strip leading/trailing whitespace from a string. + \param s The string to be stripped (will be modified). + \return The stripped string. + + This functions strips all leading and trailing whitespace + characters from the input string, and returns a pointer to + the resulting string. The string is modified in place. +*/ +char *ast_strip(char *s); +#if !defined(LOW_MEMORY) && !defined(AST_API_MODULE) +extern inline +#endif +#if !defined(LOW_MEMORY) || defined(AST_API_MODULE) +char *ast_strip(char *s) +{ + s = ast_skip_blanks(s); + if (s) + ast_trim_blanks(s); + return s; +} +#endif + +/*! + \brief Strip leading/trailing whitespace and quotes from a string. + \param s The string to be stripped (will be modified). + \param beg_quotes The list of possible beginning quote characters. + \param end_quotes The list of matching ending quote characters. + \return The stripped string. + + This functions strips all leading and trailing whitespace + characters from the input string, and returns a pointer to + the resulting string. The string is modified in place. + + It can also remove beginning and ending quote (or quote-like) + characters, in matching pairs. If the first character of the + string matches any character in beg_quotes, and the last + character of the string is the matching character in + end_quotes, then they are removed from the string. + + Examples: + \code + ast_strip_quoted(buf, "\"", "\""); + ast_strip_quoted(buf, "'", "'"); + ast_strip_quoted(buf, "[{(", "]})"); + \endcode + */ +char *ast_strip_quoted(char *s, const char *beg_quotes, const char *end_quotes); + +/*! + \brief Size-limited null-terminating string copy. + \param dst The destination buffer. + \param src The source string + \param size The size of the destination buffer + \return Nothing. + + This is similar to \a strncpy, with two important differences: + - the destination buffer will \b always be null-terminated + - the destination buffer is not filled with zeros past the copied string length + These differences make it slightly more efficient, and safer to use since it will + not leave the destination buffer unterminated. There is no need to pass an artificially + reduced buffer size to this function (unlike \a strncpy), and the buffer does not need + to be initialized to zeroes prior to calling this function. +*/ +void ast_copy_string(char *dst, const char *src, size_t size); +#if !defined(LOW_MEMORY) && !defined(AST_API_MODULE) +extern inline +#endif +#if !defined(LOW_MEMORY) || defined(AST_API_MODULE) +void ast_copy_string(char *dst, const char *src, size_t size) +{ + while (*src && size) { + *dst++ = *src++; + size--; + } + if (__builtin_expect(!size, 0)) + dst--; + *dst = '\0'; +} +#endif + +/*! + \brief Build a string in a buffer, designed to be called repeatedly + + This is a wrapper for snprintf, that properly handles the buffer pointer + and buffer space available. + + \return 0 on success, non-zero on failure. + \param buffer current position in buffer to place string into (will be updated on return) + \param space remaining space in buffer (will be updated on return) + \param fmt printf-style format string +*/ +int ast_build_string(char **buffer, size_t *space, const char *fmt, ...) __attribute__ ((format (printf, 3, 4))); + +/*! Make sure something is true */ +/*! + * Determine if a string containing a boolean value is "true". + * This function checks to see whether a string passed to it is an indication of an "true" value. It checks to see if the string is "yes", "true", "y", "t", "on" or "1". + * + * Returns 0 if val is a NULL pointer, -1 if "true", and 0 otherwise. + */ +int ast_true(const char *val); + +/*! Make sure something is false */ +/*! + * Determine if a string containing a boolean value is "false". + * This function checks to see whether a string passed to it is an indication of an "false" value. It checks to see if the string is "no", "false", "n", "f", "off" or "0". + * + * Returns 0 if val is a NULL pointer, -1 if "false", and 0 otherwise. + */ +int ast_false(const char *val); + +/* The realloca lets us ast_restrdupa(), but you can't mix any other ast_strdup calls! */ + +struct ast_realloca { + char *ptr; + int alloclen; +}; + +#define ast_restrdupa(ra, s) \ + ({ \ + if ((ra)->ptr && strlen(s) + 1 < (ra)->alloclen) { \ + strcpy((ra)->ptr, s); \ + } else { \ + (ra)->ptr = alloca(strlen(s) + 1 - (ra)->alloclen); \ + if ((ra)->ptr) (ra)->alloclen = strlen(s) + 1; \ + } \ + (ra)->ptr; \ + }) + +#ifdef __linux__ +#define ast_strcasestr strcasestr +#else +extern char *ast_strcasestr(const char *, const char *); +#endif /* __linux__ */ + +#undef AST_API_MODULE +#endif /* _ASTERISK_STRINGS_H */ diff --git a/include/asterisk/time.h b/include/asterisk/time.h new file mode 100755 index 000000000..a92e1f91e --- /dev/null +++ b/include/asterisk/time.h @@ -0,0 +1,35 @@ +/* + * Asterisk -- A telephony toolkit for Linux. + * + * Time-related functions and macros + * + * Copyright (C) 2004 - 2005, Digium, Inc. + * + * This program is free software, distributed under the terms of + * the GNU General Public License + */ + +#ifndef _ASTERISK_TIME_H +#define _ASTERISK_TIME_H + +#include + +/*! + * \brief Computes the difference (in milliseconds) between two \c struct \c timeval instances. + * \param start the beginning of the time period + * \param end the end of the time period + * \return the difference in milliseconds + */ +int ast_tvdiff_ms(const struct timeval *start, const struct timeval *end); +#if !defined(LOW_MEMORY) && !defined(AST_API_MODULE) +extern inline +#endif +#if !defined(LOW_MEMORY) || defined(AST_API_MODULE) +int ast_tvdiff_ms(const struct timeval *start, const struct timeval *end) +{ + return ((end->tv_sec - start->tv_sec) * 1000) + ((end->tv_usec - start->tv_usec) / 1000); +} +#endif + +#undef AST_API_MODULE +#endif /* _ASTERISK_TIME_H */ -- cgit v1.2.3