Repository navigation
Releases
Modern C++ Foundations 0.1.0-alpha.1 — First Public Alpha
English version below.
Polski
Modern C++ Foundations to praktyczny kurs programowania od podstaw w nowoczesnym C++ (C++20), po polsku i po angielsku. Nie musisz wcześniej programować. To pierwsze publiczne wydanie kursu, w fazie alfa. Kurs jest pierwszą częścią (A) planowanej ścieżki nauki C++.
Co zawiera to wydanie
- 15 modułów (0–14) i 86 lekcji w każdej wersji językowej. Obie wersje mają tę samą treść, te same programy i te same wyniki.
- Tematy, moduł po module:
- Moduł 0: pliki, terminal, instalacja narzędzi i pierwszy program, w CLionie i z terminala;
- Moduł 1: pierwsze programy w C++20, komunikaty kompilatora, droga od kodu źródłowego do programu i zapisywanie historii pracy w Gicie;
- Moduł 2: wartości, obliczenia, dane od użytkownika i tekst;
- Moduł 3: decyzje i warunki;
- Moduł 4: pętle;
- Moduł 5: własne funkcje;
- Moduł 6: wiele wartości w jednej zmiennej (
std::vector); - Moduł 7: tekst znak po znaku (
char,std::string); - Moduł 8: struktury, czyli własne typy danych;
- Moduł 9: funkcje, które zmieniają dane przez referencję;
- Moduł 10: rekordy budowane z danych odczytanych z wejścia;
- Moduł 11: programy z kilku plików źródłowych i własnych plików nagłówkowych;
- Moduł 12: odczyt danych i rekordów z plików tekstowych, ze wskazaniem błędnej linii;
- Moduł 13: programy testowe, które same sprawdzają wyniki Twoich funkcji;
- Moduł 14: nazwane stany i wyniki funkcji (
enum class,switch) oraz odczyt, który po błędnym wpisie odzyskuje strumień i pozwala spróbować jeszcze raz.
- Zadania i sprawdziany: lekcje zawierają krótkie, niezależne zadania z kryteriami sukcesu, podpowiedziami i przykładowymi rozwiązaniami. Moduły 1–14 kończą się sprawdzianem, w którym samodzielnie wykorzystujesz umiejętności z całego modułu.
Jak zacząć
- Opis kursu: README po polsku albo README in English.
- Pierwsza lekcja: Lekcja 0.1: Pliki, katalogi i pierwsze spotkanie z terminalem. Lekcje przerabiaj po kolei, zaczynając od Modułu 0.
Czego potrzebujesz
-
Komputer: Windows 10/11, macOS albo Ubuntu 24.04 LTS, dostęp do internetu, kilka gigabajtów wolnego miejsca na dysku i uprawnienia administratora do instalacji narzędzi. Do lekcji 0.1–0.3 wystarczy dowolny komputer z Windowsem, macOS albo Linuksem.
-
Narzędzia, które instalujesz w lekcji 0.4:
- LLVM/Clang 22 lub nowszy (kompilator
clang++); - CMake 3.28 lub nowszy;
- Ninja;
- CLion.
Na Windowsie
clang++korzysta też z Visual Studio Build Tools i Windows SDK. - LLVM/Clang 22 lub nowszy (kompilator
-
CLion jest wygodny, ale nie jest obowiązkowy: każdy projekt z kursu zbudujesz i uruchomisz też z terminala.
-
Inne dystrybucje Linuksa: polecenia instalacji mogą się różnić, a kursu na nich nie sprawdzaliśmy.
-
Kroki w CLionie i instalacja: część z nich opisujemy według dokumentacji narzędzi i nie sprawdziliśmy ich jeszcze na każdym systemie.
Automatyczne kontrole
Przy każdej zmianie lekcji GitHub Actions uruchamia kontrole na Windowsie, macOS i Ubuntu 24.04, z kompilatorem Clang 22 i bibliotekami standardowymi tych systemów (MSVC STL, libc++ i libstdc++):
- 476 przykładowych programów z 80 lekcji Modułów 1–14 jest budowanych i uruchamianych. W 981 uruchomieniach program dostaje dane wejściowe z lekcji. Wynik każdego programu jest porównywany z wynikiem pokazanym w lekcji.
- 48 programów, które celowo się nie budują, jest sprawdzanych razem z oczekiwanym błędem kompilacji albo linkowania.
- Narzędzie sprawdzające przechodzi własne 145 testów, które potwierdzają, że wykrywa błędy.
- Polecenia terminala z wybranych lekcji są wykonywane w powłokach bash, zsh, PowerShell 7 i Windows PowerShell 5.1.
Te kontrole sprawdzają, czy programy działają tak, jak opisują lekcje. Nie zastępują pilotażu z osobami uczącymi się: nie mówią, czy wyjaśnienia są zrozumiałe ani ile naprawdę trwa praca z lekcją.
Faza alfa
- Kurs jest publicznie dostępny: możesz korzystać ze wszystkich 86 lekcji.
- Materiały mogą się jeszcze zmieniać, także na podstawie zgłoszeń.
- Kurs nie przeszedł jeszcze pilotażu dydaktycznego z osobami uczącymi się.
- Czas pracy podany w lekcjach to szacunek.
- Zgłaszaj błędy i niejasności: każda uwaga pomaga.
Licencje
- Materiały edukacyjne (tekst lekcji, ćwiczenia, pytania, opisy rozwiązań i dokumentacja) są na licencji Creative Commons Attribution 4.0 International (CC BY 4.0).
- Kod (programy i przykłady w C++, pliki CMake, testy i skrypty) jest na licencji MIT. Dotyczy to także kodu umieszczonego w lekcjach.
- Szczegóły, przykłady i sposób podawania autora opisuje LICENSE.md.
Zgłoszenia i uwagi
Zgłoś w GitHub Issues:
- niejasne albo błędne wyjaśnienia;
- przykłady, które się nie budują albo wypisują coś innego niż w lekcji;
- problemy z instalacją narzędzi i ze środowiskiem;
- pomysły na ulepszenia.
Do wyboru są trzy krótkie formularze. Formularze są po angielsku, ale zgłoszenie możesz napisać po polsku albo po angielsku. Do zgłoszenia potrzebne jest konto na GitHubie. Zgłoszenia są publiczne, więc nie wpisuj w nich danych osobowych.
English
Modern C++ Foundations is a practical course that teaches programming from scratch in modern C++ (C++20), in Polish and in English. You don't need any previous programming experience. This is the course's first public release, at the alpha stage. The course is the first part (A) of a planned C++ learning path.
What this release contains
- 15 modules (0–14) and 86 lessons in each language. Both versions have the same content, the same programs and the same results.
- The topics, module by module:
- Module 0: files, the terminal, installing the tools and a first program, in CLion and from the terminal;
- Module 1: first programs in C++20, compiler messages, the path from source code to a program, and saving the history of your work with Git;
- Module 2: values, calculations, data from the user and text;
- Module 3: decisions and conditions;
- Module 4: loops;
- Module 5: functions of your own;
- Module 6: many values in one variable (
std::vector); - Module 7: text character by character (
char,std::string); - Module 8: structs, your own data types;
- Module 9: functions that change data through a reference;
- Module 10: records built from data read from input;
- Module 11: programs made of several source files and your own header files;
- Module 12: reading data and records from text files, pointing to the bad line;
- Module 13: test programs that check the results of your functions by themselves;
- Module 14: named states and function results (
enum class,switch), and reading that recovers the stream after a bad entry and lets you try again.
- Tasks and tests: the lessons contain short, independent tasks with success criteria, hints and example solutions. Modules 1–14 each end with a test in which you use the skills of the whole module on your own.
Getting started
- Course overview: README in English or README po polsku.
- First lesson: Lesson 0.1: Files, folders and your first look at the terminal. Work through the lessons in order, starting with Module 0.
What you need
-
A computer: Windows 10/11, macOS or Ubuntu 24.04 LTS, internet access, a few gigabytes of free disk space and administrator rights to install the tools. For lessons 0.1–0.3, any computer running Windows, macOS or Linux is enough.
-
Tools, which you install in lesson 0.4:
- LLVM/Clang 22 or newer (the
clang++compiler); - CMake 3.28 or newer;
- Ninja;
- CLion.
On Windows,
clang++also relies on Visual Studio Build Tools and the Windows SDK. - LLVM/Clang 22 or newer (the
-
CLion is convenient but not required: you can also build and run every project in the course from the terminal.
-
Other Linux distributions: the installation commands may differ, and we haven't checked the course on them.
-
CLion steps and installation: some of them are based on the tools' documentation and haven't been checked on every system yet.
Automatic checks
Whenever a lesson changes, GitHub Actions runs checks on Windows, macOS and Ubuntu 24.04, with the Clang 22 compiler and each system's standard library (the MSVC STL, libc++ and libstdc++):
- 476 example programs from 80 lessons of Modules 1–14 are built and run. In 981 of the runs, the program gets the input data from the lesson. Each program's output is compared with the output shown in the lesson.
- 48 programs that are meant not to build are checked together with their expected compile or link error.
- The checking tool passes its own 145 tests, which confirm that it detects errors.
- The terminal commands of selected lessons are run in bash, zsh, PowerShell 7 and Windows PowerShell 5.1.
These checks confirm that the programs work the way the lessons describe. They don't replace a pilot with learners: they can't tell whether the explanations are clear or how long a lesson really takes.
Alpha stage
- **The course i...