mirror of
				https://github.com/espressif/esp-idf.git
				synced 2025-11-03 22:08:28 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			87 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			87 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*
 | 
						|
 * SPDX-FileCopyrightText: 2015-2021 Espressif Systems (Shanghai) CO LTD
 | 
						|
 *
 | 
						|
 * SPDX-License-Identifier: Apache-2.0
 | 
						|
 */
 | 
						|
 | 
						|
 | 
						|
#ifndef _HTTP_UTILS_H_
 | 
						|
#define _HTTP_UTILS_H_
 | 
						|
#include <sys/time.h>
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief      Assign new_str to *str pointer, and realloc *str if it not NULL
 | 
						|
 *
 | 
						|
 * @param      str      pointer to string pointer
 | 
						|
 * @param      new_str  assign this tring to str
 | 
						|
 * @param      len      length of string, less than 0 if new_str is zero terminated
 | 
						|
 *
 | 
						|
 * @return
 | 
						|
 *  - new_str pointer
 | 
						|
 *  - NULL
 | 
						|
 */
 | 
						|
char *http_utils_assign_string(char **str, const char *new_str, int len);
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief      Realloc *str and append new_str to it if new_str is not NULL; return *str pointer if new_str is NULL
 | 
						|
 *
 | 
						|
 * @param      str      pointer to string pointer
 | 
						|
 * @param      new_str  append this string to str
 | 
						|
 * @param      len      length of string, less than 0 if new_str is zero terminated
 | 
						|
 *
 | 
						|
 * @return
 | 
						|
 *  - *str pointer
 | 
						|
 */
 | 
						|
char *http_utils_append_string(char **str, const char *new_str, int len);
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief      Remove white space at begin and end of string
 | 
						|
 *
 | 
						|
 * @param[in]  str   The string
 | 
						|
 *
 | 
						|
 * @return     New strings have been trimmed
 | 
						|
 */
 | 
						|
void http_utils_trim_whitespace(char **str);
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief      Gets the string between 2 string.
 | 
						|
 *             It will allocate a new memory space for this string, so you need to free it when no longer use
 | 
						|
 *
 | 
						|
 * @param[in]  str    The source string
 | 
						|
 * @param[in]  begin  The begin string
 | 
						|
 * @param[in]  end    The end string
 | 
						|
 *
 | 
						|
 * @return     The string between begin and end
 | 
						|
 */
 | 
						|
char *http_utils_get_string_between(const char *str, const char *begin, const char *end);
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief      Join 2 strings to one
 | 
						|
 *             It will allocate a new memory space for this string, so you need to free it when no longer use
 | 
						|
 *
 | 
						|
 * @param[in]  first_str   The first string
 | 
						|
 * @param[in]  len_first   The length first
 | 
						|
 * @param[in]  second_str  The second string
 | 
						|
 * @param[in]  len_second  The length second
 | 
						|
 *
 | 
						|
 * @return
 | 
						|
 * - New string pointer
 | 
						|
 * - NULL: Invalid input
 | 
						|
 */
 | 
						|
char *http_utils_join_string(const char *first_str, size_t len_first, const char *second_str, size_t len_second);
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief      Check if ``str`` is start with ``start``
 | 
						|
 *
 | 
						|
 * @param[in]  str    The string
 | 
						|
 * @param[in]  start  The start
 | 
						|
 *
 | 
						|
 * @return
 | 
						|
 *     - (-1) if length of ``start`` larger than length of ``str``
 | 
						|
 *     - (1) if ``start`` NOT starts with ``start``
 | 
						|
 *     - (0) if ``str`` starts with ``start``
 | 
						|
 */
 | 
						|
int http_utils_str_starts_with(const char *str, const char *start);
 | 
						|
 | 
						|
#endif
 |