[back] [prev] [next] [index] [root]

<p>&nbsp;<p>
<hr noshade size="5">
<h2><a name="SScan"></a>
SScan
</h2>

Reads kash objects out of a string.

<p><p>

<h3>
Syntax:
</h3>
<pre>L := SScan( s, fmt, R1, R2, ...);</pre>

<p>

<table>
<tr>
<td>list</td>
<td><pre>  L  </pre></td>
<td>containing the kash objects</td>
</tr>
<tr>
<td>string</td>
<td><pre>  s  </pre></td>
<td></td>
</tr>
<tr>
<td>string</td>
<td><pre>  fmt  </pre></td>
<td>format string</td>
</tr>
<tr>
<td>rings</td>
<td><pre>  R1, R2  </pre></td>
<td></td>
</tr>
</table>

<p>


See also:&nbsp;&nbsp;<a href="kashref.html#SPrint">SPrint</a>, <a href="kashref.html#SScan">SScan</a>

<p>

<h3>
Description:
</h3>
Supported kash objects are: integers (<tt> \%Z</tt>), reals (<tt> \%R</tt>),
logicals (<tt> \%B</tt>), polynomials (<tt> \%P</tt>) and algebraic elements
(<tt> \%E</tt>);
also the usual standard C-format is supported. If you want to scan an
algebraic element resp. a polynomial you have to pass the order
resp. the polynomial algebra as parameter to the <tt> SScan</tt> function.
For a better understanding see the detailed list of examples
below.

<p><p>

<p>
<hr>
<p>
<h3>
Example:
</h3>
reading a list of integers
<pre>

kash> L := SScan("111, 12, 13","%Z,%Z,%Z");
[ 111, 12, 13 ]


</pre>

<p>

<p>
<hr>
<p>
<h3>
Example:
</h3>
reading an algebraic element
<pre>

kash> o := OrderMaximal(Z,2,5);;
kash> L := SScan("alpha: [0,27]/12 ","alpha: %E",o);
[ [0, 9] / 4 ]


</pre>

<p>

<p>
<hr>
<p>
<h3>
Example:
</h3>
or
<pre>

kash> L := SScan("alpha: [0,27]/12 ","%s %E",o);
[ "alpha:", [0, 9] / 4 ]


</pre>

<p>

<p>
<hr>
<p>
<h3>
Example:
</h3>
reading a logical and a polynomial and a real
<pre>

kash> s := "true, 17*x^3 + 14*x +2, 2.1382";;
kash> fmt := "%B,%P,%R";;
kash> L := SScan(s, fmt, Zx);
[ true, 17*x^3 + 14*x + 2, 2.1382 ]


</pre>

<p>

<p>
<hr>
<p>
<h3>
Example:
</h3>
and now an interesting example
<pre>

kash> s := "foobar : foobar 17*x^3 + 14*x +2, 2.1382";;
kash> fmt := "%s : %s %P,%R";;
kash> L := SScan(s, fmt, Zx);
> [ "foobar", "foobar", 17*x^3 + 14*x + 2, 2.1382 ]

</pre>

<p>


<hr>

<p>
<a href="../kashref.html"><- back</a>[back] [prev] [next] [index] [root]