Basic utils for wsjcpp
include helper functions, logger and etc.
$ wsjcpp install https://github.com/wsjcpp/wsjcpp-core:master
Or include files:
src/wsjcpp_core/wsjcpp_core.hsrc/wsjcpp_core/wsjcpp_core.cpp
- Output will be colored for console, but color will be missing for files.
- Functions are safe thread.
- Logger supports a log rotation (every 51000 seconds / every day)
- WsjcppLog::throw_err - will be generate
throw std::runtime_error(sMessage); - std::vectorstd::string WsjcppLog::getLastLogMessages() - last 50 records from log
In main() you need to init logger first.
#include <wsjcpp_core.h>
int main(int argc, char* argv[]) {
std::string TAG = "MAIN";
WsjcppLog::setLogDirectory(".logs");
WsjcppLog::setPrefixLogFile("app");
// disable log file
// WsjcppLog::setEnableLogFile(false);
// ...
return 0;
}
And then you can call static functions anywhere in your code:
#include <wsjcpp_core.h>
...
const std::string TAG = "MAIN";
WsjcppLog::info(TAG, "Hello info");
WsjcppLog::err(TAG, "Hello err");
WsjcppLog::warn(TAG, "Hello warn");
WsjcppLog::ok(TAG, "Hello ok");
Example output
2020-02-25 16:56:07.373, 0x0x10ac51dc0 [INFO] MAIN: Hello info
2020-02-25 16:56:07.374, 0x0x10ac51dc0 [ERR] MAIN: Hello err
2020-02-25 16:56:07.375, 0x0x10ac51dc0 [WARN] MAIN: Hello warn
2020-02-25 16:56:07.376, 0x0x10ac51dc0 [OK] MAIN: Hello ok
| function | description | code-example |
|---|---|---|
wsjcpp::normalize_filepath |
Normalize paths. (For example: .//../bin/some/../ -> ./../bin/) |
Code-Example |
wsjcpp::recursive_copy_files |
Recursive copy files. If target folders does not exists then it will be created | Code-Example |
wsjcpp::recursive_remove_dir |
Please will be careful. Recursive remove directory with sub-directories and sub-files | Code-Example |
wsjcpp::starts_with |
Test string starts with substring | Code-Example |
wsjcpp::ends_with |
Test string ends with substring | Code-Example |
wsjcpp::directory_list |
Return list of child directories | Code-Example |
wsjcpp::generate_uuid |
Generate uuid, but you need to call WsjcppCore::initRandom(); before it (for example in main() function) |
Code-Example |
wsjcpp::parent_dirpath |
Extract dirpath from filepath | Code-Example |
wsjcpp::to_snake_case |
Normalize input string to snake case | Code-Example |
wsjcpp::dir_exists |
Test for directory exists | Code-Example |
wsjcpp::file_exists |
Test for file exists | Code-Example |
wsjcpp::split |
split string by delimiter | Code-Example |
wsjcpp::join |
Join vector to string by delimiter | Code-Example |
wsjcpp::replace_all_in |
Replace all substrings in target | Code-Example |
wsjcpp::create_empty_file |
Creating empty file. Will return true if file not exists and do created | Code-Example |
wsjcpp::extract_filename |
Extract base filename from filepath. | Code-Example |
wsjcpp::levenshtein_distance |
Calculation Of Levenshtein Distance. | Code-Example |
wsjcpp::user_is_root |
For a linux system. Return true if current user is root | Code-Example |
wsjcpp::change_current_process_privileges |
For a linux system. Try change (or downgrade) for current process privileges. | Code-Example |
wsjcpp::operation_system_platform |
Return OS from enum. | Code-Example |
wsjcpp::is_linux |
return true if current platform is linux. | Code-Example |
wsjcpp::is_windows |
return true if current platform is windows. | Code-Example |
wsjcpp::padding_right |
Padding string right. | Code-Example |
wsjcpp::padding_left |
Padding string left. | Code-Example |
wsjcpp::is_valid_ip4 |
Check string contains valid IPv4 format. | Code-Example |
wsjcpp::is_valid_ip6 |
Check string contains valid IPv6 format. | Code-Example |
wsjcpp::is_valid_date |
Check string contains valid Date format. | Code-Example |
wsjcpp::is_valid_time24 |
Check string contains valid Time (H24) format. | Code-Example |
wsjcpp::is_valid_url_protocol |
Check string contains valid URL Protocol. | Code-Example |
wsjcpp::is_valid_domain_name |
Check string contains valid Domain-Name format. | Code-Example |
wsjcpp::is_valid_port |
Check string or int contains valid IP Port format. | Code-Example |
wsjcpp::is_valid_base64 |
Check string contains valid base64 format. | Code-Example |
Normalize paths. For example: ".//../bin/some/../" -> "./../bin/"
std::string _path = wsjcpp::normalize_filepath(".//../bin/some/../");
Extract base dir path from fullpath.
std::string sDirpath = WsjcppCore::extractDirpath(".//../bin/some/../file.txt");
Variable sDirpath will has value .//../bin/some/..
static std::string getCurrentDirectory();
static long getCurrentTimeInMilliseconds();
static long getCurrentTimeInSeconds();
static std::string getCurrentTimeForFilename();
will be like this: ?
static std::string getCurrentTimeForLogFormat();
will be like this: 2020-09-17 02:22:40.755
static std::string getThreadId();
will be like this: 0x00007fa9c6a96740
static std::string formatTimeForWeb(long nTimeInSec);
static std::string formatTimeForFilename(long nTimeInSec);
static std::string formatTimeUTC(int nTimeInSec);
Create a new directory
std::string sDirname = ".logs";
if (WsjcppCore::makeDir(sDirname)) {
std::cout << " Created '" << sDirname << "'" << std::endl;
}
Create a new directories full path
std::string sDirsPath = "./data/dir1/dir1/dir3";
if (WsjcppCore::makeDirsPath(sDirname)) {
std::cout << " Created '" << sDirsPath << "'" << std::endl;
}
static bool writeFile(const std::string &sFilename, const std::string &sContent);
static bool writeFile(const std::string &sFilename, const char *pBuffer, const int nBufferSize);
Read text files into std::string
std::string sContent;
if (WsjcppCore::readTextFile("./file.txt", sContent)) {
std::cout << sContent;
}
Read file binary content to buffer
char *pBuffer = nullptr;
int nBufferSize = 0;
if (WsjcppCore::readFileToBuffer("./data/readFileToBuffer.txt", &pBuffer, nBufferSize)) {
// your can work with buffer here
}
if (WsjcppCore::removeFile("./file.txt")) {
std::cout << "File removed" << std::endl;
}
if (WsjcppCore::copyFile("./file.txt", "./file1.txt")) {
std::cout << "File copied!" << std::endl;
}
static std::string& ltrim(std::string& str, const std::string& chars = "\t\n\v\f\r ");
static std::string& rtrim(std::string& str, const std::string& chars = "\t\n\v\f\r ");
static std::string& trim(std::string& str, const std::string& chars = "\t\n\v\f\r ");
static std::string toLower(const std::string& str);
Convert text to lower characters, like "ABc" -> "abc". Worked only with latin alphabet.
static std::string toUpper(const std::string& str);
Convert text to upper characters like "abC" -> "ABC". Worked only with latin alphabet.
Generate uuid, but you need to call WsjcppCore::initRandom(); before it (for example in main() function)
WsjcppCore::initRandom(); // once in main on start
std::string _uuid = wsjcpp::generate_uuid();
std::cout << _uuid << std::endl;
Example output:
b49d92ae-f11c-f8bc-3a94-e7519e341927
unsigned int to hex string (lowercase)
std::cout << WsjcppCore::uint2hexString(1) << std::endl;
std::cout << WsjcppCore::uint2hexString(3000) << std::endl;
std::cout << WsjcppCore::uint2hexString(4123123123) << std::endl;
Example output
00000001
00000bb8
f5c1ddb3
std::string s = "dddd";
unsigned long nPointer = WsjcppCore::convertVoidToULong((void *)&s);
std::cout << sPointerHex << std::endl;
static unsigned long convertVoidToULong(void *p);
Example output:
140732802287936
std::string s = "dddd";
std::string sPointerHex = WsjcppCore::getPointerAsHex((void *)&s);
std::cout << sPointerHex << std::endl;
Example output:
0x7ffee8b04940
std::string proto = wsjcpp::extract_url_protocol("https://github.com/wsjcpp");
proto will be contains https
Get the value of a system environment variable
std::string sValue;
if (WsjcppCore::getEnv("PATH", sValue)) {
std::cout << sValue << std::endl;
}
Example output:
/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
Similar a js function encodeURIComponent
static std::string encodeUriComponent(const std::string& sValue);
Similar a js function decodeURIComponent
static std::string decodeUriComponent(const std::string& sValue);
Human size for sizes in bytes
std::string sResult = WsjcppCore::getHumanSizeBytes(12012);
std::cout << "Size: " << sResult << std::endl;
Example output:
Size: 12K
Recursive copy files If target folders does not exists then it will be created
if (WsjcppCore::recursive_copy_files("./folder1", "./folder2")) {
// everything ok
}
Please will be careful Recursive remove directory with sub-directories and sub-files
std::string error;
if (!wsjcpp::recursive_remove_dir("./folder2", error)) {
// everything removed
}
Test string starts with substring
if (wsjcpp::starts_with("123456", "123")) {
// true
}
Test string ends with substring
if (wsjcpp::ends_with("123456", "456")) {
// true
}
std::vector<std::string> dirs = wsjcpp::directory_list("./");
Extracted normalize dirpath from filepath
std::string parent_dir = wsjcpp::directory_list("./bo/test.txt"); // parent_dir will be contains './bo'
Normalize input string to snake case
std::string name1 = wsjcpp::to_snake_case("./bo/test.txt"); // name1 will be contains 'bo_test_txt' std::string name2 = wsjcpp::to_snake_case("123:ssss"); // name2 will be contains '_123_ssss' std::string name3 = wsjcpp::to_snake_case("SomeClass"); // name3 will be contains 'some_class'
bool wsjcpp::dir_exists(const std::string &dir_path);
bool wsjcpp::file_exists(const std::string &file_path);
std::string source = "|1a|2b|3c|4d|"; std::vector<std::string> tokens = wsjcpp::split(source, "|"); for (int i = 0; i < tokens.size(); i++) { std::cout << tokens[i] << std::endl; }
Example output:
1a
2b
3c
4d
std::vector<std::string> source; source.push("1a"); source.push("2b"); source.push("3c"); source.push("4d"); std::string result = wsjcpp::join(source, ","); std::cout << result << std::endl;
Example output:
1a,2b,3c,4d
std::string target = "some1some2"; wsjcpp::replace_all_in(target, "some", "new"); std::cout << target << std::endl;
Example output:
new1new2
Creating empty file. Will return true if file not exists and do created
if (wsjcpp::create_empty_file("./file.txt")) { std::cout << "Empty file created" << std::endl; }
Extract base filename from filepath.
std::string filename = wsjcpp::extract_filename(".//../bin/some/../file.txt");
Variable filename will has value file.txt
Calculation Of Levenshtein Distance.
int dist = wsjcpp::levenshtein_distance("taf", "t0");
Variable dist will has value 2
For a linux system.
Return true if current user is root.
For a linux system.
Try change (or downgrade) for current process privileges.
Return true if success or false if not. See more in error.
std::string error; int user_id = 1001; if (!wsjcpp::change_current_process_privileges(1001, error)) { std::cerr << "FAILED: " << error << std::endl; }
Return OS from enum
if (wsjcpp::operation_system_platform() wsjcpp::operation_system::LINUX) { std::cout << "is a linux " << std::endl; }
return true if current platform is linux
return true if current platform m is linux
Padding string right.
std::string str = wsjcpp::padding_right("123", '-', 5);
Variable str will contains string 123--
Padding string left.
std::string str = wsjcpp::padding_left("123", '-', 5);
Variable str will contains string --123
Check string contains valid IPv4 format.
std::string error; if (wsjcpp::is_valid_ip4("127.0.0.1", error)) { std::cout << "Valid" << std::endl; }
Check string contains valid IPv6 format.
std::string error; if (wsjcpp::is_valid_ip6("2607:f8b0:4002:c08:0:0:0:8b", error)) { std::cout << "Valid" << std::endl; }
Check string contains valid Date format.
std::string error; if (wsjcpp::is_valid_date("2020-01-01", error)) { std::cout << "Valid" << std::endl; }
Check string contains valid Date format.
std::string error; if (wsjcpp::is_valid_date("2020-01-01", error)) { std::cout << "Valid" << std::endl; }
Check string contains valid time HH:MM:SS format.
std::string error; if (wsjcpp::is_valid_time24("01:02:03", error)) { std::cout << "Valid" << std::endl; }
Check string contains valid url protocol.
std::string error; if (wsjcpp::is_valid_url_protocol("http", error)) { std::cout << "Valid" << std::endl; }
Check string contains valid domain-name format.
std::string error; if (wsjcpp::is_valid_domain_name("some.ru", error)) { std::cout << "Valid" << std::endl; }
Check string contains valid port ip format.
std::string error; if (!wsjcpp::is_valid_port(111888, error)) { std::cout << "Not valid port value" << std::endl; }
std::string error; if (wsjcpp::is_valid_port("8080", error)) { std::cout << "Valid port" << std::endl; }
Check string contains valid base64 format.
std::string error; if (wsjcpp::is_valid_base64("O2Rrc2Y7YXNsa2RmMQ==", error)) { std::cout << "Valid" << std::endl; }