"hello world" demos & templates for various languages, incl. gcc build commands for C & C++
See also my eRCaGuy_hello_world_data project.
By Gabriel Staples
www.ElectricRCAircraftGuy.com
- My eRCaGuy_dotfiles repo.
(click to expand)
- Many solid C & C++ demos are done and work!
- A Python demo also is in place to show how to parse a YAML file.
See the tree output below to see the file/folder structure.
Note that these are NOT just your standard "simple" hello world demos for absolute beginners. Rather, they are simple enough for beginners but also contain some advanced techniques and tips & tricks to act as good reminders or teaching for more expert programmers too. I, myself, regularly reference my own examples here to remind myself of some of these details which are easy to forget. There's no sense stressing about trying to remember everything. Instead of trying to remember everything, just remember where to look (here in this case).
- How to generate intermediate build files, including .ii, .s, and .o.
- How to make a single file compile in both C and C++ by using the
#ifdef __cplusplusextern "C" {brace trick- See "c/hello_world.c"
- Note: there is also such a thing as
extern "C++". Search the GNU gcc documentation here for that search string: https://gcc.gnu.org/onlinedocs/gcc.pdf. Ex: the top of p489, under the paragraph titled "Language-linkage module attachment", mentions(extern "C" or extern "C++").
- How to use a forward declaration of
printfrather than includingstdio.hto make it link - How to do cross-platform sleep in Windows or Linux
- A reminder to use
-Wall -Werrorfor better code safety and quality - How to use
g3for full debugging info - How to specify the C or C++ version you are compiling for, such as
c90,c99, orc11(C 2011), orc++98,c++03(C++ 2003), orc++11(C++ 2011) - How to pass entire functions or curly-brace-scoped
{ }code blocks, as though they were a single parameter, into a macro to be evaluated - How to do integer rounding UP, DOWN, and to NEAREST whole integer during division using 3 different techniques: 1) macros, 2) gcc/clang statement expressions, and 3) C++ function templates. This also is a great unit test example using simple hand-written unit tests.
- See "c/rounding_integer_division/" directory
- If you'd like to see how to use googletest (gtest) and googlemock (gmock) instead of writing custom unit tests, see my other project here instead: https://github.com/ElectricRCAircraftGuy/eRCaGuy_gtest_practice. It also acts as a good demo of how to get up and running quickly with Google's Bazel build system.
- Witness that the C++
std::unordered_map<T_key, T_value>unordered map (hash table) class automatically implicitly creates a new key/value pair each time you attempt to read OR write to a value (or any members of a complex value, such as astructorclass) which belongs to a non-existing key! In other words, reading or writing any key/value which does NOT yet exists causesstd::unordered_map<>to automatically, dynamically, generate it right on the spot for you to access it! This is confusing behavior at first, as it happens implicitly behind the scenes, so it needs to be understood. Once understood, it is a powerful feature to use, but a one or two-line comment to exlain that you intend dynamic allocation to happen, above any lines in production code where you use this, would be wise. - Case-insensitive
strncmp()function, with unit tests.- See "c/strncmpci.c"
- Example of how to manually write unit tests.
- See "c/strncmpci.c"
- Note: for Google Test (gtest/gmock) examples, including how to use the Bazel build system, see my repo here instead: https://github.com/ElectricRCAircraftGuy/eRCaGuy_gtest_practice.
- Example of how to use ANSI color codes (ex: red and green) in terminal output.
- It is possible to colorize and stylize/format your text you print to
stdoutorstderr, in any programming language, by surrounding the text with special ANSI color codes. This works for all programming languages and all forms of printing tostdoutorstderr, whether viaprintf("some text\n");in C or C++,std::cout << "some text\n";in C++,print("some text")in Python,echo "some text"in bash, etc. - See these defines in C in "c/strncmpci.c":
...and how I used them to colorize text in
#define ANSI_COLOR_OFF "\033[m" #define ANSI_COLOR_GRN "\033[32m" #define ANSI_COLOR_RED "\033[31m"
printf()calls there. - See also my other repo here: https://github.com/ElectricRCAircraftGuy/eRCaGuy_dotfiles/blob/master/useful_scripts/git-diffn.sh#L126
- It is possible to colorize and stylize/format your text you print to
- How to use a
constreference to a vector, with a default parameter, as an input param to a function! - How to call command-line system calls in C and C++, read piped input from
stdin, and read command-line output from called process from itsstdout:- StackOverflow.com: how to read from stdout in C
- StackOverflow.com: C: Run a System Command and Get Output?
- StackOverflow.com: How can I run an external program from C and parse its output?
- StackOverflow.com: Capturing stdout from a system() command optimally
- [the most-thorough C++ answer I think] StackOverflow.com: How do I execute a command and get the output of the command within C++ using POSIX?
- Advanced bit-masks and bit-shifting.
- See "cpp/process_10_bit_video_data.cpp"
- See also the problem statement and my answer, with other references, on Stack Overflow here: Stack Overflow: Add bit padding (bit shifting?) to 10bit values stored in a byte array.
- Weak functions (functions with attribute
weak): prove to myself that weak functions which are declared but not defined really do have addresses equal to nil (ie: zero, or0), as this is how the ArduinoserialEvent()function works and is implemented.- See "cpp/check_addr_of_weak_undefined_funcs.cpp".
- See also my Stack Overflow answer here: Arduino “SerialEvent” example code doesn't work on my Arduino Nano. I can't receive serial data. Why?.
- gcc
weakfunction attribute: https://gcc.gnu.org/onlinedocs/gcc-3.2/gcc/Function-Attributes.htmlweak
The
weakattribute causes the declaration to be emitted as a weak symbol rather than a global. This is primarily useful in defining library functions which can be overridden in user code, though it can also be used with non-function declarations. Weak symbols are supported for ELF targets, and also for a.out targets when using the GNU assembler and linker.
- Empirically measure the max thread stack size permitted on your architecture, in C OR C++. See:
- Practice using
void *function arguments to pass in ANY data type, such as a regularuint32_t, to a function.void *is also the required input parameterargtype, passed bypthread_create()to thestart_routinefunction, so thatargcan be ANY type! This allows the Linuxpthread_create()function to be a generic function prototype which allows generic callback functions, to be called by the thread, and which shall receive generic input parameters. GOING FURTHER: The cool thing about this is that avoid *input parameter can literally be A POINTER TO ANY DATA TYPE, so it could even be to a struct containing more function pointers, or a struct containing a bunch of parameters, etc. In this way, a generic function prototype containing a singlevoid *input param can actually "wrap", or contain, a ton of input params. There are no limits to what you can pass with this--it's all up to your imagination and ingenuity and desires.- My example usage of this, passing a simple
uint32_ttype via avoid *input parameter: c/onlinegdb--empirically_determine_max_thread_stack_size_GS_version.c - See also my answer on Stack Overflow here: Stack Overflow: C/C++ maximum stack size of program
- My example usage of this, passing a simple
- Learn 3 techniques to read individual bytes out of variables of any type in gcc C and C++.
- You can use 1) unions and "type punning", 2) raw pointers, or 3) bit-masks and bit shifting!
- See "c/type_punning.c"
- See also my detailed answer and explanations here: Stack Overflow: Portability of using union for conversion - my answer: "Using Unions for "type punning" is fine in C, and fine in gcc's C++ as well (as a gcc [g++] extension). But, "type punning" via unions has hardware architecture endianness considerations.".
- (Multidimensional arrays) 2D array practice in C and C++.
- See c/2d_array_practice.c; it runs in both C and C++; see build commands in the comments at the top
- See my full answer on this on Stack Overflow here: How to pass a multidimensional array to a function in C and C++
- See c/2d_array_practice.c; it runs in both C and C++; see build commands in the comments at the top
- Asserts in C:
- c/assert_practice.c - practice using the
assert()andstatic_assert()macro wrappers in C11, as well as a customASSERT_TRUE()macro I wrote which also prints the filename, function name, and line number using built-in macros__FILE__and__LINE__, and the special built-in static C-string (char array) variable__func__.
- c/assert_practice.c - practice using the
- Pre-main() and post-main() function call injection:
- [VERY interesting and neat concept!] Dynamically inject function calls before and after another executable's
main()function.- AKA: program "constructors" and "destructors" in C.
- AKA: how to use gcc function attributes
constructoranddestructor, and C functionatexit().
- See c/dynamic_func_call_before_and_after_main.c.
- [VERY interesting and neat concept!] Dynamically inject function calls before and after another executable's
- Dynamic library (shared object
lib*.so) creation and use, including with the LinuxLD_PRELOADpreloader trick at call time. - How to use
std::initializer_list<>as an input arg to a function, likestd::max()does, so you can easily pass in a variable number of input arguments inside curly braces in order to perform operations on them. In this case, I concatenate any number of input argument strings with/chars between them in order to build a file path from multiple directory names and the filename at the end.- See cpp/make_path_to_file.cpp
- Sample usage:
// output: `"/dir1/dir2/dir3"` std::string file_path = make_path({"/dir1", "dir2", "dir3"});
- Sample usage:
- See cpp/make_path_to_file.cpp
-
Use
-Wwarning-nameto turn ON build warning "warning-name", and-Wno-warning-nameto turn OFF build warning "warning-name".-Wturns a warning ON, and-Wno-turns a warning OFF. Here's what gcc has to say about it (source: https://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html; emphasis added):You can request many specific warnings with options beginning with
-W, for example-Wimplicitto request warnings on implicit declarations. Each of these specific warning options also has a negative form beginning-Wno-to turn off warnings; for example,-Wno-implicit. This manual lists only one of the two forms, whichever is not the default. -
Instead of
-g3, use-ggdbto build debug information specifically for the GNU gdb debugger. If using the clang (LLVM) compiler instead of gcc, you may also use-glldbto build debug information specifically for the clang LLDB debugger. Note that if you use-glldb, it usually builds debug symbols and information which works just fine with gdb too, so you can generally use either debugger with the same built symbols in that case. -
Use
-Wall -Wextra -Werror(which is a good idea) to see all warnings and to convert all warnings to errors, to make you write better code. Some people may leave off-Wextra, and just use-Wall -Werror. Others may also like to add-Wpedanticto that list (now it's-Wall -Wextra -Wpedantic -Werror) to enforce ISO C and ISO C++ standards, but other people or code-bases will explicitly turn OFF pedantic with-Wno-pedanticto explicitly DISABLE pedantic (ISO standards) checks and ALLOW compiler extensions. Personally, I prefer to leave compiler extensions ENABLED (meaning: do NOT use-Wpedantic), as compiler extensions are very frequently used and very useful, especially in small, embedded, low-level and hardware-centric systems such as microcontrollers.- In other words, I recommend that you DO use
-Wall -Wextra -Werrorbut that you NOT use-Wpedantic, but if you'd like to use-Wpedanticas well, you may. See just below for additional details. - For details on which warning flags
-Walland-Wextraeach turn on, refer to the gcc user manual here (https://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html), and search the page for these warnings, or just scroll partway down. There's a nice list detailing what individual warning flags are under each (-Wall, and-Wextra).
- In other words, I recommend that you DO use
-
Add the
-Wpedanticor-pedantic(same thing) build flag to enforce strict ISO C or ISO C++ standards and "reject all programs that use forbidden extensions". Or, conversely, add-Wno-pedanticto ENABLE extensions and turn a previously-set-Wpedanticback OFF.-WpedanticNOT being on is the default. See gcc's user manual section on Warning Options, for example, as well as the bullet just above, for details: https://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html.- Some people want strict ISO C and C++ functionality only. They use
-Wpedantic. - Some libraries REQUIRE compiler extensions and explicitly have
-Wno-pedanticset for the library to enable compiler extensions and disable any previously-set-Wpedanticflags. Sometimes this is just for certain files which require exceptions to use certain compiler extensions. - Others rely on compiler extensions and do NOT use
-Wpedantic. I am in this latter category and prefer NOT to use-Wpedantic, so that I CAN use gcc (or clang) compiler extensions. They are good. They are safe. They are helpful. They just may not be quite as portable across compilers is all, though from gcc to clang and back again, you are usually ok to use them, since clang strives to be gcc-compatible by design (see http://clang.llvm.org/: clang strives to be gcc compatible: "End-User Features" they advertise include: "GCC compatibility"). - See also my notes about
-Wpedanticin the previous higher-level bullet just above this one.
- Some people want strict ISO C and C++ functionality only. They use
-
clang, but NOT gcc, also has a
-Weverythingoption which appears to include things such as-Wpedantic. You can test it here: https://godbolt.org/z/qcYKd1. Notice the-Wvla-extensionwarning we get since we are relying on a C99 extension in C++ in this case, and we have-Weverythingset. We get the same warning if we just use-Wpedantic, as shown here: https://godbolt.org/z/M9ahE4, indicating that-Weverythingdoes in fact include-Wpedantic. We get no warning if we have neither of those flags set: https://godbolt.org/z/j8sfsY.Despite-Weverythingexisting and working in clang, however, I can find no documentation whatsoever on its existence, neither in the clang man pages nor in the online manual here: https://clang.llvm.org/docs/DiagnosticsReference.html.- Note there is also a clang (at least) option for
-Wc99-extensionsto allow them, or-Wno-c99-extensionsto disallow them. Source: https://clang.llvm.org/docs/DiagnosticsReference.html#wc99-extensions. - UPDATE: the bottom of the main clang documentation index page: https://clang.llvm.org/docs/index.html, under the "Indices and tables" section at the very bottom, has a "Search Page" link. Using that link, here is my search for "-Weverything": https://clang.llvm.org/docs/search.html?q=-Weverything, which brings me to the official documentation here!: https://clang.llvm.org/docs/UsersManual.html?highlight=weverything#cmdoption-weverything. Done! There it is!
-
See my answer here: https://stackoverflow.com/questions/64147706/what-does-the-clang-compilers-weverything-option-include-and-where-is-it-doc/64147755#64147755. Clang does NOT recommend using
-Weverything! They say it's better to use just-Wall -Wextrainstead. See their quote here (emphasis added):Since
-Weverythingenables every diagnostic, we generally don’t recommend using it.-Wall -Wextraare a better choice for most projects. Using-Weverythingmeans that updating your compiler is more difficult because you’re exposed to experimental diagnostics which might be of lower quality than the default ones. If you do use-Weverythingthen we advise that you address all new compiler diagnostics as they get added to Clang, either by fixing everything they find or explicitly disabling that diagnostic with its correspondingWno-option.
-
- Note there is also a clang (at least) option for
- How to use the special Python
__slots__list inside a class to reduce RAM usage during run-time.- Also, learn about and use class variables vs. instance variables, private variables vs public variables, and internal Python variables surrounded by double underscores (
__some_var__). Also practice passing and using list args to a function (ex: as*args), and keyword key:value dict args to a function as well (ex: as**kwargs). - See "python/slots_practice/slots_practice.py".
- Also, learn about and use class variables vs. instance variables, private variables vs public variables, and internal Python variables surrounded by double underscores (
- How to create, parse, and print YAML files. How to find the directory path a called Python file is in.
- See "python/yaml_import/import_yaml_test.py" and other files in that directory.
- How to autogenerate C or C++ headers or code using Python.
- See "python/autogenerate_c_or_cpp_code.py" and the C or C++ header file it auto-generates: "python/autogenerated/myheader.h".
- File python/raw_bytes_practice.py contains:
- How to convert a list of integers to bytes.
- How to convert bytes back to a list of integers.
- Decoding a bytes buffer into a UTF-8 string.
- Decoding a bytes buffer into an ASCII string.
- Decoding a bytes buffer into a UTF-8 or ASCII string while replacing invalid chars with the 4 char string sequence
"\xhh"wherehhis the valid hex char sequence, as a string (via theerrors='backslashreplace'argument to the bytesdecode()method). - Converting a bytes buffer into a full hex string.
- Converting a full hex string back into a bytes buffer.
- Also demonstrated in this file:
textwrap.dedent()- New Python "f" format strings. See: https://realpython.com/python-f-strings/.
time.sleep()- Exception handling with
tryexceptelse.
- Image manipulation:
- How to essentially get the equivalent of GIMP's
Colors --> Auto --> White Balancefeature:- python/auto_white_balance_img.py
- See also my answer on Stack Overflow here for a demonstration and more details: How do I do the equivalent of Gimp's Colors, Auto, White Balance in Python-Fu?.
- How to essentially get the equivalent of GIMP's
- File python/enum_practice.py contains:
- How to use the hash-bang (ex:
#!/usr/bin/python3) at the top of a Python script to make it a callable file. Note: you must still make the file executable in addition to this too. - How to use enums (ie: "
Enumclasses") in Python. - Demonstrates that Python enums can have values which are either integers or strings (or other types I think too).
- Shows how to left-align prints in Python using the
%operator, as well as specify their width. This is like theprintf()-style prints in C and C++. Keywords: python print alignment, python print width, python left or right align prints, python C or C++-like prints, python %s prints. - How to inspect and print all members of any class in Python using the
.__dict__member accessor; ex:my_obj.__dict__. - How to access the full, scoped name of an enum with just
my_enum, or its name withmy_enum.name, or its value withmy_enum.value. - How to access an enum via a variable (ex:
fruit, where previously fruit was set like this:fruit = Fruit.APPLE) OR directly via its scoped class name (ex:Fruit.APPLEdirectly). - How to create an enum class which contains ONLY strings, for instance, by inheriting from BOTH the
strclass and theEnumclass.- Pay attention!: if you try to store an integer into such an Enum class the integer value gets automatically converted into a string! This is demonstrated.
- How to iterate over Enums in Python (meaning: over all enum members in an Enum class).
- Introduce 3 types of enums:
- regular enums
- string enums
- integer enums
- Compare and contrast three types of enums (1. regular enums vs. 2. string enums vs. 3. integer enums), and show and compare how each works and how each treats the
=operator. - etc.
- How to use the hash-bang (ex:
- github_readme_center_and_align_images.md: show how to insert and center, align left, align right, etc. images in GitHub readmes in markdown. Ex: resize this image to 15% auto-resizing width, and:
Align left:
Align center:
Align right:
6 images in a row:
- See the bash folder.
- See also various *.sh bash scripts I've written in my eRCaGuy_dotfiles repo here: eRCaGuy_dotfiles/useful_scripts.
- How to obtain the full file path, full directory, and base filename of any script being run itself.
- Learn how to use the
source(AKA.) command to "import" variables, and theexportcommand to "export" them. - How to escape
$and': bash/character_escaping_demo.sh - How to do "array slicing" (like in Python) in bash, meaning: how to grab an element or a desired range of elements from within a bash array. This also covers the bare basics of printing arrays, creating arrays, etc.
- See the awk folder.
- See also: git-diffn.sh in another repo of mine, my readme here, and my answer to how to do "Git diff with line numbers (Git log with line numbers)" here.
(Output of tree. Run this cmd yourself to make sure what you see is up-to-date! I don't update the output below very often.)
eRCaGuy_hello_world$ tree
.
├── arduino
│ └── Leonardo_type_once_per_second
│ └── Leonardo_type_once_per_second.ino
├── avr
│ └── avr_ATmega328_blink--UNTESTED.c
├── awk
│ ├── awk_hello_world_SAMPLE_OUTPUT.txt
│ ├── awk_hello_world.sh
│ ├── awk_syntax_tests.sh
│ └── input_file_1.txt
├── bash
│ ├── array_slicing_demo.sh
│ ├── character_escaping_demo.sh
│ ├── get_script_path.sh
│ ├── Link to ElectricRCAircraftGuy--PDF2SearchablePDF [THIS IS A SOLID BASH EXAMPLE!].desktop
│ ├── Link to PDF2SearchablePDF--pdf2searchablepdf.sh at master · ElectricRCAircraftGuy--PDF2SearchablePDF.desktop
│ ├── practice
│ │ ├── read_arrays.sh
│ │ └── README.md
│ ├── README.md
│ └── source_and_export.sh
├── bin
├── c
│ ├── 2d_array_practice.c
│ ├── assert_practice.c
│ ├── bin
│ │ ├── D_define
│ │ ├── stack_size_bruno_c
│ │ ├── stack_size_bruno_cpp
│ │ ├── stack_size_gs_c
│ │ ├── stack_size_gs_cpp
│ │ └── tmp
│ ├── c - Where do we use .i files and how do we generate them? - Stack Overflow.desktop
│ ├── dynamic_func_call_before_and_after_main_build_and_run.sh
│ ├── dynamic_func_call_before_and_after_main.c
│ ├── gcc_dash_D_macro_define.c
│ ├── hello_world
│ ├── hello_world_basic.c
│ ├── hello_world.c
│ ├── hello_world_sleep
│ ├── hello_world_sleep.c
│ ├── Link to c - Prototype of printf and implementation - Stack Overflow%%%%%+ [MY OWN ANS!].desktop
│ ├── Link to c - Where do we use .i files and how do we generate them - Stack Overflow%%%%% [MY OWN ANS!].desktop
│ ├── Link to Using the GNU Compiler Collection (GCC): Warning Options%%%%% [always use `-Wall -Werror`!].desktop
│ ├── malloc_override_test.c
│ ├── onlinegdb--atomic_block_in_c_WORKS.c
│ ├── onlinegdb--empirically_determine_max_thread_stack_size_Bruno_Haible.c
│ ├── onlinegdb--empirically_determine_max_thread_stack_size_GS_version.c
│ ├── onlinegdb--empirically_determine_max_thread_stack_size.md
│ ├── rounding_integer_division
│ │ ├── c - Rounding integer division (instead of truncating) - Stack Overflow.desktop
│ │ ├── readme.md
│ │ ├── rounding_integer_division.c -> rounding_integer_division.cpp
│ │ ├── rounding_integer_division.cpp
│ │ ├── rounding_integer_division.md
│ │ ├── run_tests_sample_output.txt
│ │ └── run_tests.sh
│ ├── strncmpci.c
│ ├── type_punning.c
│ ├── Using the GNU Compiler Collection (GCC): Warning Options-1.desktop
│ ├── utilities.c
│ └── utilities.h
├── cpp
│ ├── bin
│ │ ├── integer_literals
│ │ ├── onlinegdb--cpp_default_args_practice
│ │ ├── onlinegdb--process_10_bit_video_data
│ │ ├── process_10_bit_video_data
│ │ ├── struct_initialization
│ │ ├── struct_initialization.i
│ │ ├── struct_initialization.ii
│ │ ├── struct_initialization.o
│ │ ├── struct_initialization.s
│ │ └── tmp
│ ├── bin_hello_world
│ │ ├── hello_world
│ │ ├── hello_world.ii
│ │ ├── hello_world.o
│ │ └── hello_world.s
│ ├── check_addr_of_weak_undefined_funcs.cpp
│ ├── copy_constructor_and_assignment_operator
│ │ ├── 170_Copy_Constructor_Assignment_Operator_[Stanford.edu]_GS_edit.pdf
│ │ ├── 170_Copy_Constructor_Assignment_Operator_[Stanford.edu].pdf
│ │ ├── Copy assignment operator - cppreference.com.desktop
│ │ ├── copy_constructor_and_assignment_operator [AKA--the ''Rule of Three'' and the ''Rule of Five'' demo!].txt
│ │ ├── copy_constructor_and_assignment_operator.cpp
│ │ ├── Copy constructors, assignment operators, - C++ Articles-1.desktop
│ │ ├── Copy constructors, assignment operators, - C++ Articles.desktop
│ │ ├── Copy constructor vs assignment operator in C++ - GeeksforGeeks.desktop
│ │ ├── c++ - What is The Rule of Three? - Stack Overflow.desktop
│ │ ├── c++ - What's the difference between assignment operator and copy constructor? - Stack Overflow.desktop
│ │ ├── Link to 170_Copy_Constructor_Assignment_Operator_[Stanford.edu].pdf.desktop
│ │ ├── Link to c++ Assignment operator and copy constructor - Google Search%%%%%.desktop
│ │ ├── Link to Copy constructor vs assignment operator in C++ - GeeksforGeeks%%%%% [see `t2 = t1; -- calls assignment operator, same as "t2.operator=(t1);" `].desktop
│ │ ├── Link to c++ - What is The Rule of Three? - Stack Overflow%%%%%.desktop
│ │ └── Link to When should we write our own assignment operator in C++? - GeeksforGeeks%%%%% [use this code here!].desktop
│ ├── floating_point_resolution
│ │ ├── data -> ../../../eRCaGuy_hello_world_data/cpp/floating_point_resolution/data/
│ │ ├── double_resolution_test_1.cpp
│ │ ├── double_resolution_test_2.cpp
│ │ ├── double_resolution_test_3.cpp
│ │ ├── double_resolution_test_3--Figure_1a.png
│ │ ├── double_resolution_test_3--Figure_1b_zoomed_in.png
│ │ ├── double_resolution_test_3--Figure_1c_zoomed_in_really_small_to_very_beginning.png
│ │ ├── double_resolution_test_4.cpp
│ │ ├── plot_data.py
│ │ ├── readme.md
│ │ └── todo_(what_to_work_on_next).txt
│ ├── hello_world.cpp
│ ├── integer_literals.cpp
│ ├── Link to c - Where do we use .i files and how do we generate them - Stack Overflow%%%%% [MY OWN ANS!].desktop
│ ├── Link to How to initialize a struct to 0 in C++ - Stack Overflow%%%%%+ [my own Q & A].desktop
│ ├── Link to Why doesn't initializing a C++ struct to `= {0}` set all of its members to 0? - Stack Overflow%%%%%++ [my own Q; very good answers here!].desktop
│ ├── macro_practice
│ │ ├── advanced_macro_usage_pass_in_entire_func.cpp
│ │ ├── bin_adv_macro
│ │ │ ├── advanced_macro_usage_pass_in_entire_func
│ │ │ ├── advanced_macro_usage_pass_in_entire_func.ii
│ │ │ ├── advanced_macro_usage_pass_in_entire_func.o
│ │ │ └── advanced_macro_usage_pass_in_entire_func.s
│ │ └── gcc_dash_D_macro_define.c -> ../../c/gcc_dash_D_macro_define.c
│ ├── onlinegdb--atomic_block_in_cpp_1_WORKS.cpp
│ ├── onlinegdb--atomic_block_in_cpp_2_FAILS.cpp
│ ├── onlinegdb--atomic_block_in_cpp_3_WORKS.cpp
│ ├── onlinegdb--const_reference_to_vector__default_func_parameter.cpp
│ ├── onlinegdb--cpp_default_args_practice.cpp
│ ├── process_10_bit_video_data.cpp
│ ├── run_hello_world.sh
│ ├── run_struct_initialization.sh
│ ├── struct_initialization.c -> struct_initialization.cpp
│ ├── struct_initialization.cpp
│ ├── template_function_sized_array_param
│ │ ├── print_array_calls_by_array_size.ods
│ │ ├── readme.md
│ │ ├── regular_func
│ │ ├── regular_func.cpp
│ │ ├── template_func
│ │ └── template_func.cpp
│ ├── template_practice
│ │ ├── explicit_template_specialization.cpp
│ │ ├── research
│ │ │ ├── (7) Template Specialization In C++ - YouTube.desktop
│ │ │ ├── Buckys C++ Programming Tutorials - 61 - Template Specializations - YouTube.desktop
│ │ │ ├── Link to explicit (full) template specialization - cppreference.com%%%%%+.desktop
│ │ │ ├── Link to template c++ - Google Search%%%%%.desktop
│ │ │ ├── Link to template specialization - Google Search%%%%%.desktop
│ │ │ ├── Link to template specialization - Google Search [videos]%%%%%.desktop
│ │ │ ├── partial template specialization - cppreference.com.desktop
│ │ │ ├── Template (C++) - Wikipedia.desktop
│ │ │ ├── Template (C++) - Wikipedia_GS_edit.pdf
│ │ │ └── Template (C++) - Wikipedia.pdf
│ │ └── run_explicit_template_specialization.sh
│ └── unordered_map_practice
│ ├── Link to GDB online Debugger - Code, Compile, Run, Debug online C, C++ [unordered_map practice].desktop
│ ├── unordered_map_hash_table_implicit_key_construction_test
│ └── unordered_map_hash_table_implicit_key_construction_test.cpp
├── eRCaGuy_hello_world--what to work on next--Gabriel.odt
├── git_branch_hash_backups
│ └── eRCaGuy_hello_world_git_branch_bak--20200628-1856hrs-45sec.txt
├── java
│ └── todo.txt
├── LICENSE
├── markdown
│ ├── github_readme_center_and_align_images.md
│ └── photos
│ ├── LICENSE.txt
│ ├── pranksta1.jpg
│ ├── pranksta2.jpg
│ ├── pranksta3.jpg
│ ├── pranksta4.jpg
│ ├── pranksta5.jpg
│ ├── pranksta6.jpg
│ └── pranksta7.jpg
├── python
│ ├── autogenerate_c_or_cpp_code.py
│ ├── autogenerated
│ │ └── myheader.h
│ ├── auto_white_balance_img.py
│ ├── raw_bytes_practice.py
│ ├── slots_practice
│ │ ├── Class and Instance Attributes – Real Python.desktop
│ │ ├── Link to 10. __slots__ Magic — Python Tips 0.1 documentation%%%%%+.desktop
│ │ └── slots_practice.py
│ ├── textwrap_practice_1.py
│ └── yaml_import
│ ├── import_yaml_test.py
│ ├── my_config1.yaml
│ └── my_config2.yaml
├── README.md
├── test_photos
│ ├── README.md
│ └── test1.jpg
└── tree.txt
30 directories, 163 files
- Newest on top
- Follows Semantic Versioning: MAJOR.MINOR.PATCH; see: https://semver.org/ for rules & FAQ.
- The 6 most common recommended types of changes are (see here: https://keepachangelog.com/en/1.0.0/): Added, Changed, Deprecated, Removed, Fixed, Security
INITIAL DEVELOPMENT PHASE:
- Use version numbers 0.MINOR.PATCH for the initial development phase; ex: 0.1.0, 0.2.0, etc.
- Increment just the MINOR version number for each new 0.y.z development phase enhancement, until the project is mature enough that you choose to move to a 1.0.0 release
- You may increment the PATCH number for bug fixes to your development code, or just increment the MINOR version number if there are also enhancements
MORE MATURE PHASE:
- As the project matures, release a 1.0.0 version
- Once you release a 1.0.0 version, do the following (copied from semver.org):
- Given a version number MAJOR.MINOR.PATCH, increment the:
- MAJOR version when you make incompatible API changes,
- MINOR version when you add functionality in a backwards compatible manner, and
- PATCH version when you make backwards compatible bug fixes.
UPDATE 27 DEC 2020: CHANGELOG AND RELEASES NOT REALLY UP-TO-DATE ANYMORE. JUST USE THE LATEST MASTER BRANCH!
- Added "awk" folder with two sample programs: "awk_hello_world.sh" and "awk_syntax_tests.sh"
- Added "cpp/unordered_map_practice/unordered_map_hash_table_implicit_key_construction_test.cpp"
- Added changelog and started tracking a "version" number via the changelog
- Added "python/yaml_import/import_yaml_test.py" and related .yaml configuration files to demonstrate importing and using YAML configuration files in Python
- A bunch of really good C and C++ examples were already in place at this time, as I had been doing this project for quite some time without a Changelog