GenLib.h

//@AUTOHEADER@BEGIN@
/***********************************************************************\
|                    Drift Standard Libraries v1.01                     |
|            Copyright 2010-2023 Drift Solutions / Indy Sams            |
| Docs and more information available at https://www.driftsolutions.dev |
|          This file released under the 3-clause BSD license,           |
|            see included DSL.LICENSE.TXT file for details.             |
\***********************************************************************/
//@AUTOHEADER@END@
 
#ifndef _DSL_GENLIB_H_
#define _DSL_GENLIB_H_
 
DSL_API_CLASS const char * DSL_CC nopathA(const char * filename); 
DSL_API_CLASS const wchar_t * DSL_CC nopathW(const wchar_t * filename); 
DSL_API_CLASS char * DSL_CC nopathA(char * filename); 
DSL_API_CLASS wchar_t * DSL_CC nopathW(wchar_t * filename); 
 
DSL_API_CLASS char * DSL_CC bin2hex(const uint8_t * data, size_t datalen, char * out, size_t outsize);
DSL_API_CLASS string DSL_CC bin2hex(const uint8_t * data, size_t datalen);
 
DSL_API_CLASS bool DSL_CC hex2bin(const char * instr, size_t inlen, uint8 * out, size_t outsize);
DSL_API_CLASS bool DSL_CC hex2bin(const char * instr, uint8 * out, size_t outsize);
DSL_API_CLASS bool DSL_CC hex2bin(const string instr, vector<uint8_t>& out);
 
DSL_API void DSL_CC PrintData(FILE * fp, const uint8 * ptr, size_t len); 
 
#if defined(WIN32) || defined(DOXYGEN_SKIP)
    DSL_API_CLASS const char * DSL_CC stristr(const char * haystack, const char * needle); 
    DSL_API_CLASS char * DSL_CC stristr(char * haystack, const char * needle); 
    DSL_API char * DSL_CC strtok_r(char *newstring, const char *delimiters, char ** save_ptr); 
    time_t filetime_2_time_t(FILETIME ft);
    DSL_API struct tm * DSL_CC localtime_r(const time_t * tme, struct tm * out); 
    DSL_API struct tm * DSL_CC gmtime_r(const time_t * tme, struct tm * out); 
#else
    DSL_API char * DSL_CC strlwr(char * str); 
    DSL_API uint32 DSL_CC GetTickCount(); 
    DSL_API uint64 DSL_CC GetTickCount64(); 
#endif
 
DSL_API bool DSL_CC dsl_mkdir_r(const char * p, int mode); 
DSL_API bool DSL_CC strempty(const char * p); 
DSL_API int64 DSL_CC dsl_clamp(int64 value, int64 vMin, int64 vMax); 
 
DSL_API_CLASS char * DSL_CC escapeshellarg(const char * p, char * out, size_t outSize); 
DSL_API_CLASS string DSL_CC escapeshellarg(const string& str); 
 
#if defined(OPENBSD) || defined(FREEBSD)
#define HAVE_STRLCPY
#endif
 
#if !defined(HAVE_STRLCPY)
DSL_API size_t DSL_CC strlcpy(char * dst, const char * src, size_t siz);
DSL_API size_t DSL_CC strlcat(char * dst, const char * src, size_t siz);
#endif
#define sstrcpy(x,y) strlcpy(x,y,sizeof(x))
#define sstrcat(x,y) strlcat(x,y,sizeof(x))
 
 
#define TRIM_LEFT   0x01
#define TRIM_RIGHT  0x02
#define TRIM_BOTH   (TRIM_LEFT|TRIM_RIGHT)
DSL_API char * DSL_CC strtrim(char *buf, const char * trim = "\r\n\t ", uint8 sides = TRIM_BOTH);
 
DSL_API int DSL_CC wildcmp(const char *wild, const char *string);
DSL_API int DSL_CC wildicmp(const char *wild, const char *string);
DSL_API int DSL_CC wildicmp_multi(const char *wild, const char *string, const char *sep = "|");
 
DSL_API int64 DSL_CC fseek64(FILE * fp, int64 offset, int whence); 
DSL_API int64 DSL_CC ftell64(FILE * fp); 
DSL_API int64 DSL_CC filesize(const char * fn); 
#if defined(WIN32)
DSL_API int DSL_CC truncate(const char * fn, int64 size); 
#endif
 
DSL_API_CLASS bool DSL_CC file_get_contents(const string& fn, vector<uint8>& data, int64 maxSize=INT32_MAX);
DSL_API_CLASS bool DSL_CC file_get_contents(const string& fn, string& data, int64 maxSize=INT32_MAX);
DSL_API_CLASS bool DSL_CC file_get_contents(const string& fn, uint8 ** data, int64& fileSize, int64 maxSize=INT32_MAX); 
DSL_API_CLASS bool DSL_CC file_put_contents(const string& fn, const vector<uint8>& data, bool append = false);
DSL_API_CLASS bool DSL_CC file_put_contents(const string& fn, const string& data, bool append = false);
DSL_API_CLASS bool DSL_CC file_put_contents(const string& fn, const uint8 * data, size_t fileSize, bool append = false);
DSL_API int64 DSL_CC copy_file(const string& src, const string& dest, bool allow_overwrite = false);
 
DSL_API_CLASS int DSL_CC str_replaceA(char *Str, size_t BufSize, const char *FindStr, const char *ReplStr); 
DSL_API_CLASS int DSL_CC str_replaceW(wchar_t *Str, size_t BufSize, const wchar_t * FindStr, const wchar_t * ReplStr); 
 
