| /* |
| * |
| * Copyright 2015, Google Inc. |
| * All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions are |
| * met: |
| * |
| * * Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * * Redistributions in binary form must reproduce the above |
| * copyright notice, this list of conditions and the following disclaimer |
| * in the documentation and/or other materials provided with the |
| * distribution. |
| * * Neither the name of Google Inc. nor the names of its |
| * contributors may be used to endorse or promote products derived from |
| * this software without specific prior written permission. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| * |
| */ |
| |
| #ifndef GRPC_CORE_LIB_SUPPORT_STRING_H |
| #define GRPC_CORE_LIB_SUPPORT_STRING_H |
| |
| #include <stddef.h> |
| |
| #include <grpc/slice.h> |
| #include <grpc/slice_buffer.h> |
| #include <grpc/support/port_platform.h> |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /* String utility functions */ |
| |
| /* Flags for gpr_dump function. */ |
| #define GPR_DUMP_HEX 0x00000001 |
| #define GPR_DUMP_ASCII 0x00000002 |
| |
| /* Converts array buf, of length len, into a C string according to the flags. |
| Result should be freed with gpr_free() */ |
| char *gpr_dump(const char *buf, size_t len, uint32_t flags); |
| |
| /* Parses an array of bytes into an integer (base 10). Returns 1 on success, |
| 0 on failure. */ |
| int gpr_parse_bytes_to_uint32(const char *data, size_t length, |
| uint32_t *result); |
| |
| /* Minimum buffer size for calling ltoa */ |
| #define GPR_LTOA_MIN_BUFSIZE (3 * sizeof(long)) |
| |
| /* Convert a long to a string in base 10; returns the length of the |
| output string (or 0 on failure). |
| output must be at least GPR_LTOA_MIN_BUFSIZE bytes long. */ |
| int gpr_ltoa(long value, char *output); |
| |
| /* Minimum buffer size for calling int64toa */ |
| #define GPR_INT64TOA_MIN_BUFSIZE (3 * sizeof(int64_t)) |
| |
| /* Convert an int64 to a string in base 10; returns the length of the |
| output string (or 0 on failure). |
| output must be at least GPR_INT64TOA_MIN_BUFSIZE bytes long. |
| NOTE: This function ensures sufficient bit width even on Win x64, |
| where long is 32bit is size.*/ |
| int int64_ttoa(int64_t value, char *output); |
| |
| // Parses a non-negative number from a value string. Returns -1 on error. |
| int gpr_parse_nonnegative_int(const char *value); |
| |
| /* Reverse a run of bytes */ |
| void gpr_reverse_bytes(char *str, int len); |
| |
| /* Pad a string with flag characters. The given length specifies the minimum |
| field width. The input string is never truncated. */ |
| char *gpr_leftpad(const char *str, char flag, size_t length); |
| |
| /* Join a set of strings, returning the resulting string. |
| Total combined length (excluding null terminator) is returned in total_length |
| if it is non-null. */ |
| char *gpr_strjoin(const char **strs, size_t nstrs, size_t *total_length); |
| |
| /* Join a set of strings using a separator, returning the resulting string. |
| Total combined length (excluding null terminator) is returned in total_length |
| if it is non-null. */ |
| char *gpr_strjoin_sep(const char **strs, size_t nstrs, const char *sep, |
| size_t *total_length); |
| |
| /* A vector of strings... for building up a final string one piece at a time */ |
| typedef struct { |
| char **strs; |
| size_t count; |
| size_t capacity; |
| } gpr_strvec; |
| |
| /* Initialize/destroy */ |
| void gpr_strvec_init(gpr_strvec *strs); |
| void gpr_strvec_destroy(gpr_strvec *strs); |
| /* Add a string to a strvec, takes ownership of the string */ |
| void gpr_strvec_add(gpr_strvec *strs, char *add); |
| /* Return a joined string with all added substrings, optionally setting |
| total_length as per gpr_strjoin */ |
| char *gpr_strvec_flatten(gpr_strvec *strs, size_t *total_length); |
| |
| /** Case insensitive string comparison... return <0 if lower(a)<lower(b), ==0 if |
| lower(a)==lower(b), >0 if lower(a)>lower(b) */ |
| int gpr_stricmp(const char *a, const char *b); |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* GRPC_CORE_LIB_SUPPORT_STRING_H */ |