[🛈Start+]	[🥋Trad. Taekwon-Do+]	[🧮Mathematik]	[📙Forschung & Lehre+]	[🐧GNU/Linux+]
[🔑Impressum+]	[🛀Autogenes Training+]	[💡Physik]	[⚙️Technik+]	[💾Progs: C+++]
Sprache:		[🔭Astronomie]	[📜LATEX]	[🕹️Spiele+]

Programmieren in C++

unter GNU/Linux-Systemen mit GCC

Basis zum Programmieren: GNU/Linux und GCC

Betriebssystem GNU/Linux als Programmierbasis

Erzeugen von Binaries mit der GNU‑Compilersammlung GCC

^𝔻 ) Die Programmiersprache D mit objektorientierten, imperativen sowie deklarativen / funktionalen Sprachelementen wird seit 1999 von Walter Bright entwickelt, der 2001 die erste Version (D1) des Compilers veröffentlichte – 2007 wurde diese unter Mitwirkung von Andrei Alexandrescu durch D2 abgelöst (und entwickelte sich seither inkrementell in über 100 Veröffentlichungen: aktuell ist 2.094.0 vom 22.09.2020); die D‑Standardlaufzeitbibliothek namens Phobos wurde vom 2006 einsteigenden Andrei Alexandrescu entwickelt. D übernimmt die meisten Sprachmittel der Sprache C, verzichtet im Gegensatz zu C++ aber auf die Kompatibilität dazu (hält aber die ABI‑Kompatibilität, so dass alle Programme und Bibliotheken, ggf. über Funktionen und Wrapper, nutzbar bleiben – die Anbindung von C++-Code unterliegt dagegen Einschränkungen). Programme können in D ohne Zeiger geschrieben werden – anders als Java ist es aber dennoch möglich, Zeiger bei Bedarf nahezu wie in C zu benutzen und so maschinennah zu programmieren. D verfügt über Klassenvorlagen und überladbare Operatoren, bietet Design by contract und Module und besitzt Sprachmittel wie integrierte Unit‑Tests und String Mixins; Automatische Speicherbereinigung (Garbage Collector) ist im Gegensatz zu z.B. C/C++ fester, wenn auch prinzipiell optionaler Bestandteil der Sprache.  DMD, der Digital Mars D‑Compiler, bildet die Referenzimplementierung, von Walter Bright für die x86/x86-64‑Versionen von Windows, Linux, macOS und FreeBSD erhältlich. Der GNU D Compiler GDC verbindet das Frontend von DMD mit dem GCC‑Backend (ab GCC 9.1), so wie der LLVM D Compiler LDC das Frontend von DMD mit dem LLVM‑Backend verbindet. Ebenso wurden die Compiler Dil und Dang in D selbst programmiert, die kompatibel zu LLVM sind. Mit Poseidon existiert sogar eine in D geschrieben IDE, die Autovervollständigung sowie Refactoring unterstützt und einen integrierten Debugger bietet – unter den IDEs zum Programmieren in D sei auch auf den D Extended EDitor hingewiesen. GNU Debugger und WinDbg unterstützen D rudimentär (Stand: Ende 2019).
Weitere Infos siehe Wikipedia oder z.B. den Artikel in Heise‑Magazinen: iX, 12/2019, S. 150, und iX, 13/2020, S. 26-29, dem Buch Programming in D by Ali Çehreli (inkl. kostenlosem  PDF) oder schlicht einer Internet‑Suche nach dem Stichwort Dlang.

^🏗️ ) Rust ist eine recht neue, von Mozilla Research entwickelte und 2010 erschienene Sprache (erste stabile Version 2015; aktuell ist 1.45, siehe Heise‑Developer, 17.07.2020 oder iX 13/2020, S. 16-19). Diese Programmiersprache, die sicher, nebenläufig und praxisnah sein sollte, habe ich zwar weiter unten nicht als eine meiner Empfehlungen aufgeführt, wohl aber bzgl. der Ranglisten der Programmiersprachen mit deutlichem Vorsprung vor Go herausgehoben.
Eine der Gründe liegt am immer wieder anvisierten möglichen Einsatz von Rust für Linux-Systemtreiber (siehe z.B. LKML vom 27.04.2019 oder den LWN‑Beitrag vom 29.08.2019 zur positiven Aufnahme zukünfigen Codes in Rust durch Greg Kroah‑Hartman), was ebenfalls deutlich in einer wissenschaftlichen Studie anklang, nach der die meisten Sicherheitsprobleme in den Treibern zu finden seien (siehe Preprint: arxiv.org/1909.06344 vom 13.09.2019). Und in 2020 scheint dies nun konkretere Formen anzunehmen (vgl. Heise‑Developer, 14.07.2020) und wird auch für den zukünftigen Gebrauch in Mesa diskutiert (vgl. Phoronix, 02.10.2020).
Ende 2019 gab es erneute Diskussionen, ein offizielles Frontend für Rust in GCC einzuführen – bisher gibt es lediglich Out‑Of‑Tree‑Fassungen (siehe den Phoronix‑Artikel vom 03.12.2013), wobei eine Aufnahme auch zur allgemeinen Sprachdefinition zu begrüßen wäre (vgl. Phoronix‑Artikel vom 28.12.2019). Wenn die Rust‑Entwickler mitzögen, könnte so das Henne‑Ei‑Problem elegant vermieden werden.

Fehlersuche im Binary mit dem Debugger GDB

Umgang mit Quelltexten: Editoren und IDEs

Automatisierte Erstellung von Binaries: Makefiles als Steuerdatei des Utilitys make

# ******************************************************************************
# * 'Makefile' des Verzeichnisses '~/mycpp/jmb/'                               *
# *                                                                            *
# * J.M.B.  [URL: https://www.jmb-edu.de/cpp_programming.html#makefileexamp]   *
# *                                                                            *
# * Lizenz:   (c) 2019 unter GPLv3: https://www.gnu.org/licenses/gpl-3.0.txt   *
# *                                                                            *
# * Erstellung:           05.08.2019                                           *
# *                                                                            *
# * Letzte Umgestaltung:  04.09.2019  (Phase 2; vgl. Phase 1 vom 08.08.2019)   *
# ******************************************************************************

# * Dafuer sorgen, dass 'all' und 'clean' auch dann ausgefuehrt werden,
#   wenn die jeweils entsprechende Datei existieren sollte:
.PHONY: all     clean   exampd  exampf  example_debug   example c       cf

# * Beim Hilfstext nicht durch doppelte Ausgabe verwirren, also das Kommando
#   nicht vor der Ausfuehrung ausgeben:
.SILENT:        info    help    h

# * Definitionen von sinnvollen Compiler-Flag-Kombinationen als Variable
#   (hier ist noch viel Raum fuer Verbesserungen - nur ein Anfang):

# o Debug Modus: optimierte Debugging-Faehigkeit mit allen Standard- sowie
#   allen Extra-Warnungen (zum Lernen beim Edit-Compile-Debug-Zyklus):
cppflagsd = -Og -Wall -Wextra

# o Space Modus: optimiert bzgl. Groesse und alles von -O2, das dem nicht
#   zuwider laeuft (falls man es mal brauchen sollte ;):
cppflagss = -Os

# o Final Modus: optimiert haerter bzgl. Kompilierzeit und Geschwindigkeit
#   des Binarys.
cppflagsf = -O2

# * Fuer Namensgebung der Backup-Datei Datum und Zeit als String besorgen:
bckdate := $(shell date +%Y%m%0e%0k%M%S)
bckname := ~/Downloads/mycpp_jmb_$(bckdate).tgz
humdate := $(shell date +%a.,\ %0e.%m.%Y,\ %0k:%M:%S)
humdatedate := $(shell date +%a.,\ %0e.%m.%Y)
humdatetime := $(shell date +%0k:%M:%S)

# ** Das nun kommende erste Target wird ausgefuehrt, wenn 'make' ohne
#    Argument, d.h. der Angabe des Targets, aufgerufen wird:

# * Hilfstext (zur Uebersicht, was alles gemacht werden kann; siehe Screenshot unten):
info help h:
                -echo "Zur Zeit sind die folgenden Parameter moeglich:         ^***************"
                -echo "  ep = ed = edit = e:                                     * Hilfs-Text *"
                -echo "    Quelltext des Programms mit vim editieren,             * zu 'make' *"
                -echo "  em:                                                     * von J.M.B. *"
                -echo "    Editieren von 'Makefile' mit vim,                   ^***********   *"
                -echo "  exampd = example_debug = c:                                      *   *"
                -echo "    Kompilieren & Linken von 'example_debug' & 'ls -l' vom Binary, *   *"
                -echo "  exampf =  example = cf:                                          *   *"
                -echo "    Kompilieren & Linken von 'example' und 'ls -l' vom Binary,     *   *"
                -echo "  all {= exampd & exampf}:                                         *   *"
                -echo "    Erzeugen beider Binaries: 'example_debug' & 'example',         *   *"
                -echo "  r:                                                               *   *"
                -echo "    Aufrufen von 'example_debug args' & Fehlercode ausgeben,       *   *"
                -echo "  run:                                                             *   *"
                -echo "    Aufrufen von 'example args' - danach Fehlercode ausgeben,      *   *"
                -echo "  clean:                                                           *   *"
                -echo "    Hausputz (: 'example_debug' loeschen),                         *   *"
                -echo "  superclean:                                                      *   *"
                -echo "    Fruehlingsputz (% 'clean' + loeschen von 'example'),           *   *"
                -echo "  backup = bck                                   **** [jmb-edu.de] *   *"
                -echo "    Erstellen einer tgz-Sicherung,               *  ****************   *"
                -echo "  help = h = info = '' {d.h. ohne Target}:       * Have Fun with GNU!  *"
                -echo "    Diesen Hilfstext ausgeben.                   ***********************"
                -echo "  == GNU 'make' ${MAKE_VERSION} gestartet am $(humdatedate), um $(humdatetime) Uhr ! =="

# * Was man unter `mach alles' verstehen soll (z.B. mehrere Binaries bauen;
#   dieses Target ist zumeist das erste und wird bei 'make' ausgefuehrt):
all:    exampd  exampf

# * Sprungpunkt/Target fuer das Programm (Name und was damit passieren soll):
# -a) Optimiert fuer optimale Debbuging-Faehigkeit, allen Standard-
#     sowie den Extra-Warnungen (zum Lernen beim Edit-Compile-Debug-Zyklus):
exampd c example_debug:         example.cpp
                -g++ $(cppflagsd) example.cpp -o example_debug
                -ls -l example_debug

