rcutils  master
C API providing common utilities and data structures.
format_string.h
Go to the documentation of this file.
1 // Copyright 2017 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 
15 #ifndef RCUTILS__FORMAT_STRING_H_
16 #define RCUTILS__FORMAT_STRING_H_
17 
18 #if __cplusplus
19 extern "C"
20 {
21 #endif
22 
23 #include <string.h>
24 
25 #include "rcutils/allocator.h"
26 #include "rcutils/macros.h"
28 
30 
35 #define rcutils_format_string(allocator, format_string, ...) \
36  rcutils_format_string_limit(allocator, 2048, format_string, __VA_ARGS__)
37 
39 
67 char *
69  rcutils_allocator_t allocator,
70  size_t limit,
71  const char * format_string,
72  ...);
73 
74 #if __cplusplus
75 }
76 #endif
77 
78 #endif // RCUTILS__FORMAT_STRING_H_
char * rcutils_format_string_limit(rcutils_allocator_t allocator, size_t limit, const char *format_string,...)
Return a newly allocated string, created with a format string up to a limit.
Encapsulation of an allocator.
Definition: allocator.h:43
#define RCUTILS_WARN_UNUSED
Definition: macros.h:24
#define RCUTILS_PUBLIC
Definition: visibility_control.h:48