strnum.h

Go to the documentation of this file.

// strnum.h   (c) 2019 adolfo.dimare@gmail.com
 
/** \file  strnum.h
    \brief Complement routines for \c <string> && \c <cstring>
 
    \author adolfo.dimare@gmail.com
    \date   2019
*/
 
#ifndef   strnum_h
#define   strnum_h ///< Avoid multiple inclusion
 
#include <cstring> // size_t, strlen(), etc.
#include <cstdint> // intmax_t && uintmax_t
#include <cstdlib> // strtoull()
 
/// Safe size for 'insnsep()'
const size_t insnsep_size=96;
 
// Insert in place the separator 'sep' for a numeric string.
// - [ej: sep==',' && w==3 for thousands]
char *insnsep( char* num, char sep, unsigned w );
 
// Use 'insnsep()' to format a Rupee amount.
char* insnsep_Rupee( char *num, char sep );
 
// Use 'insnsep()' to format a date.
char* insnsep_date8( char *num, char sep, bool YMD );
 
// Take all numeric values from 'str' to fill up 'VEC[]'.
size_t atoi_vec( const char* str, intmax_t  VEC[], size_t N );
 
// Take all numeric values from 'str' to fill up 'VEC[]'.
size_t atou_vec( const char* str, uintmax_t VEC[], size_t N );
 
// Extract the next number of 'N' digits.
uintmax_t atou_ndigit( const char* *str, unsigned N );
 
/// Converts 'str' into an unsigned number invoking \c strtoull()
inline uintmax_t atouint( const char * str ) {
    return strtoull( str,NULL,0 );
}
 
// Converts "val" into the zero terminated C-string "dst"
char* utoa_sz( uintmax_t val, char *dst, unsigned base, size_t sz );
 
#endif // strnum_h
 
// EOF: strnum.h