# - b) Optimiert fuer Kompilierzeit und Geschwindigkeit des Binarys:
exampf cf example:              example.cpp
                -g++ $(cppflagsf) example.cpp -o example
                -ls -l example
# ... fuer weitere Verbesserungen siehe z.B.:
#  https://developers.redhat.com/blog/2018/03/21/compiler-and-linker-flags-gcc/

# * Editieren:

# o ... des Programm-Quellcodes:
ep ed edit e:
                -vim example.cpp

# o ... des Makefiles:
em:
                -vim Makefile

# * Binary aufrufen, danach Fehlercode auslesen (0 = OK; sonst = KO):
r:
                -./example_debug $(filter-out $@,$(MAKECMDGOALS)); echo "Fehlercode: "$$?" !"

# * Fuer andere als die ausgewiesenen Targets mache nichts
#   (wegen r/run-Optionen noetig, sie sonst je eine Fehlermeldung gaeben) -
#   Vorsicht: 'make quark' macht nichts - auch keine Fehlermeldung!:
%:
                @:

run:
                -./example $(filter-out $@,$(MAKECMDGOALS)); echo "Fehlercode: "$$?" !"

# * Waere Compilieren und Ausfuehren gewuenscht, dies auskommentieren:
#cr:    c       r

# * Hausputz (Problemreste und Debug-Binary werden geloescht):
clean:
                -rm -f core *.o *.bak *~ example_debug

# * Fruehlingsputz (auch das finale Binary wird nun geloescht):
superclean:     clean
                -rm -f example

# * Sicherung (als gezipptes tar-Archiv):
backup bck:     clean   exampd
                -echo "Sichere in: '$(bckname)' ..."
                -cd .. ; tar cfvz $(bckname) jmb/ ; cd jmb

# Zu beachten ist, dass nach "TARGET:" bzw. am leeren Zeilenanfang Tabs
# stehen muessen - Leerzeichen funktioniert nicht - ebenso zwischen
# multiple targets, die von einem anderen (hier 'all' oder 'bck')
# aufgerufen werden!
# Somit darf man auch nicht Copy&Paste machen (Blanks werden dann durch
# Leerzeichen ersetzt), sondern kopieren oder ueber 'tar' sichern ...

# ******************************************************************************
# * Das war's ...  Viel Spass beim eigenen Experimentieren und Programmieren ! *
# ******************************************************************************

if [ -f "$HOME/.alias" ]; then
  . "$HOME/.alias"
fi

Einstimmung in Programmiersprachen

Historische Entwicklung der drei Generationen

C als hardwarenahe Programmiersprache

Empfehlung einer Programmiersprache

• Mit besonderem Renommee startet diese Aufzählung mit der IEEE Rangliste der Programmiersprachen, bei der C auf Platz 3 und C++ auf Rang 4 landen, Platz 1 Phython, Platz 2 Java, nach C++ liegt R auf Rang 5 und JavaScript auf Rang 6.
• Nach den Analysten RedMonk liegt C++ auf Rang 5 und C auf Rang 9, wobei die hier gezeigte Grafik von Beliebtheit auf GitHub gegen Beliebtheit des Entwicklerforums Stack Overflow interessant ist.
• In einer Stack-Overflow-Umfrage unter Profientwicklern wurden Rust und Python zu den beliebtesten Sprachen gezählt, C++ stand auf Rang 19, C auf Rang 24.
• Nach einer anderen Umfrage ist Python die populärste Programmiersprache für Data Science.
• Monatlich gibt es auch die TIOBE Rangliste, die im September 2019 C auf Rang 2 hinter Java und C++ auf Rang 4 hinter Python ausweist.

Einstimmung  in C++

Historie und Normen von C++

Eigenschaften und sich daraus ergebende Haupt‑Anwendungsbereiche

(insb. bei Spielen, z.B. SuperTux oder SuperTuxKart, wie auch bei der Spiel-Engine Godot [ab 4.0 soll C++11 verwendet werden; für einen englischen Überblick siehe  Godot & C++ – How, What and Why? sowie  Why Godot Over Unity or Unreal Engine? bzw. die Godot News]; vgl. Literatur zur Spiele‑Programmierung)

Vorstellen eines Beispiel‑Programms in C++

Quelltext 

/******************************************************************************
 * C++-Programm 'example.cpp' im Verzeichnis '~/mycpp/jmb/'                   *
 *                                                                            *
 * Funktion:    "Zerlegung einer Zahl in ihre Primfaktoren"                   *
 *                                                                            *
 * J.M.B.   [URL: https://www.jmb-edu.de/cpp_programming.html#progcppexamp]   *
 *                                                                            *
 * Lizenz:  (c) 2019  unter GPLv3: https://www.gnu.org/licenses/gpl-3.0.txt   *
 *                                                                            *
 * Erstellung:           05.08.2019                                           *
 *                                                                            *
 * Letzte Umgestaltung:  07.09.2019  (Phase 2; vgl. Phase 1 vom 08.08.2019)   *
 ******************************************************************************
 */

/* Einbau von Bibliotheken der C++-Standardbibliothek: */
# include <string>                     // fuer std::string {Container-Typ}:
                                       //   std::stoi/stoll, std::to_string
# include <vector>                     // fuer std::vector {Container-Typ}
# include <iostream>                   // fuer std::cin, std::cout, std::endl
# include <sstream>                    // fuer std::stringstream/ostringstream
# include <fstream>                    // fuer std::ofstream (Datei: file)
# include <stdexcept>                  // exception - zur Ausnahme-Behandlung
# include <cmath>                      // C-Mathe-Lib in C++ fuer: std::sqrt(l)
# include <ctime>                      // " std::time_t/struct tm/time/localtime

/* Gebrauch von ANSI-Farben in kompatiblen Terminals:
 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 * Effekt          Code   |  Farbe   Vordergrund Hintergrund |  ASCII 27 = \033
 * zuruecksetzen     0    |  schwarz       30         40     |   = ESC-Zeichen
 * fett/hell         1    |  rot           31         41     | Z.B. hell rot
 * unterstrichen     4    |  gruen         32         42     |      auf schwarz
 * invertiert        7    |  gelb/orange   33         43     |  "\033[4;31;40m"
 * fett/hell aus    21    |  blau          34         44     | Clear Screan:
 * unterstri. aus   24    |  magenta       35         45     |"\033[2J\033[1;1H"
 * invertiert aus   27    |  cyan          36         46     | Reset: "\033[0m"
 *   * Just play ! *      |  weiss/grau    37         47     |  * Have fun! *
 */
// * Globale String-Konstanten zur Festlegung der ANSI-Steuercodes, hier
// *   bzgl. STIL_VGFARBE_HGFARBE (siehe Erklaerung oben; Esc=x1B=27=\033):
const std::string              // Definition aller ANSI-ESC-Sequenzen / Farben
// Anstelle: '# define RESET "\033[0m"' fuer Praeprozessor nun:
  RESET            = "\x1B[0m",        // Reset to Defaul: zuruecksetzen
  CLRSCR           = "\x1B[2J\x1B[1;1H", // wie in C++ 'std::system("clear");'
  UL_LWHITE_BROWN  = "\x1B[1;4;37;43m",// unterstrichen weiss auf orange
  LWHITE_BROWN     = "\x1B[1;37;43m",  // weiss auf braun/orange
  UL_LYELLOW_BROWN = "\x1B[1;4;33;43m",// unterstrichen gelb auf braun/orange
  LYELLOW_BROWN    = "\x1B[1;33;43m",  // gelb auf braun/orange
  UL_LRED_BLACK    = "\x1B[1;4;31;40m",// unterstrichen rosa auf schwarz
  LRED_BLACK       = "\x1B[1;31;40m",  // rosa auf schwarz
  LYELLOW_BLACK    = "\x1B[1;33;40m",  // gelb auf schwarz
  UL_LYELLOW_GREEN = "\x1B[1;4;33;42m",// unterstrichen gelb auf gruen
  RED_BROWN        = "\x1B[31;43m";    // rot auf braun/orange

// * Globale Variable zur Festlegung, ob Ausgabe ohne ANSI-Farben gewuenscht ist
bool farbLos = false;                  // wird nur von main umgeaendert!

// * Nun eine zweiteilige Funktion zum (ggf. farbigen) Start bzw. Ende ;)
void begruessung (std::ostream& os, bool anfang, std::string prgname)
{ using std::endl;                     // endl bedeutet nun std::endl
  if (anfang)                          // * anfang: 1 = true (= Begruessung)
  { /* Begruessung */
    if (farbLos)
    {                                  // prgname = argv[0], d.h. Aufrufstring
      os << " * Programm '" << prgname << "' zur Ausgabe der Primfaktoren *";
      os << endl;
    } else
    {                                  // prgname = argv[0], d.h. Aufrufstring
      os << UL_LYELLOW_BROWN << " * Programm '" << UL_LYELLOW_GREEN << prgname;
      os << UL_LYELLOW_BROWN << "' zur Ausgabe der Primfaktoren *" << RESET;
      os << endl;
    }
  } else                               // * anfang: 0 = false (= Abschied)
  { /* Verabschiedung */
    if (farbLos)
    {
    os << " * Macht's gut, Kinners!  \U0001F609 * -<\u00A9 2019 J.M.B., GPLv3\U0001F60E>-";
    os << endl;
    } else
    {
    os << UL_LWHITE_BROWN << " * Macht's gut, Kinners! ";
    os << LYELLOW_BROWN << "\U0001F609" << UL_LWHITE_BROWN;
    os << " * -<\u00A9 2019 J.M.B., GPLv3" << RED_BROWN << "\U0001F60D";
    os << UL_LWHITE_BROWN << ">-" << RESET << endl;
    }
  }
} // Ende: void begruessung (std::ostream& os, bool anfang, std::string prgname)

// * Nun eine Funktion zur Ausgabe von Fehler-Hinweisen:
void meldeInfo (std::ostream& os, bool errMsg, std::string msgStr)
{ using std::endl;                     // endl bedeutet nun std::endl
  if (errMsg)                          // errMsg = 1: "Fehler: ..."
  { /* ehemals void fehlerInfo (std::ostream& os, std::string fehlerStr) */
    if (farbLos)
    {
    os << " * Fehler: " << msgStr << "!" << endl;
    } else
    {
    os << LRED_BLACK << " * " << UL_LRED_BLACK << "Fehler:" << RESET;
    os << " " << msgStr << "!" << endl;
    }
  } else                               // errMsg = 0: "Info: ..."
  { /* ehemals void hinweisInfo (std::ostream& os, std::string hinweisStr) */
    if (farbLos)
    {
    os << " * Info: " << msgStr << endl;
    } else
    {
    os << LYELLOW_BROWN << " * " << UL_LYELLOW_BROWN << "Info:" << RESET;
    os << " " << msgStr << endl;
    }
  }
} // Ende: void meldeInfo (std::ostream& os, bool errMsg, std::string msgStr)

