libosmocore  0.9.0
Osmocom core library
utils.h
Go to the documentation of this file.
1 #pragma once
2 
3 #include <osmocom/core/backtrace.h>
4 #include <osmocom/core/talloc.h>
5 
13 #define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
14 
15 #define OSMO_MAX(a, b) ((a) >= (b) ? (a) : (b))
16 
17 #define OSMO_MIN(a, b) ((a) >= (b) ? (b) : (a))
18 
19 #include <stdint.h>
20 
22 struct value_string {
23  unsigned int value;
24  const char *str;
25 };
26 
27 const char *get_value_string(const struct value_string *vs, uint32_t val);
28 
29 int get_string_value(const struct value_string *vs, const char *str);
30 
31 char osmo_bcd2char(uint8_t bcd);
32 /* only works for numbers in ascci */
33 uint8_t osmo_char2bcd(char c);
34 
35 int osmo_hexparse(const char *str, uint8_t *b, int max_len);
36 
37 char *osmo_ubit_dump(const uint8_t *bits, unsigned int len);
38 char *osmo_hexdump(const unsigned char *buf, int len);
39 char *osmo_hexdump_nospc(const unsigned char *buf, int len);
40 char *osmo_osmo_hexdump_nospc(const unsigned char *buf, int len) __attribute__((__deprecated__));
41 
42 #define osmo_static_assert(exp, name) typedef int dummy##name [(exp) ? 1 : -1] __attribute__((__unused__));
43 
44 void osmo_str2lower(char *out, const char *in);
45 void osmo_str2upper(char *out, const char *in);
46 
47 #define OSMO_SNPRINTF_RET(ret, rem, offset, len) \
48 do { \
49  len += ret; \
50  if (ret > rem) \
51  ret = rem; \
52  offset += ret; \
53  rem -= ret; \
54 } while (0)
55 
56 #define OSMO_ASSERT(exp) \
57  if (!(exp)) { \
58  fprintf(stderr, "Assert failed %s %s:%d\n", #exp, __FILE__, __LINE__); \
59  osmo_generate_backtrace(); \
60  abort(); \
61  }
62 
63 static inline void osmo_talloc_replace_string(void *ctx, char **dst, char *newstr)
64 {
65  if (*dst)
66  talloc_free(*dst);
67  *dst = talloc_strdup(ctx, newstr);
68 }
69 
void osmo_str2lower(char *out, const char *in)
Convert an entire string to lower case.
Definition: utils.c:237
int get_string_value(const struct value_string *vs, const char *str)
get numeric value for given human-readable string
Definition: utils.c:66
const char * get_value_string(const struct value_string *vs, uint32_t val)
get human-readable string for given value
Definition: utils.c:45
unsigned int value
numeric value
Definition: utils.h:23
uint8_t osmo_char2bcd(char c)
Convert number in ASCII to BCD value.
Definition: utils.c:95
A mapping between human-readable string and numeric value.
Definition: utils.h:22
const char * str
human-readable string
Definition: utils.h:24
char * osmo_ubit_dump(const uint8_t *bits, unsigned int len)
Convert a sequence of unpacked bits to ASCII string.
Definition: utils.c:166
char osmo_bcd2char(uint8_t bcd)
Convert BCD-encoded digit into printable character.
Definition: utils.c:83
int osmo_hexparse(const char *str, uint8_t *b, int max_len)
Parse a string ocntaining hexadecimal digits.
Definition: utils.c:106
char * osmo_hexdump_nospc(const unsigned char *buf, int len)
Convert binary sequence to hexadecimal ASCII string.
Definition: utils.c:217
char * osmo_hexdump(const unsigned char *buf, int len)
Convert binary sequence to hexadecimal ASCII string.
Definition: utils.c:204
void osmo_str2upper(char *out, const char *in)
Convert an entire string to upper case.
Definition: utils.c:250