Руководство по регулярным выражениям (Regex): различия между версиями

Текущая версия от 03:18, 5 июня 2024

Эта страница должна быть пересмотрена/обновлена

Эта статья содержит устаревшие данные, необходимо сверить и обновить информацию.
Причина: Мы уже давно используем ТГчат, в нём регулярки работают немного иначе

Regex (сокр. от Regular expressions - Регулярные выражения) - это способ поиска подтекста в тексте. Он позволит вам искать более сложные выражения и даст вам больше свободы в выборе того, что выделить. Однако он немного сложен для полного понимания за один раз. Смотрите ниже примеры использования строк regex. По умолчанию в игре Regex нечувствителен к регистру.

Полезным инструментом для тестирования вашей regex-строки является этот сайт.

Настройка

Чтобы открыть окно настроек Regex нажмите шестеренку в окне чата. И в появившемся списке кликните Highlight string.

Как добраться до Regex

Игра предоставляет вам два способа использования системы регулярных выражений.

Простой способ

Пример простого ввода

Убедитесь, что чекбокс Enable Regex выключен. И просто вводите, в одно из полей, через пробел, желаемые слова, которые хотите выделить в чате. Этот способ наиболее элементарный. Но имеет недостатки.

Существует непреодолимый недостаток системы Regex, на текущий момент, это выделение части букв из других слов. Например введя слово маг, он будет выделять часть слова Магомед, бумага и любых других слов содержащих указанную последовательность букв. А также чувствителен к орфографическим ошибкам. Если вы зададите для выделения слово детектив, а в чате будет написано декектив, то оно выделено не будет.

Отчасти, справиться с этими недостатками можно используя регулярные выражения ниже.

Сложный способ

Сложный способ подразумевает использование синтаксиса регулярных выражений. Все доступные регулярные выражения представлены в справочнике BYOND Regex. Также вы можете посмотреть на YouTube руководства по Regex, что существенно упростит понимание нижеописанного.

Ниже будут приведены полезные для игры примеры.

в[^ ]+п[^ ]+р - хорошее регулярное выражение для выделения слова вампир.

Разберём это выражение подробнее:

[^ ] - выражение которое ищет любой символ исключая пробел

+ - ищет любое количество символов согласно предыдущему выражению. В данном случае это значит, что между символами В и П может быть любое количество, любых символов исключая пробелы.

Фактически для данное выражение можно представить так: в*п*р где, * - это любые символы (кроме пробела), в любом количестве.

Пример работы Regex рассчитанный на слово "вампир"

Комбинация Regex выражений

Если вы решите создать много Regex выражений для названий антагонистов и их сленг-синонимов, то строк представленных в окне Regex вам не хватит. Для решения указанной проблемы можно комбинировать множество выражений в одной строке:

Пример комбинирования для слов вампир и генокрад: (в[^ ]+п[^ ]+р|[^ ]+н[^ ]+к[^ ]+д)

Таблица готовых Regex выражений

Таблица с регулярными выражениями для наиболее часто употребляемых слов (будет пополняться, возможно)
Слово для выделения	Regex синтакс
генокрад	[^ ]+н[^ ]+к[^ ]+д
вампир	в[^ ]+п[^ ]+р

Настройка цвета выделения

В нижней части окна предоставлена возможность изменить цвет выделения слов. Ввод цвета производится в шестнадцатеричной системе (HEX). Цвета можно подобрать по этой ссылке.