void ausgabeInfotext (std::ostream& os, bool hlpMsg)
{
  if (hlpMsg)                          // hlpMsg = 1: Hilfs-Text ..."
  {
    if (!(farbLos))
     os << LYELLOW_BROWN << " * Hilfstext:" << LWHITE_BROWN << "\n";
    os << " *******************************************************************\n";
    os << " * Generelle Funktion und Spezialparameter des Programms 'example' *\n";
    os << " *-===============================================================-*\n";
    os << " * Es ist moeglich, als 1. Parameter ein Steuerflag einzugeben:    *\n";
    os << " * o Keinen Spezialparameter (d.h. kein Steuerflag):               *\n";
    os << " *   Parameter / interaktiv einzugebende Zahlen als Strings holen  *\n";
    os << " *   und nacheinander bearbeiten: jeweils Ganzzahlen zwischen      *\n";
    os << " *   2 und 18446744073709551615 (2^64-1), auch hex. wie 0x9AFE,    *\n";
    os << " *   in Primfaktoren zerlegen und die Faktoren ausgeben.           *\n";
    os << " *   Alle Nichtzahlen werden ignoriert - sie koennen aber als      *\n";
    os << " *   Zahlentrenner eingesetzt werden (wie 66,0x1B bzw. 66/12/9).   *\n";
    os << " *   Eingabe eines Zeichens: 'H' - Hilfs-, 'V'- Versions-Text und  *\n";
    os << " *   'B' - beide interaktiv abrufbar, mit '1'/'Q' abbrechen.       *\n";
    os << " * o -f --file    => Ausgabe des Parameter-Teils in eine Datei -   *\n";
    os << " *                   eine interaktive Abfrage erfolgt nicht.       *\n";
    os << " * o -m --mono    => Monochromatisch mit Default-Farben vom xterm  *\n";
    os << " * o -i --inverse => Invertierte Darstellung (mit Nostalgie \U0001F917 )   *\n";
    os << " *                   gelb auf schwarz (wie Turbo Pascal 3.0)       *\n";
    os << " * o -h --help    => Diesen Hilfstext ausgeben und beenden         *\n";
    os << " * o -v --version => Version, Datum, Autorinfo, Lizenz & beenden   *\n";
    os << " * o -b -vh -hv   => Versions- und Hilfs-Text ausgeben & beenden   *\n";
    os << " *******************************************************************";
  } else                               // hlpMsg = 1: Versions-Text ..."
  {
    if (!(farbLos))
     os << LYELLOW_BROWN << " * Versionstext:" << LWHITE_BROWN << "\n";
    os << " *******************************************************************\n";
    os << " * C++-Programm fuer GNU/Linux >example< in Version 2.00 (Phase 2) *\n";
    os << " * \u00A9 2019  J.M.B. (URL: https://www.jmb-edu.de/)  03.09.2019 GPLv3 *\n";
    os << " * [URL: https://www.jmb-edu.de/cpp_programming.html#progcppexamp] *\n";
    os << " *******************************************************************";
  }
  if (!(farbLos))
    os << RESET;
  os << std::endl;
} // Ende: void ausgabeInfotext (std::ostream& os)

// * Globale Variable fuer Dateiname
std::string outputFilename = "";  // v- spaeter mit Zeitstempel YYYYMMDDHHMMSS..
std::string myOutputFilename = "PrimZahlZerlegung_JMB.txt";// Ueberschreibschutz

// * Zwei Funktionen zum Erhalt des Datumsstrings (braucht '# include <ctime>'):
std::string addZeroIOD (std::ostream& os, std::string addStr)
{
  if (addStr.length() == 1)
  {
    addStr = std::string("0")+addStr;  // ergaenze fuehrende 0 bei einer Ziffer
  } else if ((addStr.length() == 0) || (addStr.length() > 2))  // 2 ist OK :)
  {
    meldeInfo (os, 1, "Falsche Stringlaenge in addZeroIOD!");
    return "";                         // macht nichts kaputt - Fehler sichtbar
  }
  return addStr;
} // Ende: addZeroIOD (std::ostream& os, std::string addStr)

std::string getDatStr (std::ostream& os)
{ using namespace std;                 // sollte vermieden werden; hier klein
  tm *nun;                             // ein struct fuer Zeitangaben: tm_*
  time_t now = time(0);                // Sekunden seit 00:00, Jan 1 1970 UTC
  nun = localtime(&now);               // Konvertieren in Kalenderzeit
  int dateYear = 1900 + nun->tm_year;  // Jahr:     seit 1900 (= 0)
  int dateMonth =   1 + nun->tm_mon;   // Monate:   0-11
  int dateDay =         nun->tm_mday;  // Tage:     1-31
  int timeHour =        nun->tm_hour;  // Stunden:  0-23
  int timeMin =         nun->tm_min;   // Minuten:  0-59
  int timeSec =         nun->tm_sec;   // Sekunden: 0-60 (Schaltsekunde)
  string dateTime = to_string (dateYear);  // Start dateTime mit Jahreszahl
  string addStr = addZeroIOD (os, to_string (dateMonth)); // Monat zweist. ..
  dateTime += addStr;                  // .. in addStr und diesen anfuegen
  addStr = addZeroIOD(os, to_string (dateDay));      // Tag zweistellig ..
  dateTime += addStr;                  // .. in addStr und diesen anfuegen
  addStr = addZeroIOD(os, to_string (timeHour));     // Stunden zweistellig ..
  dateTime += addStr;                  // .. in addStr und diesen anfuegen
  addStr = addZeroIOD(os, to_string (timeMin));      // Minuten zweistellig ..
  dateTime += addStr;                  // .. in addStr und diesen anfuegen
  addStr = addZeroIOD(os, to_string (timeSec));      // Sekunden zweistellig ..
  dateTime += addStr;                  // .. in addStr und diesen anfuegen
  return dateTime;                     // Zeitstring als YYYYMMDDHHMMSS zurueck
} // Ende: std::string getDatStr (std::ostream& os)

// * Globale Variable fuer Primfaktorliste:
// *   Funktion suchePrimFaktoren bestueckt sie,
// *   Funktion ausgabePrimFaktoren liest sie
// *     fuer Ausgabe aus und setzt sie zurueck.
std::vector<unsigned long long> wertepfs;

// * Globale Variable, die bei ausgabePrimFaktoren ausgelesen und
// *   ausgegeben wird und an deren Ende auch inkrementiert (+1) wird.
unsigned long long anzFaktorZerlegungen = 1;

// * Globale Variablen fuer Eingabe ueber Parameter/Tastatur ...
std::string inputStr = "";             // Einlese-String
std::string::size_type sz = 0;         // Entspricht size_t (ein Alias)
// sz dient als Marker fuer StringRest-Kopie in verwandleStringInULL !

// * Funktion zur PF-Ermittlung - der eigentliche Algorithmus (d.h. das Herz)
void suchePrimFaktoren (unsigned long long n)
{
  /* 1. Schritt: */
  // Anzahl 2-en ausgeben, durch die n (vor 1. Schritt) dividiert werden kann
  while (n%2 == 0)                     // wenn bei Division kein Rest
  {
    wertepfs.push_back (2);            // jeder Faktor wird gemerkt -> wertepfs
    n = n/2;
  }
  /* 2. Schritt: */
  // n (Anfang 2. Schritt) muss nun ungerade sein - Primfaktoren 2 wurden
  // entdeckt, somit kann man immer eine Zahl uebergehen, daher i=i+2
  for (unsigned long long i = 3; i <= std::sqrt(n); i = i+2)
  { // .. nach GCC Namspace-Fix sqrtl statt^^^^ verwenden (C++17-Voraussetzung)
    // Solange n durch i teilbar ist, wird i ausgegeben (analog 2 oben)
    while (n%i == 0)                   // wenn bei Division kein Rest
    {
      wertepfs.push_back (i);          // jeder Faktor wird gemerkt -> wertepfs
      n = n/i;
    }
  }
  /* 3. Schritt: */
  // Wenn for bis i = Wurzel n (n nach 1. Schritt) nicht n=1 (Ende 2. Schritt)
  // liefert, muss n der letzte fehlende Primfaktor der Zerlegung sein
  if (n > 2)                           // n ist der letzte fehlende PF ...
  {
    wertepfs.push_back (n);            // n wird als PF gemerkt -> wertepfs
  }
} // Ende: void suchePrimFaktoren (unsigned long long n)

