Changeset 8403b32 for doc

Timestamp:

May 3, 2026, 10:18:08 AM (12 hours ago)

Author:

Peter A. Buhr <pabuhr@…>

Branches:

master

Parents:

2fd3de7

Message:

update user documentation with new quote manipulator

File:

• doc/user/user.tex (modified) (7 diffs)

doc/user/user.tex

@@ -11 +11 @@
 %% Created On       : Wed Apr  6 14:53:29 2016
 %% Last Modified By : Peter A. Buhr
-%% Last Modified On : Fri Mar 20 08:05:59 2026
-%% Update Count     : 7399
+%% Last Modified On : Sun May  3 10:13:13 2026
+%% Update Count     : 7425
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
@@ -5382 +5382 @@
 \begin{enumerate}
 \item
-\Indexc{bin}( integer )\index{manipulator!bin@©bin©} print value in base 2 preceded by ©0b©/©0B©.
+\Indexc{bin}( integer / character / string )\index{manipulator!bin@©bin©} print value in base 2 preceded by ©0b©/©0B©.
 \begin{cfa}[belowskip=0pt]
 sout | bin( 0 ) | bin( 27HH ) | bin( 27H ) | bin( 27 ) | bin( 27L );
@@ -5388 +5388 @@
 sout | bin( -27HH ) | bin( -27H ) | bin( -27 ) | bin( -27L );
 0b11100101 0b1111111111100101 0b11111111111111111111111111100101 0b®(58 1s)®100101
-\end{cfa}
-
-\item
-\Indexc{oct}( integer )\index{manipulator!oct@©oct©} print value in base 8 preceded by ©0©.
+sout | bin( 'A' ) | "|" |  bin( "abd" ) | "|" | bin( (string){ "@#!" } );
+0b1000001 | 0b1100001 0b1100010 0b1100100 | 0b1000000 0b100011 0b100001
+\end{cfa}
+
+\item
+\Indexc{oct}( integer / character / string )\index{manipulator!oct@©oct©} print value in base 8 preceded by ©0©.
 \begin{cfa}[belowskip=0pt]
 sout | oct( 0 ) | oct( 27HH ) | oct( 27H ) | oct( 27 ) | oct( 27L );
@@ -5397 +5399 @@
 sout | oct( -27HH ) | oct( -27H ) | oct( -27 ) | oct( -27L );
 0345 0177745 037777777745 01777777777777777777745
-\end{cfa}
-Note, octal 0 is \emph{not} preceded by ©0© to prevent confusion.
-
-\item
-\Indexc{hex}( integer / floating-point )\index{manipulator!hex@©hex©} print value in base 16 preceded by ©0x©/©0X©.
+sout | oct( 'A' ) | "|" |  oct( "abd" ) | "|" | oct( (string){ "@#!" } );
+0101 | 0141 0142 0144 | 0100 043 041
+\end{cfa}
+Note, octal ©0© is \emph{not} preceded by ©0© to prevent confusion.
+
+\item
+\Indexc{hex}( integer / floating-point  / character / string )\index{manipulator!hex@©hex©} print value in base 16 preceded by ©0x©/©0X©.
 \begin{cfa}[belowskip=0pt]
 sout | hex( 0 ) | hex( 27HH ) | hex( 27H ) | hex( 27 ) | hex( 27L );
@@ -5407 +5411 @@
 sout | hex( -27HH ) | hex( -27H ) | hex( -27 ) | hex( -27L );
 0xe5 0xffe5 0xffffffe5 0xffffffffffffffe5
-
 sout | hex( 0.0 ) | hex( 27.5F ) | hex( 27.5 ) | hex( 27.5L );
 0x0p+0 0x1.b8p+4 0x1.b8p+4 0xd.cp+1
 sout | hex( -27.5F ) | hex( -27.5 ) | hex( -27.5L );
 -0x1.b8p+4 -0x1.b8p+4 -0xd.cp+1
+sout | hex( 'A' ) | "|" |  hex( "abd" ) | "|" | hex( (string){ "@#!" } );
+0x41 | 0x61 0x62 0x64 | 0x40 0x23 0x21
 \end{cfa}
 
@@ -5441 +5446 @@
 
 \item
-\Indexc{upcase}( bin / hex / floating-point )\index{manipulator!upcase@©upcase©} print letters in a value in upper case. Lower case is the default.
+\Indexc{upcase}( bin / hex )\index{manipulator!upcase@©upcase©} print letters in a value in upper case. Lower case is the default.
 \begin{cfa}[belowskip=0pt]
-sout | upcase( bin( 27 ) ) | upcase( hex( 27 ) ) | upcase( 27.5e-10 ) | upcase( hex( 27.5 ) );
-0®B®11011 0®X®1®B® 2.75®E®-09 0®X®1.®B®8®P®+4
-\end{cfa}
-
-\item
-\Indexc{nobase}( integer )\index{manipulator!nobase@©nobase©} do not precede ©bin©, ©oct©, ©hex© with ©0b©/©0B©, ©0©, or ©0x©/©0X©.
+sout | upcase( bin( 27 ) ) | upcase( hex( 27 ) ) | upcase( 27.5e-10 ) | upcase( hex( 27.5 ) ) | upcase( hex( 'W' ) );
+0®B®11011 0®X®1®B® 2.75®E®-09 0®X®1.®B®8®P®+4 0®X®57
+\end{cfa}
+
+\item
+\Indexc{nobase}( bin / oct / hex (not floating-point) )\index{manipulator!nobase@©nobase©} do not precede ©bin©, ©oct©, ©hex© with ©0b©/©0B©, ©0©, or ©0x©/©0X©.
 Printing the base is the default.
 \begin{cfa}[belowskip=0pt]
-sout | nobase( bin( 27 ) ) | nobase( oct( 27 ) ) | nobase( hex( 27 ) );
-11011 33 1b
+sout | nobase( bin( 'W' ) ) | nobase( oct( 27 ) ) | nobase( hex( 27 ) );
+1010111 33 1b
 \end{cfa}
 
@@ -5461 +5466 @@
 sout | 0. | nodp( 0. ) | 27.0 | nodp( 27.0 ) | nodp( 27.5 );
 0.0 ®0® 27.0 ®27® 27.5
+\end{cfa}
+
+\item
+\Indexc{quote}( character / string) )\index{manipulator!quote@©quote©} bracket text with appropriate quote characters.
+No quotes is the default.
+\begin{cfa}[belowskip=0pt]
+sout | quote( 'A' ) | quote( "abd" ) | quote( (string){ "@#!" } );
+'A'"abd" "@#!"
 \end{cfa}