xref: /third_party/node/deps/cares/src/lib/ares_str.h (revision 1cb0ef41)
1/* MIT License
2 *
3 * Copyright (c) 1998 Massachusetts Institute of Technology
4 * Copyright (c) The c-ares project and its contributors
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice (including the next
14 * paragraph) shall be included in all copies or substantial portions of the
15 * Software.
16 *
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23 * SOFTWARE.
24 *
25 * SPDX-License-Identifier: MIT
26 */
27#ifndef HEADER_CARES_STRDUP_H
28#define HEADER_CARES_STRDUP_H
29
30#include "ares_setup.h"
31#include "ares.h"
32
33char         *ares_strdup(const char *s1);
34
35size_t        ares_strlen(const char *str);
36
37/*! Copy string from source to destination with destination buffer size
38 *  provided.  The destination is guaranteed to be null terminated, if the
39 *  provided buffer isn't large enough, only those bytes from the source that
40 *  will fit will be copied.
41 *
42 *  \param[out] dest       Destination buffer
43 *  \param[in]  src        Source to copy
44 *  \param[in]  dest_size  Size of destination buffer
45 *  \return String length.  Will be at most dest_size-1
46 */
47size_t        ares_strcpy(char *dest, const char *src, size_t dest_size);
48
49ares_bool_t   ares_str_isnum(const char *str);
50
51unsigned char ares__tolower(unsigned char c);
52ares_bool_t   ares__memeq_ci(const unsigned char *ptr, const unsigned char *val,
53                             size_t len);
54
55#endif /* HEADER_CARES_STRDUP_H */
56