149 lines
6.1 KiB
HTML
149 lines
6.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<title>scan</title>
|
||
</head>
|
||
<body>
|
||
<h1>scan</h1>
|
||
|
||
<p>Производит разбор строки в стиле процедуры <strong>sscanf</strong>.</p>
|
||
|
||
<h2>СИНТАКСИС</h2>
|
||
|
||
<pre>
|
||
<strong>scan</strong> <em>string</em> <em>format</em> <em>varName</em> ?<em>varName</em>...?
|
||
</pre>
|
||
|
||
<h2>ВВЕДЕНИЕ</h2>
|
||
|
||
<p>Данная команда, подобно ANSI C процедуре <strong>sscanf</strong>,
|
||
просматривает строку <em>string</em>, выбирает поля и преобразует
|
||
их в соответствии с очередным спецификатором преобразования в
|
||
строке <em>format</em>. Выбранные значения преобразуются обратно в
|
||
строковый вид и последовательно записываются в переменные
|
||
<em>varName</em>.</p>
|
||
|
||
<h2>ПРОЦЕСС СКАНИРОВАНИЯ</h2>
|
||
|
||
<p>Команда <strong>scan</strong> просматривает одновременно строки
|
||
<em>string</em> и <em>format</em>. Если очередной символ в строке
|
||
<em>format</em> пробел или табуляция, то он соответствует любому
|
||
числу (включая ноль) пробельных символов (пробел, табуляция,
|
||
новая строка) в строке <em>string</em>. Если в строке
|
||
<em>format</em> встретился символ <strong>%</strong>, он означает начало
|
||
очередного спецификатора преобразования. Спецификатор
|
||
преобразования включает в себя до трех полей после символа
|
||
<strong>%</strong>: первое поле может содержать символ <strong>*</strong>,
|
||
означающий, что преобразуемая величина будет удалена, а не
|
||
записана в очередную переменную, второе поле может содержать
|
||
число, указывающее максимальную ширину поля, и третье поле
|
||
содержит букву, определяющую тип преобразования. Обязательным
|
||
является только третье поле.</p>
|
||
|
||
<p>Когда команда <strong>scan</strong> находит спецификатор
|
||
преобразования в строке <em>format</em>, она пропускает
|
||
пробельные символы в строке <em>string</em>. Затем она выбирает
|
||
следующую группу непробельных символов и преобразует их в
|
||
соответствии со спецификатором преобразования и записывает
|
||
результат в переменную, соответствующую следующему аргументу
|
||
команды. Поддерживаются следующие типы преобразований,
|
||
задаваемые соответствующими символами:</p>
|
||
|
||
<dl>
|
||
<dt><strong>d</strong></dt>
|
||
|
||
<dd>Входное поле должно быть десятичным числом. Результат
|
||
записывается как десятичная строка.</dd>
|
||
|
||
<dt><strong>o</strong></dt>
|
||
|
||
<dd>Входное поле должно быть восьмеричным числом. Результат
|
||
преобразуется в десятичную строку.</dd>
|
||
|
||
<dt><strong>x</strong></dt>
|
||
|
||
<dd>Входное поле должно быть шестнадцатеричным числом.
|
||
Результат преобразуется в десятичную строку.</dd>
|
||
|
||
<dt><strong>c</strong></dt>
|
||
|
||
<dd>Читается один символ, его двоичная величина преобразуется и
|
||
записывается в переменную как десятичная строка. Начальные
|
||
пробельные символы в этом случае не пропускаются. В отличие от
|
||
ANSI C процедуры <strong>sscanf</strong> входное поле всегда состоит
|
||
ровно из одного символа, а ширина поля не может быть
|
||
задана.</dd>
|
||
|
||
<dt><strong>s</strong></dt>
|
||
|
||
<dd>Входное поле состоит из всех непробельных символов до
|
||
следующего пробельного. Все символы копируются в
|
||
переменную.</dd>
|
||
|
||
<dt><strong>e</strong> или <strong>f</strong> или <strong>g</strong></dt>
|
||
|
||
<dd>Входное поле должно быть числом с плавающей точкой,
|
||
состоящим из знака (не обязательно), строки десятичных цифр,
|
||
возможно с десятичной точкой и порядка (не обязательно),
|
||
состоящего из буквы <strong>e</strong> или <strong>E</strong>, знака порядка (не
|
||
обязательно) и строки десятичных цифр.</dd>
|
||
|
||
<dt><strong>[<em>chars</em>]</strong></dt>
|
||
|
||
<dd>Входное поле состоит из произвольного числа символов из
|
||
<em>chars</em>. Соответствующая строка записывается в
|
||
переменную. Если первый символ в скобках <strong>]</strong>, то он
|
||
рассматривается как часть <em>chars</em>, а не как закрывающая
|
||
скобка для множества символов.</dd>
|
||
|
||
<dt><strong>[^<em>chars</em>]</strong></dt>
|
||
|
||
<dd>Входное поле состоит из произвольного числа символов, не
|
||
содержащихся в <em>chars</em>. Соответствующая строка
|
||
записывается в переменную. Если первый символ в скобках после
|
||
<strong>^</strong> есть <strong>]</strong>, то он рассматривается как
|
||
часть <em>chars</em>, а не как закрывающая скобка для множества
|
||
символов.</dd>
|
||
</dl>
|
||
|
||
<p>Число символов, которое выбирается для преобразования, это
|
||
максимально возможное число символов для соответствующего
|
||
преобразования (например, так много десятичных цифр, как это
|
||
возможно для <strong>%d</strong>, или так много восьмеричных цифр, как это
|
||
возможно для <strong>%o</strong>). Поле, выбираемое для очередного
|
||
преобразования, закрывается, как только в строке <em>string</em>
|
||
встречается пробельный символ или как только поле достигает
|
||
указанного максимального размера (в зависимости от того, что
|
||
происходит раньше). Если в спецификаторе преобразования для
|
||
очередного поля присутствует символ <strong>*</strong>, то выбранное
|
||
значение не присваивает никакой переменной, а очередной аргумент
|
||
команды <strong>scan</strong> по-прежнему считается неиспользованным.</p>
|
||
|
||
<h2>ОТЛИЧИЯ ОТ ANSI SSCANF</h2>
|
||
|
||
<p>Поведение команды <strong>scan</strong> не отличается от поведения ANSI
|
||
C процедуры <strong>sscanf</strong> за исключением следующих моментов:</p>
|
||
<table>
|
||
<tr>
|
||
<td>[1]</td>
|
||
<td>Спецификаторы <strong>%p</strong> и <strong>%n</strong> не поддерживаются.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>[2]</td>
|
||
<td>Для спецификатора <strong>%c</strong> нельзя указывать ширину
|
||
поля. Только один символ переводится в десятичную
|
||
величину, которая и присваивается соответствующей
|
||
переменной.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>[3]</td>
|
||
<td>Модификаторы <strong>l</strong>, <strong>h</strong> и <strong>L</strong> игнорируются. Целые
|
||
числа преобразуются так, как будто никакого модификатора
|
||
не было задано, а действительные числа - как при
|
||
модификаторе <strong>l</strong>, то есть с использованием типа
|
||
<strong>double</strong> для внутреннего представления.</td>
|
||
</tr>
|
||
</table>
|
||
</body>
|
||
</html>
|