void ausgabePrimFaktoren (std::ostream& os, unsigned long long wert)
{
  int pfanz = 0;                       // Anzahl Primfaktoren - hier int OK!
  std::string pfliststring = "  ";     // Def.+Initialisierung von String
  std::string dummystring = "";
  unsigned int curoutstrllength = 0;   // Laenge der aktuellen pfliststring-Z.
  unsigned int addfutstrlength= 0;     // Laenge der naechsten Ergaenzung
  const unsigned int maxlength = 75;   // Angabe der maximalen Zeilenlaenge - 1
  std::string zeilUmbrStr = ",\n *   ";
  if (!(farbLos))
    zeilUmbrStr = ",\n"+LYELLOW_BROWN+" * "+RESET+"  ";
  for (unsigned long long primfaktor : wertepfs)
  {
    if (pfanz < 1)
    {
      pfliststring += std::to_string (primfaktor);  // to_string ab C++11
      curoutstrllength = pfliststring.length();     // Startlaenge der Zeile
    } else                                          // es gab Vorgaenger: +' ,'
    {
      dummystring = std::to_string (primfaktor);
      addfutstrlength = (2+dummystring.length());
      if (!(curoutstrllength+addfutstrlength+2 < maxlength))
      {
        pfliststring += zeilUmbrStr;                // Zeilenumbruch + Platz
        curoutstrllength = addfutstrlength;         // Neuer Start Zeilenlaenge
      } else
      {
        pfliststring += ", ";                       // Komma + wenig Platz
        curoutstrllength += addfutstrlength;        // Zeilenlaenge vergroess.
      }
      pfliststring += std::to_string (primfaktor);  // aktuelle PF dem Str. zuf.
    }
    ++pfanz;
  }
  pfliststring += ".";                 // Abschlusspunkt
  if (pfanz < 2)
  {
    if (!(farbLos))
    {
      os << LYELLOW_BROWN << " * " << RESET;
    } else
    {
     os << " * ";
    }
    os << "Der " << anzFaktorZerlegungen << ". Wert '" << wert;
    os << "' ist bereits prim." << std::endl;   // \n und Flushen am Schluss
  } else
  {
    if (!(farbLos))
    {
      os << LYELLOW_BROWN << " * " << RESET;
    } else
    {
      os << " * ";
    }
    os << " Der " << anzFaktorZerlegungen << ". Wert '" << wert;
    os << "' konnte in " << pfanz << " Primfaktoren zerlegt werden:\n";
    if (!(farbLos))
    {
      os << LYELLOW_BROWN << " * " << RESET;
    } else
    {
      os << " * ";
    }
    os << pfliststring << std::endl;   // Liste als Abschluss, \n und Flushen!
  } // Angaben x86_64-Linux, signed|uns. int|long|long long ist systemabhaengig:
  if        (wert == 18446744073709551615ull)// 2^64-1 groesster 64 Bit - Wert!
  {
    meldeInfo (os, 0, "Ende von 'unsigned long long' erreicht - groesser nur mit Spezial-Libs!");
  } else if (wert >  9223372036854775807)  // 2^63-1 grosster signed 64 Bit - W!
  {
    meldeInfo (os, 0, "Hier war 'unsigned long long' statt '>long long<' notwendig!");
  } else if (wert >           4294967295)  // 2^32-1 grosster unsigned 32 Bit-W!
  {
    meldeInfo (os, 0, "Hier war 'unsigned long long' statt '>unsigned int<' notwendig!");
  } else if (wert >           2147483647)  // 2^31-1 grosster signed 32 Bit-W!
  {
    meldeInfo (os, 0, "Hier war 'unsigned long long' statt '>int<' notwendig!");
  } else if (wert >                  255)  // 2^8-1  grosster unsigned 8 Bit-W!
  {
    meldeInfo (os, 0, "Hier war 'unsigned long long' statt '>unsigned char<' notwendig!");
  } else if (wert >                  127)  // 2^7-1  grosster signed 8 Bit-W!
  {
    meldeInfo (os, 0, "Hier war 'unsigned long long' statt '>signed char<' notwendig!");
  }
  /* Vector wertepfs loeschen, damit Platz fuer neue Eintraege ist */
  wertepfs.clear();
  ++anzFaktorZerlegungen;              // Globale Variable als Zaehler: +1
} // Ende: void ausgabePrimFaktoren (std::ostream& os, unsigned long long wert)

// * Diese Funktion loescht fuehrende Zahlen (zu gross fuer ULL), indem diese
// *   im Uebergabestring geloescht werden und der Rest uebergeben wird.
// * Fuer vorzeichenlose Ganzzahl-Typen ist die Funktion schon allgemein.
std::string loescheFuehrendeZahlen (std::ostream& os, std::string stringRest)
{
  unsigned int stringRestLength = stringRest.length();  // Laenge stringRest
  if (stringRestLength == 0)
  { // die Funktion kann mit Leerstring starten und damit enden - kein Fehler!
    meldeInfo (os, 1, "Leerstring bei loescheFuehrendeZahlen sollte nicht vorkommen");
    return "";
  }
  if (!(std::isdigit(stringRest[0])))
  {
    meldeInfo (os, 1, "Aufruf von loescheFuehrendeZahlen mit 1. Zeichen keine Zahl");
    return stringRest;                 // Parameter startet mit Zahl - nix tun
  } else
  {                                    // 1. Zeichen [0] wird geloescht - mehr?
    for (unsigned int i = 1; i < stringRestLength; ++i)
    {                                  // wieviele Zeichen werden geloescht: i
      if (!(std::isdigit(stringRest[i])))  // keine Zahl, dann hier Abbruch
      {
        return (stringRest.erase(0, i)); // ab 0 {= Anfang}: i Zeichen loeschen
      }
    }
    return "";                           // alle Zeichen Zahlen - Leerstring
  }
} // Ende: string loescheFuehrendeZahlen (ostream& os, std::string stringRest)

// * Diese Funktion loescht fuehrende Nicht-Zahlen, indem diese im
// *   Uebergabestring geloescht werden und der Rest uebergeben wird.
// * Fuer vorzeichenlose Ganzzahl-Typen ist die Funktion schon allgemein,
// *   wenn man nicht strenger mit dem Anwender sein will/muss.  ;)
std::string loescheFuehrendeNichtZahlen (std::ostream& os, std::string stringRest)
{
  unsigned int stringRestLength = stringRest.length();  // Laenge stringRest
  if (stringRestLength == 0)
  { // die Funktion kann mit Leerstring starten und damit enden - kein Fehler!
    return "";
  }
  if (std::isdigit(stringRest[0]))
  {
    return stringRest;                 // Parameter startet mit Zahl - nix tun
  } else
  {                                    // 1. Zeichen [0] wird geloescht - mehr?
    if ((stringRest[0] == '-') && (std::isdigit(stringRest[1])))
      meldeInfo (os, 1, "Negative Zahlen sind nicht erlaubt: '-' wird verworfen");
    for (unsigned int i = 1; i < stringRestLength; ++i)
    {                                  // wieviele Zeichen werden geloescht: i
      if (std::isdigit(stringRest[i]))
      {
        return (stringRest.erase(0, i)); // ab 0 {= Anfang}: i Zeichen loeschen
      } else if ((stringRest[i] == '-') && (std::isdigit(stringRest[(i+1)])))
      {                                  // nur bei - Meldung - Rest stumm weg
        meldeInfo (os, 1, "Negative Zahlen sind nicht erlaubt: '-' wird verworfen");
      }                                  // alles andere wird uebergangen
    }
    return "";                           // alle Zeichen keine Zahlen - Leerstr.
  }
} // Ende: string loescheFuehrendeNichtZahlen (ostream& os, string stringRest)

// * Diese Funktion wandelt einen String in die zugehoerige ULL
// *   (groesster positiver C++-Standard-Ganzzahltyp) und faengt
// *   alle Probleme ab - da negative Werte ohne jede Kennzeichnung
// *   unsinnig konvertiert werden, wird zur Eliminierung von '-'
// *   die obige Funktion loescheFuehrendeNichtZahlen vorgeschaltet.
// * Sollte diese Funktion in anderem Zusammenhang verwendet werden,
// *   darf nicht mehr 0 angemahnt und ansonsten zum Weitermachen verwendet
// *   werden, sondern sollte ueber einen Fehlerstatus weitergegeben werden,
// *   der ggf. eine globale Variable ist als ullConvErr oder ULL global und
// *   den Boolean als Rueckgabe, da eine Funktion nur einen Rueckgabewert
// *   hat (wenn man kein Konstrukt uebergeben will) - zudem sollte als
// *   Parameter einfach "(std::string teilString)" mitgegeben werden - hier
// *   werden globale Variablen wegen komplexer KBD-Schleife verwendet ... -
// *   und der Reststring wird in dieser Funktion mit sz beschnittet ... -
// *   ansonsten ist die Funktion bereits allgemein.
unsigned long long verwandleStringInULL (std::ostream& os)
{
  unsigned long long wert = 0;         // Definition mit Startwert: Rueckgabe
  try                                  // Solange kein Fehlert auftritt ...
  {
    wert = std::stoull (inputStr,&sz,0);  // ... sollte dies die Zahl sein.
    if (wert == 0)                     // 0 wird sonst verwendet als 'continue'
    {
      meldeInfo (os, 1, "Es wurde '0' eingegeben"); // 0 bei Faktorzerlegung unsinnig
    }
  } catch (std::invalid_argument &exc) // --- Erster Handler ...
  {
    meldeInfo (os, 1, "Ungueltiger Aufrufparameter: nicht in ULL konvertierbar");
    inputStr = loescheFuehrendeZahlen(os, inputStr);
    return 0;                          // hier abbrechen, aussen weitermachen
  } catch (std::out_of_range &exc)     // --- zweiter Handler ...
  { // bei ULL bedeutet ^- dies zu gross - negativ wird nicht erkannt!
    meldeInfo (os, 1, "Ungueltiger Aufrufparameter: ausserhalb der ULL-Grenzen (zu gross)");
    inputStr = loescheFuehrendeZahlen(os, inputStr);
    return 0;                          // hier abbrechen, aussen weitermachen
  } catch( ... )                       // ... dritter Handler fuer den Rest.
  {
    meldeInfo (os, 1, "Seltsames Problem bei der Umwandlung in ULL-Grenzen aufgetreten");
    inputStr = loescheFuehrendeZahlen(os, inputStr);
    return 0;                          // hier abbrechen, aussen weitermachen
  }
  // Nur Loeschen der Zahl bei Ueberlauf/Umwandlung verlaesst zuvor - return 0:
  inputStr = inputStr.substr(sz);      // inputStr ist nun der Rest ...
  return wert;
} // Ende: unsigned long long verwandleStringInULL (std::ostream& os)

// * Nun zwei Funktionen, zuerst werden Kommandozeilen-Parameter gesucht (CLP),
// * dann wird eine Eingabe ueber die Tastatur erbeten und gelesen (KBD).
// * Wegen der zentralen Schleifen stehen sie direkt vor main ...

// Diese Funktion ermittelt die Parameter und wertet diese einzeln als String
// aus, die in jeweils eine oder mehrere Zahlen ueberfuehrt werden,
// die in einer Schleife abgearbeitet werden:
// sie sollen in Primfaktoren zerlegt und so ausgegeben werden.
unsigned long long eingabeCLPZahlZumFaktorisieren (std::ostream& os, int argc,
  const char* argv[], bool frstParamUsed)
{
  unsigned long long wert = 0;         // < 2 ist Fehlercode, > 1 ist ges. Wert
    for (int i = 1; i < argc; ++i)
    {
      if ((i == 1) && (frstParamUsed))    // 1. Parameter "-f" wegwerfen!
      {
        meldeInfo (os, 0, "1. Parameter enthielt Steuerflag - ist kein Input.");
        continue;
      }
      inputStr = argv[i];  // fuer meine Funktionen editierbar als std::string
      // * String muss mit Zahl beginnen, kein '-' oder gar Buchstabe:
      inputStr = loescheFuehrendeNichtZahlen (os, inputStr);
      while (!inputStr.empty())
      {
        wert = verwandleStringInULL (os);  // inputStr wird verwendet
// * Bedeutet: std::stoull (dummyString,&sz,0) & inputStr.substr(0,sz) kopiert.
        if (wert > 1)                    // OK, wert kann zerlegt werden
        {
          /* PFs ermitteln und in vector wertepfs speichern */
          suchePrimFaktoren (wert);
          /* PFs aus wertepfs lesen, mit "," getrennt ausgeben & "." am Ende */
          ausgabePrimFaktoren (os, wert);
        } else if (wert == 1)          // wegen Benchmark auch hier Abbruch
        {
          meldeInfo (os, 0, "Abbruch des Programms wurde gewuenscht! - Benchmark?");
          return 0;                    // Programmabbruch mit OK-Code gewuenscht
        } // = 0 wird nicht behandelt, da verwandleStringInULL Fehler meldet
        // * String muss mit Zahl beginnen, kein '-' oder gar Buchstabe:
        inputStr = loescheFuehrendeNichtZahlen (os, inputStr);
      }
    }
  if (wert == 0)                       // wenn nicht ueber return: continue
    wert = 5;                          // uninteressanter wird - unbeachtet
  return wert;                         // Weitergabe der Zahl ...
} // Ende: unsigned long long eingabeCLPZahlZumFaktorisieren (std::ostream& os,
//   \       int argc, const char* argv[], bool frstParamUsed)

