/* this header file comes from libowfat, http://www.fefe.de/libowfat/ */ #ifndef FMT_H #define FMT_H /* for size_t: */ #include /* for uint32_t */ #include /* for time_t: */ #include /* for byte_copy */ #include "byte.h" /* for add_of */ #include "rangecheck.h" #ifdef __cplusplus extern "C" { #endif #define FMT_LONG 41 /* enough space to hold -2^127 in decimal, plus \0 */ #define FMT_ULONG 40 /* enough space to hold 2^128 - 1 in decimal, plus \0 */ #define FMT_8LONG 44 /* enough space to hold 2^128 - 1 in octal, plus \0 */ #define FMT_XLONG 33 /* enough space to hold 2^128 - 1 in hexadecimal, plus \0 */ #define FMT_LEN ((char *) 0) /* convenient abbreviation */ /* This file declares routines for formatting strings and numbers in * various forms or encodings, either binary or text based. * * The first argument is always the destination buffer, the second * argument is always the value to be formatted/encoded. The return * value is always the number of bytes written in the output buffer. * * If you don't know how large the output will be, call the function * first with NULL as destination buffer and use the length it returns * to allocate the destination buffer. * * Note that none of these routines append a 0 terminator. If you need * 0 termination, call the functions like this: buf[fmt_ulong(buf,number)]=0; */ /* convert signed src integer -23 to ASCII '-','2','3', return number of * bytes of value in output format (3 in this example). * If dest is not NULL, write result to dest */ size_t fmt_long(char *dest,signed long src); /* convert unsigned src integer 23 to ASCII '2','3', return number of * bytes of value in output format (2 in this example). * If dest is not NULL, write result to dest */ size_t fmt_ulong(char *dest,unsigned long src); /* convert unsigned src integer 0x23 to ASCII '2','3', return number of * bytes of value in output format (2 in this example). * If dest is not NULL, write result to dest */ size_t fmt_xlong(char *dest,unsigned long src); /* convert unsigned src integer 023 to ASCII '2','3', return number of * bytes of value in output format (2 in this example). * If dest is not NULL, write result to dest */ size_t fmt_8long(char *dest,unsigned long src); /* like fmt_long but for long long */ size_t fmt_longlong(char *dest,signed long long src); /* like fmt_ulong but for unsigned long long */ size_t fmt_ulonglong(char *dest,unsigned long long src); /* like fmt_xlong but for unsigned long long */ size_t fmt_xlonglong(char *dest,unsigned long long src); #define fmt_uint(dest,src) fmt_ulong(dest,src) #define fmt_int(dest,src) fmt_long(dest,src) #define fmt_xint(dest,src) fmt_xlong(dest,src) #define fmt_8int(dest,src) fmt_8long(dest,src) /* Like fmt_ulong, but prepend '0' while length is smaller than padto. * Does not truncate! */ /* fmt_ulong0(buf,23,4) -> '0','0','2','3' return 4 */ /* fmt_ulong0(buf,234,2) -> '2','3','4', return 3 */ size_t fmt_ulong0(char *,unsigned long src,size_t padto); #define fmt_uint0(buf,src,padto) fmt_ulong0(buf,src,padto) /* convert src double 1.7 to ASCII '1','.','7', return length. * If dest is not NULL, write result to dest */ size_t fmt_double(char *dest, double d,int max,int prec); /* if src is negative, write '-' and return 1. * if src is positive, write '+' and return 1. * otherwise return 0 */ size_t fmt_plusminus(char *dest,int src); /* if src is negative, write '-' and return 1. * otherwise return 0. */ size_t fmt_minus(char *dest,int src); /* copy str to dest until \0 byte, return number of copied bytes. */ /* fmt_str(NULL,str) == strlen(str) */ /* fmt_str(buf,str) == strcpy(buf,str), return strlen(str) */ /* strcat(strcpy(buf,"foo"),"bar") can be written as * i=fmt_str(buf,"foo"); * i+=fmt_str(buf+i,"bar"); * buf[i]=0; * This is more efficient because strcat needs to scan the string to * find the end and append. */ size_t fmt_str(char *dest,const char *src); /* copy str to dest until \0 byte or limit bytes copied. * return number of copied bytes. */ size_t fmt_strn(char *dest,const char *src,size_t limit); /* copy n bytes from src to dest, return n */ static inline size_t fmt_copybytes(char* dest,const char* src,size_t n) { byte_copy(dest,n,src); return n; } /* "foo" -> " foo" * write padlen-srclen spaces, if that is >= 0. Then copy srclen * characters from src. Truncate only if total length is larger than * maxlen. Return number of characters written. */ size_t fmt_pad(char* dest,const char* src,size_t srclen,size_t padlen,size_t maxlen); /* "foo" -> "foo " * append padlen-srclen spaces after dest, if that is >= 0. Truncate * only if total length is larger than maxlen. Return number of * characters written. */ size_t fmt_fill(char* dest,size_t srclen,size_t padlen,size_t maxlen); /* 1 -> "1", 4900 -> "4.9k", 2300000 -> "2.3M" */ size_t fmt_human(char* dest,unsigned long long l); /* 1 -> "1", 4900 -> "4.8k", 2300000 -> "2.2M" */ size_t fmt_humank(char* dest,unsigned long long l); /* "Sun, 06 Nov 1994 08:49:37 GMT" */ size_t fmt_httpdate(char* dest,time_t t); /* "2014-05-27T19:22:16.247Z" */ size_t fmt_iso8601(char* dest,time_t t); #define FMT_UTF8 5 #define FMT_ASN1LENGTH 17 /* enough space to hold 2^128-1 */ #define FMT_ASN1TAG 19 /* enough space to hold 2^128-1 */ /* some variable length encodings for integers */ size_t fmt_utf8(char* dest,uint32_t n); /* can store 0-0x7fffffff */ size_t fmt_asn1derlength(char* dest,unsigned long long l); /* 0-0x7f: 1 byte, above that 1+bytes_needed bytes */ size_t fmt_asn1dertag(char* dest,unsigned long long l); /* 1 byte for each 7 bits; upper bit = more bytes coming */ size_t fmt_varint(char* dest,unsigned long long l); /* protocol buffers encoding; like asn1dertag but little endian */ size_t fmt_pb_tag(char* dest,size_t fieldno,unsigned char type); /* protocol buffer tag */ size_t fmt_pb_type0_int(char* dest,signed long long l); /* protocol buffers encoding: type 0 integer */ size_t fmt_pb_type1_double(char* dest,double d); /* protocol buffers encoding: double (64-bit little endian blob) */ size_t fmt_pb_type1_fixed64(char* dest,uint64_t l); /* protocol buffers encoding: 64-bit little endian blob */ size_t fmt_pb_type2_string(char* dest,const char* s,size_t l); /* protocol buffers encoding: varint length + blob */ size_t fmt_pb_type5_float(char* dest,float f); /* protocol buffers encoding: float (32-bit little endian blob) */ size_t fmt_pb_type5_fixed32(char* dest,uint32_t l); /* protocol buffers encoding: 32-bit little endian blob */ static inline size_t fmt_pb_int(char* dest,size_t fieldno,signed long long l) { size_t n=fmt_pb_tag(dest,fieldno,0); return n+fmt_pb_type0_int(dest?dest+n:0,l); } static inline size_t fmt_pb_double(char* dest,size_t fieldno,double d) { size_t n=fmt_pb_tag(dest,fieldno,1); return n+fmt_pb_type1_double(dest?dest+n:0,d); } static inline size_t fmt_pb_float(char* dest,size_t fieldno,float f) { size_t n=fmt_pb_tag(dest,fieldno,5); return n+fmt_pb_type5_float(dest?dest+n:0,f); } static inline size_t fmt_pb_string(char* dest,size_t fieldno,const char* s,size_t l) { size_t n=fmt_pb_tag(dest,fieldno,2); size_t m; if (add_of(m,fmt_pb_type2_string(NULL,s,l),n)) return 0; return n+fmt_pb_type2_string(dest?dest+n:0,s,l); } size_t fmt_netstring(char* dest,const char* src,size_t len); /* Marshaling helper functions. * Escape one character, no matter if it needs escaping or not. * The functions will reject characters that cannot be represented but * not characters that the standard says should never occur. The idea * is to make these functions useful for creating bad encoding for * penetration testing. * Depending on the escaping method, the input character (uint32_t, a * unicode codepoint) may be limited to 0x7f, 0xff or 0x10ffff. */ /* XML escaping: '&' -> '&', '<' -> '<', 'ö' -> 'ö' */ size_t fmt_escapecharxml(char* dest,uint32_t ch); /* HTML escaping is the same as XML escaping. */ size_t fmt_escapecharhtml(char* dest,uint32_t ch); /* JSON escaping: '\' -> '\\', '"' -> '\"', 'ö' -> '\u00f6' */ size_t fmt_escapecharjson(char* dest,uint32_t ch); /* MIME quoted-printable escaping: 'ö' -> '=f6', characters > 0xff not supported */ size_t fmt_escapecharquotedprintable(char* dest,uint32_t ch); /* MIME quoted-printable escaping with UTF-8: 'ö' -> '=c3=b6', characters > 0x7fffffff not supported */ size_t fmt_escapecharquotedprintableutf8(char* dest,uint32_t ch); /* C escaping: '\' -> '\\', newline -> '\n', 0xc2 -> '\302' */ size_t fmt_escapecharc(char* dest,uint32_t ch); /* internal functions, may be independently useful */ char fmt_tohex(char c); #define fmt_strm(b,...) fmt_strm_internal(b,__VA_ARGS__,(char*)0) size_t fmt_strm_internal(char* dest,...); #ifndef MAX_ALLOCA #define MAX_ALLOCA 100000 #endif #define fmt_strm_alloca(a,...) ({ size_t len=fmt_strm((char*)0,a,__VA_ARGS__)+1; char* c=(len