Loading...
Searching...
No Matches
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 <time.h>
47#include <unistd.h>
48
49#ifdef __cplusplus
50extern "C" {
51#endif
52
53#ifndef FMT_USE_MEMMOVE
54#define FMT_USE_MEMMOVE (1)
55#endif
56
64static inline int fmt_is_digit(char c)
65{
66 return (c >= '0' && c <= '9');
67}
68
76static inline int fmt_is_upper(char c)
77{
78 return (c >= 'A' && c <= 'Z');
79}
80
88int fmt_is_number(const char *str);
89
104size_t fmt_byte_hex(char *out, uint8_t byte);
105
119size_t fmt_bytes_hex(char *out, const uint8_t *ptr, size_t n);
120
134size_t fmt_bytes_hex_reverse(char *out, const uint8_t *ptr, size_t n);
135
145uint8_t fmt_hex_byte(const char *hex);
146
165size_t fmt_hex_bytes(uint8_t *out, const char *hex);
166
179size_t fmt_u16_hex(char *out, uint16_t val);
180
193size_t fmt_u32_hex(char *out, uint32_t val);
194
207size_t fmt_u64_hex(char *out, uint64_t val);
208
220size_t fmt_u16_dec(char *out, uint16_t val);
221
233size_t fmt_u32_dec(char *out, uint32_t val);
234
248size_t fmt_u64_dec(char *out, uint64_t val);
249
263size_t fmt_s64_dec(char *out, int64_t val);
264
278size_t fmt_s32_dec(char *out, int32_t val);
279
293size_t fmt_s16_dec(char *out, int16_t val);
294
306size_t fmt_s16_dfp(char *out, int16_t val, int scale);
307
325size_t fmt_s32_dfp(char *out, int32_t val, int scale);
326
347size_t fmt_float(char *out, float f, unsigned precision);
348
360size_t fmt_char(char *out, char c);
361
369size_t fmt_strlen(const char *str);
370
380size_t fmt_strnlen(const char *str, size_t maxlen);
381
393size_t fmt_str(char *out, const char *str);
394
406size_t fmt_to_lower(char *out, const char *str);
407
425int fmt_time_tm_iso8601(char out[20], const struct tm *tm, char separator);
426
437uint32_t scn_u32_dec(const char *str, size_t n);
438
449uint32_t scn_u32_hex(const char *str, size_t n);
450
476ssize_t scn_buf_hex(void *dest, size_t dest_len, const char *hex, size_t hex_len);
477
498int scn_time_tm_iso8601(struct tm *tm, const char *str, char separator);
499
508void print(const char* s, size_t n);
509
515void print_u32_dec(uint32_t val);
516
522void print_s32_dec(int32_t val);
523
529void print_byte_hex(uint8_t byte);
530
537void print_bytes_hex(const void *bytes, size_t n);
538
544void print_u32_hex(uint32_t val);
545
551void print_u64_hex(uint64_t val);
552
560void print_u64_dec(uint64_t val);
561
569void print_s64_dec(uint64_t val);
570
582void print_float(float f, unsigned precision);
583
589void print_str(const char* str);
590
614size_t fmt_lpad(char *str, size_t in_len, size_t pad_len, char pad_char);
615
616#ifdef __cplusplus
617}
618#endif
619
621#endif /* FMT_H */
size_t fmt_byte_hex(char *out, uint8_t byte)
Format a byte value as hex.
int fmt_time_tm_iso8601(char out[20], const struct tm *tm, char separator)
Format a time structure to an ISO 8601 string.
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:64
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)
int scn_time_tm_iso8601(struct tm *tm, const char *str, char separator)
Convert an ISO 8601 string to time structure.
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:76
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.