Changeset d2e6f84

Timestamp:

Sep 15, 2025, 9:22:48 PM (5 days ago)

Author:

Peter A. Buhr <pabuhr@…>

Branches:

master

Children:

96aca388

Parents:

4b465445

Message:

clean up string discussion

File:

• doc/user/user.tex (modified) (10 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 Sep 15 17:06:25 2025
-%% Update Count     : 7216
+%% Last Modified On : Mon Sep 15 21:14:57 2025
+%% Update Count     : 7220
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
@@ -2441 +2441 @@
 The maximum storage for a \CFA ©string© value is ©size_t© characters, which is $2^{32}$ or $2^{64}$ respectively.
 A \CFA string manages its length separately from the string, so there is no null (©'\0'©) terminating value at the end of a string value.
-Hence, a \CFA string cannot be passed to a C string manipulation routine, such as ©strcat©.
+Hence, a \CFA string cannot be passed to a C string manipulation function, such as ©strcat©.
 Like C strings, characters in a ©string© are numbered from the left starting at 0 (because subscripting is zero-origin), and in \CFA numbered from the right starting at -1.
 \begin{cquote}
@@ -2626 +2626 @@
 cs - cs2;       §\C{// find pointer offset}\CRT§
 \end{cfa}
-addition is less obvious:
+addition is less obvious
 \begin{cfa}
 ch + 'b'        §\C[2in]{// add character values}§
@@ -2675 +2675 @@
 s = 'x' * 3;
 s = "abc" * 3;
-s = ("Peter" + ' ') * 3;
+s = ("PETER" + ' ') * 3;
 \end{cfa}
 &
@@ -2682 +2682 @@
 "xxx"
 "abcabcabc"
-"Peter Peter Peter "
+"PETER PETER PETER "
 \end{cfa}
 \end{tabular}
@@ -2953 +2953 @@
 \begin{figure}
 \begin{cquote}
-\setlength{\tabcolsep}{15pt}
 \begin{tabular}{@{}l|l@{}}
 \multicolumn{1}{c}{\textbf{\CC}} & \multicolumn{1}{c}{\textbf{\CFA}} \\
@@ -2999 +2998 @@
 Hence, it is possible to convert a block of C string operations to \CFA strings just by changing the type @char *@ to @string@.
 \begin{cquote}
-\setlength{\tabcolsep}{15pt}
 \begin{tabular}{@{}ll@{}}
 \begin{cfa}
@@ -3028 +3026 @@
 A comparison with \CC string I/O is presented as a counterpoint to \CFA string I/O.
 
-The \CC ooutput ©<<© and input ©>>© operators are defined on type ©string©.
+The \CC output ©<<© and input ©>>© operators are defined on type ©string©.
 \CC output for ©char©, ©char *©, and ©string© are similar.
 The \CC manipulators are ©setw©, and its associated width controls ©left©, ©right© and ©setfill©.
 \begin{cquote}
-\setlength{\tabcolsep}{15pt}
 \begin{tabular}{@{}l|l@{}}
 \begin{C++}
@@ -3050 +3047 @@
 The \CFA manipulators are ©bin©, ©oct©, ©hex©, ©wd©, and its associated width control and ©left©.
 \begin{cquote}
-\setlength{\tabcolsep}{15pt}
 \begin{tabular}{@{}l|l@{}}
 \begin{cfa}
@@ -3079 +3075 @@
 Reading into a ©char© is safe as the size is 1, ©char *© is unsafe without using ©setw© to constraint the length (which includes ©'\0'©), ©string© is safe as its grows dynamically as characters are read.
 \begin{cquote}
-\setlength{\tabcolsep}{15pt}
 \begin{tabular}{@{}l|l@{}}
 \begin{C++}