@@ Строка 1: / Строка 1: @@
-==Вступление==
+{{Needsrevision|reason = Мы уже давно используем ТГчат, в нём регулярки работают немного иначе}}
-Настройка двигателя - это сложный процесс, поэтому не работайте один, лучше с командой инженеров, чтобы быть уверенным в том, что процесс включения пройдет гладко. Если вы не уверены в своих возможностях при настройке этого двигателя, и нет никого, кто мог бы вам помочь, подумайте сначала о настройке [[Solars|солнечных панелей]], чтобы у станции была энергия, а вы могли проводить процесс обучения в своем собственном темпе.
+Regex (сокр. от Regular expressions - Регулярные выражения) - это способ поиска подтекста в тексте. Он позволит вам искать более сложные выражения и даст вам больше свободы в выборе того, что выделить. Однако он немного сложен для полного понимания за один раз. Смотрите ниже примеры использования строк regex. По умолчанию в игре Regex нечувствителен к регистру.
-Работа с атмосферой кажется фантастикой для большинства людей, но просто внимательное ознакомление с [[Guide to Atmospherics|данным руководством]] очень поможет в ней разобраться.
-=='''ДИСКЛЕЙМЕР'''==
-Представленное ниже руководство по настройке предназначено для использования чистого N2, поэтому, несмотря на возможность использования различных составов газовой смеси, настройка, скорее всего, потребует оптимизации. При использовании плазмы или CO2 перенастройка особенно необходима.
+Полезным инструментом для тестирования вашей regex-строки является [https://regex101.com/ '''этот сайт.''']
 ==Настройка==
-===Защитная экипировка===
+Чтобы открыть окно настроек Regex нажмите шестеренку в окне чата. И в появившемся списке кликните <code>Highlight string</code>'''.'''
-Чтобы избежать облучения кристаллом суперматерии, вам нужно будет надеть противорадиационный костюм (radiation suit), а также пару мезонных очков (meson goggles).
+[[Файл:Regex1.png|без|обрамить|Как добраться до Regex]]
+Игра предоставляет вам два способа использования системы регулярных выражений.
-Если вы этого не сделаете, вас '''облучит'''. Если вас облучит, вы получите повреждения от токсинов, будете облучать других сотрудников, а также начнете видеть галлюцинации. Если вы будете видеть галлюцинации и продолжать работу в отсеке двигателя, то они будут становится более мощными при приближении к СМ или при увеличении мощности СМ.
+===Простой способ===
+[[Файл:Regex2.png|мини|591x591пкс|Пример простого ввода]]
-===Настройка СМ на Box Station===
-====Газовый контур====
-[[File:SuperMatterGasLoopGuide.png|thumb|460x460px|альт=|Отсек СМ на Box Station]]
-#Установите каждый насос (pump), представленный на картинке зелёным цветом, а также фильтры (filter), также окрашенные в зеленый, на выходную мощность 4500 кПа. В качестве альтернативы можно заменить насосы (pump) обычными трубами (фильтры заменять трубами настоятельно не рекомендуется).
-#После этого вы захотите отключить газовые насосы, обведённые на картинке красным (забыв, что именно так вы разгоните двигатель суперматерии).
-===Настройка СМ на Delta Station===
-====Газовый контур====
-#Сперва убедитесь, что все насосы обозначенные красным цветом выключены. Затем установите 2 балона с азотом (обозначены зеленым справа) на предусмотренные порты (обозначены зеленым справа от двери в активную зону).  Как альтернативу канистрам с азотом вы можете использовать прямую подачу азота из атмосферного отсека. Достаточно будет установки давления в 100-150 кПа на насосе (обозначен оранжевым цветом).
-#Следующим шагом включите на полную мощность фильтр отходов (обозначен зеленым справа вверху), настроив его на фильтрацию азота (N2), чтобы все газы кроме азота уходили дальше по трубе в космос, а сам азот возвращался в контур по трубе в бок.
-#Включите на полную мощность фильтр сборщика газов (обозначен синим слева от двери в активную зону), настроив его на пропуск всех газов (Nothing). Либо вы можете выбрать какой-то интересующий вас газ, кроме охладителя и выбрать его. В таком случае вам понадобятся пустые канистры для его сбора, они стоят неподалеку (обозначены синим слева) - просто подключите их к портам (так же обозначены синим).
-#Открутите портативные скраббер и помпу от портов (обозначены бордовым справа)
-#Включите на полную мощность насосы обозначенные зеленым цветом. Контур начнет заполнятся азотом.
-===Сборщики радиации===
-Возьмите плазменные баллоны и поместите их в радиационные сборщики (radiation collector) непосредственно за пределами камеры СМ, а затем включите их, чтобы можно было производить электроэнергию. Как правило, рекомендуется заполнять эти резервуары полностью, например, с помощью канистры с плазмой (1012кПа - это максимум в маленьком баллоне). Если они не заполнены, будьте готовы к тому, что вам придётся их заменять в течении смены, хотя это не приведет к отслоению СМ или подобным событиям само по себе, отдел ксенобиологии будет очень недоволен нехваткой энергии.
-===Запуск двигателя===
-#Теперь приступите к настройке воздушной сигнализации активной зоны (supermatter engine air alarm).
-#Нажмите на "vent controls" и установите мощность каждой вентиляции на 2000, а также убедитесь, что они установлены на BLOWING. Если существует риск отслаивания суперматерии или при сифоне скрабберов стоит установить вентиляции на 0, а также на режим INTERNAL.
-#Следом, нажмите на "scrubber controls" и установите всем скрубберам очистку всех газов. (Отклонение от этого приведёт к накоплению горячих газов в камере. Если вы хотите, как написано в пункте 2 настроить вентиляции на 0 и на INTERNAL, то скрубберы должны настраиваться на "siphon", а радиус на "extended")
-#Установите вход SMESов на максимальное значение, а выход - чуть ниже него. Имейте в виду, что эмиттеры питаются от SMESов, поэтому если они не обеспечивают достаточной мощностью станцию и эмиттеры, то последние перестанут стрелять.
-#При желании, вы можете подключить больше эмиттеров и отражателей.
-#Включите эмиттеры и наблюдайте за тем, как происходит волшебство. Рекомендуется активировать по одному эмиттеру за раз и наблюдать за последствиями, прежде чем включать больше.
-==Техническое обслуживание==
-СРП предписывают, что если эмиттеры стреляют, то двигатель должен находиться под постоянным контролем. Кроме того, необходимо периодически проверять, правильно ли настроены фильтры, насосы и воздушная сигнализация. Проконсультируйтесь с другим инженерно-техническим персоналом, если обнаружена нестандартная конфигурация.
-===Чек-лист монитора СМ===
-#Убедитесь, что давление ниже 500 кПа.
-#Убедитесь, что температура ниже 310 кельвинов.
-#Убедитесь, что коэффициент энергетической эффективности (EER) менее 3000 МэВ/см3.
-#Убедитесь, что первичный охлаждающий газ (обычно N2) составляет более 90%.
-===Что если EER слишком высокий===
-#Выключите все эмиттеры.
-#Слейте немного газа, чтобы ограничить газ в контуре. Сделайте так, чтобы нижние фильтры не пропускали никакой газ, и не имели при этом внешнего входа. Не делайте этого слишком долго, иначе не хватит охлаждающих газов для СМ, чтобы она стабилизировалась. Если используется любой другой газ, кроме N2, влейте большое количество N2. Это легче всего сделать, отфильтровав использованный газ, например, чистый CO2, при закачке вместо него N2, и отфильтровав N2 обратно в камеру, до тех пор, пока СМ не станет стабильной. Имейте в виду, что слишком большое количество любого газа, будет вызывать более высокое излучение энергии, поэтому не допускайте, чтобы объем также уменьшился.
-===Что если давление слишком высокое===
-#Выключите все эмиттеры.
-#Убедитесь, что все насосы и фильтры работают на максимуме. Убедитесь, что все сифоны рядом с СМ установлены на "siphon", а радиус на "extended". Убедитесь, что все вентиляции рядом с СМ установлены на максимум.
-#С помощью анализаторов определите давление в контуре охлаждение и состав газов.
-#Если в системе слишком много азота, настройте фильтры на N2 и слейте излишки в канистры.
-#Если в голубых трубах газ отличный от азота, то проверьте настройки фильтров.
-===Что если температура слишком высокая===
+Убедитесь, что чекбокс <code>Enable Regex</code> выключен. И просто вводите, в одно из полей, через пробел, желаемые слова, которые хотите выделить в чате. Этот способ наиболее элементарный. Но имеет недостатки.
-#Выключите все эмиттеры.
+Существует непреодолимый недостаток системы Regex, на текущий момент, это выделение части букв из других слов. Например введя слово '''маг,''' он будет выделять часть слова '''<mark>Маг</mark>омед, бу<mark>маг</mark>а''' и любых других слов содержащих указанную последовательность букв. А также чувствителен к орфографическим ошибкам. Если вы зададите для выделения слово '''детектив,''' а в чате будет написано '''декектив,''' то оно выделено не будет.
-#Убедитесь, что все насосы и фильтры работают на максимуме. Убедитесь, что все скрабберы рядом с СМ установлены на "siphon", а радиус на "extended". Убедитесь, что все вентиляции рядом с СМ установлены на максимум.
-#Влейте холодный N2 в контур охлаждающих газов, чтобы снизить температуру. (При правильной настройке скрабберы должны автоматически выкачать новый газ, при попадании в камеру СМ)
-==Расслоение==
+Отчасти, справиться с этими недостатками можно используя регулярные выражения ниже.
-<q>Помогите...</q>
-Несмотря на то, что это может вызвать достаточную панику, расслоение СМ обычно длительный процесс и даёт время, чтобы его можно было зафиксировать, или, по крайней мере, ограничить повреждения. Выполните шаги "технического обслуживания", перечисленные выше, для всех трех видов - тепла, энергии и давления, перед тем как попытаться использовать крайнюю меру, приведённую ниже.
+===Сложный способ===
+Сложный способ подразумевает использование синтаксиса регулярных выражений. Все доступные регулярные выражения представлены в справочнике [https://www.byond.com/docs/ref/#/{notes}/regex '''BYOND Regex''']. Также вы можете посмотреть на [https://www.youtube.com/results?search_query=regex '''YouTube руководства по Regex'''], что существенно упростит понимание нижеописанного.
-При слишком большой мощности, температуре или давлении кристалл начинает терять целостность. Если он достигнет нуля, он расслоится.
+Ниже будут приведены полезные для игры примеры.
-===Показатели, приводящие к расслоению===
+'''в[^ ]+п[^ ]+р''' - хорошее регулярное выражение для выделения слова '''вампир.'''
-#При достижении EER 5000 МэВ/см3 / 1800 молей газа в контуре/при слишком большом давлении в камере - начнётся расслоение.
+Разберём это выражение подробнее:
-#При достижении EER выше 5000 МэВ/см3, СМ станет излучать дуги и вызывать аномалии. Это явный признак расслоения.
-#При слишком большом излучении энергии кристалл будет создавать больше газа, что может привести к возгоранию и увеличению температуры, подкреплённому повреждением суперматерии.
-#По мере приближения к фактическому событию расслоения, вы регулярно будете слышать автоматические предупреждения, чтобы успеть стабилизировать кристалл.
-#Когда ваше время закончится, то кристал расслаивается и произойдёт одна из трёх вещей. Если в камере было более 1800 молей газа - суперматерия схлопнется в самый опасный подвид сингулярности. Если EER был больше 5000 МэВ/см3, то СМ превратится в теслу, если ни первое, ни второе не превышало верхнюю границу, то произойдёт достаточно сильный взрыв.
-===Аномалии===
+'''[^ ]''' - выражение которое ищет любой символ исключая пробел
-Если, как было сказано выше, значение МэВ/см3 будет выше 5000, СМ будет порождать определенные аномалии:
-*Gravitational: притягивает находящихся рядом живых существ, а также предметы.
+'''+''' - ищет любое количество символов согласно предыдущему выражению. В данном случае это значит, что между символами '''В''' и '''П''' может быть любое количество, любых символов исключая пробелы.
-*Flux: бьёт током всё до чего коснётся.
-*Pyro: наполняет комнату горящей плазмой и порождает враждебных красных и оранжевых слаймов.
-Излучение, исходящее от кристалла, и галлюцинации будут увеличиваться.
+Фактически для данное выражение можно представить так: '''в*п*р''' где, * - это любые символы (кроме пробела), в любом количестве.
+[[Файл:Regex3.png|без|обрамить|Пример работы Regex рассчитанный на слово "вампир"]]
-===Точка невозврата===
+==== Комбинация Regex выражений ====
+Если вы решите создать много Regex выражений для названий антагонистов и их сленг-синонимов, то строк представленных в окне Regex вам не хватит. Для решения указанной проблемы можно комбинировать множество выражений в одной строке:
-Если обычные шаги по техническому обслуживанию не увенчались успехом и суперматерия прошла точку невозврата. Существуют некоторые заключительные шаги по ограничению последствий расслоения. Прежде всего, взрыв - это единичное событие, хотя и большое, но не продолжающееся, как это происходит при тесле или сингулярности. Первое, что вы должны сделать, это убедиться, что условия для возникновения теслы или сингулярности не выполняются. Во-вторых, вы захотите ограничить взрыв СМ, предполагая, что вам удалось воспрепятствовать возникновению вышеописанных событий. Тесла порождается, если EER выше 5000 МэВ/см3, который будет быстро падать, если у СМ нет газа для излучения энергии. С другой стороны, сингулярность нуждается в определенной плотности газа, которого не будет, если нет газа. Взрыв основан на типе, а также на количестве газа вокруг кристалла. Все это достигается одним действием, высасываем через дыру в полу, сделанную через RCD.
+Пример комбинирования для слов '''вампир''' и '''генокрад:''' (в[^ ]+п[^ ]+р|[^ ]+н[^ ]+к[^ ]+д)
-#Наденьте что-нибудь с огнестойкостью и магнитные ботинки (Это не гарантирует, что вы выживите, но может помочь вам выжить достаточно долго, чтобы быть героем, которого помнят только призраки).
+==== Таблица готовых Regex выражений ====
-#Убедитесь, что магнитные ботинки включены (Если вы этого не сделаете, вы будете засасываться в кристалл и испаритесь).
+{| class="wikitable" style="text-align: center;"
-#УБЕДИТЕСЬ, ЧТО МАГНИТНЫЕ БОТИНКИ ВКЛЮЧЕНЫ (Нет, серьезно, вы исчезните)
+|+Таблица с регулярными выражениями для наиболее часто употребляемых слов
-#Используйте RCD для деконструкции пола под СМ (Вам нужно использовать ALT + ЛКМ по полу, иначе при применении RCD по суперматерии - RCD исчезнет)
+(будет пополняться, возможно)
-#'''БЕГИ''' (Если можешь)
+|- style="font-weight: bold; text-align: center; background-color: chocolate; color: white;"
+| style="width: 250pt; center;" |Слово для выделения
+| style="width: 150pt; center;" |Regex синтакс
+|-
+!'''генокрад'''
+|[^ ]+н[^ ]+к[^ ]+д
+|-
+!'''вампир'''
+|в[^ ]+п[^ ]+р
+|}
-==Саботаж==
+===Настройка цвета выделения===
-'''Если вы не антаг с целью на угон (hijack), то вы определенно должны использовать ahelp, прежде чем связываться с двигателем СМ.'''
+В нижней части окна предоставлена возможность изменить цвет выделения слов. Ввод цвета производится в [[google:цвет+шестнадцатеричный+код|'''шестнадцатеричной системе (HEX)''']]. Цвета можно подобрать по этой [[ColorPalette|'''ссылке''']].
+[[Категория:Руководства]]