diff options
Diffstat (limited to '1.2-netsec/include/asterisk/strings.h')
-rw-r--r-- | 1.2-netsec/include/asterisk/strings.h | 251 |
1 files changed, 0 insertions, 251 deletions
diff --git a/1.2-netsec/include/asterisk/strings.h b/1.2-netsec/include/asterisk/strings.h deleted file mode 100644 index 52bbc3629..000000000 --- a/1.2-netsec/include/asterisk/strings.h +++ /dev/null @@ -1,251 +0,0 @@ -/* - * Asterisk -- An open source telephony toolkit. - * - * Copyright (C) 1999 - 2005, Digium, Inc. - * - * Mark Spencer <markster@digium.com> - * - * See http://www.asterisk.org for more information about - * the Asterisk project. Please do not directly contact - * any of the maintainers of this project for assistance; - * the project provides a web site, mailing lists and IRC - * channels for your use. - * - * This program is free software, distributed under the terms of - * the GNU General Public License Version 2. See the LICENSE file - * at the top of the source tree. - */ - -/*! \file - * \brief String manipulation functions - */ - -#ifndef _ASTERISK_STRINGS_H -#define _ASTERISK_STRINGS_H - -#include <string.h> -#include <stdarg.h> - -#include "asterisk/inline_api.h" -#include "asterisk/compiler.h" -#include "asterisk/compat.h" - -static force_inline int ast_strlen_zero(const char *s) -{ - return (!s || (*s == '\0')); -} - -/*! - \brief Gets a pointer to the first non-whitespace character in a string. - \param ast_skip_blanks function being used - \param str the input string - \return a pointer to the first non-whitespace character - */ -AST_INLINE_API( -char *ast_skip_blanks(char *str), -{ - while (*str && *str < 33) - str++; - return str; -} -) - -/*! - \brief Trims trailing whitespace characters from a string. - \param ast_trim_blanks function being used - \param str the input string - \return a pointer to the modified string - */ -AST_INLINE_API( -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; -} -) - -/*! - \brief Gets a pointer to first whitespace character in a string. - \param ast_skip_noblanks function being used - \param str the input string - \return a pointer to the first whitespace character - */ -AST_INLINE_API( -char *ast_skip_nonblanks(char *str), -{ - while (*str && *str > 32) - str++; - return str; -} -) - -/*! - \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. -*/ -AST_INLINE_API( -char *ast_strip(char *s), -{ - s = ast_skip_blanks(s); - if (s) - ast_trim_blanks(s); - return s; -} -) - -/*! - \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 ast_copy_string function being used - \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. -*/ -AST_INLINE_API( -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'; -} -) - -/*! - \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. - - \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 - \return 0 on success, non-zero on failure. -*/ -int ast_build_string(char **buffer, size_t *space, const char *fmt, ...) __attribute__ ((format (printf, 3, 4))); - -/*! - \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 - \param ap varargs list of arguments for format -*/ -int ast_build_string_va(char **buffer, size_t *space, const char *fmt, va_list ap); - -/*! 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; \ - }) - -#ifndef HAVE_STRCASESTR -char *strcasestr(const char *, const char *); -#endif - -#if !defined(HAVE_STRNDUP) && !defined(__AST_DEBUG_MALLOC) -char *strndup(const char *, size_t); -#endif - -#ifndef HAVE_STRNLEN -size_t strnlen(const char *, size_t); -#endif - -#if !defined(HAVE_VASPRINTF) && !defined(__AST_DEBUG_MALLOC) -int vasprintf(char **strp, const char *fmt, va_list ap); -#endif - -#ifndef HAVE_STRTOQ -uint64_t strtoq(const char *nptr, char **endptr, int base); -#endif - -#endif /* _ASTERISK_STRINGS_H */ |