// Diese Funktion liest bei Bedarf einen Sting, der in eine oder mehrere
// Zahlen ueberfuehrt wird, die in einer Schleife abgearbeitet werden:
// sie sollen in Primfaktoren zerlegt und so ausgegeben werden.
unsigned long long eingabeKBDZahlZumFaktorisieren (std::ostream& os)
{
  unsigned long long wert = 0;         // < 1 ist falsch - d.h. wiederholen,
                                       // 1 ist Fehlercode zum Programmabbruch,
                                       // > 1 ist gesuchter Wert!
  while (wert < 1)                     // Bis wert mindestens 1 ist einlesen
  {
    inputStr = "";
    // * Eingabe-Aufforderung:
    meldeInfo (os, 0, "Spezial:  'H': Hilfe \U0001F198-'B'-'V': Versionsinfo \U0001F6C8 , '1'/'Q': Abbruch \u274C.");
    meldeInfo (os, 0, "Gib ansonsten eine ganze Zahl \u2115 in [2;18446744073709551615]\u2705 ein:");
    if (farbLos)
    {
      os << " * ";
    } else
    {
      os << LYELLOW_BROWN << " * " << RESET;
    }
    os << "      \U0001F644          \U0001F635";
    os << "          \U0001F634         \U0001F612 ";
    // * Lese von Tastatur in String:
    std::getline(std::cin, inputStr);
    if (inputStr.length() == 1)
    {
      switch (inputStr[0])
      {
        case 'H': case 'h':
        { // * Hilfsinfo und Abbruch der Funktion mit '5' {= continue}
          ausgabeInfotext (os, 1);
          return 5;
        }
        case 'V': case 'v':
        { // * Versionsinfo und Abbruch der Funktion mit '5' {= continue}
          ausgabeInfotext (os, 0);
          return 5;
        }
        case 'B': case 'b':
        { // * Versionsinfo und Abbruch der Funktion mit '5' {= continue}
          ausgabeInfotext (os, 0);
          ausgabeInfotext (os, 1);
          return 5;
        }
        case '1': case 'Q': case 'q':
        { // * Programm-Abbruch: '1' - break kann (wie zuvor: '5') entfallen.
          return 0;
        } // ein Zweig: 'default : ...' als Joker ist nicht noetig.
      }
    }
    // * String muss mit Zahl beginnen, kein '-' oder gar Buchstabe:
    inputStr = loescheFuehrendeNichtZahlen (os, inputStr);
    while (!inputStr.empty())
    {
      wert = verwandleStringInULL (os);  // inputStr wird verwendet
// * Bedeutet: std::stoull (dummyString,&sz,0) & inputStr.substr(0,sz) kopiert.
      if (wert > 1)                    // OK, wert kann zerlegt werden
      {
        /* PFs ermitteln und in vector wertepfs speichern */
        suchePrimFaktoren (wert);
        /* PFs aus wertepfs lesen, mit "," getrennt ausgeben und "." am Ende */
        ausgabePrimFaktoren (os, wert);
      } else if (wert == 1)
      {
        meldeInfo (os, 0, "Abbruch des Programms wurde gewuenscht!");
        break;
      } // = 0 wird nicht behandelt, da verwandleStringInULL Fehler meldet
      // * String muss mit Zahl beginnen, kein '-' oder gar Buchstabe:
      inputStr = loescheFuehrendeNichtZahlen (os, inputStr);
    }
  }
  if (wert == 1)
  {
    wert = 0;
  }
  return wert;                         // Weitergabe der Zahl zur Faktorisierung
} // Ende: unsigned long long eingabeKBDZahlZumFaktorisieren (std::ostream& os)

// * Die folgende Funktion enthaelt den Grossteil des ehemaligen Kerns
// * von main, der wegen Uebergabe von ostream nun besser als Funktion
// * aufgerufen werden kann.
// * Es wird die Hauptfunktion als CLP = Parameter-Abfrage und als Schleife
// * KBD als interaktive Tastaturabfrage behandelt und Return-Codes ermittelt.
int abfrageSchleifePFBestimmungAusgabe (std::ostream& os, const int argc,
  const char* argv[], bool frstParamUsed)
{
  /* Zahl aus Kommandozeilen-Parameter ermitteln,
     die im Anschluss in PFs aufgespalten werden soll */
  unsigned long long wert = eingabeCLPZahlZumFaktorisieren (os, argc, argv, frstParamUsed);
  // * Variablen-Deklaration von wert als Rueckgabewert der beiden
  // * Eingabefunktionen; in abfrageSchleifePFBestimmungAusgabe bedeutet:
  // *   '> 1': continue (Programm laeuft weiter - Tastatureingabe-Schleife),
  // *  '== 1': Abbruch mit Fehlercode 1 und
  // *  '== 0': Abbruch gewuenscht, d.h. mit Code 0 fuer alles OK!
  // CLP-Einlesen nun beendet ... noch die letzten Auswertungen von wert
  if (outputFilename == myOutputFilename)
  { // * Datei-Ausgabe hat keinen KBD-Teil
    if (wert > 1)                      // Keine Abbruchbedingung bislang,
      wert = 0;                        //   also regulaeres Ende
    meldeInfo (os, 0, "Hier noch zum Abschluss der Versions- und Hilfs-Text des Programms:");
    ausgabeInfotext (os, 0);           // Versions-Text ausgeben
    ausgabeInfotext (os, 1);           // Hilfs-Text ausgeben
    return wert;                       // Verabschiedung erfolgt im main-Zweig
  }
  if (wert == 0)                       // {(wert < 2): return (wert) ginge auch}
  { // * Abbruch nach CLP gewuenscht (kein KBD) - Benchmark
    return 0;                          // dann Abbruch mit Fehlercode 0
  } else if (wert == 1)
  {                                    // Wesentliches Problem
    return 1;                          // dann Abbruch mit Fehlercode 1
  }                                    // ausser 0 und 1 bedeutet alles continue
  do                                   // Schleife bzgl. Tastatureingabe ...
  {
    /* Zahl aus Tastatureingabe (KBD; von cin) ermitteln,
       die im Anschluss in PFs aufgespalten werden soll */
    wert = eingabeKBDZahlZumFaktorisieren (os);
    if (wert == 1)                   // Wesentliches Problem
      return 1;                      // dann Abbruch mit Fehlercode 1
    if (wert == 0)                   // Abbruch durch Eingabe 1 gewaehlt
      return 0;                      // -> Abbruch ohne Fehlercode (0 = OK)
// * Zur Erinnerung, main verabschiedet (ausser Dateiausgabe) und reicht
// *   am Ende den Return-Code an das Betriebssystem/xterm/Shell weiter ...
  } while (wert > 1);                // gleichbedeutend mit !(wert == 1),
                                     // und dies sollte oben abbrechen ...
  // *** HIER SOLLTE NICHTS LANDEN - EINFACH DURCHSCHAUEN ...
  meldeInfo (os, 1, "Hier sollte - am Ende von abfrageSchleifePFBestimmungAusgabe - nichts landen");
  return 1;                            // Uebergabewert (= Fehlercode) an main
} // Ende: int abfrageSchleifePFBestimmungAusgabe (ostream& os, const int argc,
//   \       const char* argv[], bool frstParamUsed)

