% This macro source file is from the four volume series
% "TeX in Practice" by Stephan von Bechtolsheim, published
% 1993 by Springer-Verlag, New York.
% Copyright 1993 Stephan von Bechtolsheim.
% No warranty or liability is assumed.
% This macro may be copied freely if no fees other than
% media cost or shipping charges are charged and as long
% as this copyright and the following source code itself
% is not changed. Please see the series for further information.
%
% Version: 1.0
% Date: May 1, 1993
%
%
% This source code is documented in 19.2.2, p. III-78.
% Original source in file "tokens2.TEX", starting line 640.
\wlog{L: "csar.tip" ["tokens2.TEX," l. 640, p. III-78]}%
% This file DOES belong to format "texip."
\InputD{doloop.tip}
\InputD{rangetst.tip}
\InputD{compst.tip}
\InputD{strleng.tip}
\catcode`\@ = 11
\newcount\@CreateArrayCount
\def\CCreateArray #1#2#3{%
   \NameEdef{#1-low}{\number#2}%
   \NameEdef{#1-high}{#3}%
   \ifnum #3<#2
       \errmessage{\string\CCreateArray: low array boundary
           \number#2 is larger than upper array boundary
           \number#3}%
   \fi
   \DoLoop{\@CreateArrayCount}{#2}{1}{#3}{%
       \NameDef{#1-\the\@CreateArrayCount}{}%
   }
}
\newcount\@ConvertStringIntoArrayLength
\newcount\@ConvertStringIntoArrayCount
\def\ConvertStringIntoArray #1#2{%
   \def\@ConvertArrayName{#1}%
   \edef\@ConvertArrayString{#2}%
   \StringLength{\@ConvertArrayString}%
   \@ConvertStringIntoArrayLength = \StringLengthResult
   \advance\@ConvertStringIntoArrayLength by -1
   \CCreateArray{\@ConvertArrayName}%
       {0}{\the\@ConvertStringIntoArrayLength}%
   \@ConvertStringIntoArrayCount = 0
   \expandafter\@ConvertStringIntoArray
       \@ConvertArrayString\@ConvertEnd
}
\def\@ConvertStringIntoArray #1#2\@ConvertEnd{%
   \CLoadArrayElementEdef{\@ConvertArrayName}%
       {\the\@ConvertStringIntoArrayCount}{#1}%
   \if\EmptyStringConditional{#2}%
       \def\@ConvertStringIntoArrayNext{}%
   \else
       \advance\@ConvertStringIntoArrayCount by 1\relax
       \def\@ConvertStringIntoArrayNext{%
           \@ConvertStringIntoArray #2\@ConvertEnd%
       }%
   \fi
   \@ConvertStringIntoArrayNext
}
\def\CCheckIndex #1#2{%
   \expandafter\ifx\csname #1-low\endcsname\relax
       \errmessage{\string\CCheckIndex: no array #1.}%
   \fi
   \ifnum #2<\NameUse{#1-low}%
       \errmessage{Index #2 for array #1 too small.}%
   \fi
   \ifnum #2>\NameUse{#1-high}%
       \errmessage{Index #2 for array #1 too large.}%
   \fi
}
\def\CArrayAccess #1#2#3{%
   \CCheckIndex{#1}{#2}%
   \edef#3{\NameUse{#1-#2}}%
}
\newcount\@CArrayAccessIntervalCount
\def\CArrayAccessInterval #1#2#3#4{%
   \CCheckIndex{#1}{#2}%
   \CCheckIndex{#1}{#3}%
   \ifnum #2>#3\relax
       \errmessage{\string\CArrayAccessInterval: low index
           (\PoundSignText 2) > high index
           (PoundSignText 3).}%
   \fi
   \def#4{}%
   \DoLoop
       {\@CArrayAccessIntervalCount}{#2}{1}{#3}{%
       \CArrayAccess{#1}{\the\@CArrayAccessIntervalCount}%
           {\@CArrayAccessInterval}%
       \edef#4{#4\@CArrayAccessInterval}%
   }%
}
\def\CLoadArrayElement #1#2#3{%
   \CCheckIndex{#1}{#2}%
   \NameDef{#1-#2}{#3}%
}
\def\CLoadArrayElementEdef #1#2#3{%
   \CCheckIndex{#1}{#2}%
   \NameEdef{#1-#2}{#3}%
}
\newcount\@CShowArrayCount
\def\CShowArray #1{%
   \DoLoop
       {\@CShowArrayCount}%
       {\NameUse{#1-low}}%
       {1}%
       {\NameUse{#1-high}}%
       {\wlog{Index \the\@CShowArrayCount:
           \NameUse{#1-\the\@CShowArrayCount}}}%
}
\catcode`\@ = 12