GRPC C++  1.30.0
slice.h
Go to the documentation of this file.
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_IMPL_CODEGEN_SLICE_H
20 #define GRPC_IMPL_CODEGEN_SLICE_H
21 
23 
24 #include <stddef.h>
25 
27 
28 typedef struct grpc_slice grpc_slice;
29 
43 /* Inlined half of grpc_slice is allowed to expand the size of the overall type
44  by this many bytes */
45 #define GRPC_SLICE_INLINE_EXTRA_SIZE sizeof(void*)
46 
47 #define GRPC_SLICE_INLINED_SIZE \
48  (sizeof(size_t) + sizeof(uint8_t*) - 1 + GRPC_SLICE_INLINE_EXTRA_SIZE)
49 
50 struct grpc_slice_refcount;
60 struct grpc_slice {
61  struct grpc_slice_refcount* refcount;
64  size_t length;
65  uint8_t* bytes;
66  } refcounted;
68  uint8_t length;
70  } inlined;
71  } data;
72 };
73 
74 #define GRPC_SLICE_BUFFER_INLINE_ELEMENTS 8
75 
78 typedef struct grpc_slice_buffer {
82 
86  size_t count;
89  size_t capacity;
91  size_t length;
95 
96 #define GRPC_SLICE_START_PTR(slice) \
97  ((slice).refcount ? (slice).data.refcounted.bytes \
98  : (slice).data.inlined.bytes)
99 #define GRPC_SLICE_LENGTH(slice) \
100  ((slice).refcount ? (slice).data.refcounted.length \
101  : (slice).data.inlined.length)
102 #define GRPC_SLICE_SET_LENGTH(slice, newlen) \
103  ((slice).refcount ? ((slice).data.refcounted.length = (size_t)(newlen)) \
104  : ((slice).data.inlined.length = (uint8_t)(newlen)))
105 #define GRPC_SLICE_END_PTR(slice) \
106  GRPC_SLICE_START_PTR(slice) + GRPC_SLICE_LENGTH(slice)
107 #define GRPC_SLICE_IS_EMPTY(slice) (GRPC_SLICE_LENGTH(slice) == 0)
108 
109 #ifdef GRPC_ALLOW_GPR_SLICE_FUNCTIONS
110 
111 /* Duplicate GPR_* definitions */
112 #define GPR_SLICE_START_PTR(slice) \
113  ((slice).refcount ? (slice).data.refcounted.bytes \
114  : (slice).data.inlined.bytes)
115 #define GPR_SLICE_LENGTH(slice) \
116  ((slice).refcount ? (slice).data.refcounted.length \
117  : (slice).data.inlined.length)
118 #define GPR_SLICE_SET_LENGTH(slice, newlen) \
119  ((slice).refcount ? ((slice).data.refcounted.length = (size_t)(newlen)) \
120  : ((slice).data.inlined.length = (uint8_t)(newlen)))
121 #define GPR_SLICE_END_PTR(slice) \
122  GRPC_SLICE_START_PTR(slice) + GRPC_SLICE_LENGTH(slice)
123 #define GPR_SLICE_IS_EMPTY(slice) (GRPC_SLICE_LENGTH(slice) == 0)
124 
125 #endif /* GRPC_ALLOW_GPR_SLICE_FUNCTIONS */
126 
127 #endif /* GRPC_IMPL_CODEGEN_SLICE_H */
grpc_slice::grpc_slice_data::grpc_slice_inlined::bytes
uint8_t bytes[(sizeof(size_t)+sizeof(uint8_t *) - 1+sizeof(void *))]
Definition: slice.h:69
grpc_slice_buffer::inlined
grpc_slice inlined[8]
inlined elements to avoid allocations
Definition: slice.h:93
grpc_slice::refcount
struct grpc_slice_refcount * refcount
Definition: slice.h:61
grpc_slice::grpc_slice_data::grpc_slice_refcounted::length
size_t length
Definition: slice.h:64
GRPC_SLICE_BUFFER_INLINE_ELEMENTS
#define GRPC_SLICE_BUFFER_INLINE_ELEMENTS
Definition: slice.h:74
grpc_slice::grpc_slice_data::grpc_slice_refcounted
Definition: slice.h:63
grpc_slice_buffer::slices
grpc_slice * slices
slices in the array (Points to the first valid grpc_slice in the array)
Definition: slice.h:84
grpc_slice::grpc_slice_data::grpc_slice_inlined
Definition: slice.h:67
grpc_slice::grpc_slice_data
Definition: slice.h:62
grpc_slice_buffer
struct grpc_slice_buffer grpc_slice_buffer
Represents an expandable array of slices, to be interpreted as a single item.
grpc_slice::grpc_slice_data::grpc_slice_inlined::length
uint8_t length
Definition: slice.h:68
grpc_slice_buffer::count
size_t count
the number of slices in the array
Definition: slice.h:86
grpc_slice_buffer::length
size_t length
the combined length of all slices in the array
Definition: slice.h:91
grpc_slice
A grpc_slice s, if initialized, represents the byte range s.bytes[0..s.length-1].
Definition: slice.h:60
grpc_slice::data
union grpc_slice::grpc_slice_data data
grpc_slice::grpc_slice_data::inlined
struct grpc_slice::grpc_slice_data::grpc_slice_inlined inlined
port_platform.h
grpc_slice_buffer::base_slices
grpc_slice * base_slices
This is for internal use only.
Definition: slice.h:81
grpc_slice::grpc_slice_data::grpc_slice_refcounted::bytes
uint8_t * bytes
Definition: slice.h:65
grpc_slice::grpc_slice_data::refcounted
struct grpc_slice::grpc_slice_data::grpc_slice_refcounted refcounted
GRPC_SLICE_INLINED_SIZE
#define GRPC_SLICE_INLINED_SIZE
Definition: slice.h:47
grpc_slice_buffer::capacity
size_t capacity
the number of slices allocated in the array.
Definition: slice.h:89
gpr_slice.h
grpc_slice_buffer
Represents an expandable array of slices, to be interpreted as a single item.
Definition: slice.h:78