added loops over collections

Author: thomasWeise

bibliography/bibliography.bib

@@ -972,7 +972,7 @@ @article{E1985AEOCF
  doi = {10.1007/BF01699475},
  url = {https://www.researchgate.net/publication/301720080},
  urldate = {2024-09-24},
- addendum = {Translation of of \cite{E1737DFCD}.},
+ addendum = {Translation of~\cite{E1737DFCD}.},
 }
 
 @incollection{EOEBSRGML2024LY,

text/main/basics/collections/collections.tex

@@ -1,4 +1,5 @@
 \hsection{Collections}%
+\label{sec:collections}%
 %
 We already learned about simple datatypes, like integer and floating point numbers, strings, and Boolean values.
 We also learned how we can use variables to store instances (objects) of such datatypes.

text/main/basics/collections/sets/sets.tex

@@ -2,10 +2,12 @@
 \label{sec:sets}%
 %
 \gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{sets_1.py}{--args format}{sets:sets_1}{%
-A first example for using sets in \python: creating, modifying, and converting sets.}%
+A first example for using sets in \python: creating, modifying, and converting sets. %
+Since sets are unordered, printing them can yield a different result each time a program is executed (see \cref{bp:setsUnordered}).}%
 %
 \gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{sets_2.py}{--args format}{sets:sets_2}{%
-A second example for using sets in \python: creating sets and set operations (as illustrated in \cref{fig:setOperations}).}%
+A second example for using sets in \python: creating sets and set operations (as illustrated in \cref{fig:setOperations}). %
+Since sets are unordered, printing them can yield a different result each time a program is executed (see \cref{bp:setsUnordered}).}%
 %
 \begin{figure}%
 \centering%

text/main/basics/simpleDataTypesAndOperations/str/str.tex

@@ -311,6 +311,8 @@
 %
 %
 \hsection{Escaping Characters}%
+\label{sec:str:escaping}%
+\pythonIdx{str!escaping}\pythonIdx{escaping}%
 %
 \noviceHint{%
 This section tells you how to include special characters in strings that you otherwise could not include, like quotation marks. %
@@ -320,7 +322,7 @@
 \begin{figure}%
 \centering%
 \includegraphics[width=0.8\linewidth]{\currentDir/strEscapes}%
-\caption{Escaping special characters in \python\ strings.}%
+\caption{Escaping special characters in \python\ strings.\pythonIdx{str!escaping}\pythonIdx{escaping}}%
 \label{fig:strEscapes}%
 \end{figure}%
 %
@@ -331,25 +333,25 @@
 Well, you can say, if I need a double quotation mark, then I will delimit my string with single quotation marks and vice versa.
 This is all good as long as you do not need \emph{both} single and double quotation marks inside the string.
 
-The answer to this problem is \emph{escaping}\pythonIdx{str!escaping}.
+The answer to this problem is \emph{escaping}\pythonIdx{str!escaping}\pythonIdx{escaping}.
 The idea is very simple:
 If we need a certain quotation mark, then we simply put a backslash~(\inQuotes{\textbackslash})\pythonIdx{\textbackslash} before it.
 The backslash tells the \python\ interpreter that the next character should be considered as a normal character and not be interpreted as any special character, like a string delimiter.
 
-In \cref{fig:strEscapes}, we present several strings with escape sequences.
+In \cref{fig:strEscapes}, we present several strings with escape sequences\pythonIdx{str!escaping}\pythonIdx{escaping}.
 For clarity reasons, we pass them to the \pythonilIdx{print} function to output them, which means that they show up undelimited in the console.
 A double quotation mark can be printed as \pythonil{print("\\"")}, i.e., as a string which is delimited and that then contains the escape sequence {\textbackslash\textquotedbl}\pythonIdx{\textbackslash\textquotedbl}.
 It then shows up as~\textil{"} in the output.
 A single quotation mark can be printed as \pythonil{print("\\'")}, i.e., via the escape sequence {\textbackslash\textquotesingle}\pythonIdx{\textbackslash\textquotesingle}.
 It appears as~\textil{'} in the output.
 
 If the use the backslash character~\inQuotes{\textbackslash}\pythonIdx{\textbackslash} to escape characters which may otherwise have some special meaning {\dots} then what do we do if we need a backslash inside of a string?
-Easy: We escape it.
+Easy: We escape it\pythonIdx{str!escaping}\pythonIdx{escaping}.
 The escape sequence \inQuotes{\textbackslash\textbackslash}\pythonIdx{\textbackslash\textbackslash} is converted to a single backslash and \expandafter\pythonil{print("\\\\")} writes \textil{\\} to the output.
 Knowing these sequences, we can now try to \pythonil{print("\\"\\'\\\\")}.
 The result printed to the output then is~\textil{"'\\}.
 
-Another situation where escape sequences are nice is when we want to have strings that span over multiple lines.
+Another situation where escape sequences are nice is when we want to have strings that span over multiple lines\pythonIdx{str!escaping}\pythonIdx{escaping}.
 The newline sequence \inQuotes{\textbackslash{n}}\pythonIdx{\textbackslash{n}} represents a \inQuotes{newline character} which causes the console to skip to the next line.
 \pythonil{print("Hello\\nWorld!")} will first print \textil{Hello}, then end the current line and begin a new line, and then print \textil{World!}.
 Notice that the newline character sequence \inQuotes{\textbackslash{n}} is used in \linux\ and similar systems, whereas \windows\ uses \inQuotes{\textbackslash{r}\textbackslash{n}}\pythonIdx{\textbackslash{r}\textbackslash{n}}.
@@ -361,14 +363,15 @@
 If you want to include a horizontal tabulator in a string, the escape sequence \inQuotes{\textbackslash{t}}\pythonIdx{\textbackslash{t}} is your friend:
 \pythonil{print("The horizontal tab is like a bigger space: '\\t'.")} yields \inlinelistingbox{\texttt{The~horizontal~tab~is~like~a~bigger~space:~'~~~~'.}}.
 
-Finally, a backslash can also escape an actual newline in your string.
+Finally, a backslash can also escape an actual newline in your string\pythonIdx{str!escaping}\pythonIdx{escaping}.
 If you have a string that is too long to write on a single line but you do not want to have a linebreak inside the actual string, you can simply put a backslash, hit \keys{\enter}, and continue the typing the string.
 The linebreak will then be ignored entirely.
 Therefore, if you print~\pythonil{print("Hello\\}, hit \keys{\enter}, and then continue to write \pythonil{World!")}, this produces the output~\textil{HelloWorld!}.
 
 Escape sequences allow us to write arbitrary text in strings.
 We already learned the sequences \inQuotes{\textbraceleft\textbraceleft}\pythonIdx{\textbraceleft\textbraceleft} and \inQuotes{\textbraceright\textbraceright}\pythonIdx{\textbraceright\textbraceright} that were designed for \pglspl{fstring} only.
 The backslash-based escape sequence we discussed in this section work for both \pglspl{fstring} and normal strings.%
+\pythonIdx{str!escaping}\pythonIdx{escaping}%
 \endhsection%
 %
 \hsection{Multi-Line Strings}%