mirror of
https://github.com/curl/curl.git
synced 2025-04-18 16:30:45 +08:00
0c6e63a1be
Curl_hexbyte - output a byte as a two-digit ASCII hex number Curl_hexval - convert an ASCII hex digit to its binary value ... instead of duplicating similar code and hexdigit strings in numerous places. Closes #16888
119 lines
4.2 KiB
C
119 lines
4.2 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
|
|
#define STRE_NO_NUM 8
|
|
|
|
/* public struct, but all accesses should be done using the provided
|
|
functions */
|
|
struct Curl_str {
|
|
const char *str;
|
|
size_t len;
|
|
};
|
|
|
|
void Curl_str_init(struct Curl_str *out);
|
|
void Curl_str_assign(struct Curl_str *out, const char *str, size_t len);
|
|
|
|
#define Curl_str(x) ((x)->str)
|
|
#define Curl_strlen(x) ((x)->len)
|
|
|
|
/* Get a word until the first space
|
|
return non-zero on error */
|
|
int Curl_str_word(const 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(const char **linep, struct Curl_str *out, const size_t max,
|
|
char delim);
|
|
|
|
/* Get a word until a newline byte or end of string. At least one byte long.
|
|
return non-zero on error */
|
|
int Curl_str_untilnl(const char **linep, struct Curl_str *out,
|
|
const size_t max);
|
|
|
|
/* Get a "quoted" word. No escaping possible.
|
|
return non-zero on error */
|
|
int Curl_str_quotedword(const char **linep, struct Curl_str *out,
|
|
const size_t max);
|
|
|
|
/* Advance over a single character.
|
|
return non-zero on error */
|
|
int Curl_str_single(const char **linep, char byte);
|
|
|
|
/* Advance over a single space.
|
|
return non-zero on error */
|
|
int Curl_str_singlespace(const char **linep);
|
|
|
|
/* Get an unsigned decimal number. Return non-zero on error */
|
|
int Curl_str_number(const char **linep, curl_off_t *nump, curl_off_t max);
|
|
|
|
/* As above with CURL_OFF_T_MAX but also pass leading blanks */
|
|
int Curl_str_numblanks(const char **str, curl_off_t *num);
|
|
|
|
/* Get an unsigned hexadecimal number. Return non-zero on error */
|
|
int Curl_str_hex(const char **linep, curl_off_t *nump, curl_off_t max);
|
|
|
|
/* Get an unsigned octal number. Return non-zero on error */
|
|
int Curl_str_octal(const char **linep, curl_off_t *nump, curl_off_t max);
|
|
|
|
/* Check for CR or LF
|
|
return non-zero on error */
|
|
int Curl_str_newline(const char **linep);
|
|
|
|
/* case insensitive compare that the parsed string matches the
|
|
given string. */
|
|
int Curl_str_casecompare(struct Curl_str *str, const char *check);
|
|
int Curl_str_cmp(struct Curl_str *str, const char *check);
|
|
|
|
int Curl_str_nudge(struct Curl_str *str, size_t num);
|
|
|
|
int Curl_str_cspn(const char **linep, struct Curl_str *out, const char *cspn);
|
|
void Curl_str_trimblanks(struct Curl_str *out);
|
|
void Curl_str_passblanks(const char **linep);
|
|
|
|
/* given a hexadecimal letter, return the binary value. '0' returns 0, 'a'
|
|
returns 10. THIS ONLY WORKS ON VALID HEXADECIMAL LETTER INPUT. Verify
|
|
before calling this!
|
|
*/
|
|
extern const unsigned char Curl_hexasciitable[];
|
|
#define Curl_hexval(x) (unsigned char)(Curl_hexasciitable[(x) - '0'] & 0x0f)
|
|
|
|
#define curlx_str_number(x,y,z) Curl_str_number(x,y,z)
|
|
#define curlx_str_octal(x,y,z) Curl_str_octal(x,y,z)
|
|
#define curlx_str_single(x,y) Curl_str_single(x,y)
|
|
#define curlx_str_passblanks(x) Curl_str_passblanks(x)
|
|
#define curlx_str_numblanks(x,y) Curl_str_numblanks(x,y)
|
|
|
|
#endif /* HEADER_CURL_STRPARSE_H */
|