// * Hauptfunktion - nimmt Parameter entgegen und ermittelt ggf. einen
// * Steuer-Parameter, aendert ggf. die globale Variable farbLos und setzt
// * ggf. die an CLP durchgereichte Variable frstParamUsed (beides passiert
// * nur hier), gibt dann viele Parameter wie genauer outputstream und
// * Parameter an die Steuerfunktion abfrageSchleifePFBestimmungAusgabe
// * weiter, die die eigentliche Programmfunktionalitaet ausloest und
// * die Return-Codes liefert.
// * Im wesentlichen kuemmert sich main um die Aenderung von ostream fuer
// * unterschiedliche Ausgaben: neben cout (7. Moeglichkeit, und mit
// * Farbaenderungen auch 2.+3. Moeglichkeit) und Datei (1. Moeglichkeit)
// * waere auch in einen String denkbar, was hier eher stoeren wuerde,
// * zu Testzwecken aber praktisch ist ...:
// *     ``std::ostringstream oss{};'', so dass dieser abgfragt werden kann:
// *     ``if (oss.str() == "...") { ... }''.
int main (int argc, const char* argv[])
{                                      // Hauptfunktion mit Aufruf-Parametern
  try                                  // Absichern gegenueber Exceptions ...
  {
    std::string prgname = argv[0];     // Aufrufname des Programms
    std::string frstParamStr = "";
    bool frstParamUsed = 0;            // neue bool an CLP: 1. Param. continue
    int retStat = 0;                   // Fehlercode an OS/xterm/shell
    // nach Parameter fragen bzgl. output - bool fileOut setzen!
    if (argc > 1)                      // mindestens ein Parameter gegeben ...
      frstParamStr = argv[1];          // String hat 1. Parameter oder ist leer
    if ((frstParamStr == "-f") || (frstParamStr == "--file"))
    { // * 1. Moeglichkeit: Ausgabe in Datei
      frstParamUsed = 1;               // 1. Parameter wurde verwendet
      /* Begruessung */                // Erst auf den Bildschirm ..
      begruessung (std::cout, 1, prgname); // .. Begruessung
      myOutputFilename = std::string("PrimZahlZerlegung_")+
                         getDatStr(std::cout)+std::string("_JMB.txt");
      outputFilename = myOutputFilename;
      meldeInfo (std::cout, 0, "Die wirkliche Ausgabe erfolgt nun ueber die Datei:");
      meldeInfo (std::cout, 0, std::string(" * '")+outputFilename+std::string("'!"));
      farbLos = true;                  // keine ANSI-Farben
      std::ofstream datei {outputFilename};
      // Datei outputFilename -^ wird neu erzeugt oder bei Existenz
      // ueberschrieben (daher ggf. sinnvoller mit Zeitstempel im Namen);
      // dass Oeffnen und Schliessen ueberlaesst man sicherheitshalber
      // den Mechanismen von ofstream (Konstruktor und Destruktor) - AWG!
      /* Begruessung */                // .. nun auch in die Datei
      begruessung (datei, 1, prgname);
      meldeInfo (datei, 0, std::string("Diese Ausgabe-Datei heisst: '")+outputFilename+std::string("'!"));
      /* Hauptteil */
      retStat = abfrageSchleifePFBestimmungAusgabe (datei, argc, argv, frstParamUsed);
      if (anzFaktorZerlegungen == 1)
      { // Info, wenn Primfaktoren ueberhaupt berechnet werden sollten
        meldeInfo (datei, 1, "Es konnte keine sinnvolle Eingabe gefunden werden");
      }
      /* Verabschiedung */             // erst in die Datei ..
      begruessung (datei, 0, prgname); // Verabschiedung
      farbLos = false;                 // nun wieder mit ANSI-Farben
      if (anzFaktorZerlegungen == 1)
      { // Info, wenn Primfaktoren ueberhaupt berechnet werden sollten
        meldeInfo (std::cout, 1, "Es konnte keine sinnvolle Eingabe gefunden werden");
      }
      /* Verabschiedung */             // nun auch auf den Bildschirm ..
      begruessung (std::cout, 0, prgname); // Verabschiedung
    } else if ((frstParamStr == "-m") || (frstParamStr == "--mono"))
    { // * 2. Moeglichkeit: monochromatische Darstellung - Default von xterm
      frstParamUsed = 1;               // 1. Parameter wurde verwendet
      farbLos = true;                  // keine ANSI-Farben
      /* Begruessung */                // Auf den Bildschirm ..
      begruessung (std::cout, 1, prgname); // Begruessung monochrom
      meldeInfo (std::cout, 0, "Die wirkliche Ausgabe erfolgt nun monochromatisch:");
      /* Hauptteil */
      retStat = abfrageSchleifePFBestimmungAusgabe (std::cout, argc, argv, frstParamUsed);
      if (anzFaktorZerlegungen == 1)
      { // Info, wenn Primfaktoren ueberhaupt berechnet werden sollten
        meldeInfo (std::cout, 1, "Es konnte keine sinnvolle Eingabe gefunden werden");
      }
      /* Verabschiedung */             // Auf den Bildschirm ..
      begruessung (std::cout, 0, prgname); // Abschied monochrom
    } else if ((frstParamStr == "-i") || (frstParamStr == "--inverse"))
    { // * 3. Moeglichkeit: inverse Darstellung (gelb auf schwarz - Tur.Pascal3)
      frstParamUsed = 1;               // 1. Parameter wurde verwendet
      farbLos = true;                  // keine ANSI-Farben
      std::cout  << LYELLOW_BLACK << "\n";
      /* Begruessung */                // Auf den Bildschirm ..
      begruessung (std::cout, 1, prgname); // Begruessung invers
      meldeInfo (std::cout, 0, "Die wirkliche Ausgabe erfolgt nun invers:");
      /* Hauptteil */
      retStat = abfrageSchleifePFBestimmungAusgabe (std::cout, argc, argv, frstParamUsed);
      if (anzFaktorZerlegungen == 1)
      { // Info, wenn Primfaktoren ueberhaupt berechnet werden sollten
        meldeInfo (std::cout, 1, "Es konnte keine sinnvolle Eingabe gefunden werden");
      }
      /* Verabschiedung */             // Auf den Bildschirm ..
      begruessung (std::cout, 0, prgname); // Abschied invers
      std::cout  << RESET << std::endl;
    } else if ((frstParamStr == "-h") || (frstParamStr == "--help"))
    { // * 4. Moeglichkeit: Hilfstext
      frstParamUsed = 1;               // 1. Parameter wurde verwendet
      std::cout << CLRSCR;             // Bildschirm loeschen
      /* Begruessung */                // Auf den Bildschirm ..
      begruessung (std::cout, 1, prgname); // Begruessung zur Hilfe
      /* Hilfstext-Ausgabe */
      ausgabeInfotext (std::cout, 1);  // Hilfs-Text ausgeben
      meldeInfo (std::cout, 0, "Ende Hilfs-Text.");
      /* Verabschiedung */             // Auf den Bildschirm ..
      begruessung (std::cout, 0, prgname); // Abschied von Hilfe
    } else if ((frstParamStr == "-v") || (frstParamStr == "--version"))
    { // * 5. Moeglichkeit: Versionsinfo
      frstParamUsed = 1;               // 1. Parameter wurde verwendet
      std::cout << CLRSCR;             // Bildschirm loeschen
      /* Begruessung */                // Auf den Bildschirm ..
      begruessung (std::cout, 1, prgname); // Begruessung zum Versionstext
      /* Versions-Ausgabe */
      ausgabeInfotext (std::cout, 0);  // Versions-Text ausgeben
      meldeInfo (std::cout, 0, "Ende Versions-Text.");
      /* Verabschiedung */             // Auf den Bildschirm ..
      begruessung (std::cout, 0, prgname); // Abschied vom Versionstext
    } else if ((frstParamStr == "-b") || (frstParamStr == "-vh") || (frstParamStr == "-hv"))
    { // * 6. Moeglichkeit: Versions- und Hilfs-Text
      frstParamUsed = 1;               // 1. Parameter wurde verwendet
      std::cout << CLRSCR;             // Bildschirm loeschen
      /* Begruessung */                // Auf den Bildschirm ..
      begruessung (std::cout, 1, prgname); // Begruessung zur vollen Info
      /* Versions-Ausgabe */
      ausgabeInfotext (std::cout, 0);  // Versions-Text ausgeben
      /* Hilfstext-Ausgabe */
      ausgabeInfotext (std::cout, 1);  // Hilfs-Text ausgeben
      meldeInfo (std::cout, 0, "Ende Versions- und Hilfs-Text.");
      /* Verabschiedung */             // Auf den Bildschirm ..
      begruessung (std::cout, 0, prgname); // Abschied von vollen Info
    } else
    { // * 7. Moeglichkeit: Bildschirm - Standard {= Default}, ohne Spezial-Par.
      farbLos = false;                 // Abschluss auf cout mit ANSI-Farben
      /* Begruessung */                // Auf den Bildschirm ..
      begruessung (std::cout, 1, prgname); // Begruessung zum Standardprogramm
      meldeInfo (std::cout, 0, "Die gesamte Ausgabe erfolgt auf dem Bildschirm ...");
      /* Hauptteil */
      retStat = abfrageSchleifePFBestimmungAusgabe (std::cout, argc, argv, frstParamUsed);
      if (anzFaktorZerlegungen == 1)
      { // Info, wenn Primfaktoren ueberhaupt berechnet werden sollten
        meldeInfo (std::cout, 1, "Es konnte keine sinnvolle Eingabe gefunden werden");
      }
      /* Verabschiedung */             // Auf den Bildschirm ..
      begruessung (std::cout, 0, prgname); // Abschied vom Standardprogramm
    }
    return retStat;                    // Programm-Ende mit Fehlercode-Rueckgabe
  } catch (...)                        // Ende des try-Blocks zur Ausnahme-Beh.
  {                                    // Behandlung der Ausnahmebedingung ...
    meldeInfo (std::cout, 1, "Das Programm fand eine seltsame Ausnahmebedingung in main");
    if (anzFaktorZerlegungen == 1)
      meldeInfo (std::cout, 1, "Es konnte keine sinnvolle Eingabe gefunden werden");
    return 1;
  }
  meldeInfo (std::cout, 1, "Das Programm sollte nicht an diese Stelle gelangen");
} // Ende: int main (int argc, const char* argv[])
/******************************************************************************
 * Das war's - ein erstes Hobby - C++ - Programm - nicht zu trivial ...  :))  *
 ******************************************************************************
 */

Erläuterung zum Quelltext

