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_SRC_CORE_LIB_SLICE_B64_H
20 #define GRPC_SRC_CORE_LIB_SLICE_B64_H
21 
22 #include <grpc/support/port_platform.h>
23 
24 #include <stddef.h>
25 
26 #include <grpc/slice.h>
27 
28 // Encodes data using base64. It is the caller's responsibility to free
29 // the returned char * using gpr_free. Returns NULL on NULL input.
30 // TODO(makdharma) : change the flags to bool from int
31 char* grpc_base64_encode(const void* data, size_t data_size, int url_safe,
32                          int multiline);
33 
34 // estimate the upper bound on size of base64 encoded data. The actual size
35 // is guaranteed to be less than or equal to the size returned here.
36 size_t grpc_base64_estimate_encoded_size(size_t data_size, int multiline);
37 
38 // Encodes data using base64 and write it to memory pointed to by result. It is
39 // the caller's responsibility to allocate enough memory in |result| to fit the
40 // encoded data.
41 void grpc_base64_encode_core(char* result, const void* vdata, size_t data_size,
42                              int url_safe, int multiline);
43 
44 // Decodes data according to the base64 specification. Returns an empty
45 // slice in case of failure.
46 grpc_slice grpc_base64_decode(const char* b64, int url_safe);
47 
48 // Same as above except that the length is provided by the caller.
49 grpc_slice grpc_base64_decode_with_len(const char* b64, size_t b64_len,
50                                        int url_safe);
51 
52 #endif  // GRPC_SRC_CORE_LIB_SLICE_B64_H
53