//: # "Line breaks are often after "(" for a hyperlink as this is the (only)" //: # "possibility to break the line at 80 characters and avoid spaces in" //: # "hyperlinks."

this file is based on https://gist.github.com/PurpleBooth/109311bb0361f32d87a2#file-readme-template-md

common_sourcecode: sourcecode for multiple projects

Cross-platform (Windows/Linux/Android/POSIX) C and C++98/C++03 (kind of) library.

Some paths to source and header files don't seem be senseful and so may need to change.

Highest Quality Source Code

Not all of the source code is on a high standard (from point of view of a quality-aware long-year software engineer with an Master of Science in Computer Science).

the highest level code (02 Apr 2024) is:

• multithread-safe logger (/Controller/Logger)

  • able store file formats:
    • Log4j
    • HTML
    • txt
  • able to output the following attributes in log entries:
    • by using GCC's "__PRETTY_FUNCTION__" and MicroSoft Visual C(++)'s "__FUNCSIG__" (for C++:):
      • namespace name(s) and class name(s) where the log output happens
      • function name where the log output happens
    • thread name (must be set via I_Thread::SetThreadName(...) from "OperatingSystem/multithread/I_Thread.hpp" from the thread whose name is to set before)
    • thread ID
    • date and time of log output
    • log level
  • configurable time format string with place holders/variables/fields like {year},{month},{day},{hour},{minute},{second},{millisecond} that are preprocessed in I_LogFormatter::GetNeededArraySizeForTimeString(const std::string &) to save time when logging

• iterable trie data structure with template as member

  (/data_structures/Trie)

  Uses a template instead of "void *" for information on nodes so e.g. a member function pointer (needs more than "sizeof(void *)" bytes?!) may be stored there.

• BSD sockets :
  ease of use of/unified (cross-Operating System) access to its functions (state: 08 Aug 2021) :

  • /OperatingSystem/BSD/socket
  • /OperatingSystem/Windows/BSD_sockets
  • /OperatingSystem/POSIX/BSD_sockets

• multithreading and thread synchronization

  • /OperatingSystem/mutithread
  • /OperatingSystem/POSIX/mutithread
  • /OperatingSystem/Windows/mutithread

• CPU core usage via Performance Data Helper in MS Windows

  (/OperatingSystem/Windows/GetCPUusage/PerformanceDataHelper)

  This is the least CPU-time consuming way to get the CPU core usage via MS Windows known by the author.

• Windows power profile access

  (/OperatingSystem/Windows/PowerProfAccess)

  Is able to access (unified) via 2 (dynamically linked at runtime to enable both APIs with the same executable) power profile APIs:

  • API for access up to Windows XP/Server 2003
  • API for access beginnung from Windows v.6/Vista

• Apache Xerces (/Xerces)

Authors

Stefan Gebauer, Computer Science Master (from TU Berlin)

License

Copyright by Stefan Gebauer, no commercial use without grant. If you want to use the code in a commercial product then contact the author.

You may use the code free of charge

• to study the implementation and quality (of one of the authour's software products) so bugs can be reported.

• in a non-commercial product if it is not in competition with an author's software product (repositories from http://github.com/st-gb).

  If in doubt which applications this affects then ask the author.

It is appreciated to reference the author (e.g. in the "about" dialog or README.txt) if using this code. Therefore please refer to this github user page and/or to "it-gebauer.de".