diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/aai.html ./doc/aai.html *** ../StreamDevice-2-1/doc/aai.html Thu Jan 1 01:00:00 1970 --- ./doc/aai.html Mon Jun 12 10:53:47 2006 *************** *** 0 **** --- 1,124 ---- + + +
+
+ With aai records, the format converter is applied to
+ each element. Between the elements, a separator is printed
+ or expected as specified by the Separator
+ variable in the protocol.
+ When parsing input, a space as the first character of the
+ Separator
matches any number of any whitespace
+ characters.
+
+ During input, a maximum of NELM
elements is
+ read and NORD
is updated accordingly.
+ Parsing of elements stops when the separator does not match,
+ conversion fails, or the end of the input is reached.
+ A minimum of one element must be available.
+
+ During output, the first NORD
elements are
+ written.
+
+ The format data type must be convertible to or from the type
+ specified in the FTVL
field.
+ The variable x[i]
stands for one element of
+ the written or read value.
+
%f
):x[i]=double(VAL[i])
FTVL
can be "DOUBLE"
, "FLOAT"
,
+ "LONG"
, "ULONG"
, "SHORT"
,
+ "USHORT"
, "CHAR"
, "UCHAR"
,
+ or "ENUM"
(which is treated as "USHORT"
).VAL[i]=FTVL(x[i])
FTVL
must be "FLOAT"
or "DOUBLE"
+ %i
or %{
):x[i]=long(VAL[i])
FTVL
can be
+ "LONG"
, "ULONG"
, "SHORT"
,
+ "USHORT"
, "CHAR"
, "UCHAR"
,
+ or "ENUM"
(which is treated as "USHORT"
).VAL[i]=FTVL(x[i])
FTVL
can be "DOUBLE"
, "FLOAT"
,
+ "LONG"
, "ULONG"
, "SHORT"
,
+ "USHORT"
, "CHAR"
, "UCHAR"
,
+ or "ENUM"
(which is treated as "USHORT"
).FTVL
has a smaller data size than long
.
+ %s
):FTVL=="STRING"
:x[i]=VAL[i]
VAL[i]=x[i]
FTVL=="CHAR"
or FTVL="UCHAR"
:NORD
.
+ No separators are printed or expected.x=range(VAL,0,NORD)
NORD
characters are printed,
+ which might be less than NELM
.VAL=x, NORD=length(x)
NELM-1
characters can be read.
+ NORD
is updated to the index of the first of the
+ trailing zeros.
+ Usually, this is the same as the string length.
+ FTVL
are not allowed for this format.
+
+ During initialization, the @init
handler is executed, if
+ present. All format converters work like in normal operation.
+
+ aao + ai + ao + bi + bo + mbbi + mbbo + mbbiDirect + mbboDirect + longin + longout + stringin + stringout + calcout + scalcout +
+Dirk Zimoch, 2006
+ + + diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/aao.html ./doc/aao.html *** ../StreamDevice-2-1/doc/aao.html Thu Jan 1 01:00:00 1970 --- ./doc/aao.html Mon Jun 12 10:53:47 2006 *************** *** 0 **** --- 1,124 ---- + + + +
+ With aao records, the format converter is applied to
+ each element. Between the elements, a separator is printed
+ or expected as specified by the Separator
+ variable in the protocol.
+ When parsing input, a space as the first character of the
+ Separator
matches any number of any whitespace
+ characters.
+
+ During output, the first NORD
elements are
+ written.
+
+ During input, a maximum of NELM
elements is
+ read and NORD
is updated accordingly.
+ Parsing of elements stops when the separator does not match,
+ conversion fails, or the end of the input is reached.
+ A minimum of one element must be available.
+
+ The format data type must be convertible to or from the type
+ specified in the FTVL
field.
+ The variable x[i]
stands for one element of
+ the written or read value.
+
%f
):x[i]=double(VAL[i])
FTVL
can be "DOUBLE"
, "FLOAT"
,
+ "LONG"
, "ULONG"
, "SHORT"
,
+ "USHORT"
, "CHAR"
, "UCHAR"
,
+ or "ENUM"
(which is treated as "USHORT"
).VAL[i]=FTVL(x[i])
FTVL
must be "FLOAT"
or "DOUBLE"
+ %i
or %{
):x[i]=long(VAL[i])
FTVL
can be
+ "LONG"
, "ULONG"
, "SHORT"
,
+ "USHORT"
, "CHAR"
, "UCHAR"
,
+ or "ENUM"
(which is treated as "USHORT"
).VAL[i]=FTVL(x[i])
FTVL
can be "DOUBLE"
, "FLOAT"
,
+ "LONG"
, "ULONG"
, "SHORT"
,
+ "USHORT"
, "CHAR"
, "UCHAR"
,
+ or "ENUM"
(which is treated as "USHORT"
).FTVL
has a smaller data size than long
.
+ %s
):FTVL=="STRING"
:x[i]=VAL[i]
VAL[i]=x[i]
FTVL=="CHAR"
or FTVL="UCHAR"
:NORD
.
+ No separators are printed or expected.x=range(VAL,0,NORD)
NORD
characters are printed,
+ which might be less than NELM
.VAL=x, NORD=length(x)
NELM-1
characters can be read.
+ NORD
is updated to the index of the first of the
+ trailing zeros.
+ Usually, this is the same as the string length.
+ FTVL
are not allowed for this format.
+
+ During initialization, the @init
handler is executed, if
+ present. All format converters work like in normal operation.
+
+ aai + ai + ao + bi + bo + mbbi + mbbo + mbbiDirect + mbboDirect + longin + longout + stringin + stringout + calcout + scalcout +
+Dirk Zimoch, 2006
+ + + diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/ai.html ./doc/ai.html *** ../StreamDevice-2-1/doc/ai.html Wed May 24 14:53:13 2006 --- ./doc/ai.html Mon Jun 12 10:53:47 2006 *************** *** 58,63 **** --- 58,65 ----+ aai + aao ao bi bo diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/ao.html ./doc/ao.html *** ../StreamDevice-2-1/doc/ao.html Wed May 24 14:53:13 2006 --- ./doc/ao.html Mon Jun 12 10:53:47 2006 *************** *** 59,64 **** --- 59,66 ----
+ aai + aao ai bi bo diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/bi.html ./doc/bi.html *** ../StreamDevice-2-1/doc/bi.html Wed May 24 14:53:13 2006 --- ./doc/bi.html Mon Jun 12 10:53:47 2006 *************** *** 54,59 **** --- 54,61 ----
+ aai + aao ai ao bo diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/bo.html ./doc/bo.html *** ../StreamDevice-2-1/doc/bo.html Wed May 24 14:53:13 2006 --- ./doc/bo.html Mon Jun 12 10:53:47 2006 *************** *** 53,58 **** --- 53,60 ----
+ aai + aao ai ao bi diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/calcout.html ./doc/calcout.html *** ../StreamDevice-2-1/doc/calcout.html Wed May 24 16:15:06 2006 --- ./doc/calcout.html Mon Jun 12 10:53:47 2006 *************** *** 60,65 **** --- 60,67 ----
+ aai
+ aao
ai
ao
bi
diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/formats.html ./doc/formats.html
*** ../StreamDevice-2-1/doc/formats.html Mon Jun 12 11:09:02 2006
--- ./doc/formats.html Mon Jun 12 10:53:47 2006
***************
*** 142,148 ****
With the #
flag, output always contains a period character.
! In input all these formats are equivalent. Leading whitespaces are skipped.
--- 142,148 ---- With the#
flag, output always contains a period character.
! In input, all these formats are equivalent. Leading whitespaces are skipped.
diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/longin.html ./doc/longin.html *** ../StreamDevice-2-1/doc/longin.html Wed May 24 14:53:13 2006 --- ./doc/longin.html Mon Jun 12 10:53:47 2006 *************** *** 45,50 **** --- 45,52 ----+ aai + aao ai ao bi diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/longout.html ./doc/longout.html *** ../StreamDevice-2-1/doc/longout.html Wed May 24 14:53:13 2006 --- ./doc/longout.html Mon Jun 12 10:53:47 2006 *************** *** 45,50 **** --- 45,52 ----
+ aai + aao ai ao bi diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/mbbi.html ./doc/mbbi.html *** ../StreamDevice-2-1/doc/mbbi.html Wed May 24 14:53:13 2006 --- ./doc/mbbi.html Mon Jun 12 10:53:47 2006 *************** *** 71,76 **** --- 71,78 ----
+ aai + aao ai ao bi diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/mbbiDirect.html ./doc/mbbiDirect.html *** ../StreamDevice-2-1/doc/mbbiDirect.html Wed May 24 14:53:13 2006 --- ./doc/mbbiDirect.html Mon Jun 12 10:53:47 2006 *************** *** 57,62 **** --- 57,64 ----
+ aai + aao ai ao bi diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/mbbo.html ./doc/mbbo.html *** ../StreamDevice-2-1/doc/mbbo.html Wed May 24 14:53:13 2006 --- ./doc/mbbo.html Mon Jun 12 10:53:47 2006 *************** *** 72,77 **** --- 72,79 ----
+ aai + aao ai ao bi diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/mbboDirect.html ./doc/mbboDirect.html *** ../StreamDevice-2-1/doc/mbboDirect.html Wed May 24 14:53:13 2006 --- ./doc/mbboDirect.html Mon Jun 12 10:53:47 2006 *************** *** 59,64 **** --- 59,66 ----
+ aai + aao ai ao bi diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/nav.html ./doc/nav.html *** ../StreamDevice-2-1/doc/nav.html Wed May 24 14:53:13 2006 --- ./doc/nav.html Mon Jun 12 10:53:47 2006 *************** *** 125,130 **** --- 125,132 ---- Record Types
There is a separate page for each supported record type:
+ aai
+ aao
ai
ao
bi
***************
*** 30,37 ****
longout
stringin
stringout
- calcout
waveform
Each page describes which record fields are used in input and output --- 32,40 ---- longout stringin stringout waveform + calcout + scalcout
Each page describes which record fields are used in input and output diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/scalcout.html ./doc/scalcout.html *** ../StreamDevice-2-1/doc/scalcout.html Fri May 26 11:20:37 2006 --- ./doc/scalcout.html Mon Jun 12 10:53:47 2006 *************** *** 78,83 **** --- 78,85 ----
+ aai + aao ai ao bi diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/stringin.html ./doc/stringin.html *** ../StreamDevice-2-1/doc/stringin.html Wed May 24 14:53:13 2006 --- ./doc/stringin.html Mon Jun 12 10:53:47 2006 *************** *** 44,49 **** --- 44,51 ----
+ aai + aao ai ao bi diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/stringout.html ./doc/stringout.html *** ../StreamDevice-2-1/doc/stringout.html Wed May 24 14:53:13 2006 --- ./doc/stringout.html Mon Jun 12 10:53:47 2006 *************** *** 44,49 **** --- 44,51 ----
+ aai + aao ai ao bi diff -cPr --exclude=CVS --exclude=old ../StreamDevice-2-1/doc/waveform.html ./doc/waveform.html *** ../StreamDevice-2-1/doc/waveform.html Wed May 24 14:53:13 2006 --- ./doc/waveform.html Mon Jun 12 10:53:47 2006 *************** *** 102,107 **** --- 102,109 ----
+ aai + aao ai ao bi *************** *** 119,124 ****
Dirk Zimoch, 2005
-