fmt.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2015 Kaspar Schleiser <kaspar@schleiser.de>
3  *
4  * This file is subject to the terms and conditions of the GNU Lesser
5  * General Public License v2.1. See the file LICENSE in the top level
6  * directory for more details.
7  */
8 
41 #ifndef FMT_H
42 #define FMT_H
43 
44 #include <stddef.h>
45 #include <stdint.h>
46 #include <unistd.h>
47 
48 #ifdef __cplusplus
49 extern "C" {
50 #endif
51 
52 #ifndef FMT_USE_MEMMOVE
53 #define FMT_USE_MEMMOVE (1)
54 #endif
55 
63 static inline int fmt_is_digit(char c)
64 {
65  return (c >= '0' && c <= '9');
66 }
67 
75 static inline int fmt_is_upper(char c)
76 {
77  return (c >= 'A' && c <= 'Z');
78 }
79 
87 int fmt_is_number(const char *str);
88 
103 size_t fmt_byte_hex(char *out, uint8_t byte);
104 
118 size_t fmt_bytes_hex(char *out, const uint8_t *ptr, size_t n);
119 
133 size_t fmt_bytes_hex_reverse(char *out, const uint8_t *ptr, size_t n);
134 
144 uint8_t fmt_hex_byte(const char *hex);
145 
164 size_t fmt_hex_bytes(uint8_t *out, const char *hex);
165 
178 size_t fmt_u16_hex(char *out, uint16_t val);
179 
192 size_t fmt_u32_hex(char *out, uint32_t val);
193 
206 size_t fmt_u64_hex(char *out, uint64_t val);
207 
219 size_t fmt_u16_dec(char *out, uint16_t val);
220 
232 size_t fmt_u32_dec(char *out, uint32_t val);
233 
247 size_t fmt_u64_dec(char *out, uint64_t val);
248 
262 size_t fmt_s64_dec(char *out, int64_t val);
263 
277 size_t fmt_s32_dec(char *out, int32_t val);
278 
292 size_t fmt_s16_dec(char *out, int16_t val);
293 
305 size_t fmt_s16_dfp(char *out, int16_t val, int scale);
306 
324 size_t fmt_s32_dfp(char *out, int32_t val, int scale);
325 
346 size_t fmt_float(char *out, float f, unsigned precision);
347 
359 size_t fmt_char(char *out, char c);
360 
368 size_t fmt_strlen(const char *str);
369 
379 size_t fmt_strnlen(const char *str, size_t maxlen);
380 
392 size_t fmt_str(char *out, const char *str);
393 
405 size_t fmt_to_lower(char *out, const char *str);
406 
417 uint32_t scn_u32_dec(const char *str, size_t n);
418 
429 uint32_t scn_u32_hex(const char *str, size_t n);
430 
456 ssize_t scn_buf_hex(void *dest, size_t dest_len, const char *hex, size_t hex_len);
457 
466 void print(const char* s, size_t n);
467 
473 void print_u32_dec(uint32_t val);
474 
480 void print_s32_dec(int32_t val);
481 
487 void print_byte_hex(uint8_t byte);
488 
495 void print_bytes_hex(const void *bytes, size_t n);
496 
502 void print_u32_hex(uint32_t val);
503 
509 void print_u64_hex(uint64_t val);
510 
518 void print_u64_dec(uint64_t val);
519 
527 void print_s64_dec(uint64_t val);
528 
540 void print_float(float f, unsigned precision);
541 
547 void print_str(const char* str);
548 
572 size_t fmt_lpad(char *str, size_t in_len, size_t pad_len, char pad_char);
573 
574 #ifdef __cplusplus
575 }
576 #endif
577 
579 #endif /* FMT_H */
size_t fmt_byte_hex(char *out, uint8_t byte)
Format a byte value as hex.
size_t fmt_strlen(const char *str)
Count characters until '\0' (exclusive) in str.
static int fmt_is_digit(char c)
Test if the given character is a numerical digit (regex [0-9])
Definition: fmt.h:63
void print_byte_hex(uint8_t byte)
Print byte value as hex to stdout.
size_t fmt_s16_dfp(char *out, int16_t val, int scale)
Convert 16-bit fixed point number to a decimal string.
size_t fmt_char(char *out, char c)
Copy in char to string (without terminating '\0')
size_t fmt_lpad(char *str, size_t in_len, size_t pad_len, char pad_char)
Pad string to the left.
uint8_t fmt_hex_byte(const char *hex)
Converts a sequence of two hex characters to a byte.
size_t fmt_u64_hex(char *out, uint64_t val)
Convert a uint64 value to hex string.
size_t fmt_u32_dec(char *out, uint32_t val)
Convert a uint32 value to decimal string.
size_t fmt_strnlen(const char *str, size_t maxlen)
Count at most maxlen characters until '\0' (exclusive) in str.
void print_s64_dec(uint64_t val)
Print int64 value as decimal to stdout.
size_t fmt_s32_dfp(char *out, int32_t val, int scale)
Convert 32-bit fixed point number to a decimal string.
void print_s32_dec(int32_t val)
Print int32 value to stdout.
size_t fmt_s16_dec(char *out, int16_t val)
Convert a int16 value to decimal string.
size_t fmt_s32_dec(char *out, int32_t val)
Convert a int32 value to decimal string.
size_t fmt_bytes_hex_reverse(char *out, const uint8_t *ptr, size_t n)
Formats a sequence of bytes as hex characters, starting with the last byte.
size_t fmt_to_lower(char *out, const char *str)
Copy null-terminated string to a lowercase string (excluding terminating \0)
void print_u32_dec(uint32_t val)
Print uint32 value to stdout.
ssize_t scn_buf_hex(void *dest, size_t dest_len, const char *hex, size_t hex_len)
Convert a hex to binary.
size_t fmt_float(char *out, float f, unsigned precision)
Format float to string.
size_t fmt_u32_hex(char *out, uint32_t val)
Convert a uint32 value to hex string.
size_t fmt_u16_dec(char *out, uint16_t val)
Convert a uint16 value to decimal string.
int fmt_is_number(const char *str)
Test if the given string is a number (regex [0-9]+)
void print_u64_hex(uint64_t val)
Print uint64 value as hex to stdout.
void print_u64_dec(uint64_t val)
Print uint64 value as decimal to stdout.
void print_bytes_hex(const void *bytes, size_t n)
Print bytes as hex to stdout.
void print_float(float f, unsigned precision)
Print float value.
size_t fmt_str(char *out, const char *str)
Copy null-terminated string (excluding terminating \0)
size_t fmt_bytes_hex(char *out, const uint8_t *ptr, size_t n)
Formats a sequence of bytes as hex characters.
void print_u32_hex(uint32_t val)
Print uint32 value as hex to stdout.
size_t fmt_s64_dec(char *out, int64_t val)
Convert a int64 value to decimal string.
void print_str(const char *str)
Print null-terminated string to stdout.
size_t fmt_u16_hex(char *out, uint16_t val)
Convert a uint16 value to hex string.
uint32_t scn_u32_dec(const char *str, size_t n)
Convert string of decimal digits to uint32.
static int fmt_is_upper(char c)
Test if the given character is an uppercase letter (regex [A-Z])
Definition: fmt.h:75
size_t fmt_u64_dec(char *out, uint64_t val)
Convert a uint64 value to decimal string.
void print(const char *s, size_t n)
Print string to stdout.
uint32_t scn_u32_hex(const char *str, size_t n)
Convert string hexadecimal digits to uin32_t.
size_t fmt_hex_bytes(uint8_t *out, const char *hex)
Converts a sequence of hex characters to an array of bytes.