<para>Редактор регулярных выражений предназначен для редактирования регулярных выражений в графическом виде (в отличие от текстовых строк). Традиционно, регулярные выражения имеют <acronym>ASCII</acronym>-синтаксис, к примеру: <literal>^.*kde\b</literal>. Основными недостатками данного стиля являются: <itemizedlist>
<listitem><para>Сложность применения для людей, не занимающихся программированием.</para></listitem>
<listitem><para>Необходимость <emphasis>экранировать</emphasis> определённые символы (например, чтобы использовать символ звёздочки, придётся набрать <literal>\*</literal>). </para></listitem>
<listitem><para>Необходимость постоянно помнить и соблюдать правила приоритетов выполнения - что делает операция <literal>x|y*</literal>? Значение <literal>x</literal> или множество <literal>y</literal>, <emphasis>ИЛИ</emphasis> множества <literal>x</literal> и <literal>y</literal> смешаны?</para></listitem>
<para>Редактор регулярных выражений позволяет <emphasis>рисовать</emphasis> регулярные выражения. Он позволяет решить проблемы, изложенные в пунктах два и три выше. Делает ли редактор простым и доступным использование регулярных выражений для всех — покажет практика. Если вы не программист, который мастерски манипулирует всей мощью регулярных выражений — <ulink url="mailto:blackie@kde.org">сообщите нам своё мнение</ulink>. </para>
<para>Регулярные выражения являются способом записи <emphasis>условий</emphasis>, которыми мы обычно мысленно описываем ситуацию. Обычно в текстовом редакторе для поиска вы используете какие-то <emphasis>конкретные</emphasis> строки, однако использование регулярных выражений позволяет описать: на что должен быть похожим искомый текст. К примеру, <emphasis>Я ищу слово KDE, стоящее только в начале строки</emphasis>, или <emphasis>Я ищу слово <literal>под</literal>, но только как слово целиком</emphasis>, или <emphasis>Я ищу файлы, начинающиеся со слова <literal>test</literal> и последующих цифр, к примеру <literal>test12</literal>, <literal>test107</literal> и <literal>test007</literal></emphasis></para>
<para>Регулярные выражения можно составлять из более мелких регулярных выражений, подобно тому как строятся большие дома из маленьких кирпичей. Так как в строительстве существует множество материалов, то далее мы постараемся на примерах рассказать об основных «кирпичах», тем самым заложив фундамент для построения регулярных выражений.</para>
<para>Оговоримся сразу, что регулярные выражения не являются наилучшим способом поиска конкретных строк в тексте. Причина кроется в том, что в регулярных выражениях некоторым символам присвоены специальные значения. Среди них следующие: <literal>.*|$</literal>. Таким образом, если вы хотите найти в тексте <literal>kde.</literal> (то есть слово <literal>kde</literal> с точкой), то придётся набрать <literal>kde\.</literal> <footnote><para>Редактор регулярных выражений выполнит все необходимые формальности за вас</para></footnote>, записав <literal>\.</literal> вместо <literal>.</literal>, то есть подставив <emphasis>управляющую последовательность</emphasis> (escape sequence, также это было названо экранированием выше) вместо символа. </para>
<para>При выделении текста похожего на URL в KDE программа <command>klipper</command>, если она настроена соответствующим образом, предложить вам открыть этот URL при помощи <command>konqueror</command>.</para>
<para><command>Klipper</command> осуществляет свой выбор, руководствуясь результатами сопоставления нескольких регулярных выражений, и когда одно из регулярных выражений совпадает с искомым, тогда и будет предложен подходящий вариант.</para>
<para>Регулярное выражение для URL содержит (помимо всего прочего) условие, что текст должен начинаться с <literal>http://</literal>. С помощью регулярного выражения это условие можно описать следующим образом: <literal>http://</literal> со «шляпой» (с символом <literal>^</literal>).</para>
<para>Предыдущий пример показывает, как с помощью регулярных выражений можно указать расположение искомого фрагмента в тексте (сравнение по позиции). Аналогично можно указать на то, что искомый фрагмент находится <emphasis>в конце строки </emphasis>, для этого используется символ <literal>$</literal> (символ доллара).</para>
<title>Поиск слова <literal>the</literal>, но не <emphasis>the</emphasis><literal>re</literal>, <literal>brea</literal><emphasis>the</emphasis> или <literal>ano</literal><emphasis>the</emphasis><literal>r</literal></title>
<para>По образу и подобию вышеизложенного могут быть указаны ещё два дополнительных условия при поиске, а именно: позиция <emphasis>на границе слова</emphasis> (в начале, либо конце) и <emphasis>не на границе слова</emphasis>. Для обозначения этих условий применяются обозначения <literal>\b</literal> (указание на границу слова) и <literal>\B</literal> (не на границе слова). <emphasis></emphasis></para>
<para>Таким образом, слово <literal>the</literal> можно найти, воспользовавшись регулярным выражением <literal>\bthe\b</literal>. Этим мы указываем, что ищем просто слово <literal>the</literal> без каких-бы то ни было «довесков» перед и после слова (т.ес границами по каждой из сторон фразы).</para>
<para>Все четыре типа указания на расположение, использующиеся в регулярных выражениях, включены в редактор, см. <link linkend="positiontool"> четыре различных типа расположения</link></para>
<title>Поиск всех <literal>this</literal> или <literal>that</literal></title>
<para>Представьте себе, что вы хотите найти в документе слово <literal>this</literal> или слово <literal>that</literal>. При обычном поиске вам необходимо сделать два прохода: в первый произвести поиск слова <literal>this</literal>, во второй — <literal>that</literal>.</para>
<para>Используя регулярные выражения, сделать всё это можно за один приём. Для этого запишите выражение следующим образом: <literal>this|that</literal>, т.е. разделите оба искомых слова вертикальной чертой.<footnote><para>Обратите внимание, что по обе стороны от вертикальной черты могут находиться не только искомые слова, но и два регулярных выражения.</para></footnote></para>
<para>В редакторе регулярных выражений вы не вводите вручную вертикальную черту, а активируете инструмент <link linkend="altntool">Варианты</link> и вводите регулярные выражения в отдельные поля.</para>
<para>Регулярные выражения часто сравнивают с шаблоном, использующемся в командном интерпретаторе (оболочке), где можно выбрать несколько файлов, используя звёздочку. Вы без всякого сомнения узнаете шаблон в следующих примерах: <itemizedlist>
<listitem><para><literal>ls *.txt</literal> — здесь <literal>*.txt</literal>является шаблоном, указывающим на то, что необходимо показать все файлы с расширением <literal>.txt</literal></para></listitem>
<listitem><para><literal>cat test??.res</literal> — вывод всех файлов, имена которых начинаются с <literal>test</literal>, за которым следуют два любых символа, и заканчиваются на <literal>.res</literal>.</para></listitem>
<para>В оболочке звёздочка указывает, что любой символ может встретиться в названии любое количество раз, другими словами, звёздочка означает <emphasis>всё, что угодно</emphasis>. В регулярном выражении подобное условие задаётся при помощи записи <literal>.*</literal>. Точка указывает, что может быть <emphasis>один</emphasis> произвольный символ, в свою очередь звёздочка сообщает, что предыдущее регулярное выражение может повторяться любое количество раз. Вместе они задают условие поиска: любой единичный символ может быть встречен произвольное количество раз.</para>
<para>Это может на первый взгляд показаться чрезмерно сложным, но когда вы увидите всю картину работы регулярных выражений, то сможете по достоинству оценить всё их изящество. Позвольте продемонстрировать ещё одно основное выражение: <literal>a</literal>. Эта запись указывает, что регулярное выражение ищет соответствие одиночному символу <literal>a</literal>. Если объединить эту запись со звёздочкой, т.е. <literal>a*</literal>, то получится регулярное выражение соответствующее любому количеству символов «a» подряд.</para>
<para>Можно объединять несколько регулярных выражений последовательно, например <literal>ba(na)*</literal>. Запись <footnote><para><literal>(na)*</literal> указывает, что строка в скобках может повторяться любое количество раз</para></footnote>. Представьте себе, что работая в текстовом редакторе, необходимо найти следующие слова: <literal>ba</literal>, <literal>bana</literal>, <literal>banana</literal>, <literal>bananananananana</literal> </para>
<para>Как сказано выше, не составляет труда записать шаблон оболочки: <literal>test??.res</literal> через регулярное выражение: <literal>test..\.res</literal>. Точка означает любой символ. Для того чтобы указать, что нужна именно точка, вы должны записать <literal>\.</literal><footnote><para> Здесь использована управляющая последовательность</para></footnote>. Во всех словах регулярное выражение <literal>\.</literal> означает собственно точку, а просто точка — соответствие любому символу в данной позиции. </para>
<para>В редакторе регулярных выражений повторяющиеся выражения могут быть вставлены с использованием инструмента <link linkend="repeattool">Повторение</link> </para>
<title>Замена <literal>&</literal> на <literal>&amp;</literal> в документе HTML.</title> <para>Для показа на странице HTML специального символа <literal>&</literal>, его необходимо записывать как <literal>&amp;</literal> — по аналогии с тем, как происходит замена служебных символов на управляющие последовательности в регулярных выражениях.</para>
<para>Представьте себе, что вы набрали документ HTML в обычном текстовом редакторе (XEmacs, Kate или Notepad), и полностью забыли про эти правила. Для того чтобы устранить ошибку, необходимо заменить все символы <literal>&</literal> на <literal>&amp;</literal>.</para>
<para>Эта операция может быть достаточно просто реализована с использованием традиционных средств поиска и замены, однако возможны некоторые осложнения. Представьте себе, что что вы периодически вспоминали об этих правилах, т.е. <emphasis>местами</emphasis> у вас записано правильно. В этом случае все ошибочные варианты будут заменены на правильные <literal>&amp;</literal>, а в тех местах, где было записано правильно, возникнет новая ошибка: <literal>&amp;amp;</literal></para>
<para>На самом деле вы хотите произвести замену записи <literal>&</literal> только в том случае, если за ней <emphasis>не</emphasis> стоит <literal>amp;</literal>. Для этого нужно задать ограничение на <emphasis>контекст</emphasis> (т.е. то, что будет непосредственно после найденного текста). </para>
<para>Для того чтобы указать, при котором за искомым текстом не должно стоять <literal>amp;</literal>, необходимо записать следующее выражение: <literal>&(?!amp;)</literal>. Гораздо проще всё будет выглядеть в редакторе регулярных выражений, если вы воспользуетесь инструментом <link linkend="lookaheadtools"> Упреждающий поиск по отрицанию</link>.</para>
<para>Наиболее важной частью редактора является область редактирования: это область, в который вы рисуете регулярные выражения. Область имеет серый цвет и расположена в центре окна редактора.</para>
<para>Выше области редактирования расположены две панели инструментов. Первая панель содержит <link linkend="editingtools">средства редактирования</link> и очень похожа на инструменты для рисования в графических программах. Вторая панель содержит кнопку <emphasis>Что это?</emphasis> и кнопки отмены и повтора.</para>
<para>Ниже области редактирования находится строка регулярного выражения в текстовом (ASCII) виде. Все изменения, вносимые в графическом редакторе переносятся в текстовую форму. Если вы захотите поправить регулярное выражение в текстовом виде, то все изменения также будут внесены в графическое представление.</para>
<para>Наконец, слева от области редактирования есть много заготовок регулярных выражений. Они служат для достижения двух целей: (1) когда вы используете редактор, эти выражения являются более <emphasis>качественными</emphasis> или, если хотите, более исчерпывающими, заменяя общие регулярные выражения. На рисунке выше вы можете увидеть, как текстовое представление «.*» заменяется на шаблонное «всё что угодно».(2) Вы можете использовать эти заготовки в качестве строительного материала для построения своих регулярных выражений. За более исчерпывающей информацией обратитесь к разделу <link linkend="userdefinedregexps">Регулярные выражения, определяемые пользователями</link>, где содержится подробная информация о том, как сохранить ваши собственные регулярные выражения.</para>
<para>В этой главе предполагается, что вы изучили главу <link linkend="whatIsARegExp">Что такое регулярные выражения ?</link> и имеете представление, о чём идёт речь.</para>
<para>Выделение предназначено для обозначения элементов, подлежащих копированию, вставке или перетаскиванию. Выделение работает также как и в обычных программах для работы с графикой.</para>
<para>Используя этот инструмент, вы можете вставить обычный текст, при этом не заботясь о необходимости экранирования специальных символов. Далее в примере будет создано регулярное выражение: <literal>abc\*\\\)</literal></para>
<para>Используя этот инструмент, вы определяете области символов. К примеру, что в тексте содержатся символы <literal>[0-9]</literal>, <literal>[^a-zA-Z,_]</literal>. Если вы воспользовались данным инструментом, то должен появиться диалог, в котором определяются области символов.</para>
<para>Повторяющиеся элементы (квалификаторы). Включают в себя звёздочку (*), плюс (+), знак вопроса (?) и интервал ({3,5}). Если вы используете этот инструмент, то появится диалог, в котором вы должны указать необходимое количество повторов.</para>
<para>Повторяемые элементы выражения можно взять извне, затем поместить в квадрат. Также вы можете сперва нарисовать то что потом должно будет быть повторено, а затем выбрать инструмент повторения. И наоборот: вы можете сперва вставить символ повторения (квалификатор), а затем нарисовать внутри него повторяемое. </para>
<para>Задание альтернативы — это использование оператора (|). Вы рисуете другой вариант поверх имеющегося, после того как в редакторе появится новая рамка для ввода.</para>
<para>Этот инструмент — не регулярное выражение. Оно позволяет группировать блоки для того, чтобы вы могли их легко использовать, руководствуясь только названиями. Это видно в правой части рисунка.</para>
<para>Инструменты начала и конца строк указывают на соответствие условиям начала и конца строки. Регулярное выражение в приведённом выше примере окна редактора не содержит операторов соответствия началу или концу строк.</para>
<para>Инструментальные средства границ позволяют задавать условия соответствие границам или содержимому слова. Регулярное выражение, изображённое на рисунке, совпадает с любыми словами, начинающимися с <literal>the</literal>. Само слово <literal>the</literal> однако не совпадает с этим условием.</para>
<para>См. описание в разделе <link linkend="boundaryregexp">Границы слов в регулярных выражениях</link>.</para>
<para>Запрет или разрешение того, чтобы после найденного текста шёл текст, отвечающий указанному шаблону. Этот текст, тем не менее, не будет являться частью результата.</para>
<para>Примечание: разрешается устанавливать такие условия только в конце регулярного выражения. Редактор регулярных выражений не следит за этим.</para>
<para>Слева от области редактирования расположен список регулярных выражений, определяемых пользователем. Несколько регулярных выражений занесено в этот список непосредственно после установки KDE, тогда как другие вы можете внести и сохранить самостоятельно.</para>
<para>Данные регулярные выражения обеспечивают достижение двух целей: (см. <link linkend="screenorganization">более подробное описание</link>), а именно: 1) Обеспечивают блоки для компоновки регулярных выражений 2) делают регулярные выражения более понятными.</para>
<para>Вы можете сохранить ваши собственные регулярные выражения, щёлкнув правой кнопкой мыши в области редактирования и выбрав пункт <literal>Сохранить регулярное выражение</literal> в появившемся меню.</para>
<para>Если регулярное выражение сохраняется в составе <link linkend="compoundtool">контейнера</link>, то оно может участвовать в создании последующих регулярных выражений.</para>
<para>Регулярные выражения, определяемые пользователем, могут быть переименованы или удалены щелчком правой кнопки мыши на их названии в списке и выбором соответствующего пункта в появившемся меню.</para>
<para>Замеченные ошибки и пожелания направляйте в <ulink url="http://bugs.trinitydesktop.org/">систему отслеживания ошибок</ulink>, но <emphasis role="strong">сначала убедитесь</emphasis> в том, что подобная ошибка ещё не была <ulink url="http://bugs.trinitydesktop.org/simple_search.cgi?id=kregexpeditor">зафиксирована</ulink>.</para>
<title>Я являюсь автором программы для KDE, как я могу использовать ваш редактор в своём приложении?</title>
<para>См. ссылку <ulink url="http://developer.kde.org/documentation/library/cvs-api/classref/interfaces/KRegExpEditorInterface.html">Документация для класса KRegExpEditorInterface</ulink></para>
<title>Я не могу найти кнопку <emphasis>Изменить</emphasis> регулярное выражение, допустим, в konqueror, после переустановки KDE 3. Почему?</title>
<para>Редактор регулярных выражений содержится в пакете tdeutils. Если вы не установили этот пакет, то кнопка <emphasis>Изменить</emphasis> регулярное выражение не появится в соответствующих программах.</para>