•  Kommentare:  Alles von // bis zum Zeilenende wird vom Compiler ignoriert (z.B. Zeilen 39‑42 oder 43), ebenso alles zwischen /* und */ (z.B. Zeilen 1‑14 oder Zeile 93; vgl. Kommentar‑Arten unten). Hier sollen Kommentare verwendet werden, die den Quelltext auch nach Monaten bis Jahren schnell verständlich machen sollen.
  Man sollte sich merken, dass bei C und C++ als Kommentar immer der Slash / mit einem weiteren Zeichen (genauer // bzw. /* ... */) kombiniert wird – bei Shell-Skripten bzw. Makefiles ist es das Doppelkreuz (oder hash) #, bei 📜L^AT_EX das Prozentzeichen %, bei 🌐HTML <!-- ... --> (vgl. Kommentarbeispiele aus Wikipedia).
•  Hauptteil:  Jedes C++/C‑Programm enthält genau eine main-Funktion (im obigen Beispiel Zeile 635; hier in der komplizierten Fassung unter Heranziehen von mit dem Aufruf mitgegebenen Parametern). Diese Funktion entspricht dem aufgerufenen Programm – alles weitere muss von dort aufgerufen werden, wie im Beispiel die Funktion begruessung (in Zeile 650+663+672+679+685+694+701+710+717+722+728+733+739+746+751+760, die Funktion selbst ist in Zeilen 58‑87 zu finden) oder auch der überweigende Bestandteil von main aus Phase 1: abfrageSchleifePFBestimmungAusgabe (in Zeilen 666+688+704+754, die Funktion selbst ist in Zeilen 569‑619 zu finden) und dem dortigen Aufruf deren beider Unterfunktionen zum Einlesen von Parametern eingabeCLPZahlZumFaktorisieren (in Zeile 579, die Funktion selbst ist in Zeilen 443‑488 zu finden) und von Tastatureingaben eingabeKBDZahlZumFaktorisieren (in Zeile 606, die Funktion selbst ist in Zeilen 490‑567 zu finden), da das neue main vorrangig die Betriebsart und damit auch die Datenausgabe an Bildschirm oder in eine Datei steuert (in einen String wäre zu Testzwecken auch ostringstream denkbar (wie im Kommentar in Zeilen 628‑634 angedeutet) – hier machte dies wenig Sinn).
  Will man Aufrufparameter ignorieren, reicht ein einfaches: int main () // Hauptfunktion ohne Aufruf-Parameter Die Hauptfunktion main sollte mit return 0 abgebrochen werden, was das sofortige Programmende bedeutet mit Übergabewert 0 für alles OK, jede andere Zahl (aus Kompatibilitätsgründen besser nur bis 127, zumeist aber 1, bedeutet einen Fehler{code}, den man in der Shell [unter Linux meist die Bash, zu überprüfen über echo $SHELL mit typischer Ausgabe: /bin/bash] aufrufen kann: ./example; echo "Fehlercode: "$?).
•  Präprozessor:  Alle Zeilen, die mit Doppelkreuz # beginnen, werden vom Präprozessor ausgeführt, noch bevor der Compiler seine Arbeit aufnimmt. #include weist diesen an, die anzugebende Standard-Bibliothek (im obigen Beispiel Zeilen 14‑25; hier mit im Kommentar angegebenem Verwendungszweck; diese Dateien sollten sich im Suchpfad des Compilers befinden) oder auch eine weitere Quelltextdatei im aktuellen Verzeichnis (#include "meinModul.hpp"; also doppelte Anführungszeichen statt spitze Klammern) einzubinden. In C++20 werden Möglichkeiten eingeführt, auch hier den Präprozessor obslet zu machen.
  Speziell zur Einbindung von C‑Bibliotheken eine Bemerkung (hier Zeilen 24+25): Statt der C‑Libs <time.h> und <math.h> sollten die C++‑Pendants <ctime> und <cmath> verwendet werden. Hintergrund ist, dass für jede C‑Standard‑Bibliothek xxx.h es eine entsprechende C++‑Bibliothek cxxx gibt, die lediglich den Namespace auf std setzt und ansonsten die alte Fassung verwendet – d.h. verwendet man xxx.h, so wäre alles global verfügbar, was vermieden werden soll (vgl. C++ Standard Library headers).
  Der Präprozessor kann auch  bestimmte Konstanten definieren (Textersetzung; in Phase 2 wurde dies bewusst durch konstante Strings ersetzt, in Phase 1 waren es Zeilen 32‑36 für ASCII-Steuercodes zur Farbwahl).
•  Struktur:  Je nach Projekt kann der Programmierstil deutlich variieren. Man sollte sich einen aussuchen und bei eigenen Projekten durchhalten, so dass man intuitiv Fehler finden kann. Bei existierendem Code sollte man sich anpassen – oder alles umschreiben. Bei einem Team sollte man sich möglichst auf den Code-Stil einigen (siehe auch C++‑Code‑Standards von Standard C++ Foundation, Google, GitHub, geosoft, KDE-Framework|-Libs|Qt, Bjarne Stroustrup's C++ Style and Technique FAQ;   und C-Code-Standards von GNU und Linux).
  Hier habe ich (fast) alles auf Deutsch kommentiert, natürlich ist bei internationalen Projekten Englisch angesagt.
  a) Zusammengehörigkeit: Man sieht, dass {...} bestimmte Blöcke zusammen gehören (z.B. Zeilen 62+73, 64+67, oder 68+72), ebenso dass ...; eine Anweisung mit Ende bezeichnet (z.B. Zeilen 66, 159 oder 173; diese Anweisungen werden immer nacheinander abgearbeitet – bei Ausdrücken erlebt man Überraschungen: hier kann der Compiler optimieren) oder dass (...) Ausdrücke beinhalten, die z.B. wahr oder falsch sein können (Typ bool mit Literalen true {=1; ggf. auch eine größere Zahl} und false {=0}, z.B. Zeilen 63, 168 dreifach, 381 dreifach oder 680 dreifach).
  Nach if muss kein Leerzeichen / Blank folgen, { kann direkt nach der Verzweigungs- oder Schleifenanweisung kommen. Dass hier zugehörige geschweifte Klammern die selbe Einrückung haben (also untereinander stehen) oder niedere Blöcke genau zwei Leerzeichen mehr eingerückt sind, ist meine Präferenz, auch dass ich nie Tabulatoren gebrauche (die leider im Makefile Pflicht sind). Gebrächlich sind 2 oder 4 (ganz selten, z.B. dem Linux-Kernel, auch 8) Blanks oder ein Tab als Einrücktiefe.
  b) Kommentar-Arten: Vermeidung von Kommentaren der Art /* ... */ hat den Vorteil, dass man dann mit diesem Stil große Bereiche auskommentieren kann (vgl. Kommentarabschnitt oben).
  c) Namenskonventionen: Bei Variablen klein beginnen und dann CamelCase: anzahlErfolgterAufrufe (bzw. bei Klassenvariablen mit Underscore _ abschließen: anzahlErfolgterAufrufe_), bei Funktionen wie Variable oder auch snake_case: wer_findet_funktion() [mit Phase 2 habe ich mich entschlossen, wer_findet_funktion () zu verwenden, also Funktionbezeichner und Argumenklammern mit einem Leerzeichen abzutrennen – dies ist allerdings sehr unüblich, mich hat es anders gestört], einfache Typen klein mit Unterstrich und Endung: adress_typ, Klassen groß beginnen mit CamelCase, Konstanten, Enum-Elemente und Makros groß mit Unterstrich: SMILEY_FROWNING.
•  Algorithmus:  Als Mathe-Lehrer, der den Schülern ab der Klassenstufe 6 beibringt, eine Bruchaufgabe sei nur bei vollständig gekürztem Bruch auch vollständig gelöst und somit die volle Punktzahl wert, ist ein Programm zur Ausgabe der Primfaktoren (PFs) natürlich naheliegend. 😉  Was passiert aber mathematisch in der Funktion primeFactors:
  Schritt 1 (Zeilen 219‑225): Die eigentlich zu zerlegende Zahl n (hier als Aufruf-Parameter übergeben, Zeile 462, oder im laufenden Programm eingegeben, Zeile 514) wird zuerst durch 2 geteilt (halbiert), bis dies nicht mehr restfrei geht (d.h. die verbleibende Zahl ist ungerade und ist das neue n, wenn das ursprüngliche n gerade war). Die Variable n ist immer der Quotient, in dem noch nicht getestete Faktoren stecken können. Bei jedem gefundenen PF gibt es einen neuen Wert für n, der sich durch Teilen mit dem gefundenen PF ergibt (dies gilt auch für den folgenden Schritt 2).
  Schritt 2 (Zeilen 226‑237): Nun wird nacheinander die zuvor erhaltene ungeraden Zahl n durch Zahlen i von 3 bis zu sqrt(n) [d.h. square root (n) = Wurzel (n) = √n] jeweils so oft wie restfrei möglich geteilt (analog Schritt 1), wobei nur ungerade i getestet werden. Hierzu sind ein paar Bemerkungen zum besseren Verständnis nötig:
  1. Da bereits der Primfaktor 2 in Schritt 1 bearbeitet wurde, muss hier mit i = 3 begonnen werden.
     
  2. Es müssen nur ungerade Zahlen getestet werden (dies wird in Zeile 229 durch i=i+2 erreicht), denn außer 2 sind alle anderen geraden Zahlen nicht prim. Zudem wurde durch Schritt 1 eine ungerade Zahl n erzwungen, so dass die geraden Zahlen keine Divisoren i für Teilen ohne Rest darstellen.
     
  3. Da der Laufindex inkrementiert wird, d.h. sich von klein zu groß wandelt, werden Nicht-Primzahlen keine Teiler i sein können, da diese Faktoren besitzen, um die n bereits beraubt wurde.
     
  4. Hier darf n als am Ende von Schritt 1 eingefroren betrachtet werden: Wurzel n wäre die größte Zahl, die zweimal als Faktor in n stecken kann. Eine Zahl größer Wurzel (n) kann damit nur einmal in n stecken. Diese als einzige von Schritt 2 nicht behandelte Möglichkeit behandelt Schritt 3.
  Wenn sich durch diese for-Schleife am Ende n = 1 ergibt (n = 2 ist nicht möglich wegen Schitt 1, daher ist (n > 2) in Zeile 241 in Ordnung), dann ist die Primfaktorzerlegung bereits geschafft.
  Ansonsten kommt nun Schritt 3 (Zeilen 238‑244): Wie in Punkten 3. und 4. von Schritt 2 ausgeführt, kann n, wenn es nicht 1 ist, nur eine Primzahl sein, die größer als √n ist. Es gilt also nur noch, diese Primzahl n der Liste hinzuzufügen. Fertig! 😎 
  Man ersieht hier, dass man mit brute force, d.h. durch gewaltsames Teilen, sinnvoll und schnell zum Ziel kommt, lediglich die beschriebenen Stellen sind logisch zu bedenken. Der Computer berechnet viele Operationen schnell und fehlerfrei, Menschen gehen daher anders vor – dies ist beim Programmieren im Auge zu behalten. Speziell auch, wann sich eine Optimierung durch einen geschickteren Algorithmus lohnt und wann es direkt geht.
•  Mini-Benchmark:  Um den letzten Gedanken am Ende des Algorithmusabschnitts weiterzuführen, kann ein Benchmark Klarheit über Schwächen geben und sinnvolle Änderungen am Code auslösen – oder auch die entsprechende verwendete Hardware testen. Speziell nach Erweiterung von 31 Bit für natürliche Zahlen (ℕ) mit int auf 64 Bit unsigned long long, liegt ein solcher Test nahe, da bei der größtmöglichen Primzahl 18 446 744 073 709 551 557 (über 18 Trillionen!) sehr viele Berechnungen erfolgen und somit die Zeitangabe auch sinnvoll zu erfassen ist.
  Bei Aufruf von time ./example 18446744073709551557 1 bzw. time make r 18446744073709551557 1 ergaben sich folgende Werte auf den angegebenen Systemen:
  

  System:   [🔧PC‑Tech‑Info]	Intel Core 2 Duo T6400@ 2,0 GHz ❹ Penryn bogomips: 3989,82	Pentium Dual-Core T4300@ 2,1 GHz Penryn bogomips: 4189,40	Intel Core i7-2600K@ 3,4 GHz ❸ Sandy Bridge bogomips: 6799,86	Intel Core i7-4770T@ 2,5 GHz ❷ Haswell bogomips: 4988,40	Intel Core i7-6700@ 3,4 GHz Skylake bogomips: 6816,00	AMD Ryzen 5 3600@ 3,6-4,2 GHz ❶ Zen2 & RDNA 1.0 bogomips: 7186,43
  real:	35,339 s	33,724 s	25,132 s	23,829 s	17,259 s	16,046 s
  user:	35,288 s	33,620 s	25,107 s	23,825 s	17,255 s	16,024 s
  sys:	0,004 s	0,008 s	0,009 s	0,005 s	0,004 s	0,000 s

  Die System‑Angaben entstammen dem Befehl: cat /proc/cpuinfo bis auf den Codenamen (der bei meinen Systemen fettgedruckt erscheint; Backup‑ oder deutlich veraltete Systeme erscheinen kursiv).
  Für die größtmögliche ULL‑Zahl 18 446 744 073 709 551 615 (58 mehr als die Primzahl zuvor) braucht mein Haswell‑System statt 23,829 s lediglich 0,015 s und zerlegt dabei in sieben Primfaktoren: 3, 5, 17, 257, 641, 65537 und 6700417. Der Code ist für Einzelzahlen also schnell genug und der Mini-Benchmark ein nettes Abfallprodukt.
