[format.string.{std,escaped}, macros] Add missing examples

Author: tkoeppe

source/macros.tex

@@ -715,7 +715,8 @@
 %%--------------------------------------------------
 %% Environment for imported graphics
 %%--------------------------------------------------
-% usage: \begin{importgraphic}{CAPTION}{TAG}{FILE}
+% usage: \begin{importgraphic}{CAPTION}{TAG}{FILE}\end{importgraphic}
+%        \importexample[VERTICAL OFFESET]{FILE}
 %
 % The filename is relative to the source/assets directory.
 
@@ -730,6 +731,8 @@
 \caption{\cptn \quad [fig:\lbl]}\label{fig:\lbl}%
 \end{figure}}
 
+\newcommand{\importexample}[2][-0.9pt]{\raisebox{#1}{\includegraphics{assets/#2}}}
+
 %%--------------------------------------------------
 %% Definitions section for "Terms and definitions"
 %%--------------------------------------------------

source/utilities.tex

@@ -1,4 +1,5 @@
 %!TEX root = std.tex
+
 \rSec0[utilities]{General utilities library}
 
 \rSec1[utilities.general]{General}
@@ -15915,6 +15916,8 @@
 string s8 = format("{:02}", 1234);          // value of \tcode{s8} is \tcode{"1234"}
 string s9 = format("{:*<}", "12");          // value of \tcode{s9} is \tcode{"12"}
 string sA = format("{:*<6}", "12345678");   // value of \tcode{sA} is \tcode{"12345678"}
+string sB = format("{:@\importexample[-2pt]{example_05}\caret{}@6}", "x");         // value of \tcode{sB} is \tcode{"\importexample[-2pt]{example_05}\importexample[-2pt]{example_05}x\importexample[-2pt]{example_05}\importexample[-2pt]{example_05}\importexample[-2pt]{example_05}"}
+string sC = format("{:*@\caret{}@6}", "@\importexample[-2pt]{example_05}@");         // value of \tcode{sC} is \tcode{"\importexample[-2pt]{example_05}\importexample[-2pt]{example_05}\importexample[-2pt]{example_05}"}
 \end{codeblock}
 \end{example}
 \begin{note}
@@ -15924,8 +15927,7 @@
 because padding width is \tcode{0} in that case.
 Since fill characters are assumed to have a field width of \tcode{1},
 use of a character with a different field width can produce misaligned output.
-%FIXME: cannot show clown face character below.
-The \unicode{1f921}{clown face} character has a field width of \tcode{2}.
+The \importexample[-2pt]{example_05} (\unicode{1f921}{clown face}) character has a field width of \tcode{2}.
 The examples above that include that character
 illustrate the effect of the field width
 when that character is used as a fill character
@@ -17142,16 +17144,19 @@
 %% FIXME: their Unicode characters are not available in our font (Latin Modern).
 \begin{example}
 \begin{codeblock}
-string s0 = format("[{}]", "h\tllo");               // \tcode{s0} has value: \tcode{[h\ \ \ \ llo]}
-string s1 = format("[{:?}]", "h\tllo");             // \tcode{s1} has value: \tcode{["h\textbackslash tllo"]}
-string s3 = format("[{:?}, {:?}]", '\'', '"');      // \tcode{s3} has value: \tcode{['\textbackslash '', '"']}
+string s0 = format("[{}]", "h\tllo");                   // \tcode{s0} has value: \tcode{[h\ \ \ \ llo]}
+string s1 = format("[{:?}]", "h\tllo");                 // \tcode{s1} has value: \tcode{["h\textbackslash tllo"]}
+string s2 = format("[{:?}]", "@\importexample[-2.5pt]{example_01}@");  @\kern1.25pt@// \tcode{s2} has value: \tcode{["\importexample[-2.5pt]{example_01}"]}
+string s3 = format("[{:?}, {:?}]", '\'', '"');          // \tcode{s3} has value: \tcode{['\textbackslash '', '"']}
 
 // The following examples assume use of the UTF-8 encoding
 string s4 = format("[{:?}]", string("\0 \n \t \x02 \x1b", 9));
                                                     // \tcode{s4} has value: \tcode{["\textbackslash u\{0\} \textbackslash n \textbackslash t \textbackslash u\{2\} \textbackslash u\{1b\}"]}
 string s5 = format("[{:?}]", "\xc3\x28");           // invalid UTF-8, \tcode{s5} has value: \tcode{["\textbackslash x\{c3\}("]}
+string s6 = format("[{:?}]", "@\importexample{example_02}@");                 @\kern0.75pt@// \tcode{s6} has value: \tcode{["\importexample{example_03}\textbackslash{u}\{200d\}\importexample{example_04}\textbackslash{u}\{fe0f\}"]}
 string s7 = format("[{:?}]", "\u0301");             // \tcode{s7} has value: \tcode{["\textbackslash u{301}"]}
 string s8 = format("[{:?}]", "\\\u0301");           // \tcode{s8} has value: \tcode{["\textbackslash \textbackslash \textbackslash u{301}"]}
+string s9 = format("[{:?}]", "e\u0301\u0323");      // \tcode{s9} has value: \tcode{["\importexample[-2pt]{example_06}"]}
 \end{codeblock}
 \end{example}