rcutils  master
C API providing common utilities and data structures.
uint8_array.h
Go to the documentation of this file.
1 // Copyright 2018 Open Source Robotics Foundation, Inc.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
16 
17 #ifndef RCUTILS__TYPES__UINT8_ARRAY_H_
18 #define RCUTILS__TYPES__UINT8_ARRAY_H_
19 
20 #if __cplusplus
21 extern "C"
22 {
23 #endif
24 
25 #include <stdint.h>
26 
27 #include "rcutils/allocator.h"
30 
33 {
35  uint8_t * buffer;
36 
38  size_t buffer_length;
39 
42 
46 
48 
55 
57 
74  rcutils_uint8_array_t * uint8_array,
75  size_t buffer_capacity,
76  const rcutils_allocator_t * allocator);
77 
79 
95 
97 
115 rcutils_uint8_array_resize(rcutils_uint8_array_t * uint8_array, size_t new_size);
116 
117 #if __cplusplus
118 }
119 #endif
120 
121 #endif // RCUTILS__TYPES__UINT8_ARRAY_H_
rcutils_uint8_array_t::allocator
rcutils_allocator_t allocator
The allocator used to allocate and free memory for the uint8 array.
Definition: uint8_array.h:44
rcutils_uint8_array_t
The structure holding the metadata for a uint8 array.
Definition: uint8_array.h:32
rcutils_uint8_array_t::buffer
uint8_t * buffer
The allocated memory for the uint8 array.
Definition: uint8_array.h:35
rcutils_get_zero_initialized_uint8_array
rcutils_uint8_array_t rcutils_get_zero_initialized_uint8_array(void)
Return a zero initialized uint8 array struct.
RCUTILS_PUBLIC_TYPE
#define RCUTILS_PUBLIC_TYPE
Definition: visibility_control.h:29
rcutils_uint8_array_fini
rcutils_ret_t rcutils_uint8_array_fini(rcutils_uint8_array_t *uint8_array)
Finalize a uint8 array struct.
rcutils_ret_t
int rcutils_ret_t
The type that holds a return value for an rcutils operation.
Definition: rcutils_ret.h:26
RCUTILS_WARN_UNUSED
#define RCUTILS_WARN_UNUSED
A macro to make the compiler warn when the return value of a function is not used.
Definition: macros.h:27
rcutils_ret.h
visibility_control.h
rcutils_allocator_t
Encapsulation of an allocator.
Definition: allocator.h:47
allocator.h
rcutils_uint8_array_init
rcutils_ret_t rcutils_uint8_array_init(rcutils_uint8_array_t *uint8_array, size_t buffer_capacity, const rcutils_allocator_t *allocator)
Initialize a zero initialized uint8 array struct.
RCUTILS_PUBLIC
#define RCUTILS_PUBLIC
Definition: visibility_control.h:23
rcutils_uint8_array_t
struct rcutils_uint8_array_t rcutils_uint8_array_t
The structure holding the metadata for a uint8 array.
rcutils_uint8_array_resize
rcutils_ret_t rcutils_uint8_array_resize(rcutils_uint8_array_t *uint8_array, size_t new_size)
Resize the internal buffer of the uint8 array.
rcutils_uint8_array_t::buffer_capacity
size_t buffer_capacity
The maximum capacity of the uint8 array.
Definition: uint8_array.h:41
rcutils_uint8_array_t::buffer_length
size_t buffer_length
The number of valid elements in the uint8 array.
Definition: uint8_array.h:38