•  Lizenz und Urheberrecht:  Wenn man privat Code schreibt, besitzt man das Copyright und sollte dies auch anmerken. Dies gibt das Recht, den Code zu verkaufen, aber natürlich ebenso, diesen im Form von Freier Software der Allgemeinheit zu überlassen (Copyleft), so dass niemand diesen Code missbrauchen kann, sondern nur abändern und ebenfalls im Quellcode der Allgemeinheit zur Verfügung stellen muss. Dies macht die GNU General Public License: GPL, deren jüngste und mächtigste Variante zur Befreiung der Anwender die GPLv3 ist. Der von mir nur gelinkte Text wird normalerweise dem Software-Quelltext als Datei beigelegt. Hier bedeutet mein Copyright nur, dass ich es geschrieben habe und die Nutzung freigebe – die Basis-Struktur kam aus einem Beispiel meiner 1. Literaturangabe (S. 63, Listing 4.2), der Algorithmus ist wohl bekannt und im Netz vielfach leicht zu finden, ebenso die ANSI-Farbsequenzen, die ich schon Ende der 1980-er in Tubo Pascal verwendete. In Phase 2 kamen dann weitere Ideen aus der 1. Literaturangabe (Listing 10.6 [Exception: try/catch-Blöcke; oben Zeilen 637-763-769], S. 233; Listing 12.6 [variable Ausgabe via ostream], S. 261) hinzu, ebenso eine Literaturrecherche bzgl. ULL, Standardstring-Umgang und weiteren Themen, wobei auch viel Code verworfen bzw. umgeändert werden musste. Somit ist vorrangig die spezielle Gesamtgestaltung mein Werk. Nichts hier ist also ein Copyright (Urheberschaft macht bei sehr Einfachem wenig Sinn; wenn das mal die Patentämter [bzw. die verantwortliche Legislative] begreifen würden) oder eine Lizenz wert ... es soll nur als Beispiel dienen, wie man mit eigener Software umgehen sollte.
•  Feinheiten:  So, wie die Farbcodes im Teminal über ANSI-Escape-Sequenzen eine neue Farbe festlegen (Kommentar und Festlegung in Zeilen 27‑53, Anwendung z.B. in Zeilen 69+154+711+715), so gibt es auch in String-Angaben bzw. allgemein in C/C++ Escape-Sequenzen, z.B. um einen Zeilenumbruch: \n (new line; vgl. Zeile 120+255+292+699), ein Unicode-Zeichen über \Uhhhhhhhh zu bewirken (vgl. z.B. Zeile 77 dreimal+82+137+502+511) auch das doppelte Anführungszeichen: " zu maskieren, das ja als Beginn- bzw. Endemarke eines Strings dient und somit im String als \" dargestellt werden muss. Die Escape-Sequenzen beginnen immer mit einem Rückwärtsschrägstrich / Backslash: \\. Im Übrigen werden Escape-Sequenzen auch in Druckersprachen wie ESC/P (Epson) oder PCL (HP) verwendet, wenn keine Seitenbeschreibungssprachen wie PostScript verwendet wird.
  Eine Vereinfachung ist in Zeilen 60 (schmal)+177 (breit) zu finden, so dass der Namespace für die angegebene Funktionen oder gar alle Funktionen im Block nicht mit std:: ausgewiesen werden muss. Man kann also auch in einer Zeile für alle Funktionen der Standardbibliothek schreiben: using namespace std; // fuer std::cout und std::endl - aber auch bei anderen wirksam Diese allgemeine Änderung sollte aber eher vermieden werden, insbesondere wenn in main oder gar global umdefiniert, weil hier Mehrdeutigkeiten eingeführt werden könnten. Daher lieber nur für häufig aufgerufene Bibliotheks-Funktionen in einer Funktion oder in einer überschaubaren Funktion, in der kaum eigene Bezeichner vorkommen, umdefinieren wie im Listing gezeigt.
•  Kommt noch was?:  Nicht alles ist erklärt ... und wird es wohl auch nie (auch wenn ich auf Hinweise eingehe). Dafür sei die Literaturliste und eine Internetrecherche empfohlen. Nach der deutlichen Umarbeitung zur Phase 2 ist noch offen, was als Nächstes ansteht. Die Phase 1 (08.08.2019) dieses Programms habe ich auf einer Website eingefroren – inkl. der ehemaligen Phase 1-Download-Datei. Ideen hätte ich genug ... auch für ganz andere Programme ... oder einen Programmierkurs für Heranwachsende, der sich an einen 📢Vortrag anschließen könnte (diese Idee hat bereits vieles von Phase 2 geleitet).

Ergänzungen 

$ ls -al example_debug example
-rwxrwxr-x 1 jmb jmb 60464 Sep  7 15:14 example_debug
-rwxrwxr-x 1 jmb jmb 56616 Sep  7 15:14 example
# d.h. 60464 = 59,05 kB / 56616 = 55.29 kB Größe
$ file example
example: ELF 64-bit LSB shared object, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, BuildID[sha1]=f59476f8f7efd2f9dc548143f262f53b1191c37e, for GNU/Linux 3.2.0, not stripped
$ strings example
# Ausgabe aller Zeichenketten (Strings) des Executables (viel: 649 Zeilen)
$ readelf -x .rodata example
# Anzeigen der statischen Strings
$ nm example
# Auflisten der Symbole
$ readelf -s example
# Anzeigen der Symbole
$ readelf -h example
# Ausgabe des ELF (Binärformat unter Linux) - Headers
$ readelf --relocs example
# Klären, ob das Binary ein positionsunabhängiges Executable ist bzgl. der Bibliotheken.
$ ldd example
# Liste dynamisch gelinkter Bibliotheken (hier sechs: linux-vdso.so.1, libstdc++.so.6, libm.so.6, libgcc_s.so.1, libc.so.6, /lib64/ld-linux-x86-64.so.2)
$ ldconfig -p | grep NAME_BIBLIOTHEK
# Nachschauen, ob eine bestimmte Bibliothek auf dem System installiert ist, z.B. bei `ldconfig -p | grep libm.so.6' u.a. `... => /lib/x86_64-linux-gnu/libc.so.6'.
$ /lib/x86_64-linux-gnu/libc.so.6
# liefert am Anfang: 'GNU C Library (Ubuntu GLIBC 2.29-0ubuntu2) stable release version 2.29.' auf Xubuntu 19.04.
$ objdump -d example
# Disassemblieren des Binary bzw. des Object Files (*.o)
$ strace ./example
# Lässt das Programm ablaufen und berichtet, was es dabei tut.

Weiterführende Literatur & Online Quellen

• C++‑Programmierung allgemein: ...
•  ... Buch‑Form:
  • C++ – Das umfassende Handbuch (aktuell zu C++17) [Errata & Listings], Torsten T. Will, Rheinwerk Computing, 2019 (1. korrigierter Nachdruck der 1. Aufl. 2018), 1067 S. [erstes Viertel gelesen ... Anfang meines Programmierens mit hier vorgestelltem Faktorisierungs‑Programm]
  • C++ – kurz & gut (aktuell zu C++17), 2018 (3. Aufl.), 228 S. [Vorsicht: keine Einführung, dafür aktuelle Übersicht]
  •  Die C++ Programmiersprache (Deutsche Ausgabe der Special Edition), Bjarne Stroustrup, Addison-Wesley Verlag, 2000 (4. aktualisierte Auflage), 1068 S. [in 2000 oder direkt danach gekaufte Originalausgabe; damals bis zur Hälfte gelesen]
  •  A Tour of C++ (C++ In Depth SERIES), Bjarne Stroustrup, 2018, 239 S., Addison Wesley, 2nd Edition, ISBN 978-0134997834   [beim Einlesen]
  •  Clean Code: A Handbook of Agile Software Craftsmanship, Robert C. Martin, 2008, 464 S., Prentice Hall, ISBN 978-0132350884   [noch nicht gelesen]
•  ... Online‑Quellen:
  • C++ Referenz (Online: auf Englisch aktuell bis C++20; Google-deutsch Fassung veraltet – bis C++11)
  • Open Standards
  • GCC Online Documentation (mit unterschiedlichen Versionen, als Online-Manual, PDS- oder PS-Datei oder HTML-tar-Datei) [vgl. GCC Kapitel]
  • The GNU C++ Library: libstdc++
  • Boost (zusätzliche C++-Bibliothek): Dokumentation, Getting Started with Boost 1.70 on Unix Variants
  • GNU C library: libc (Download)
  • ncurses (C++-Demo)
  • Stack Overflow: C++
  • Heise‑Beiträge zu C/C++ bzw. deren Artikel zu Core Guidelines C++
• Spiele‑Programmierung mit C++: ...
•  ... Buch‑Form:
  •  Beginning C++ Through Game Programming, Michael Dawson, 2014, 390 S., CENGAGE LEARNING, 4th Edition, ISBN 978-1305109919   [beim Einlesen]
  •  SFML Game Development (English Edition), Jan Haller, Henrik Vogelius Hansson, Artur Moreira, 2013, 296 S., Packt Publishing, ISBN 978-1849696845   [noch nicht gelesen]
  •  SFML Game Development By Example (English Edition), Raimondas Pupius, 2015, 522 S., Packt Publishing, ISBN 978-1785287343   [noch nicht gelesen]
  • C++ Game Development By Example, Siddharth Shekar, 2019, Packt, 408 S. [noch nicht gelesen]
•  ... Online‑Quellen:
  • SFML (multimedia library in C++; aktuell ist Version 2.5.1 vom 18.10.2018)
    • Development / Contribution Guidelines / Code Style Guide / Tutorial: SFML and Linux
    • Bislang erfüllt SFML C++03, ab SFML 3 soll C++17 anvisiert werden (vgl. Merkmale von Modern C++)
    • Weitere anvisierte Änderungen: Vulkan sowie besserer Gamepad‑Support
  • SDL (game library in C; begonnen durch Loki in 1998; aktuell ist Version 2.0.14 vom 21.12.2020, siehe auch 2.0.12 vom 11.03.2020)

Eigene Erfahrungen und Motivation

© 1987-2021