d5c738c608
Designed to aid converting off from sscanf parsers. sscanf is hard to use right, easy to mess up and often makes for sloppy error checking. The new parsers allow more exact and pedandic parsing. This new set of functions should be possible to use (and extend) and switch over other libcurl parser code to use going forward. Adapts the following to use the new functions: - altsvc.c - hsts.c - http_aws_sigv4.c Bonus: fewer memory copies, fewer stack buffers. Test: Unit test1664 Docs: docs/internals/STRPARSE.md Closes #15692
72 lines
2.3 KiB
C
72 lines
2.3 KiB
C
#ifndef HEADER_CURL_STRPARSE_H
|
|
#define HEADER_CURL_STRPARSE_H
|
|
/***************************************************************************
|
|
* _ _ ____ _
|
|
* Project ___| | | | _ \| |
|
|
* / __| | | | |_) | |
|
|
* | (__| |_| | _ <| |___
|
|
* \___|\___/|_| \_\_____|
|
|
*
|
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
*
|
|
* This software is licensed as described in the file COPYING, which
|
|
* you should have received as part of this distribution. The terms
|
|
* are also available at https://curl.se/docs/copyright.html.
|
|
*
|
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
|
* copies of the Software, and permit persons to whom the Software is
|
|
* furnished to do so, under the terms of the COPYING file.
|
|
*
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
* KIND, either express or implied.
|
|
*
|
|
* SPDX-License-Identifier: curl
|
|
*
|
|
***************************************************************************/
|
|
#include "curl_setup.h"
|
|
|
|
#define STRE_OK 0
|
|
#define STRE_BIG 1
|
|
#define STRE_SHORT 2
|
|
#define STRE_BEGQUOTE 3
|
|
#define STRE_ENDQUOTE 4
|
|
#define STRE_BYTE 5
|
|
#define STRE_NEWLINE 6
|
|
#define STRE_OVERFLOW 7
|
|
|
|
struct Curl_str {
|
|
char *str;
|
|
size_t len;
|
|
};
|
|
|
|
/* Get a word until the first space
|
|
return non-zero on error */
|
|
int Curl_str_word(char **linep, struct Curl_str *out, const size_t max);
|
|
|
|
/* Get a word until the first DELIM or end of string
|
|
return non-zero on error */
|
|
int Curl_str_until(char **linep, struct Curl_str *out, const size_t max,
|
|
char delim);
|
|
|
|
/* Get a "quoted" word. No escaping possible.
|
|
return non-zero on error */
|
|
int Curl_str_quotedword(char **linep, struct Curl_str *out, const size_t max);
|
|
|
|
/* Advance over a single character.
|
|
return non-zero on error */
|
|
int Curl_str_single(char **linep, char byte);
|
|
|
|
/* Advance over a single space.
|
|
return non-zero on error */
|
|
int Curl_str_singlespace(char **linep);
|
|
|
|
/* Get an unsigned number
|
|
return non-zero on error */
|
|
int Curl_str_number(char **linep, size_t *nump, size_t max);
|
|
|
|
/* Check for CR or LF
|
|
return non-zero on error */
|
|
int Curl_str_newline(char **linep);
|
|
|
|
#endif /* HEADER_CURL_STRPARSE_H */
|