legacy-libs/grpc-cloned/deps/grpc/src/core/lib/uri/uri_parser.h

   1 /*
   2  *
   3  * Copyright 2015 gRPC authors.
   4  *
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at
   8  *
   9  *     http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  *
  17  */
  18
  19 #ifndef GRPC_CORE_LIB_URI_URI_PARSER_H
  20 #define GRPC_CORE_LIB_URI_URI_PARSER_H
  21
  22 #include <grpc/support/port_platform.h>
  23
  24 #include <stddef.h>
  25
  26 typedef struct {
  27   char* scheme;
  28   char* authority;
  29   char* path;
  30   char* query;
  31   /** Query substrings separated by '&' */
  32   char** query_parts;
  33   /** Number of elements in \a query_parts and \a query_parts_values */
  34   size_t num_query_parts;
  35   /** Split each query part by '='. NULL if not present. */
  36   char** query_parts_values;
  37   char* fragment;
  38 } grpc_uri;
  39
  40 /** parse a uri, return NULL on failure */
  41 grpc_uri* grpc_uri_parse(const char* uri_text, bool suppress_errors);
  42
  43 /** return the part of a query string after the '=' in "?key=xxx&...", or NULL
  44  * if key is not present */
  45 const char* grpc_uri_get_query_arg(const grpc_uri* uri, const char* key);
  46
  47 /** destroy a uri */
  48 void grpc_uri_destroy(grpc_uri* uri);
  49
  50 #endif /* GRPC_CORE_LIB_URI_URI_PARSER_H */