projman/hlp/ru/tcl/string.html

189 lines
9.8 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>string</title>
</head>
<body>
<h1>string</h1>
<p>Команда для работы со строками.</p>
2015-10-19 13:27:31 +03:00
<h2>СИНТАКСИС</h2>
2015-10-19 13:27:31 +03:00
<pre>
<strong>string</strong> <strong>option</strong> <em>arg</em> ?<em>arg</em>...?
</pre>
<h2>ОПИСАНИЕ</h2>
2015-10-19 13:27:31 +03:00
<p>Выполняет одну из перечисленных ниже строковых операций в
зависимости от заданной опции <em>option</em>.</p>
2015-10-19 13:27:31 +03:00
<dl>
<dt><a name=string compare></a><strong>string</strong> <strong>compare</strong>
2015-10-19 13:27:31 +03:00
<em>string1</em> <em>string2</em></dt>
<dd>Выполняет посимвольное сравнение строк <em>string1</em> и <em>
string2</em> так же, как С-процедура <strong>strcmp</strong>. Возвращает
<strong>-1, 0</strong> или <strong>1</strong>, в зависимости от того, будет ли
строка <em>string1</em> больше, равна или меньше (при
лексикографическом сравнении) строки <em> string2</em>.
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string first></a>string</strong> <strong>first</strong>
2015-10-19 13:27:31 +03:00
<em>string1</em> <em>string2</em></dt>
<dd>Ищет в строке <em>string2</em> последовательность символов, в
точности совпадающую со <em>string1</em>. Если такая
последовательность есть, возвращает индекс первой буквы в
первой найденной последовательности. В противном случае
возвращает -1.
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string index></a>string</strong> <strong>index</strong> <em>string</em>
2015-10-19 13:27:31 +03:00
<em>charIndex</em></dt>
<dd>Возвращает <em>charIndex</em>-ный символ в строке <em>
string</em>. Значение <em>charIndex</em>, равное 0,
соответствует первому символу в строке. Если значение <em>
charIndex</em> меньше 0 или не меньше длины строки
- возвращает пустую строку.
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string last></a>string</strong> <strong>last</strong>
2015-10-19 13:27:31 +03:00
<em>string1</em> <em>string2</em></dt>
<dd>Ищет в строке <em>string2</em> последовательность символов, в
точности совпадающую со <em>string1</em>. Если такая
последовательность есть, возвращает индекс первой буквы в
последней найденной последовательности. В противном случае
возвращает -1.
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string length></a>string</strong> <strong>length</strong>
2015-10-19 13:27:31 +03:00
<em>string</em></dt>
<dd>Возвращает десятичную строку, содержащую число символов в
строке.
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string match></a>string</strong> <strong>match</strong>
2015-10-19 13:27:31 +03:00
<em>pattern</em> <em>string</em></dt>
<dd><p>Проверяет, соответствует ли строка образцу. Возвращает
1, если соответствует, и 0 - в противном
случае. Соответствие проверяется примерно так же, как в
C-shell. Строка соответствует шаблону, если они совпадают
посимвольно, за исключением перечисленных ниже специальных
случаев:</p>
2015-10-19 13:27:31 +03:00
<table>
<tbody>
<tr>
<td>*</td>
<td>Удовлетворяет любой последовательности из нуля
или больше символов;</td>
2015-10-19 13:27:31 +03:00
</tr>
<tr>
<td>?</td>
<td>Удовлетворяет любому символу;</td>
2015-10-19 13:27:31 +03:00
</tr>
<tr>
<td><strong>[<em>chars</em>]</strong></td>
<td> Удовлетворяет любому символу из <em>chars</em>. Если
<em>chars</em> включает последовательность символов типа
<em>a-b</em>, то удовлетворяет всем символам от <em>a</em>
до <em>b</em> (включительно).</td>
2015-10-19 13:27:31 +03:00
</tr>
<tr>
<td>\x</td>
<td>Удовлетворяет символу x. Обеспечивает возможность
избежать в шаблонах специального смысла символов *, ?,
2015-10-19 13:27:31 +03:00
[, ], \.</td>
</tr>
</tbody>
</table>
</dd>
<dt><strong><a name=string range></a>string</strong> <strong>range</strong> <em>string</em>
2015-10-19 13:27:31 +03:00
<em>first</em> <em>last</em></dt>
<dd>Возвращает подстроку строки <em>string</em>, начиная с символа
с индексом <em>first</em> и кончая символом с индексом
<em>last</em>. Индекс <strong>0</strong> указывает на первый символ
строки. Индекс <strong>end</strong> (или любое его сокращение) указывает
на последний символ строки. Если значение <em>first</em> меньше
<strong>0</strong>, используется значение <strong>0</strong>. Если <em>last</em>
больше значения индекса последнего символа в строке,
используется значение <strong>end</strong>. Если <em>first</em> больше,
чем <em>last</em>, команда возвращает пустую строку.
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string tolower></a>string</strong> <strong>tolower</strong>
2015-10-19 13:27:31 +03:00
<em>string</em></dt>
<dd>Возвращает строку, тождественную <em>string</em>, за
исключением того, что все символы верхнего регистра в ней
переведены в нижний регистр.
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string toupper></a>string</strong> <strong>toupper</strong>
2015-10-19 13:27:31 +03:00
<em>string</em></dt>
<dd>Возвращает строку, тождественную <em>string</em>, за
исключением того, что все символы нижнего регистра в ней
переведены в верхний регистр.
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong>string</strong> <strong>trim</strong> <em>string</em> ?<em>chars</em>?</dt>
<dd>Возвращает строку, тождественную <em>string</em>, за исключением
того, что из нее удалены все начальные и конечные символы,
входящие в <em>chars</em>. Если аргумент <em>chars</em> не указан,
удаляются пробельные символы (пробелы, табуляция, символы
новой строки).
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string trimleft></a>string</strong> <strong>trimleft</strong>
2015-10-19 13:27:31 +03:00
<em>string</em> ?<em>chars</em>? </dt>
<dd>Возвращает строку, тождественную <em>string</em>, за
исключением того, что из нее удалены все начальные символы,
входящие в <em>chars</em>. Если аргумент <em>chars</em> не указан,
удаляются пробельные символы (пробелы, табуляция, символы
новой строки).
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string trimleft></a>string</strong> <strong>trimright</strong>
2015-10-19 13:27:31 +03:00
<em>string</em> ?<em>chars</em>? </dt>
<dd>Возвращает строку, тождественную <em>string</em>, за
исключением того, что из нее удалены все конечные символы,
входящие в <em>chars</em>. Если аргумент <em>chars</em> не
указан, удаляются пробельные символы (пробелы, табуляция,
символы новой строки).
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string wordend></a>string</strong> <strong>wordend</strong>
2015-10-19 13:27:31 +03:00
<em>string</em> <em>index</em></dt>
<dd>Возвращает индекс символа, идущего сразу после последнего
символа в слове, содержащем <em>index</em>-ный символ строки
<em>string</em>. Словом считается любая непрерывная
последовательность из букв, цифр и символа подчеркивания,
или любой другой одиночный символ.
2015-10-19 13:27:31 +03:00
</dd>
<dt><strong><a name=string wordstart></a>string</strong> <strong>wordstart</strong>
2015-10-19 13:27:31 +03:00
<em>string</em> <em>index</em></dt>
<dd>Возвращает индекс первого символа в слове, содержащем
<em>index</em>-ный символ строки <em>string</em>. Словом считается
любая непрерывная последовательность из букв, цифр и символа
подчеркивания, или любой другой одиночный символ.
2015-10-19 13:27:31 +03:00
</dd>
</dl>
</body>
</html>