You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
190 lines
7.1 KiB
C
190 lines
7.1 KiB
C
/* this header file comes from libowfat, http://www.fefe.de/libowfat/ */
|
|
#ifndef FMT_H
|
|
#define FMT_H
|
|
|
|
/* for size_t: */
|
|
#include <stddef.h>
|
|
/* for uint32_t */
|
|
#include <stdint.h>
|
|
/* for time_t: */
|
|
#include <sys/types.h>
|
|
/* for byte_copy */
|
|
#include "byte.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);
|
|
|
|
#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 */
|
|
|
|
/* 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<MAX_ALLOCA?alloca(len):0); if (c) c[fmt_strm(c,a,__VA_ARGS__)]=0; c;})
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|