Changeset 65b851a for doc

Timestamp:

Jan 28, 2024, 4:00:31 PM (5 months ago)

Author:

Peter A. Buhr <pabuhr@…>

Branches:

master

Children:

2989d6f, 7329b0a

Parents:

b771581

Message:

start updaing documentation for input changes

File:

• doc/user/user.tex (modified) (4 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 : Mon Jan 22 11:59:04 2024
-%% Update Count     : 5961
+%% Last Modified On : Sun Jan 28 13:28:23 2024
+%% Update Count     : 5979
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
@@ -4599 +4599 @@
 For example, in:
 \begin{cfa}
+int i, j;
 sin | i | ®nl® | j;
 1 ®2®
@@ -4604 +4605 @@
 \end{cfa}
 variable ©i© is assigned 1, the 2 is skipped, and variable ©j© is assigned 3.
+For example, in:
+\begin{cquote}
+\begin{tabular}{@{}l@{\hspace{3em}}l@{}}
+\begin{cfa}
+char ch
+
+sin | ch; // read X
+
+X
+\end{cfa}
+&
+\begin{cfa}
+
+sin | ®nlOn®; // enable reading newlines
+sin | ch; // read newline
+
+
+\end{cfa}
+\end{tabular}
+\end{cquote}
+the left example skips the newline and reads ©'X'© into ©ch©, while the right example reads the newline into ©ch©.
 
 For output:
@@ -4942 +4964 @@
 
 \item
-\Indexc{wdi}( maximum, reference-value )\index{manipulator!wdi@©wdi©}
-For all types except ©char©, maximum is the maximum number of characters read for the current operation.
+\Indexc{wdi}( maximum, reference )\index{manipulator!wdi@©wdi©}
+For all types except ©char *©, maximum is the maximum number of characters read for the current operation.
 \begin{cfa}[belowskip=0pt]
-char s[10];   int i;   double d;   
-sin | wdi( 4, s ) | wdi( 3, i ) | wdi( 8, d );  // c == "abcd", i == 123, d == 3.456E+2
+char ch;   char ca[3];   int i;   double d;   
+sin | wdi( sizeof(ch), ch ) | wdi( sizeof(ca), ca[0] ) | wdi( 3, i ) | wdi( 8, d );  // c == 'a', ca = "bcd", i == 123, d == 345.6
 \end{cfa}
 \begin{cfa}[showspaces=true,aboveskip=0pt,belowskip=0pt]
 ®abcd1233.456E+2®
 \end{cfa}
+Here, ©ca[0]© is type ©char©, so the width reads 3 characters \Textbf{without} a null terminator.
+
 Note, input ©wdi© cannot be overloaded with output ©wd© because both have the same parameters but return different types.
 Currently, \CFA cannot distinguish between these two manipulators in the middle of an ©sout©/©sin© expression based on return type.