projman/hlp/ru/tcl/glob.html

112 lines
4.5 KiB
HTML
Raw Normal View History

<!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN>
2015-10-19 13:27:31 +03:00
<html>
<head>
<title>glob</title>
</head>
<body>
<h1>glob</h1>
<p> Команда возвращает имена файлов, удовлетворяющих шаблону.
2015-10-19 13:27:31 +03:00
</p>
<h2>СИНТАКСИС</h2>
2015-10-19 13:27:31 +03:00
<pre>
<strong>glob</strong> ?<em>switches</em>? <em>pattern</em> ?<em>pattern</em>?
</pre>
<h2>ОПИСАНИЕ</h2>
2015-10-19 13:27:31 +03:00
<p> Команда <strong>glob</strong> выполняет поиск имен файлов подобно тому,
как это делает оболочка csh, и возвращает список имен,
удовлетворяющих шаблону <em>pattern</em>. Аргументы, начинающиеся
со знака <strong>-</strong>, являются управляющими ключами <em>switches</em>.
2015-10-19 13:27:31 +03:00
</p>
<p>Возможные ключи: </p>
2015-10-19 13:27:31 +03:00
<dl>
<dt> <strong>-nocomplain</strong> </dt>
<dd> Позволяет вернуть пустой список без генерации ошибки. Если
ключ не задан, то при пустом списке формируется ошибка.
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong>--</strong></dt>
<dd> Означает конец ключей. Аргумент после этого ключа считается
шаблоном, даже если он начинается с <strong>-</strong>.
2015-10-19 13:27:31 +03:00
</dd>
</dl>
<p>Шаблоны могут включать следующие специальные символы: </p>
2015-10-19 13:27:31 +03:00
<table>
<tbody>
<tr>
<td><strong>?</strong></td>
<td>Удовлетворяет любому символу;</td>
2015-10-19 13:27:31 +03:00
</tr>
<tr>
<td><strong>*</strong></td>
<td>Удовлетворяет любой последовательности из нуля или
больше символов;</td>
2015-10-19 13:27:31 +03:00
</tr>
<tr>
<td><strong>[chars]</strong></td>
<td>Удовлетворяет любому символу из <em>chars</em>. Если
<em>chars</em> включает последовательность символов типа
<em>a-b</em>, то удовлетворяет всем символам от <em>a</em> до
<em>b</em> (включительно).
2015-10-19 13:27:31 +03:00
</td>
</tr>
<tr>
<td><strong>\x</strong></td>
<td>Удовлетворяет символу <strong>x</strong>.</td>
2015-10-19 13:27:31 +03:00
</tr>
<tr>
<td><strong>{a,b,...}</strong></td>
<td>Удовлетворяет любой из строк <em>a</em>, <em>b</em>,> и т.д.</td>
2015-10-19 13:27:31 +03:00
</tr>
</tbody>
</table>
<p>Как и в csh, символ <strong>.</strong> в начале имени файла или сразу
после <strong>/</strong> должен соответствовать явно или с помощью
конструкции <strong>{}</strong>.</p>
2015-10-19 13:27:31 +03:00
<p>Если первый символ образца <strong>~</strong>, то он указывает на
домашний каталог пользователя, чье имя указано после
<strong>~</strong>. Если сразу после <strong>~</strong> идет <strong>/</strong>, то
используется значение переменной окружения HOME.</p>
2015-10-19 13:27:31 +03:00
<p>Действие команды <strong>glob</strong> отличается от работы в csh в
следующем:</p>
2015-10-19 13:27:31 +03:00
<ul>
<li>она не сортирует составленный ей список;</li>
2015-10-19 13:27:31 +03:00
<li>она возвращает имена только существующих файлов (в csh
проверку наличия файлов надо задавать отдельно, если только
шаблон не содержит символов <strong>?</strong>, <strong>*</strong>, или
2015-10-19 13:27:31 +03:00
<strong>[]</strong>).</li>
</ul>
<h2>ОСОБЕННОСТИ РАБОТЫ НА РАЗЛИЧНЫХ ПЛАТФОРМАХ</h2>
2015-10-19 13:27:31 +03:00
<p> В отличие от другихTcl-команд команда <strong>glob</strong> может
работать с именами файлов только в нотации, поддерживаемой на
той платформе, на которой она исполняется. Кроме того, на
Windows-платформах специальные символы не допустимы в сетевых
именах.
2015-10-19 13:27:31 +03:00
</p>
</body>
</html>