3 * Copyright 2015 gRPC authors.
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
9 * http://www.apache.org/licenses/LICENSE-2.0
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.
19 #ifndef GRPC_COMPRESSION_H
20 #define GRPC_COMPRESSION_H
22 #include <grpc/impl/codegen/port_platform.h>
26 #include <grpc/impl/codegen/compression_types.h>
27 #include <grpc/slice.h>
33 /** Return if an algorithm is message compression algorithm. */
34 GRPCAPI int grpc_compression_algorithm_is_message(
35 grpc_compression_algorithm algorithm);
37 /** Return if an algorithm is stream compression algorithm. */
38 GRPCAPI int grpc_compression_algorithm_is_stream(
39 grpc_compression_algorithm algorithm);
41 /** Parses the \a slice as a grpc_compression_algorithm instance and updating \a
42 * algorithm. Returns 1 upon success, 0 otherwise. */
43 GRPCAPI int grpc_compression_algorithm_parse(
44 grpc_slice value, grpc_compression_algorithm* algorithm);
46 /** Updates \a name with the encoding name corresponding to a valid \a
47 * algorithm. Note that \a name is statically allocated and must *not* be freed.
48 * Returns 1 upon success, 0 otherwise. */
49 GRPCAPI int grpc_compression_algorithm_name(
50 grpc_compression_algorithm algorithm, const char** name);
52 /** Returns the compression algorithm corresponding to \a level for the
53 * compression algorithms encoded in the \a accepted_encodings bitset.*/
54 GRPCAPI grpc_compression_algorithm grpc_compression_algorithm_for_level(
55 grpc_compression_level level, uint32_t accepted_encodings);
57 GRPCAPI void grpc_compression_options_init(grpc_compression_options* opts);
59 /** Mark \a algorithm as enabled in \a opts. */
60 GRPCAPI void grpc_compression_options_enable_algorithm(
61 grpc_compression_options* opts, grpc_compression_algorithm algorithm);
63 /** Mark \a algorithm as disabled in \a opts. */
64 GRPCAPI void grpc_compression_options_disable_algorithm(
65 grpc_compression_options* opts, grpc_compression_algorithm algorithm);
67 /** Returns true if \a algorithm is marked as enabled in \a opts. */
68 GRPCAPI int grpc_compression_options_is_algorithm_enabled(
69 const grpc_compression_options* opts, grpc_compression_algorithm algorithm);
75 #endif /* GRPC_COMPRESSION_H */