| #ifndef UTILS_H |
| #define UTILS_H |
| |
| /// |
| // Miscellaneous utilities |
| // ----------------------- |
| |
| #include <stddef.h> |
| #include <stdarg.h> |
| |
| /// |
| // duplicate a memory buffer in a newly allocated buffer. |
| // @src: a pointer to the memory buffer to be duplicated |
| // @len: the size of the memory buffer to be duplicated |
| // @return: a pointer to a copy of @src allocated via |
| // :func:`__alloc_bytes()`. |
| void *xmemdup(const void *src, size_t len); |
| |
| /// |
| // duplicate a null-terminated string in a newly allocated buffer. |
| // @src: a pointer to string to be duplicated |
| // @return: a pointer to a copy of @str allocated via |
| // :func:`__alloc_bytes()`. |
| char *xstrdup(const char *src); |
| |
| /// |
| // printf to allocated string |
| // @fmt: the format followed by its arguments. |
| // @return: the allocated & formatted string. |
| // This function is similar to asprintf() but the resulting string |
| // is allocated with __alloc_bytes(). |
| char *xasprintf(const char *fmt, ...); |
| |
| /// |
| // vprintf to allocated string |
| // @fmt: the format |
| // @ap: the variadic arguments |
| // @return: the allocated & formatted string. |
| // This function is similar to asprintf() but the resulting string |
| // is allocated with __alloc_bytes(). |
| char *xvasprintf(const char *fmt, va_list ap); |
| |
| #endif |