DSL_API_CLASS string DSL_CC str_replaceA(const string& str, const string& FindStr, const string& ReplStr); 
DSL_API_CLASS wstring DSL_CC str_replaceW(const wstring& str, const wstring& FindStr, const wstring& ReplStr); 
 
DSL_API char * DSL_CC tchar2charA(char * str);
DSL_API char * DSL_CC tchar2charW(wchar_t * str);
 
DSL_API_CLASS char * DSL_CC GetUserConfigFolderA(const char * name);
DSL_API_CLASS string DSL_CC GetUserConfigFolderA(const string& name);
DSL_API_CLASS char * DSL_CC GetUserConfigFileA(const char * name, const char * fn);
DSL_API_CLASS string DSL_CC GetUserConfigFileA(const string& name, const string& fn);
DSL_API wchar_t * DSL_CC GetUserConfigFolderW(const wchar_t * name); 
DSL_API wchar_t * DSL_CC GetUserConfigFileW(const wchar_t * name, const wchar_t * fn); 
 
DSL_API char * DSL_CC GetUserDocumentsFolderA(const char * name);
 
DSL_API char * DSL_CC tcstombsA(const char * str);
DSL_API char * DSL_CC tcstombsW(const wchar_t * str);
DSL_API wchar_t * DSL_CC tcstowcsW(const wchar_t * str);
DSL_API wchar_t * DSL_CC tcstowcsA(const char * str);
DSL_API char * DSL_CC mbstotcsA(const char * str);
DSL_API char * DSL_CC wcstotcsA(const wchar_t * str);
DSL_API wchar_t * DSL_CC mbstotcsW(const char * str);
DSL_API wchar_t * DSL_CC wcstotcsW(const wchar_t * str);
DSL_API size_t DSL_CC wcscnt(const wchar_t * ptr); // returns number of bytes taken up by string, not including NULL terminator
 
 
#ifdef UNICODE
#define str_replace str_replaceW
#define tchar2char tchar2charW
#define tcstombs tcstombsW
#define tcstowcs tcstowcsW
#define mbstotcs mbstotcsW
#define wcstotcs wcstotcsW
#define nopath nopathW
#define GetUserConfigFolder GetUserConfigFolderW
#define GetUserConfigFile GetUserConfigFileW
#define GetUserDocumentsFolder #error Not implemented
#else
#define str_replace str_replaceA
#define tchar2char tchar2charA
#define tcstombs tcstombsA
#define tcstowcs tcstowcsA
#define mbstotcs mbstotcsA
#define wcstotcs wcstotcsA
#define nopath nopathA
#define GetUserConfigFolder GetUserConfigFolderA
#define GetUserConfigFile GetUserConfigFileA
#define GetUserDocumentsFolder GetUserDocumentsFolderA
#endif
 
 
template <typename T>
T scale_ranges(T value, T srcmin, T srcmax, T destmin, T destmax) {
    T in = value - srcmin;
    T indiff = srcmax - srcmin;
    T outdiff = destmax - destmin;
    return ((in * outdiff) / indiff) + destmin;
}
 
#if defined(__cplusplus) && __cplusplus < 201703L
template <typename T>
T clamp(T v, T vMin, T vMax) {
    if (v < vMin) { return vMin; }
    if (v > vMax) { return vMax; }
    return v;
}
#endif
 
class DSL_API_CLASS StrTokenizer {
private:
    bool b_strdup = false;
    char * string = NULL;
    char sep = 0;
    char sep_str[2] = { 0,0 };
 
    size_t num_tokens = 0;
    char ** tokens = NULL;
public:
    StrTokenizer(char * str, char separater, bool do_strdup=true);
    ~StrTokenizer();
 
    size_t NumTok();
 
    char * GetTok(size_t first, size_t last);
    char * GetSingleTok(size_t num);
    void FreeString(char * buf); 
 
    std::string stdGetTok(size_t first, size_t last);
    std::string stdGetSingleTok(size_t num);
};
 
/* Remaining functions past this line were borrowed from PhysicsFS */
 
DSL_API bool DSL_CC IsValidUTF8(const char *s); 
DSL_API const char * DSL_CC FirstInvalidUTF8(const char *s);
 
DSL_API uint16 DSL_CC ByteSwap16(uint16 X); 
DSL_API uint32 DSL_CC ByteSwap32(uint32 X); 
DSL_API uint64 DSL_CC ByteSwap64(uint64 val); 
 
DSL_API uint16 DSL_CC Get_ULE16(uint16 x); 
DSL_API int16 DSL_CC Get_SLE16(int16 x); 
DSL_API uint32 DSL_CC Get_ULE32(uint32 x); 
DSL_API int32 DSL_CC Get_SLE32(int32 x); 
DSL_API uint64 DSL_CC Get_ULE64(uint64 x); 
DSL_API int64 DSL_CC Get_SLE64(int64 x); 
 
DSL_API uint16 DSL_CC Get_UBE16(uint16 x); 
DSL_API int16 DSL_CC Get_SBE16(int16 x); 
DSL_API uint32 DSL_CC Get_UBE32(uint32 x); 
DSL_API int32 DSL_CC Get_SBE32(int32 x); 
DSL_API uint64 DSL_CC Get_UBE64(uint64 x); 
DSL_API int64 DSL_CC Get_SBE64(int64 x); 
 
#endif // _DSL_GENLIB_H_