Викиучебник:Общий форум

<mediawiki xmlns="http://www.mediawiki.org/xml/export-0.11/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mediawiki.org/xml/export-0.11/ http://www.mediawiki.org/xml/export-0.11.xsd" version="0.11" xml:lang="ru">
  <siteinfo>
    <sitename>Викиучебник</sitename>
    <dbname>ruwikibooks</dbname>
    <base>https://ru.wikibooks.org/wiki/%D0%97%D0%B0%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0</base>
    <generator>MediaWiki 1.47.0-wmf.24</generator>
    <case>first-letter</case>
    <namespaces>
      <namespace key="-2" case="first-letter">Медиа</namespace>
      <namespace key="-1" case="first-letter">Служебная</namespace>
      <namespace key="0" case="first-letter" />
      <namespace key="1" case="first-letter">Обсуждение</namespace>
      <namespace key="2" case="first-letter">Участник</namespace>
      <namespace key="3" case="first-letter">Обсуждение участника</namespace>
      <namespace key="4" case="first-letter">Викиучебник</namespace>
      <namespace key="5" case="first-letter">Обсуждение Викиучебника</namespace>
      <namespace key="6" case="first-letter">Файл</namespace>
      <namespace key="7" case="first-letter">Обсуждение файла</namespace>
      <namespace key="8" case="first-letter">MediaWiki</namespace>
      <namespace key="9" case="first-letter">Обсуждение MediaWiki</namespace>
      <namespace key="10" case="first-letter">Шаблон</namespace>
      <namespace key="11" case="first-letter">Обсуждение шаблона</namespace>
      <namespace key="12" case="first-letter">Справка</namespace>
      <namespace key="13" case="first-letter">Обсуждение справки</namespace>
      <namespace key="14" case="first-letter">Категория</namespace>
      <namespace key="15" case="first-letter">Обсуждение категории</namespace>
      <namespace key="100" case="first-letter">Полка</namespace>
      <namespace key="101" case="first-letter">Обсуждение полки</namespace>
      <namespace key="102" case="first-letter">Импортировано</namespace>
      <namespace key="103" case="first-letter">Обсуждение импортированного</namespace>
      <namespace key="104" case="first-letter">Рецепт</namespace>
      <namespace key="105" case="first-letter">Обсуждение рецепта</namespace>
      <namespace key="106" case="first-letter">Задача</namespace>
      <namespace key="107" case="first-letter">Обсуждение задачи</namespace>
      <namespace key="710" case="first-letter">TimedText</namespace>
      <namespace key="711" case="first-letter">TimedText talk</namespace>
      <namespace key="828" case="first-letter">Модуль</namespace>
      <namespace key="829" case="first-letter">Обсуждение модуля</namespace>
      <namespace key="1728" case="first-letter">Event</namespace>
      <namespace key="1729" case="first-letter">Event talk</namespace>
    </namespaces>
  </siteinfo>
  <page>
    <title>Викиучебник:Общий форум</title>
    <ns>4</ns>
    <id>1253</id>
    <revision>
      <id>270413</id>
      <parentid>270407</parentid>
      <timestamp>2026-10-26T14:01:17Z</timestamp>
      <contributor>
        <username>MediaWiki message delivery</username>
        <id>37025</id>
      </contributor>
      <comment>/* Переключение сервера: ваш вики-проект скоро на короткое время будет доступен в режиме «только для чтения» */ новая тема</comment>
      <origin>270413</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="84866" sha1="ppj93xmlig1q3dm0wicsujobt93hpsn" xml:space="preserve">{{Участник:Kylaixbot/ArchiveConfig
|archive = Викиучебник:Общий форум/Архив/%(year)d
|algo = old(60d)
|counter = 1
}}
{{Форум}}
{{Архив-П |2005-2007|2008|2009-2010|2011-2012|2013|2014|2015|2016|2018|2019|2020|2021|2022|2023|2024|2025}}
{{Актуально}}

== Что тут ==
Тут есть кто живой? — [[Участник:Medyanowsky|Medyanowsky]] ([[Обсуждение участника:Medyanowsky|обсуждение]]) 08:12, 13 октября 2026 (UTC)

:В чем вопрос? [[Участник:Def2010|Def2010]] ([[Обсуждение участника:Def2010|обсуждение]]) 17:07, 13 октября 2026 (UTC)
:Все живы! [[Участник:Erokhin|Erokhin]] ([[Обсуждение участника:Erokhin|обсуждение]]) 03:45, 25 октября 2026 (UTC)
Ну, тут Leksey и Kylain Aixter активны, я особо не редактирую, но на сообщения отвечаю. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 13:00, 14 октября 2026 (UTC)

== Извинения, что задержался ==
Извиняюсь, что закопался, но я чет своего бота @[[Участник:Kylaixbot|Kylaixbot]] не могу починить из-за приколов Тулфорджа. Они там обновили политику venv и у меня никак не получается нормально запустить моего бота. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:52, 14 июня 2026 (UTC)

:Я оказался достаточно оперативен и бот заработал [[Участник:Kylaixbot|Kylaixbot]] ([[Обсуждение участника:Kylaixbot|обсуждение]]) 14:27, 26 июля 2026 (UTC)
::Чем сейчас занят ваш бот? [[Участник:Erokhin|Erokhin]] ([[Обсуждение участника:Erokhin|обсуждение]]) 03:44, 25 октября 2026 (UTC)

== Шаблон может быть улучшен ==
По определению, большинство учебников пишут по книгам; шаблон Книга работает здесь безупречно. По стечению обстоятельств пришлось  использовать шаблон Статья. Видимо, он не точно соответствует этому шаблону в википедии: ISSN (и отчасти PMID и PMC) работает не так, как в википедии. А в [[Шаблон:Статья/Документация| документации]] не написано, что есть отличия (issn):

фрагмент кода: . . . место=Москва|год=2016|номер=8|issn=0131-2618|страницы=74—79|pmid=24006620|pmc=PMC1234567}} ISSN 0131-2618, PMID 24006620&lt;/ref&gt;

его отображение: Москва, 2016. — № 8. — С. 74—79. — ISSN Шаблон:ISSN search link. — Шаблон:PMID. — Шаблон:PMC. ISSN 0131-2618, PMID 24006620

+ сообщения ниже красным шрифтом: Шаблон:ISSN search link (править) ... Шаблон:PMID (править) ... Шаблон:PMC (править)

Если можно без больших трудозатрат устранить отличия в шаблонах от википедии, прошу Вас это сделать, как сможете. Спасибо [[Служебная:Вклад/&amp;#126;2026-31604-77|&amp;#126;2026-31604-77]] ([[Обсуждение участника:&amp;#126;2026-31604-77|обс.]]) 17:46, 29 мая 2026 (UTC)
: А можете где-то им воспользоваться и пингануть меня плиз? Я поправлю шаблон&lt;br&gt; P.s.: последний раз, судя по истории, я его и его подшаблоны импортировал в феврале 2025 года. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:50, 14 июня 2026 (UTC)

== Тип блюда (P8431 course) ==
в элементе викиданных, связанном со страницей рецепта, можно добавить поле Тип блюда (P8431 course). 

в викиданных данное свойство имеет ограниченное количество значений: закуска, первое блюдо, суп, салат, рыба, второе блюдо, десерт, соус, завтрак, пирог, гарнир... 

после указания в поле нужного значения, рецепт будет размещен в аналогичной категории.

но у нас в кулинарной книге есть аналогичные категории, только во множественном числе, например, Закуски, Вторые блюда, Салаты...

в результате получается двойная категоризация и двойное отображение в кулинарной книге.

есть идеи, что с этим можно сделать? переименовать в викиданных эти значения - перевести во множественное число? — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 16:00, 26 мая 2026 (UTC)
: Я не знаю [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:46, 28 мая 2026 (UTC)
: Оооо да! Я давно заметил это и в прошлых темах предлагал к обсуждению этот вопрос. Я сторонник стандарта Викиданных, банально потому что это стандартизировано под Википедию. Но вот другие что об этом думают? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:47, 14 июня 2026 (UTC)
:: Я за викиданные, но что делать - переименовывать или нет - не знаю. Есть возможсноть оставить в единственном числе в ВД, а категории иметь в множественном? [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 16:53, 15 июня 2026 (UTC)
::: Кажется нет. Это невозможно будет автоматизировать &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 00:09, 16 июня 2026 (UTC)

== Полки в Кулинарной книге ==
можно ли в кулинарной книге сделать еще одну корневую полку и как? например, полку Кулинарные процессы, аналогично Ингредиенты — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 13:59, 26 мая 2026 (UTC)
: И на этот вопрос я не знаю ответа [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:46, 28 мая 2026 (UTC)
: эээээ, можно...&lt;br&gt; но что там будет? Примерно? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:44, 14 июня 2026 (UTC)

== [[Викиучебник:Каталог учебников/Список]] ==
не обновляется — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 08:36, 22 мая 2026 (UTC)
: тэкс, значит бот мой сломался. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 13:34, 22 мая 2026 (UTC)

== [[Шаблон:К быстрому удалению|Шаблон:КБУ]] ==
как часто удаляются страницы, помеченные этим шаблоном?

их удаляет бот или админ вручную? — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 07:28, 22 мая 2026 (UTC)
: Админ. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:48, 22 мая 2026 (UTC)
:кто-то из админов или подводящих итоги может пройтись и удалить [https://ru.wikibooks.org/wiki/Служебная:Ссылки_сюда?target=Шаблон%3AК+быстрому+удалению&amp;namespace=&amp;limit=500 статьи с данным шаблоном] в основном пространстве и пространстве полок? частично это нужно, чтобы переименовать другие страницы + пустые страницы/полки. [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 08:25, 23 мая 2026 (UTC)
:: Ну, я не админ, надо Лексея пингануть @[[Участник:Leksey|Leksey]] [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 14:17, 24 мая 2026 (UTC)
:: Удалил!
:: @[[Участник:Kylaix|Kylaix]] посмотри, плиз, почему в категорию включило статьи, где только ссылка  на шаблон. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 21:49, 25 мая 2026 (UTC)
:::не могу переименовать [[Введение в дифференциальные уравнения]] в Дифференциальные уравнения - &quot;Переименование невозможно: страница с таким именем уже существует&quot;. но я не нашла такой страницы [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 09:56, 28 мая 2026 (UTC)
:::: Она в перенаправлении &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 17:12, 28 мая 2026 (UTC)
::::: [[Дифференциальные уравнения]] удалена и нет на этом месте перенаправления [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:42, 28 мая 2026 (UTC)
::::: там СО была и она мешала [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:44, 28 мая 2026 (UTC)
:::: переименовал [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:45, 28 мая 2026 (UTC)
:::аналогично не могу переименовать [[Постулат Бертрана]] в Теория чисел/Постулат Бертрана [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 09:57, 28 мая 2026 (UTC)
:::: переименовал [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:44, 28 мая 2026 (UTC)
::: @[[Участник:Leksey|Leksey]] Если в Ссылки сюда нажать кнопки Скрыть ссылки и Скрыть перенаправления , то будет показываться только включения, то есть только страницы которые надо удалить. Вот ссылка: https://ru.wikibooks.org/wiki/%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:%D0%A1%D1%81%D1%8B%D0%BB%D0%BA%D0%B8_%D1%81%D1%8E%D0%B4%D0%B0?target=%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%3A%D0%9A+%D0%B1%D1%8B%D1%81%D1%82%D1%80%D0%BE%D0%BC%D1%83+%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D1%8E&amp;namespace=&amp;hidelinks=1&amp;hideredirs=1&amp;limit=50 [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 11:11, 29 мая 2026 (UTC)

== Сколько уровней полок поддерживается? ==
например, в [[Викиучебник:Каталог учебников/Список]]? Сейчас только два уровня, например, Языки - Языки Европы. А может быть 3-й, 4-й и т.д уровни? — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 17:13, 21 мая 2026 (UTC)
: По идее - да, там вроде бесконечная вложенность, главное только правильно оформлять полки. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:50, 14 июня 2026 (UTC)

== [[Полка:Компьютеры]] ==
все доп. полки почему-то задублированы, например, Программирование фигурирует дважды — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 09:50, 21 мая 2026 (UTC)

:исправила через Править код [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 10:22, 21 мая 2026 (UTC)
: О, спасибо что убрали. Ранее они просто добавлялись в ручную. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 13:36, 22 мая 2026 (UTC)

== Не обновляются Полки ==
1. Дополнительные полки:
[[Полка:Теория чисел]], на ней лежит учебник [https://ru.wikibooks.org/wiki/Теория_чисел Теория чисел], но в учебнике в шаблоне Название учебника указана категория не Теория чисел, а Математика (я ее сделала доп. полкой на основной полке Формальные науки). почему учебник таки находится на данной полке? из-за того, что у него внизу указана категория Теория чисел?

аналогично [[Полка:Дифференциальные уравнения]], [[Полка:Математический анализ]], [[Полка:Алгебра]], [[Полка:Занимательная математика]].

2. Основные полки: [[Полка:Компьютеры]], [[Полка:Естественные науки]], [[Полка:Языки]], [[Полка:Досуг]], [[Полка:Техника]], [[Полка:Гуманитарные науки]]

существует ли бот, который обновляет полки? уже прошло несколько дней, но полки не обновились, кнопка Очистить кэш не помогает — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 07:55, 21 мая 2026 (UTC)

== [[Теория музыки для математиков]] ==
в шаблоне Название учебника две Категории - Музыка, Математика

но на полке [[Полка:Математика|Математика]] он не появляется

почему?

потому что это Основная полка?

нужно указать вместо нее Дополнительную полку в шаблоне? — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 18:24, 20 мая 2026 (UTC)
: Последнее верно. Это основная полка а требуется дополнительная полка. Я правда не знаю как ее можно было назвать, но раздел бы стоило создать. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:11, 20 мая 2026 (UTC)

== КУ ==
[[Викиучебник:К удалению/Май 2026]] Прошу всех обратить внимание. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:31, 20 мая 2026 (UTC)

:создала в вики страницу [[w:Биографический_метод|Биографический метод]]
:может, их связать? и поставить в учебнике шаблон, что это заготовка. может, кто заинтересуется и начнет наполнять учебник? [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 18:36, 20 мая 2026 (UTC)

== Полка и категория ==
чем отличается [[Полка:Математика]] от [https://ru.wikibooks.org/wiki/Категория:Математика Категория:Математика]? 

зачем нужны полки?

почему не ограничиться только категориями? 

например, сгласно полкам учебных пособий 2 шт, согласно категориям находится еще 100 шт учебных пособий ... — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 18:26, 19 мая 2026 (UTC)
: Категорию проставляют в статьях, на полке же список статей. К тому же, зачем традиции ломать? [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:32, 20 мая 2026 (UTC)
::выглядит, как дублирующий инструмент
::тем паче, что рецепты на категориях строятся [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 18:21, 20 мая 2026 (UTC)
::: Иронично что вы оба правы. Категории, по сути, помогают работе шаблонов и модулей для организации каталога учебников. А каталог учебников кажется сейчас наиболее удобным средством для поиска нужных книг. Было бы круто не использовать категории, но к сожалению иначе организовать полки было бы невозможно или, как минимум, труднее на порядок. Ну и да, + это еще и дань традициям - в Википедии, к примеру, они до сих пор используются.
::: Кстати, напоминаю, что категории в статьях проставляются через {{tl|Название учебника}} и для рецептов через {{tl|Рецепт}}. Касательно разницы в полках и категориях: просто те 98 учебников еще не обработаны через эти шаблоны. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:08, 20 мая 2026 (UTC)

== Страницы учебника на полке ==
на полке [[Полка:Математика|Математика]] есть полка [[Полка:Теория чисел|Теория чисел]]

на ней лежит учебник [[Теория чисел]]

и страница из учебника [[Теория чисел/Постулат Бертрана]]

что не есть правильно - на полке должны быть только учебники

аналогично на полке [[Полка:Дифференциальные уравнения|Дифференциальные уравнения]]

как удалить страницы учебника с полки? — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 07:03, 19 мая 2026 (UTC)
: Привет.&lt;br&gt; Я пока не знаю причину, ищу ошибку в шаблонах. Тем не менее, большая просьба либо создавать эти учебники уже на существующих полках, либо же переименовать их так, чтобы не совпадали с названием полки. Это может быть одной из причин. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 07:40, 19 мая 2026 (UTC)
:: Подтверждаю. Учебники не стоит называть одинаково с названием полки. Более того, не стоит создавать отдельные полки для каждого учебника. Я оставил лишь полку с теорией чисел, учебник про диффуры перенес в полку матанализа. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 08:01, 19 мая 2026 (UTC)
:::спасибо!
:::но дифференециальные уравнения - это не матан, это отдельный [[w:Разделы_математики#Математика_как_учебная_дисциплина|учебный раздел математики]]
:::поэтому для него была создана своя полка
:::иначе можно обойтись вообще без полок и все учебники размещать на полке Математика [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 09:05, 19 мая 2026 (UTC)
:::: Ну, я понимаю что его в целом выделяют, но тут проблема именно Викиучебника. У нас пока* мало книг и имеет смысл их пока отводить в гораздо более крупные разделы, чем это делается в науке.&lt;br&gt; &lt;nowiki&gt;*&lt;/nowiki&gt;надеюсь все же мы сможем хотя бы перевести достаточное количество книг, а еще лучше написать сами в ближайшее время. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 09:27, 19 мая 2026 (UTC)
:::::тогда можно сделать полку Другие разделы
:::::в нее отнести все, что не Алгебра и не Геометрия [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 09:30, 19 мая 2026 (UTC)
:::::: Хорошо, сделаю. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 09:41, 19 мая 2026 (UTC)
:::::::я все перенесла в Алгебру/Геометрию [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 13:05, 19 мая 2026 (UTC)
:::::::ненужные страницы пометила КБУ в пространствах - Основное, Полка [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 13:55, 19 мая 2026 (UTC)

== Как привязать учебник к другой полке? ==
например, [[Дифференциальные уравнения]] к полке [[Полка:Дифференциальные уравнения|Дифференциальные уравнения]]— [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 17:46, 17 мая 2026 (UTC)
: @[[Участник:Kylaix|Kylaix]] ответишь? [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:50, 17 мая 2026 (UTC)
:или достаточно в учебнике в шаблоне &quot;Название учебника&quot; указать нужные значения в Категория? и бот привяжет учебник, куда нужно? в какой время отрабатывает бот? явно, сразу не после правки Категория [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 10:02, 18 мая 2026 (UTC)
:: Да да да, в категорию просто вписываете полку и бот пройдет (один раз в день делает проходку) и ваша книга попадет на полку. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 14:44, 18 мая 2026 (UTC)

== CAPTCHA ==
при сохранении правок возникает:
CAPTCHA: Для редактирования страницы, пожалуйста, введите буквы, которые видны на изображении ниже

это из-за того, что я новичок? или так всегда будет?— [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 16:29, 17 мая 2026 (UTC)
: Никогда такого не видел. Конечно пройдет.
: А можете кинуть на почту скриншот leksey@ya.ru&lt;br&gt; Интересно посмотреть даже.
: Я посмотрю, может вам можно статус подкрутить руками, но вроде я такого не видел. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:49, 17 мая 2026 (UTC)
: Попытался поменять вам группу, но все что мне дает это. Наверное, когда вы попадете в группу &quot;Автоподтвержденные&quot;, то отпустит. Как это работает - я не знаю. У вас же по идее глобальный аккаунт и специально в Учебнике вы вчера условно не регились?
: {{Цитата|Группы, которые вы можете изменять&lt;ul&gt;&lt;li&gt;исключение из IP-блокировок&lt;/li&gt;&lt;li&gt;организаторка мероприятий&lt;/li&gt;&lt;/ul&gt;}} [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:55, 17 мая 2026 (UTC)
: Посмотрел у себя - я состою в неяавной группе [[Викиучебник:Автоподтверждённые участники]]
: 4 дня стажа хочет после отдельной регистрации в Викиучебнике
: {{Цитата|В случае регистрации [[w:Википедия:Единая_учётная_запись|в другом проекте]] фонда [[w:Викимедиа|Викимедиа]] и стаж, и правки отсчитываются в нашем разделе отдельно: эти статусы в разных проектах между собой не связаны.}} [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:57, 17 мая 2026 (UTC)
:: Вот и настройка, что за это отвечает https://noc.wikimedia.org/wiki.php?wiki=ruwikibooks#wgAutoConfirmAge [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 18:01, 17 мая 2026 (UTC)
: Пропала у вас капча? [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 19:01, 19 мая 2026 (UTC)

== [[Теория чисел]] ==
создала [[Полка:Теория чисел]], и учебник [[Теория чисел]]

но они не связаны, как их связать?— [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 19:47, 15 мая 2026 (UTC)

:уже связались [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 10:03, 18 мая 2026 (UTC)

== [[Полка:Теория чисел]] ==
создала [[Полка:Теория чисел]], но она не появилась визуально внутри [[Полка:Математика]]

что делать?— [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 19:45, 15 мая 2026 (UTC)

:Неудачно попробовал, может появится кто-то из админов. Подозреваю, что, возможно, там используются викиданные для этого, надо уточнить. [[Участник:Def2010|Def2010]] ([[Обсуждение участника:Def2010|обсуждение]]) 11:01, 16 мая 2026 (UTC)
:Как-то коряво добавил, список определяется страницей [[Викиучебник:Каталог учебников/Список]]. [[Участник:Def2010|Def2010]] ([[Обсуждение участника:Def2010|обсуждение]]) 11:18, 16 мая 2026 (UTC)
:: Список определяется ботом в проходке, лучше его не трогать (по возможности, конечно же)&lt;br&gt; Там вся суть в кэше, часто после добавления чего-либо теперь в каталоге или где-либо еще надо обновить кэш, чтобы заработало. В целом, все полки кажется появились, хотя там есть некоторые странности с тем, что некоторые полки не существуют. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 14:42, 18 мая 2026 (UTC)
:::Да, там вроде сутки прошли после добавления перед моими правками, но бот не стал добавлять в список. [[Участник:Def2010|Def2010]] ([[Обсуждение участника:Def2010|обсуждение]]) 20:42, 18 мая 2026 (UTC)
:::: Что странно. Надо будет мне весь код проверить, и кажется я в свое время не все там доработал. Может быть из-за этого. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 07:40, 19 мая 2026 (UTC)

== Флаг бота ==
Прошу присвоить флаг бота [[Участник:Taratarussia's Bot|моему боту]]. Бот будет откатывать мат в статьях Викиучебника. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 16:39, 11 мая 2026 (UTC)
: @[[Участник:Leksey|Leksey]] @[[Участник:Kylaix|Kylaix]] [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 16:39, 11 мая 2026 (UTC)
:: @[[Участник:Валерий Стариков|Валерий Стариков]] [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 16:46, 11 мая 2026 (UTC)
:: Я не знаю как это делать, но, наверное, разберусь.
:: Но я не уверен, что такой бот нужен. Вроде нет проблемы с матом как таковой. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:33, 11 мая 2026 (UTC)
::: Я тоже так думаю, но, НО, пока он будет мат откатывать, а позже я расширю функционал. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 11:27, 12 мая 2026 (UTC)
: Привет. Код хороший, но насколько актуально использовать это, если есть фильтры? И еще вопрос: вы его с консоли хотите использовать? Я бы рекомендовал для ботов использовать Toolforge &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 17:27, 11 мая 2026 (UTC)
:: Я только знаю как запускать с консоли [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 17:53, 11 мая 2026 (UTC)
::: @[[Участник:Kylaix|Kylaix]] [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 17:53, 11 мая 2026 (UTC)
::: Не переживайте за это, я могу вам помочь перенести на toolforge, это не сложно. Вопрос только состоит в актуальности &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:56, 11 мая 2026 (UTC)
:::: @[[Участник:Kylaix|Kylaix]] Спасибо за помощь, я готов перенести, время есть. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 11:29, 12 мая 2026 (UTC)
::::: @[[Участник:Leksey|Leksey]] что думаешь? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 14:14, 12 мая 2026 (UTC)
:::::: @[[Участник:Kylaix|Kylaix]] Я зарегистрировался на Toolforge и подал заявку на участие. Краткое описание написал на русском языке. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 15:10, 12 мая 2026 (UTC)
::::::: А вы на нейронке пишете бота? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 16:53, 12 мая 2026 (UTC)
:::::::: В общем, да. Я не умею учебники писать, а пользу проекту приносить хочу. Единственный выход — боты. Но питон я не знаю, поэтому использую нейросети. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 16:55, 12 мая 2026 (UTC)
::::::::: Я сам ботовод, подумаю что вам придумать в задачи. Сам хотя и знаю питон, писал @[[Участник:Kylaixbot|Kylaixbot]] при помощи ИИ &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:00, 12 мая 2026 (UTC)
::::::::: Мне кажется, проекту нужны авторы. Остальное все пока нет авторов - несущественно и не нужно. А авторы вряд ли появятся так как проект не закрывает какие-то насущные задачи людей. Или же людй вполне устраивают другие платформы и способы обучения. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 19:01, 12 мая 2026 (UTC)
:::::::::: У меня нет телеграма. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:16, 13 мая 2026 (UTC)
::::::::::: Раз важны статьи, я могу заняться переводами с других проектов. Но думаю, что лучше чтобы был бот, так на фоне, если вдруг что будет, то сможет откатить. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:24, 13 мая 2026 (UTC)
:::::::::::: Я не уверен, что переводы автоматические нужны. Сейчас любой сам может себе что угодно перевести одним или тремя нажатиями. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 20:17, 13 мая 2026 (UTC)
:::::: Я думаю, что нам это не надо. Так как я не вижу пробемы вандализма с матом конкретно.
:::::: Актуален вопрос отката всего вклада вандала &quot;одним нажатием&quot;, но скрипт из Википедии у нас тут не работает. Вот его бы заставить работать. 
:::::: Также имеет смысл уведомлять администратора (через СО или через телеграм)  о самих фактах вандализма, чтобы он пришел и откатил все. Той самой одной кнопкой. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 18:31, 12 мая 2026 (UTC)
::::::: Можно попробовать сделать бота, который будет откатывать все правки заблокированных участников. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:16, 13 мая 2026 (UTC)
:::::::: Трудновато. Не всегда вклад негативный. Можно конечно по причине блокировки ловить (вандализм). Было бы круто если бы попробовали написать бота, а я гляну его, вот тогда стоит дать флаг. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 15:51, 13 мая 2026 (UTC)
::::::::: Опишите подробнее что хотите, и попробую что-либо сделать. С уважением, [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 18:53, 13 мая 2026 (UTC)
:::::::: Я предпочту откатывать скриптом вручную, но надо чтобы он заработал. Есть JS-скрипт, который в Викиучебнике не работает.&lt;br&gt; А вот о необходимости прийти и откатить уведомление бы не помешало. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 20:15, 13 мая 2026 (UTC)
::::::::: Не могли бы вы скинуть ссылку на скрипт, я попробую оптимизировать. Возможно, дело в ограничениях в скрипте, или в расширениях которых нет в ВУ. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 11:27, 14 мая 2026 (UTC)
:::::::::: Пожалуйста [[Участник:Leksey/common.js]]
:::::::::: Вот обсуждение [[w:Служебная:GoToComment/c-Leksey-20260402155500-Вопрос_по_администрированию_Викиучебника]] [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 16:11, 14 мая 2026 (UTC)
:::::::::: Вот тут я перечислил административные средства имеющиеся сейчас [[Викиучебник:Инструменты_администратора]] [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 16:17, 14 мая 2026 (UTC)
:::::::::: Вот еще с такой проблемой столкнулся [[Обсуждение шаблона:Цитата#Не работает свойство &quot;Источник&quot;]]. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:48, 14 мая 2026 (UTC)
::::::::::: Шаблон починил, любуйтесь. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 11:23, 15 мая 2026 (UTC)
:::::::::::: @[[Участник:Leksey|Leksey]] Вот исправный код (хотя я не знаю у меня не проверяется, у меня нет кнопок откатить:))&lt;br&gt; // Mass Rollback for MediaWiki&lt;br&gt; // Универсальная версия для Википедии, Викиучебника и других вики
:::::::::::: if (typeof wkRollbackPortlet === &quot;undefined&quot;) {&lt;br&gt; var wkRollbackPortlet = &quot;p-tb&quot;;&lt;br&gt; }
:::::::::::: // Откат одной правки&lt;br&gt; function rollbackOneThingWKMR(edit, rbMetadata) {
:::::::::::: var userName;
:::::::::::: // Для IP-участников&lt;br&gt; if (rbMetadata.userName === null) {
:::::::::::: userName = $(edit)&lt;br&gt; .parents(&quot;li:first&quot;)&lt;br&gt; .find(&quot;a.mw-anonuserlink&quot;)&lt;br&gt; .first()&lt;br&gt; .text();
:::::::::::: } else {
:::::::::::: userName = rbMetadata.userName;
:::::::::::: }
:::::::::::: var titleMatch = /title=([^&amp;]+)/.exec(edit.href);
:::::::::::: if (!titleMatch) {&lt;br&gt; console.error(&quot;Не удалось определить страницу&quot;);&lt;br&gt; return;&lt;br&gt; }
:::::::::::: var pageTitle = decodeURIComponent(titleMatch[1]);
:::::::::::: var params = {};
:::::::::::: if (rbMetadata.editSummary !== &quot;&quot;) {&lt;br&gt; params.summary = rbMetadata.editSummary;&lt;br&gt; }
:::::::::::: rbMetadata.api.rollback(pageTitle, userName, params)
:::::::::::: .done(function () {
:::::::::::: console.log(&quot;Откат:&quot;, pageTitle);
:::::::::::: $(edit).after(&lt;br&gt; '&lt;span style=&quot;color:green;font-weight:bold;&quot;&gt; [откачено]&lt;/span&gt;'&lt;br&gt; );
:::::::::::: $(edit).remove();
:::::::::::: })
:::::::::::: .fail(function (code, data) {
:::::::::::: console.error(&quot;Ошибка rollback:&quot;, code, data);
:::::::::::: $(edit).after(&lt;br&gt; '&lt;span style=&quot;color:red;font-weight:bold;&quot;&gt; [ошибка]&lt;/span&gt;'&lt;br&gt; );
:::::::::::: });&lt;br&gt; }
:::::::::::: // Откат всех&lt;br&gt; function rollbackEverythingWKMR(editSummary) {
:::::::::::: if (editSummary === null) {&lt;br&gt; return false;&lt;br&gt; }
:::::::::::: if (&lt;br&gt; mw.config.get(&quot;wgRelevantUserName&quot;) ===&lt;br&gt; mw.config.get(&quot;wgUserName&quot;)&lt;br&gt; ) {
:::::::::::: if (&lt;br&gt; !confirm(&lt;br&gt; &quot;Вы собираетесь откатить ВСЕ свои правки. Продолжить?&quot;&lt;br&gt; )&lt;br&gt; ) {&lt;br&gt; return false;&lt;br&gt; }&lt;br&gt; }
:::::::::::: mw.loader.using([&quot;mediawiki.api&quot;]).done(function () {
:::::::::::: var rbMetadata = {};
:::::::::::: rbMetadata.api = new mw.Api();
:::::::::::: rbMetadata.userName =&lt;br&gt; mw.config.get(&quot;wgRelevantUserName&quot;);
:::::::::::: rbMetadata.editSummary = editSummary;
:::::::::::: $(&quot;a[href*='action=rollback']&quot;).each(function (ind, el) {
:::::::::::: rollbackOneThingWKMR(el, rbMetadata);
:::::::::::: });
:::::::::::: });
:::::::::::: return false;&lt;br&gt; }
:::::::::::: // Откат выбранных&lt;br&gt; function rollbackSomeThingsWKMR(editSummary) {
:::::::::::: if (editSummary === null) {&lt;br&gt; return false;&lt;br&gt; }
:::::::::::: mw.loader.using([&quot;mediawiki.api&quot;]).done(function () {
:::::::::::: var rbMetadata = {};
:::::::::::: rbMetadata.api = new mw.Api();
:::::::::::: rbMetadata.userName =&lt;br&gt; mw.config.get(&quot;wgRelevantUserName&quot;);
:::::::::::: rbMetadata.editSummary = editSummary;
:::::::::::: var rollbackList = $(&quot;input.revdelIds:checked&quot;)&lt;br&gt; .parents(&quot;li&quot;)&lt;br&gt; .find(&quot;a[href*='action=rollback']&quot;);
:::::::::::: if (rollbackList.length &lt;= 0) {
:::::::::::: mw.notify(&quot;Не выбрано ни одной правки.&quot;);
:::::::::::: return;&lt;br&gt; }
:::::::::::: rollbackList.each(function (ind, el) {
:::::::::::: rollbackOneThingWKMR(el, rbMetadata);
:::::::::::: });
:::::::::::: });
:::::::::::: return false;&lt;br&gt; }
:::::::::::: // Главная часть&lt;br&gt; mw.loader.using([&lt;br&gt; &quot;mediawiki.util&quot;,&lt;br&gt; &quot;mediawiki.api&quot;&lt;br&gt; ]).done(function () {
:::::::::::: mw.hook('wikipage.content').add(function () {
:::::::::::: // Только на странице вкладов&lt;br&gt; if (&lt;br&gt; mw.config.get(&quot;wgCanonicalSpecialPageName&quot;) !==&lt;br&gt; &quot;Contributions&quot;&lt;br&gt; ) {&lt;br&gt; return;&lt;br&gt; }
:::::::::::: // Уже добавлено&lt;br&gt; if ($(&quot;#ca-rollbackeverything&quot;).length) {&lt;br&gt; return;&lt;br&gt; }
:::::::::::: // Проверяем наличие rollback&lt;br&gt; if ($(&quot;a[href*='action=rollback']&quot;).length &lt;= 0) {
:::::::::::: console.log(&quot;Rollback ссылки не найдены&quot;);
:::::::::::: return;&lt;br&gt; }
:::::::::::: console.log(&quot;MassRollback загружен&quot;);
:::::::::::: // Добавляем чекбоксы&lt;br&gt; $(&quot;ul.mw-contributions-list li&quot;).each(function () {
:::::::::::: // Уже есть чекбокс&lt;br&gt; if ($(this).find(&quot;input.revdelIds&quot;).length) {&lt;br&gt; return;&lt;br&gt; }
:::::::::::: var rollbackLink = $(this)&lt;br&gt; .find(&quot;a[href*='action=rollback']&quot;);
:::::::::::: if (rollbackLink.length &gt; 0) {
:::::::::::: $(this)&lt;br&gt; .find(&quot;a.mw-changeslist-date&quot;)&lt;br&gt; .first()&lt;br&gt; .before(&lt;br&gt; &quot;&lt;input type='checkbox' class='revdelIds' style='margin-right:5px;'&gt;&quot;&lt;br&gt; );&lt;br&gt; }&lt;br&gt; });
:::::::::::: // Кнопка Rollback all&lt;br&gt; mw.util.addPortletLink(&lt;br&gt; wkRollbackPortlet,&lt;br&gt; &quot;#&quot;,&lt;br&gt; &quot;Rollback all&quot;,&lt;br&gt; &quot;ca-rollbackeverything&quot;,&lt;br&gt; &quot;Откатить все правки&quot;&lt;br&gt; );
:::::::::::: // Кнопка Rollback selected&lt;br&gt; mw.util.addPortletLink(&lt;br&gt; wkRollbackPortlet,&lt;br&gt; &quot;#&quot;,&lt;br&gt; &quot;Rollback selected&quot;,&lt;br&gt; &quot;ca-rollbacksome&quot;,&lt;br&gt; &quot;Откатить выбранные правки&quot;&lt;br&gt; );
:::::::::::: // Обработка кнопки ALL&lt;br&gt; $(&quot;#ca-rollbackeverything&quot;).click(function (event) {
:::::::::::: event.preventDefault();
:::::::::::: rollbackEverythingWKMR(&lt;br&gt; prompt(&lt;br&gt; &quot;Введите комментарий отката:&quot;&lt;br&gt; )&lt;br&gt; );
:::::::::::: });
:::::::::::: // Обработка кнопки SELECTED&lt;br&gt; $(&quot;#ca-rollbacksome&quot;).click(function (event) {
:::::::::::: event.preventDefault();
:::::::::::: rollbackSomeThingsWKMR(&lt;br&gt; prompt(&lt;br&gt; &quot;Введите комментарий отката:&quot;&lt;br&gt; )&lt;br&gt; );
:::::::::::: });
:::::::::::: });
:::::::::::: }); [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:10, 15 мая 2026 (UTC)
::::::::::::: Блин. Мне стремно выполнять непонятный JS. Можете диф показать как-нить или объяснить что за правка была сделана.
::::::::::::: Да и идея править ИИ мне конечно не нравится, но других предложений нет. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:52, 17 мая 2026 (UTC)
:::::::::::: Починилось, спасибо! [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:50, 17 мая 2026 (UTC)
Прекрасно, если понадобится помощь — обращайтесь на мою СО. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 19:52, 17 мая 2026 (UTC)
Если не работает, вот это попробуйте:
&lt;pre&gt;if (typeof wkContribsCheckboxInit === &quot;undefined&quot;) {
	wkContribsCheckboxInit = false;
}

if (typeof wkRollbackPortlet === &quot;undefined&quot;) {
	wkRollbackPortlet = &quot;p-cactions&quot;;
}

function getContributionItem(el) {
	return $(el).closest(&quot;li, tr, .mw-contribs-list-item&quot;);
}

function getRollbackLinks(scope) {
	return scope.find(&quot;a[href*='action=rollback']&quot;);
}

function rollbackEverythingWKMR(editSummary) {
	if (editSummary === null) {
		return false;
	}

	if (mw.config.get(&quot;wgRelevantUserName&quot;) === mw.config.get(&quot;wgUserName&quot;)) {
		if (!confirm(&quot;You are about to roll back *all* of *your own* edits. Please note that this will be very difficult to undo. Are you *ABSOLUTELY SURE* you want to do this?&quot;)) {
			return false;
		}
	}

	mw.loader.using(&quot;mediawiki.api&quot;).done(function () {
		var rbMetadata = {};
		rbMetadata.api = new mw.Api();
		rbMetadata.userName = mw.config.get(&quot;wgRelevantUserName&quot;);
		rbMetadata.ipRange = (rbMetadata.userName === null);
		rbMetadata.titleRegex = /title=([^&amp;]+)/;
		rbMetadata.editSummary = editSummary;

		$(&quot;a[href*='action=rollback']&quot;).each(function (ind, el) {
			rollbackOneThingWKMR(el, rbMetadata);
		});
	});

	return false;
}

function rollbackSomeThingsWKMR(editSummary) {
	if (editSummary === null) {
		return false;
	}

	mw.loader.using(&quot;mediawiki.api&quot;).done(function () {
		var rbMetadata = {};
		rbMetadata.api = new mw.Api();
		rbMetadata.userName = mw.config.get(&quot;wgRelevantUserName&quot;);
		rbMetadata.titleRegex = /title=([^&amp;]+)/;
		rbMetadata.editSummary = editSummary;

		var rollbackList = $(&quot;input.revdelIds:checked&quot;).each(function () {
			var item = getContributionItem(this);
			item.find(&quot;a[href*='action=rollback']&quot;).each(function (ind, el) {
				rollbackOneThingWKMR(el, rbMetadata);
			});
		});

		if ($(&quot;input.revdelIds:checked&quot;).length &lt;= 0) {
			mw.notify(&quot;You didn't select any edits that could be rolled back!&quot;);
			return;
		}
	});

	return false;
}

function rollbackOneThingWKMR(edit, rbMetadata) {
	var userName;

	var item = getContributionItem(edit);

	if (rbMetadata.userName === null) {
		userName = item.find(&quot;a.mw-anonuserlink&quot;).not(&quot;.mw-contributions-title&quot;).first().text();
	} else {
		userName = rbMetadata.userName;
	}

	if (!userName) {
		return;
	}

	var params = {};
	if (rbMetadata.editSummary != '') {
		params.summary = rbMetadata.editSummary;
	}

	var titleMatch = rbMetadata.titleRegex.exec(edit.href);
	if (!titleMatch) {
		return;
	}

	rbMetadata.api.rollback(decodeURIComponent(titleMatch[1]), userName, params).done(function () {
		$(edit).after(&quot;reverted&quot;);
		$(edit).remove();
	});
}

$(document).ready(function () {
	if (mw.config.get(&quot;wgCanonicalSpecialPageName&quot;) == &quot;Contributions&quot; &amp;&amp; $(&quot;a[href*='action=rollback']&quot;).length &gt; 0) {
		mw.loader.using(&quot;mediawiki.util&quot;).done(function () {
			mw.util.addPortletLink(wkRollbackPortlet, '#', &quot;Rollback all&quot;, &quot;ca-rollbackeverything&quot;, &quot;rollback all edits displayed here&quot;);

			if (!wkContribsCheckboxInit) {
				if ($(&quot;input.revdelIds&quot;).length === 0) {
					$(&quot;a[href*='action=rollback']&quot;).each(function (ind, el) {
						var item = getContributionItem(el);
						item.find(&quot;a&quot;).first().before(&quot;&lt;input type='checkbox' class='revdelIds'&gt;&amp;nbsp;&quot;);
						item.find(&quot;input.revdelIds&quot;).data(&quot;index&quot;, ind);
					});
				} else {
					$(&quot;input.revdelIds&quot;).each(function (ind, el) {
						$(el).data(&quot;index&quot;, ind);
					});
				}
				wkContribsCheckboxInit = true;
			}

			mw.util.addPortletLink(wkRollbackPortlet, '#', &quot;Rollback selected&quot;, &quot;ca-rollbacksome&quot;, &quot;rollback selected edits&quot;);

			$(&quot;#ca-rollbackeverything&quot;).click(function (event) {
				event.preventDefault();
				mw.loader.load(&quot;mediawiki.api&quot;);
				return rollbackEverythingWKMR(prompt(&quot;Rollback all edits: Enter an edit summary, or leave blank to use the default (or hit Cancel to cancel the rollback entirely)&quot;));
			});

			$(&quot;#ca-rollbacksome&quot;).click(function (event) {
				event.preventDefault();
				mw.loader.load(&quot;mediawiki.api&quot;);
				return rollbackSomeThingsWKMR(prompt(&quot;Rollback selected edits: Enter an edit summary, or leave blank to use the default (or hit Cancel to cancel the rollback entirely)&quot;));
			});

			$(&quot;#ca-rollbacksome&quot;).data(&quot;lastSelectedIndex&quot;, -1);

			$(&quot;input.revdelIds&quot;).off(&quot;click&quot;).click(function (ev) {
				var lastSelectedRevdel = $(&quot;#ca-rollbacksome&quot;).data(&quot;lastSelectedIndex&quot;);
				var newIndex = $(this).data(&quot;index&quot;);

				if (ev.shiftKey &amp;&amp; lastSelectedRevdel &gt;= 0) {
					var checkboxArray = $(&quot;input.revdelIds&quot;);
					var start = lastSelectedRevdel;
					var stop = newIndex;

					if (start &lt; stop) {
						for (var i = start; i &lt; stop; i++) {
							if (i != lastSelectedRevdel) {
								$(checkboxArray[i]).prop(&quot;checked&quot;, !($(checkboxArray[i]).prop(&quot;checked&quot;)));
							}
						}
					} else {
						for (var i = start; i &gt; stop; i--) {
							if (i != lastSelectedRevdel) {
								$(checkboxArray[i]).prop(&quot;checked&quot;, !($(checkboxArray[i]).prop(&quot;checked&quot;)));
							}
						}
					}
				}

				$(&quot;#ca-rollbacksome&quot;).data(&quot;lastSelectedIndex&quot;, newIndex);
			});
		});
	}
});&lt;/pre&gt;
[[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 18:13, 15 мая 2026 (UTC)

=== Итог ===
* Флаг не присвоен, но зато починен скрипт и шаблон. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 15:52, 18 мая 2026 (UTC)

== Изменение шаблона «Родственные проекты» ==
К сожалению, Викиновости полностью закрылись на всех языках решением Фонда Викимедиа. Поэтому, считаю целесообразным убрать Викиновости из шаблона, как уже сделали на https://meta.wikimedia.org/wiki/Main_Page/ru. Сам я не могу, поэтому прошу местных администраторов сделать. С уважением, СССР (обсуждение) 16:07, 8 мая 2026 (UTC)
: @[[Участник:Leksey|Leksey]] сможете поправить шаблон? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:21, 13 мая 2026 (UTC)
:: Сделал. И предлагаю на ты. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 20:20, 13 мая 2026 (UTC)

== Вопрос с [[ВУ:КУ]] ==

Я тут ставил цель в прошлом году закончить с КУ, но кажется там у меня небольшой тупик с этим. И я вспомнил почему я хотел побыстрее с этим покончить: я хотел переделать КУ, чтобы там можно было удобнее все это просматривать и, если надо - автоматизировать. Я конечно не предлагаю вести ежедневный КУ (да и от ежемесячного тоже думал бы отказаться, так как все равно небольшие неудобства) а перейти на годовой (то есть одна страница чисто для 2026) и возможно, оставлять ее сразу на [[ВУ:КУ]]. Думаю, номинаций много не будет в скором времени, поэтому есть время об этом подумать и реализовать (если, конечно, будет согласие) &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 00:04, 3 января 2026 (UTC)

Я вижу, вы тут снесли что-то 1Сное, а [[Служебная:Неиспользуемые файлы|несвободные файлы удалить забыли]].&lt;br&gt;
Файлы Хедина в Цивилизции оформлены неправильно: должны быть переоформлены или удалены по [[ВУ:КДИ]]#10а и в. Он не является &quot;автором или правообладателем&quot;, а &quot;иллюстрирование&quot; не является валидной причиной для содержания несвободного файла. А после переоформления около трети должна быть удалена по 8 пункту.&lt;br&gt; 
И, раз уж написал, примерно половину статей господина Пинчука снесли на enКнигах в прошлом году. — Ирука&lt;sup&gt;[[u:Iruka13|13]]&lt;/sup&gt; 18:44, 10 января 2026 (UTC)
: ээ, вроде 1сное не сносил особо, кроме каких-то 2-3 файлов, с согласия других (надо поискать в КУ). До несвободных файлов рука не добралась, там вообще желательно обсуждение.&lt;br&gt;Ровно так же как и с Цивой, потому что иллюстрирование в играх по КДИ, как мне кажется, у нас под вопросом. Я замечал случаи, где иллюстрирование необходимо как в руководствах Хедина, поэтому тут под вопросом. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 15:41, 15 января 2026 (UTC)

== Категории кулинарной книги ==

&lt;s&gt;Коль ниже нас похоронили, решу немного покопаться в гробу&lt;/s&gt;. Касательно категорий: нам надо их слегка вложить друг в друга чтобы это отображалось цивильно, да и для удобства поиска. Например: категории огурцы, помидоры и баклажан стоило бы вложить в овощи, а китайская, японская, корейская кухня в восточно-азиатские кухни и т.д. Хотелось бы услышать мнения касательно данного действа. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:42, 28 декабря 2025 (UTC)
: @[[Участник:Leksey|Leksey]] @[[Участник:Heffalump1974|Heffalump1974]] @[[Участник:Erokhin|Erokhin]] &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:42, 28 декабря 2025 (UTC)
:Можно на примерах показать? [[Участник:Erokhin|Erokhin]] ([[Обсуждение участника:Erokhin|обсуждение]]) 22:11, 28 декабря 2025 (UTC)
:: См. [[Кулинарная книга]], спускаемся ниже до [[:Категория:Европейская кухня]] и там видим подкухни, которые я ранее посчитал европейскими. Если бы их там не было, то кухни бы догнали список ингредиентов на странице кулинарной книги по длине. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 15:38, 29 декабря 2025 (UTC)
::: ? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 15:55, 15 января 2026 (UTC)
::::Соглашусь, хорошо бы перетасовать предлагаемым образом.
::::Сам не возьмусь, пока без компьютера. [[Участник:Heffalump1974|Heffalump1974]] ([[Обсуждение участника:Heffalump1974|обсуждение]]) 14:03, 5 мая 2026 (UTC)
::::: Категоризировал, и стало теперь приятнее смотреть на не слишком длинные списки. Оценка за вами, @[[Участник:Leksey|Leksey]], @[[Участник:Heffalump1974|Heffalump1974]] :)&lt;br&gt; Там единственное есть дубляжи (Баклажан и баклажаны, орех и орехи) надо бы определиться в каком числе категоризировать их. Мне кажется лучше в единственном числе, потому что так будет логично. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:26, 13 мая 2026 (UTC)
:::::: А куда смотреть? Я уже забыл все [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 20:18, 13 мая 2026 (UTC)
::::::: [[Викиучебник:Кулинарная книга]] и туда снизу. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:23, 13 мая 2026 (UTC)
::::::зависит от того, как этот объект назван в элементе викиданных, если Баклажан, то и у нас должно быть также [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 18:03, 17 мая 2026 (UTC)


&lt;!-- Сообщение отправил Участник:Keegan (WMF)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=29905753 --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Vote now in the 2026 U4C election&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;announcement-content&quot; /&gt;
Eligible voters are asked to participate in the 2026 [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee|Universal Code of Conduct Coordinating Committee]] election. More information–including an eligibility check, voting process information, candidate information, and a link to the vote–are available on Meta at the [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee/Election/2026|2026 Election information page]]. The vote closes on 2 June 2026 at [https://zonestamp.toolforge.org/1780358400 00:00 UTC].

Please vote if your account is eligible. Results will be available by 14 June 2026. -- In cooperation with the U4C,&lt;section end=&quot;announcement-content&quot; /&gt;
&lt;/div&gt;

[[m:User:Keegan (WMF)|Keegan (WMF)]] ([[m:User talk:Keegan (WMF)|talk]]) 17:14, 27 мая 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Keegan (WMF)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=30513860 --&gt;

== RFC about AI-generated content in Wikimedia Commons ==

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Apologies for writing in English, please help translate this message to your language. You are invited to participate in a [[c:Commons:Requests for comment/Policy update for AI content|request for comment on Wikimedia Commons about a policy update for AI content]]. This may affect files that are uploaded to Wikimedia Commons for use on this project. Thank you. [[m:User:Codename Noreste|Codename Noreste]] ([[m:User talk:Codename Noreste|обсуждение]])&lt;/bdi&gt; 17:11, 23 июня 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Codename Noreste@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=30513860 --&gt;

== Размещение ссылок на контакты по вопросам права и безопасности в нижнем колонтитуле вашего вики-проекта ==

&lt;section begin=&quot;Message&quot;/&gt;
'''Контакты по вопросам права и безопасности'''

Дорогие участники сообщества, Фонд Викимедиа сформировал [[wmf:Special:MyLanguage/Legal:Wikimedia Foundation Legal and Safety Contact Information|единую страницу с контактами по вопросам права и безопасности]] для размещения в нижних колонтитулах ваших проектов соответствующих ссылок на нее, чтобы обеспечить доступ к достоверной юридической информации. Это нормативное требование. Мы уже разместили эти ссылки в английском, немецком, итальянском, испанском и других проектах Википедии, и мы также скоро добавим это и в ваш вики-проект. [[m:Special:MyLanguage/Wikimedia_Foundation_Legal_and_Safety_Contacts_FAQ|Пожалуйста, ознакомьтесь более подробно на странице проекта]] и оставляйте любые комментарии в этой ветке или на [[m:Special:MyLanguage/Talk:Wikimedia Foundation Legal and Safety Contacts FAQ|странице обсуждений]].

&lt;section end=&quot;Message&quot;/&gt;

-- [[User:Sannita (WMF)|User:Sannita (WMF)]] ([[User talk:Sannita (WMF)|talk]]) 13:30, 25 июня 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Sannita (WMF)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=User:Sannita_(WMF)/Mass_sending_test&amp;oldid=30731267 --&gt;

== Request for comment (the future of Abstract Wikipedia) ==

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;
Apologies if this has not yet been translated into your wiki's language. {{int:Please-translate}}
You are invited to voice your opinions in a [[:m:Requests for comment/The future of Abstract Wikipedia|request for comment about the future of Abstract Wikipedia]]. {{Int:Feedback-thanks-title}}
[[:m:User:Kowal2701|Kowal2701]] ([[:m:User talk:Kowal2701|talk]])  12:24, 24 июля 2026 (UTC)
&lt;/bdi&gt;

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:DreamRimmer@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=30513860 --&gt;

== Переключение сервера: ваш вики-проект скоро на короткое время будет доступен в режиме «только для чтения» ==
&lt;section begin=&quot;server-switch&quot;/&gt;&lt;div class=&quot;plainlinks&quot;&gt;

[[:m:Special:MyLanguage/Tech/Server switch|Прочитать это сообщение на другом языке]] • [https://meta.wikimedia.org/w/index.php?title=Special:Translate&amp;group=page-Tech%2FServer+switch&amp;language=&amp;action=page&amp;filter= {{int:please-translate}}]

[[foundation:|Фонд Викимедиа]] будет переключать трафик между своими центрами обработки данных. Это гарантирует, что Википедия и другие вики-проекты Викимедиа смогут оставаться доступными даже после катастрофы.

Весь трафик будет переключен '''{{#time:j xg|2026-09-23|ru}}'''. Переключение начнётся в '''[https://zonestamp.toolforge.org/{{#time:U|2026-09-23T14:00|en}} {{#time:H:i e|2026-09-23T14:00}}]'''.

К сожалению, ввиду некоторых ограничений движка [[mw:Special:MyLanguage/Manual:What is MediaWiki?|MediaWiki]], редактирование будет остановлено в течение этих двух переключений. Приносим свои извинения за задержку в работе. Мы работаем над тем, чтобы сократить такие работы в будущем. 

За 30 минут до начала переноса во всех проектах будет показан баннер-предупреждение. Этот баннер будет оставаться видимым до окончания операции. 
Вы можете внести вклад в [https://meta.wikimedia.org/w/index.php?title=Special%3ATranslate&amp;group=Centralnotice-tgroup-read_only_banner&amp;task=view&amp;language=&amp;filter=&amp;action=translate перевод или вычитку] этого текста баннера.

'''В течение короткого промежутка времени вы сможете читать, но не сможете редактировать все вики-сайты.'''

* День переключения — {{#time:l j xg Y|2026-09-23|ru}}. Оно продлится не более часа.
* При попытке отредактировать или сохранить страницы в течение этого времени вы увидите сообщение об ошибке. Мы надеемся, что правки в этот период не будут потеряны, но не можем этого гарантировать. Если вы увидите сообщение об ошибке, пожалуйста, подождите, пока всё не восстановится. После этого вы сможете сохранить свою правку. Но на всякий случай мы рекомендуем вам сделать копию ваших изменений.

''Побочные эффекты'':

* Фоновые задания будут выполняться замедленно, а некоторые могут быть отклонены. Красные ссылки могут также обновляться с замедлением. Если вы создаёте статью, на которую уже есть ссылки откуда-то, то такие ссылки будут оставаться красными дольше, чем обычно. Некоторые долго выполняющиеся скрипты необходимо будет остановить.
* Мы ожидаем, что развёртывание кода произойдет так же, как и на любой другой неделе. Однако могут происходить некоторые зависания кода, если впоследствии этого потребует данная операция.
* [[mw:Special:MyLanguage/GitLab|GitLab]] будет недоступен примерно 90 минут.

При необходимости эти планы могут быть отложены. Вы можете [[wikitech:Switch_Datacenter|посмотреть расписание на wikitech.wikimedia.org]]. О любых изменениях будет сообщено в расписании. 

'''Пожалуйста, поделитесь этой информацией с вашим сообществом.'''&lt;/div&gt;&lt;section end=&quot;server-switch&quot;/&gt;

[[m:user:Trizek (WMF)|Trizek (WMF)]] 12:58, 15 сентября 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Trizek (WMF)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Non-Technical_Village_Pumps_distribution_list&amp;oldid=30513874 --&gt;

== Your feedback wanted: Remove ''(Language link added:) and similar'' edits from Special:RecentChanges ==
''(Apologies for posting in English. You can help by translating it)''

Hello, I’m Danny from [[:en:w:Wikimedia_Deutschland|Wikimedia Deutschland’s]] [[m:Wikidata_For_Wikimedia_Projects|Wikidata For Wikimedia Projects]] team.&lt;br/&gt;
We have been investigating and examining how Wikidata’s use in the [[Special:RecentChanges]] and [[Special:Watchlist]] pages can be made to be more useful, or less ‘noisy’ (fewer edits that have little value to the reader).

We are currently exploring to make a change in the volume and the type of Wikidata edits that appear in these pages, and '''we need your feedback''' to help us ensure this is a positive change for the Wikis and won’t disrupt your workflows.&lt;br/&gt;
Language links are also known as sitelinks or interlanguage links and describe when a Wikidata item is connected to a Wiki, adding it to the language dropdown tool for other connected Wikis.
[[File:Types of Lang Link changes.png|x350px|frame|A variety of &quot;Language Link&quot; edits as seen in the Recent Changes feed]]

The request for feedback is whether you support the removal of these language link edits from the Recent Changes and Watchlist feed, or would you oppose such a change and if so, why?
Please share you thoughts on the dedicated '''[[m:Talk:Wikidata_For_Wikimedia_Projects/Clearer_Wikidata_Edit_Summaries/Hide_Language_Link_edits|metawiki Talk page]]'''. 

Further information about this change: [[m:Wikidata_For_Wikimedia_Projects/Clearer_Wikidata_Edit_Summaries/Hide_Language_Link_edits|m:Wikidata_For_Wikimedia_Projects/Hide_Language_Link_edits]]

Thank you for any participation or feedback you give, -- [[m:User:Danny_Benjafield_(WMDE)|User:Danny Benjafield (WMDE)]] 11:46, 25 сентября 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Danny Benjafield (WMDE)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=User:Danny_Benjafield_(WMDE)/MassMessage_test_list&amp;oldid=31080832 --&gt;

== Wikidata Sitelink changes in Recent Changes and Watchlist ==
''(Apologies for cross-posting in English, translating it will help spread the message)''

Editors on group 1 wikis, including Wikiquote, Wikibooks, Wikiversity, Wikivoyage, and Wikisource, will no longer see notifications on [[Special:RecentChanges|Recent Changes]] and [[Special:Watchlist|Watchlist]] when a link to ''another'' language version of a page is added, removed, or changed in its Wikidata item. This change will begin on '''October 5 at 07:00 UTC''' as a two-week trial to reduce high-volume, low-value notifications and make higher-value changes easier to identify. Editors who rely on these notifications should be aware of the change and can share feedback or concerns on the [[m:Wikidata For Wikimedia Projects/Clearer Wikidata Edit Summaries/Hide Language Link edits|project]] or [[m:Talk:Wikidata_For_Wikimedia_Projects/Clearer_Wikidata_Edit_Summaries/Hide_Language_Link_edits|talk page]].&lt;br/&gt;Please reach out if you have any questions, thank you! -- [[User:Danny_Benjafield_(WMDE)|Danny Benjafield (WMDE)]] ([[User_talk:Danny_Benjafield_(WMDE)|talk]])  sent via [[Участник:MediaWiki message delivery|MediaWiki message delivery]] ([[Обсуждение участника:MediaWiki message delivery|обсуждение]]) 12:42, 1 октября 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Danny Benjafield (WMDE)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=User:Danny_Benjafield_(WMDE)/MassMessage_test_list&amp;oldid=31106967 --&gt;

== Переключение сервера: ваш вики-проект скоро на короткое время будет доступен в режиме «только для чтения» ==
&lt;section begin=&quot;server-switch&quot;/&gt;&lt;div class=&quot;plainlinks&quot;&gt;
[[:m:Special:MyLanguage/Tech/Server switch|Прочитать это сообщение на другом языке]] • [https://meta.wikimedia.org/w/index.php?title=Special:Translate&amp;group=page-Tech%2FServer+switch&amp;language=&amp;action=page&amp;filter= {{int:please-translate}}]

[[foundation:|Фонд Викимедиа]] будет переключать трафик между своими центрами обработки данных. Это гарантирует, что Википедия и другие вики-проекты Викимедиа смогут оставаться доступными даже в случае катастрофы.

Весь трафик будет переключён '''{{#time:j xg|2026-10-28|ru}}'''. Переключение начнётся в '''[https://zonestamp.toolforge.org/{{#time:U|2026-10-28T15:00|en}} {{#time:H:i e|2026-10-28T15:00}}]'''.

К сожалению, ввиду некоторых ограничений движка [[mw:Special:MyLanguage/Manual:What is MediaWiki?|MediaWiki]], редактирование будет остановлено в течение этих двух переключений. Приносим свои извинения за задержку. Мы стараемся сократить такие заминки в будущем. 

За 30 минут до начала переноса во всех проектах будет показан баннер-предупреждение. Этот баннер будет оставаться видимым до окончания работ. 
Вы можете помочь [https://meta.wikimedia.org/w/index.php?title=Special%3ATranslate&amp;group=Centralnotice-tgroup-read_only_banner&amp;task=view&amp;language=&amp;filter=&amp;action=translate с переводом или вычиткой] этого текста.

'''В течение короткого промежутка времени вы сможете читать, но не сможете редактировать все вики-сайты.'''

* День переключения — {{#time:l j xg Y|2026-10-28|ru}}. Оно продлится не более часа.
* При попытке отредактировать или сохранить страницы в течение этого времени будет показано сообщение об ошибке. Мы надеемся, что правки в этот период не будут потеряны, но не можем этого гарантировать. Если вы увидите сообщение об ошибке, пожалуйста, подождите, пока всё не восстановится. После этого вы сможете сохранить свою правку. Но на всякий случай мы рекомендуем сделать копию ваших изменений.

''Побочные эффекты'':

* Фоновые задания будут выполняться замедленно, а некоторые могут быть отклонены. Красные ссылки могут также обновляться с замедлением. Если вы создаёте статью, на которую уже есть ссылки, то они будут оставаться красными дольше, чем обычно. Некоторые долго выполняющиеся скрипты необходимо будет остановить.
* Мы ожидаем, что развёртывание нового кода произойдёт как обычно. Однако в отдельных случаях код могут частично замораживать, если это потребуется для работ.
* [[mw:Special:MyLanguage/GitLab|GitLab]] будет недоступен примерно 90 минут.

При необходимости планы по переключению серверов могут быть отложены. Расписание работ [[wikitech:Switch_Datacenter|см. на wikitech.wikimedia.org]]. Там же будет сообщаться о всех изменениях. 

'''Пожалуйста, поделитесь этой информацией с вашим сообществом.'''&lt;/div&gt;&lt;section end=&quot;server-switch&quot;/&gt;

[[user:Trizek_(WMF)|Trizek_(WMF)]] 14:01, 26 октября 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Trizek (WMF)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Non-Technical_Village_Pumps_distribution_list&amp;oldid=30513874 --&gt;</text>
      <sha1>ppj93xmlig1q3dm0wicsujobt93hpsn</sha1>
    </revision>
    <revision>
      <id>270417</id>
      <parentid>270413</parentid>
      <timestamp>2026-10-27T07:02:16Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270417</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="84874" sha1="azdwls03c3z05e8kc7w59o4s3zuf1rb" xml:space="preserve">{{Участник:Kylaixbot/ArchiveConfig
|archive = Викиучебник:Общий форум/Архив/%(year)d
|algo = old(60d)
|counter = 1
}}
{{Форум}}
{{Архив-П |2005-2007|2008|2009-2010|2011-2012|2013|2014|2015|2016|2018|2019|2020|2021|2022|2023|2024|2025}}
{{Актуально}}

== Что тут ==
Тут есть кто живой? — [[Участник:Medyanowsky|Medyanowsky]] ([[Обсуждение участника:Medyanowsky|обсуждение]]) 08:12, 13 октября 2026 (UTC)

:В чем вопрос? [[Участник:Def2010|Def2010]] ([[Обсуждение участника:Def2010|обсуждение]]) 17:07, 13 октября 2026 (UTC)
:Все живы! [[Участник:Erokhin|Erokhin]] ([[Обсуждение участника:Erokhin|обсуждение]]) 03:45, 25 октября 2026 (UTC)
Ну, тут Leksey и Kylain Aixter активны, я особо не редактирую, но на сообщения отвечаю. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 13:00, 14 октября 2026 (UTC)

== Извинения, что задержался ==
Извиняюсь, что закопался, но я чет своего бота @[[Участник:Kylaixbot|Kylaixbot]] не могу починить из-за приколов Тулфорджа. Они там обновили политику venv и у меня никак не получается нормально запустить моего бота. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:52, 14 июня 2026 (UTC)

:Я оказался достаточно оперативен и бот заработал [[Участник:Kylaixbot|Kylaixbot]] ([[Обсуждение участника:Kylaixbot|обсуждение]]) 14:27, 26 июля 2026 (UTC)
::Чем сейчас занят ваш бот? [[Участник:Erokhin|Erokhin]] ([[Обсуждение участника:Erokhin|обсуждение]]) 03:44, 25 октября 2026 (UTC)

== Шаблон может быть улучшен ==
По определению, большинство учебников пишут по книгам; шаблон Книга работает здесь безупречно. По стечению обстоятельств пришлось  использовать шаблон Статья. Видимо, он не точно соответствует этому шаблону в википедии: ISSN (и отчасти PMID и PMC) работает не так, как в википедии. А в [[Шаблон:Статья/Документация| документации]] не написано, что есть отличия (issn):

фрагмент кода: . . . место=Москва|год=2016|номер=8|issn=0131-2618|страницы=74—79|pmid=24006620|pmc=PMC1234567}} ISSN 0131-2618, {{PMID|24006620}}&lt;/ref&gt;

его отображение: Москва, 2016. — № 8. — С. 74—79. — ISSN Шаблон:ISSN search link. — Шаблон:PMID. — Шаблон:PMC. ISSN 0131-2618, {{PMID|24006620}}

+ сообщения ниже красным шрифтом: Шаблон:ISSN search link (править) ... Шаблон:PMID (править) ... Шаблон:PMC (править)

Если можно без больших трудозатрат устранить отличия в шаблонах от википедии, прошу Вас это сделать, как сможете. Спасибо [[Служебная:Вклад/&amp;#126;2026-31604-77|&amp;#126;2026-31604-77]] ([[Обсуждение участника:&amp;#126;2026-31604-77|обс.]]) 17:46, 29 мая 2026 (UTC)
: А можете где-то им воспользоваться и пингануть меня плиз? Я поправлю шаблон&lt;br&gt; P.s.: последний раз, судя по истории, я его и его подшаблоны импортировал в феврале 2025 года. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:50, 14 июня 2026 (UTC)

== Тип блюда (P8431 course) ==
в элементе викиданных, связанном со страницей рецепта, можно добавить поле Тип блюда (P8431 course). 

в викиданных данное свойство имеет ограниченное количество значений: закуска, первое блюдо, суп, салат, рыба, второе блюдо, десерт, соус, завтрак, пирог, гарнир... 

после указания в поле нужного значения, рецепт будет размещен в аналогичной категории.

но у нас в кулинарной книге есть аналогичные категории, только во множественном числе, например, Закуски, Вторые блюда, Салаты...

в результате получается двойная категоризация и двойное отображение в кулинарной книге.

есть идеи, что с этим можно сделать? переименовать в викиданных эти значения - перевести во множественное число? — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 16:00, 26 мая 2026 (UTC)
: Я не знаю [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:46, 28 мая 2026 (UTC)
: Оооо да! Я давно заметил это и в прошлых темах предлагал к обсуждению этот вопрос. Я сторонник стандарта Викиданных, банально потому что это стандартизировано под Википедию. Но вот другие что об этом думают? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:47, 14 июня 2026 (UTC)
:: Я за викиданные, но что делать - переименовывать или нет - не знаю. Есть возможсноть оставить в единственном числе в ВД, а категории иметь в множественном? [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 16:53, 15 июня 2026 (UTC)
::: Кажется нет. Это невозможно будет автоматизировать &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 00:09, 16 июня 2026 (UTC)

== Полки в Кулинарной книге ==
можно ли в кулинарной книге сделать еще одну корневую полку и как? например, полку Кулинарные процессы, аналогично Ингредиенты — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 13:59, 26 мая 2026 (UTC)
: И на этот вопрос я не знаю ответа [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:46, 28 мая 2026 (UTC)
: эээээ, можно...&lt;br&gt; но что там будет? Примерно? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:44, 14 июня 2026 (UTC)

== [[Викиучебник:Каталог учебников/Список]] ==
не обновляется — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 08:36, 22 мая 2026 (UTC)
: тэкс, значит бот мой сломался. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 13:34, 22 мая 2026 (UTC)

== [[Шаблон:К быстрому удалению|Шаблон:КБУ]] ==
как часто удаляются страницы, помеченные этим шаблоном?

их удаляет бот или админ вручную? — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 07:28, 22 мая 2026 (UTC)
: Админ. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:48, 22 мая 2026 (UTC)
:кто-то из админов или подводящих итоги может пройтись и удалить [https://ru.wikibooks.org/wiki/Служебная:Ссылки_сюда?target=Шаблон%3AК+быстрому+удалению&amp;namespace=&amp;limit=500 статьи с данным шаблоном] в основном пространстве и пространстве полок? частично это нужно, чтобы переименовать другие страницы + пустые страницы/полки. [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 08:25, 23 мая 2026 (UTC)
:: Ну, я не админ, надо Лексея пингануть @[[Участник:Leksey|Leksey]] [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 14:17, 24 мая 2026 (UTC)
:: Удалил!
:: @[[Участник:Kylaix|Kylaix]] посмотри, плиз, почему в категорию включило статьи, где только ссылка  на шаблон. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 21:49, 25 мая 2026 (UTC)
:::не могу переименовать [[Введение в дифференциальные уравнения]] в Дифференциальные уравнения - &quot;Переименование невозможно: страница с таким именем уже существует&quot;. но я не нашла такой страницы [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 09:56, 28 мая 2026 (UTC)
:::: Она в перенаправлении &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 17:12, 28 мая 2026 (UTC)
::::: [[Дифференциальные уравнения]] удалена и нет на этом месте перенаправления [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:42, 28 мая 2026 (UTC)
::::: там СО была и она мешала [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:44, 28 мая 2026 (UTC)
:::: переименовал [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:45, 28 мая 2026 (UTC)
:::аналогично не могу переименовать [[Постулат Бертрана]] в Теория чисел/Постулат Бертрана [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 09:57, 28 мая 2026 (UTC)
:::: переименовал [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:44, 28 мая 2026 (UTC)
::: @[[Участник:Leksey|Leksey]] Если в Ссылки сюда нажать кнопки Скрыть ссылки и Скрыть перенаправления , то будет показываться только включения, то есть только страницы которые надо удалить. Вот ссылка: https://ru.wikibooks.org/wiki/%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:%D0%A1%D1%81%D1%8B%D0%BB%D0%BA%D0%B8_%D1%81%D1%8E%D0%B4%D0%B0?target=%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%3A%D0%9A+%D0%B1%D1%8B%D1%81%D1%82%D1%80%D0%BE%D0%BC%D1%83+%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D1%8E&amp;namespace=&amp;hidelinks=1&amp;hideredirs=1&amp;limit=50 [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 11:11, 29 мая 2026 (UTC)

== Сколько уровней полок поддерживается? ==
например, в [[Викиучебник:Каталог учебников/Список]]? Сейчас только два уровня, например, Языки - Языки Европы. А может быть 3-й, 4-й и т.д уровни? — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 17:13, 21 мая 2026 (UTC)
: По идее - да, там вроде бесконечная вложенность, главное только правильно оформлять полки. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:50, 14 июня 2026 (UTC)

== [[Полка:Компьютеры]] ==
все доп. полки почему-то задублированы, например, Программирование фигурирует дважды — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 09:50, 21 мая 2026 (UTC)

:исправила через Править код [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 10:22, 21 мая 2026 (UTC)
: О, спасибо что убрали. Ранее они просто добавлялись в ручную. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 13:36, 22 мая 2026 (UTC)

== Не обновляются Полки ==
1. Дополнительные полки:
[[Полка:Теория чисел]], на ней лежит учебник [https://ru.wikibooks.org/wiki/Теория_чисел Теория чисел], но в учебнике в шаблоне Название учебника указана категория не Теория чисел, а Математика (я ее сделала доп. полкой на основной полке Формальные науки). почему учебник таки находится на данной полке? из-за того, что у него внизу указана категория Теория чисел?

аналогично [[Полка:Дифференциальные уравнения]], [[Полка:Математический анализ]], [[Полка:Алгебра]], [[Полка:Занимательная математика]].

2. Основные полки: [[Полка:Компьютеры]], [[Полка:Естественные науки]], [[Полка:Языки]], [[Полка:Досуг]], [[Полка:Техника]], [[Полка:Гуманитарные науки]]

существует ли бот, который обновляет полки? уже прошло несколько дней, но полки не обновились, кнопка Очистить кэш не помогает — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 07:55, 21 мая 2026 (UTC)

== [[Теория музыки для математиков]] ==
в шаблоне Название учебника две Категории - Музыка, Математика

но на полке [[Полка:Математика|Математика]] он не появляется

почему?

потому что это Основная полка?

нужно указать вместо нее Дополнительную полку в шаблоне? — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 18:24, 20 мая 2026 (UTC)
: Последнее верно. Это основная полка а требуется дополнительная полка. Я правда не знаю как ее можно было назвать, но раздел бы стоило создать. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:11, 20 мая 2026 (UTC)

== КУ ==
[[Викиучебник:К удалению/Май 2026]] Прошу всех обратить внимание. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:31, 20 мая 2026 (UTC)

:создала в вики страницу [[w:Биографический_метод|Биографический метод]]
:может, их связать? и поставить в учебнике шаблон, что это заготовка. может, кто заинтересуется и начнет наполнять учебник? [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 18:36, 20 мая 2026 (UTC)

== Полка и категория ==
чем отличается [[Полка:Математика]] от [https://ru.wikibooks.org/wiki/Категория:Математика Категория:Математика]? 

зачем нужны полки?

почему не ограничиться только категориями? 

например, сгласно полкам учебных пособий 2 шт, согласно категориям находится еще 100 шт учебных пособий ... — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 18:26, 19 мая 2026 (UTC)
: Категорию проставляют в статьях, на полке же список статей. К тому же, зачем традиции ломать? [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:32, 20 мая 2026 (UTC)
::выглядит, как дублирующий инструмент
::тем паче, что рецепты на категориях строятся [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 18:21, 20 мая 2026 (UTC)
::: Иронично что вы оба правы. Категории, по сути, помогают работе шаблонов и модулей для организации каталога учебников. А каталог учебников кажется сейчас наиболее удобным средством для поиска нужных книг. Было бы круто не использовать категории, но к сожалению иначе организовать полки было бы невозможно или, как минимум, труднее на порядок. Ну и да, + это еще и дань традициям - в Википедии, к примеру, они до сих пор используются.
::: Кстати, напоминаю, что категории в статьях проставляются через {{tl|Название учебника}} и для рецептов через {{tl|Рецепт}}. Касательно разницы в полках и категориях: просто те 98 учебников еще не обработаны через эти шаблоны. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:08, 20 мая 2026 (UTC)

== Страницы учебника на полке ==
на полке [[Полка:Математика|Математика]] есть полка [[Полка:Теория чисел|Теория чисел]]

на ней лежит учебник [[Теория чисел]]

и страница из учебника [[Теория чисел/Постулат Бертрана]]

что не есть правильно - на полке должны быть только учебники

аналогично на полке [[Полка:Дифференциальные уравнения|Дифференциальные уравнения]]

как удалить страницы учебника с полки? — [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 07:03, 19 мая 2026 (UTC)
: Привет.&lt;br&gt; Я пока не знаю причину, ищу ошибку в шаблонах. Тем не менее, большая просьба либо создавать эти учебники уже на существующих полках, либо же переименовать их так, чтобы не совпадали с названием полки. Это может быть одной из причин. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 07:40, 19 мая 2026 (UTC)
:: Подтверждаю. Учебники не стоит называть одинаково с названием полки. Более того, не стоит создавать отдельные полки для каждого учебника. Я оставил лишь полку с теорией чисел, учебник про диффуры перенес в полку матанализа. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 08:01, 19 мая 2026 (UTC)
:::спасибо!
:::но дифференециальные уравнения - это не матан, это отдельный [[w:Разделы_математики#Математика_как_учебная_дисциплина|учебный раздел математики]]
:::поэтому для него была создана своя полка
:::иначе можно обойтись вообще без полок и все учебники размещать на полке Математика [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 09:05, 19 мая 2026 (UTC)
:::: Ну, я понимаю что его в целом выделяют, но тут проблема именно Викиучебника. У нас пока* мало книг и имеет смысл их пока отводить в гораздо более крупные разделы, чем это делается в науке.&lt;br&gt; &lt;nowiki&gt;*&lt;/nowiki&gt;надеюсь все же мы сможем хотя бы перевести достаточное количество книг, а еще лучше написать сами в ближайшее время. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 09:27, 19 мая 2026 (UTC)
:::::тогда можно сделать полку Другие разделы
:::::в нее отнести все, что не Алгебра и не Геометрия [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 09:30, 19 мая 2026 (UTC)
:::::: Хорошо, сделаю. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 09:41, 19 мая 2026 (UTC)
:::::::я все перенесла в Алгебру/Геометрию [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 13:05, 19 мая 2026 (UTC)
:::::::ненужные страницы пометила КБУ в пространствах - Основное, Полка [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 13:55, 19 мая 2026 (UTC)

== Как привязать учебник к другой полке? ==
например, [[Дифференциальные уравнения]] к полке [[Полка:Дифференциальные уравнения|Дифференциальные уравнения]]— [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 17:46, 17 мая 2026 (UTC)
: @[[Участник:Kylaix|Kylaix]] ответишь? [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:50, 17 мая 2026 (UTC)
:или достаточно в учебнике в шаблоне &quot;Название учебника&quot; указать нужные значения в Категория? и бот привяжет учебник, куда нужно? в какой время отрабатывает бот? явно, сразу не после правки Категория [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 10:02, 18 мая 2026 (UTC)
:: Да да да, в категорию просто вписываете полку и бот пройдет (один раз в день делает проходку) и ваша книга попадет на полку. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 14:44, 18 мая 2026 (UTC)

== CAPTCHA ==
при сохранении правок возникает:
CAPTCHA: Для редактирования страницы, пожалуйста, введите буквы, которые видны на изображении ниже

это из-за того, что я новичок? или так всегда будет?— [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 16:29, 17 мая 2026 (UTC)
: Никогда такого не видел. Конечно пройдет.
: А можете кинуть на почту скриншот leksey@ya.ru&lt;br&gt; Интересно посмотреть даже.
: Я посмотрю, может вам можно статус подкрутить руками, но вроде я такого не видел. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:49, 17 мая 2026 (UTC)
: Попытался поменять вам группу, но все что мне дает это. Наверное, когда вы попадете в группу &quot;Автоподтвержденные&quot;, то отпустит. Как это работает - я не знаю. У вас же по идее глобальный аккаунт и специально в Учебнике вы вчера условно не регились?
: {{Цитата|Группы, которые вы можете изменять&lt;ul&gt;&lt;li&gt;исключение из IP-блокировок&lt;/li&gt;&lt;li&gt;организаторка мероприятий&lt;/li&gt;&lt;/ul&gt;}} [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:55, 17 мая 2026 (UTC)
: Посмотрел у себя - я состою в неяавной группе [[Викиучебник:Автоподтверждённые участники]]
: 4 дня стажа хочет после отдельной регистрации в Викиучебнике
: {{Цитата|В случае регистрации [[w:Википедия:Единая_учётная_запись|в другом проекте]] фонда [[w:Викимедиа|Викимедиа]] и стаж, и правки отсчитываются в нашем разделе отдельно: эти статусы в разных проектах между собой не связаны.}} [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:57, 17 мая 2026 (UTC)
:: Вот и настройка, что за это отвечает https://noc.wikimedia.org/wiki.php?wiki=ruwikibooks#wgAutoConfirmAge [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 18:01, 17 мая 2026 (UTC)
: Пропала у вас капча? [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 19:01, 19 мая 2026 (UTC)

== [[Теория чисел]] ==
создала [[Полка:Теория чисел]], и учебник [[Теория чисел]]

но они не связаны, как их связать?— [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 19:47, 15 мая 2026 (UTC)

:уже связались [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 10:03, 18 мая 2026 (UTC)

== [[Полка:Теория чисел]] ==
создала [[Полка:Теория чисел]], но она не появилась визуально внутри [[Полка:Математика]]

что делать?— [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 19:45, 15 мая 2026 (UTC)

:Неудачно попробовал, может появится кто-то из админов. Подозреваю, что, возможно, там используются викиданные для этого, надо уточнить. [[Участник:Def2010|Def2010]] ([[Обсуждение участника:Def2010|обсуждение]]) 11:01, 16 мая 2026 (UTC)
:Как-то коряво добавил, список определяется страницей [[Викиучебник:Каталог учебников/Список]]. [[Участник:Def2010|Def2010]] ([[Обсуждение участника:Def2010|обсуждение]]) 11:18, 16 мая 2026 (UTC)
:: Список определяется ботом в проходке, лучше его не трогать (по возможности, конечно же)&lt;br&gt; Там вся суть в кэше, часто после добавления чего-либо теперь в каталоге или где-либо еще надо обновить кэш, чтобы заработало. В целом, все полки кажется появились, хотя там есть некоторые странности с тем, что некоторые полки не существуют. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 14:42, 18 мая 2026 (UTC)
:::Да, там вроде сутки прошли после добавления перед моими правками, но бот не стал добавлять в список. [[Участник:Def2010|Def2010]] ([[Обсуждение участника:Def2010|обсуждение]]) 20:42, 18 мая 2026 (UTC)
:::: Что странно. Надо будет мне весь код проверить, и кажется я в свое время не все там доработал. Может быть из-за этого. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 07:40, 19 мая 2026 (UTC)

== Флаг бота ==
Прошу присвоить флаг бота [[Участник:Taratarussia's Bot|моему боту]]. Бот будет откатывать мат в статьях Викиучебника. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 16:39, 11 мая 2026 (UTC)
: @[[Участник:Leksey|Leksey]] @[[Участник:Kylaix|Kylaix]] [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 16:39, 11 мая 2026 (UTC)
:: @[[Участник:Валерий Стариков|Валерий Стариков]] [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 16:46, 11 мая 2026 (UTC)
:: Я не знаю как это делать, но, наверное, разберусь.
:: Но я не уверен, что такой бот нужен. Вроде нет проблемы с матом как таковой. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 22:33, 11 мая 2026 (UTC)
::: Я тоже так думаю, но, НО, пока он будет мат откатывать, а позже я расширю функционал. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 11:27, 12 мая 2026 (UTC)
: Привет. Код хороший, но насколько актуально использовать это, если есть фильтры? И еще вопрос: вы его с консоли хотите использовать? Я бы рекомендовал для ботов использовать Toolforge &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 17:27, 11 мая 2026 (UTC)
:: Я только знаю как запускать с консоли [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 17:53, 11 мая 2026 (UTC)
::: @[[Участник:Kylaix|Kylaix]] [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 17:53, 11 мая 2026 (UTC)
::: Не переживайте за это, я могу вам помочь перенести на toolforge, это не сложно. Вопрос только состоит в актуальности &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:56, 11 мая 2026 (UTC)
:::: @[[Участник:Kylaix|Kylaix]] Спасибо за помощь, я готов перенести, время есть. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 11:29, 12 мая 2026 (UTC)
::::: @[[Участник:Leksey|Leksey]] что думаешь? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 14:14, 12 мая 2026 (UTC)
:::::: @[[Участник:Kylaix|Kylaix]] Я зарегистрировался на Toolforge и подал заявку на участие. Краткое описание написал на русском языке. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 15:10, 12 мая 2026 (UTC)
::::::: А вы на нейронке пишете бота? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 16:53, 12 мая 2026 (UTC)
:::::::: В общем, да. Я не умею учебники писать, а пользу проекту приносить хочу. Единственный выход — боты. Но питон я не знаю, поэтому использую нейросети. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 16:55, 12 мая 2026 (UTC)
::::::::: Я сам ботовод, подумаю что вам придумать в задачи. Сам хотя и знаю питон, писал @[[Участник:Kylaixbot|Kylaixbot]] при помощи ИИ &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:00, 12 мая 2026 (UTC)
::::::::: Мне кажется, проекту нужны авторы. Остальное все пока нет авторов - несущественно и не нужно. А авторы вряд ли появятся так как проект не закрывает какие-то насущные задачи людей. Или же людй вполне устраивают другие платформы и способы обучения. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 19:01, 12 мая 2026 (UTC)
:::::::::: У меня нет телеграма. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:16, 13 мая 2026 (UTC)
::::::::::: Раз важны статьи, я могу заняться переводами с других проектов. Но думаю, что лучше чтобы был бот, так на фоне, если вдруг что будет, то сможет откатить. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:24, 13 мая 2026 (UTC)
:::::::::::: Я не уверен, что переводы автоматические нужны. Сейчас любой сам может себе что угодно перевести одним или тремя нажатиями. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 20:17, 13 мая 2026 (UTC)
:::::: Я думаю, что нам это не надо. Так как я не вижу пробемы вандализма с матом конкретно.
:::::: Актуален вопрос отката всего вклада вандала &quot;одним нажатием&quot;, но скрипт из Википедии у нас тут не работает. Вот его бы заставить работать. 
:::::: Также имеет смысл уведомлять администратора (через СО или через телеграм)  о самих фактах вандализма, чтобы он пришел и откатил все. Той самой одной кнопкой. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 18:31, 12 мая 2026 (UTC)
::::::: Можно попробовать сделать бота, который будет откатывать все правки заблокированных участников. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:16, 13 мая 2026 (UTC)
:::::::: Трудновато. Не всегда вклад негативный. Можно конечно по причине блокировки ловить (вандализм). Было бы круто если бы попробовали написать бота, а я гляну его, вот тогда стоит дать флаг. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 15:51, 13 мая 2026 (UTC)
::::::::: Опишите подробнее что хотите, и попробую что-либо сделать. С уважением, [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 18:53, 13 мая 2026 (UTC)
:::::::: Я предпочту откатывать скриптом вручную, но надо чтобы он заработал. Есть JS-скрипт, который в Викиучебнике не работает.&lt;br&gt; А вот о необходимости прийти и откатить уведомление бы не помешало. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 20:15, 13 мая 2026 (UTC)
::::::::: Не могли бы вы скинуть ссылку на скрипт, я попробую оптимизировать. Возможно, дело в ограничениях в скрипте, или в расширениях которых нет в ВУ. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 11:27, 14 мая 2026 (UTC)
:::::::::: Пожалуйста [[Участник:Leksey/common.js]]
:::::::::: Вот обсуждение [[w:Служебная:GoToComment/c-Leksey-20260402155500-Вопрос_по_администрированию_Викиучебника]] [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 16:11, 14 мая 2026 (UTC)
:::::::::: Вот тут я перечислил административные средства имеющиеся сейчас [[Викиучебник:Инструменты_администратора]] [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 16:17, 14 мая 2026 (UTC)
:::::::::: Вот еще с такой проблемой столкнулся [[Обсуждение шаблона:Цитата#Не работает свойство &quot;Источник&quot;]]. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:48, 14 мая 2026 (UTC)
::::::::::: Шаблон починил, любуйтесь. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 11:23, 15 мая 2026 (UTC)
:::::::::::: @[[Участник:Leksey|Leksey]] Вот исправный код (хотя я не знаю у меня не проверяется, у меня нет кнопок откатить:))&lt;br&gt; // Mass Rollback for MediaWiki&lt;br&gt; // Универсальная версия для Википедии, Викиучебника и других вики
:::::::::::: if (typeof wkRollbackPortlet === &quot;undefined&quot;) {&lt;br&gt; var wkRollbackPortlet = &quot;p-tb&quot;;&lt;br&gt; }
:::::::::::: // Откат одной правки&lt;br&gt; function rollbackOneThingWKMR(edit, rbMetadata) {
:::::::::::: var userName;
:::::::::::: // Для IP-участников&lt;br&gt; if (rbMetadata.userName === null) {
:::::::::::: userName = $(edit)&lt;br&gt; .parents(&quot;li:first&quot;)&lt;br&gt; .find(&quot;a.mw-anonuserlink&quot;)&lt;br&gt; .first()&lt;br&gt; .text();
:::::::::::: } else {
:::::::::::: userName = rbMetadata.userName;
:::::::::::: }
:::::::::::: var titleMatch = /title=([^&amp;]+)/.exec(edit.href);
:::::::::::: if (!titleMatch) {&lt;br&gt; console.error(&quot;Не удалось определить страницу&quot;);&lt;br&gt; return;&lt;br&gt; }
:::::::::::: var pageTitle = decodeURIComponent(titleMatch[1]);
:::::::::::: var params = {};
:::::::::::: if (rbMetadata.editSummary !== &quot;&quot;) {&lt;br&gt; params.summary = rbMetadata.editSummary;&lt;br&gt; }
:::::::::::: rbMetadata.api.rollback(pageTitle, userName, params)
:::::::::::: .done(function () {
:::::::::::: console.log(&quot;Откат:&quot;, pageTitle);
:::::::::::: $(edit).after(&lt;br&gt; '&lt;span style=&quot;color:green;font-weight:bold;&quot;&gt; [откачено]&lt;/span&gt;'&lt;br&gt; );
:::::::::::: $(edit).remove();
:::::::::::: })
:::::::::::: .fail(function (code, data) {
:::::::::::: console.error(&quot;Ошибка rollback:&quot;, code, data);
:::::::::::: $(edit).after(&lt;br&gt; '&lt;span style=&quot;color:red;font-weight:bold;&quot;&gt; [ошибка]&lt;/span&gt;'&lt;br&gt; );
:::::::::::: });&lt;br&gt; }
:::::::::::: // Откат всех&lt;br&gt; function rollbackEverythingWKMR(editSummary) {
:::::::::::: if (editSummary === null) {&lt;br&gt; return false;&lt;br&gt; }
:::::::::::: if (&lt;br&gt; mw.config.get(&quot;wgRelevantUserName&quot;) ===&lt;br&gt; mw.config.get(&quot;wgUserName&quot;)&lt;br&gt; ) {
:::::::::::: if (&lt;br&gt; !confirm(&lt;br&gt; &quot;Вы собираетесь откатить ВСЕ свои правки. Продолжить?&quot;&lt;br&gt; )&lt;br&gt; ) {&lt;br&gt; return false;&lt;br&gt; }&lt;br&gt; }
:::::::::::: mw.loader.using([&quot;mediawiki.api&quot;]).done(function () {
:::::::::::: var rbMetadata = {};
:::::::::::: rbMetadata.api = new mw.Api();
:::::::::::: rbMetadata.userName =&lt;br&gt; mw.config.get(&quot;wgRelevantUserName&quot;);
:::::::::::: rbMetadata.editSummary = editSummary;
:::::::::::: $(&quot;a[href*='action=rollback']&quot;).each(function (ind, el) {
:::::::::::: rollbackOneThingWKMR(el, rbMetadata);
:::::::::::: });
:::::::::::: });
:::::::::::: return false;&lt;br&gt; }
:::::::::::: // Откат выбранных&lt;br&gt; function rollbackSomeThingsWKMR(editSummary) {
:::::::::::: if (editSummary === null) {&lt;br&gt; return false;&lt;br&gt; }
:::::::::::: mw.loader.using([&quot;mediawiki.api&quot;]).done(function () {
:::::::::::: var rbMetadata = {};
:::::::::::: rbMetadata.api = new mw.Api();
:::::::::::: rbMetadata.userName =&lt;br&gt; mw.config.get(&quot;wgRelevantUserName&quot;);
:::::::::::: rbMetadata.editSummary = editSummary;
:::::::::::: var rollbackList = $(&quot;input.revdelIds:checked&quot;)&lt;br&gt; .parents(&quot;li&quot;)&lt;br&gt; .find(&quot;a[href*='action=rollback']&quot;);
:::::::::::: if (rollbackList.length &lt;= 0) {
:::::::::::: mw.notify(&quot;Не выбрано ни одной правки.&quot;);
:::::::::::: return;&lt;br&gt; }
:::::::::::: rollbackList.each(function (ind, el) {
:::::::::::: rollbackOneThingWKMR(el, rbMetadata);
:::::::::::: });
:::::::::::: });
:::::::::::: return false;&lt;br&gt; }
:::::::::::: // Главная часть&lt;br&gt; mw.loader.using([&lt;br&gt; &quot;mediawiki.util&quot;,&lt;br&gt; &quot;mediawiki.api&quot;&lt;br&gt; ]).done(function () {
:::::::::::: mw.hook('wikipage.content').add(function () {
:::::::::::: // Только на странице вкладов&lt;br&gt; if (&lt;br&gt; mw.config.get(&quot;wgCanonicalSpecialPageName&quot;) !==&lt;br&gt; &quot;Contributions&quot;&lt;br&gt; ) {&lt;br&gt; return;&lt;br&gt; }
:::::::::::: // Уже добавлено&lt;br&gt; if ($(&quot;#ca-rollbackeverything&quot;).length) {&lt;br&gt; return;&lt;br&gt; }
:::::::::::: // Проверяем наличие rollback&lt;br&gt; if ($(&quot;a[href*='action=rollback']&quot;).length &lt;= 0) {
:::::::::::: console.log(&quot;Rollback ссылки не найдены&quot;);
:::::::::::: return;&lt;br&gt; }
:::::::::::: console.log(&quot;MassRollback загружен&quot;);
:::::::::::: // Добавляем чекбоксы&lt;br&gt; $(&quot;ul.mw-contributions-list li&quot;).each(function () {
:::::::::::: // Уже есть чекбокс&lt;br&gt; if ($(this).find(&quot;input.revdelIds&quot;).length) {&lt;br&gt; return;&lt;br&gt; }
:::::::::::: var rollbackLink = $(this)&lt;br&gt; .find(&quot;a[href*='action=rollback']&quot;);
:::::::::::: if (rollbackLink.length &gt; 0) {
:::::::::::: $(this)&lt;br&gt; .find(&quot;a.mw-changeslist-date&quot;)&lt;br&gt; .first()&lt;br&gt; .before(&lt;br&gt; &quot;&lt;input type='checkbox' class='revdelIds' style='margin-right:5px;'&gt;&quot;&lt;br&gt; );&lt;br&gt; }&lt;br&gt; });
:::::::::::: // Кнопка Rollback all&lt;br&gt; mw.util.addPortletLink(&lt;br&gt; wkRollbackPortlet,&lt;br&gt; &quot;#&quot;,&lt;br&gt; &quot;Rollback all&quot;,&lt;br&gt; &quot;ca-rollbackeverything&quot;,&lt;br&gt; &quot;Откатить все правки&quot;&lt;br&gt; );
:::::::::::: // Кнопка Rollback selected&lt;br&gt; mw.util.addPortletLink(&lt;br&gt; wkRollbackPortlet,&lt;br&gt; &quot;#&quot;,&lt;br&gt; &quot;Rollback selected&quot;,&lt;br&gt; &quot;ca-rollbacksome&quot;,&lt;br&gt; &quot;Откатить выбранные правки&quot;&lt;br&gt; );
:::::::::::: // Обработка кнопки ALL&lt;br&gt; $(&quot;#ca-rollbackeverything&quot;).click(function (event) {
:::::::::::: event.preventDefault();
:::::::::::: rollbackEverythingWKMR(&lt;br&gt; prompt(&lt;br&gt; &quot;Введите комментарий отката:&quot;&lt;br&gt; )&lt;br&gt; );
:::::::::::: });
:::::::::::: // Обработка кнопки SELECTED&lt;br&gt; $(&quot;#ca-rollbacksome&quot;).click(function (event) {
:::::::::::: event.preventDefault();
:::::::::::: rollbackSomeThingsWKMR(&lt;br&gt; prompt(&lt;br&gt; &quot;Введите комментарий отката:&quot;&lt;br&gt; )&lt;br&gt; );
:::::::::::: });
:::::::::::: });
:::::::::::: }); [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 12:10, 15 мая 2026 (UTC)
::::::::::::: Блин. Мне стремно выполнять непонятный JS. Можете диф показать как-нить или объяснить что за правка была сделана.
::::::::::::: Да и идея править ИИ мне конечно не нравится, но других предложений нет. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:52, 17 мая 2026 (UTC)
:::::::::::: Починилось, спасибо! [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 17:50, 17 мая 2026 (UTC)
Прекрасно, если понадобится помощь — обращайтесь на мою СО. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 19:52, 17 мая 2026 (UTC)
Если не работает, вот это попробуйте:
&lt;pre&gt;if (typeof wkContribsCheckboxInit === &quot;undefined&quot;) {
	wkContribsCheckboxInit = false;
}

if (typeof wkRollbackPortlet === &quot;undefined&quot;) {
	wkRollbackPortlet = &quot;p-cactions&quot;;
}

function getContributionItem(el) {
	return $(el).closest(&quot;li, tr, .mw-contribs-list-item&quot;);
}

function getRollbackLinks(scope) {
	return scope.find(&quot;a[href*='action=rollback']&quot;);
}

function rollbackEverythingWKMR(editSummary) {
	if (editSummary === null) {
		return false;
	}

	if (mw.config.get(&quot;wgRelevantUserName&quot;) === mw.config.get(&quot;wgUserName&quot;)) {
		if (!confirm(&quot;You are about to roll back *all* of *your own* edits. Please note that this will be very difficult to undo. Are you *ABSOLUTELY SURE* you want to do this?&quot;)) {
			return false;
		}
	}

	mw.loader.using(&quot;mediawiki.api&quot;).done(function () {
		var rbMetadata = {};
		rbMetadata.api = new mw.Api();
		rbMetadata.userName = mw.config.get(&quot;wgRelevantUserName&quot;);
		rbMetadata.ipRange = (rbMetadata.userName === null);
		rbMetadata.titleRegex = /title=([^&amp;]+)/;
		rbMetadata.editSummary = editSummary;

		$(&quot;a[href*='action=rollback']&quot;).each(function (ind, el) {
			rollbackOneThingWKMR(el, rbMetadata);
		});
	});

	return false;
}

function rollbackSomeThingsWKMR(editSummary) {
	if (editSummary === null) {
		return false;
	}

	mw.loader.using(&quot;mediawiki.api&quot;).done(function () {
		var rbMetadata = {};
		rbMetadata.api = new mw.Api();
		rbMetadata.userName = mw.config.get(&quot;wgRelevantUserName&quot;);
		rbMetadata.titleRegex = /title=([^&amp;]+)/;
		rbMetadata.editSummary = editSummary;

		var rollbackList = $(&quot;input.revdelIds:checked&quot;).each(function () {
			var item = getContributionItem(this);
			item.find(&quot;a[href*='action=rollback']&quot;).each(function (ind, el) {
				rollbackOneThingWKMR(el, rbMetadata);
			});
		});

		if ($(&quot;input.revdelIds:checked&quot;).length &lt;= 0) {
			mw.notify(&quot;You didn't select any edits that could be rolled back!&quot;);
			return;
		}
	});

	return false;
}

function rollbackOneThingWKMR(edit, rbMetadata) {
	var userName;

	var item = getContributionItem(edit);

	if (rbMetadata.userName === null) {
		userName = item.find(&quot;a.mw-anonuserlink&quot;).not(&quot;.mw-contributions-title&quot;).first().text();
	} else {
		userName = rbMetadata.userName;
	}

	if (!userName) {
		return;
	}

	var params = {};
	if (rbMetadata.editSummary != '') {
		params.summary = rbMetadata.editSummary;
	}

	var titleMatch = rbMetadata.titleRegex.exec(edit.href);
	if (!titleMatch) {
		return;
	}

	rbMetadata.api.rollback(decodeURIComponent(titleMatch[1]), userName, params).done(function () {
		$(edit).after(&quot;reverted&quot;);
		$(edit).remove();
	});
}

$(document).ready(function () {
	if (mw.config.get(&quot;wgCanonicalSpecialPageName&quot;) == &quot;Contributions&quot; &amp;&amp; $(&quot;a[href*='action=rollback']&quot;).length &gt; 0) {
		mw.loader.using(&quot;mediawiki.util&quot;).done(function () {
			mw.util.addPortletLink(wkRollbackPortlet, '#', &quot;Rollback all&quot;, &quot;ca-rollbackeverything&quot;, &quot;rollback all edits displayed here&quot;);

			if (!wkContribsCheckboxInit) {
				if ($(&quot;input.revdelIds&quot;).length === 0) {
					$(&quot;a[href*='action=rollback']&quot;).each(function (ind, el) {
						var item = getContributionItem(el);
						item.find(&quot;a&quot;).first().before(&quot;&lt;input type='checkbox' class='revdelIds'&gt;&amp;nbsp;&quot;);
						item.find(&quot;input.revdelIds&quot;).data(&quot;index&quot;, ind);
					});
				} else {
					$(&quot;input.revdelIds&quot;).each(function (ind, el) {
						$(el).data(&quot;index&quot;, ind);
					});
				}
				wkContribsCheckboxInit = true;
			}

			mw.util.addPortletLink(wkRollbackPortlet, '#', &quot;Rollback selected&quot;, &quot;ca-rollbacksome&quot;, &quot;rollback selected edits&quot;);

			$(&quot;#ca-rollbackeverything&quot;).click(function (event) {
				event.preventDefault();
				mw.loader.load(&quot;mediawiki.api&quot;);
				return rollbackEverythingWKMR(prompt(&quot;Rollback all edits: Enter an edit summary, or leave blank to use the default (or hit Cancel to cancel the rollback entirely)&quot;));
			});

			$(&quot;#ca-rollbacksome&quot;).click(function (event) {
				event.preventDefault();
				mw.loader.load(&quot;mediawiki.api&quot;);
				return rollbackSomeThingsWKMR(prompt(&quot;Rollback selected edits: Enter an edit summary, or leave blank to use the default (or hit Cancel to cancel the rollback entirely)&quot;));
			});

			$(&quot;#ca-rollbacksome&quot;).data(&quot;lastSelectedIndex&quot;, -1);

			$(&quot;input.revdelIds&quot;).off(&quot;click&quot;).click(function (ev) {
				var lastSelectedRevdel = $(&quot;#ca-rollbacksome&quot;).data(&quot;lastSelectedIndex&quot;);
				var newIndex = $(this).data(&quot;index&quot;);

				if (ev.shiftKey &amp;&amp; lastSelectedRevdel &gt;= 0) {
					var checkboxArray = $(&quot;input.revdelIds&quot;);
					var start = lastSelectedRevdel;
					var stop = newIndex;

					if (start &lt; stop) {
						for (var i = start; i &lt; stop; i++) {
							if (i != lastSelectedRevdel) {
								$(checkboxArray[i]).prop(&quot;checked&quot;, !($(checkboxArray[i]).prop(&quot;checked&quot;)));
							}
						}
					} else {
						for (var i = start; i &gt; stop; i--) {
							if (i != lastSelectedRevdel) {
								$(checkboxArray[i]).prop(&quot;checked&quot;, !($(checkboxArray[i]).prop(&quot;checked&quot;)));
							}
						}
					}
				}

				$(&quot;#ca-rollbacksome&quot;).data(&quot;lastSelectedIndex&quot;, newIndex);
			});
		});
	}
});&lt;/pre&gt;
[[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 18:13, 15 мая 2026 (UTC)

=== Итог ===
* Флаг не присвоен, но зато починен скрипт и шаблон. [[Участник:Taratarussia|СССР]] ([[Обсуждение участника:Taratarussia|обсуждение]]) 15:52, 18 мая 2026 (UTC)

== Изменение шаблона «Родственные проекты» ==
К сожалению, Викиновости полностью закрылись на всех языках решением Фонда Викимедиа. Поэтому, считаю целесообразным убрать Викиновости из шаблона, как уже сделали на https://meta.wikimedia.org/wiki/Main_Page/ru. Сам я не могу, поэтому прошу местных администраторов сделать. С уважением, СССР (обсуждение) 16:07, 8 мая 2026 (UTC)
: @[[Участник:Leksey|Leksey]] сможете поправить шаблон? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:21, 13 мая 2026 (UTC)
:: Сделал. И предлагаю на ты. [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 20:20, 13 мая 2026 (UTC)

== Вопрос с [[ВУ:КУ]] ==

Я тут ставил цель в прошлом году закончить с КУ, но кажется там у меня небольшой тупик с этим. И я вспомнил почему я хотел побыстрее с этим покончить: я хотел переделать КУ, чтобы там можно было удобнее все это просматривать и, если надо - автоматизировать. Я конечно не предлагаю вести ежедневный КУ (да и от ежемесячного тоже думал бы отказаться, так как все равно небольшие неудобства) а перейти на годовой (то есть одна страница чисто для 2026) и возможно, оставлять ее сразу на [[ВУ:КУ]]. Думаю, номинаций много не будет в скором времени, поэтому есть время об этом подумать и реализовать (если, конечно, будет согласие) &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 00:04, 3 января 2026 (UTC)

Я вижу, вы тут снесли что-то 1Сное, а [[Служебная:Неиспользуемые файлы|несвободные файлы удалить забыли]].&lt;br&gt;
Файлы Хедина в Цивилизции оформлены неправильно: должны быть переоформлены или удалены по [[ВУ:КДИ]]#10а и в. Он не является &quot;автором или правообладателем&quot;, а &quot;иллюстрирование&quot; не является валидной причиной для содержания несвободного файла. А после переоформления около трети должна быть удалена по 8 пункту.&lt;br&gt; 
И, раз уж написал, примерно половину статей господина Пинчука снесли на enКнигах в прошлом году. — Ирука&lt;sup&gt;[[u:Iruka13|13]]&lt;/sup&gt; 18:44, 10 января 2026 (UTC)
: ээ, вроде 1сное не сносил особо, кроме каких-то 2-3 файлов, с согласия других (надо поискать в КУ). До несвободных файлов рука не добралась, там вообще желательно обсуждение.&lt;br&gt;Ровно так же как и с Цивой, потому что иллюстрирование в играх по КДИ, как мне кажется, у нас под вопросом. Я замечал случаи, где иллюстрирование необходимо как в руководствах Хедина, поэтому тут под вопросом. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 15:41, 15 января 2026 (UTC)

== Категории кулинарной книги ==

&lt;s&gt;Коль ниже нас похоронили, решу немного покопаться в гробу&lt;/s&gt;. Касательно категорий: нам надо их слегка вложить друг в друга чтобы это отображалось цивильно, да и для удобства поиска. Например: категории огурцы, помидоры и баклажан стоило бы вложить в овощи, а китайская, японская, корейская кухня в восточно-азиатские кухни и т.д. Хотелось бы услышать мнения касательно данного действа. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:42, 28 декабря 2025 (UTC)
: @[[Участник:Leksey|Leksey]] @[[Участник:Heffalump1974|Heffalump1974]] @[[Участник:Erokhin|Erokhin]] &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:42, 28 декабря 2025 (UTC)
:Можно на примерах показать? [[Участник:Erokhin|Erokhin]] ([[Обсуждение участника:Erokhin|обсуждение]]) 22:11, 28 декабря 2025 (UTC)
:: См. [[Кулинарная книга]], спускаемся ниже до [[:Категория:Европейская кухня]] и там видим подкухни, которые я ранее посчитал европейскими. Если бы их там не было, то кухни бы догнали список ингредиентов на странице кулинарной книги по длине. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 15:38, 29 декабря 2025 (UTC)
::: ? &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 15:55, 15 января 2026 (UTC)
::::Соглашусь, хорошо бы перетасовать предлагаемым образом.
::::Сам не возьмусь, пока без компьютера. [[Участник:Heffalump1974|Heffalump1974]] ([[Обсуждение участника:Heffalump1974|обсуждение]]) 14:03, 5 мая 2026 (UTC)
::::: Категоризировал, и стало теперь приятнее смотреть на не слишком длинные списки. Оценка за вами, @[[Участник:Leksey|Leksey]], @[[Участник:Heffalump1974|Heffalump1974]] :)&lt;br&gt; Там единственное есть дубляжи (Баклажан и баклажаны, орех и орехи) надо бы определиться в каком числе категоризировать их. Мне кажется лучше в единственном числе, потому что так будет логично. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 19:26, 13 мая 2026 (UTC)
:::::: А куда смотреть? Я уже забыл все [[Участник:Leksey|Leksey]] ([[Обсуждение участника:Leksey|обсуждение]]) 20:18, 13 мая 2026 (UTC)
::::::: [[Викиучебник:Кулинарная книга]] и туда снизу. &lt;span style=&quot;font-family:TimesNewRoman;&quot;&gt;[[Участник:Kylaix|'''''Kylain Aixter''''' ]] ([[Обсуждение участника:Kylaix|СО]]) &lt;/span&gt; 20:23, 13 мая 2026 (UTC)
::::::зависит от того, как этот объект назван в элементе викиданных, если Баклажан, то и у нас должно быть также [[Участник:AllaBuraya|AllaBuraya]] ([[Обсуждение участника:AllaBuraya|обсуждение]]) 18:03, 17 мая 2026 (UTC)


&lt;!-- Сообщение отправил Участник:Keegan (WMF)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=29905753 --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Vote now in the 2026 U4C election&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;announcement-content&quot; /&gt;
Eligible voters are asked to participate in the 2026 [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee|Universal Code of Conduct Coordinating Committee]] election. More information–including an eligibility check, voting process information, candidate information, and a link to the vote–are available on Meta at the [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee/Election/2026|2026 Election information page]]. The vote closes on 2 June 2026 at [https://zonestamp.toolforge.org/1780358400 00:00 UTC].

Please vote if your account is eligible. Results will be available by 14 June 2026. -- In cooperation with the U4C,&lt;section end=&quot;announcement-content&quot; /&gt;
&lt;/div&gt;

[[m:User:Keegan (WMF)|Keegan (WMF)]] ([[m:User talk:Keegan (WMF)|talk]]) 17:14, 27 мая 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Keegan (WMF)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=30513860 --&gt;

== RFC about AI-generated content in Wikimedia Commons ==

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Apologies for writing in English, please help translate this message to your language. You are invited to participate in a [[c:Commons:Requests for comment/Policy update for AI content|request for comment on Wikimedia Commons about a policy update for AI content]]. This may affect files that are uploaded to Wikimedia Commons for use on this project. Thank you. [[m:User:Codename Noreste|Codename Noreste]] ([[m:User talk:Codename Noreste|обсуждение]])&lt;/bdi&gt; 17:11, 23 июня 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Codename Noreste@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=30513860 --&gt;

== Размещение ссылок на контакты по вопросам права и безопасности в нижнем колонтитуле вашего вики-проекта ==

&lt;section begin=&quot;Message&quot;/&gt;
'''Контакты по вопросам права и безопасности'''

Дорогие участники сообщества, Фонд Викимедиа сформировал [[wmf:Special:MyLanguage/Legal:Wikimedia Foundation Legal and Safety Contact Information|единую страницу с контактами по вопросам права и безопасности]] для размещения в нижних колонтитулах ваших проектов соответствующих ссылок на нее, чтобы обеспечить доступ к достоверной юридической информации. Это нормативное требование. Мы уже разместили эти ссылки в английском, немецком, итальянском, испанском и других проектах Википедии, и мы также скоро добавим это и в ваш вики-проект. [[m:Special:MyLanguage/Wikimedia_Foundation_Legal_and_Safety_Contacts_FAQ|Пожалуйста, ознакомьтесь более подробно на странице проекта]] и оставляйте любые комментарии в этой ветке или на [[m:Special:MyLanguage/Talk:Wikimedia Foundation Legal and Safety Contacts FAQ|странице обсуждений]].

&lt;section end=&quot;Message&quot;/&gt;

-- [[User:Sannita (WMF)|User:Sannita (WMF)]] ([[User talk:Sannita (WMF)|talk]]) 13:30, 25 июня 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Sannita (WMF)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=User:Sannita_(WMF)/Mass_sending_test&amp;oldid=30731267 --&gt;

== Request for comment (the future of Abstract Wikipedia) ==

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;
Apologies if this has not yet been translated into your wiki's language. {{int:Please-translate}}
You are invited to voice your opinions in a [[:m:Requests for comment/The future of Abstract Wikipedia|request for comment about the future of Abstract Wikipedia]]. {{Int:Feedback-thanks-title}}
[[:m:User:Kowal2701|Kowal2701]] ([[:m:User talk:Kowal2701|talk]])  12:24, 24 июля 2026 (UTC)
&lt;/bdi&gt;

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:DreamRimmer@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=30513860 --&gt;

== Переключение сервера: ваш вики-проект скоро на короткое время будет доступен в режиме «только для чтения» ==
&lt;section begin=&quot;server-switch&quot;/&gt;&lt;div class=&quot;plainlinks&quot;&gt;

[[:m:Special:MyLanguage/Tech/Server switch|Прочитать это сообщение на другом языке]] • [https://meta.wikimedia.org/w/index.php?title=Special:Translate&amp;group=page-Tech%2FServer+switch&amp;language=&amp;action=page&amp;filter= {{int:please-translate}}]

[[foundation:|Фонд Викимедиа]] будет переключать трафик между своими центрами обработки данных. Это гарантирует, что Википедия и другие вики-проекты Викимедиа смогут оставаться доступными даже после катастрофы.

Весь трафик будет переключен '''{{#time:j xg|2026-09-23|ru}}'''. Переключение начнётся в '''[https://zonestamp.toolforge.org/{{#time:U|2026-09-23T14:00|en}} {{#time:H:i e|2026-09-23T14:00}}]'''.

К сожалению, ввиду некоторых ограничений движка [[mw:Special:MyLanguage/Manual:What is MediaWiki?|MediaWiki]], редактирование будет остановлено в течение этих двух переключений. Приносим свои извинения за задержку в работе. Мы работаем над тем, чтобы сократить такие работы в будущем. 

За 30 минут до начала переноса во всех проектах будет показан баннер-предупреждение. Этот баннер будет оставаться видимым до окончания операции. 
Вы можете внести вклад в [https://meta.wikimedia.org/w/index.php?title=Special%3ATranslate&amp;group=Centralnotice-tgroup-read_only_banner&amp;task=view&amp;language=&amp;filter=&amp;action=translate перевод или вычитку] этого текста баннера.

'''В течение короткого промежутка времени вы сможете читать, но не сможете редактировать все вики-сайты.'''

* День переключения — {{#time:l j xg Y|2026-09-23|ru}}. Оно продлится не более часа.
* При попытке отредактировать или сохранить страницы в течение этого времени вы увидите сообщение об ошибке. Мы надеемся, что правки в этот период не будут потеряны, но не можем этого гарантировать. Если вы увидите сообщение об ошибке, пожалуйста, подождите, пока всё не восстановится. После этого вы сможете сохранить свою правку. Но на всякий случай мы рекомендуем вам сделать копию ваших изменений.

''Побочные эффекты'':

* Фоновые задания будут выполняться замедленно, а некоторые могут быть отклонены. Красные ссылки могут также обновляться с замедлением. Если вы создаёте статью, на которую уже есть ссылки откуда-то, то такие ссылки будут оставаться красными дольше, чем обычно. Некоторые долго выполняющиеся скрипты необходимо будет остановить.
* Мы ожидаем, что развёртывание кода произойдет так же, как и на любой другой неделе. Однако могут происходить некоторые зависания кода, если впоследствии этого потребует данная операция.
* [[mw:Special:MyLanguage/GitLab|GitLab]] будет недоступен примерно 90 минут.

При необходимости эти планы могут быть отложены. Вы можете [[wikitech:Switch_Datacenter|посмотреть расписание на wikitech.wikimedia.org]]. О любых изменениях будет сообщено в расписании. 

'''Пожалуйста, поделитесь этой информацией с вашим сообществом.'''&lt;/div&gt;&lt;section end=&quot;server-switch&quot;/&gt;

[[m:user:Trizek (WMF)|Trizek (WMF)]] 12:58, 15 сентября 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Trizek (WMF)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Non-Technical_Village_Pumps_distribution_list&amp;oldid=30513874 --&gt;

== Your feedback wanted: Remove ''(Language link added:) and similar'' edits from Special:RecentChanges ==
''(Apologies for posting in English. You can help by translating it)''

Hello, I’m Danny from [[:en:w:Wikimedia_Deutschland|Wikimedia Deutschland’s]] [[m:Wikidata_For_Wikimedia_Projects|Wikidata For Wikimedia Projects]] team.&lt;br/&gt;
We have been investigating and examining how Wikidata’s use in the [[Special:RecentChanges]] and [[Special:Watchlist]] pages can be made to be more useful, or less ‘noisy’ (fewer edits that have little value to the reader).

We are currently exploring to make a change in the volume and the type of Wikidata edits that appear in these pages, and '''we need your feedback''' to help us ensure this is a positive change for the Wikis and won’t disrupt your workflows.&lt;br/&gt;
Language links are also known as sitelinks or interlanguage links and describe when a Wikidata item is connected to a Wiki, adding it to the language dropdown tool for other connected Wikis.
[[File:Types of Lang Link changes.png|x350px|frame|A variety of &quot;Language Link&quot; edits as seen in the Recent Changes feed]]

The request for feedback is whether you support the removal of these language link edits from the Recent Changes and Watchlist feed, or would you oppose such a change and if so, why?
Please share you thoughts on the dedicated '''[[m:Talk:Wikidata_For_Wikimedia_Projects/Clearer_Wikidata_Edit_Summaries/Hide_Language_Link_edits|metawiki Talk page]]'''. 

Further information about this change: [[m:Wikidata_For_Wikimedia_Projects/Clearer_Wikidata_Edit_Summaries/Hide_Language_Link_edits|m:Wikidata_For_Wikimedia_Projects/Hide_Language_Link_edits]]

Thank you for any participation or feedback you give, -- [[m:User:Danny_Benjafield_(WMDE)|User:Danny Benjafield (WMDE)]] 11:46, 25 сентября 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Danny Benjafield (WMDE)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=User:Danny_Benjafield_(WMDE)/MassMessage_test_list&amp;oldid=31080832 --&gt;

== Wikidata Sitelink changes in Recent Changes and Watchlist ==
''(Apologies for cross-posting in English, translating it will help spread the message)''

Editors on group 1 wikis, including Wikiquote, Wikibooks, Wikiversity, Wikivoyage, and Wikisource, will no longer see notifications on [[Special:RecentChanges|Recent Changes]] and [[Special:Watchlist|Watchlist]] when a link to ''another'' language version of a page is added, removed, or changed in its Wikidata item. This change will begin on '''October 5 at 07:00 UTC''' as a two-week trial to reduce high-volume, low-value notifications and make higher-value changes easier to identify. Editors who rely on these notifications should be aware of the change and can share feedback or concerns on the [[m:Wikidata For Wikimedia Projects/Clearer Wikidata Edit Summaries/Hide Language Link edits|project]] or [[m:Talk:Wikidata_For_Wikimedia_Projects/Clearer_Wikidata_Edit_Summaries/Hide_Language_Link_edits|talk page]].&lt;br/&gt;Please reach out if you have any questions, thank you! -- [[User:Danny_Benjafield_(WMDE)|Danny Benjafield (WMDE)]] ([[User_talk:Danny_Benjafield_(WMDE)|talk]])  sent via [[Участник:MediaWiki message delivery|MediaWiki message delivery]] ([[Обсуждение участника:MediaWiki message delivery|обсуждение]]) 12:42, 1 октября 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Danny Benjafield (WMDE)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=User:Danny_Benjafield_(WMDE)/MassMessage_test_list&amp;oldid=31106967 --&gt;

== Переключение сервера: ваш вики-проект скоро на короткое время будет доступен в режиме «только для чтения» ==
&lt;section begin=&quot;server-switch&quot;/&gt;&lt;div class=&quot;plainlinks&quot;&gt;
[[:m:Special:MyLanguage/Tech/Server switch|Прочитать это сообщение на другом языке]] • [https://meta.wikimedia.org/w/index.php?title=Special:Translate&amp;group=page-Tech%2FServer+switch&amp;language=&amp;action=page&amp;filter= {{int:please-translate}}]

[[foundation:|Фонд Викимедиа]] будет переключать трафик между своими центрами обработки данных. Это гарантирует, что Википедия и другие вики-проекты Викимедиа смогут оставаться доступными даже в случае катастрофы.

Весь трафик будет переключён '''{{#time:j xg|2026-10-28|ru}}'''. Переключение начнётся в '''[https://zonestamp.toolforge.org/{{#time:U|2026-10-28T15:00|en}} {{#time:H:i e|2026-10-28T15:00}}]'''.

К сожалению, ввиду некоторых ограничений движка [[mw:Special:MyLanguage/Manual:What is MediaWiki?|MediaWiki]], редактирование будет остановлено в течение этих двух переключений. Приносим свои извинения за задержку. Мы стараемся сократить такие заминки в будущем. 

За 30 минут до начала переноса во всех проектах будет показан баннер-предупреждение. Этот баннер будет оставаться видимым до окончания работ. 
Вы можете помочь [https://meta.wikimedia.org/w/index.php?title=Special%3ATranslate&amp;group=Centralnotice-tgroup-read_only_banner&amp;task=view&amp;language=&amp;filter=&amp;action=translate с переводом или вычиткой] этого текста.

'''В течение короткого промежутка времени вы сможете читать, но не сможете редактировать все вики-сайты.'''

* День переключения — {{#time:l j xg Y|2026-10-28|ru}}. Оно продлится не более часа.
* При попытке отредактировать или сохранить страницы в течение этого времени будет показано сообщение об ошибке. Мы надеемся, что правки в этот период не будут потеряны, но не можем этого гарантировать. Если вы увидите сообщение об ошибке, пожалуйста, подождите, пока всё не восстановится. После этого вы сможете сохранить свою правку. Но на всякий случай мы рекомендуем сделать копию ваших изменений.

''Побочные эффекты'':

* Фоновые задания будут выполняться замедленно, а некоторые могут быть отклонены. Красные ссылки могут также обновляться с замедлением. Если вы создаёте статью, на которую уже есть ссылки, то они будут оставаться красными дольше, чем обычно. Некоторые долго выполняющиеся скрипты необходимо будет остановить.
* Мы ожидаем, что развёртывание нового кода произойдёт как обычно. Однако в отдельных случаях код могут частично замораживать, если это потребуется для работ.
* [[mw:Special:MyLanguage/GitLab|GitLab]] будет недоступен примерно 90 минут.

При необходимости планы по переключению серверов могут быть отложены. Расписание работ [[wikitech:Switch_Datacenter|см. на wikitech.wikimedia.org]]. Там же будет сообщаться о всех изменениях. 

'''Пожалуйста, поделитесь этой информацией с вашим сообществом.'''&lt;/div&gt;&lt;section end=&quot;server-switch&quot;/&gt;

[[user:Trizek_(WMF)|Trizek_(WMF)]] 14:01, 26 октября 2026 (UTC)

(This message was sent to [[:Викиучебник:Форум]] and is being posted here due to a redirect.)
&lt;!-- Сообщение отправил Участник:Trizek (WMF)@metawiki, используя список на странице https://meta.wikimedia.org/w/index.php?title=Distribution_list/Non-Technical_Village_Pumps_distribution_list&amp;oldid=30513874 --&gt;</text>
      <sha1>azdwls03c3z05e8kc7w59o4s3zuf1rb</sha1>
    </revision>
  </page>
  <page>
    <title>Си++</title>
    <ns>0</ns>
    <id>1351</id>
    <revision>
      <id>270434</id>
      <parentid>258294</parentid>
      <timestamp>2026-10-27T07:37:47Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270434</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="4964" sha1="917by28dlg3hlcndpqaei7jy4mv1pub" xml:space="preserve">{{Название учебника
|Категория = Программирование
|Готовность = 75%
|Тип = Многостраничный
}}
{{wikipedia|Си++}}
Это — вводный курс по [[Объектно-ориентированное программирование|объектно-ориентированному]] [[Программирование|программированию]] на языке [[w:C++|Си++]].

Материал изложения примерно соответствует части курса ООП ФИТ НГУ ([[w:Новосибирский государственный университет|Новосибирский государственный университет]]) за третий семестр, касающейся Си++, а также классическим книгам Страуструп/Эллис (около 1990) и Саттер/Александреску (около 2000).

Смотрите [http://ccfit.nsu.ru/~rylov/oop.html список тем к экзамену].

== Введение ==
Язык C++ сравнивается с С, который считается уже известным читателю. За отправную точку принят стандарт C89 (он же C90). По следующим причинам:
* Стандарт C99 не реализован полностью ни в [[w:GCC|GCC]] [http://gcc.gnu.org/c99status.html], ни [[w:Visual C++|Visual C++]] [http://stackoverflow.com/questions/146381/visual-studio-support-for-new-c-c-standards].
* В учебнике брать за исходную точку следует стандарт, который реализован полностью и уже давно, а не тот, работа по реализации которого ещё не закончена.

Си++ - и без того довольно сложный язык, чтобы ещё запутывать читателя подробностями о том, какие свойства C99 где реализованы.

Некоторые конструкции («два слеша») и inline давно реализованы во многих компиляторах Си. Это не делает их частью стандартa C99.

== Содержание ==
* [[/Препроцессорные директивы/]]
* [[/Основные отличия Си++ от Си/]]
* [[/Объектно-ориентированное программирование/]]
* [[/Обобщённое программирование/]]
* [[/Стандартная библиотека/]]
* [[/Разные вопросы/]]
* [[/DLL]]

== Эпилог ==
Некоторые люди интересовались, откуда берутся так часто употребляемые ''метасинтатические переменные'' &lt;tt&gt;foo&lt;/tt&gt;, &lt;tt&gt;bar&lt;/tt&gt; и тому подобные. На английском происхождение данных слов очень хорошо описано в {{RFC|3092}}. (Также, если вы знаете английский, см. [http://klubkev.org/~ksulliva/rfc-april1/ полный список первоапрельских RFC].)

Если Вы возьмётесь править этот викиучебник, пожалуйста, соблюдайте правила русской [[w:Типографика|типографики]]. О том, как это делается см. [[w:Википедия:Специальные символы|Википедия: Специальные символы]].

== См. также ==
* [[Реализации алгоритмов]]

=== C ===
* [[Язык Си в примерах]]
* [[w:Си (язык программирования)|Си]]/[[w:ANSI C|ANSI C]]/[[w:C99|C99]]/[[w:C11|C11]]
* [[:w:Категория:Статьи с примерами кода Си|Категория: Статьи с примерами кода Си]]

=== C++ ===
* [[w:C++|C++]]/[[w:C++11|C++11]]/[[w:C++14|C++14]]/[[w:C++17|C++17]]
* [[w:Boost|Boost]]
* [[:w:Категория:Статьи с примерами кода C++|Категория: Статьи с примерами кода C++]]

== Ссылки ==
* [https://my-specialist.ru/chto-takoe-c-tendencii-i-spros-na-razrabotchikov-etot-yazyk-programmirovaniya/ Что такое C++? Тенденции и спрос разработчиков на этот язык программирования]
* [https://isocpp.org/ News, Status &amp; Discussion about Standard C++]
* [http://www.cplusplus.com/ The C++ Resources Network]
* [http://www.books.ru/cc-9001536/ Книги C/C++ (584) Books.ru]
* [http://kak-tot.narod.ru/ru/otd-bs2e/index.htm Книга Б. Страуструпа &quot;Язык программирования С++&quot;]
* {{dmoz|Computers/Programming/Languages/C%2B%2B/|C++}}</text>
      <sha1>917by28dlg3hlcndpqaei7jy4mv1pub</sha1>
    </revision>
  </page>
  <page>
    <title>Семейство стандартов SNMP</title>
    <ns>0</ns>
    <id>3266</id>
    <revision>
      <id>270432</id>
      <parentid>258859</parentid>
      <timestamp>2026-10-27T07:33:29Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270432</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="57999" sha1="qgra6ntu61zfxlkxs7an3gu01v0hxkp" xml:space="preserve">{{Название учебника|Тип=Одностраничный|Категория=Компьютерные сети,Информационная безопасность}}
{{wikipedia|SNMP}}
Семейство стандартов простого протокола управления сетями (Simple Network Management Protocol, SNMP) предназначено для управления сетями. Семейство определено сообществом проектирования Интернета (Internet Engineering Task Force, IETF) и является частью семейства стандартов Интернета.

== О книге ==

Первоначальный автор — [[w:Участник:Anrie Nord|Anrie Nord]].

Книга стремится познакомить со стандартами в области управления сетями, а также научить архитектурным принципам семейства стандартов SNMP. Архитектура рассматривается в рамках классификации сетевых программных архитектур&lt;ref name=&quot;fielding&quot;&gt;Fielding R. T. Architectural Styles and the Design of Network-based Software Architectures. Ph. D. Dissertation. — University of California, Irvine. — 2000. http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm&lt;/ref&gt;. Описывается история развития стандартов и даются комментарии по причинам принятия новых версий SNMP.

== Стандарты управления сетями ==

Помимо стандартов SNMP сообщества IETF есть стандарты, принимаемые международными органами стандартизации&lt;ref name=&quot;pras&quot;&gt;Pras A. Internet Management Protocols Course — University of Twente, 2000. http://www.simpleweb.org/&lt;/ref&gt;; вот крупнейшие из них:

{| class=&quot;wide&quot;
 ! Организация || Стандарты || Особенности
 |-
 | IETF || SNMP       || Управление должно быть простым, ориентировано на переменные
 |-
 |ISO   || CMIP, CMIS || Управление должно быть мощным, объектно-ориентированное
 |-
 |ITU-T || TMN        || Определяется только архитектура
 |-
 |DMTF  || WBEM, CIM  || Управление сетями и системами, объектно-ориентированное
 |-
 |OMG   || CORBA      || Архитектура удалённых объектов
 |}

Ныне самым успешным семейством стандартов является SNMP&lt;ref name=&quot;pras&quot; /&gt;; он лидирует по числу управляемых систем (агентов). Управляющие системы (менеджеры) обычно поддерживают множество стандартов, поэтому здесь сложно говорить о лидерстве SNMP. По количеству вложенных денег, возможно, лидирует Telecommunications Management Network (TMN).

Показательно проследить зависимость популярности стандартов от среды их применения. В локальных и глобальных сетях передачи данных, использующих Протокол интернета (Internet Protocol, IP) наиболее широко распространён стандарт SNMP. В системах учрежденческих автоматических телефонных станций (УАТС) и в публичных телефонных сетях наиболее часто используются проприетарные решения. В мобильных сетях в основном используются решения на основе стандартов Международной Стандартизационной Организации (ISO).

Почти все успехи SNMP связаны с особенностями процесса стандартизации в IETF:
* Стандарты бесплатны и свободно распространяемы
* Стандарты легко доступны в электронной форме
* Быстрое развитие стандартов, продуманные этапы стандартизации
* На всех этапах ведётся техническая экспертиза
* Рабочие группы возглавляют технические, а не политические лидеры
* Прототипы систем на основе стандартов демонстрируют их применимость

== Задачи ==

Функциональные группы задач управления системами определены в стандарте ITU-T X.700:
* Управление конфигурацией (Configuration Management)
* Обработка ошибок (Fault Management)
* Анализ производительности и надёжности (Performance management)
* Управление безопасностью (Security Management)
* Учёт работы (Accounting Management)

Семейство стандартов SNMP создано для решения задач обработки ошибок и анализа производительности и надёжности.

;Обработка ошибок:выявление, определение и устранение последствий сбоев и отказов в работе сети&lt;ref&gt;Олифер В. Г., Олифер Н. А. Компьютерные сети. Принципы, технологии, протоколы. — СПб.: Питер, 2001&lt;/ref&gt;. На этом уровне выполняется регистрация сообщений об ошибках, их фильтрация, маршрутизация и анализ на основе некоторой корреляционной модели.

;Анализ производительности и надёжности:оценка на основе статистической информации таких параметров, как время реакции системы, пропускная способность каналов связи, интенсивность трафика в отдельных сегментах сети, вероятность искажения данных, коэффициент готовности служб сети. Результаты такого анализа позволяют контролировать соглашение об уровне обслуживания (Service Level Agreement, SLA).

Согласно идеологии SNMP, управление должно быть простым, пусть даже ценой потери мощности, масштабируемости и защищённости&lt;ref name=&quot;pras&quot; /&gt;. Поэтому при разработке стандартов SNMP учитывались следующие условия:

* Повсеместность. Системы под управлением SNMP могут быть любыми и могут быть везде: от принтеров до мейнфреймов
* Простота добавления управляющих функций. Управляемая система ограничена в функциональности управления, очень проста и не может контролировать себя. Вместо этого все управляемые системы контролирует сложная управляющая система, функциональность которой можно расширять
* Устойчивость в критических ситуациях. Например, при перегрузке и проблемах в сети, т. е. при множественных ошибках

== История ==

Одной из самых первых инициатив по управлению сетями была инициатива ISO Open Systems Interconnection (OSI). Соответствующие группы по стандартизации инфраструктуры управления OSI (OSI Management Framework) были созданы в 1981 году.

К концу 1980-х годов сеть Интернет стала достаточно большой и потребовала стандартов управления. Однако группа ISO OSI была далека от завершения работ над семейством стандартов. Поэтому в 1987 году сообществом IETF было принято решение ''временно'' создать набор упрощённых стандартов управления в Интернете на основе наработок ISO OSI. Данные стандарты получили название Simple Network Management Protocol (SNMP). В дальнейшем предполагалось переключиться на стандарты ISO по мере их готовности. Таким образом, многие идеи SNMP были взяты из стандартов ISO:

* Концепция «менеджер-агент»
* Идея баз управляющей информации (Management Information Bases, MIBs)
* Использование синтаксиса Abstract Syntax Notation One (ASN.1)
* Часть терминологии

Другими проектом стандарта, на базе которого началась разработка SNMP, был проект простого протокола мониторинга шлюзов (Simple Gateway Monitoring Protocol, SGMP) сообщества IETF.

В дальнейшем в рамках ISO OSI было предложено много новых идей, в частности, объектно-ориентированный подход. Однако эти идеи уже не вошли в стандарты SNMP. Одно время IETF продолжала инициативу CMIP over TCP (CMOT), которая предполагала использование общего протокола управляющей информации (Common Management Information Protocol, CMIP) стека протоколов ISO OSI в стеке IETF TCP/IP. В 1992 году эта инициатива была прекращена в связи с успехом и распространённостью SNMP.

Стандарты SNMP продолжали развиваться на протяжении 1990-х годов. Основным направлением развития было совершенствование вопросов безопасности. Были разработаны следующие версии SNMP: SNMPv1, SNMPv2, SNMPv2c, SNMPv2u и SNMPv3. Их обсуждение будет продолжено в главе «Версии SNMP».

== Архитектура ==

Архитектуру распределённой системы можно описать в терминах обрабатывающих элементов (или компонентов), соединяющих элементов (или соединителей) и элементов данных&lt;ref&gt;Perry D. E., Wolf A. L. Foundations for the Study of Software Architecture // ACM SIGSOFT Software Engineering Notes. — 1992. — #17(4). — pp. 40-52&lt;/ref&gt;. Перечислим составные элементы системы управления SNMP&lt;ref name=&quot;snmp-arch&quot;&gt;Harringson D., et al. An Architecture for Describing SNMP Management Frameworks. IETF STD 62, {{RFC|3411}}. — 2002. http://www.ietf.org/rfc/rfc3411.txt&lt;/ref&gt;:

* Компоненты
** Агент
** Менеджер
* Соединители
** Транспортный протокол
** Протокольные блоки данных (Protocol Data Units, PDU) и сообщения SNMP
* Данные
** Управляющая информация MIB

Опишем подробнее и проанализируем архитектуру SNMP с позиции достижения поставленных перед SNMP целей. Для этого используем понятие архитектурного стиля сетевого программного обеспечения&lt;ref name=&quot;fielding&quot;/&gt;. '''Архитектурный стиль''' — это согласованный набор архитектурных ограничений, накладываемых на роли и особенности архитектурных элементов (компонентов, соединителей и данных) и отношений между ними, проявляющийся в любой архитектуре, которая удовлетворяет этому стилю.

=== Компоненты ===

Вначале поговорим об архитектурных компонентах. Архитектура SNMP предполагает построение системы управления по схеме «менеджер-агент», т. е. использование архитектурного стиля «клиент-сервер». Система SNMP содержит множество управляемых узлов, на каждом из которых размещается достаточно простой сервер — агент SNMP, а также, по крайней мере, один узел, содержащий сложного клиента — менеджера SNMP.

Менеджер взаимодействует с агентами при помощи протокола SNMP с целью обмена управляющей информацией. В основном, это взаимодействие реализуется в виде ''периодического опроса'' менеджером множества агентов, т. к. агенты всего лишь предоставляют доступ к информации, но не знают, что им с ней делать. Видно, что система, построенная по таким принципам, теряет в масштабируемости, поскольку есть выделенный клиент, занимающийся опросом всех серверов. Зато такая схема обеспечивает простоту реализации систем под управлением SNMP.

Для повышения масштабируемости и административной управляемости вводится понятие прокси-агента, который может переправлять операции протокола SNMP, а также понятие менеджера промежуточного уровня, который скрывает несущественные подробности управляющей информации от систем управления сетями верхнего уровня, интегрируя получаемые от агентов данные. Это позволяет создавать многоуровневые системы управления, соответствующие архитектурному стилю «многоуровневый клиент-сервер».

Более детальная классификация компонентов по ролям:

* Менеджер
** Менеджер промежуточного уровня
** Система управления сетями
* Агент
** Минимальный агент
** Прокси-агент
** Менеджер промежуточного уровня

Компоненты в SNMP обобщённо называются '''сущностями SNMP'''.

=== Данные ===

Теперь рассмотрим данные, которыми манипулируют системы SNMP, т. е. управляющую информацию. В SNMP каждое управляемое устройство, на котором расположен агент, представляет свою управляющую информацию в виде '''переменных'''. Такими переменными могут быть, например, имя системы, время с момента её перезапуска, записи в таблице маршрутизации и т. д. В общем случае переменные можно разделить на:

* Скалярные переменные
* Таблицы переменных

Схема данных описывается структурой управляющей информации (Structure of Management Information, SMI). Схема данных определяет, как выглядит управляющая информация, т. е. описывает её синтаксис. SMI базируется на Abstract Syntax Notation One (ASN.1).

Конкретные наборы управляющей информации для разных типов устройств, протоколов и т. д. описываются базами управляющей информации (Management Information Bases, MIBs). Базы MIB определяют, какая управляющая информация существует. Например, для устройства, поддерживающего IP, MIB описывает таблицу маршрутизации, флажок активации функции маршрутизации, число переданных и принятых пакетов, число ошибок различного характера и т. д.

Таким образом, каждое устройство содержит набор значений переменных, определённых в некотором количестве MIB, описанных по правилам SMI. Этот набор переменных и является данными, управляющей информацией для протокола SNMP.

Важным вопросом является именование переменных. В SNMP каждой переменный присваивается уникальный идентификатор объекта (Object Identifier, OID). Пространство имён OID является иерархическим и контролируется организацией по распределению номеров в Интернете (Internet Assigned Numbers Authority, IANA). Каждый компонент имени является числом. В текстовом виде имена записываются как десятичные числа, разделённые точками, слева направо. Числам могут быть поставлены в соответствие текстовые строки для удобства восприятия. В целом, структура имени похожа на систему доменных имён Интернета (Domain Name System, DNS).

Каждая MIB определяет набор переменных, т. е. определённую ветку дерева OID, описывающую управляющую информацию в определённой области. Например, ветка &lt;code&gt;1.3.6.1.2.1.1&lt;/code&gt; (мнемонический эквивалент: &lt;code&gt;iso.org.dod.internet.mgmt.mib-2.system&lt;/code&gt;) описывает общую информацию о системе. Опишем некоторые переменные из этой ветки:

* &lt;code&gt;sysDescr&lt;/code&gt; (&lt;code&gt;1.3.6.1.2.1.1.1&lt;/code&gt;) — краткое описание системы
* &lt;code&gt;sysUpTime&lt;/code&gt; (&lt;code&gt;1.3.6.1.2.1.1.3&lt;/code&gt;) — время с момента последнего перезапуска
* &lt;code&gt;sysName&lt;/code&gt; (&lt;code&gt;1.3.6.1.2.1.1.5&lt;/code&gt;) — имя системы

Переменные и сведения об их типе определены также в MIB. А сами типы переменных — в SMI.

Помимо непосредственно данных, необходимо ввести операции над ними. Набор этих операций изменялся и расширялся по мере развития SNMP. Основными операциями являются:

* Чтение переменной
* Запись переменной
* Чтение переменной, следующей за заданной переменной (требуется для просмотра таблиц переменных)

Более подробно операции над данными описаны ниже при обсуждении соединителей в архитектуре SNMP.

В целом, операции над данными в SNMP похожи на удалённую отладку некоторого приложения: состояние системы описывается неким набором переменных, которые можно просматривать и изменять.

=== Соединители ===
Для обмена данными между компонентами используются соединители. В случае SNMP в качестве соединителя используется протокол прикладного уровня Simple Network Management Protocol (SNMP), обычно работающий поверх стека протоколов UDP/IP. Современные стандарты SNMP разрешают использование и других транспортных протоколов.

Рассмотрим стек протоколов более подробно, указав привязку протоколов к Open Systems Interconnection Reference Model (OSI RM).

{| class=&quot;wide&quot;
 ! # || Протокол || Комментарий
 |-
 | 7   || SNMP      || Сообщения, PDU, операции
 |-
 | 6   || ASN.1 BER || Кодирование данных
 |-
 | 5   || —         || —
 |-
 | 4   || UDP       || Транспорт между службами
 |-
 | 3   || IP        || Связь между узлами сети
 |}

SNMP вводит свой протокол прикладного уровня. Имеются четыре версии данного протокола: SNMPv1, SNMPv2, SNMPv2c и SNMPv3. В процессе развития SNMP расширялись возможные операции, т. е. типы протокольных блоков данных (Protocol Data Units, PDUs), а также вводились новые форматы сообщений SNMP для обеспечения безопасности.

Сообщение SNMP содержит номер версии SNMP, информацию о безопасности и протокольный блок данных PDU, который характеризует выполняемую операцию и её параметры. Например, SNMPv1 описывает следующие PDU и соответствующие операции:

* &lt;code&gt;Get-Request&lt;/code&gt; — запрос на получение значений 1..N переменных
* &lt;code&gt;Get-Next-Request&lt;/code&gt; — запрос на получение значений 1..N переменных, чьи OID идут следом за OID указанных 1..N переменных
* &lt;code&gt;Get-Response&lt;/code&gt; — ответ на запросы &lt;code&gt;Get-Request&lt;/code&gt;, &lt;code&gt;Get-Next-Request&lt;/code&gt; и &lt;code&gt;Set-Request&lt;/code&gt;
* &lt;code&gt;Set-Request&lt;/code&gt; — установка значений 1..N переменных
* &lt;code&gt;Trap&lt;/code&gt; — ловушка (см. ниже)

Описанные PDU, как уже упоминалось, являются частью сообщения SNMP. Сообщения кодируются для передачи по сети при помощи ASN.1 Basic Encoding Rules (BER). Это функция шестого уровня (уровня представления) эталонной модели OSI. Далее закодированные сообщения отправляются одним компонентом SNMP другому при помощи транспортного протокола.

Как уже отмечалось, стандарт предусматривает использование различного транспорта для SNMP, но почти что всегда используется протокол пользовательских датаграмм (User Datagram Protocol, UDP). Агенты используют хорошо известный порт UDP 161. Этот протокол предоставляет минимальные транспортные услуги (доставка сообщений от службы к службе и проверка контрольной суммы) и не предполагает организацию сеансов и потоковую передачу данных, как Transmission Control Protocol (TCP). За счёт этого удаётся добиться большой скорости реакции и быстродействия, что соответствует поставленным перед SNMP целям.

Для повышения скорости реакции менеджера на срочные события вводится специальный тип операции протокола SNMP, называемый «ловушка» (&lt;code&gt;Trap&lt;/code&gt;). Он позволяет агентам асинхронно информировать менеджера (по собственной инициативе) о наступлении ограниченного числа значимых событий. В этом случае агент выступает в необычной для себя роли клиента, а менеджер — в роли сервера. В случае использования транспорта UDP для входящих соединений менеджер использует хорошо известный порт UDP 162.

Как мы видим, ни одна из этих операций не предполагает, что агент хранит информацию о сессии с менеджером. Для выполнения операции &lt;code&gt;Trap&lt;/code&gt; такая информация хранится статически, т. е. сессия в таком случае статична и перманентна. Помимо этого операции SNMP определяют единые, унифицированные интерфейсы агентов и менеджеров SNMP. Таким образом, SNMP — это протокол без сохранения состояния, который соответствует архитектурному стилю «унифицированный многоуровневый клиент-сервер без сохранения состояния».

Опишем некоторые свойства операций SNMP на примере SNMPv1:

{| class=&quot;wide&quot;
 ! Имя  || Безопасная || Подтверждаемая || Идемпотентная
 |-
 | &lt;code&gt;Get-Request&lt;/code&gt;      || 1            || 1                || 1
 |-
 | &lt;code&gt;Get-Next-Request&lt;/code&gt; || 1            || 1                || 1
 |-
 | &lt;code&gt;Get-Response&lt;/code&gt;     || 1            || 0                || ?
 |-
 | &lt;code&gt;Set-Request&lt;/code&gt;      || 0            || 1                || ?
 |-
 | &lt;code&gt;Trap&lt;/code&gt;             || 1            || 0                || ?
 |}

Таким образом, мы рассмотрели все основные архитектурные особенности SNMP, кроме моделей безопасности. Вопросы, связанные с защитой информации, будут рассмотрены ниже при обсуждении версий стандартов SNMP.

== Соответствие архитектурному стилю REST ==

'''Архитектурный стиль REST''' — это унифицированный многоуровневый кэшируемый клиент-серверный стиль с кодом по запросу и без сохранения состояния (Unified-Layered-Code-on-Demand-Client-Cached-Stateless-Server, ULCODCСSS)&lt;ref name=&quot;fielding&quot;/&gt;. Как мы определили в результате анализа архитектуры SNMP, система SNMP определяется унифицированным многоуровневым клиент-серверным стилем без сохранения состояния (Unified-Layered-Client-Stateless-Server, ULCSS).

Как мы видим, на SNMP не накладываются ограничения, связанные с репликацией (наличие кэша) и мобильным кодом (применение кода по запросу). В этом смысле стиль SNMP — более свободный, чем REST, т. е. содержит меньше архитектурных особенностей, которые, например, необходимо учитывать при моделировании систем с такой архитектурой.

Однако, даже в SNMPv1 есть особая операция &lt;code&gt;Trap&lt;/code&gt;, инициируемая агентом асинхронно по отношению к менеджеру. В SNMPv2 вводится операция &lt;code&gt;Inform-Request&lt;/code&gt;, которая также выполняется асинхронно, но между двумя менеджерами. При выполнении таких операций клиент и сервер меняются ролями. При этом используется принцип интеграции на основе извещений. Это элементы однорангового стиля взаимодействия (Peer-to-Peer), хотя в данном случае роли клиента и сервера для конкретных типов протокольных операций выражены явно. В этом смысле стиль SNMP — более ограниченный, чем REST.

Таким образом, при определённых ограничениях система SNMP может быть рассмотрена как REST-овская распределённая система.

== Структура стандартов ==

Стандарты SNMP описывают аспекты, отражённые ниже&lt;ref name=&quot;snmp-arch&quot;/&gt;:

* Общая информация
* Обработка сообщений (SNMP Messages)
** Привязки к транспорту
** Разбор и диспетчеризация сообщений
** Безопасность (аутентификация, шифрование, своевременность)
* Обработка протокольных блоков данных (SNMP PDUs)
** Операции протокола
** Приложения SNMP
** Управление доступом
* Информационная модель
** Структура управляющей информации (SMI)
** Текстовые конвенции
** Выражения соответствия
* Модули баз управляющей информации (MIB)

Изначально в стандартах выделялись не все эти аспекты. Тем не менее, структура стандартов SNMP всех версий вписывается в эту схему.

Можно видеть, что рассмотренная нами выше архитектура SNMP даёт представление о многих из этих аспектов. В частности, компоненты SNMP описаны в разделах «Общая информация» и «Приложения SNMP», данные — в разделах «Информационная модель» и «Модули баз управляющей информации», а соединители — в «Обработке сообщений» и «Операциях протокола».

Среди важных аспектов, не рассмотренных при анализе архитектуры SNMP, остаётся информационная безопасность, описываемая в разделах «Безопасность» и «Управление доступом». Перейдём к рассмотрению этих вопросов.

== Информационная безопасность ==

Рассмотрим, как учитываются в SNMP основные элементы информационной безопасности:

* Конфиденциальность
* Целостность
* Доступность
* Контролируемость

В ходе развития стандартов SNMP инфраструктура безопасности подвергалась наибольшим изменениям. Для того, чтобы проследить эти изменения, вначале опишем требования безопасности и угрозы, затем структуру моделей безопасности, после чего рассмотрим использующиеся в различных версиях SNMP модели.

=== Требования и угрозы безопасности ===

Опишем требования безопасности в архитектуре SNMP&lt;ref name=&quot;snmp-arch&quot;/&gt;. Угрозами безопасности, против которых должна предоставлять защиту любая модель безопасности SNMP, являются:

* Первичные угрозы
** Модификация информации
** Маскарад
* Вторичные угрозы
** Модификация потока сообщений
** Разглашение

'''Угроза модификации информации''' — это возможность того, что некоторая неавторизованная сущность может изменить сообщения SNMP, сгенерированные по запросу авторизованного принципала, на пути их следования таким образом, что это приведёт к неавторизованным операциям управления, включая фальсификацию значения объекта (переменной).

'''Угроза маскарада''' — это возможность того, что операции управления, не авторизованные для некоторого принципала, могут быть предприняты при подстановке идентификатора другого принципала, для которого подобные действия авторизованы.

'''Угроза модификации потока сообщений''' состоит в следующем. Протокол SNMP обычно основан на транспортной службе без организации соединения. Перестановка, задержка или повторная посылка сообщений может происходить и происходит в ходе обычной эксплуатации сетей с применением таких протоколов. Угроза модификаций потока сообщений — это возможность того, что сообщения могут быть переставлены, задержаны или повторно посланы со злым умыслом с задержками, которые превышают имеющие место задержки при нормальной эксплуатации, с целью выполнения неавторизованных операций управления.

'''Угроза разглашения''' — это возможность прослушивания обменов сообщениями между сущностями SNMP. Защита от этой угрозы может требоваться локальной политикой безопасности.

Модель безопасности может не бороться с такими угрозами, как, например, отказ в обслуживании, т. к. состояние сетевых сбоев и ошибок (нормальное для SNMP) часто неотличимо от ситуаций отказа в обслуживании.

Как мы увидим ниже, на практике не каждая модель безопасности SNMP удовлетворяет требованиям нейтрализации перечисленных угроз.

=== Структура моделей безопасности ===

Устоявшаяся структура моделей безопасности была описана в документе по архитектуре SNMP&lt;ref name=&quot;snmp-arch&quot;/&gt;. Сущность SNMP содержит две подсистемы:

* Подсистема безопасности
* Подсистема управления доступом

'''Подсистема безопасности''' функционирует на уровне ''сообщений SNMP''. Она отвечает за аутентификацию, шифрование и своевременность. Документ по безопасности описывает модель безопасности, угрозы, против которых она защищает, цели модели безопасности, протоколы, используемые для достижения этих целей, модуль MIB, описывающий соответствующие структуры данных. Такой модуль нужен в том числе и для того, чтобы удалённо конфигурировать параметры безопасности уровня сообщений SNMP.

'''Подсистема управления доступом''' функционирует на уровне ''SNMP PDU''. Очевидно, что она отвечает за управление доступом к управляемым объектам (переменным). Документы, описывающие её, также определяют модуль MIB для удалённой настройки параметров.

=== Модели безопасности ===

Перечислим основные модели безопасности и соответствующие им инфраструктуры:

* SNMPv1
** SNMPv1 — Community-based Security Model
* SNMPv2
** SNMPv2p — Party-based Security Model
** SNMPv2c — Community-based Security Model
** SNMPv2u — User-based Security Model
* SNMPv3
** SNMPv3 USM User-based Security Model

'''Модель безопасности на основе сообществ (Community-based Security Model)''' была первой, самой простой и самой небезопасной. Она подразумевает лишь аутентификацию на основе «строки сообщества», фактически, пароля, передаваемого по сети в теле сообщения SNMP в открытом тексте. Эта модель безопасности не в состоянии бороться ни с одной из угроз информационной безопасности в SNMP. Тем не менее, она часто используется до сих пор в связи со своей простотой, а также благодаря наличию внешних, не связанных с SNMP систем безопасности, например, межсетевых экранов.

'''Модель безопасности на основе сторон (Party-based Security Model)''' подразумевает введение понятие стороны. '''Сторона''' — это виртуальное окружение исполнения, в котором набор допустимых операций ограничен административно. Сущность SNMP при обработке сообщения действует как сторона, поэтому ограничена операциями, определёнными для этой стороны. Сторона определяется следующими параметрами:

* Уникальный идентификатор стороны
* Логический сетевой адрес (область адресов транспортного протокола и адрес транспортного протокола)
* Протокол аутентификации и параметры, требующиеся для аутентификации всех сообщений стороны
* Протокол шифрования и параметры, требующиеся для шифрования всех сообщений стороны

Могут использоваться различные алгоритмы для протоколов аутентификации и шифрования. Обычно в качестве алгоритма для протокола аутентификации используют хэш-функцию Message Digest 5 (MD5), а для протокола шифрования — алгоритм Data Encryption Standard (DES) в режиме Cipher Block Chaining (CBC).

Вводятся и другие понятия, используемые для реализации этой модели. Однако здесь они подробно не рассматриваются, так же как и детали функционирования модели. Отметим лишь, что при использовании соответствующих протоколов аутентификации и шифрования модель успешно справляется с описанными выше угрозами безопасности SNMP. Данная модель безопасности не была широко принята, поскольку показалась многим слишком сложной и запутанной.

'''Модель безопасности на основе пользователей (User-based Security Model)''' вводит понятие ''пользователя'', от имени которого действует сущность SNMP. Этот пользователь характеризуется именем пользователя, используемыми протоколами аутентификации и шифрования, а также закрытым ключом аутентификации и шифрования. Аутентификация и шифрование являются необязательными. Их наличие описывается одним из параметров модели, качеством обслуживания (Quality of Service, QoS). Модель безопасности во многом похожа на модель на основе сторон, но она упрощает идентификацию пользователей, распределение ключей и проткольные операции.

== Версии SNMP ==

Кратко опишем различия между версиями SNMP и документы, определяющие эти версии. Заметим, что здесь приведены ''первые'' версии RFC каждой из версий SNMP, т. е. почти все из них были замещены более новыми RFC и признаны устаревшими. По состоянию на 2006 год, единственной не устаревшей версией SNMP является SNMPv3, определённая в {{RFC|3411}}-3418.

=== SNMPv1 ===

Первые RFC, описывающие стандарты SNMP, появились в 1988 году. Версия 1 подверглась критике за её посредственную модель безопасности на основе сообществ&lt;ref&gt;Simple Network Management Protocol. — Wikipedia, The Free Encyclopedia. 2006-05-07 00:11Z http://en.wikipedia.org/w/index.php?title=Simple_Network_Management_Protocol&amp;oldid=51905318&lt;/ref&gt;. В то время безопасность в Интернете не входила в круг первоочередных задач рабочих групп IETF.

* Обработка сообщений
** {{RFC|1067}}. A Simple Network Management Protocol
* Обработка PDU
** {{RFC|1067}}. A Simple Network Management Protocol
* Информационная модель
** Структура управляющей информации
*** {{RFC|1065}}. Structure and Identification of Management Information for TCP/IP-based internets
* Модули MIB
** {{RFC|1066}}. Management Information Base for Network Management of TCP/IP-based internets

=== SNMPv2 ===

Версия 2, известная так же, как Party-based SNMPv2, или SNMPv2p, не получила широкого распространения из-за серьёзных разногласий по поводу инфраструктуры безопасности в стандарте.

SNMPv2 улучшал версию 1 в области быстродействия, безопасности, конфиденциальности и взаимодействий «менеджер-менеждер». Он представил новый тип PDU &lt;code&gt;Get-Bulk-Request&lt;/code&gt;, альтернативу &lt;code&gt;Get-Next-Request&lt;/code&gt; для получения больших объёмов информации при помощи одного запроса. Тем не менее, новая система безопасности на основе сторон выглядела для многих как чересчур сложная и не была широко признана.

* Общая информация
** {{RFC|1441}}. Introduction to version 2 of the Internet-standard Network Management Framework
** {{RFC|1452}}. Coexistence between version 1 and version 2 of the Internet-standard Network Management Framework
* Обработка сообщений
** Привязки к транспорту
*** {{RFC|1448}}. Transport Mappings for SNMPv2
** Безопасность
*** {{RFC|1445}}. Administrative Model for SNMPv2
*** {{RFC|1446}}. Security Protocols for SNMPv2
* Обработка PDU
** Управление доступом
*** {{RFC|1445}}. Administrative Model for SNMPv2
** Протокольные операции
*** {{RFC|1448}}. Protocol Operations for SNMPv2
* Информационная модель
** Структура управляющей информации
*** {{RFC|1442}}. Structure of Management Information SNMPv2
** Текстовые конвенции
*** {{RFC|1443}}. Textual Conventions for SNMPv2
** Выражения соответствия
*** {{RFC|1444}}. Conformance Statements for SNMPv2
* Модули MIB
** {{RFC|1447}}. Party MIB for SNMPv2
** {{RFC|1450}}. MIB for SNMPv2
** {{RFC|1451}}. Manager-to-Manager MIB

=== SNMPv2c ===

Community-based SNMPv2, или SNMPv2c, представил SNMPv2 без новой модели безопасности версии 2. Вместо неё предлагалось использовать старую модель безопасности версии 1 на основе сообществ. Соответствующее предложение RFC было принято только как черновик стандарта, однако стало ''де факто'' стандартом SNMPv2. Безопасность SNMP снова оказалась нерешённым вопросом.

* Обработка сообщений
** Безопасность
*** {{RFC|1901}}. Introduction to Community-based SNMPv2

=== SNMPv2u ===

User-based SNMPv2, или SNMPv2u, является компромиссом между незащищённостью SNMPv1 и чрезмерной сложностью SNMPv2p. Предложенная модель безопасности на основе пользователей была положена в основу SNMPv3.

* Обработка сообщений
** Безопасность
*** {{RFC|1909}}. An Administrative Infrastructure for SNMPv2
*** {{RFC|1910}}. User-based Security Model for SNMPv2
* Обработка PDU
** Управление доступом
*** {{RFC|1909}}. An Administrative Infrastructure for SNMPv2

=== SNMPv3 ===

SNMPv3 наконец-то решил проблемы с безопасностью способом, который многие посчитали приемлемым. Версия 3 SNMP принята IETF как стандарт Интернета (IETF STD 62). Почти все предыдущие RFC признаны устаревшими.

* Общая информация
** {{RFC|3411}}. An Architecture for Describing SNMP Management Frameworks 
* Обработка сообщений
** Привязки к транспорту
*** {{RFC|3417}}. Transport Mappings for the SNMP
** Разбор и диспетчеризация сообщений
*** {{RFC|3412}}. Message Processing and Dispatching for the SNMP
** Безопасность
*** {{RFC|3414}}. User-based Security Model (USM) for SNMPv3
* Обработка PDU
** Операции протокола
*** {{RFC|3416}}. Version 2 of the Protocol Operations for SNMP
** Приложения SNMP
*** {{RFC|3413}}. SNMP Applications
** Управление доступом
*** {{RFC|3415}}. View-based Access Control Model (VACM) for the SNMP
* Модули MIB
** {{RFC|3418}}. MIB for the SNMP

== Блиц-сравнение с другими технологиями ==

SNMP похож на WBEM тем, что это семейство стандартов управления распределёнными объектами, построенное по схеме менеджер-агент.

SNMP похож на APP тем, что это почти REST-овский протокол, который использует стандартный транспорт (UDP и TCP, соответственно), что использует стандартный формат кодирования информации на 6 уровне OSI (обменивается скорее данными, чем командами: ASN.1 и XML), хотя и использует собственный прикладной протокол (SNMP и HTTP).

SNMP похож на ONC RPC тем, что оба используют метаязыки L0, L1, L2 для кодирования передаваемой информации на 6 уровне OSI (XDR Encoding и ASN.1 BER) и L2 для описания формата данных (XDR Language и ASN.1).

Ещё раз о метаязыках. Например, в программировании:

* L0 — значения переменных Python, &lt;code&gt;&quot;12&quot;: 12&lt;/code&gt;
* L1 — переменные Python, &lt;code&gt;&quot;i = 12; i&quot;: 12&lt;/code&gt;
* L2 — классы Python, &lt;code&gt;&quot;type(i)&quot;: &amp;lt;type 'int'&amp;gt;&lt;/code&gt;
* L3 — метаклассы Python, &lt;code&gt;&quot;type(type(i))&quot;: &amp;lt;type 'type'&amp;gt;&lt;/code&gt;

Например, в распределённых системах:

* L0 — данные в RPC, данные в XDR Encoding
* L1 — экземпляры переменных в RPC, описатели полей структур в XDR Encoding
* L2 — типы данных в RPC, типы полей структур в XDR Encoding, типы XDR Language
* L3 — типы типов RPC, формальная спецификация XDR Language

SNMP похож на HTTP тем, что вопросы интерфейса между приложениями в основном решаются на уровне сетевого API, т. е. на 7 уровне OSI, а не на уровне программного интерфейса (хотя последующие версии SNMP описывают абстрактный программный API).

== Существующие реализации ==

Поддержка SNMP — во многих значимых системах управления сетями, в частности:

* HP Network Node Manager
* IBM Tivoli NetView
* OpenNMS

== Заключение ==

* SNMP широко используется для управления сетями, особенно IP-сетями
* Успех SNMP по сравнению с другими стандартами управления показывает преимущества процесса стандартизации IETF
* История развития SNMP показывает важность задач защиты информации
* Архитектура SNMP интересна как пример для анализа архитектуры сетевого программного обеспечения; она соответствует поставленным перед SNMP целям
* Архитектура SNMP соответствует архитектурному стилю ULCSS сетевого программного обеспечения
* В SNMP для решения функций 6 уровня модели OSI RM используется ASN.1, что необычно для стандартов IETF и положительно сказывается на вопросах формализации протоколов, однозначности стандартов, удобства проектирования приложений
* Структура стандартов SNMP хорошо продумана и показательна как пример для изучения стандартов
* Лишь некоторые модели безопасности SNMP отвечают поставленным перед системой безопасности SNMP целям
* SNMP сравним со всеми объектами в мире, а в случае сетевых технологий 4-7 уровня OSI RM это к тому же имеет практический смысл и может иметь теоретический смысл
* Агенты и менеджеры SNMP просты в программной реализации, однако всегда нужно помнить об информационной безопасности

== Внешние ссылки ==
* SNMP менеджеры
** [https://plgn.ru/catalog/programmnoe-obespechenie/sistema-upravleniya-setyami-polygon-snmp-manager/ Бесплатная система управления Polygon SNMP Manager на базе протокола SNMP]
* Общая информация по SNMP
** [[w:SNMP|SNMP в Википедии]]
* Изучение SNMP
** [http://www.simpleweb.org/tutorials/video/ SNMP tutorials in Real format]
** [http://www.simpleweb.org/tutorials/exercises.html SNMP interactive exercises]
* Простые реализации SNMP
** [http://www.wtcs.org/snmp4tpc/getif.htm Getif]
** [http://pysnmp.sourceforge.net/ PySNMP]
* Сетевое программирование на Python
** [http://www.amk.ca/python/howto/sockets/ Socket Programming HOWTO]
** [http://pyasn1.sourceforge.net/ ASN.1 tools for Python]
* Для работы с SNMP
** [http://snmp.ru/doku.php Описание]
** [http://www.mmtools.ru/news.php Tools]
** [http://docsis.dobroe.ru/DOCSIS/ DOCSIS &amp; SNMP]

== Примечания ==
{{примечания}}</text>
      <sha1>qgra6ntu61zfxlkxs7an3gu01v0hxkp</sha1>
    </revision>
  </page>
  <page>
    <title>Сетевой порт/Что такое NAT и как определить, находитесь ли вы за NAT</title>
    <ns>0</ns>
    <id>3889</id>
    <revision>
      <id>270433</id>
      <parentid>264079</parentid>
      <timestamp>2026-10-27T07:34:31Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270433</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="10153" sha1="9t0tqb61zg9hg7a6mi5hi3hmhxmr99g" xml:space="preserve">{{wikipedia|NAT}}
== Что такое NAT ==
[[Файл:Network.NAT.png|right]]
NAT — Network Address Translation, трансляция сетевых адресов. Оригинал {{RFC|1631}}, {{RFC|3022}}. Перевод http://rfc.com.ru/rfc3022.htm {{RFC|3022}}.

Ваш компьютер может быть подключен к Интернету:

* '''Напрямую''' — обычно при подключении непосредственно к [[w:Модем|модему]] (DSL, кабельному или обычному аналоговому).
* '''Через NAT''' — тогда ваш компьютер или [[w:Модем|модем]] имеет ''локальный''&amp;nbsp; IP-адрес, из Интернета недоступный.

Здесь [[w:NAT|NAT]] — это процесс трансляции локальных адресов во внешние. Благодаря этому процессу ваш компьютер получает доступ в Интернет.

''NAT автоматически делает порты вашей машины недоступными из Интернета для прямого входящего соединения''.

== Находитесь ли вы за NAT ==

=== IP-адрес компьютера ===
; Windows
Выберите команду главного меню '''Пуск &gt; Выполнить...''' и наберите команду &lt;code&gt;cmd&lt;/code&gt;

В появившемся командном окне выполните команду &lt;code&gt;ipconfig&lt;/code&gt;
{|border=1
|bgcolor=#eeeeee|
&lt;pre style=&quot;padding: 5px&quot;&gt;Windows IP Configuration

Ethernet adapter Local Area Connection:

        IP        . . . . . . . . . . . . : 192.168.0.73
        Subnet Mask . . . . . . . . . . . : 255.255.224.0
        Default Gateway . . . . . . . . . : 192.168.0.1
&lt;/pre&gt;
|}
Первый из этих адресов — это IP-адрес вашего компьютера.

Default Gateway — адрес шлюза, он же маршрутизатор (роутер).

Subnet Mask определяет, какие адреса являются локальными (к ним компьютер будет обращаться напрямую), а какие нет (к ним обращение будет идти через маршрутизатор).

; Linux
Выполните в терминале команду:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;ifconfig&lt;/syntaxhighlight&gt;

=== Локальный ли? ===
Три специальных диапазона IP-адресов зарезервированы для локальных сетей и в Интернете не используются:
  10.   0.  0.  0 -  10.255.255.255
  172.  Х.  0.  0 - 172.  Х.255.255 (где X - от 16 до 31)
  192.168.  X.  0 - 192.168.  Х.255 (где X - от 0 до 255, обычно 0 или 1)

Четвертый диапазон предназначен для самоназначаемых IP-адресов; в случае если на компьютере настроен DHCP-клиент и ему не удалось получить IP-адрес, он берёт случайный адрес из этого диапазона. Эти адреса предназначены для передачи информации только в пределах одной физической сети (так называемые Link-local-адреса, см. {{RFC|3927}}).
  169.254.  0.  0 - 169.254.255.255

Если IP-адрес вашего компьютера находится в одном из этих диапазонов, то есть начинается с 10. или с 192.168. или с 172.nn. (где nn — от 16 до 31), то это ''локальный (внутренний)'' адрес и вы точно находитесь '''за NAT'''.

=== Внешний ли? ===
Зайдите на любую из этих страниц: [http://www.whatsmyip.org/ whatsmyip.org], [http://myipaddress.com/ myipaddress.com], [https://www.showmyip.com/ showmyip.com], [http://www.radiotoolbox.com/online_tools/whereami.php www.radiotoolbox.com], [http://2ip.ru/ 2ip.ru], [http://myip.ru/ myip.ru],
[https://whatismyip.media/ whatismyip.media],
[http://internet.yandex.ru/ internet.yandex.ru].

Эти сайты покажут вам адрес, под которым вас видят другие компьютеры в Интернете. Если он совпадает с IP-адресом вашего компьютера, то вы точно подключены к Интернету '''напрямую''' (то есть не за NAT) и дальше вам читать не нужно.

=== Остальные варианты ===
В остальных случаях возможны такие варианты:
* вы находитесь за NAT, но ваш сетевой администратор зачем-то выбрал нестандартные внутренние адреса для вашей локальной сети
* вы выходите в Интернет через прокси-сервер. Его надо настраивать в каждой программе, без этого выход в Интернет невозможен.
Во многих случаях вы можете определить, есть ли между вами и Интернетом прокси-сервер, пользуясь, например, сайтом [http://www.lagado.com/proxy-test lagado.com/proxy-test].
&lt;!-- или http://whatismyipaddress.com/staticpages/index.php/advanced-proxy-test --&gt;

''Подключение через прокси в этом руководстве пока не рассматривается''.

== Чей это NAT ==

&lt;!--
Специфика работы NAT такова, что соединения, инициируемые вашим компьютером, прозрачно проходят через NAT-устройство в Интернет.
Однако соединения, которые хотели бы с вами установить другие компьютеры из интернета, до вас дойти не могут.
--&gt;
Если вы за NAT, то следующим шагом надо определить, где именно находится NAT-устройство.

=== Провайдеры ===
Такую ситуацию описывают разными словами:
* провайдер предоставляет вам доступ в Интернет через NAT
* у вас внутренний («серый») IP-адрес
* провайдер не даёт вам внешний IP-адрес
* вы подключены через локальную сеть провайдера

Проще всего позвонить провайдеру и узнать. Или спросить у соседей с таким же подключением. Обычно такой провайдер предоставляет дополнительную услугу — внешний («белый») IP-адрес за отдельную плату.

'''Без внешнего IP-адреса сделать себе доступный порт нельзя'''.

Если вы находитесь за маршрутизатором в офисе или в многоквартирном доме, то в принципе ситуация такая же, но вы можете попробовать поискать подходы к местному админу. Кроме того, можно также попробовать [[Сетевой порт/Использование UPnP для перенаправления порта|использование UPnP для перенаправления порта (UPnP)]], вдруг в маршрутизаторе оставили его разрешённым.

== Дополнительно ==

=== Ваш NAT ===

В этом случае ваш внешний IP-адрес «принадлежит» вам лично, и вы практически всегда можете ваше NAT-устройство настроить и получить доступный порт.

В качестве NAT может выступать компьютер, подключённый к Интернету напрямую; тогда ваш второй компьютер (для которого вам нужно открыть порт) получает доступ к Интернет через него с помощью встроенного в Windows &lt;span title=&quot;Internet Connection Sharing - Совместное Использование Интернета&quot; style=&quot;border-bottom:2px dashed gray; cursor:help&quot;&gt;ICS&lt;/span&gt; или сторонней программы, например, WinRoute. Про настройку порта в ICS смотрите [http://www.practicallynetworked.com/sharing/ics/icsconfiguration.htm тут] (ссылка на статью на английском).

Но чаще это обычный домашний маршрутизатор, на настройке которого и фокусируется далее это руководство: [[Сетевой порт/Роутер и его настройки]].

=== Двойной NAT ===
К сожалению, иногда бывает и так, что NAT есть и у вас, и у провайдера, то есть ваш компьютер находится за двумя NAT сразу. Это можно проверить, зайдя в настройки маршрутизатора, посмотрев на его внешний (WAN) IP-адрес и далее следуя вышеописанному сценарию (принадлежит ли ''этот'' адрес диапазонам локальных сетей, совпадает ли он с тем адресом, под которым вас видят в Интернете).</text>
      <sha1>9t0tqb61zg9hg7a6mi5hi3hmhxmr99g</sha1>
    </revision>
  </page>
  <page>
    <title>Ruby/Справочник/Time</title>
    <ns>0</ns>
    <id>4466</id>
    <revision>
      <id>270438</id>
      <parentid>216972</parentid>
      <timestamp>2026-10-27T07:41:26Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270438</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="28346" sha1="a463mdv855alx8rpyy1ax1rb7ixts08" xml:space="preserve">==Класс Time==
Implements the extensions to the Time class that are described in the documentation for the time.rb library.
----
Extensions to time to allow comparisons with an early time class.
----

'''Примеси'''

[[Ruby/Справочник/Comparable|Comparable]] ([[Ruby/Справочник/Comparable#Comparable#&amp;lt;|&amp;lt;]], [[Ruby/Справочник/Comparable#Comparable#&amp;lt;=|&amp;lt;=]], [[Ruby/Справочник/Comparable#Comparable#==|==]], [[Ruby/Справочник/Comparable#Comparable#&amp;gt;|&amp;gt;]], [[Ruby/Справочник/Comparable#Comparable#&amp;gt;=|&amp;gt;=]], [[Ruby/Справочник/Comparable#Comparable#between?|between?]])

'''Константы'''

CommonYearMonthDays, LeapYearMonthDays, MonthValue, RFC2822_DAY_NAME, RFC2822_MONTH_NAME, ZoneOffset

'''Методы класса'''

[[#Time::_load|_load]], [[#Time::apply_offset|apply_offset]], [[#Time::at|at]], [[#Time::gm|gm]], [[#Time::httpdate|httpdate]], [[#Time::local|local]], [[#Time::make_time|make_time]], [[#Time::mktime|mktime]], [[#Time::month_days|month_days]], [[#Time::new|new]], [[#Time::now|now]], [[#Time::parse|parse]], [[#Time::rfc2822|rfc2822]], [[#Time::times|times]], [[#Time::utc|utc]], [[#Time::w3cdtf|w3cdtf]], [[#Time::xmlschema|xmlschema]], [[#Time::yaml_new|yaml_new]], [[#Time::zone_offset|zone_offset]], [[#Time::zone_utc?|zone_utc?]]

'''Методы объекта'''

[[#Time#+|+]], [[#Time#-|-]], [[#Time#&amp;lt;=&amp;gt;|&amp;lt;=&amp;gt;]], [[#Time#_dump|_dump]], [[#Time#asctime|asctime]], [[#Time#ctime|ctime]], [[#Time#day|day]], [[#Time#dst?|dst?]], [[#Time#eql?|eql?]], [[#Time#getgm|getgm]], [[#Time#getlocal|getlocal]], [[#Time#getutc|getutc]], [[#Time#gmt?|gmt?]], [[#Time#gmt_offset|gmt_offset]], [[#Time#gmtime|gmtime]], [[#Time#gmtoff|gmtoff]], [[#Time#hash|hash]], [[#Time#hour|hour]], [[#Time#httpdate|httpdate]], [[#Time#inspect|inspect]], [[#Time#isdst|isdst]], [[#Time#iso8601|iso8601]], [[#Time#localtime|localtime]], [[#Time#marshal_dump|marshal_dump]], [[#Time#marshal_load|marshal_load]], [[#Time#mday|mday]], [[#Time#min|min]], [[#Time#month|month]], [[#Time#mon|mon]], [[#Time#rfc2822|rfc2822]], [[#Time#rfc822|rfc822]], [[#Time#sec|sec]], [[#Time#strftime|strftime]], [[#Time#succ|succ]], [[#Time#to_a|to_a]], [[#Time#to_f|to_f]], [[#Time#to_i|to_i]], [[#Time#to_s|to_s]], [[#Time#to_yaml|to_yaml]], [[#Time#tv_sec|tv_sec]], [[#Time#tv_usec|tv_usec]], [[#Time#usec|usec]], [[#Time#utc?|utc?]], [[#Time#utc_offset|utc_offset]], [[#Time#utc|utc]], [[#Time#wday|wday]], [[#Time#xmlschema|xmlschema]], [[#Time#yday|yday]], [[#Time#year|year]], [[#Time#zone|zone]]
===Time::_load===
----
&lt;syntaxhighlight lang=&quot;ruby&quot;&gt;Time._load(string) #=&gt; time&lt;/syntaxhighlight&gt;
----
Unmarshal a dumped &lt;code&gt;Time&lt;/code&gt; object.

===Time::apply_offset===
----
&lt;syntaxhighlight lang=&quot;ruby&quot;&gt;Time::apply_offset(year, mon, day, hour, min, sec, off)&lt;/syntaxhighlight&gt;
----
(нет описания...)
===Time::at===
----
&lt;syntaxhighlight lang=&quot;ruby&quot;&gt;Time.at( aTime ) #=&gt; time
Time.at( seconds [, microseconds] ) #=&gt; time&lt;/syntaxhighlight&gt;
----
Creates a new time object with the value given by &lt;i&gt;aTime&lt;/i&gt;, or the given number of &lt;i&gt;seconds&lt;/i&gt; (and optional &lt;i&gt;microseconds&lt;/i&gt;) from epoch. A non-portable feature allows the offset to be negative on some systems.
&lt;syntaxhighlight lang=&quot;ruby&quot;&gt;Time.at(0)            #=&gt; Wed Dec 31 18:00:00 CST 1969
Time.at(946702800)    #=&gt; Fri Dec 31 23:00:00 CST 1999
Time.at(-284061600)   #=&gt; Sat Dec 31 00:00:00 CST 1960&lt;/syntaxhighlight&gt;
===Time::gm===
----
  &lt;tt&gt;Time.utc( year [, month, day, hour, min, sec, usec] ) =&amp;gt; time
  &lt;/tt&gt;&lt;tt&gt;Time.utc( sec, min, hour, day, month, year, wday, yday, isdst, &lt;/tt&gt;&lt;tt&gt;tz
  ) =&amp;gt; time
  Time.gm( year [, month, day, hour, min, sec, &lt;/tt&gt;&lt;tt&gt;usec] ) =&amp;gt; time
  Time.gm( sec, min, hour, day, month, year, wday, &lt;/tt&gt;&lt;tt&gt;yday, isdst, tz
  ) =&amp;gt; time&lt;/tt&gt;
----
Creates a time based on given values, interpreted as UTC (GMT). The year must be specified. Other values default to the minimum value for that field (and may be &lt;tt&gt;nil&lt;/tt&gt; or omitted). Months may be specified by numbers from 1 to 12, or by the three-letter English month names. Hours are specified on a 24-hour clock (0..23). Raises an &lt;tt&gt;ArgumentError&lt;/tt&gt; if any values are out of range. Will also accept ten arguments in the order output by &lt;tt&gt;Time#to_a&lt;/tt&gt;.
   &lt;code&gt;Time.utc(2000,&amp;quot;jan&amp;quot;,1,20,15,1)  #=&amp;gt; Sat Jan 01 20:15:01 UTC 2000
   Time.gm(2000,&quot;jan&quot;,1,20,15,1)   #=&gt; Sat Jan 01 20:15:01 UTC 2000&lt;/code&gt;
===Time::httpdate===
----
  &lt;tt&gt;Time::httpdate(date)&lt;/tt&gt;
----
Parses &lt;tt&gt;date&lt;/tt&gt; as HTTP-date defined by {{RFC|2616}} and converts it to a Time object.
ArgumentError is raised if &lt;tt&gt;date&lt;/tt&gt; is not compliant with {{RFC|2616}} or Time class cannot represent specified date.
See #httpdate for more information on this format.
===Time::local===
----
  &lt;tt&gt;Time.local( year [, month, day, hour, min, sec, usec] ) =&amp;gt; &lt;/tt&gt;&lt;tt&gt;time
  Time.local( sec, min, hour, day, month, year, wday, yday, &lt;/tt&gt;&lt;tt&gt;isdst,
  tz ) =&amp;gt; time
  Time.mktime( year, month, day, hour, min, &lt;/tt&gt;&lt;tt&gt;sec, usec )   =&amp;gt; time&lt;/tt&gt;
----
Same as &lt;tt&gt;Time::gm&lt;/tt&gt;, but interprets the values in the local time zone.
   &lt;code&gt;Time.local(2000,&amp;quot;jan&amp;quot;,1,20,15,1)   #=&amp;gt; Sat Jan 01 20:15:01 CST 2000&lt;/code&gt;
===Time::make_time===
----
  &lt;tt&gt;Time::make_time(year, mon, day, hour, min, sec, sec_fraction, &lt;/tt&gt;&lt;tt&gt;zone, now)&lt;/tt&gt;
----
(нет описания...)
===Time::mktime===
----
  &lt;tt&gt;Time.local( year [, month, day, hour, min, sec, usec] ) =&amp;gt; &lt;/tt&gt;&lt;tt&gt;time
  Time.local( sec, min, hour, day, month, year, wday, yday, &lt;/tt&gt;&lt;tt&gt;isdst,
  tz ) =&amp;gt; time
  Time.mktime( year, month, day, hour, min, &lt;/tt&gt;&lt;tt&gt;sec, usec )   =&amp;gt; time&lt;/tt&gt;
----
Same as &lt;tt&gt;Time::gm&lt;/tt&gt;, but interprets the values in the local time zone.
   &lt;code&gt;Time.local(2000,&amp;quot;jan&amp;quot;,1,20,15,1)   #=&amp;gt; Sat Jan 01 20:15:01 CST 2000&lt;/code&gt;
===Time::month_days===
----
  &lt;tt&gt;Time::month_days(y, m)&lt;/tt&gt;
----
(нет описания...)
===Time::new===
----
  &lt;tt&gt;Time.new -&amp;gt; time&lt;/tt&gt;
----
Document-method: now
Synonym for &lt;tt&gt;Time.new&lt;/tt&gt;. 
Returns a &lt;tt&gt;Time&lt;/tt&gt; object initialized to the current system time. &lt;b&gt;Note:&lt;/b&gt; The object created will be created using the resolution available on your system clock, and so may include fractional seconds.
   &lt;code&gt;a = Time.new      #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   b = Time.new      #=&gt; Wed Apr 09 08:56:03 CDT 2003
   a == b            #=&gt; false
   &quot;%.6f&quot; % a.to_f   #=&gt; &quot;1049896563.230740&quot;
   &quot;%.6f&quot; % b.to_f   #=&gt; &quot;1049896563.231466&quot;&lt;/code&gt;

===Time::now===
----
  &lt;tt&gt;Time.now -&amp;gt; time&lt;/tt&gt;
----
Synonym for &lt;tt&gt;Time.new&lt;/tt&gt;. 
Returns a &lt;tt&gt;Time&lt;/tt&gt; object initialized to the current system time. &lt;b&gt;Note:&lt;/b&gt; The object created will be created using the resolution available on your system clock, and so may include fractional seconds.
   &lt;code&gt;a = Time.now      #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   b = Time.now      #=&gt; Wed Apr 09 08:56:03 CDT 2003
   a == b            #=&gt; True
   &quot;%.6f&quot; % a.to_f   #=&gt; &quot;1049896563.230740&quot;
   &quot;%.6f&quot; % b.to_f   #=&gt; &quot;1049896563.231466&quot;&lt;/code&gt;

===Time::parse===
----
  &lt;tt&gt;Time::parse(date, now=Time.now) {|year| ...}&lt;/tt&gt;
----
Parses &lt;tt&gt;date&lt;/tt&gt; using Date._parse and converts it to a Time object.
If a block is given, the year described in &lt;tt&gt;date&lt;/tt&gt; is converted by the block. For example:
    &lt;code&gt;Time.parse(...) {|y| y &amp;lt; 100 ? (y &amp;gt;= 69 ? y + 1900 : y + 2000) : y}&lt;/code&gt;
If the upper components of the given time are broken or missing, they are supplied with those of &lt;tt&gt;now&lt;/tt&gt;. For the lower components, the minimum values (1 or 0) are assumed if broken or missing. For example:
    &lt;code&gt;# Suppose it is &amp;quot;Thu Nov 29 14:33:20 GMT 2001&amp;quot; now and
    # your timezone is GMT:
    Time.parse(&quot;16:30&quot;)     #=&gt; Thu Nov 29 16:30:00 GMT 2001
    Time.parse(&quot;7/23&quot;)      #=&gt; Mon Jul 23 00:00:00 GMT 2001
    Time.parse(&quot;Aug 31&quot;)    #=&gt; Fri Aug 31 00:00:00 GMT 2001&lt;/code&gt;
Since there are numerous conflicts among locally defined timezone abbreviations all over the world, this method is not made to understand all of them. For example, the abbreviation &amp;quot;CST&amp;quot; is used variously as:
    &lt;code&gt;-06:00 in America/Chicago,
    -05:00 in America/Havana,
    +08:00 in Asia/Harbin,
    +09:30 in Australia/Darwin,
    +10:30 in Australia/Adelaide,
    etc.&lt;/code&gt;
Based on the fact, this method only understands the timezone abbreviations described in {{RFC|822}} and the system timezone, in the order named. (i.e. a definition in {{RFC|822}} overrides the system timezone definition.) The system timezone is taken from &lt;tt&gt;Time.local(year, 1, 1).zone&lt;/tt&gt; and &lt;tt&gt;Time.local(year, 7, 1).zone&lt;/tt&gt;. If the extracted timezone abbreviation does not match any of them, it is ignored and the given time is regarded as a local time.
ArgumentError is raised if Date._parse cannot extract information from &lt;tt&gt;date&lt;/tt&gt; or Time class cannot represent specified date.
This method can be used as fail-safe for other parsing methods as:
  &lt;code&gt;Time.rfc2822(date) rescue Time.parse(date)
  Time.httpdate(date) rescue Time.parse(date)
  Time.xmlschema(date) rescue Time.parse(date)&lt;/code&gt;
A failure for Time.parse should be checked, though.
===Time::rfc2822===
----
  &lt;tt&gt;Time::rfc2822(date)&lt;/tt&gt;
----
Parses &lt;tt&gt;date&lt;/tt&gt; as date-time defined by {{RFC|2822}} and converts it to a Time object. The format is identical to the date format defined by {{RFC|822}} and updated by {{RFC|1123}}.
ArgumentError is raised if &lt;tt&gt;date&lt;/tt&gt; is not compliant with {{RFC|2822}} or Time class cannot represent specified date.
See #rfc2822 for more information on this format.
===Time::times===
----
  &lt;tt&gt;Time.times =&amp;gt; struct_tms&lt;/tt&gt;
----
Deprecated in favor of &lt;tt&gt;Process::times&lt;/tt&gt;
===Time::utc===
----
  &lt;tt&gt;Time.utc( year [, month, day, hour, min, sec, usec] ) =&amp;gt; time
  &lt;/tt&gt;&lt;tt&gt;Time.utc( sec, min, hour, day, month, year, wday, yday, isdst, &lt;/tt&gt;&lt;tt&gt;tz
  ) =&amp;gt; time
  Time.gm( year [, month, day, hour, min, sec, &lt;/tt&gt;&lt;tt&gt;usec] ) =&amp;gt; time
  Time.gm( sec, min, hour, day, month, year, wday, &lt;/tt&gt;&lt;tt&gt;yday, isdst, tz
  ) =&amp;gt; time&lt;/tt&gt;
----
Creates a time based on given values, interpreted as UTC (GMT). The year must be specified. Other values default to the minimum value for that field (and may be &lt;tt&gt;nil&lt;/tt&gt; or omitted). Months may be specified by numbers from 1 to 12, or by the three-letter English month names. Hours are specified on a 24-hour clock (0..23). Raises an &lt;tt&gt;ArgumentError&lt;/tt&gt; if any values are out of range. Will also accept ten arguments in the order output by &lt;tt&gt;Time#to_a&lt;/tt&gt;.
   &lt;code&gt;Time.utc(2000,&amp;quot;jan&amp;quot;,1,20,15,1)  #=&amp;gt; Sat Jan 01 20:15:01 UTC 2000
   Time.gm(2000,&quot;jan&quot;,1,20,15,1)   #=&gt; Sat Jan 01 20:15:01 UTC 2000&lt;/code&gt;
===Time::w3cdtf===
----
  &lt;tt&gt;Time::w3cdtf(date)&lt;/tt&gt;
----
(нет описания...)
===Time::xmlschema===
----
  &lt;tt&gt;Time::xmlschema(date)&lt;/tt&gt;
----
Parses &lt;tt&gt;date&lt;/tt&gt; as dateTime defined by XML Schema and converts it to a Time object. The format is restricted version of the format defined by ISO 8601.
ArgumentError is raised if &lt;tt&gt;date&lt;/tt&gt; is not compliant with the format or Time class cannot represent specified date.
See #xmlschema for more information on this format.
===Time::yaml_new===
----
  &lt;tt&gt;Time::yaml_new( klass, tag, val )&lt;/tt&gt;
----
(нет описания...)
===Time::zone_offset===
----
  &lt;tt&gt;Time::zone_offset(zone, year=Time.now.year)&lt;/tt&gt;
----
(нет описания...)
===Time::zone_utc?===
----
  &lt;tt&gt;Time::zone_utc?(zone)&lt;/tt&gt;
----
(нет описания...)
===Time#+===
----
  &lt;tt&gt;time + numeric =&amp;gt; time&lt;/tt&gt;
----
Addition---Adds some number of seconds (possibly fractional) to &lt;i&gt;time&lt;/i&gt; and returns that value as a new time.
   &lt;code&gt;t = Time.now         #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   t + (60 * 60 * 24)   #=&gt; Thu Apr 10 08:56:03 CDT 2003&lt;/code&gt;
===Time#-===
----
  &lt;tt&gt;time - other_time =&amp;gt; float
  time - numeric    =&amp;gt; time&lt;/tt&gt;
----
Difference---Returns a new time that represents the difference between two times, or subtracts the given number of seconds in &lt;i&gt;numeric&lt;/i&gt; from &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;t = Time.now       #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   t2 = t + 2592000   #=&gt; Fri May 09 08:56:03 CDT 2003
   t2 - t             #=&gt; 2592000.0
   t2 - 2592000       #=&gt; Wed Apr 09 08:56:03 CDT 2003&lt;/code&gt;
Более одного метода удовлетворяет вашему запросу. Вы можете уточнить
ваш запрос, выбрав один из следующих методов:

Time#&amp;lt;=&amp;gt;, Time#&amp;lt;=&amp;gt;===Time#_dump===
----
  &lt;tt&gt;time._dump   =&amp;gt; string&lt;/tt&gt;
----
Dump &lt;i&gt;time&lt;/i&gt; for marshaling.
===Time#asctime===
----
  &lt;tt&gt;time.asctime =&amp;gt; string
  time.ctime   =&amp;gt; string&lt;/tt&gt;
----
Returns a canonical string representation of &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;Time.now.asctime   #=&amp;gt; &amp;quot;Wed Apr  9 08:56:03 2003&amp;quot;&lt;/code&gt;
===Time#ctime===
----
  &lt;tt&gt;time.asctime =&amp;gt; string
  time.ctime   =&amp;gt; string&lt;/tt&gt;
----
Returns a canonical string representation of &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;Time.now.asctime   #=&amp;gt; &amp;quot;Wed Apr  9 08:56:03 2003&amp;quot;&lt;/code&gt;
===Time#day===
----
  &lt;tt&gt;time.day  =&amp;gt; fixnum
  time.mday =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the day of the month (1..n) for &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   t.day          #=&gt; 9
   t.mday         #=&gt; 9&lt;/code&gt;
===Time#dst?===
----
  &lt;tt&gt;time.isdst =&amp;gt; true or false
  time.dst?  =&amp;gt; true or false&lt;/tt&gt;
----
Returns &lt;tt&gt;true&lt;/tt&gt; if &lt;i&gt;time&lt;/i&gt; occurs during Daylight Saving Time in its time zone.
   &lt;code&gt;Time.local(2000, 7, 1).isdst   #=&amp;gt; true
   Time.local(2000, 1, 1).isdst   #=&gt; false
   Time.local(2000, 7, 1).dst?    #=&gt; true
   Time.local(2000, 1, 1).dst?    #=&gt; false&lt;/code&gt;
===Time#eql?===
----
  &lt;tt&gt;time.eql?(other_time)&lt;/tt&gt;
----
Return &lt;tt&gt;true&lt;/tt&gt; if &lt;i&gt;time&lt;/i&gt; and &lt;i&gt;other_time&lt;/i&gt; are both &lt;tt&gt;Time&lt;/tt&gt; objects with the same seconds and fractional seconds.
===Time#getgm===
----
  &lt;tt&gt;time.getgm  =&amp;gt; new_time
  time.getutc =&amp;gt; new_time&lt;/tt&gt;
----
Returns a new &lt;tt&gt;new_time&lt;/tt&gt; object representing &lt;i&gt;time&lt;/i&gt; in UTC.
   &lt;code&gt;t = Time.local(2000,1,1,20,15,1)   #=&amp;gt; Sat Jan 01 20:15:01 CST 2000
   t.gmt?                             #=&gt; false
   y = t.getgm                        #=&gt; Sun Jan 02 02:15:01 UTC 2000
   y.gmt?                             #=&gt; true
   t == y                             #=&gt; true&lt;/code&gt;
===Time#getlocal===
----
  &lt;tt&gt;time.getlocal =&amp;gt; new_time&lt;/tt&gt;
----
Returns a new &lt;tt&gt;new_time&lt;/tt&gt; object representing &lt;i&gt;time&lt;/i&gt; in local time (using the local time zone in effect for this process).
   &lt;code&gt;t = Time.gm(2000,1,1,20,15,1)   #=&amp;gt; Sat Jan 01 20:15:01 UTC 2000
   t.gmt?                          #=&gt; true
   l = t.getlocal                  #=&gt; Sat Jan 01 14:15:01 CST 2000
   l.gmt?                          #=&gt; false
   t == l                          #=&gt; true&lt;/code&gt;
===Time#getutc===
----
  &lt;tt&gt;time.getgm  =&amp;gt; new_time
  time.getutc =&amp;gt; new_time&lt;/tt&gt;
----
Returns a new &lt;tt&gt;new_time&lt;/tt&gt; object representing &lt;i&gt;time&lt;/i&gt; in UTC.
   &lt;code&gt;t = Time.local(2000,1,1,20,15,1)   #=&amp;gt; Sat Jan 01 20:15:01 CST 2000
   t.gmt?                             #=&gt; false
   y = t.getgm                        #=&gt; Sun Jan 02 02:15:01 UTC 2000
   y.gmt?                             #=&gt; true
   t == y                             #=&gt; true&lt;/code&gt;
===Time#gmt?===
----
  &lt;tt&gt;time.utc? =&amp;gt; true or false
  time.gmt? =&amp;gt; true or false&lt;/tt&gt;
----
Returns &lt;tt&gt;true&lt;/tt&gt; if &lt;i&gt;time&lt;/i&gt; represents a time in UTC (GMT).
   &lt;code&gt;t = Time.now                        #=&amp;gt; Wed Apr 09 08:56:04 CDT 2003
   t.utc?                              #=&gt; false
   t = Time.gm(2000,&quot;jan&quot;,1,20,15,1)   #=&gt; Sat Jan 01 20:15:01 UTC 2000
   t.utc?                              #=&gt; true

   t = Time.now                        #=&gt; Wed Apr 09 08:56:03 CDT 2003
   t.gmt?                              #=&gt; false
   t = Time.gm(2000,1,1,20,15,1)       #=&gt; Sat Jan 01 20:15:01 UTC 2000
   t.gmt?                              #=&gt; true&lt;/code&gt;
===Time#gmt_offset===
----
  &lt;tt&gt;time.gmt_offset =&amp;gt; fixnum
  time.gmtoff     =&amp;gt; fixnum
  &lt;/tt&gt;&lt;tt&gt;time.utc_offset =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the offset in seconds between the timezone of &lt;i&gt;time&lt;/i&gt; and UTC.
   &lt;code&gt;t = Time.gm(2000,1,1,20,15,1)   #=&amp;gt; Sat Jan 01 20:15:01 UTC 2000
   t.gmt_offset                    #=&gt; 0
   l = t.getlocal                  #=&gt; Sat Jan 01 14:15:01 CST 2000
   l.gmt_offset                    #=&gt; -21600&lt;/code&gt;
===Time#gmtime===
----
  &lt;tt&gt;time.gmtime    =&amp;gt; time
  time.utc       =&amp;gt; time&lt;/tt&gt;
----
Converts &lt;i&gt;time&lt;/i&gt; to UTC (GMT), modifying the receiver.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   t.gmt?         #=&gt; false
   t.gmtime       #=&gt; Wed Apr 09 13:56:03 UTC 2003
   t.gmt?         #=&gt; true

   t = Time.now   #=&gt; Wed Apr 09 08:56:04 CDT 2003
   t.utc?         #=&gt; false
   t.utc          #=&gt; Wed Apr 09 13:56:04 UTC 2003
   t.utc?         #=&gt; true&lt;/code&gt;
===Time#gmtoff===
----
  &lt;tt&gt;time.gmt_offset =&amp;gt; fixnum
  time.gmtoff     =&amp;gt; fixnum
  &lt;/tt&gt;&lt;tt&gt;time.utc_offset =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the offset in seconds between the timezone of &lt;i&gt;time&lt;/i&gt; and UTC.
   &lt;code&gt;t = Time.gm(2000,1,1,20,15,1)   #=&amp;gt; Sat Jan 01 20:15:01 UTC 2000
   t.gmt_offset                    #=&gt; 0
   l = t.getlocal                  #=&gt; Sat Jan 01 14:15:01 CST 2000
   l.gmt_offset                    #=&gt; -21600&lt;/code&gt;
===Time#hash===
----
  &lt;tt&gt;time.hash   =&amp;gt; fixnum&lt;/tt&gt;
----
Return a hash code for this time object.
===Time#hour===
----
  &lt;tt&gt;time.hour =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the hour of the day (0..23) for &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   t.hour         #=&gt; 8&lt;/code&gt;
===Time#httpdate===
----
  &lt;tt&gt;httpdate()&lt;/tt&gt;
----
Returns a string which represents the time as rfc1123-date of HTTP-date defined by {{RFC|2616}}:
  &lt;code&gt;day-of-week, DD month-name CCYY hh:mm:ss GMT&lt;/code&gt;
Note that the result is always UTC (GMT).
===Time#inspect===
----
  &lt;tt&gt;time.inspect =&amp;gt; string
  time.to_s    =&amp;gt; string&lt;/tt&gt;
----
Returns a string representing &lt;i&gt;time&lt;/i&gt;. Equivalent to calling &lt;tt&gt;Time#strftime&lt;/tt&gt; with a format string of ``&lt;tt&gt;%a&lt;/tt&gt; &lt;tt&gt;%b&lt;/tt&gt; &lt;tt&gt;%d&lt;/tt&gt; &lt;tt&gt;%H:%M:%S&lt;/tt&gt; &lt;tt&gt;%Z&lt;/tt&gt; &lt;tt&gt;%Y&lt;/tt&gt;''.
   &lt;code&gt;Time.now.to_s   #=&amp;gt; &amp;quot;Wed Apr 09 08:56:04 CDT 2003&amp;quot;&lt;/code&gt;
===Time#isdst===
----
  &lt;tt&gt;time.isdst =&amp;gt; true or false
  time.dst?  =&amp;gt; true or false&lt;/tt&gt;
----
Returns &lt;tt&gt;true&lt;/tt&gt; if &lt;i&gt;time&lt;/i&gt; occurs during Daylight Saving Time in its time zone.
   &lt;code&gt;Time.local(2000, 7, 1).isdst   #=&amp;gt; true
   Time.local(2000, 1, 1).isdst   #=&gt; false
   Time.local(2000, 7, 1).dst?    #=&gt; true
   Time.local(2000, 1, 1).dst?    #=&gt; false&lt;/code&gt;
===Time#iso8601===
----
  &lt;tt&gt;iso8601(fraction_digits=0)&lt;/tt&gt;
----
Alias for #xmlschema
===Time#localtime===
----
  &lt;tt&gt;time.localtime =&amp;gt; time&lt;/tt&gt;
----
Converts &lt;i&gt;time&lt;/i&gt; to local time (using the local time zone in effect for this process) modifying the receiver.
   &lt;code&gt;t = Time.gm(2000, &amp;quot;jan&amp;quot;, 1, 20, 15, 1)
   t.gmt?        #=&gt; true
   t.localtime   #=&gt; Sat Jan 01 14:15:01 CST 2000
   t.gmt?        #=&gt; false&lt;/code&gt;
===Time#marshal_dump===
----
  &lt;tt&gt;marshal_dump()&lt;/tt&gt;
----
undocumented
===Time#marshal_load===
----
  &lt;tt&gt;marshal_load(p1)&lt;/tt&gt;
----
undocumented
===Time#mday===
----
  &lt;tt&gt;time.day  =&amp;gt; fixnum
  time.mday =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the day of the month (1..n) for &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   t.day          #=&gt; 9
   t.mday         #=&gt; 9&lt;/code&gt;
===Time#min===
----
  &lt;tt&gt;time.min =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the minute of the hour (0..59) for &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   t.min          #=&gt; 56&lt;/code&gt;
===Time#mon===
----
  &lt;tt&gt;time.mon   =&amp;gt; fixnum
  time.month =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the month of the year (1..12) for &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   t.mon          #=&gt; 4
   t.month        #=&gt; 4&lt;/code&gt;
===Time#month===
----
  &lt;tt&gt;time.mon   =&amp;gt; fixnum
  time.month =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the month of the year (1..12) for &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   t.mon          #=&gt; 4
   t.month        #=&gt; 4&lt;/code&gt;
===Time#rfc2822===
----
  &lt;tt&gt;rfc2822()&lt;/tt&gt;
----
Returns a string which represents the time as date-time defined by {{RFC|2822}}:
  &lt;code&gt;day-of-week, DD month-name CCYY hh:mm:ss zone&lt;/code&gt;
where zone is [+-]hhmm.
If &lt;tt&gt;self&lt;/tt&gt; is a UTC time, -0000 is used as zone.

(еще известен как rfc822)
===Time#rfc822===
----
  &lt;tt&gt;rfc822()&lt;/tt&gt;
----
Alias for #rfc2822
===Time#sec===
----
  &lt;tt&gt;time.sec =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the second of the minute (0..60)&lt;i&gt;[Yes, seconds really can &lt;/i&gt;&lt;i&gt;range from zero to 60. This allows the system to inject leap &lt;/i&gt;&lt;i&gt;seconds every now and then to correct for the fact that years are &lt;/i&gt;&lt;i&gt;not really a convenient number of hours long.]&lt;/i&gt; for &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:04 CDT 2003
   t.sec          #=&gt; 4&lt;/code&gt;
===Time#strftime===
----
  &lt;tt&gt;Time.strftime( string ) =&amp;gt; string&lt;/tt&gt;
----
Formats &lt;i&gt;time&lt;/i&gt; according to the directives in the given format string. Any text not listed as a directive will be passed through to the output string.
Format meaning:
  &lt;code&gt;%a - The abbreviated weekday name (``Sun'')
  %A - The  full  weekday  name (``Sunday'')
  %b - The abbreviated month name (``Jan'')
  %B - The  full  month  name (``January'')
  %c - The preferred local date and time representation
  %d - Day of the month (01..31)
  %H - Hour of the day, 24-hour clock (00..23)
  %I - Hour of the day, 12-hour clock (01..12)
  %j - Day of the year (001..366)
  %m - Month of the year (01..12)
  %M - Minute of the hour (00..59)
  %p - Meridian indicator (``AM''  or  ``PM'')
  %S - Second of the minute (00..60)
  %U - Week  number  of the current year,
          starting with the first Sunday as the first
          day of the first week (00..53)
  %W - Week  number  of the current year,
          starting with the first Monday as the first
          day of the first week (00..53)
  %w - Day of the week (Sunday is 0, 0..6)
  %x - Preferred representation for the date alone, no time
  %X - Preferred representation for the time alone, no date
  %y - Year without a century (00..99)
  %Y - Year with century
  %Z - Time zone name
  %% - Literal ``%'' character

   t = Time.now
   t.strftime(&quot;Printed on %m/%d/%Y&quot;)   #=&gt; &quot;Printed on 04/09/2003&quot;
   t.strftime(&quot;at %I:%M%p&quot;)            #=&gt; &quot;at 08:56AM&quot;&lt;/code&gt;

===Time#succ===
----
  &lt;tt&gt;time.succ   =&amp;gt; new_time&lt;/tt&gt;
----
Return a new time object, one second later than &lt;tt&gt;time&lt;/tt&gt;.
===Time#to_a===
----
  &lt;tt&gt;time.to_a =&amp;gt; array&lt;/tt&gt;
----
Returns a ten-element &lt;i&gt;array&lt;/i&gt; of values for &lt;i&gt;time&lt;/i&gt;: {&lt;tt&gt;[ sec, min, hour, &lt;/tt&gt;&lt;tt&gt;day, month, year, wday, yday, isdst, zone ]&lt;/tt&gt;}. See the individual methods for an explanation of the valid ranges of each value. The ten elements can be passed directly to &lt;tt&gt;Time::utc&lt;/tt&gt; or &lt;tt&gt;Time::local&lt;/tt&gt; to create a new &lt;tt&gt;Time&lt;/tt&gt;.
   &lt;code&gt;now = Time.now   #=&amp;gt; Wed Apr 09 08:56:04 CDT 2003
   t = now.to_a     #=&gt; [4, 56, 8, 9, 4, 2003, 3, 99, true, &quot;CDT&quot;]&lt;/code&gt;
===Time#to_f===
----
  &lt;tt&gt;time.to_f =&amp;gt; float&lt;/tt&gt;
----
Returns the value of &lt;i&gt;time&lt;/i&gt; as a floating point number of seconds since epoch.
   &lt;code&gt;t = Time.now
   &quot;%10.5f&quot; % t.to_f   #=&gt; &quot;1049896564.13654&quot;
   t.to_i              #=&gt; 1049896564&lt;/code&gt;
===Time#to_i===
----
  &lt;tt&gt;time.to_i   =&amp;gt; int
  time.tv_sec =&amp;gt; int&lt;/tt&gt;
----
Returns the value of &lt;i&gt;time&lt;/i&gt; as an integer number of seconds since epoch.
   &lt;code&gt;t = Time.now
   &quot;%10.5f&quot; % t.to_f   #=&gt; &quot;1049896564.17839&quot;
   t.to_i              #=&gt; 1049896564&lt;/code&gt;
===Time#to_s===
----
  &lt;tt&gt;time.inspect =&amp;gt; string
  time.to_s    =&amp;gt; string&lt;/tt&gt;
----
Returns a string representing &lt;i&gt;time&lt;/i&gt;. Equivalent to calling &lt;tt&gt;Time#strftime&lt;/tt&gt; with a format string of ``&lt;tt&gt;%a&lt;/tt&gt; &lt;tt&gt;%b&lt;/tt&gt; &lt;tt&gt;%d&lt;/tt&gt; &lt;tt&gt;%H:%M:%S&lt;/tt&gt; &lt;tt&gt;%Z&lt;/tt&gt; &lt;tt&gt;%Y&lt;/tt&gt;''.
   &lt;code&gt;Time.now.to_s   #=&amp;gt; &amp;quot;Wed Apr 09 08:56:04 CDT 2003&amp;quot;&lt;/code&gt;
===Time#to_yaml===
----
  &lt;tt&gt;to_yaml( opts = {} )&lt;/tt&gt;
----
(нет описания...)
===Time#tv_sec===
----
  &lt;tt&gt;time.to_i   =&amp;gt; int
  time.tv_sec =&amp;gt; int&lt;/tt&gt;
----
Returns the value of &lt;i&gt;time&lt;/i&gt; as an integer number of seconds since epoch.
   &lt;code&gt;t = Time.now
   &quot;%10.5f&quot; % t.to_f   #=&gt; &quot;1049896564.17839&quot;
   t.to_i              #=&gt; 1049896564&lt;/code&gt;
===Time#tv_usec===
----
  &lt;tt&gt;time.usec    =&amp;gt; int
  time.tv_usec =&amp;gt; int&lt;/tt&gt;
----
Returns just the number of microseconds for &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;t = Time.now        #=&amp;gt; Wed Apr 09 08:56:04 CDT 2003
   &quot;%10.6f&quot; % t.to_f   #=&gt; &quot;1049896564.259970&quot;
   t.usec              #=&gt; 259970&lt;/code&gt;
===Time#usec===
----
  &lt;tt&gt;time.usec    =&amp;gt; int
  time.tv_usec =&amp;gt; int&lt;/tt&gt;
----
Returns just the number of microseconds for &lt;i&gt;time&lt;/i&gt;.
   &lt;code&gt;t = Time.now        #=&amp;gt; Wed Apr 09 08:56:04 CDT 2003
   &quot;%10.6f&quot; % t.to_f   #=&gt; &quot;1049896564.259970&quot;
   t.usec              #=&gt; 259970&lt;/code&gt;
===Time#utc===
----
  &lt;tt&gt;time.gmtime    =&amp;gt; time
  time.utc       =&amp;gt; time&lt;/tt&gt;
----
Converts &lt;i&gt;time&lt;/i&gt; to UTC (GMT), modifying the receiver.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:03 CDT 2003
   t.gmt?         #=&gt; false
   t.gmtime       #=&gt; Wed Apr 09 13:56:03 UTC 2003
   t.gmt?         #=&gt; true

   t = Time.now   #=&gt; Wed Apr 09 08:56:04 CDT 2003
   t.utc?         #=&gt; false
   t.utc          #=&gt; Wed Apr 09 13:56:04 UTC 2003
   t.utc?         #=&gt; true&lt;/code&gt;
===Time#utc?===
----
  &lt;tt&gt;time.utc? =&amp;gt; true or false
  time.gmt? =&amp;gt; true or false&lt;/tt&gt;
----
Returns &lt;tt&gt;true&lt;/tt&gt; if &lt;i&gt;time&lt;/i&gt; represents a time in UTC (GMT).
   &lt;code&gt;t = Time.now                        #=&amp;gt; Wed Apr 09 08:56:04 CDT 2003
   t.utc?                              #=&gt; false
   t = Time.gm(2000,&quot;jan&quot;,1,20,15,1)   #=&gt; Sat Jan 01 20:15:01 UTC 2000
   t.utc?                              #=&gt; true

   t = Time.now                        #=&gt; Wed Apr 09 08:56:03 CDT 2003
   t.gmt?                              #=&gt; false
   t = Time.gm(2000,1,1,20,15,1)       #=&gt; Sat Jan 01 20:15:01 UTC 2000
   t.gmt?                              #=&gt; true&lt;/code&gt;
===Time#utc_offset===
----
  &lt;tt&gt;time.gmt_offset =&amp;gt; fixnum
  time.gmtoff     =&amp;gt; fixnum
  &lt;/tt&gt;&lt;tt&gt;time.utc_offset =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the offset in seconds between the timezone of &lt;i&gt;time&lt;/i&gt; and UTC.
   &lt;code&gt;t = Time.gm(2000,1,1,20,15,1)   #=&amp;gt; Sat Jan 01 20:15:01 UTC 2000
   t.gmt_offset                    #=&gt; 0
   l = t.getlocal                  #=&gt; Sat Jan 01 14:15:01 CST 2000
   l.gmt_offset                    #=&gt; -21600&lt;/code&gt;
===Time#wday===
----
  &lt;tt&gt;time.wday =&amp;gt; fixnum&lt;/tt&gt;
----
Returns an integer representing the day of the week, 0..6, with Sunday == 0.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:04 CDT 2003
   t.wday         #=&gt; 3&lt;/code&gt;
===Time#xmlschema===
----
  &lt;tt&gt;xmlschema(fraction_digits=0)&lt;/tt&gt;
----
Returns a string which represents the time as dateTime defined by XML Schema:
  &lt;code&gt;CCYY-MM-DDThh:mm:ssTZD
  CCYY-MM-DDThh:mm:ss.sssTZD&lt;/code&gt;
where TZD is Z or [+-]hh:mm.
If self is a UTC time, Z is used as TZD. [+-]hh:mm is used otherwise.
&lt;tt&gt;fractional_seconds&lt;/tt&gt; specifies a number of digits of fractional seconds. Its default value is 0.

(еще известен как iso8601)
===Time#yday===
----
  &lt;tt&gt;time.yday =&amp;gt; fixnum&lt;/tt&gt;
----
Returns an integer representing the day of the year, 1..366.
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:04 CDT 2003
   t.yday         #=&gt; 99&lt;/code&gt;
===Time#year===
----
  &lt;tt&gt;time.year =&amp;gt; fixnum&lt;/tt&gt;
----
Returns the year for &lt;i&gt;time&lt;/i&gt; (including the century).
   &lt;code&gt;t = Time.now   #=&amp;gt; Wed Apr 09 08:56:04 CDT 2003
   t.year         #=&gt; 2003&lt;/code&gt;
===Time#zone===
----
  &lt;tt&gt;time.zone =&amp;gt; string&lt;/tt&gt;
----
Возвращает наименовние часового поиса. В Ruby 1.8 возвращает UTC , а не GMT для времени UTC.

  &lt;code&gt;t = Time.gm(2000, &amp;quot;jan&amp;quot;, 1, 20, 15, 1)
   t.zone   #=&gt; &quot;UTC&quot;
   t = Time.local(2000, &quot;jan&quot;, 1, 20, 15, 1)
   t.zone   #=&gt; &quot;CST&quot;&lt;/code&gt;

Пример Ruby 2.0

  &lt;code&gt;t=Time.new
   t.zone #=&gt; OMST&lt;/code&gt;
[[Категория:Ruby|Справочник/Time]]</text>
      <sha1>a463mdv855alx8rpyy1ax1rb7ixts08</sha1>
    </revision>
  </page>
  <page>
    <title>Python/Учебник Python 3.1</title>
    <ns>0</ns>
    <id>5101</id>
    <revision>
      <id>270436</id>
      <parentid>265141</parentid>
      <timestamp>2026-10-27T07:39:09Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270436</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="374579" sha1="14e70awlfgll8o8kpex9uose3cp094g" xml:space="preserve">{{Python/DocPart}}

{|class=&quot;standard&quot;
 |''Исходный текст''
 |http://docs.python.org/3.1/tutorial/
 |-
 |''Автор''
 |Фред Л. Дрейк мл. (Fred L. Drake, Jr. ) [https://docs.python.org/3.1/about.html и другие]
 |-
 |''Релиз''
 |3.1.5
 |-
 |''Версия от''
 |09 апреля 2012
 |}


__TOC__


=== Описание ===

Python — мощный и простой для изучения язык программирования. В нём предоставлены проработанные высокоуровневые структуры данных и простой, но эффективный подход к объектно-ориентированному программированию. Сочетание изящного синтаксиса и динамической типизации, совмещённых с интерпретируемой сущностью, делает Python идеальным языком для написания сценариев и ускоренной разработки приложений в различных сферах и на большинстве платформ.

Интерпретатор Python и разрастающаяся стандартная библиотека находятся в свободном доступе в виде исходников и бинарных файлов для всех основных платформ на официальном сайте Python http://www.python.org и могут распространяться без ограничений. Кроме этого на сайте содержатся дистрибутивы и ссылки на многочисленные модули третьих сторон для языка Python, различные программы и инструменты, а также дополнительная документация.

Интерпретатор Python может быть легко расширен с помощью новых функций и типов данных, написанных на C/C++ (или других языках, к которым можно получить доступ из C). Также Python можно применять как язык расширений для настраиваемых приложений.

Этот учебник неформально представляет читателю основные концепции и возможности языка и системы Python. Полезно держать интерпретатор Python под рукой для получения практического опыта, но при этом все примеры самодостаточны, так что учебник вполне возможно читать вне сети.

Описание стандартных объектов и модулей вы можете найти в [[Справочник по библиотеке Python 3.1|справочнике по библиотеке Python]]. [[Справочник по языку Python 3.1|Руководство по языку]] даёт более формальное описание языка. Перед написанием расширений на C/C++ ознакомьтесь с [[Расширение и встраивание - Python 3.1|руководством по расширению и встраиванию в интерпретатор]] и [[Python 3.1 - C API|справочником по Python/C API]]. Существует также несколько книг, в которых подробно рассмотрен язык Python.

Этот учебник не претендует на звание всеобъемлющего и не описывает каждую особенность Python: он даже не описывает ''все'' его часто используемые особенности. Вместо этого он знакомит читателя с наиболее заслуживающими внимания из них и даёт вам представление о стиле и ''привкусе'' языка. После прочтения учебника вы сможете писать и читать программы и модули, написанные на Python, и будете готовы узнать больше о различных модулях библиотеки Python, описанных в [[Справочник по библиотеке Python 3.1|справочнике по библиотеке Python]].

Кроме того, будет нелишним полистать [[Глоссарий Python 3.1|Глоссарий]].

== Разжигая ваш аппетит !==

Если вы много работаете за компьютером — то периодически обнаруживаете задачи, которые хотели бы автоматизировать. Например, вы были бы не против ускорить операцию поиска и замены большого количества текстовых файлов, или как-то своеобразно переименовать и отсортировать набор фотографий. Возможно, вам хотелось бы написать небольшую базу данных на заказ, специализированное GUI-приложение или простую игру.

Если вы профессиональный разработчик программных продуктов — вероятно, вы привыкли работать с несколькими библиотеками на C/C++/Java, но находите обычный цикл написания/компиляции/тестирования/перекомпиляции кода чересчур медленным. Возможно, вы пишете набор тестов для такой библиотеки и процесс написания тестирующего кода воспринимается утомительным. Или же вы написали программу, которая должна использовать специальный язык для расширений и не хотите проектировать и разрабатывать полностью новый язык для вашего приложения.

Python — язык, который вам подойдёт.

Вы можете написать шелл-сценарий для Unix или использовать пакетные файлы Windows для некоторых из этих задач, но шелл-сценарии хороши лишь для перемещения файлов и замены текстовых данных — они вряд ли подойдут для написания приложений, снабженных графическим интерфейсом, или для игр. Вы можете написать программу на C/C++/Java, но разработка может занять довольно много времени — даже на то, чтобы получить первый рабочий набросок, его требуется немало. Python — проще в использовании, доступен на операционных системах Windows, Mac OS X и Unix, и поможет сделать работу намного быстрее.

Даже учитывая лёгкость использования, Python — полноценный язык программирования, предлагающий много больше возможностей для структурирования и поддержки крупных программ, чем могут позволить себе шелл-сценарии или пакетные файлы. С другой стороны, Python также предоставляет намного больше информации для отладки ошибок чем C и, будучи ''сверх-высокоуровневым-языком'', имеет встроенные высокоуровневые типы данных — такие, как гибкие массивы и словари. Благодаря наличию обобщённых типов данных Python применим для более широкого круга приложений, чем Awk или даже Perl, и при этом очень многие вещи остаются в языке Python как минимум настолько же простыми, насколько просты в упомянутых языках.

Python позволяет вам разделить вашу программу на модули, которые могут быть заново использованы в других программах на Python. Он поставляется вместе с внушительной коллекцией стандартных модулей, которые вы можете использовать в качестве фундамента ваших программ; или в качестве примеров для того, чтобы начать изучение Python. Многие из этих модулей предоставляют различную полезную функциональность: например, ввод-вывод для файлов, системные вызовы, сокеты, и даже инструменты для создания графического пользовательского интерфейса&amp;nbsp;— например, Tk.

Python — интерпретируемый язык, и это может сохранить вам немало времени при разработке — в компиляции и связывании нет необходимости. Интерпретатор может использоваться в интерактивном режиме, что позволяет легко экспериментировать с возможностями языка, писать программы-однодневки или проверять функции во время разработки программ методом снизу-вверх. И, кроме всего прочего — это удобный настольный калькулятор.

Python даёт возможность писать компактные и удобочитаемые программы. Программы, написанные на Python, отличаются большей краткостью, чем эквиваленты на C, C++ или Java по нескольким причинам:

* высокоуровневые типы данных позволяют вам выражать сложные операции в одной инструкции;
* группировка инструкций выполняется отступами, а не операторными скобками;
* нет необходимости в описании переменных или аргументов.

Python ''расширяем'': если вы знаете, как программировать на C, то вам легко будет добавить к интерпретатору новую встроенную функцию или модуль, либо для выполнения критических операции на максимальной скорости, либо для связывания программы на Python с библиотеками, которые могут быть доступны только в бинарной форме (например, зависящие от поставщика графические библиотеки). Как только вы приобретете соответствующий опыт, вы сможете привязать интерпретатор Python к приложению, написанному на C, чтобы использовать его как язык расширений или командный язык этого приложения.

Кстати, язык назван в честь шоу «Летающий цирк Монти Пайтона» на BBC и не имеет ничего общего с рептилиями. Ссылки на скетчи Монти Пайтона в документации не только позволены, но и приветствуются!

Теперь, когда ваш интерес к Python полностью пробужден, вам наверняка захочется изучить его более детально. В связи с тем, что лучший способ выучить язык — использовать его, автор приглашает вас использовать интерпретатор Python в процессе чтения.

В следующей главе описана механика использования интерпретатора. Это довольно приземленная информация, но она необходима для работы с примерами, которые будут представлены позже.

Остальная часть учебника описывает различные возможности языка и системы Python за счёт примеров — начиная с простых выражений, операторов и типов данных, рассматривая функции и модули, и заканчивая прикосновением к таким продвинутым концепциям как исключения и определённые пользователем&lt;ref&gt;''(Прим. перев.)'' Здесь и далее по учебнику понятия пользователя и программиста в некоторые моменты пересекаются, ввиду того что последний рассматривается как «пользователь языка». Обычно это понятно из контекста, но тем не менее, на всякий случай, поясняю.&lt;/ref&gt; классы.

== Использование интерпретатора Python ==

=== Запуск интерпретатора ===

Интерпретатор Python после установки располагается, обычно, по пути &lt;tt&gt;/usr/local/bin/python3.1&lt;/tt&gt; — на тех компьютерах, где этот путь доступен. Добавление каталога &lt;tt&gt;/usr/local/bin&lt;/tt&gt; к пути поиска Unix-шелла (переменная &lt;tt&gt;PATH&lt;/tt&gt;) позволит запустить интерпретатор набором команды

&lt;code&gt;python3.1&lt;/code&gt;salut

прямо из шелла&lt;ref&gt;В случае операционных систем UNIX, интерпретатор версии 3.1 по умолчанию устанавливается с исполняемым файлом, имеющим имя, отличное от &lt;tt&gt;python&lt;/tt&gt; — дабы не иметь конфликтов с (возможно) установленным исполняемым файлом версии 2.6&lt;/ref&gt;. Поскольку выбор каталога, в котором будет обитать интерпретатор, осуществляется при его установке, то возможны и другие варианты — посоветуйтесь с вашим Python-гуру или системным администратором. (Например, путь &lt;tt&gt;/usr/local/python&lt;/tt&gt; тоже популярен в качестве альтернативного расположения.)

На машинах с ОС Windows, инсталляция Python обычно осуществляется в каталог &lt;tt&gt;C:\Python31&lt;/tt&gt;, но и он может быть изменён во время установки. Чтобы добавить этот каталог к вашему пути поиска, вы можете набрать в окне DOS следующую команду, в ответ на приглашение:

&lt;code&gt;set path=%path%;C:\python31&lt;/code&gt;

При наборе символа конца файла (&lt;tt&gt;Ctrl-D&lt;/tt&gt; в Unix, &lt;tt&gt;Ctrl-Z&lt;/tt&gt; в Windows) в ответ на основное приглашение интерпретатора, последний будет вынужден закончить работу с нулевым статусом выхода. Если это не сработает — вы можете выйти из интерпретатора путём ввода следующих команд:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import sys; sys.exit()&lt;/syntaxhighlight&gt;

Особенности редактирования строк в интерпретаторе не оказываются обычно чересчур сложными. Те, кто установил интерпретатор на машину Unix, потенциально имеют поддержку библиотеки &lt;tt&gt;GNU readline&lt;/tt&gt;, обеспечивающей усовершенствованное интерактивное редактирование и сохранение истории. Самый быстрый, наверное, способ проверить, поддерживается ли расширенное редактирование командной строки, заключается в нажатии &lt;tt&gt;Ctrl-P&lt;/tt&gt; в ответ на первое полученное приглашение Python. Если вы услышите сигнал — значит вам доступно редактирование командной строки — тогда обратитесь к [[Учебник Python 3.1 — Приложения#Интерактивное редактирование входных данных и подстановка истории|Приложению об Интерактивном редактировании входных данных]] за описанием клавиш. Если на ваш взгляд ничего не произошло или отобразился символ &lt;tt&gt;^P&lt;/tt&gt; — редактирование командной строки недоступно — удалять символы из текущей строки возможно будет лишь использованием клавиши &lt;tt&gt;Backspace&lt;/tt&gt;.

Интерпретатор ведёт себя сходно шеллу Unix: если он вызван, когда ''стандартный ввод'' привязан к устройству &lt;tt&gt;tty&lt;/tt&gt; — он считывает и выполняет команды в режиме диалога; будучи вызванным с именем файла в качестве параметра или с файлом, назначенным на ''стандартный ввод'' — он читает и выполняет сценарий из этого файла.

Другой способ запустить интерпретатор — директива &lt;code&gt;'''python -c''' ''команда'' &lt;tt&gt;[arg]&lt;/tt&gt; ...&lt;/code&gt; — при её использовании поочередно выполняются инструкции(-ция) из ''команды'' (как при использовании опции '''-c''' Unix-шелла). В связи с тем, что инструкции Python часто содержат пробелы или другие специальные для шелла символы, рекомендуется заключать ''команды'' полностью в одинарные кавычки.

Некоторые модули Python оказываются полезными при использовании их в качестве сценариев. Они могут быть запущены в этом виде командой &lt;code&gt;'''python -m''' ''модуль'' &lt;tt&gt;[arg]&lt;/tt&gt; ...&lt;/code&gt; — таким образом исполняется исходный файл модуля (как произошло бы, если бы вы ввели его полное имя в командной строке).

Обратите внимание на различие между командами &lt;tt&gt;python file&lt;/tt&gt; и &lt;tt&gt;python &lt;file&lt;/tt&gt;. В последнем случае запросы на ввод из программы, такие как вызов &lt;code&gt;sys.stdin.read()&lt;/code&gt;, удовлетворяются из самого файла. Поскольку файл уже был прочитан до конца ещё до начала выполнения программы — символ конца файла будет обнаружен программой незамедлительно. В большинстве случаев (это, чаще всего, и есть те ситуации, которых вы ожидали) вызовы удовлетворяются независимо от того, файл или устройство привязаны к стандартному вводу интерпретатора Python.

При использовании файла сценария иногда полезно иметь возможность запустить сценарий и затем войти в интерактивный режим. Это может быть сделано через указание параметра '''-i''' перед именем сценария. (Этот способ не сработает, если сценарий считывается со стандартного ввода — по той самой причине, которая описана в предыдущем абзаце).

==== Передача параметров ====

В случае, если интерпретатору известны имя сценария и дополнительные параметры, с которыми он вызван, все они передаются сценарию в переменной &lt;code&gt;sys.argv&lt;/code&gt;, представляющей собой список (&lt;code&gt;list&lt;/code&gt;) строк. Длина (&lt;code&gt;length&lt;/code&gt;) списка — минимум, единица; если не переданы ни имя сценария, ни аргументы — то &lt;code&gt;sys.argv[0]&lt;/code&gt; содержит пустую строку. Когда в качестве имени сценария передан &lt;code&gt;'-'&lt;/code&gt; (означает ''стандартный ввод''), &lt;code&gt;sys.argv[0]&lt;/code&gt; устанавливается в &lt;code&gt;'-'&lt;/code&gt;. Если используется директива '''-c''' ''команда'' — &lt;code&gt;sys.argv[0]&lt;/code&gt; содержит &lt;code&gt;'-c'&lt;/code&gt;. В случае, если используется директива '''-m''' ''модуль'' — то &lt;code&gt;sys.argv[0]&lt;/code&gt; устанавливается равным полному имени модуля по расположению. Опции, обнаруженные после сочетаний '''-c''' ''команда'' или '''-m''' ''модуль'' не обрабатываются интерпретатором Python, но остаются в переменной &lt;code&gt;sys.argv&lt;/code&gt;, дабы обеспечить возможность отслеживания в самой команде или в модуле.

==== Интерактивный режим ====

Если команды считываются с &lt;tt&gt;tty&lt;/tt&gt; — говорят, что интерпретатор находится в ''интерактивном режиме'' (режиме диалога). В этом режиме он приглашает к вводу следующей команды, отобразив ''основное приглашение''&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;primary prompt&lt;/tt&gt; — ''зд.'', основное приглашение: приглашение к вводу команды или нескольких команд (сценария);&lt;/ref&gt; (обычно это три знака «больше-чем» — &lt;tt&gt;&amp;gt;&amp;gt;&amp;gt;&lt;/tt&gt;); в то же время, для ''продолжающих строк''&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;continuation lines&lt;/tt&gt; — ''зд.'', продолжающие строки (строки продолжения): строки, продолжающие текст команды (оператора, выражения), или раскрывающие внутреннее устройство внешнего оператора (команды, выражения), в последнем случае определяются дополнительным отступом от края — углублением в структуру;&lt;/ref&gt; выводится ''вспомогательное приглашение''&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;secondary prompt&lt;/tt&gt; — ''зд.'', вспомогательное приглашение: приглашение к продолжению ввода команды или набора команд (сценария) с использованием ''продолжающих строк'';&lt;/ref&gt; (по умолчанию — три точки — &lt;tt&gt;...&lt;/tt&gt;). Перед выводом первого приглашения интерпретатор отображает приветственное сообщение, содержащее номер его версии и пометку о правах копирования:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;$ python3.1
Python 3.1a1 (py3k, Sep 12 2007, 12:21:02)
[GCC 3.4.6 20060404 (Red Hat 3.4.6-8)] on linux2
Type &quot;help&quot;, &quot;copyright&quot;, &quot;credits&quot; or &quot;license&quot; for more information.
&gt;&gt;&gt;&lt;/syntaxhighlight&gt;

''Продолжающие строки'' используются в случаях, когда необходимо ввести многострочную конструкцию. Взгляните, например, на следующий оператор &lt;code&gt;if&lt;/code&gt;&lt;ref&gt;''(Прим. перев.)'' Здесь и далее тексты некоторых исходных кодов также будут переведены в примечаниях (вместе с ключевыми словами, поэтому их нельзя будет запустить в интерпретаторе), чтобы показать их смысл или задумку, которые не всегда очевидны без перевода (если он вам нужен :)):&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;&lt;span style=&quot;color: #aaa&quot;&gt;&gt;&gt;&gt;&lt;/span&gt; мир_плоский = 1&lt;br/&gt;
&lt;span style=&quot;color: #aaa&quot;&gt;&gt;&gt;&gt;&lt;/span&gt; '''если''' мир_плоский:&lt;br/&gt;
&lt;span style=&quot;color: #aaa&quot;&gt;...&lt;/span&gt;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;Будьте осторожны — не упадите!&quot;)&lt;br/&gt;
&lt;span style=&quot;color: #aaa&quot;&gt;...&lt;/span&gt; &lt;br/&gt;
&lt;span style=&quot;color: #030&quot;&gt;Будьте осторожны — не упадите!&lt;/span&gt;&lt;/code&gt;&lt;br /&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; the_world_is_flat = 1
&gt;&gt;&gt; if the_world_is_flat:
...     print(&quot;Be careful not to fall off!&quot;)
...
Be careful not to fall off!&lt;/syntaxhighlight&gt;

=== Интерпретатор и его окружение ===

==== Обработка ошибок ====

В случае появления ошибки интерпретатор выводит сообщение об ошибке, завершая его стеком вызовов. В интерактивном режиме он снова возвращается в состояние приглашения для ввода команд; если ввод происходит из файла — интерпретатор выходит с ненулевым статусом, сразу после распечатки стека вызовов. (Исключения, обрабатываемые в блоке &lt;code&gt;except&lt;/code&gt; оператора &lt;code&gt;try&lt;/code&gt; в этом контексте не считаются ошибками.) Некоторые ошибки исключительно фатальны и вызывают собой принудительное завершение работы с ненулевым статусом — это применимо к внутренним противоречиям языка и к некоторым случаям нехватки памяти. Все сообщения об ошибках выводятся в ''стандартный поток ошибок'' (&lt;tt&gt;error stream&lt;/tt&gt;). Обычный вывод исполняемых команд направляется в ''стандартный вывод''.

Нажатие клавиш прерывания процесса (обычно &lt;tt&gt;Ctrl-C&lt;/tt&gt; или &lt;tt&gt;DEL&lt;/tt&gt;), в ответ на приглашение в основном или вспомогательном режиме, отменяет ввод и возвращает вас к основному приглашению.&lt;ref&gt;Известная проблема в пакете &lt;tt&gt;GNU Readline&lt;/tt&gt; может этому помешать.&lt;/ref&gt; Символ прерывания, набранный во время выполнения какой-либо команды порождает исключение &lt;code&gt;KeyboardInterrupt&lt;/code&gt;, которое, в свою очередь, может быть перехвачено оператором &lt;code&gt;try&lt;/code&gt;.

==== Исполняемые сценарии на Python ====

На Unix-системах семейства BSD сценарии на Python могут быть сделаны исполняемыми, также как и шелл-сценарии, путём добавления следующей строки

&lt;code&gt;#! /usr/bin/env python3.1&lt;/code&gt;

(предполагается, что интерпретатор может быть найден по одному из путей, указанных в пользовательской переменной &lt;tt&gt;PATH&lt;/tt&gt;) в начало сценария и установки файла в исполняемый режим. Символы &lt;tt&gt;#!&lt;/tt&gt; должны быть первыми символами в файле. На некоторых платформах строка должна оканчиваться символом конца строки в стиле Unix (&lt;tt&gt;'\n'&lt;/tt&gt;), а не в стиле Windows (&lt;tt&gt;'\r\n'&lt;/tt&gt;). Заметьте, что символ решётки &lt;tt&gt;'#'&lt;/tt&gt; используется в Python для указания начала комментария.

Исполняемый режим (или разрешение на исполнение) может быть установлен сценарию использованием команды '''chmod''':

&lt;code&gt;$ chmod +x myscript.py&lt;/code&gt;

У систем с операционной системой Windows нет такого понятия, как исполняемый режим. Установщик Python автоматически связывает файлы &lt;tt&gt;.py&lt;/tt&gt; с файлом &lt;tt&gt;python.exe&lt;/tt&gt;, таким образом двойной клик на файле Python запустит его в виде сценария. Расширение может быть и &lt;tt&gt;.pyw&lt;/tt&gt; в случае, если окно консоли (которое, обычно, отображается) при запуске сценария подавляется.

==== Кодировка исходных файлов ====

По умолчанию, исходники Python считаются созданными в кодировке &lt;tt&gt;UTF-8&lt;/tt&gt;. В этой кодировке в строковых литералах, идентификаторах и комментариях могут быть использованы символы большинства языков мира — учитывая то, что стандартная библиотека Python использует символы &lt;tt&gt;ASCII&lt;/tt&gt; для именования идентификаторов — и этому соглашению должен следовать любой переносимый код. Для корректного отображения всех этих символов, ваш редактор должен опознавать файл как закодированный в &lt;tt&gt;UTF-8&lt;/tt&gt; и должен использовать шрифт, который содержит все символы, используемые в файле.

Также, есть возможность указать другую кодировку для исходных файлов. Для этого нужно добавить специальный комментарий следом за строкой &lt;tt&gt;#!&lt;/tt&gt;, дабы описать кодировку исходного файла:

&lt;code&gt;# -*- coding: encoding -*-&lt;/code&gt;

Если используется это описание — всё, что находится в этом файле будет опознаваться как имеющее соответствующую кодировку ''&lt;tt&gt;encoding&lt;/tt&gt;'', а не &lt;tt&gt;UTF-8&lt;/tt&gt;. Список возможных кодировок представлен в [[Справочник по библиотеке Python 3.1|Справочнике по библиотеке]] — в разделе, описывающем модуль [[Справочник по библиотеке Python 3.1#codecs|codecs]].

Например, если выбранный вами редактор не поддерживает файлы, закодированные &lt;tt&gt;UTF-8&lt;/tt&gt; и требует применения какой-либо другой кодировки, допустим &lt;tt&gt;Windows-1252&lt;/tt&gt;, вы можете написать:

&lt;code&gt;# -*- coding: cp-1252 -*-&lt;/code&gt;

И, с этого момента, использовать в исходных файлах только символы из таблицы символов &lt;tt&gt;Windows-1252&lt;/tt&gt;. Устанавливающий (отличную от установленной по умолчанию) кодировку специальный комментарий должен являться первой или второй строкой файла.

==== Интерактивный файл запуска ====

Если вы используете Python интерактивно — часто бывает удобным выполнить некоторые стандартные команды перед запуском интерпретатора. Вы можете сделать это, установив переменную окружения с именем &lt;tt&gt;PYTHONSTARTUP&lt;/tt&gt; равной имени файла, содержащего ваши команды запуска. Способ схож с использованием файла &lt;tt&gt;.profile&lt;/tt&gt; в Unix-шелле.

Этот файл читается только в интерактивных сессиях, но не в случае считывания команд из сценария, и не в случае, если &lt;tt&gt;/dev/tty&lt;/tt&gt; назначен как независимый источник команд (который в других случаях ведет себя сходно интерактивным сессиям). Файл исполняется в том же пространстве имён, что и исполняемые команды — поэтому объекты и импортированные модули, которые он определяет могут свободно использоваться в интерактивной сессии. Также в этом файле вы можете изменить приглашения: &lt;code&gt;sys.ps1&lt;/code&gt; и &lt;code&gt;sys.ps2&lt;/code&gt;.

Если вы хотите прочитать дополнительный файл запуска из текущего каталога — вы можете использовать код вроде:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;if os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())&lt;/syntaxhighlight&gt;

Если вы хотите использовать файл запуска в сценарии — вам нужно будет указать это явно:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import os
filename = os.environ.get('PYTHONSTARTUP')
if filename and os.path.isfile(filename):
    exec(open(filename).read())&lt;/syntaxhighlight&gt;

== Неформальное введение в Python ==

В приведенных далее примерах, ввод и вывод различаются присутствием и отсутствием приглашений соответственно (приглашениями являются &lt;tt&gt;&gt;&gt;&gt;&lt;/tt&gt; и &lt;tt&gt;...&lt;/tt&gt;): чтобы воспроизвести пример — вам нужно ввести всё, что следует за приглашением, после его появления; строки, не начинающиеся с приглашений являются выводом интерпретатора. Обратите внимание, что строка, в которой содержится лишь вспомогательное приглашение («&lt;tt&gt;... &lt;/tt&gt;») означает, что вам нужно ввести пустую строку — этот способ используется для завершения многострочных команд.

Большинство примеров в этом руководстве — даже те, которые вводятся в интерактивном режиме — содержат комментарии. Комментарии в Python начинаются с символа решетки # (&lt;tt&gt;hash&lt;/tt&gt;) — и продолжаются до физического конца строки. Комментарии могут находиться как в начале строки, так и следовать за пробельными символами или кодом — но не содержаться внутри строки. Символ решётки в строке остаётся лишь символом решётки. Поскольку комментарии предназначены для того, чтобы сделать код более понятным, и не интерпретируются Python — при вводе примеров они могут быть опущены.

Несколько примеров:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;# это первый комментарий
SPAM = 1                 # а это второй комментарий
                         # ... и наконец третий!
STRING = &quot;# Это не комментарий.&quot;&lt;/syntaxhighlight&gt;

=== Использование Python в качестве калькулятора ===

Давайте опробуем несколько простых команд Python. Запустите интерпретатор и дождитесь появления основного приглашения — &lt;tt&gt;&gt;&gt;&gt;&lt;/tt&gt;. (Это не должно занять много времени.)

==== Числа ====
Вот вам маленький пример:
print(&quot;Привет, как дела?&quot;)

Поведение интерпретатора сходно поведению калькулятора: вы вводите выражение, а в ответ он выводит значение. Синтаксис выражений привычен: операции &lt;code&gt;+&lt;/code&gt;, &lt;code&gt;-&lt;/code&gt;, &lt;code&gt;*&lt;/code&gt; и &lt;code&gt;/&lt;/code&gt; работают так же как и в большинстве других языков (например, Паскале или C); для группировки можно использовать скобки. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 2+2
4
&gt;&gt;&gt; # Это комментарий
... 2+2
4
&gt;&gt;&gt; 2+2  # а вот комментарий на одной строке с кодом
4
&gt;&gt;&gt; (50-5*6)/4
5.0
&gt;&gt;&gt; 8/5 # При делении целых чисел дробные части не теряются
1.6000000000000001
&lt;/syntaxhighlight&gt;

''Заметьте'': Вы можете получить результат, несколько отличный от представленного: результаты деления с плавающей запятой могут различаться на разных системах. Позже мы расскажем о том, как контролировать вывод чисел с плавающей запятой. Здесь использован наиболее информативный вариант вывода этого значения, а не более легко-читаемый, какой возможен:
&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print(8/5)
1.6
&lt;/syntaxhighlight&gt;

Чтобы учебник читался легче, мы будем показывать упрощённый вывод чисел с плавающей точкой и объясним позже, почему эти два способа отображения чисел с плавающей точкой стали различными. Обратитесь к приложению [[Учебник Python 3.1 — Приложения#Арифметика с плавающей точкой - Проблемы и ограничения|Арифметика с плавающей точкой: Проблемы и ограничения]], чтобы ознакомиться с подробным обсуждением.

Для получения целого результата при делении целых чисел, отсекая дробные результаты, предназначена другая операция: &lt;tt&gt;//&lt;/tt&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # Деление целых чисел возвращает округлённое к минимальному значение:
... 7//3
2
&gt;&gt;&gt; 7//-3
-2&lt;/syntaxhighlight&gt;

Знак равенства (&lt;code&gt;'='&lt;/code&gt;) используется для присваивания переменной какого-либо значения. После этого действия в интерактивном режиме ничего не выводится:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; width = 20
&gt;&gt;&gt; height = 5*9
&gt;&gt;&gt; width * height
900&lt;/syntaxhighlight&gt;

Значение может быть присвоено нескольким переменным одновременно:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; x = y = z = 0  # Нулевые x, y и z
&gt;&gt;&gt; x
0
&gt;&gt;&gt; y
0
&gt;&gt;&gt; z
0&lt;/syntaxhighlight&gt;

Переменные должны быть ''определены'' (&lt;tt&gt;defined&lt;/tt&gt;) (должны иметь присвоенное значение) перед использованием, иначе будет сгенерирована ошибка:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # попытка получить доступ к неопределённой переменной
... n
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in &lt;module&gt;
NameError: name 'n' is not defined&lt;/syntaxhighlight&gt;

Присутствует полная поддержка операций с плавающей точкой; операции над операндами смешанного типа конвертируют целочисленный операнд в число с плавающей запятой:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 3 * 3.75 / 1.5
7.5
&gt;&gt;&gt; 7.0 / 2
3.5&lt;/syntaxhighlight&gt;

Поддерживаются и комплексные числа, добавлением к мнимым частям суффикса &lt;code&gt;j&lt;/code&gt; или &lt;code&gt;J&lt;/code&gt;. Комплексные числа с ненулевым вещественным компонентом записываются в виде &lt;code&gt;(''&lt;вещественная_часть&gt;''+''&lt;мнимая_часть&gt;''j)&lt;/code&gt;, или могут быть созданы с помощью функции &lt;code&gt;complex(''&lt;вещественная_часть&gt;'', ''&lt;мнимая_часть&gt;'')&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 1j * 1J
(-1+0j)
&gt;&gt;&gt; 1j * complex(0, 1)
(-1+0j)
&gt;&gt;&gt; 3+1j*3
(3+3j)
&gt;&gt;&gt; (3+1j)*3
(9+3j)
&gt;&gt;&gt; (1+2j)/(1+1j)
(1.5+0.5j)&lt;/syntaxhighlight&gt;

Комплексные числа всегда представлены в виде двух чисел с плавающей запятой — вещественной и мнимой частями. Для получения этих частей из комплексного числа &lt;code&gt;z&lt;/code&gt; используется &lt;code&gt;z.real&lt;/code&gt; и &lt;code&gt;z.imag&lt;/code&gt; соответственно.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a=1.5+0.5j
&gt;&gt;&gt; a.real
1.5
&gt;&gt;&gt; a.imag
0.5&lt;/syntaxhighlight&gt;

Функции конвертации (приведения) к вещественным и целым числам (&lt;code&gt;float()&lt;/code&gt;, &lt;code&gt;int()&lt;/code&gt;) не работают с комплексными числами, так как нет единственно правильного способа сконвертировать комплексное число в вещественное. Используйте функцию &lt;code&gt;abs(z)&lt;/code&gt; чтобы получить ''модуль'' числа (в виде числа с плавающей точкой) или &lt;code&gt;z.real&lt;/code&gt; чтобы получить его вещественную часть:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a=3.0+4.0j
&gt;&gt;&gt; float(a)
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
TypeError: can`t convert complex to float; use abs(z)
&gt;&gt;&gt; a.real
3.0
&gt;&gt;&gt; a.imag
4.0
&gt;&gt;&gt; abs(a)  # sqrt(a.real**2 + a.imag**2)
5.0
&gt;&gt;&gt;&lt;/syntaxhighlight&gt;

В интерактивном режиме последнее выведенное выражение сохраняется в переменной &lt;code&gt;_&lt;/code&gt;. Это значит, что если вы используете Python в качестве настольного калькулятора — всегда есть способ продолжить вычисления с меньшими усилиями, например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; tax = 12.5 / 100
&gt;&gt;&gt; price = 100.50
&gt;&gt;&gt; price * tax
12.5625
&gt;&gt;&gt; price + _
113.0625
&gt;&gt;&gt; round(_, 2)
113.06
&gt;&gt;&gt;&lt;/syntaxhighlight&gt;

Эта переменная для пользователя должна иметь статус ''только для чтения''. Не навязывайте ей значение собственноручно — вы создадите независимую переменную с таким же именем, скрывающую встроенную переменную вместе с её магическими свойствами.

==== Строки ====

Помимо чисел, Python может работать со строками, которые, в свою очередь, могут быть описаны различными способами. Строки могут быть заключены в одинарные или двойные кавычки:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 'spam eggs'
'spam eggs'
&gt;&gt;&gt; 'doesn\'t'
&quot;doesn't&quot;
&gt;&gt;&gt; &quot;doesn't&quot;
&quot;doesn't&quot;
&gt;&gt;&gt; '&quot;Yes,&quot; he said.'
'&quot;Yes,&quot; he said.'
&gt;&gt;&gt; &quot;\&quot;Yes,\&quot; he said.&quot;
'&quot;Yes,&quot; he said.'
&gt;&gt;&gt; '&quot;Isn\'t,&quot; she said.'
'&quot;Isn\'t,&quot; she said.'&lt;/syntaxhighlight&gt;

Интерпретатор выводит результаты операций над строками тем же способом, каким они были введены: обрамляя в кавычки, и, кроме того, экранируя обратными слэшами внутренние кавычки и другие забавные символы — для того, чтобы отобразить точное значение. Строка заключается в двойные кавычки, если строка содержит одинарные кавычки и ни одной двойной, иначе она заключается в одинарные кавычки. Повторимся, функция &lt;tt&gt;print()&lt;/tt&gt; предоставляет более читаемый вывод.

Строковые литералы могут быть разнесены на несколько строк различными способами. Могут быть использованы ''продолжающие строки'', с обратным слэшем в качестве последнего символа строки, сообщающим о том, что следующая строка есть продолжение текущей&lt;ref&gt;''(Прим. перев.):''&lt;syntaxhighlight lang=&quot;python&quot;&gt;hello = &quot;Это довольно длинная строка, содержащая\n\
 несколько строк текста — такой вы бы представили её в C.\n\
    Обратите внимание, что пробельное пространство в начале строки\
 имеет значение.&quot;

print(hello)&lt;/syntaxhighlight&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;hello = &quot;This is a rather long string containing\n\
 several lines of text just as you would do in C.\n\
    Note that whitespace at the beginning of the line is\
 significant.&quot;

print(hello)&lt;/syntaxhighlight&gt;

Обратите внимание, что новые строки все ещё нужно подключать в строку через &lt;code&gt;\n&lt;/code&gt;; символ новой строки, перед которым идёт обратный слэш — не обрабатывается. Запуск примера выведет следующее:

&lt;pre&gt;This is a rather long string containing
several lines of text just as you would do in C.
    Note that whitespace at the beginning of the line is significant.&lt;/pre&gt;

Если мы объявим строковой литерал ''сырым'' (&lt;tt&gt;raw&lt;/tt&gt;)&lt;ref&gt;''(Прим. перев.)'' ''raw string'' — для описания ''сырой строки'' (не требующей последующей обработки) используется префикс '''&lt;code&gt;r&lt;/code&gt;'''.&lt;/ref&gt; — символы &lt;code&gt;\n&lt;/code&gt; не будут конвертированы в новые строки, но и обратный слэш в конце строки, и символ новой строки в исходном коде — будут добавлены в строку в виде данных. Следовательно, код из примера:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;hello = r&quot;This is a rather long string containing\n\
several lines of text much as you would do in C.&quot;

print(hello)&lt;/syntaxhighlight&gt;

выведет:

&lt;pre&gt;This is a rather long string containing\n\
several lines of text much as you would do in C.&lt;/pre&gt;

Или, строки могут быть обрамлены совпадающей парой тройных кавычек: &lt;code&gt;&quot;&quot;&quot;&lt;/code&gt; или &lt;code&gt;&lt;nowiki&gt;'''&lt;/nowiki&gt;&lt;/code&gt;. Окончания строк не нужно завершать тройными кавычками — при этом будут включены в строку.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;print(&quot;&quot;&quot;
Usage: thingy [OPTIONS]
     -h                        Display this usage message
     -H hostname               Hostname to connect to
&quot;&quot;&quot;)&lt;/syntaxhighlight&gt;

выводит в результате следующее:

&lt;syntaxhighlight lang=&quot;text&quot;&gt;Usage: thingy [OPTIONS]
     -h                        Display this usage message
     -H hostname               Hostname to connect to&lt;/syntaxhighlight&gt;

Строки могут конкатенироваться (склеиваться вместе) операцией &lt;code&gt;+&lt;/code&gt; и быть повторенными операцией &lt;code&gt;*&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word = 'Help' + 'A'
&gt;&gt;&gt; word
'HelpA'
&gt;&gt;&gt; '&lt;' + word*5 + '&gt;'
'&lt;HelpAHelpAHelpAHelpAHelpA&gt;'&lt;/syntaxhighlight&gt;

Два строковых литерала, расположенные друг за другом, автоматически конкатенируются; первая строка в предыдущем примере также могла быть записана как &lt;code&gt;word = 'Help' 'A'&lt;/code&gt;; это работает только с двумя литералами — не с произвольными выражениями, содержащими строки.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 'str' 'ing'                   #  &lt;-  Так — верно
'string'
&gt;&gt;&gt; 'str'.strip() + 'ing'   #  &lt;-  Так — верно
'string'
&gt;&gt;&gt; 'str'.strip() 'ing'     #  &lt;-  Так — не верно
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
    'str'.strip() 'ing'
                      ^
SyntaxError: invalid syntax&lt;/syntaxhighlight&gt;

Строки могут быть проиндексированы; также как и в C, первый символ строки имеет индекс &lt;tt&gt;0&lt;/tt&gt;. Отсутствует отдельный тип для символов; символ является строкой с единичной длиной. Как и в языке программирования Icon, подстроки могут определены через нотацию срезов (&lt;tt&gt;slice&lt;/tt&gt;): два индекса, разделенных двоеточием.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[4]
'A'
&gt;&gt;&gt; word[0:2]
'He'
&gt;&gt;&gt; word[2:4]
'lp'&lt;/syntaxhighlight&gt;

Индексы срезов имеют полезные значения по умолчанию; опущенный первый индекс заменяется нулём, опущенный второй индекс подменяется размером срезаемой строки.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[:2]    # Первые два символа
'He'
&gt;&gt;&gt; word[2:]    # Всё, исключая первые два символа
'lpA'&lt;/syntaxhighlight&gt;

В отличие от строк в C, строки Python не могут быть изменены. Присваивание по позиции индекса строки вызывает ошибку:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[0] = 'x'
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
TypeError: 'str' object doesn't support item assignment
&gt;&gt;&gt; word[:1] = 'Splat'
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
TypeError: 'str' object doesn't support slice assignment&lt;/syntaxhighlight&gt;

Тем не менее, создание новой строки со смешанным содержимым — процесс легкий и очевидный:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 'x' + word[1:]
'xelpA'
&gt;&gt;&gt; 'Splat' + word[4]
'SplatA'&lt;/syntaxhighlight&gt;

Полезный инвариант операции среза: &lt;code&gt;s[:i] + s[i:]&lt;/code&gt; эквивалентно &lt;code&gt;s&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[:2] + word[2:]
'HelpA'
&gt;&gt;&gt; word[:3] + word[3:]
'HelpA'&lt;/syntaxhighlight&gt;

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

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[1:100]
'elpA'
&gt;&gt;&gt; word[10:]
''
&gt;&gt;&gt; word[2:1]
''&lt;/syntaxhighlight&gt;

Индексы могут быть отрицательными числами, обозначая при этом отсчет справа налево. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[-1]     # Последний символ
'A'
&gt;&gt;&gt; word[-2]     # Предпоследний символ
'p'
&gt;&gt;&gt; word[-2:]    # Последние два символа
'pA'
&gt;&gt;&gt; word[:-2]    # Всё, кроме последних двух символов
'Hel'&lt;/syntaxhighlight&gt;

Но обратите внимание, что &lt;tt&gt;-0&lt;/tt&gt; действительно эквивалентен &lt;tt&gt;0&lt;/tt&gt; — это не отсчет справа.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[-0]     # (поскольку -0 равен 0)
'H'&lt;/syntaxhighlight&gt;

Отрицательные индексы вне диапазона обрезаются, но не советуем делать это с одно-элементными индексами (''не-срезами''):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[-100:]
'HelpA'
&gt;&gt;&gt; word[-10]    # ошибка
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
IndexError: string index out of range&lt;/syntaxhighlight&gt;

Один из способов запомнить, как работают срезы — думать о них, как об указателях на места между символами, где левый край первого символа установлен в ноль, а правый край последнего символа строки из &lt;code&gt;n&lt;/code&gt; символов имеет индекс &lt;code&gt;n&lt;/code&gt;, например:

&lt;pre&gt; +---+---+---+---+---+
 | H | e | l | p | A |
 +---+---+---+---+---+
 0   1   2   3   4   5
-5  -4  -3  -2  -1&lt;/pre&gt;

Первый ряд чисел дает позицию индексов строки от 0 до 5; второй ряд описывает соответствующие отрицательные индексы. Срез от i до j состоит из всех символов между правым и левым краями, отмеченными, соответственно, через &lt;code&gt;i&lt;/code&gt; и &lt;code&gt;j&lt;/code&gt;.

Для всех индексов, больших или равных нулю, длина среза — разность между индексами, при условии что оба индекса находятся в диапазоне. Например, длина &lt;code&gt;word[1:3]&lt;/code&gt; — 2.

Встроенная функция &lt;code&gt;len()&lt;/code&gt; возвращает длину строки&lt;ref&gt;''(Прим. перев.)'': [[w:en:Supercalifragilisticexpialidocious|Supercalifragilisticexpialidocious]] — английское слово из одноименной песни, прозвучавшей в фильме [[w:en:Mary Poppins (film)|Мэри Поппинс]]&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; s = 'supercalifragilisticexpialidocious'
&gt;&gt;&gt; len(s)
34&lt;/syntaxhighlight&gt;

{{Смотрите также|
;[[Справочник по библиотеке Python 3.1#Перечисляемые типы|Перечисляемые типы]]: Строки — вид перечисляемых типов и они поддерживают привычные для этих типов операции.
;[[Справочник по библиотеке Python 3.1#Строковые методы|Строковые методы]]: Строки поддерживают большое количество методов для поиска и простых трансформаций.
;[[Справочник по библиотеке Python 3.1#Форматирование строк|Форматирование строк]]: Здесь описано форматирование строк с применением функции &lt;code&gt;str.format()&lt;/code&gt;
;[[Справочник по библиотеке Python 3.1#Форматирование строк в старом стиле|Операции форматирования строк в старом стиле]]:Операции форматирования, вызывающиеся тогда, когда обычные строки или строки в Unicode оказываются левым операндом относительно операции &lt;code&gt;%&lt;/code&gt;, более детально рассмотрены здесь.&lt;ref&gt;''(Прим. перев.) Эти операции будут отключены в финальном релизе 3.1''&lt;/ref&gt;
}}

==== О Unicode ====

Начиная с Unicode версии 3.0, строковый тип поддерживает только Unicode (см. http://www.unicode.org/).

Преимущество набора Unicode состоит в том, что он предоставляет порядковый номер для любого символа из любой письменности, использовавшейся в современных или древнейших текстах. До этих пор для символов в сценарии было доступно лишь 256 номеров. Тексты обычно привязывались к кодовой странице, которая устанавливала в соответствие порядковые номера и символы сценария. Это приводило к серьезной путанице, особенно в том, что касалось интернационализации&lt;ref&gt;Часто записывается как &lt;tt&gt;'''i18n'''&lt;/tt&gt; — &lt;tt&gt;''internationalization'' = '''i''' + '''18''' символов + '''n'''&lt;/tt&gt;&lt;/ref&gt; программного продукта. Unicode решает эти проблемы, определяя единую кодовую страницу для всех письменностей.

Для вставки в строку специального символа можно использовать Unicode-экранирование (&lt;tt&gt;Python Unicode-Escape encoding&lt;/tt&gt;). Следующий пример всё пояснит:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 'Hello\u0020World !'
'Hello World !'&lt;/syntaxhighlight&gt;

Экранированная последовательность &lt;code&gt;\u0020&lt;/code&gt; задаёт символ Unicode с порядковым номером &lt;tt&gt;0x0020&lt;/tt&gt; (символ пробела).

Другие символы интерпретируются с использованием соответствующих им порядковых значений тем же способом, что и порядковые номера Unicode. Первые 128 символов кодировки Unicode полностью совпадают с 128 символами кодировки &lt;tt&gt;Latin-1&lt;/tt&gt;, использующейся во многих западных странах.

Помимо стандартных способов кодирования, Python предоставляет целый набор различных способов создания Unicode-строк, основываясь на известной кодировке.

Для конвертирования Unicode-строки в последовательность байтов с использованием желаемой кодировки, строковые объекты предоставляют метод &lt;code&gt;encode()&lt;/code&gt;, принимающий единственный параметр — название кодировки. Предпочитаются названия кодировок, записанные в нижнем регистре.


==== Списки ====

В языке Python доступно некоторое количество ''составных'' типов данных, использующихся для группировки прочих значений вместе. Наиболее гибкий из них — список (&lt;tt&gt;list&lt;/tt&gt;). Его можно выразить в тексте программы через разделённые запятыми значения (''элементы''), заключённые в квадратные скобки. Элементы списка могут быть разных типов.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = ['spam', 'eggs', 100, 1234]
&gt;&gt;&gt; a
['spam', 'eggs', 100, 1234]&lt;/syntaxhighlight&gt;

Подобно индексам в строках, индексы списков начинаются с нуля, списки могут быть срезаны, объединены (''конкатенированы'') и так далее:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a[0]
'spam'
&gt;&gt;&gt; a[3]
1234
&gt;&gt;&gt; a[-2]
100
&gt;&gt;&gt; a[1:-1]
['eggs', 100]
&gt;&gt;&gt; a[:2] + ['bacon', 2*2]
['spam', 'eggs', 'bacon', 4]
&gt;&gt;&gt; 3*a[:3] + ['Boo!']
['spam', 'eggs', 100, 'spam', 'eggs', 100, 'spam', 'eggs', 100, 'Boo!']&lt;/syntaxhighlight&gt;

В отличие от строк, являющихся неизменяемыми, изменить индивидуальные элементы списка вполне возможно:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a
['spam', 'eggs', 100, 1234]
&gt;&gt;&gt; a[2] = a[2] + 23
&gt;&gt;&gt; a
['spam', 'eggs', 123, 1234]&lt;/syntaxhighlight&gt;

Присваивание срезу также возможно, и это действие может даже изменить размер списка или полностью его очистить:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # Заменим некоторые элементы:
... a[0:2] = [1, 12]
&gt;&gt;&gt; a
[1, 12, 123, 1234]
&gt;&gt;&gt; # Удалим немного:
... a[0:2] = []
&gt;&gt;&gt; a
[123, 1234]
&gt;&gt;&gt; # Вставим пару:
... a[1:1] = ['bletch', 'xyzzy']
&gt;&gt;&gt; a
[123, 'bletch', 'xyzzy', 1234]
&gt;&gt;&gt; # Вставим (копию) самого себя в начало
&gt;&gt;&gt; a[:0] = a
&gt;&gt;&gt; a
[123, 'bletch', 'xyzzy', 1234, 123, 'bletch', 'xyzzy', 1234]
&gt;&gt;&gt; # Очистка списка: замена всех значений пустым списком
&gt;&gt;&gt; a[:] = []
&gt;&gt;&gt; a
[]&lt;/syntaxhighlight&gt;

Встроенная функция &lt;code&gt;len()&lt;/code&gt; также применима к спискам:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = ['a', 'b', 'c', 'd']
&gt;&gt;&gt; len(a)
4&lt;/syntaxhighlight&gt;

Вы можете встраивать списки (создавать списки, содержащие другие списки), например так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; q = [2, 3]
&gt;&gt;&gt; p = [1, q, 4]
&gt;&gt;&gt; len(p)
3
&gt;&gt;&gt; p[1]
[2, 3]
&gt;&gt;&gt; p[1][0]
2&lt;/syntaxhighlight&gt;

Вы можете добавить что-нибудь в конец списка.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; p[1].append('xtra')
&gt;&gt;&gt; p
[1, [2, 3, 'xtra'], 4]&lt;/syntaxhighlight&gt;

Обратите внимание, что в последнем примере &lt;code&gt;p[1]&lt;/code&gt; и &lt;code&gt;q&lt;/code&gt; на самом деле ссылаются на один и тот же объект!

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; q
[2, 3, 'xtra']&lt;/syntaxhighlight&gt;

Мы вернёмся к ''семантике объектов'' позже.

=== Первые шаги к программированию ===

Безусловно, Python можно использовать для более сложных задач, чем сложение двух чисел. Например, мы можем вывести начало последовательности чисел Фибоначчи таким образом:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # Ряд Фибоначчи:
... # сумма двух элементов определяет следущий элемент
... a, b = 0, 1
&gt;&gt;&gt; while b &lt; 10:
...     print(b)
...     a, b = b, a+b
...
1
1
2
3
5
8&lt;/syntaxhighlight&gt;

Этот пример показывает нам некоторые новые возможности.

* Первая строка содержит ''множественное присваивание'' (&lt;tt&gt;multiple assignment&lt;/tt&gt;): переменные &lt;code&gt;a&lt;/code&gt; и &lt;code&gt;b&lt;/code&gt; параллельно получают новые значения — &lt;code&gt;0&lt;/code&gt; и &lt;code&gt;1&lt;/code&gt;. В последней строке этот метод используется снова, демонстрируя тот факт, что выражения по правую сторону [от оператора присваивания] всегда вычисляются раньше каких бы то ни было присваиваний. Сами же разделённые запятыми выражения вычисляются слева направо.

* Цикл &lt;code&gt;while&lt;/code&gt; (пока) исполняется до тех пор, пока условие (здесь: &lt;code&gt;b &lt; 10&lt;/code&gt;) остается истиной. В Python, также как и в C, любое ненулевое значение является истиной (&lt;code&gt;True&lt;/code&gt;); ноль является ложью (&lt;code&gt;False&lt;/code&gt;). Условием может быть строка, список или вообще любая последовательность; все, что имеет ненулевую длину, играет роль истины, пустые последовательности — лжи. Использованная в примере проверка — простое условие. Стандартные операции сравнения записываются так же, как и в C: &lt;code&gt;&lt;&lt;/code&gt; (меньше чем), &lt;code&gt;&gt;&lt;/code&gt; (больше чем), &lt;code&gt;==&lt;/code&gt; (равно), &lt;code&gt;&lt;=&lt;/code&gt; (меньше или равно), &lt;code&gt;&gt;=&lt;/code&gt; (больше или равно) и &lt;code&gt;!=&lt;/code&gt; (не равно).

* ''Тело'' цикла выделено ''отступом'' (&lt;tt&gt;indented&lt;/tt&gt;). Отступы — это средство группировки операторов в Python. Интерактивный режим Python (пока!) не имеет какого-либо разумного и удобного средства для редактирования строк ввода, поэтому необходимо использовать табуляции или пробелы для отступа в каждой строке. На практике более сложный текст на Python готовится в текстовом редакторе, большинство из которых имеют функцию авто-отступа. По окончании ввода составного выражения в интерактивном режиме его необходимо закончить пустой строкой — признаком завершения (поскольку интерпретатор не может угадать, когда вами была введена последняя строка). Обратите внимание, что размер отступа в каждой строке основного блока должен быть одним и тем же&lt;ref&gt;''(Прим. перев.)'' Размер отступа для блока не унифицирован — табуляция может чередоваться с пробелами, это может быть один пробел или же пять — главное, чтобы у всего блока он был одинаковым и был больше по величине чем у внешнего (обрамляющего) блока. Тем не менее, чаще всего программисты на Python устанавливают в редакторах режим замены табуляции четырьмя пробелами и при наборе кода вложенность блока обозначают отступом с соответствующим количеством нажатий клавиш табуляции. Благодаря этому код остается читабельным во всех текстовых редакторах и в большинстве браузеров (или, в редких случаях, требует минимального форматирования для корректного отображения)).''&lt;/ref&gt;.

* Функция &lt;code&gt;print()&lt;/code&gt; выводит значения переданных ей выражений. Поведение этой функции отличается от обычного вывода выражения (как происходило выше в примерах с калькулятором) тем, каким способом обрабатываются ряды выражений, величины с плавающей точкой и строки. Строки выводятся без кавычек, и между элементами вставляются пробелы, благодаря чему форматирование вывода улучшается — как, например, здесь:
&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; i = 256*256
&gt;&gt;&gt; print('Значением i является', i)
Значением i является 65536&lt;/syntaxhighlight&gt;
: Для отключения перевода строки после вывода или завершения вывода другой строкой используется именованный параметр &lt;code&gt;end&lt;/code&gt;:
&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a, b = 0, 1
&gt;&gt;&gt; while b &lt; 1000:
...     print(b, end=' ')
...     a, b = b, a+b
...
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987&lt;/syntaxhighlight&gt;

== Больше средств для управления потоком команд&lt;ref&gt;''(Прим. перев.)'' More Control Flow Tools; [[w:en:Control Flow|Control Flow]] — поток команд, процесс управления, алгоритм; подразделы в оригинале используют множественное число: &quot;Операторы (выражения, инструкции) &lt;code&gt;if&lt;/code&gt;, «Операторы (выражения, инструкции) &lt;code&gt;for&lt;/code&gt;», и. т. п.&lt;/ref&gt; ==

Помимо описанного выше оператора &lt;code&gt;while&lt;/code&gt;, в Python доступны привычные операторы управления потоком из других языков, но с некоторыми особенностями.

=== Оператор &lt;code&gt;if&lt;/code&gt; ===

Возможно, наиболее широко известный тип оператора — оператор &lt;code&gt;if&lt;/code&gt; (если). Пример:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; x = int(input(&quot;Введите, пожалуйста, целое число: &quot;))
Введите, пожалуйста, целое число: 42
&gt;&gt;&gt; if x &lt; 0:
...      x = 0
...      print('Отрицательное значение, изменено на ноль')
... elif x == 0:
...      print('Ноль')
... elif x == 1:
...      print('Один')
... else:
...      print('Больше')
...&lt;/syntaxhighlight&gt;

Блока &lt;code&gt;elif&lt;/code&gt; может не быть вообще, он может быть один или их может быть несколько, а блок &lt;code&gt;else&lt;/code&gt; (иначе) необязателен. Ключевое слово &lt;tt&gt;elif&lt;/tt&gt; — краткая запись &lt;tt&gt;else if&lt;/tt&gt; (иначе если) — позволяет избавиться от чрезмерного количества отступов. Оператор &lt;code&gt;if&lt;/code&gt; &lt;tt&gt;...&lt;/tt&gt; &lt;code&gt;elif&lt;/code&gt; &lt;tt&gt;...&lt;/tt&gt; &lt;code&gt;elif&lt;/code&gt; &lt;tt&gt;...&lt;/tt&gt; — аналог оператора выбора &lt;code&gt;switch&lt;/code&gt; или &lt;code&gt;case&lt;/code&gt;, которые можно встретить в других языках программирования.

=== Оператор &lt;code&gt;for&lt;/code&gt; ===

Оператор &lt;code&gt;for&lt;/code&gt; в Python немного отличается от того, какой вы, возможно, использовали в C или Pascal. Вместо неизменного прохождения по арифметической прогрессии из чисел (как в Pascal) или предоставления пользователю возможности указать шаг итерации и условие остановки (как в С), оператор &lt;code&gt;for&lt;/code&gt; в Python проходит по всем элементам любой последовательности (списка или строки) в том порядке, в котором они в ней располагаются. Например (игра слов не подразумевалась):&lt;ref&gt;''(Прим. перев.)'' Defenestrate{{ref-en}} — выкидывать кого-либо из окна с целью покалечить. Другие слова — «кошка» и «окно».&lt;/ref&gt;

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # Измерим несколько строк:
... a = ['cat', 'window', 'defenestrate']
&gt;&gt;&gt; for x in a:
...     print(x, len(x))
...
cat 3
window 6
defenestrate 12&lt;/syntaxhighlight&gt;

Изменять содержимое последовательности, по которой проходит цикл, небезопасно (это в принципе-то возможно только для изменяемых типов, таких как списки). Если необходимо модифицировать список, использующийся для организации цикла, (например, для того чтобы продублировать отдельные элементы) нужно передать циклу его копию. Нотация срезов делает это практически безболезненным:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for x in a[:]:  # создать срез-копию всего списка
...    if len(x) &gt; 6: a.insert(0, x)
...
&gt;&gt;&gt; a
['defenestrate', 'cat', 'window', 'defenestrate']&lt;/syntaxhighlight&gt;

=== Функция &lt;code&gt;range()&lt;/code&gt; ===

&lt;ad/lang=ru/id=5938)'''''Если вам нужно перебрать последовательность чисел, встроенная функция &lt;code&gt;range()&lt;/code&gt; придёт на помощь. Она генерирует арифметические прогрессии:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for i in range(5):
...    print(i)
...
0
1
2
3
4&lt;/syntaxhighlight&gt;


&lt;syntaxhighlight lang=&quot;python&quot;&gt;range(5, 10)
   от 5 до 9

range(0, 10, 3)
   0, 3, 6, 9

range(-10, -100, -30)
   -10, -40, -70&lt;/syntaxhighlight&gt;

Чтобы пройти по всем индексам какой-либо последовательности, скомбинируйте вызовы &lt;code&gt;range()&lt;/code&gt; и &lt;code&gt;len()&lt;/code&gt; следующим образом:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = ['Mary', 'had', 'a', 'little', 'lamb']
&gt;&gt;&gt; for i in range(len(a)):
...     print(i, a[i])
...
0 Mary
1 had
2 a
3 little
4 lamb&lt;/syntaxhighlight&gt;

В большинстве таких случаев удобно использовать функцию &lt;code&gt;enumerate()&lt;/code&gt;, обратитесь к [[Учебник Python 3.1#Организация циклов|Организация циклов]].

Странные вещи начинают происходить при попытке вывода последовательности:
&lt;ad/lang=ru/id=5938)'''''
&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print(range(10))
range(0, 10)&lt;/syntaxhighlight&gt;

Во многих случаях объект, возвращаемый функцией &lt;code&gt;range()&lt;/code&gt;, ведёт себя как список, но фактически им не является. Этот объект возвращает по очереди элементы желаемой последовательности, когда вы проходите по нему в цикле, но на самом деле не создаёт списка, сохраняя таким образом пространство в памяти.

Мы называем такие объекты ''итерируемыми'' (&lt;tt&gt;iterable&lt;/tt&gt;), и это все объекты, которые предназначаются для функций и конструкций, ожидающих от них поочерёдного предоставления элементов до тех пор, пока источник не иссякнет. Мы видели, что оператор &lt;code&gt;for&lt;/code&gt; является таким ''итератором'' &lt;tt&gt;iterator&lt;/tt&gt;. Функция &lt;code&gt;list()&lt;/code&gt; тоже из их числа — она создаёт списки из ''итерируемых'' объектов:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; list(range(5))
[0, 1, 2, 3, 4]&lt;/syntaxhighlight&gt;

Позже мы познакомимся и с другими функциями, которые возвращают и принимают ''итерируемые'' объекты в качестве параметров.

=== Операторы &lt;code&gt;break&lt;/code&gt; и &lt;code&gt;continue&lt;/code&gt;, а также условие &lt;code&gt;else&lt;/code&gt; в циклах ===

Оператор &lt;code&gt;break&lt;/code&gt; прерывает выполнение самого ближайшего вложенного цикла &lt;code&gt;for&lt;/code&gt; или &lt;code&gt;while&lt;/code&gt; (по аналогии с языком C).

Оператор &lt;code&gt;continue&lt;/code&gt;, также заимствованный из C, продолжает выполнение цикла со следующей итерации.

Операторы циклов могут иметь ветвь &lt;code&gt;else&lt;/code&gt;. Она исполняется, когда цикл выполнил перебор до конца (в случае &lt;code&gt;for&lt;/code&gt;) или когда условие становится ложным (в случае &lt;code&gt;while&lt;/code&gt;), но не в тех случаях, когда цикл прерывается по &lt;code&gt;break&lt;/code&gt;. Это поведение иллюстрируется следующим примером, в котором производится поиск простых чисел:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for n in range(2, 10): 
...     for x in range(2, int(n ** 0.5) + 1):
...         if n % x == 0:
...             print(n, 'равно', x, '*', n//x)
...             break
...     else:
...             print(n, '- простое число')
...
2 - простое число
3 - простое число
4 равно 2 * 2
5 - простое число
6 равно 2 * 3
7 - простое число
8 равно 2 * 4
9 равно 3 * 3&lt;/syntaxhighlight&gt;

=== Оператор &lt;code&gt;pass&lt;/code&gt; ===

Оператор &lt;code&gt;pass&lt;/code&gt; не делает ничего. Он может использоваться когда синтаксически требуется присутствие оператора, но от программы не требуется действий. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; while True:
...       pass # Ожидание прерывания c клавиатуры (Ctrl+C) в режиме занятости
...&lt;/syntaxhighlight&gt;

Этот оператор часто используется для создания минималистичных классов, к примеру ''исключений'' (&lt;tt&gt;exceptions&lt;/tt&gt;), или для игнорирования нежелательных исключений:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; class ParserError(Exception):
...     pass
...
&gt;&gt;&gt; try:
...     import audioop
... except ImportError:
...     pass
...&lt;/syntaxhighlight&gt;

Другой вариант: &lt;code&gt;pass&lt;/code&gt; может применяться в качестве заглушки для тела функции или условия при создании нового кода, позволяя вам сохранить абстрактный взгляд на вещи. С другой стороны, оператор &lt;code&gt;pass&lt;/code&gt; игнорируется без каких-либо сигналов и лучшим выбором было бы породить исключение &lt;code&gt;NotImplementedError&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def initlog(*args):
...     raise NotImplementedError   # Открыть файл для логгинга, если он ещё не открыт
...     if not logfp:
...         raise NotImplementedError  # Настроить заглушку для логгинга
...     raise NotImplementedError('Обработчик инициализации лога вызовов')
...&lt;/syntaxhighlight&gt;

Если бы здесь использовались операторы &lt;code&gt;pass&lt;/code&gt;, а позже вы бы запускали тесты, они могли бы упасть без указания причины. Использование &lt;code&gt;NotImplementedError&lt;/code&gt; принуждает этот код породить исключение, сообщая вам конкретное место, где присутствует незавершённый код. Обратите внимание на два способа порождения исключений. Первый способ, без сообщения, но сопровождаемый комментарием, позволяет вам оставить комментарий когда вы будете подменять выброс исключения рабочим кодом, который, в свою очередь, в идеале, будет хорошим описанием блока кода, для которого исключение предназначалось заглушкой. Однако, передача сообщения вместе с исключением, как в третьем примере, обуславливает более насыщенный информацией вывод при отслеживании ошибки.

=== Определение функций ===

Мы можем создать функцию, которая выводит последовательность Фибоначчи до некоторого предела:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def fib(n):    # вывести числа Фибоначчи меньшие (вплоть до) n
...     &quot;&quot;&quot;Выводит ряд Фибоначчи, ограниченный числом n.&quot;&quot;&quot;
...     a, b = 0, 1
...     while b &lt; n:
...         print(b, end=' ')
...         a, b = b, a+b
...
&gt;&gt;&gt; # Теперь вызовем определенную нами функцию:
... fib(2000)
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597&lt;/syntaxhighlight&gt;

Зарезервированное слово &lt;code&gt;def&lt;/code&gt; предваряет ''определение'' функции. За ним должны следовать имя функции и заключённый в скобки список формальных параметров. Выражения, формирующие тело функции, начинаются со следующей строки и должны иметь отступ.

Первым выражением в теле функции может быть строковой литерал — этот литерал является строкой документации функции, или ''док-строкой'' (&lt;tt&gt;docstring&lt;/tt&gt;). (Больше информации о ''док-строках'' вы найдёте в разделе [[Учебник Python 3.1#Строки документации|Строки документации]]) Существуют инструменты, которые используют ''док-строки'' для того, чтобы сгенерировать печатную или онлайн-документацию или чтобы позволить пользователю перемещаться по коду интерактивно; добавление строк документации в ваш код — это хорошая практика, постарайтесь к ней привыкнуть.

''Исполнение'' функции приводит к созданию новой таблицы символов&lt;ref&gt;''(Прим. перев.)'' Здесь слово «символ» используется не в привычном значении — под ''символом'' подразумевается нечто лингвистическое, описывающее какую-либо сущность (близко к значению ''символизировать''), в данном случае: имя переменной — саму переменную.&lt;/ref&gt;, использующейся для хранения локальных переменных функции. Если быть более точными, все присваивания переменных в функции сохраняют значение в локальной таблице символов; при обнаружении ссылки на переменную, в первую очередь просматривается локальная таблица символов, затем локальная таблица символов для окружающих функций, затем глобальная таблица символов и, наконец, таблица встроенных имён. Таким образом, глобальным переменным невозможно прямо присвоить значения внутри функций (если они конечно не упомянуты в операторе &lt;code&gt;global&lt;/code&gt;) несмотря на то, что ссылки на них могут использоваться.

Фактические параметры при вызове функции помещаются в локальную таблицу символов вызванной функции; в результате аргументы передаются через ''вызов по значению'' (&lt;tt&gt;call by value&lt;/tt&gt;) (где значение — это всегда ''ссылка'' (&lt;tt&gt;reference&lt;/tt&gt;) на объект, а не значение его самого)&lt;ref&gt;На самом деле, лучшим определением был бы ''вызов по ссылке на объект'' (&lt;tt&gt;call by object reference&lt;/tt&gt;), так как при передаче изменяемого объекта, вызывающему будут видны все изменения, которые производит над объектом вызываемый (вставка элементов в список)&lt;/ref&gt;. Если одна функция вызывает другую — то для этого вызова создается новая локальная таблица символов.

При определении функции её имя также помещается в текущую таблицу символов. Тип значения, связанного с именем функции, распознается интерпретатором как функция, определённая пользователем (&lt;tt&gt;user-defined function&lt;/tt&gt;). Само значение может быть присвоено другому имени, которое затем может также использоваться в качестве функции. Эта система работает в виде основного механизма переименования:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; fib
&lt;function fib at 10042ed0&gt;
&gt;&gt;&gt; f = fib
&gt;&gt;&gt; f(100)
1 1 2 3 5 8 13 21 34 55 89&lt;/syntaxhighlight&gt;

Если вы использовали в работе другие языки программирования, вы можете возразить, что &lt;code&gt;fib&lt;/code&gt; — это не функция, а процедура, поскольку не возвращает никакого значения. На самом деле, даже функции без ключевого слова &lt;code&gt;return&lt;/code&gt; возвращают значение, хотя и более скучное. Такое значение именуется &lt;code&gt;None&lt;/code&gt; (это встроенное имя). Вывод значения &lt;code&gt;None&lt;/code&gt; обычно подавляется в интерактивном режиме интерпретатора, если оно оказывается единственным значением, которое нужно вывести. Вы можете проследить за этим процессом, если действительно хотите, используя функцию &lt;code&gt;print()&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; fib(0)
&gt;&gt;&gt; print(fib(0))
None&lt;/syntaxhighlight&gt;

Довольно легко написать функцию, которая возвращает список чисел из ряда Фибоначчи, вместо того, чтобы выводить их:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def fib2(n): # вернуть числа Фибоначчи меньшие (вплоть до) n
...     &quot;&quot;&quot;Возвращает список чисел ряда Фибоначчи, ограниченный n.&quot;&quot;&quot;
...     result = []
...     a, b = 0, 1
...     while b &lt; n:
...         result.append(b)    # см. ниже
...         a, b = b, a+b
...     return result
...
&gt;&gt;&gt; f100 = fib2(100)    # вызываем
&gt;&gt;&gt; f100                # выводим результат
[1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]&lt;/syntaxhighlight&gt;

И на этот раз пример демонстрирует некоторые новые возможности Python:

* Оператор &lt;code&gt;return&lt;/code&gt; завершает выполнение функции, возвращая некоторое значение. Оператор &lt;code&gt;return&lt;/code&gt; без аргумента возвращает &lt;code&gt;None&lt;/code&gt;. Достижение конца функции также возвращает &lt;code&gt;None&lt;/code&gt;.

* Выражение &lt;code&gt;result.append(b)&lt;/code&gt; вызывает метод &lt;code&gt;append&lt;/code&gt; объекта-списка &lt;code&gt;result&lt;/code&gt;. Метод — это функция, которая «принадлежит» объекту и указывается через выражение вида &lt;code&gt;obj.methodname&lt;/code&gt;, где &lt;code&gt;obj&lt;/code&gt; — некоторый объект (может быть выражением), а &lt;code&gt;methodname&lt;/code&gt; — имя метода, присущий объекту данного типа. Различные типы определяют различные методы. Методы разных типов могут иметь одинаковые имена, не вызывая неопределённостей. (Позже в этом учебнике будет рассмотрено как определять собственные типы объектов и методы, используя классы.) Метод &lt;code&gt;append()&lt;/code&gt;, показанный в примере, определён для объектов типа список. Он добавляет в конец списка новый элемент. В данном примере это действие эквивалентно выражению &lt;code&gt;result = result + [b]&lt;/code&gt;, но более эффективно.

=== Подробнее об определении функций ===

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

==== Значения аргументов по умолчанию ====

Наиболее полезной формой является задание значений по умолчанию для одного или более параметров. Таким образом создаётся функция, которая может быть вызвана с меньшим количеством параметров, чем в её определении: при этом неуказанные при вызове параметры примут данные в определении функции значения. Например&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;'''опред''' спросить_подтверждения(вопрос, попытки=4, протест='Да или нет, пожалуйста!'):&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''пока''' ''Истина'':&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;ответ = ''ввод''(вопрос)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''если''' ответ '''среди''' ('д', 'да', 'ага'): '''вернуть''' ''Истина''&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''если''' ответ '''среди''' ('н', 'не', 'нет', 'не-а'): '''вернуть''' ''Ложь''&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;попытки = попытки - 1&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''если''' попытки &lt; 0: '''породить''' ОшибкаВВ('пользователь-отказник')&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(протест)&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;
(''Refusenik''{{ref-en}} — [[w:ru:Отказник|Отказник]]). Ниже: «…&lt;code&gt;спросить_подтверждения('Вы действительно хотите выйти?')&lt;/code&gt; или так: &lt;code&gt;спросить_подтверждения('Согласны ли вы перезаписать файл?', 2)&lt;/code&gt;…»&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def ask_ok(prompt, retries=4, complaint='Yes or no, please!'):
    while True:
        ok = input(prompt)
        if ok in ('y', 'yeah', 'yes', 'yep'): return True
        if ok in ('n', 'no', 'nop', 'nope'): return False
        retries = retries - 1
        if retries &lt; 0:
            raise IOError('refusenik user')
        print(complaint)&lt;/syntaxhighlight&gt;

Эта функция может быть вызвана, например, так: &lt;code&gt;ask_ok('Do you really want to quit?')&lt;/code&gt; или так: &lt;code&gt;ask_ok('OK to overwrite the file?', 2)&lt;/code&gt;.

Этот пример также знакомит вас с зарезервированным словом &lt;code&gt;in&lt;/code&gt;. Посредством его можно проверить, содержит ли последовательность определённое значение или нет.

Значения по умолчанию вычисляются в месте определения функции, в ''определяющей'' области, поэтому код

&lt;syntaxhighlight lang=&quot;python&quot;&gt;i = 5

def f(arg=i):
    print(arg)

i = 6
f()&lt;/syntaxhighlight&gt;

выведет 5.

'''Важное предупреждение:''' Значение по умолчанию вычисляется лишь единожды. Это особенно важно помнить, когда значением по умолчанию является изменяемый объект, такой как список, словарь (&lt;tt&gt;dictionary&lt;/tt&gt;) или экземпляры большинства классов. Например, следующая функция накапливает переданные ей параметры:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def f(a, L=[]):
    L.append(a)
    return L

print(f(1))
print(f(2))
print(f(3))&lt;/syntaxhighlight&gt;

Она выведет

&lt;syntaxhighlight lang=&quot;python&quot;&gt;[1]
[1, 2]
[1, 2, 3]&lt;/syntaxhighlight&gt;

Если вы не хотите, чтобы значение по умолчанию распределялось между последовательными вызовами, вместо предыдущего варианта вы можете использовать такую идиому:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def f(a, L=None):
    if L is None:
        L = []
    L.append(a)
    return L&lt;/syntaxhighlight&gt;

==== Именованные параметры&lt;ref&gt;''(Прим. перев.)'' В оригинале — Keyword Arguments — параметры по ключевым словам, ключевые параметры (далее используется слово ''keywords'' для набора имён параметров непостоянного количества. ''Ключевые'' — возможно, корректнее, но как мне показалось — менее понятно ([http://www.infocity.kiev.ua/prog/python/content/sempit_14.phtml альтернативный перевод]))&lt;/ref&gt; ====

Функции также могут быть вызваны с использованием именованных параметров (&lt;tt&gt;keyword arguments&lt;/tt&gt;) в форме «''имя = значение''». Например, нижеприведённая функция&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;'''опред''' попугай(вольтаж, состояние='труп', действие='ввум', тип='Норвежский Голубой'):&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Этот попугай не сделает &quot;, действие, завершить=' ')&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;если вы пропустите через него &quot;, вольтаж, &quot; вольт.&quot;)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Великолепное оперенье, &quot;, тип)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Он&quot;, состояние, &quot;!&quot;)&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;
(''Из [http://www.ibras.dk/montypython/episode08.htm#6 скетча Монти Пайтона]'')&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def parrot(voltage, state='a stiff', action='voom', type='Norwegian Blue'):
    print(&quot;-- This parrot wouldn't&quot;, action, end=' ')
    print(&quot;if you put&quot;, voltage, &quot;volts through it.&quot;)
    print(&quot;-- Lovely plumage, the&quot;, type)
    print(&quot;-- It's&quot;, state, &quot;!&quot;)&lt;/syntaxhighlight&gt;

могла бы быть вызвана любым из следующих способов&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;попугай(действие='ВВУУУУМ', вольтаж=1000000)&lt;br/&gt;
попугай('тысячу', состояние='слёг в могилу')&lt;br/&gt;
попугай('миллион', 'лишённый жизни', 'прыжок')&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;parrot(1000)
parrot(action='VOOOOOM', voltage=1000000)
parrot('a thousand', state='pushing up the daisies')
parrot('a million', 'bereft of life', 'jump')&lt;/syntaxhighlight&gt;

а эти случаи оказались бы неверными&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;попугай()&lt;br/&gt;
попугай(вольтаж=5.0, 'мёртв')&lt;br/&gt;
попугай(исполнитель='Джон Клиз')&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;parrot()                     # пропущен требуемый аргумент
parrot(voltage=5.0, 'dead')  # позиционный параметр вслед за именованным
parrot(110, voltage=220)     # повторное значение параметра
parrot(actor='John Cleese')  # неизвестное имя параметра&lt;/syntaxhighlight&gt;

В общем случае, список параметров должен содержать любое количество позиционных (&lt;tt&gt;positional&lt;/tt&gt;) параметров, за которыми может следовать любое количество именованных, и при этом имена аргументов выбираются из формальных параметров. Неважно, имеет формальный параметр значение по умолчанию или нет. Ни один из аргументов не может получать значение более чем один раз — имена формальных параметров, совпадающие с именами позиционных параметров, не могут использоваться в качестве именующих в одном и том же вызове&lt;ref&gt;''(Прим. перев.)'' В главе о функциях автор отталкивается не от привычного по другим учебникам первоначального полного описания определения функций, а уже потом — описания их вызова, а объединяет обе темы вместе (как минимум в случае с непостоянным списком аргументов это возможно непривычно, но оправдано), отдавая приоритет описанию вызова. Учебник рассчитан на тех, кто уже программирует на каком-либо языке программирования и потенциально не должен смутить читателя.&lt;/ref&gt;. Вот пример, завершающийся неудачей по причине описанного ограничения:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def function(a):
...     pass
...
&gt;&gt;&gt; function(0, a=0)
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
TypeError: function() got multiple values for keyword argument 'a'&lt;/syntaxhighlight&gt;

Если в определении функции присутствует завершающий параметр в виде ''**имя'', он получит в качестве значения словарь (подробнее в разделе [[Справочник по библиотеке Python 3.1#Типы-отображения|Справочника — Типы-отображения — словари]]), содержащий все именованные параметры и их значения, исключая те, которые соответствуют формальным параметрам. Можно совместить эту особенность с поддержкой формального параметра в формате ''*имя'' (описывается в следующем подразделе), который получает кортеж (&lt;tt&gt;tuple&lt;/tt&gt;), содержащий все позиционные параметры, следующие за списком формальных параметров. (параметр в формате ''*имя'' должен описываться перед параметром в формате ''**имя''.) Например, если мы определим такую функцию&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;'''опред''' лавка_сыров(сорт, *аргументы, **именованные):&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Есть ли у вас &quot;, сорт, '?')&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Простите, весь &quot;, сорт, &quot; у нас закончился.&quot;)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''для''' аргумент '''из''' аргументы: '''вывести'''(аргумент)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''('-' * 40)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;имена = '''сортированные'''(именованные.''ключи''())&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''для''' имя '''из''' имена: '''вывести'''(имя , &quot;:&quot;, именованные[имя])&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;
(''Из [http://www.ibras.dk/montypython/episode33.htm#7 скетча Монти Пайтона]'')&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def cheeseshop(kind, *arguments, **keywords):
    print(&quot;-- Do you have any&quot;, kind, &quot;?&quot;)
    print(&quot;-- I'm sorry, we're all out of&quot;, kind)
    for arg in arguments: print(arg)
    print(&quot;-&quot; * 40)
    keys = sorted(keywords.keys())
    for kw in keys: print(kw, &quot;:&quot;, keywords[kw])&lt;/syntaxhighlight&gt;

то её можно будет вызвать так&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;лавка_сыров(&quot;Лимбургер&quot;, &quot;Это очень расстраивает, сэр.&quot;,&lt;br /&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&quot;Это действительно очень, ОЧЕНЬ расстраивает, сэр.&quot;,&lt;br /&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;торговец=&quot;Майкл Палин&quot;,&lt;br /&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;клиент=&quot;Джон Клиз&quot;,&lt;br /&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;скетч=&quot;Скетч о сырной лавке&quot;)&lt;/code&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;cheeseshop('Limburger', &quot;It's very runny, sir.&quot;,
           &quot;It's really very, VERY runny, sir.&quot;,
           client=&quot;John Cleese&quot;,
           shopkeeper=&quot;Michael Palin&quot;,
           sketch=&quot;Cheese Shop Sketch&quot;)&lt;/syntaxhighlight&gt;

и она, конечно же, выведет&lt;ref&gt;''(Прим. перев.):''
&lt;br/&gt;&lt;br/&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;-- Есть ли у вас Лимбургер ?&lt;br/&gt;
-- Простите, весь Лимбургер у нас закончился.&lt;br/&gt;
Это очень расстраивает, сэр.&lt;br/&gt;
Это действительно очень, ОЧЕНЬ расстраивает, сэр.&lt;br/&gt;
&lt;nowiki&gt;----------------------------------------&lt;/nowiki&gt;&lt;br/&gt;
клиент: Джон Клиз&lt;br/&gt;
торговец : Майкл Палин&lt;br/&gt;
скетч : Скетч о сырной лавке&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;&lt;/ref&gt;:

&lt;code&gt;-- Do you have any Limburger ?&lt;br/&gt;
-- I'm sorry, we're all out of Limburger&lt;br/&gt;
It's very runny, sir.&lt;br/&gt;
It's really very, VERY runny, sir.&lt;br/&gt;
&lt;nowiki&gt;----------------------------------------&lt;/nowiki&gt;&lt;br/&gt;
client : John Cleese&lt;br/&gt;
shopkeeper : Michael Palin&lt;br/&gt;
sketch : Cheese Shop Sketch&lt;/code&gt;

Обратите внимание, что список имён (ключей) именованных параметров (&lt;code&gt;keys&lt;/code&gt;) создается посредством сортировки содержимого списка ключей &lt;code&gt;keys()&lt;/code&gt; словаря &lt;code&gt;keywords&lt;/code&gt;; если бы этого не было сделано, порядок вывода параметров был бы произволен.

==== Списки параметров произвольной длины ====

Наконец, наиболее редко используется возможность указания того, что функция может быть вызвана с произвольным числом аргументов. При этом сами параметры будут обёрнуты в кортеж (см. раздел [[Учебник Python 3.1#Кортежи|Кортежи]]). Переменное количество параметров могут предварять ноль или более обычных.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def write_multiple_items(file, separator, *args):
    file.write(separator.join(args))&lt;/syntaxhighlight&gt;

Обычно параметры неизвестного заранее количества (&lt;tt&gt;variadic&lt;/tt&gt;) указываются последними в списке формальных параметров, поскольку включают в себя все остальные переданные в функцию параметры. Все формальные параметры, которые следуют за параметром &lt;code&gt;*args&lt;/code&gt;, должны быть только именованными, то есть, они могут быть заданы только по имени (в отличие от позиционных параметров).

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def concat(*args, sep=&quot;/&quot;):
...    return sep.join(args)
...
&gt;&gt;&gt; concat(&quot;earth&quot;, &quot;mars&quot;, &quot;venus&quot;)
'earth/mars/venus'
&gt;&gt;&gt; concat(&quot;earth&quot;, &quot;mars&quot;, &quot;venus&quot;, sep=&quot;.&quot;)
'earth.mars.venus'&lt;/syntaxhighlight&gt;

==== Распаковка списков параметров ====

Обратная ситуация возникает когда параметры уже содержатся в списке или в кортеже, но должны быть распакованы для вызова функции, требующей отдельных позиционных параметров. Например, встроенная функция &lt;code&gt;range()&lt;/code&gt; ожидает отдельные параметры ''start'' и ''stop'' соответственно. Если они не доступны раздельно, для распаковки аргументов из списка или кортежа в вызове функции используйте *-синтаксис:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; list(range(3, 6))             # обычный вызов с отдельными параметрами
[3, 4, 5]
&gt;&gt;&gt; args = [3, 6]
&gt;&gt;&gt; list(range(*args))            # вызов с распакованными из списка параметрами
[3, 4, 5]&lt;/syntaxhighlight&gt;

Схожим способом, словари могут получать именованные параметры через **-синтаксис&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;'''опред''' попугай(вольтаж, состояние='труп', действие='ввум', тип='Норвежский Голубой'):&lt;br/&gt;
...&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Этот попугай не сделает &quot;, действие, конец=' ')&lt;br/&gt;
...&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;если вы пропустите через него &quot;, вольтаж, &quot; вольт.&quot;, конец=' ')&lt;br/&gt;
...&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Это&quot;, состояние, &quot;!&quot;)&lt;br/&gt;
...&lt;br/&gt;
&gt;&gt;&gt; d = {&quot;вольтаж&quot;: &quot;четыре миллиона&quot;, &quot;состояние&quot;: &quot;кровавая кончина&quot;, &quot;действие&quot;: &quot;ВВУМ&quot;}&lt;br/&gt;
&gt;&gt;&gt; попугай(**d)&lt;br/&gt;
-- Этот попугай не сделает ВВУМ если вы пропустите через него четыре миллиона вольт. Это кровавая смерть !&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;
(''Из [http://www.ibras.dk/montypython/episode08.htm#6 скетча Монти Пайтона]'')&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def parrot(voltage, state='a stiff', action='voom'):
...     print(&quot;-- This parrot wouldn't&quot;, action, end=' ')
...     print(&quot;if you put&quot;, voltage, &quot;volts through it.&quot;, end=' ')
...     print(&quot;It's&quot;, state, &quot;!&quot;)
...
&gt;&gt;&gt; d = {&quot;voltage&quot;: &quot;four million&quot;, &quot;state&quot;: &quot;bleedin' demised&quot;, &quot;action&quot;: &quot;VOOM&quot;}
&gt;&gt;&gt; parrot(**d)
-- This parrot wouldn't VOOM if you put four million volts through it. It's bleedin' demised !&lt;/syntaxhighlight&gt;

==== Модель &lt;tt&gt;lambda&lt;/tt&gt; ====

В связи с неустанными просьбами, в Python были добавлены несколько возможностей, которые были привычны для функциональных языков программирования, таких как Lisp. Используя зарезервированное слово &lt;code&gt;lambda&lt;/code&gt;, вы можете создать небольшую безымянную функцию. Например, функцию, которая возвращает сумму двух своих аргументов, можно записать так: &lt;code&gt;lambda a, b: a+b&lt;/code&gt;. Формы &lt;code&gt;lambda&lt;/code&gt; могут быть использованы в любом месте где требуется объект функции. При этом они синтаксически ограничены одним выражением. Семантически, они лишь «синтаксический сахар» для обычного определения функции. Как и определения вложенных функций, &lt;code&gt;lambda&lt;/code&gt;-формы могут ссылаться на переменные из содержащей их области видимости:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def make_incrementor(n):
...     return lambda x: x + n
...
&gt;&gt;&gt; f = make_incrementor(42)
&gt;&gt;&gt; f(0)
42
&gt;&gt;&gt; f(1)
43&lt;/syntaxhighlight&gt;

==== Строки документации ====

Перечислим некоторые существующие соглашения по содержимому строк документации и их форматированию.

По поводу форматирования строк документации и их содержимого постоянно появляются всё новые соглашения.

Первая строка всегда должна быть сжатой, лаконичной сводкой о назначении объекта. Для краткости, в ней не обязательно присутствие имени типа или объекта, поскольку они доступны другими способами (исключая случай, когда имя функции оказывается глаголом, описывающим суть операции). Эта строка должна начинаться с прописной буквы и оканчиваться точкой.

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

Парсер Python не обрабатывает отступы в много-строковых литералах, поэтому инструментам, которые работают над документацией, предлагается, по желанию, делать это самим. Производится это по следующему соглашению. Первая непустая строка после первой строки литерала определяет величину отступа всего литерала документации. (Мы не можем использовать первую строку, поскольку она обычно выравнивается по открывающим кавычкам и её отступ в литерале не явен). Пробельный «эквивалент» этого отступа затем отрезается от начала всех строк литерала. Строк с меньшим отступом не должно обнаруживаться, но если они встретились, весь их начальный отступ должен быть обрезан. Эквивалентность пробельных замен может быть протестирована развертыванием табуляции (обычно, к 8 пробелам).

Вот пример многострочной документации (''док-строки''):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def my_function():
...     &quot;&quot;&quot;Не делаем ничего, но документируем.
...
...     Нет, правда, эта функция ничего не делает.
...     &quot;&quot;&quot;
...     pass
...
&gt;&gt;&gt; print(my_function.__doc__)
Не делаем ничего, но документируем.

    Нет, правда, эта функция ничего не делает.&lt;/syntaxhighlight&gt;

=== Интермеццо: Стиль написания кода ===

Теперь, когда вам предстоит писать более объёмные и сложные блоки кода на Python, настало время поговорить о ''стиле написания кода'' (&lt;tt&gt;coding style&lt;/tt&gt;). Код на большинстве языков программирования может быть записан (или, точнее говоря, ''отформатирован'' (&lt;tt&gt;formatted&lt;/tt&gt;)) различными способами; некоторые из них более читабельны, некоторые — нет. Стремление к написанию лёгкого для прочтения другими кода всегда считалось хорошим тоном, и выбор правильного стиля для кода крайне ему способствует.

В случае языка Python, в качестве руководства по стилю было создано предложение [http://www.python.org/dev/peps/pep-0008 PEP8]&lt;ref&gt;''(Прим. перев.)'' — &lt;tt&gt;[[w:Python_Enhancement_Proposal|PEP]]&lt;/tt&gt; (&lt;/tt&gt;''Python Enchancement Proprosal&lt;/tt&gt;'', Предложение по улучшению Python) — документ, имеющий стандартизированный формат и описывающий какую-либо из возможностей или какое-либо из свойств языка Python, планируемые для разработки в будущем (или уже разработанную). В завершённом варианте используется как основное соглашение по данной функциональности. (см. также [[w:Python#Дальнейшая разработка|пояснение на странице языка Python]])&lt;/ref&gt;, которого придерживаются создатели большинства проектов. В нём учреждается чрезвычайно читабельный и приятный для глаза стиль написания кода. В некоторый момент с ним должен ознакомиться каждый разработчик на Python. Приведём здесь избранные, наиболее важные, пункты:

* Используйте отступ в 4 пробела, не используйте табуляцию
: 4 пробела легко опознаются и в случае небольших отступов (хватает места для глубоких вложений) и в случае больших отступов (приятнее читается). Табуляция вносит путаницу и лучше от неё воздержаться.
* Разделяйте строки так, чтобы их длина не превышала 79-и символов
: Это поможет пользователям с небольшими экранами, а пользователям с большими экранами позволит уложить несколько файлов с исходным кодом рядом.
* Используйте пустые строки для отделения функций, классов, и крупных блоков внутри функций.
* При возможности располагайте комментарий на отдельной строке.
* Используйте строки документации (''док-строки'')
* Применяйте пробелы вокруг символов операций и после запятых, но не добавляйте их в конструкции со скобками: &lt;code&gt;a = f(1, 2) + g(3, 4)&lt;/code&gt;
* Называйте ваши классы и функции единообразно; соглашение следующее: используйте &lt;code&gt;CamelCase&lt;/code&gt;&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;CamelCase&lt;/tt&gt; (''ВерблюжийСтиль'') — стиль именования идентификаторов, при котором все слова, записанные строчными буквами, объединяются в одно и первая буква каждого слова выделяется заглавной буквой — такая запись напоминает верблюжьи горбы, в связи с чем и названа.&lt;/ref&gt; для именования классов и &lt;code&gt;нижний_регистр_с_подчёркиваниями&lt;/code&gt;&lt;/tt&gt;&lt;ref&gt;''(Прим. перев.)'' Пусть данный пример по вине переводчика и использует русские буквы, соглашение корректно настаивает на использовании латиницы для именования идентификаторов, см. следующий пункт соглашения&lt;/ref&gt; для функций и методов. (обращайтесь к разделу [[Учебник Python 3.1#Первый взгляд на классы|Первый взгляд на классы]] за дополнительной информацией о классах и методах)
* Не используйте в вашем коде изощрённых кодировок&lt;ref&gt;''(Прим. перев.)'' В строковых литералах (не комментариях) это, конечно же, позволено&lt;/ref&gt;, если он рассчитан на использование в интернациональной среде. Стандартный набор ASCII всегда работает на ура&lt;ref&gt;''(Прим. перев.)'' Не кодировка, а именно набор символов — латиница, пунктуация и несколько служебных символов. Кодировка по умолчанию для файлов с исходными кодами, начиная с Python 3.0, всегда UTF-8 — дабы существовала возможность использовать национальные символы в строковых литералах и, в редких случаях — комментариях.&lt;/ref&gt;.

== Структуры данных ==

Эта глава описывает подробнее некоторые вещи, которые вы уже изучили, а также раскрывает некоторые новые темы.

=== Подробнее о списках ===

У типа данных список также имеются не описанные ранее методы. Ниже приведены все методы объекта типа список:

;&lt;code&gt;list.append(''x'')&lt;/code&gt;:Добавить элемент к концу списка; эквивалент &lt;code&gt;list[len(list):] = [x]&lt;/code&gt;

;&lt;code&gt;list.extend(''L'')&lt;/code&gt;:Расширить список за счёт добавления всех элементов переданного списка; эквивалентно &lt;code&gt;list[len(list):] = L&lt;/code&gt;.

;&lt;code&gt;list.insert(''i'', ''x'')&lt;/code&gt;:Вставить элемент в указанную позицию. Первый аргумент — это индекс того элемента, перед которым требуется выполнить операцию вставки, поэтому вызов &lt;code&gt;list.insert(0, x)&lt;/code&gt; вставляет элемент в начало списка, а &lt;code&gt;list.insert(len(list), x)&lt;/code&gt; эквивалентно &lt;code&gt;list.append(x)&lt;/code&gt;.

;&lt;code&gt;list.remove(''x'')&lt;/code&gt;:Удалить первый найденный элемент из списка, значение которого — &lt;code&gt;x&lt;/code&gt;. Если элемент не найден, генерируется ошибка.

;&lt;code&gt;list.pop([''i''])&lt;/code&gt;:Удалить элемент, находящийся на указанной позиции в списке, и вернуть его. Если индекс не указан, &lt;code&gt;list.pop()&lt;/code&gt; удаляет и возвращает последний элемент списка. (Квадратные скобки вокруг &lt;code&gt;i&lt;/code&gt; в сигнатуре метода означают, что параметр необязателен, а не необходимость набора квадратных скобок в этой позиции. Вы часто будете встречать такую нотацию в [[Справочник по библиотеке Python 3.1|Справочнике по библиотеке]].)

;&lt;code&gt;list.index(''x'')&lt;/code&gt;:Вернуть индекс первого найденного в списке элемента, значение которого равно &lt;code&gt;x&lt;/code&gt;. Если элемент не найден, генерируется ошибка.

;&lt;code&gt;list.count(''x'')&lt;/code&gt;:Вернуть значение сколько раз, &lt;code&gt;x&lt;/code&gt; встречается в списке.

;&lt;code&gt;list.sort()&lt;/code&gt;:Сортировать элементы списка, на месте.

;&lt;code&gt;list.reverse()&lt;/code&gt;:Обратить порядок элементов списка, на месте.

Пример, использующий большинство методов списка:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = [66.25, 333, 333, 1, 1234.5]
&gt;&gt;&gt; print(a.count(333), a.count(66.25), a.count('x'))
2 1 0
&gt;&gt;&gt; a.insert(2, -1)
&gt;&gt;&gt; a.append(333)
&gt;&gt;&gt; a
[66.25, 333, -1, 333, 1, 1234.5, 333]
&gt;&gt;&gt; a.index(333)
1
&gt;&gt;&gt; a.remove(333)
&gt;&gt;&gt; a
[66.25, -1, 333, 1, 1234.5, 333]
&gt;&gt;&gt; a.reverse()
&gt;&gt;&gt; a
[333, 1234.5, 1, 333, -1, 66.25]
&gt;&gt;&gt; a.sort()
&gt;&gt;&gt; a
[-1, 1, 66.25, 333, 333, 1234.5]&lt;/syntaxhighlight&gt;

==== Использование списка в качестве стека ====

Методы списков позволяют легко использовать список в качестве стека, где последний добавленный элемент становится первым полученным («первый вошёл — последний вышел»). Чтобы положить элемент на вершину стека, используйте метод &lt;code&gt;append()&lt;/code&gt;. Для получения элемента с вершины стека — метод &lt;code&gt;pop()&lt;/code&gt; без указания явного индекса. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; stack = [3, 4, 5]
&gt;&gt;&gt; stack.append(6)
&gt;&gt;&gt; stack.append(7)
&gt;&gt;&gt; stack
[3, 4, 5, 6, 7]
&gt;&gt;&gt; stack.pop()
7
&gt;&gt;&gt; stack
[3, 4, 5, 6]
&gt;&gt;&gt; stack.pop()
6
&gt;&gt;&gt; stack.pop()
5
&gt;&gt;&gt; stack
[3, 4]&lt;/syntaxhighlight&gt;

==== Использование списка в качестве очереди ====

Вы можете без труда использовать список также и в качестве очереди, где первый добавленный элемент оказывается первым полученным («первый вошёл — первый вышел»). Чтобы добавить элемент в конец очереди, используйте метод &lt;code&gt;append()&lt;/code&gt;, а чтобы получить элемент из начала очереди — метод &lt;code&gt;pop()&lt;/code&gt; с нулём в качестве индекса. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; queue = [&quot;Eric&quot;, &quot;John&quot;, &quot;Michael&quot;]
&gt;&gt;&gt; queue.append(&quot;Terry&quot;)           # Прибыл Terry
&gt;&gt;&gt; queue.append(&quot;Graham&quot;)          # Прибыл Graham
&gt;&gt;&gt; queue.pop(0)
'Eric'
&gt;&gt;&gt; queue.pop(0)
'John'
&gt;&gt;&gt; queue
['Michael', 'Terry', 'Graham']&lt;/syntaxhighlight&gt;

==== Генераторы списков&lt;ref&gt;''(Прим. перев.)'' ''Lists Comprehensions'', comprehension — включение, вложение, добавление (понимание, охват, интенция).&lt;/ref&gt; ====

Использование метода списковой сборки — легкий способ создать список на основе последовательности. В большинстве случаев он применяется для создания списков, в которых каждый элемент является результатом некой операции, произведённой над каждым членом последовательности, или для создания выборок из тех элементов, которые удовлетворяют определённому условию.

Любая списковая сборка состоит из выражения, за которым следует оператор &lt;code&gt;for&lt;/code&gt;, а затем ноль или более операторов &lt;code&gt;for&lt;/code&gt; или &lt;code&gt;if&lt;/code&gt;. Результатом станет список, получившийся через вычисление выражения в контексте следующих за ним операторов &lt;code&gt;for&lt;/code&gt; и/или &lt;code&gt;if&lt;/code&gt;. Если в результате вычисления выражения строится кортеж, его нужно явно обернуть в скобки.

В следующем примере на основе списка чисел создаётся список, где каждое число утроено:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; vec = [2, 4, 6]
&gt;&gt;&gt; [3*x for x in vec]
[6, 12, 18]&lt;/syntaxhighlight&gt;

Применим фантазию:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; [[x, x**2] for x in vec]
[[2, 4], [4, 16], [6, 36]]&lt;/syntaxhighlight&gt;

Здесь мы вызываем метод по очереди с каждым элементом последовательности:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; freshfruit = ['  banana', '  loganberry ', 'passion fruit  ']
&gt;&gt;&gt; [weapon.strip() for weapon in freshfruit]
['banana', 'loganberry', 'passion fruit']&lt;/syntaxhighlight&gt;

Используя оператор &lt;code&gt;if&lt;/code&gt;, мы можем отфильтровать поток:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; [3*x for x in vec if x &gt; 3]
[12, 18]
&gt;&gt;&gt; [3*x for x in vec if x &lt; 2]
[]&lt;/syntaxhighlight&gt;

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

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; [x, x**2 for x in vec]   # ошибка - для кортежей необходимы скобки
File &quot;&lt;stdin&gt;&quot;, line 1, in ?
 [x, x**2 for x in vec]
           ^
SyntaxError: invalid syntax
&gt;&gt;&gt; [(x, x**2) for x in vec]
[(2, 4), (4, 16), (6, 36)]&lt;/syntaxhighlight&gt;

Вот несколько вложенных циклов &lt;code&gt;for&lt;/code&gt; и ещё кое-какое забавное поведение:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; vec1 = [2, 4, 6]
&gt;&gt;&gt; vec2 = [4, 3, -9]
&gt;&gt;&gt; [x*y for x in vec1 for y in vec2]
[8, 6, -18, 16, 12, -36, 24, 18, -54]
&gt;&gt;&gt; [x+y for x in vec1 for y in vec2]
[6, 5, -7, 8, 7, -5, 10, 9, -3]
&gt;&gt;&gt; [vec1[i]*vec2[i] for i in range(len(vec1))]
[8, 12, -54]&lt;/syntaxhighlight&gt;

Списковые сборки могут применяться в сложных выражениях и вложенных функциях&lt;ref&gt;''(Прим. перев.)'' в Python, как и в большинстве других языков программирования, используется европейский стандарт разделения целой и дробной части десятичных дробей точкой.&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; [str(round(355/113, i)) for i in range(1, 6)]
['3.1', '3.14', '3.142', '3.1416', '3.14159']&lt;/syntaxhighlight&gt;

==== Вложенные списковые сборки ====

Если вы в состоянии это переварить: списковые сборки могут быть вложенными. Но как любой мощный инструмент, их следует использовать с осторожностью.

Представьте нижеследующий пример матрицы 3x3 в виде списка, содержащего три других списка, по одному в ряд:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; mat = [
...        [1, 2, 3],
...        [4, 5, 6],
...        [7, 8, 9],
...       ]&lt;/syntaxhighlight&gt;

Чтобы поменять строки и столбцы местами, можно использовать такую списковую сборку:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print([[row[i] for row in mat] for i in [0, 1, 2]])
[[1, 4, 7], [2, 5, 8], [3, 6, 9]]&lt;/syntaxhighlight&gt;

Применяя вложенные списковые сборки, необходимо помнить о важной вещи:

: Во избежание недоразумений при конструировании вложенных списковых сборок, читайте их справа налево.

Более многословная, с использованием операторов, версия примера может служить иллюстрацией:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;for i in [0, 1, 2]:
    for row in mat:
        print(row[i], end=&quot;&quot;)
    print()&lt;/syntaxhighlight&gt;

В реальных случаях лучше использовать встроенные функции вместо сложных выражений. В нашем случае поможет функция &lt;code&gt;zip()&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; list(zip(*mat))
[(1, 4, 7), (2, 5, 8), (3, 6, 9)]&lt;/syntaxhighlight&gt;

В разделе [[Учебник Python 3.1#Распаковка списков параметров|Распаковка списков параметров]] описано предназначение звёздочки в этих строках.

Другой пример использования вложенных списковых сборок — произведение матрицы a на матрицу b:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;c=[[sum(x*y for x,y in zip(i,j)) for j in zip(*b)] for i in a]&lt;/syntaxhighlight&gt;

Это можно сделать эффективнее и прозрачнее, но на данном примере видна мощь инструмента.

Получение единичной матрицы порядка n:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;a=[[0]*i+[1]+[0]*(n-i-1) for i in range(n)]&lt;/syntaxhighlight&gt;

=== Оператор &lt;code&gt;del&lt;/code&gt; ===

Существует способ удалить элемент, указывая его индекс, а не его значение: оператор &lt;code&gt;del&lt;/code&gt;. В отличие от метода &lt;code&gt;pop()&lt;/code&gt;, он не возвращает значения. Оператор &lt;code&gt;del&lt;/code&gt; может также использоваться для удаления срезов из списка или полной очистки списка (что мы делали ранее через присваивание пустого списка срезу). Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = [-1, 1, 66.25, 333, 333, 1234.5]
&gt;&gt;&gt; del a[0]
&gt;&gt;&gt; a
[1, 66.25, 333, 333, 1234.5]
&gt;&gt;&gt; del a[2:4]
&gt;&gt;&gt; a
[1, 66.25, 1234.5]
&gt;&gt;&gt; del a[:]
&gt;&gt;&gt; a
[]&lt;/syntaxhighlight&gt;

&lt;code&gt;del&lt;/code&gt; может быть также использован для удаления переменных полностью:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; del a&lt;/syntaxhighlight&gt;

Ссылка на имя &lt;code&gt;a&lt;/code&gt; в дальнейшем вызовет ошибку (по крайней мере до тех пор, пока с ним не будет связано другое значение). Позже мы с вами узнаем другие способы использования &lt;code&gt;del&lt;/code&gt;.

=== Кортежи и последовательности ===

Мы видели, что списки и строки поддерживают много привычных свойств, таких как индексирование и операция получения срезов. Существует два подвида типов данных ''последовательность'' (&lt;tt&gt;sequence&lt;/tt&gt;) (см. [[Справочник по библиотеке Python 3.1#Последовательности|Справочник по библиотеке — Последовательности]]), и поскольку Python — развивающийся язык, со временем могут быть добавлены другие последовательные типы данных. Итак, существует также и другой, достойный рассмотрения, стандартный последовательный тип данных: ''кортеж'' (&lt;tt&gt;tuple&lt;/tt&gt;).

Кортеж состоит из некоторого числа значений разделённых запятыми, например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; t = 12345, 54321, 'hello!'
&gt;&gt;&gt; t[0]
12345
&gt;&gt;&gt; t
(12345, 54321, 'hello!')
&gt;&gt;&gt; # Кортежи могут быть вложенными:
... u = t, (1, 2, 3, 4, 5)
&gt;&gt;&gt; u
((12345, 54321, 'hello!'), (1, 2, 3, 4, 5))&lt;/syntaxhighlight&gt;

Как видите, кортежи на выводе всегда заключены в скобки, таким образом вложенные кортежи интерпретируются корректно; они могут быть введены и с обрамляющими скобками и без, тем не менее в любом случае скобки чаще всего необходимы (если кортеж — часть более крупного выражения).

Кортежи можно использовать в различных целях. Например: &lt;code&gt;(x, y)&lt;/code&gt; пары координат, записи о рабочих из базы данных, и так далее. Кортежи, как и строки, неизменяемы: невозможно присвоить что-либо индивидуальным элементам кортежа (однако, вы можете симулировать большинство схожих эффектов за счёт операций срезов и конкатенации). Также можно создать кортежи, содержащие изменяемые объекты, такие как списки.

Определённая проблема состоит в конструировании кортежей, состоящих из нуля или одного элемента: в синтаксисе языка есть дополнительные хитрости, позволяющие достигнуть этого. Пустые кортежи формируются за счёт пустой пары скобок; кортеж с одним элементом конструируется за счёт запятой, следующей за первым и единственным значением (его не обязательно заключать в скобки). Необычно, но эффективно. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; empty = ()
&gt;&gt;&gt; singleton = 'hello',    # &lt;-- обратите внимание на замыкающую запятую
&gt;&gt;&gt; len(empty)
0
&gt;&gt;&gt; len(singleton)
1
&gt;&gt;&gt; singleton
('hello',)&lt;/syntaxhighlight&gt;

Выражение &lt;code&gt;t = 12345, 54321, 'hello!'&lt;/code&gt; является примером ''упаковки кортежей'' (&lt;tt&gt;tuple packing&lt;/tt&gt;): значения &lt;code&gt;12345&lt;/code&gt;, &lt;code&gt;54321&lt;/code&gt; и &lt;code&gt;'hello!'&lt;/code&gt; упаковываются в кортеж вместе. Обратная операция также возможна:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; x, y, z = t&lt;/syntaxhighlight&gt;

Такое действие называется, довольно удачно, ''распаковкой последовательности'' (&lt;tt&gt;sequence unpacking&lt;/tt&gt;). Для распаковки на левой стороне требуется список переменных с количеством элементов равным длине последовательности. Обратите внимание, что множественное присваивание на самом деле является лишь комбинацией упаковки кортежа и распаковки последовательности.

Здесь есть некоторая асимметрия: упаковка нескольких значений всегда создаёт кортеж, а распаковка работает для любой последовательности.

=== Множества ===

Python имеет также тип данных ''множество'' (&lt;tt&gt;set&lt;/tt&gt;). Множество — это неупорядоченная коллекция без дублирующихся элементов. Основные способы использования — проверка на вхождение и устранение дублирующихся элементов. Объекты этого типа поддерживают обычные математические операции над множествами, такие как объединение, пересечение, разность и симметрическая разность.

Для создания множеств могут быть использованы фигурные скобки или функция &lt;tt&gt;set()&lt;/tt&gt;. ''Заметьте:'' Для создания пустого множества нужно использовать &lt;code&gt;set()&lt;/code&gt;, а не &lt;code&gt;{}&lt;/code&gt;: в последнем случае создаётся пустой ''словарь'' (&lt;tt&gt;dictionary&lt;/tt&gt;) — тип данных, который мы обсудим в следующем разделе.

Продемонстрируем работу с множествами на небольшом примере&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;&gt;&gt;&gt; корзина = {'яблоко', 'апельсин', 'яблоко', 'груша', 'апельсин', 'банан'}&lt;br/&gt;
&gt;&gt;&gt; ''вывести''(корзина)&lt;br/&gt;
{'апельсин', 'банан', 'яблоко', 'груша'}&lt;br/&gt;
&gt;&gt;&gt; список_фруктов = ['яблоко', 'апельсин', 'яблоко', 'груша', 'апельсин', 'банан']&lt;br/&gt;
&gt;&gt;&gt; фрукты = ''множество''(список_фруктов)&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;# создать множество на основе данных из списка (заметьте исчезновение дубликатов -перев.)&lt;br/&gt;
&gt;&gt;&gt; фрукты&lt;br/&gt;
{'апельсин', 'груша', 'яблоко', 'банан'}&lt;br/&gt;
&gt;&gt;&gt; фрукты = {'апельсин', 'яблоко'}&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;# синтаксис {} эквивалентен [] у списков&lt;br/&gt;
 &gt;&gt;&gt; фрукты&lt;br/&gt;
 {'апельсин', 'яблоко'}&lt;br/&gt;
&gt;&gt;&gt; 'апельсин' '''среди''' фрукты&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;# быстрая проверка вхождения&lt;br/&gt;
Истина&lt;br/&gt;
&gt;&gt;&gt; 'росичка' '''среди''' фрукты&lt;br/&gt;
Ложь&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; basket = {'apple', 'orange', 'apple', 'pear', 'orange', 'banana'}
&gt;&gt;&gt; print(basket)
{'orange', 'banana', 'pear', 'apple'}
&gt;&gt;&gt; fruit_list = ['apple', 'orange', 'apple', 'pear', 'orange', 'banana']
&gt;&gt;&gt; fruit = set(fruit_list)               # создать множество на основе данных из списка (заметьте исчезновение дубликатов -перев.)
&gt;&gt;&gt; fruit
{'orange', 'pear', 'apple', 'banana'}
&gt;&gt;&gt; fruit = {'orange', 'apple'}       # синтаксис {} эквивалентен [] у списков
&gt;&gt;&gt; fruit
{'orange', 'apple'}
&gt;&gt;&gt; 'orange' in fruit                 # быстрая проверка на вхождение
True
&gt;&gt;&gt; 'crabgrass' in fruit
False&lt;/syntaxhighlight&gt;

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # Демонстрация операций со множествами на примере букв из двух слов
...
&gt;&gt;&gt; a = set('abracadabra')
&gt;&gt;&gt; b = set('alacazam')
&gt;&gt;&gt; a                                  # уникальные буквы в a
{'a', 'r', 'b', 'c', 'd'}
&gt;&gt;&gt; a - b                              # буквы в a но не в b
{'r', 'd', 'b'}
&gt;&gt;&gt; a | b                              # все буквы, которые встречаются в a или в b
{'a', 'c', 'r', 'd', 'b', 'm', 'z', 'l'}
&gt;&gt;&gt; a &amp; b                              # буквы, которые есть и в a и в b
{'a', 'c'}
&gt;&gt;&gt; a ^ b                              # буквы в a или в b, но не в обоих
{'r', 'd', 'b', 'm', 'z', 'l'}&lt;/syntaxhighlight&gt;

Как и у списков, у множеств существует синтаксис сборок:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = {x for x in 'abracadabra' if x not in 'abc'}
&gt;&gt;&gt; a
{'r', 'd'}&lt;/syntaxhighlight&gt;

=== Словари ===

Другой полезный встроенный в Python тип данных — это ''словарь'' (&lt;tt&gt;dictionary&lt;/tt&gt;) (см. [[Справочник по библиотеке Python 3.1#Связывающие типы|Справочник по библиотеке — Связывающие типы]]). Словари иногда встречаются в других языках в виде «ассоциативных записей» или «ассоциативных массивов». В отличие от последовательностей, которые индексируются по диапазону чисел, словари индексируются по ''ключам'' (&lt;tt&gt;keys&lt;/tt&gt;), которые, в свою очередь, могут быть любого неизменяемого типа; строки и числа всегда могут быть ключами. Кортежи могут быть ключами только если они составлены из строк, чисел или кортежей; если кортеж содержит какой-либо изменяемый объект, явно или неявно, то он не может быть использован в качестве ключа. Вы не можете использовать списки в роли ключей, поскольку списки могут быть изменены на месте присваиванием по индексу, присваиванием по срезу или такими методами как &lt;code&gt;append()&lt;/code&gt; и &lt;code&gt;extend()&lt;/code&gt;.

Лучше всего воспринимать словарь как неупорядоченный набор пар ''ключ: значение'' с требованием, чтобы ключи были уникальны (в пределах одного словаря). Пара скобок создает пустой словарь: &lt;code&gt;{}&lt;/code&gt;. Указывая разделённый запятыми список пар ''ключ: значение'' внутри скобок, вы задаёте содержимое словаря; в таком же формате словарь можно вывести.

Главные операции над словарём — это сохранение значения с каким-либо ключом и извлечение значения по указанному ключу. Также возможно удалить пару ''ключ: значение'' используя оператор &lt;code&gt;del&lt;/code&gt;. Если вы сохраняете значение используя ключ, который уже встречается в словаре — старое значение, ассоциированное с этим ключом, стирается. Извлечение значения по несуществующему ключу вызывает ошибку.

Выполнение конструкции &lt;code&gt;list(d.keys())&lt;/code&gt; с объектом словаря возвращает список всех ключей, использующихся в словаре, в случайном порядке (если вы хотите отсортировать его, к списку ключей можно применить функцию &lt;code&gt;sorted()&lt;/code&gt;). Чтобы проверить, содержит ли словарь определённый ключ, используйте ключевое слово &lt;code&gt;in&lt;/code&gt;.

Вот небольшой пример использования словарей:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; tel = {'jack': 4098, 'sape': 4139}
&gt;&gt;&gt; tel['guido'] = 4127
&gt;&gt;&gt; tel
{'sape': 4139, 'guido': 4127, 'jack': 4098}
&gt;&gt;&gt; tel['jack']
4098
&gt;&gt;&gt; del tel['sape']
&gt;&gt;&gt; tel['irv'] = 4127
&gt;&gt;&gt; tel
{'guido': 4127, 'irv': 4127, 'jack': 4098}
&gt;&gt;&gt; list(tel.keys())
['irv', 'guido', 'jack']
&gt;&gt;&gt; sorted(tel.keys())
['guido', 'irv', 'jack']
&gt;&gt;&gt; 'guido' in tel
True
&gt;&gt;&gt; 'jack' not in tel
False&lt;/syntaxhighlight&gt;

Конструктор &lt;code&gt;dict()&lt;/code&gt; строит словарь непосредственно на основе пар ключей и значений, где каждая пара представлена в виде кортежа. Когда пары могут быть сформированы шаблоном, ''списковые сборки'' помогут описать список пар более компактно.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; dict([('sape', 4139), ('guido', 4127), ('jack', 4098)])
{'sape': 4139, 'jack': 4098, 'guido': 4127}&lt;/syntaxhighlight&gt;

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

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; {x: x**2 for x in (2, 4, 6)}
{2: 4, 4: 16, 6: 36}&lt;/syntaxhighlight&gt;

Позже в учебнике мы изучим выражения-генераторы (&lt;tt&gt;Generator Expressions&lt;/tt&gt;), которые даже лучше подходят для снабжения конструктора &lt;code&gt;dict()&lt;/code&gt; парами ключ-значение.

Если ключи являются простыми строками, иногда легче описать пары используя именованные параметры:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; dict(sape=4139, guido=4127, jack=4098)
{'sape': 4139, 'jack': 4098, 'guido': 4127}&lt;/syntaxhighlight&gt;

=== Организация циклов ===

При организации перебора элементов из словаря ключ и соответствующее ему значение могут быть получены одновременно посредством метода &lt;code&gt;items()&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; knights = {'gallahad': 'the pure', 'robin': 'the brave'}
&gt;&gt;&gt; for k, v in knights.items():
...     print(k, v)
...
gallahad the pure
robin the brave&lt;/syntaxhighlight&gt;

Функция &lt;code&gt;enumerate()&lt;/code&gt; поможет пронумеровать элементы перебираемой в цикле последовательности:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for i, v in enumerate(['tic', 'tac', 'toe']):
...     print(i, v)
...
0 tic
1 tac
2 toe&lt;/syntaxhighlight&gt;

Для того, чтобы организовать цикл параллельно для двух или более последовательностей, элементы можно предварительно сгруппировать функцией &lt;code&gt;zip()&lt;/code&gt;&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;&gt;&gt;&gt; вопросы = ['имя', 'задание', 'любимый цвет']&lt;br/&gt;
&gt;&gt;&gt; ответы = ['ланцелот', 'святой грааль', 'синий']&lt;br/&gt;
&gt;&gt;&gt; '''для''' вопрос, ответ '''из''' ''застегнуть''(вопросы, ответы):&lt;br/&gt;
... &amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''('Каков(о) ваш(е) {0}?  {1}.'.форматировать(вопрос, ответ))&lt;br/&gt;
...&lt;br/&gt;
Каков(о) ваш(е) имя?  ланцелот.&lt;br/&gt;
Каков(о) ваш(е) задание?  святой грааль.&lt;br/&gt;
Каков(о) ваш(е) любимый цвет?  синий.&lt;/code&gt;&lt;/ref&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; questions = ['name', 'quest', 'favorite color']
&gt;&gt;&gt; answers = ['lancelot', 'the holy grail', 'blue']
&gt;&gt;&gt; for q, a in zip(questions, answers):
...     print('What is your {0}?  It is {1}.'.format(q, a))
...
What is your name?  It is lancelot.
What is your quest?  It is the holy grail.
What is your favorite color?  It is blue.&lt;/syntaxhighlight&gt;

Изменить порядок следования последовательности на обратный поможет функция &lt;code&gt;reversed()&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for i in reversed(range(1, 10, 2)):
...     print(i)
...
9
7
5
3
1&lt;/syntaxhighlight&gt;

Для организации цикла по отсортированной последовательности можно применить функцию &lt;code&gt;sorted()&lt;/code&gt;, которая возвращает отсортированный список, оставляя исходный без изменений.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; basket = ['apple', 'orange', 'apple', 'pear', 'orange', 'banana']
&gt;&gt;&gt; for f in sorted(set(basket)):
...     print(f)
...
apple
banana
orange
pear&lt;/syntaxhighlight&gt;

=== Подробнее об условиях ===

Условия в операторах &lt;code&gt;if&lt;/code&gt; и &lt;code&gt;while&lt;/code&gt; могут содержать любые операции, а не только операции сравнения.

Операции сравнения &lt;code&gt;in&lt;/code&gt; и &lt;code&gt;not in&lt;/code&gt; проверяют, встречается значение в последовательности или нет. Операции &lt;code&gt;is&lt;/code&gt; и &lt;code&gt;is not&lt;/code&gt; проверяют, не являются ли два объекта на самом деле одним и тем же (это имеет смысл лишь для изменяемых объектов, таких как списки). Все операции сравнения имеют один и тот же приоритет, меньший чем у любых операций над числами.

Сравнения можно объединять в цепочки. Например, &lt;code&gt;a &lt; b == c&lt;/code&gt; проверяет, меньше ли &lt;code&gt;a&lt;/code&gt; чем &lt;code&gt;b&lt;/code&gt; и, сверх того, равны ли &lt;code&gt;b&lt;/code&gt; и &lt;code&gt;c&lt;/code&gt;.

Сравнения могут быть скомбинированы с использованием булевых операций &lt;code&gt;and&lt;/code&gt; и &lt;code&gt;or&lt;/code&gt;, а результат сравнения (или любого другого булева выражения) можно отрицать используя &lt;code&gt;not&lt;/code&gt;. Эти операции имеют меньший приоритет, чем у операций сравнения; среди них у &lt;code&gt;not&lt;/code&gt; высший приоритет, а у &lt;code&gt;or&lt;/code&gt; — низший, поэтому &lt;code&gt;A and not B or C&lt;/code&gt; эквивалентно &lt;code&gt;(A and (not B)) or C&lt;/code&gt;. Как всегда, явно заданные скобки помогут выразить желаемый порядок выполнения операций.

Булевы операции &lt;code&gt;and&lt;/code&gt; и &lt;code&gt;or&lt;/code&gt; — это так называемые ''коротящие операции''&lt;ref&gt;''(Прим. перев.)'' ''short-circuit''{{ref-en}} — закоротить, обходить, идти обходными путями (для достижения цели), препятствовать&lt;/ref&gt; (&lt;tt&gt;short-circuit operators&lt;/tt&gt;): их операнды вычисляются слева направо и вычисление заканчивается как только результат становится определён (очевиден). Например, если &lt;code&gt;A&lt;/code&gt; и &lt;code&gt;C&lt;/code&gt; истинны, а &lt;code&gt;B&lt;/code&gt; — ложно, в условии &lt;code&gt;A and B and C&lt;/code&gt; выражение &lt;code&gt;C&lt;/code&gt; не вычисляется. Когда ''коротящая операция'' используется не в контексте логической операции, она возвращает последний элемент, который был вычислен.

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

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; string1, string2, string3 = '', 'Trondheim', 'Hammer Dance'
&gt;&gt;&gt; non_null = string1 or string2 or string3
&gt;&gt;&gt; non_null
'Trondheim'&lt;/syntaxhighlight&gt;

Заметьте, что в Python (в отличие от C) присваивание не может использоваться внутри выражений. Программисты на C могут возмутиться по этому поводу, но на самом деле это позволяет избежать ряда проблем, обычного для программ на C: указания оператора присваивания (&lt;code&gt;=&lt;/code&gt;) в выражении, вместо предполагавшегося сравнения (&lt;code&gt;==&lt;/code&gt;).

=== Сравнение последовательностей и других типов ===

Объекты последовательностей можно сравнивать с другими объектами с тем же типом последовательности. Сравнение использует лексикографический порядок: сравниваются первые два элемента, и если они различны — результат сравнения определён; если они равны, сравниваются следующие два элемента и так далее до тех пор, пока одна из последовательностей не будет исчерпана. Если сравниваемые два элемента сами являются последовательностями одного типа, лексикографическое сравнение происходит в них рекурсивно. Если все элементы обеих последовательностей оказались равны, последовательности считаются равными. Если одна последовательность оказывается стартовой последовательностью другой, более короткая последовательность считается меньшей. Лексикографическое упорядочивание строк использует порядок в таблице Unicode для индивидуальных символов. Несколько примеров сравнений между однотипными последовательностями:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;(1, 2, 3)              &lt; (1, 2, 4)
[1, 2, 3]              &lt; [1, 2, 4]
&quot;Пайтон&quot; &lt; &quot;Паскаль&quot; &lt; &quot;Си&quot; &lt; &quot;Си++&quot;
(1, 2, 3, 4)           &lt; (1, 2, 4)
(1, 2)                 &lt; (1, 2, -1)
(1, 2, 3)             == (1.0, 2.0, 3.0)
(1, 2, ('aa', 'ab'), 4)   &lt; (1, 2, ('abc', 'a'))&lt;/syntaxhighlight&gt;

Обратите внимание, что сравнение объектов различных типов операциями &lt;code&gt;&lt;&lt;/code&gt; или &lt;code&gt;&gt;&lt;/code&gt; позволено, если объекты имеют соответствующие методы сравнения. Например, смешанные числовые типы сравниваются в соответствии с их численными значениями, так что &lt;code&gt;0&lt;/code&gt; равен &lt;code&gt;0.0&lt;/code&gt; и т. д. В противном случае интерпретатор, прервав процесс сортировки, возбудит исключение &lt;code&gt;TypeError&lt;/code&gt;.

== Модули ==

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

В языке Python можно поместить требуемые определения в файл и использовать их в сценариях или в интерактивном режиме интерпретатора. Такой файл называется ''модулем'' (&lt;tt&gt;module&lt;/tt&gt;). Определения из модуля могут быть импортированы в других модулях, либо в главном модуле (собрание переменных, к которым есть доступ в сценарии, который непосредственно запускается, и в интерактивном режиме).

Модуль — это файл, содержащий определения и операторы Python. Именем файла является имя модуля с добавленным суффиксом &lt;tt&gt;.py&lt;/tt&gt;. Внутри модуля, имя модуля (в качестве строки) доступно в виде значения глобальной переменной с именем &lt;code&gt;__name__&lt;/code&gt;. Например, используя ваш любимый текстовый редактор, создайте в текущем каталоге файл с именем &lt;tt&gt;fibo.py&lt;/tt&gt; со следующим содержимым:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&quot;&quot;&quot;Модуль вычисления чисел Фибоначчи&quot;&quot;&quot;

def fib(n):    # вывести числа Фибоначчи вплоть до n
    a, b = 0, 1
    while b &lt; n:
        print(b, end=' ')
        a, b = b, a+b
    print()

def fib2(n): # вернуть числа Фибоначчи вплоть до n
    result = []
    a, b = 0, 1
    while b &lt; n:
        result.append(b)
        a, b = b, a+b
    return result&lt;/syntaxhighlight&gt;

Теперь можно войти в интерпретатор Python и импортировать этот модуль следующей командой:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import fibo&lt;/syntaxhighlight&gt;

Это действие не переводит имена определённых в модуле функций в текущую таблицу символов, а лишь имя модуля &lt;code&gt;fibo&lt;/code&gt;. Используя имя модуля, вы можете получить доступ к функциям:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; fibo.fib(1000)
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987
&gt;&gt;&gt; fibo.fib2(100)
[1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]
&gt;&gt;&gt; fibo.__name__
'fibo'&lt;/syntaxhighlight&gt;

Если вы собираетесь использовать функцию часто, можно присвоить её локальному имени:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; fib = fibo.fib
&gt;&gt;&gt; fib(500)
1 1 2 3 5 8 13 21 34 55 89 144 233 377&lt;/syntaxhighlight&gt;

=== Подробнее о модулях ===

Помимо определений функций модуль может содержать исполняемые операторы. Назначение этих операторов — инициализация модуля: они выполняются при первом импортировании модуля где-либо&lt;ref&gt;Фактически, определения функций — те же «исполняемые» «операторы». Выполнение помещает имя функции в ''глобальную таблицу символов''.&lt;/ref&gt;.

Каждый модуль имеет свою собственную ''таблицу символов'', которая используется в качестве глобальной всеми определёнными в модуле функциями. Таким образом, автор модуля может использовать глобальные символы в модуле, не опасаясь неожиданных совпадений с глобальными переменными пользователя. С другой стороны, если вы знаете, что делаете, можно сослаться на глобальные переменные модуля, пользуясь той же нотацией, которая применялась для ссылок на его функции: &lt;tt&gt;''&amp;lt;имя_модуля&gt;''.''&amp;lt;имя_элемента&gt;''&lt;/tt&gt;.

Модули могут импортировать другие модули. Не требуется указывать все операторы &lt;code&gt;import&lt;/code&gt; в начале модуля (или сценария, с той же целью), но обычно так и делается. Имена из импортированного модуля добавляются в ''глобальную таблицу символов'' модуля его импортирующего.

Есть вариант оператора &lt;code&gt;import&lt;/code&gt;, который переносит имена из модуля прямо в таблицу символов импортирующего модуля. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from fibo import fib, fib2
&gt;&gt;&gt; fib(500)
1 1 2 3 5 8 13 21 34 55 89 144 233 377&lt;/syntaxhighlight&gt;

При этом имя самого модуля, из которого переносятся имена элементов, не добавляется в ''локальную таблицу символов'' (так, в этом примере, имя &lt;code&gt;fibo&lt;/code&gt; не определено)

И есть даже способ импортировать все имена, которые определяет данный модуль:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from fibo import *
&gt;&gt;&gt; fib(500)
1 1 2 3 5 8 13 21 34 55 89 144 233 377&lt;/syntaxhighlight&gt;

Импортируются все имена, кроме тех, которые начинаются на подчёркивание (&lt;code&gt;_&lt;/code&gt;). В большинстве случаев программисты на Python не используют эту возможность, поскольку она внедряет в интерпретатор целый набор новых неизвестных имён и может скрыть некоторые объекты, которые вы уже определили.

{{Info2|Для повышения эффективности, каждый модуль импортируется лишь единожды за сеанс работы с интерпретатором. Поэтому, если вы изменили ваши модули, вам придётся перезапустить интерпретатор. Или, если вам нужно перезагрузить конкретный модуль, можно использовать &lt;code&gt;imp.reload()&lt;/code&gt; таким образом: &lt;code&gt;import imp; imp.reload(&lt;имя_модуля&gt;)&lt;/code&gt;}}

==== Выполнение модулей в качестве сценариев ====

Когда вы запускаете модуль Python в виде

&lt;syntaxhighlight lang=&quot;python&quot;&gt;python fibo.py &lt;параметры&gt;&lt;/syntaxhighlight&gt;

то код в этом модуле будет исполнен в момент его импортирования, но значением &lt;code&gt;__name__&lt;/code&gt; будет строка &lt;code&gt;&quot;__main__&quot;&lt;/code&gt;. Это значит, что добавляя следующий код в конец сценария:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;if __name__ == &quot;__main__&quot;:
    import sys
    fib(int(sys.argv[1]))&lt;/syntaxhighlight&gt;

вы можете сделать возможным запуск файла и в качестве сценария, и в качестве импортируемого модуля. Это возможно, поскольку разбирающий командную строку код выполняется только при исполнении модуля как ''основного'' (&lt;tt&gt;main&lt;/tt&gt;) файла:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;$ python fibo.py 50
1 1 2 3 5 8 13 21 34&lt;/syntaxhighlight&gt;

Если модуль импортируется, код не будет выполнен:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import fibo
&gt;&gt;&gt;&lt;/syntaxhighlight&gt;

Такой приём часто используется, чтобы предоставить удобный пользовательский интерфейс к модулю или для тестирования (выполнение модуля в качестве сценария запускает набор тестов).

==== Путь поиска модулей ====

Если импортируется модуль с именем &lt;code&gt;spam&lt;/code&gt;, интерпретатор ищет файл с именем &lt;tt&gt;spam.py&lt;/tt&gt; в текущем каталоге, а затем в каталогах, указанных в переменной окружения &lt;code&gt;PYTHONPATH&lt;/code&gt;. У неё такой же синтаксис, как и у переменной шелла &lt;code&gt;PATH&lt;/code&gt;, которая, в свою очередь, является перечислением каталогов. Когда переменная &lt;code&gt;PYTHONPATH&lt;/code&gt; не установлена, или файл не найден в описанных в ней местах, поиск продолжается по пути по умолчанию, зависящему от указанного при установке; на Unix это обычно &lt;tt&gt;.:/usr/local/lib/python&lt;/tt&gt;.

В действительности поиск модулей производится в списке каталогов в переменной &lt;code&gt;sys.path&lt;/code&gt;, которая обычно содержит: каталог, в котором находится сценарий на входе (или текущий каталог), &lt;code&gt;PYTHONPATH&lt;/code&gt; и умолчанием для каталога, указанного при установке. Это позволяет программам на Python (если программист знает, что делает) изменять или подменять путь поиска модулей. Заметьте: поскольку каталог, содержащий запускаемый вами сценарий, также находится в пути поиска, важно, чтобы в нем не было сценариев с именем стандартного модуля. Иначе, когда этот модуль будет импортироваться, Python будет пытаться загрузить в виде модуля сам сценарий, что в большинстве случаев вызовет ошибку. Для более подробной информации обратитесь к разделу [[Учебник Python 3.1#Стандартные модули|Стандартные модули]].

==== «Скомпилированные» файлы Python ====

Интерпретатор Python применяет один важный приём для ускорения запуска программы: если в каталоге, где располагается файл с некоторым модулем &lt;tt&gt;spam.py&lt;/tt&gt;, находится также файл &lt;tt&gt;spam.pyc&lt;/tt&gt;, предполагается, что это уже скомпилированная в байт-код («&lt;tt&gt;byte-compiled&lt;/tt&gt;») версия модуля &lt;code&gt;spam&lt;/code&gt;. В файле &lt;tt&gt;spam.pyc&lt;/tt&gt; зафиксировано время изменения файла &lt;tt&gt;spam.py&lt;/tt&gt; версии, использовавшейся для создания &lt;tt&gt;spam.pyc&lt;/tt&gt;. Если версии не совпадают — файл &lt;tt&gt;.pyc&lt;/tt&gt; игнорируется.

В обычном случае, вам не нужно ничего делать для создания файла &lt;tt&gt;spam.pyc&lt;/tt&gt;. Каждый раз, когда &lt;tt&gt;spam.py&lt;/tt&gt; успешно компилируется, предпринимается попытка записать скомпилированную версию в &lt;tt&gt;spam.pyc&lt;/tt&gt;. Не считается ошибкой, если попытка неудачна: если по какой-либо причине файл не записан полностью, результирующий файл &lt;tt&gt;spam.pyc&lt;/tt&gt; будет считаться некорректным и по этой причине в дальнейшем игнорироваться. Содержимое файла &lt;tt&gt;spam.pyc&lt;/tt&gt; платформо-независимо, благодаря чему каталог модулей Python может использоваться параллельно машинами с различной архитектурой.

Несколько советов экспертам:

* Когда интерпретатор Python запускается с флагом &lt;tt&gt;'''-O'''&lt;/tt&gt;, в файлах &lt;tt&gt;.pyo&lt;/tt&gt; сохраняется сгенерированный оптимизированный код. На данный момент оптимизатор помогает не сильно — он лишь удаляет операторы &lt;code&gt;assert&lt;/code&gt;. В случае использования &lt;tt&gt;'''-O'''&lt;/tt&gt; оптимизируется весь ''байт-код'' (&lt;tt&gt;bytecode&lt;/tt&gt;); файлы &lt;tt&gt;.pyc&lt;/tt&gt; игнорируются, а файлы &lt;tt&gt;.py&lt;/tt&gt; компилируются в оптимизированный байт-код.

* Передача двух флагов &lt;tt&gt;'''-O'''&lt;/tt&gt; интерпретатору Python (&lt;tt&gt;'''-OO'''&lt;/tt&gt;) принуждает компилятор байт-кода выполнять оптимизации, в редких случаях результат выполнения которых оказывается некачественно функционирующей программой. На данный момент из байт-кода удаляются только строки &lt;code&gt;__doc__&lt;/code&gt;, в результате получаются более компактные файлы &lt;tt&gt;.pyo&lt;/tt&gt;. Поскольку некоторые программы могут рассчитывать на их (строк) доступность, следует использовать эту возможность только в том случае, если вы знаете что делаете.

* Программа сама по себе не работает хоть сколь-нибудь быстрее, будучи прочитанной из файла &lt;tt&gt;.pyc&lt;/tt&gt; или &lt;tt&gt;.pyo&lt;/tt&gt;, чем если бы она была прочитана из файла &lt;tt&gt;.py&lt;/tt&gt;. Единственный процесс, оказывающийся более быстрым при использовании файлов &lt;tt&gt;.pyc&lt;/tt&gt; или &lt;tt&gt;.pyo&lt;/tt&gt; — это скорость их подгрузки.

* Если сценарий запущен из командной строки, его байт-код никогда не будет записан в файл &lt;tt&gt;.pyc&lt;/tt&gt; или &lt;tt&gt;.pyo&lt;/tt&gt;. Таким образом, время запуска сценария может быть уменьшено за счёт перемещения большей части его кода в модули или использования небольшого загрузочного сценария, импортирующего этот модуль. Кроме того, можно указывать файл &lt;tt&gt;.pyc&lt;/tt&gt; или &lt;tt&gt;.pyo&lt;/tt&gt; прямо в командной строке.

* Можно иметь в наличии файл с именем &lt;tt&gt;spam.pyc&lt;/tt&gt; (или &lt;tt&gt;spam.pyo&lt;/tt&gt;, когда используется &lt;tt&gt;'''-O'''&lt;/tt&gt;), не имея файла &lt;tt&gt;spam.py&lt;/tt&gt; для того же модуля. Таким образом можно распространять библиотеки кода Python в том виде, из которого трудно восстановить исходный код.

* Модуль &lt;tt&gt;[[Справочник по библиотеке Python 3.1#compileall|compileall]]&lt;/tt&gt; может создать файлы &lt;tt&gt;.pyc&lt;/tt&gt; (или файлы &lt;tt&gt;.pyo&lt;/tt&gt;, когда используется &lt;tt&gt;'''-O'''&lt;/tt&gt;) для всех модулей в каталоге.

=== Стандартные модули ===

Python поставляется с библиотекой стандартных модулей, описанной в отдельном документе, [[Справочник по библиотеке Python 3.1|Справочнике по библиотеке Python]] (далее — «Справочнику по библиотеке»). Некоторые модули встроены в интерпретатор. Они обеспечивают доступ к операциям, не входящим в ядро языка, и встроены для большей эффективности и предоставления доступа к основным средствам операционной системы, таким как ''системные вызовы'' (&lt;tt&gt;system calls&lt;/tt&gt;). Набор таких модулей — выбор настройки, зависимый от используемой платформы. Например, модуль &lt;code&gt;winreg&lt;/code&gt; предоставляется только на системах с Windows. Один конкретный модуль заслуживает большего внимания: модуль &lt;tt&gt;[[Справочник по библиотеке Python 3.1#sys|sys]]&lt;/tt&gt;, встроенный в каждую версию интерпретатора Python. Переменные &lt;code&gt;sys.ps1&lt;/code&gt; и &lt;code&gt;sys.ps2&lt;/code&gt; определяют строки, использующиеся в качестве основного и вспомогательного приглашений:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import sys
&gt;&gt;&gt; sys.ps1
'&gt;&gt;&gt; '
&gt;&gt;&gt; sys.ps2
'... '
&gt;&gt;&gt; sys.ps1 = &quot;Вводите: &quot;
Вводите: print('Ох!')
Ох!
Вводите:
&lt;/syntaxhighlight&gt;

Эти две переменные определены только для интерактивного режима интерпретатора.

Переменная &lt;code&gt;sys.path&lt;/code&gt; представляет собой список строк, определяющий путь поиска модулей интерпретатора. Она инициализируется значением пути по умолчанию, взятым из переменной окружения &lt;tt&gt;PYTHONPATH&lt;/tt&gt;, или встроенным значением по умолчанию, если &lt;tt&gt;PYTHONPATH&lt;/tt&gt; не установлен. Вы можете изменить её значение, используя стандартные операции со списками:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import sys
&gt;&gt;&gt; sys.path.append('/ufs/guido/lib/python')&lt;/syntaxhighlight&gt;

=== Функция &lt;code&gt;dir()&lt;/code&gt; ===

Встроенная функция &lt;code&gt;dir()&lt;/code&gt; используется для получения имён, определённых в модуле. Она возвращает отсортированный список строк:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import fibo, sys
&gt;&gt;&gt; dir(fibo)
['__name__', 'fib', 'fib2']
&gt;&gt;&gt; dir(sys)
['__displayhook__', '__doc__', '__excepthook__', '__name__', '__stderr__',
 '__stdin__', '__stdout__', '_getframe', 'api_version', 'argv', 
 'builtin_module_names', 'byteorder', 'callstats', 'copyright',
 'displayhook', 'exc_info', 'excepthook',
 'exec_prefix', 'executable', 'exit', 'getdefaultencoding', 'getdlopenflags',
 'getrecursionlimit', 'getrefcount', 'hexversion', 'maxint', 'maxunicode',
 'meta_path', 'modules', 'path', 'path_hooks', 'path_importer_cache',
 'platform', 'prefix', 'ps1', 'ps2', 'setcheckinterval', 'setdlopenflags',
 'setprofile', 'setrecursionlimit', 'settrace', 'stderr', 'stdin', 'stdout',
 'version', 'version_info', 'warnoptions']&lt;/syntaxhighlight&gt;

Будучи использованной без аргументов, функция &lt;code&gt;dir()&lt;/code&gt; возвращает список имён, определённых в данный момент.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = [1, 2, 3, 4, 5]
&gt;&gt;&gt; import fibo
&gt;&gt;&gt; fib = fibo.fib
&gt;&gt;&gt; dir()
['__builtins__', '__doc__', '__file__', '__name__', 'a', 'fib', 'fibo', 'sys']&lt;/syntaxhighlight&gt;

Обратите внимание, что список состоит из имён всех типов: переменных, модулей, функций и т. д.

В возвращаемом функцией &lt;code&gt;dir()&lt;/code&gt; списке не содержится встроенных функций и переменных. Если вы хотите получить ''их'' список, то они определены в стандартном модуле &lt;code&gt;builtins&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import builtins
&gt;&gt;&gt; dir(builtins)
['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException', 'Buffer
Error', 'DeprecationWarning', 'EOFError', 'Ellipsis', 'EnvironmentError', 'Excep
tion', 'False', 'FloatingPointError', 'FutureWarning', 'GeneratorExit', 'IOError
', 'ImportError', 'ImportWarning', 'IndentationError', 'IndexError', 'KeyError',
 'KeyboardInterrupt', 'LookupError', 'MemoryError', 'NameError', 'None', 'NotImp
lemented', 'NotImplementedError', 'OSError', 'OverflowError', 'PendingDeprecatio
nWarning', 'ReferenceError', 'RuntimeError', 'RuntimeWarning', 'StopIteration',
'SyntaxError', 'SyntaxWarning', 'SystemError', 'SystemExit', 'TabError', 'True',
 'TypeError', 'UnboundLocalError', 'UnicodeDecodeError', 'UnicodeEncodeError', '
UnicodeError', 'UnicodeTranslateError', 'UnicodeWarning', 'UserWarning', 'ValueE
rror', 'Warning', 'ZeroDivisionError', '__build_class__', '__debug__', '__doc__'
, '__import__', '__name__', 'abs', 'all', 'any', 'basestring', 'bin', 'bool', 'b
uffer', 'bytes', 'chr', 'chr8', 'classmethod', 'cmp', 'compile', 'complex', 'cop
yright', 'credits', 'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval', 'ex
ec', 'exit', 'filter', 'float', 'frozenset', 'getattr', 'globals', 'hasattr', 'h
ash', 'help', 'hex', 'id', 'input', 'int', 'isinstance', 'issubclass', 'iter', '
len', 'license', 'list', 'locals', 'map', 'max', 'memoryview', 'min', 'next', 'o
bject', 'oct', 'open', 'ord', 'pow', 'print', 'property', 'quit', 'range', 'repr
', 'reversed', 'round', 'set', 'setattr', 'slice', 'sorted', 'staticmethod', 'st
r', 'str8', 'sum', 'super', 'trunc', 'tuple', 'type', 'vars', 'zip']&lt;/syntaxhighlight&gt;

=== Пакеты ===

Пакеты — способ структурирования ''пространств имён'' (&lt;tt&gt;namespaces&lt;/tt&gt;) модулей Python за счёт использования имён модулей, разделённых точками («&lt;tt&gt;dotted module names&lt;/tt&gt;»). Например, имя модуля &lt;code&gt;A.B&lt;/code&gt; означает — подмодуль&lt;ref&gt;''(Прим. перев.)'' ''подмодуль'' (&lt;tt&gt;submodule&lt;/tt&gt;), ''зд.'' — модуль, находящийся в пакете. ''подпакет'' (&lt;tt&gt;subpackage&lt;/tt&gt;), ''зд.'' — пакет, расположенный в пакете.&lt;/ref&gt; с именем &lt;code&gt;B&lt;/code&gt; в пакете с именем &lt;code&gt;A&lt;/code&gt;. Так же как использование модулей позволяет авторам различных модулей не заботиться о пересекающихся именах среди глобальных переменных, использование именования через точку позволяет авторам многомодульных пакетов (таких как &lt;tt&gt;NumPy&lt;/tt&gt; или &lt;tt&gt;Python Imaging Library&lt;/tt&gt;) не заботиться о конфликтах имён модулей.

Допустим, вы собираетесь разработать набор модулей (''пакет'', &lt;tt&gt;package&lt;/tt&gt;) для унифицированной работы со звуковыми файлами и звуковыми данными. Существует множество форматов звуковых файлов (обычно их можно распознать по расширению, например: &lt;tt&gt;.wav&lt;/tt&gt;, &lt;tt&gt;.aiff&lt;/tt&gt;, &lt;tt&gt;.au&lt;/tt&gt;). Таким образом, вам может понадобиться создать и поддерживать разрастающуюся коллекцию модулей для конвертирования между различными форматами файлов. Также вам наверняка захочется иметь побольше операций для обработки звуковых данных (таких как смешивание, добавление эха, применение функции эквалайзера, создание искусственного стерео-эффекта), поэтому в дополнение к этому вы будете писать нескончаемый поток модулей для исполнения этих операций. Вот возможная структура вашего пакета (выраженная в терминологии иерархической файловой системы):

&lt;pre style=&quot;color:#00008b;&quot;&gt;sound/                          Пакет верхнего уровня
      __init__.py               Инициализация пакета работы со звуком (sound)
      formats/                  Подпакет для конвертирования форматов файлов
              __init__.py
              wavread.py        (чтение wav)
              wavwrite.py       (запись wav)
              aiffread.py       (чтение aiff)
              aiffwrite.py      (запись aiff)
              auread.py         (чтение au)
              auwrite.py        (запись au)
              ...
      effects/                  Подпакет для звуковых эффектов
              __init__.py
              echo.py           ( эхо )
              surround.py       ( окружение )
              reverse.py        ( обращение )
              ...
      filters/                  Подпакет для фильтров
              __init__.py
              equalizer.py      ( эквалайзер )
              vocoder.py        ( вокодер ) 
              karaoke.py        ( караоке )
              ...&lt;/pre&gt;

При импорте пакета Python ищет подкаталог пакета в каталогах, перечисленных в &lt;code&gt;sys.path&lt;/code&gt;.

Файлы &lt;tt&gt;__init__.py&lt;/tt&gt; необходимы для того, чтобы Python трактовал эти каталоги как содержащие пакеты. Это сделано во избежание нечаянного сокрытия правомерных модулей, встречающихся в дальнейшем по пути поиска, каталогами с часто используемыми именами, таким как «&lt;code&gt;string&lt;/code&gt;». В наипростейшем случае файл &lt;tt&gt;__init__.py&lt;/tt&gt; может быть пустым, но в более сложных может содержать код инициализации пакета или устанавливать значение описанной ниже переменной &lt;code&gt;__all__&lt;/code&gt;.

Пользователи пакета могут импортировать из него конкретные модули, например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import sound.effects.echo&lt;/syntaxhighlight&gt;

Таким образом подгружается подмодуль &lt;code&gt;sound.effects.echo&lt;/code&gt;. Ссылаться на него нужно используя его полное имя:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;sound.effects.echo.echofilter(input, output, delay=0.7, atten=4)&lt;/syntaxhighlight&gt;

Другой способ импортирования подмодуля:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;from sound.effects import echo&lt;/syntaxhighlight&gt;

Так тоже подгружается подмодуль &lt;code&gt;echo&lt;/code&gt;, но теперь он доступен без префикса пакета, поэтому может использоваться следующим образом:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;echo.echofilter(input, output, delay=0.7, atten=4)&lt;/syntaxhighlight&gt;

И еще один вариант — прямое импортирование желаемой функции или переменной:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;from sound.effects.echo import echofilter&lt;/syntaxhighlight&gt;

Опять же, таким образом подгружается подмодуль &lt;code&gt;echo&lt;/code&gt;, но теперь его функция &lt;code&gt;echofilter()&lt;/code&gt; может быть вызвана непосредственно:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;echofilter(input, output, delay=0.7, atten=4)&lt;/syntaxhighlight&gt;

Заметьте, что при использовании выражения &lt;code&gt;from ''пакет'' import ''элемент''&lt;/code&gt;, ''элементом'' может быть подмодуль (или подпакет) пакета или любое другое имя, определённое в пакете — например, функция, класс или переменная. Оператор &lt;code&gt;import&lt;/code&gt; сначала проверяет, определён ли элемент в пакете; если нет — он трактует его как модуль и пытается загрузить. Если не удается его найти, порождается исключение &lt;code&gt;ImportError&lt;/code&gt;.

Напротив, при использовании синтаксиса в стиле &lt;code&gt;import ''элемент''.''подэлемент''.''подэлемент''&lt;/code&gt;, все элементы кроме последнего должны быть пакетами; последний элемент может быть модулем или пакетом, но не может быть классом, функцией или переменной, определёнными в предыдущем элементе.

==== Импорт &lt;code&gt;*&lt;/code&gt; из пакета ====

Что происходит, когда пользователь пишет &lt;code&gt;from sound.effects import *&lt;/code&gt; ? В идеале, мы бы надеялись, что таким образом код выходит в файловую систему и находит какие подмодули существуют в пакете, импортируя их все. К сожалению, такой метод не очень хорошо работает на платформах Windows, поскольку у файловой системы не всегда есть корректная информация о регистре имён файлов. На этих платформах нет гарантированного способа узнать, нужно ли импортировать файл &lt;tt&gt;ECHO.PY&lt;/tt&gt; в качестве модуля &lt;code&gt;echo&lt;/code&gt;, &lt;code&gt;Echo&lt;/code&gt; или &lt;code&gt;ECHO&lt;/code&gt;. (Например, у Windows 95 есть назойливая привычка показывать имена всех файлов с заглавной буквы.) Ограничение DOS на имя файла в формате 8+3 добавляет забавную проблему, связанную с длинными именами модулей.

Единственный выход для автора пакета — предоставить его подробное содержание. Оператор &lt;code&gt;import&lt;/code&gt; использует следующее соглашение: если в коде файла &lt;tt&gt;__init__.py&lt;/tt&gt; текущего пакета определён список &lt;code&gt;__all__&lt;/code&gt;, то он полагается списком имён модулей, которые нужно импортировать в случае &lt;code&gt;from ''пакет'' import *&lt;/code&gt;. На совести автора поддержка этого списка в соответствующем состоянии в каждой новой версии пакета. Впрочем, авторы пакета могут его не поддерживать вообще, если не видят смысла в импортировании &lt;code&gt;*&lt;/code&gt; из их пакета. Например, файл &lt;code&gt;sounds/effects/__init__.py&lt;/code&gt; может содержать следующий код:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;__all__ = [&quot;echo&quot;, &quot;surround&quot;, &quot;reverse&quot;]&lt;/syntaxhighlight&gt;

Это будет значить, что выражение &lt;code&gt;from sound.effects import *&lt;/code&gt; импортирует три именованных подмодуля из пакета &lt;code&gt;sound&lt;/code&gt;.

Если список &lt;code&gt;__all__&lt;/code&gt; не определён, оператор &lt;code&gt;from Sound.Effects import *&lt;/code&gt; не импортирует все подмодули пакета &lt;code&gt;sound.effects&lt;/code&gt; в текущее пространство имён: он лишь убеждается, что импортирован пакет &lt;code&gt;sound.effects&lt;/code&gt; (возможно, выполняя код инициализации из &lt;tt&gt;__init__.py&lt;/tt&gt;), а затем импортирует все определённые в пакете имена. В этот список попадают любые имена, определённые (и загруженные явно подмодулями) в &lt;tt&gt;__init__.py&lt;/tt&gt;. В него также попадают все явно загруженные предшествующими операторами &lt;code&gt;import&lt;/code&gt; подмодули. Рассмотрим следующий код:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import sound.effects.echo
import sound.effects.surround
from sound.effects import *&lt;/syntaxhighlight&gt;

В этом примере модули &lt;code&gt;echo&lt;/code&gt; и &lt;code&gt;surround&lt;/code&gt; импортируются в текущее пространство имён, поскольку они определены в пакете &lt;code&gt;sound.effects&lt;/code&gt; на тот момент, когда исполняется оператор &lt;code&gt;from ... import&lt;/code&gt;. (И это также работает если определён &lt;code&gt;__all__&lt;/code&gt;.)

Обратите внимание, что в общем случае импортирование &lt;code&gt;*&lt;/code&gt; из модуля не приветствуется, поскольку в результате часто получается плохо-читаемый код. Однако, вполне нормально использовать его в интерактивных сессиях, чтобы меньше печатать, а определённые модули разработаны для экспорта только тех имён, которые следуют определённым шаблонам.

Помните: в использовании &lt;code&gt;from ''пакет'' import ''определённый_подмодуль''&lt;/code&gt; нет ничего плохого. На самом деле — это рекомендованная запись, до тех пор пока при импортировании модуля не нужно использовать подмодули с одинаковым именем из разных пакетов.

==== Ссылки внутри пакета ====

Когда пакеты структурированы в подпакеты (например, в случае пакета &lt;code&gt;sound&lt;/code&gt;), для того, чтобы сослаться на пакеты-потомки вы можете использовать абсолютное импортирование (&lt;tt&gt;absolute imports&lt;/tt&gt;). Например, если модуль &lt;code&gt;sound.filters.vocoder&lt;/code&gt; нуждается в модуле &lt;code&gt;echo&lt;/code&gt; из пакета &lt;code&gt;sound.effects&lt;/code&gt;, он должен использовать &lt;code&gt;from sound.effects import echo&lt;/code&gt;.

Вы можете также использовать ''относительное импортирование'' (&lt;tt&gt;relative imports&lt;/tt&gt;), применяя следующую форму оператора &lt;code&gt;import&lt;/code&gt;: &lt;code&gt;from ''модуль'' import ''имя''&lt;/code&gt; . При таком способе импортирования для описания текущего и родительского пакетов используется символ точки. Например, для модуля &lt;code&gt;surround&lt;/code&gt; вы можете написать:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;from . import echo
from .. import formats
from ..filters import equalizer&lt;/syntaxhighlight&gt;

Обратите внимание, что относительное импортирование основано на имени текущего модуля. Поскольку имя главного модуля всегда «&lt;code&gt;__main__&lt;/code&gt;», модули, предназначенные для использования в качестве главных модулей приложения на Python, должны всегда использовать ''абсолютное импортирование'' (&lt;tt&gt;absolute imports&lt;/tt&gt;).

==== Пакеты в нескольких каталогах ====

Пакеты поддерживают ещё один специальный аттрибут: &lt;code&gt;__path__&lt;/code&gt;. Перед исполнением файла &lt;tt&gt;__init__.py&lt;/tt&gt; этого пакета, он инициализируется списком, содержащим имя каталога, в котором этот файл находится. Изменив переменную, можно повлиять на ход поиска модулей и подпакетов, содержащихся в пакете.

Хотя эта возможность нужна не так часто, она может быть использована для расширения набора модулей, находящихся в пакете.

== Ввод и вывод ==

Ознакомить пользователя с выводом программы можно различными способами — данные могут быть выведены в читаемом виде или записаны в файл для последующего использования. Часть возможностей будет обсуждена в этой главе.

=== Удобное форматирование вывода ===

На данный момент мы выяснили два способа вывода значений: ''операторные выражения'' (&lt;tt&gt;expression statements&lt;/tt&gt;) и функция &lt;code&gt;print()&lt;/code&gt;. (Третий способ — использование метода &lt;code&gt;write()&lt;/code&gt; объектов файлов; на файл стандартного вывода можно сослаться как на &lt;code&gt;sys.stdout&lt;/code&gt;. Более подробную информацию по этому пункту смотрите в [[Справочник по библиотеке Python 3.1|Справочнике по библиотеке]].)

Часто возникает желание иметь больший контроль над форматированием вывода, чем обычная печать значений разделённых пробелами. Есть два способа форматирования вашего вывода. Первый способ — выполнять самостоятельно всю работу над строками: используя срезы строк и конкатенацию вы можете создать любой шаблон, какой пожелаете. Стандартный модуль &lt;code&gt;string&lt;/code&gt; содержит много полезных операций для выравнивания строк по определённой ширине колонки (скоро мы их кратко рассмотрим). Второй способ — использование метода &lt;code&gt;str.format()&lt;/code&gt;.

Модуль &lt;code&gt;string&lt;/code&gt; содержит класс &lt;code&gt;Template&lt;/code&gt;, который предоставляет ещё один способ подстановки значений в строки.

Остаётся, конечно, один вопрос: каким образом конвертировать значения в строки? К счастью, в Python есть два способа для преобразования любого значения в строку — это функции &lt;code&gt;repr()&lt;/code&gt; и &lt;code&gt;str()&lt;/code&gt;.

Предназначение функции &lt;code&gt;str()&lt;/code&gt; — возврат значений в довольно-таки читабельной форме; в отличие от &lt;code&gt;repr()&lt;/code&gt;, чьё назначение — генерирование форм&lt;ref&gt;(''Прим. перев.'') ''representation'' {{ref-en}} — представление, образ, форма&lt;/ref&gt;, которые могут быть прочитаны интерпретатором (или вызовут ошибку &lt;code&gt;SyntaxError&lt;/code&gt;, если эквивалентного синтаксиса не существует). Для тех объектов, у которых нет формы для человеческого прочтения функция &lt;code&gt;str()&lt;/code&gt; возвратит такое же значение, как и &lt;code&gt;repr()&lt;/code&gt;. У многих значений, таких как числа или структуры, вроде списков и словарей, одинаковая форма для обеих функций. Строки и числа с плавающей точкой, в частности, имеют по две разных формы.

Несколько примеров:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; s = 'Привет, мир.'
&gt;&gt;&gt; str(s)
'Привет, мир.'
&gt;&gt;&gt; repr(s)
&quot;'Привет, мир.'&quot;
&gt;&gt;&gt; str(0.1)
'0.1'
&gt;&gt;&gt; repr(0.1)
'0.10000000000000001'
&gt;&gt;&gt; x = 10 * 3.25
&gt;&gt;&gt; y = 200 * 200
&gt;&gt;&gt; s = 'Значение x - ' + repr(x) + ', а y - ' + repr(y) + '...'
&gt;&gt;&gt; print(s)
Значение x - 32.5, а y - 40000...
&gt;&gt;&gt; # Функция repr(), применённая к строке, добавляет кавычки и обратные слэши:
... hello = 'привет, мир\n'
&gt;&gt;&gt; hellos = repr(hello)
&gt;&gt;&gt; print(hellos)
'привет, мир\n'
&gt;&gt;&gt; # Параметром функции repr() может быть объект Python:
... repr((x, y, ('фарш', 'яйца')))
&quot;(32.5, 40000, ('фарш', 'яйца'))&quot;&lt;/syntaxhighlight&gt;

Вот два способа вывести таблицу квадратов и кубов:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for x in range(1, 11):
...     print(repr(x).rjust(2), repr(x*x).rjust(3), end=' ')
...     # Обратите внимание на использование end в предыдущей строке
...     print(repr(x*x*x).rjust(4))
...
 1   1    1
 2   4    8
 3   9   27
 4  16   64
 5  25  125
 6  36  216
 7  49  343
 8  64  512
 9  81  729
10 100 1000

&gt;&gt;&gt; for x in range(1, 11):
...     print('{0:2d} {1:3d} {2:4d}'.format(x, x*x, x*x*x))
... 
 1   1    1
 2   4    8
 3   9   27
 4  16   64
 5  25  125
 6  36  216
 7  49  343
 8  64  512
 9  81  729
10 100 1000&lt;/syntaxhighlight&gt;

(Обратите внимание, что в первом примере единичные пробелы между колонками добавлены функцией &lt;code&gt;print()&lt;/code&gt;: она всегда вставляет пробелы между своими параметрами)

Этот пример демонстрирует работу метода строковых объектов &lt;code&gt;rjust()&lt;/code&gt;, выравнивающего строку по правому краю в поле переданной ширины, отступая пробелами слева. Имеются также похожие методы &lt;code&gt;ljust()&lt;/code&gt; и &lt;code&gt;center()&lt;/code&gt;. Эти методы не выводят ничего, они лишь возвращают новую строку. Если строка на входе чересчур длинная, то они не усекают её, что обычно является меньшим из зол. (Для усечения можно добавить операцию среза, например: &lt;code&gt;x.ljust(n)[:n]&lt;/code&gt;.)

Есть другой метод — &lt;code&gt;zfill()&lt;/code&gt;, который заполняет нулями пространство слева от числовой строки. Он распознаёт знаки плюс и минус:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; '12'.zfill(5)
'00012'
&gt;&gt;&gt; '-3.14'.zfill(7)
'-003.14'
&gt;&gt;&gt; '3.14159265359'.zfill(5)
'3.14159265359'&lt;/syntaxhighlight&gt;

Основной способ применения метода &lt;code&gt;str.format()&lt;/code&gt; выглядит так&lt;ref&gt;''(Прим. перев.)'' We are the knights who say «Ni!» (''Мы — те рыцари, что говорят «Ни!»'') — цитата из [http://www.mwscomp.com/movies/grail/grail-13.htm сцены 13-й] фильма Монти Пайтон и Святой Грааль (Monty Python and Holy Grail)&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print('Мы — те {0}, что говорят &quot;{1}!&quot;'.format('рыцари', 'Ни'))
Мы — те рыцари, что говорят &quot;Ни!&quot;&lt;/syntaxhighlight&gt;

Скобки с символами внутри (их называют ''полями форматирования'' (&lt;tt&gt;format fields&lt;/tt&gt;)) заменяются на объекты, переданные методу &lt;code&gt;format&lt;/code&gt;. Номер в скобках обозначает позицию объекта в списке параметров, переданных методу &lt;code&gt;format&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print('{0} и {1}'.format('фарш', 'яйца'))
фарш и яйца
&gt;&gt;&gt; print('{1} и {0}'.format('фарш', 'яйца'))
яйца и фарш&lt;/syntaxhighlight&gt;

Если в методе &lt;code&gt;format&lt;/code&gt; используются именованные параметры, можно ссылаться на их значения, используя имя соответствующего аргумента&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;вывести('Этот {пища} — {прилагательное}.'.format(пища='фарш', прилагательное='непередаваемо ужасен'))&lt;/tt&gt;&lt;/ref&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print('Этот {food} — {adjective}.'.format(
...       food='фарш', adjective='непередаваемо ужасен'))
Этот фарш — непередаваемо ужасен.&lt;/syntaxhighlight&gt;

Позиционные и именованные параметры можно произвольно совмещать&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;вывести('История о {0}, {1}, и {другой}.'.format('Билл', 'Манфред', другой='Георг'))&lt;/tt&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print('История о {0}е, {1}е, и {other}е.'.format('Билл', 'Манфред',
                                                       other='Георг'))
История о Билле, Манфреде, и Георге.&lt;/syntaxhighlight&gt;

После имени поля может следовать необязательный спецификатор формата ‘&lt;code&gt;:&lt;/code&gt;’. С его помощью можно управлять форматированием значения. Следующий пример оставляет у числа Пи только три цифры после десятичного разделителя&lt;ref&gt;''(Прим. перев.)'' В качестве десятичного разделителя в Python используется точка, в соответствии со стандартами большинства стран.&lt;/ref&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import math
&gt;&gt;&gt; print('Значение ПИ — примерно {0:.3f}.'.format(math.pi))
Значение ПИ — примерно 3.142.&lt;/syntaxhighlight&gt;

После спецификатора ‘&lt;code&gt;:&lt;/code&gt;’ можно указать число — минимальную ширину поля, выраженную в количестве символов. Это удобно использовать для создания красивых таблиц:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; table = {'Sjoerd': 4127, 'Jack': 4098, 'Dcab': 7678}
&gt;&gt;&gt; for name, phone in table.items():
...     print('{0:10} ==&gt; {1:10d}'.format(name, phone))
... 
Jack       ==&gt;       4098
Dcab       ==&gt;       7678
Sjoerd     ==&gt;       4127&lt;/syntaxhighlight&gt;

Если ваша строка с форматами очень длинна, а вы не хотите разбивать её на подстроки, было бы неплохо если бы вы могли ссылаться на переменные, предназначенные для форматирования, не по позиции, а по имени. Это можно сделать, просто передав словарь и используя квадратные скобки ‘&lt;tt&gt;[]&lt;/tt&gt;’ для доступа к ключам.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; table = {'Sjoerd': 4127, 'Jack': 4098, 'Dcab': 8637678}
&gt;&gt;&gt; print('Jack: {0[Jack]:d}; Sjoerd: {0[Sjoerd]:d}; '
          'Dcab: {0[Dcab]:d}'.format(table))
Jack: 4098; Sjoerd: 4127; Dcab: 8637678&lt;/syntaxhighlight&gt;

Тоже самое можно сделать, передав словарь именованных параметров, используя нотацию «&lt;code&gt;**&lt;/code&gt;»:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; table = {'Sjoerd': 4127, 'Jack': 4098, 'Dcab': 8637678}
&gt;&gt;&gt; print('Jack: {Jack:d}; Sjoerd: {Sjoerd:d}; Dcab: {Dcab:d}'.format(**table))
Jack: 4098; Sjoerd: 4127; Dcab: 8637678&lt;/syntaxhighlight&gt;

В частности, такой приём удобно использовать в сочетании со встроенной функцией &lt;code&gt;vars()&lt;/code&gt;, которая возвращает словарь с локальными переменными.

Подробное описание форматирования строк с применением метода &lt;code&gt;str.format()&lt;/code&gt; описано в разделе [[Справочник по библиотеке Python 3.1#Синтаксис строк форматирования|Синтаксис строк форматирования]].

==== Форматирование строк в старом стиле ====

Для форматирования строк можно использовать и операцию &lt;code&gt;%&lt;/code&gt;. Она интерпретирует левый операнд как строку форматирования в стиле &lt;code&gt;sprintf&lt;/code&gt;, которую следует применить к правому операнду, и возвращает строку, получившуюся в результате этого преобразования. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import math
&gt;&gt;&gt; print 'Значение ПИ — примерно %5.3f.' % math.pi
Значение ПИ — примерно 3.142.&lt;/syntaxhighlight&gt;

Поскольку метод &lt;code&gt;str.format()&lt;/code&gt; довольно нов, большая часть исходных кодов Python всё ещё использует операцию &lt;code&gt;%&lt;/code&gt;. Однако, со временем, форматирование строк будет удалено из языка, поэтому в большинстве случаев следует использовать &lt;code&gt;str.format()&lt;/code&gt;.

Больше информации можно найти в разделе [[Справочник по библиотеке Python 3.1#Операции форматирования строк в старом стиле|Операции форматирования строк в старом стиле]].

=== Запись и чтение файлов ===

Функция &lt;code&gt;open()&lt;/code&gt; возвращает объект файла и в большинстве случаев используется с двумя аргументами: &lt;code&gt;open(''имя_файла'', ''режим'')&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f = open('/tmp/workfile', 'w')&lt;/syntaxhighlight&gt;

Первый параметр — строка, содержащая имя файла. Второй — другая строка, содержащая несколько символов, описывающих способ использования файла. Значение параметра ''режим'' может быть символом &lt;code&gt;'r'&lt;/code&gt;, если файл будет открыт только для чтения, &lt;code&gt;'w'&lt;/code&gt; — открыт только для записи (существующий файл с таким же именем будет стёрт) и &lt;code&gt;'a'&lt;/code&gt; — файл открыт для добавления: любые данные, записанные в файл автоматически добавляются в конец. &lt;code&gt;'r+'&lt;/code&gt; открывает файл и для чтения, и для записи. Параметр ''режим'' необязателен: если он опущен — предполагается, что он равен &lt;code&gt;'r'&lt;/code&gt;.

В обычном случае файлы открываются в ''текстовом режиме'' (&lt;tt&gt;text mode&lt;/tt&gt;) — это значит что вы читаете из файла и записываете в файл строки в определённой кодировке (по умолчанию используется &lt;tt&gt;UTF-8&lt;/tt&gt;). Если добавить к режиму файла символ ‘&lt;code&gt;b&lt;/code&gt;’, файл открывается в ''двоичном режиме'' (&lt;tt&gt;binary mode&lt;/tt&gt;): теперь данные считываются и записываются в виде двоичных объектов. Этот режим следует использовать для всех файлов, которые не содержат текст.

При использовании текстового режима, все окончания строк, по умолчанию, специфичные для платформы (&lt;code&gt;\n&lt;/code&gt; в Unix, &lt;code&gt;\r\n&lt;/code&gt; в Windows) усекаются до символа &lt;code&gt;\n&lt;/code&gt;, при чтении из файла, и конвертируются обратно из &lt;code&gt;\n&lt;/code&gt; в вид, специфичный для платформы, при записи в файл. Эти закулисные изменения в файловых данных корректно работают в случае текстовых файлов, но испортят двоичные данные в файлах вроде &lt;code&gt;JPEG&lt;/code&gt; или &lt;code&gt;EXE&lt;/code&gt;. Внимательно следите за тем, чтобы использовать двоичный режим при чтении и записи таких файлов.

==== Методы объектов-файлов ====

В примерах ниже подразумевается, что заранее создан файловый объект с именем &lt;code&gt;f&lt;/code&gt;.

Чтобы прочитать содержимое файла, вызовите &lt;code&gt;f.read(''размер'')&lt;/code&gt; — функция читает некоторое количество данных и возвращает их в виде строки или байтового объекта. &lt;code&gt;''размер''&lt;/code&gt; — необязательный числовой параметр. Если &lt;code&gt;''размер''&lt;/code&gt; опущен или отрицателен, будет прочитано и возвращено всё содержимое файла; если файл по величине в два раза больше оперативной памяти вашего компьютера, то решение этой проблемы остаётся на вашей совести. В противном случае, будет прочитано и возвращено максимум &lt;code&gt;''размер''&lt;/code&gt; байт. Если был достигнут конец файла, &lt;code&gt;f.read()&lt;/code&gt; вернёт пустую строку (&lt;code&gt;''&lt;/code&gt;).

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f.read()
'Это всё содержимое файла.\n'
&gt;&gt;&gt; f.read()
''&lt;/syntaxhighlight&gt;

&lt;code&gt;f.readline()&lt;/code&gt; читает одну строку из файла; символ новой строки (&lt;code&gt;\n&lt;/code&gt;) остаётся в конце прочитанной строки и отсутствует при чтении последней строки файла только если файл не оканчивается пустой строкой. За счёт этого возвращаемое значение становится недвусмысленным: если &lt;code&gt;f.readline()&lt;/code&gt; возвращает пустую строку — достигнут конец файла, в то же время незаполненная строка, представленная посредством &lt;code&gt;'\n'&lt;/code&gt;, содержит лишь символ новой строки.&lt;ref&gt;''(Прим. перев.)'' В источнике, в большинстве случаев, разделяется понятие ''строки'' как типа данных и ''строки'' как строки текста (ср., ''строчка'') применением слов ''string'' и ''line'' соответственно. В русском языке это различие передать сложно, тем не менее я старался по возможности избежать двусмысленностей.&lt;/ref&gt;

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f.readline()
'Это первая строка файла.\n'
&gt;&gt;&gt; f.readline()
'Вторая строка файла\n'
&gt;&gt;&gt; f.readline()
''&lt;/syntaxhighlight&gt;

&lt;code&gt;f.readlines()&lt;/code&gt; возвращает список, содержащий все строки с данными, обнаруженные в файле. Если передан необязательный параметр &lt;code&gt;подсказка_размера&lt;/code&gt;, функция читает из файла указанное количество байт, плюс некоторое количество байт сверх того, достаточное для завершения строки, и формирует список строк из результата. Функция часто используется для более эффективного (файл не загружается в память полностью) построчного чтения больших файлов. Возвращены будут только полные (завершённые) строки.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f.readlines()
['Это первая строка файла.\n', 'Вторая строка файла\n']&lt;/syntaxhighlight&gt;

Альтернативный способ построчного чтения — организация цикла по файловому объекту. Он быстр, рационально использует память и имеет простой код в результате:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for line in f:
        print(line, end='')
        
Это первая строка файла.
Вторая строка файла&lt;/syntaxhighlight&gt;

Альтернативный способ проще, но не предоставляет тонкого контроля над происходящим. Поскольку оба этих способа работают с буферизацией строк по-разному, их не следует смешивать.

&lt;code&gt;f.write(''строка'')&lt;/code&gt; записывает содержимое ''строки'' в файл и возвращает количество записанных байтов.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f.write('This is a test\n')
15&lt;/syntaxhighlight&gt;

Чтобы записать в файл нечто отличное от строки, предварительно это нечто нужно в строку сконвертировать&lt;ref&gt;''(Прим. перев.)'' Возможно, подразумевается [[w:ru:Ответ на главный вопрос жизни, вселенной и всего такого|ответ на главный вопрос жизни, вселенной и всего такого]]&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; value = ('ответ', 42)
&gt;&gt;&gt; s = str(value)
&gt;&gt;&gt; f.write(s)
18&lt;/syntaxhighlight&gt;

&lt;code&gt;f.tell()&lt;/code&gt; возвращает целое, представляющее собой текущую позицию в файле &lt;code&gt;f&lt;/code&gt;, измеренную в байтах от начала файла. Чтобы изменить позицию объекта-файла, используйте &lt;code&gt;f.seek(''смещение'', ''откуда'')&lt;/code&gt;. Позиция вычисляется прибавлением смещения к точке отсчёта; точка отсчёта выбирается из параметра &lt;code&gt;''откуда''&lt;/code&gt;. Значение &lt;code&gt;0&lt;/code&gt; параметра &lt;code&gt;''откуда''&lt;/code&gt; отмеряет смещение от начала файла, значение &lt;code&gt;1&lt;/code&gt; применяет текущую позицию в файле, а значение &lt;code&gt;2&lt;/code&gt; в качестве точки отсчёта использует конец файла. Параметр &lt;code&gt;''откуда''&lt;/code&gt; может быть опущен и по умолчанию устанавливается в &lt;code&gt;0&lt;/code&gt;, используя начало файла в качестве точки отсчёта.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f = open('/tmp/workfile', 'rb+')
&gt;&gt;&gt; f.write(b'0123456789abcdef')
16
&gt;&gt;&gt; f.seek(5)     # Перейти к шестому байту в файле
5
&gt;&gt;&gt; f.read(1)        
b'5'
&gt;&gt;&gt; f.seek(-3, 2) # Перейти к третьему байту с конца 
13
&gt;&gt;&gt; f.read(1)
b'd'&lt;/syntaxhighlight&gt;

При работе с текстовыми файлами (открытыми без символа &lt;code&gt;b&lt;/code&gt; в строке режима), выполнять позиционирование (&lt;code&gt;seek&lt;/code&gt;) позволяется только от начала файла (за исключением прокрутки в конец файла с использованием &lt;code&gt;seek(0, 2)&lt;/code&gt;).

Когда вы закончили все действия над файлом, вызовите &lt;code&gt;f.close()&lt;/code&gt; чтобы закрыть его и освободить все системные ресурсы, использованные при открытии этого файла. Все попытки использовать объект-файл после вызова &lt;code&gt;f.close()&lt;/code&gt; приведут к возникновению исключения.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f.close()
&gt;&gt;&gt; f.read()
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
ValueError: I/O operation on closed file&lt;/syntaxhighlight&gt;

Считается хорошей манерой использовать ключевое слово &lt;code&gt;with&lt;/code&gt; при работе с файловыми объектами. Преимущество этого способа в том, что файл всегда корректно закрывается после выполнения блока, либо если при выполнении было порождено исключение. Кроме того, получающийся код намного короче, чем эквивалентная форма с блоками &lt;tt&gt;&lt;code&gt;try&lt;/code&gt;-&lt;code&gt;finally&lt;/code&gt;&lt;/tt&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; with open('/tmp/workfile', 'r') as f:
...     read_data = f.read()
&gt;&gt;&gt; f.closed
True&lt;/syntaxhighlight&gt;

У объектов-файлов есть ещё несколько дополнительных методов, таких как &lt;code&gt;isatty()&lt;/code&gt; и &lt;code&gt;truncate()&lt;/code&gt;, которые используются не так часто; обратитесь к [[Справочник по библиотеке Python 3.1|Справочнику по библиотеке]] для более полного обзора по файловым объектам.

==== Модуль &lt;code&gt;pickle&lt;/code&gt; ====

Строки могут с лёгкостью быть записаны в файл и прочитаны из файла. В случае чисел нужно применить несколько больше усилий: метод &lt;code&gt;read()&lt;/code&gt; возвращает только строки, которые придётся передать функции вроде &lt;code&gt;int()&lt;/code&gt;, которая принимает строку вида &lt;code&gt;'123'&lt;/code&gt; и возвращает её числовое значение: &lt;code&gt;123&lt;/code&gt;. Однако если вы намереваетесь сохранить более сложные типы данных, такие как списки, словари или экземпляры классов, всё становится несколько запутаннее.

Вместо того чтобы принуждать программиста постоянно писать и отлаживать код для замысловатых типов данных, Python предоставляет стандартный модуль под названием &lt;code&gt;pickle&lt;/code&gt;. Это замечательный модуль, который может принять любой объект Python (даже некоторые формы кода на Python!) и конвертировать его в строковое представление: этот процесс называется ''консервацией'' (&lt;tt&gt;pickling&lt;/tt&gt;). Восстановление объекта из его строкового представления называется ''расконсервацией'' (&lt;tt&gt;unpickling&lt;/tt&gt;): строка, описывающая объект, может быть сохранена в файл, добавлена к некоторым данным, или отослана через соединение по сети на удаленный компьютер.&lt;ref&gt;''(Прим. перев.)'' ''Консервирование'' в Python можно рассматривать как частный случай [[w:ru:Сериализация|сериализации]]; ещё про ''консервирование'' можно почитать [http://www.ibm.com/developerworks/ru/library/l-pypers/index.html здесь].&lt;/ref&gt;

Если у вас есть некоторый объект &lt;code&gt;x&lt;/code&gt; и объект файла &lt;code&gt;f&lt;/code&gt;, открытый на запись в двоичном режиме (binary mode, с параметром 'wb'), простейший способ ''законсервировать'' объект требует одной-единственной строки кода:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;pickle.dump(x, f)&lt;/syntaxhighlight&gt;

Чтобы снова расконсервировать объект, при условии что &lt;code&gt;f&lt;/code&gt; — объект файла, открытого для чтения (так же в двоичном режиме, с параметром 'rb'):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;x = pickle.load(f)&lt;/syntaxhighlight&gt;

(Существуют варианты выполнения этих операций, применяемые при ''расконсервации'' нескольких объектов или когда вам требуется записать ''консервированные'' данные в файл; обратитесь к документации по модулю [[Справочник по библиотеке Python 3.1#pickle|pickle]] из [[Справочник по библиотеке Python 3.1|Справочника по библиотеке]].)

[[Справочник по библиотеке Python 3.1#pickle|pickle]] — стандартный способ для создания объектов Python, которые могут быть повторно использованы другими программами или будущими версиями этой же программы; для них есть технический термин — ''устойчивый объект'' (&lt;tt&gt;persistent object&lt;/tt&gt;). Поскольку [[Справочник по библиотеке Python 3.1#pickle|pickle]] используется часто, многие авторы расширений для Python заботятся о том, чтобы новые типы данных, такие как матрицы, могли быть корректно ''законсервированы'' и ''расконсервированы''.

== Ошибки и исключения ==

До этого момента сообщения об ошибках лишь упоминались, но если вы пробовали примеры на практике — возможно, вы уже видели некоторые. Существует (как минимум) два различимых вида ошибок: ''синтаксические ошибки'' (&lt;tt&gt;syntax errors&lt;/tt&gt;) и ''исключения'' (&lt;tt&gt;exceptions&lt;/tt&gt;).

=== Синтаксические ошибки ===

Синтаксические ошибки, также известные как ошибки разбора кода (''парсинга'', &lt;tt&gt;parsing&lt;/tt&gt;) — вероятно, наиболее привычный вид жалоб компилятора, попадающихся вам при изучении Python:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; while True print('Hello world')
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
    while True print('Hello world')
                   ^
SyntaxError: invalid syntax&lt;/syntaxhighlight&gt;

Парсер&lt;ref&gt;''(Прим. перев.)'' ''Parser'' {{ref-en}} — программа синтаксического анализа, синтаксический анализатор; программа грамматического разбора&lt;/ref&gt; повторно выводит ошибочную строку и отображает небольшую «стрелку», указывающую на самую первую позицию в строке, где была обнаружена ошибка. Причина ошибки (или по крайней мере место обнаружения) находится в символе&lt;ref&gt;''(Прим. перев.)'' ''Token'' {{ref-en}} — некоторая смысловая единица выражения: оператор, ключевое слово, значение переменной, …&lt;/ref&gt;, предшествующем указанному: в приведённом примере ошибка обнаружена на месте вызова функции &lt;code&gt;print()&lt;/code&gt;, поскольку перед ним пропущено двоеточие (&lt;code&gt;':'&lt;/code&gt;). Также здесь выводятся имя файла и номер строки, благодаря этому вы знаете в каком месте искать, если ввод был сделан из сценария.

=== Исключения ===

Даже если выражение или оператор синтаксически верны, они могут вызвать ошибку при попытке их исполнения. Ошибки, обнаруженные при исполнении, называются ''исключениями'' (&lt;tt&gt;exceptions&lt;/tt&gt;). Они не фатальны: позже вы научитесь перехватывать их в программах на Python. Большинство исключений, правда, как правило, не обрабатываются программами и приводят к сообщениям об ошибке, таким как следующие:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 10 * (1/0)
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
ZeroDivisionError: int division or modulo by zero
&gt;&gt;&gt; 4 + spam*3
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
NameError: name 'spam' is not defined
&gt;&gt;&gt; '2' + 2
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
TypeError: coercing to Unicode: need string or buffer, int found&lt;/syntaxhighlight&gt;

Последняя строка сообщения об ошибке описывает произошедшее. Исключения представлены различными типами и тип исключения выводится в качестве части сообщения: в примере это типы &lt;code&gt;ZeroDivisionError&lt;/code&gt;, &lt;code&gt;NameError&lt;/code&gt; и &lt;code&gt;TypeError&lt;/code&gt;. Часть строки, описывающая тип исключения — это имя произошедшего встроенного исключения. Такое утверждение верно для всех встроенных исключений, но не обязано быть истинным для исключений, определённых пользователем (однако, само соглашение — довольно полезное). Имена стандартных исключений — это встроенные идентификаторы (не ключевые слова).

Оставшаяся часть строки описывает детали произошедшего на основе типа исключения, которое было его причиной.

Предшествующая часть сообщения об ошибке показывает контекст, где произошло исключение, в форме стека вызовов. В общем случае она содержит стек, состоящий из списка строк исходного кода; тем не менее, в неё не войдут строки, прочитанные из стандартного ввода.

В разделе [[Справочник по библиотеке Python 3.1#Встроенные исключения|Встроенные исключения]] [[Справочник по библиотеке Python 3.1|Справочника по библиотеке]] вы найдёте список встроенных исключений и их значений.

=== Обработка исключений ===

Существует возможность написать код, который будет перехватывать избранные исключения. Посмотрите на представленный пример, в котором пользователю предлагают вводить число до тех пор, пока оно не окажется корректным целым. Тем не менее, пользователь может прервать программу (используя сочетание клавиш &lt;tt&gt;Control-C&lt;/tt&gt; или какое-либо другое, поддерживаемое операционной системой); заметьте — о вызванном пользователем прерывании сигнализирует исключение &lt;code&gt;KeyboardInterrupt&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; while True:
...     try:
...         x = int(input(&quot;Введите, пожалуйста, число: &quot;))
...         break
...     except ValueError:
...         print(&quot;Ой!  Это некорректное число.  Попробуйте ещё раз...&quot;)
...&lt;/syntaxhighlight&gt;

Оператор &lt;code&gt;try&lt;/code&gt; работает следующим образом:

* В начале исполняется ''блок &lt;code&gt;try&lt;/code&gt;'' (операторы между ключевыми словами &lt;code&gt;try&lt;/code&gt; и &lt;code&gt;except&lt;/code&gt;).

* Если при этом не появляется исключений, ''блок &lt;code&gt;except&lt;/code&gt;'' не выполняется и оператор &lt;code&gt;try&lt;/code&gt; заканчивает работу.

* Если во время выполнения блока &lt;code&gt;try&lt;/code&gt; было возбуждено какое-либо исключение, оставшаяся часть блока не выполняется. Затем, если тип этого исключения совпадает с исключением, указанным после ключевого слова &lt;code&gt;except&lt;/code&gt;, выполняется блок &lt;code&gt;except&lt;/code&gt;, а по его завершению выполнение продолжается сразу после оператора &lt;code&gt;try-except&lt;/code&gt;.

* Если порождается исключение, не совпадающее по типу с указанным в блоке &lt;code&gt;except&lt;/code&gt; — оно передаётся внешним операторам &lt;code&gt;try&lt;/code&gt;; если ни одного обработчика не найдено, исключение считается ''необработанным'' (&lt;tt&gt;unhandled exception&lt;/tt&gt;), и выполнение полностью останавливается и выводится сообщение, схожее с показанным выше.

Оператор &lt;code&gt;try&lt;/code&gt; может иметь более одного блока &lt;code&gt;except&lt;/code&gt; — для описания обработчиков различных исключений. При этом будет выполнен максимум один обработчик. Обработчики ловят только те исключения, которые возникают внутри соответствующего блока &lt;code&gt;try&lt;/code&gt;, но не те, которые возникают в других обработчиках этого же самого оператора &lt;code&gt;try-except&lt;/code&gt;. Блок &lt;code&gt;except&lt;/code&gt; может указывать несколько исключений в виде заключённого в скобки кортежа, например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;... except (RuntimeError, TypeError, NameError):
...     pass&lt;/syntaxhighlight&gt;

В последнем блоке &lt;code&gt;except&lt;/code&gt; можно не указывать имени (или имён) исключений. Тогда он будет действовать как обработчик группы исключений. Используйте эту возможность с особой осторожностью, поскольку таким образом он может с лёгкостью перехватить и фактическую ошибку программиста! Также такой обработчик может быть использован для вывода сообщения об ошибке и порождения исключения заново (позволяя при этом обработать исключение коду, вызвавшему обработчик):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import sys

try:
    f = open('myfile.txt')
    s = f.readline()
    i = int(s.strip())
except IOError as err:
    print(&quot;I/O error: {0}&quot;.format(err))
except ValueError:
    print(&quot;Не могу преобразовать данные в целое.&quot;)
except:
    print(&quot;Неожиданная ошибка:&quot;, sys.exc_info()[0])
    raise&lt;/syntaxhighlight&gt;

У оператора &lt;code&gt;try-except&lt;/code&gt; есть необязательный ''блок &lt;code&gt;else&lt;/code&gt;'', который, если присутствует, должен размещаться после всех блоков &lt;code&gt;except&lt;/code&gt;. Его полезно использовать при наличии кода, который должен быть выполнен, если блок &lt;code&gt;try&lt;/code&gt; не породил исключений. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;for arg in sys.argv[1:]:
    try:
        f = open(arg, 'r')
    except IOError:
        print('не могу открыть', arg)
    else:
        print(arg, 'содержит', len(f.readlines()), 'строк')
        f.close()&lt;/syntaxhighlight&gt;

Использование блока &lt;code&gt;else&lt;/code&gt; предпочтительнее, чем добавление дополнительного кода к блоку &lt;code&gt;try&lt;/code&gt;, поскольку исключает неожиданный перехват исключения, которое появилось не по причине выполнения кода, защищенного оператором &lt;code&gt;try-except&lt;/code&gt;.

При появлении исключения, оно может иметь ассоциированное значение, также известное как ''аргумент'' (&lt;tt&gt;argument&lt;/tt&gt;) исключения. Присутствие и тип аргумента зависят от типа самого исключения.

В блоке &lt;code&gt;except&lt;/code&gt; можно указать переменную, следующую за именем исключения. Переменная связывается с экземпляром исключения, аргументы которого хранятся в &lt;code&gt;instance.args&lt;/code&gt;. Для удобства, экземпляр исключения определяет метод &lt;code&gt;__str__()&lt;/code&gt;, так что вывод аргументов может быть произведён явно, без необходимости отсылки к &lt;code&gt;.args&lt;/code&gt;. Таким образом, вы также можете создать/взять экземпляр исключения перед его порождением и добавить к нему атрибуты по желанию.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; try:
...    raise Exception('spam', 'eggs')
... except Exception as inst:
...    print(type(inst))     # экземпляр исключения
...    print(inst.args)      # аргументы хранятся в .args
...    print(inst)           # __str__ позволяет вывести args явно,
...                          # но может быть переопределён в подклассах исключения
...    x, y = inst           # распаковка args
...    print 'x =', x
...    print 'y =', y
...
&lt;class 'Exception'&gt;
('spam', 'eggs')
('spam', 'eggs')
x = spam
y = eggs&lt;/syntaxhighlight&gt;

Если у исключения есть аргументы, они выводится в качестве последней («детальной») части сообщения о необработанном исключении.

Обработчики исключений перехватывают не только исключения, появившиеся прямо в блоке &lt;code&gt;try&lt;/code&gt;, но также и возбужденные внутри функций, которые были в блоке &lt;code&gt;try&lt;/code&gt; вызваны (даже неявно). Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def this_fails():
...     x = 1/0
... 
&gt;&gt;&gt; try:
...     this_fails()
... except ZeroDivisionError as err:
...     print('Перехват ошибки времени исполнения:', err)
... 
Перехват ошибки времени исполнения: integer division or modulo by zero&lt;/syntaxhighlight&gt;

=== Порождение исключений ===

Оператор &lt;code&gt;raise&lt;/code&gt; позволяет программисту принудительно породить исключение. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; raise NameError('ПриветТам')
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
NameError: ПриветТам&lt;/syntaxhighlight&gt;

Единственный аргумент оператора &lt;code&gt;raise&lt;/code&gt; определяет исключение, которое нужно возбудить. Им может быть либо экземпляр исключения, либо класс исключения (класс, дочерний к классу &lt;code&gt;Exception&lt;/code&gt;).

Если вам нужно определить, было ли возбуждено исключение, не перехватывая его — упрощённая форма оператора &lt;code&gt;raise&lt;/code&gt; позволит возбудить исключение заново:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; try:
...     raise NameError('ПриветТам')
... except NameError:
...     print('Исключение пролетело мимо!')
...     raise
...
Исключение пролетело мимо!
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 2, in ?
NameError: ПриветТам&lt;/syntaxhighlight&gt;

=== Исключения, определённые пользователем ===

В программах можно определять свои собственные исключения — посредством создания нового класса исключения. В общем случае, исключения должны быть унаследованы от класса &lt;code&gt;Exception&lt;/code&gt;: явно или неявно. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; class MyError(Exception):
...     def __init__(self, value):
...         self.value = value
...     def __str__(self):
...         return repr(self.value)
... 
&gt;&gt;&gt; try:
...     raise MyError(2*2)
... except MyError as e:
...     print('Поймано моё исключение со значением:', e.value)
... 
Поймано моё исключение со значением: 4
&gt;&gt;&gt; raise MyError('ой!')
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
__main__.MyError: 'ой!'&lt;/syntaxhighlight&gt;

В этом примере был перегружен конструктор по умолчанию &lt;code&gt;__init__()&lt;/code&gt; класса &lt;code&gt;Exception&lt;/code&gt;. Новое поведение отличается лишь созданием нового атрибута &lt;code&gt;value&lt;/code&gt; и заменяет поведение по умолчанию, при котором создаётся атрибут &lt;code&gt;args&lt;/code&gt;.

Классы исключений могут определять любые действия, которые могут делать все другие классы. Однако, обычно их внутренняя структура довольно проста, и предоставляет лишь некоторые атрибуты, позволяющие обработчикам исключений выяснить информацию об ошибке подробно. При создании модуля, который может породить различные ошибки, обычной практикой будет создание базового класса для исключений, определённых в этом модуле, и подклассов для различных ошибочных состояний:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class Error(Exception):
    &quot;&quot;&quot;Базовый класс для всех исключений в этом модуле.&quot;&quot;&quot;
    pass

class InputError(Error):
    &quot;&quot;&quot;Исключение порождается при ошибках при вводе.

    Атрибуты:
        expression -- выражение на вводе, в котором обнаружена ошибка
        message -- описание ошибки
    &quot;&quot;&quot;

    def __init__(self, expression, message):
        self.expression = expression
        self.message = message

class TransitionError(Error):
    &quot;&quot;&quot;Порождается, когда операция пытается выполнить неразрешённый переход
    из одного состояния в другое.

    Attributes:
        previous -- состояние в начале перехода
        next -- новое состояние, попытка принять которое была принята 
        message -- описание, по какой причине такой переход невозможен
    &quot;&quot;&quot;

    def __init__(self, previous, next, message):
        self.previous = previous
        self.next = next
        self.message = message&lt;/syntaxhighlight&gt;

Большинство исключений имеет имя, заканчивающееся на «&lt;code&gt;Error&lt;/code&gt;», подобно стандартным исключениям.

Много стандартных модулей определяют собственные исключения, сообщающие об ошибках, которые могут появиться в определяющих их модулях. Больше информации о классах представлено в главе 1.10, [[Учебник Python 3.1#Классы|Классы]]

=== Определение действий при подчистке ===

У оператора &lt;code&gt;try&lt;/code&gt; есть другой необязательный блок, предназначенный для операций подчистки, которые нужно выполнить независимо от условий:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; try:
...     raise KeyboardInterrupt
... finally:
...     print('Прощай, мир!')
... 
Прощай, мир!
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 2, in ?
KeyboardInterrupt&lt;/syntaxhighlight&gt;

''Блок &lt;code&gt;finally&lt;/code&gt;'' исполняется всегда, когда интерпретатор покидает оператор &lt;code&gt;try&lt;/code&gt;, независимо — были исключения или нет. Если в блоке &lt;code&gt;try&lt;/code&gt; появилось исключение, которое не было обработано в блоке &lt;code&gt;except&lt;/code&gt; (или появилось в самих блоках &lt;code&gt;except&lt;/code&gt; или &lt;code&gt;else&lt;/code&gt;) — оно порождается заново после выполнения блока &lt;code&gt;finally&lt;/code&gt;. Также блок &lt;code&gt;finally&lt;/code&gt; исполняется «по пути наружу», если какой-либо другой блок оператора &lt;code&gt;try&lt;/code&gt; был покинут за счёт одного из операторов: &lt;code&gt;break&lt;/code&gt;, &lt;code&gt;continue&lt;/code&gt; или &lt;code&gt;return&lt;/code&gt;. Более сложный пример:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def divide(x, y):
...     try:
...         result = x / y
...     except ZeroDivisionError:
...         print(&quot;деление на ноль!&quot;)
...     else:
...         print(&quot;результат: &quot;, result)
...     finally:
...         print(&quot;выполнение блока finally&quot;)
...
&gt;&gt;&gt; divide(2, 1)
результат:  2
выполнение блока finally
&gt;&gt;&gt; divide(2, 0)
деление на ноль!
выполнение блока finally
&gt;&gt;&gt; divide(&quot;2&quot;, &quot;1&quot;)
выполнение блока finally
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
  File &quot;&lt;stdin&gt;&quot;, line 3, in divide
TypeError: unsupported operand type(s) for /: 'str' and 'str'&lt;/syntaxhighlight&gt;

Как видите, блок &lt;code&gt;finally&lt;/code&gt; выполняется при любом событии. Ошибка &lt;code&gt;TypeError&lt;/code&gt; порождается при делении двух строк и не перехватывается блоком &lt;code&gt;except&lt;/code&gt;, и поэтому порождается заново сразу после выполнения блока &lt;code&gt;finally&lt;/code&gt;.

В приложениях реального мира, блок &lt;code&gt;finally&lt;/code&gt; применяется для освобождения внешних ресурсов (таких как файлы или сетевые соединения), независимо от того, было ли их использование удачным.

=== Предопределённые действия по подчистке ===

Некоторые объекты определяют стандартные действия при подчистке, применяемые если объект больше не нужен, независимо от того, удачна была операция использования объекта или нет. Посмотрите на следующий пример, в которым мы пытаемся открыть файл и вывести его содержимое на экран.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;for line in open(&quot;myfile.txt&quot;):
    print(line)&lt;/syntaxhighlight&gt;

Проблема этого кода в том, что он оставляет файл открытым на неопределённое количество времени после выполнения данной части кода. В простых сценариях это не является проблемой, но может стать ей в больших приложениях. Оператор &lt;code&gt;with&lt;/code&gt; позволяет использовать объекты (такие как, например, файлы) таким образом, чтобы вы всегда могли быть уверены в том, что ресурсы будут сразу и корректно очищены.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;with open(&quot;myfile.txt&quot;) as f:
    for line in f:
        print(line)&lt;/syntaxhighlight&gt;

После выполнения оператора, файл ''&lt;code&gt;f&lt;/code&gt;'' всегда закрывается, даже если при прочтении строк обнаружилась проблема. В документации к объектам, которые поддерживают предопределённые действия по подчистке, таким как файлы, эта их способность будет явно указана.

== Классы ==

За счёт механизма классов Python в язык с минимальным использованием нового синтаксиса и семантики добавляется возможность создания классов. Это смесь классовых механизмов, заимствованных из C++ и Modula-3. Как и в случае модулей, классы в Python не устанавливают абсолютного барьера между определением и программистом, рассчитывая больше на аккуратность и вежливость последнего — чтобы он не «врывался в определения». Наиболее важные возможности классов, тем не менее, содержат в себе всю возможную мощь: механизм наследования классов поддерживает несколько предков для класса, производный класс может переопределять любые методы своего предка или предков, а любой его метод может вызвать метод предка с таким же именем. Объекты могут содержать произвольное количество закрытых (&lt;tt&gt;private&lt;/tt&gt;) данных.

В терминологии C++, члены класса (включая данные-члены), обычно, открыты (&lt;tt&gt;public&lt;/tt&gt;) (исключая [[Учебник Python 3.1#Приватные переменные|Приватные переменные]], описанные ниже), а все функции-члены — виртуальны. Нет специальных конструкторов и деструкторов. Как в Modula-3, нет краткой ссылки на члены объекта из его методов: функция-метод определяется с явным первым аргументом, описывающим объект, который неявно передаётся при вызове. Как в Smalltalk, классы сами по себе являются объектами, хотя и в более широком смысле: в Python все типы данных — объекты. Таким образом обеспечивается семантика для импортирования и переименования. В отличие от C++ и Modula-3 встроенные типы могут использоваться в качестве предков для расширения возможностей пользователем. Кроме того, как в C++, но не как в Modula-3, большинство встроенных операторов со специальным синтаксисом (арифметические операторы, индексирование и т. д.) могут быть переопределены для экземпляров классов.

=== Пара слов о терминологии ===

Обходя стороной поддерживаемую всем миром терминологию, применимую к разговорам о классах, в нашем случае я буду говорить в терминах C++ и Smalltalk. (Предпочёл бы использовать термины языка Modula-3, поскольку Python ближе к ней по объектно-ориентированной семантике, чем к C++, но предполагаю, что немногие читатели слышали о нём.)

Объекты обладают индивидуальностью, и с одним объектом может быть связано несколько имён (в нескольких областях видимости). Такая практика в других языках известна как ''совмещение имён'' (&lt;tt&gt;aliasing&lt;/tt&gt;). На первый взгляд, совмещение малозаметно в Python, и его можно без последствий игнорировать при работе с основными неизменяемыми типами (числами, строками, кортежами). Тем не менее, совмещение имён влияет на семантику программного кода Python, работающего с изменяемыми объектами: списками, словарями и большинством типов, описывающих сущности вне программы (файлы, окна и т. п.). Обычно такая практика считается полезной, поскольку псевдонимы работают подобно указателям и вероятно даже превосходят их возможности. Например, передача объекта — дешевая операция, поскольку по реализации передаётся только указатель. Если функция изменяет переданный в качестве аргумента объект, это будет заметно и в месте вызова. За счёт этого пропадает необходимость в двух различных механизмах передачи аргументов.

=== Области видимости и пространства имён в Python ===

Прежде чем заняться классами необходимо получить представление о правилах областей видимости в Python. Определения классов проделывают над пространствами имён некоторые ловкие трюки. Чтобы полностью понимать происходящее, нужно знать о принципах работы областей видимости и пространств имён. Эти знания не помешают любому профессиональному программисту на Python.

Давайте начнём с нескольких определений.

''Пространство имён'' (&lt;tt&gt;namespace&lt;/tt&gt;) — это набор связей имён с объектами&lt;ref&gt;''(Прим. перев.) A namespace is a mapping from names to objects {{ref-en}} — ''(букв.)'' пространство имён суть отображение имён на объекты''&lt;/ref&gt;. В настоящий момент большинство пространств имён реализованы в виде словарей Python, но не стоит заострять на этом внимание (если только по поводу производительности): возможно, в будущем реализация изменится. Примеры пространств имён: набор встроенных имён (функции вроде &lt;code&gt;abs()&lt;/code&gt; и имён встроенных исключений); глобальные имена в модуле; локальные имена при вызове функции. Важная вещь, которую необходимо знать о пространствах имён — это то, что нет абсолютно никакой связи между именами в разных пространствах имён: например, два разных модуля могут без проблем определять функцию «&lt;code&gt;maximize&lt;/code&gt;», так как пользователи модулей будут использовать имена модулей в качестве префиксов.

Кстати, слово ''атрибут'' (&lt;tt&gt;attribute&lt;/tt&gt;) я применяю к любому имени, следующему за точкой. Например, в выражении &lt;code&gt;z.real&lt;/code&gt;, &lt;code&gt;real&lt;/code&gt; — это атрибут объекта &lt;code&gt;z&lt;/code&gt;. Строго говоря, ссылки на имена в модуле являются ссылками на атрибуты: в выражении &lt;code&gt;''имя_модуля''.''имя_функции''&lt;/code&gt; под ''имя_модуля'' скрывается объект модуля, а под ''имя_функции'' — его атрибут. В таком случае обнаруживается прямая связь между атрибутами модуля и глобальными именами, определёнными в модуле: они разделяют между собой одно и тоже пространство имён&lt;ref&gt;Исключая одну тонкость. У объектов модулей есть скрытый, только для чтения, атрибут под именем &lt;code&gt;__dict__&lt;/code&gt;, возвращающий словарь, использовавшийся для формирования пространства имён модуля; имя &lt;code&gt;__dict__&lt;/code&gt; является атрибутом, но не глобальным именем. Очевидно, что всё это нарушает абстракцию реализации пространства имён и его использование следует ограничить вещами вроде посмертных отладчиков&lt;/ref&gt;.

Запись в атрибуты может быть запрещена (''атрибут только для чтения'', &lt;tt&gt;read-only attribute&lt;/tt&gt;) или разрешена (''перезаписываемый атрибут'', &lt;tt&gt;writable attribute&lt;/tt&gt;). В последнем случае присваивание атрибуту является возможным. Атрибуты модуля перезаписываемы: вы можете написать «&lt;code&gt;modname.the_answer = 42&lt;/code&gt;»&lt;ref&gt;''(Прим. перев.)'' Снова [[w:ru:Ответ на главный вопрос жизни, вселенной и всего такого|ответ на главный вопрос жизни, вселенной и всего такого]]&lt;/ref&gt;. Перезаписываемые атрибуты могут также быть удалены оператором &lt;code&gt;del&lt;/code&gt;. Например, код «&lt;code&gt;del modname.the_answer&lt;/code&gt;» удалит атрибут &lt;code&gt;the_answer&lt;/code&gt; из объекта с именем &lt;code&gt;modname&lt;/code&gt;.

Пространства имён создаются в различные моменты и имеют разное время жизни. Пространство имён, содержащее встроенные имена создаётся при запуске интерпретатора и не удаляется никогда. Глобальное пространство имён модуля создаётся при вычитке определения модуля. Обычно, пространства имён модулей также «живут» до выхода из интерпретатора. Выражения, выполняемые верхне-уровневым порождением интерпретатора, прочитанные из файла сценария или интерактивно, рассматриваются как часть модуля под названием &lt;code&gt;__main__&lt;/code&gt;, поэтому у них есть своё собственное глобальное пространство имён. (Встроенные имена по факту также живут в модуле, он называется &lt;code&gt;builtins&lt;/code&gt;).

Локальное пространство имён функции создаётся при её вызове и удаляется когда функция возвращает значение либо порождает исключение, внутри неё не перехваченное. (На самом деле, лучшим способом объяснить, что происходит на самом деле, было бы «забывание»). Конечно же, рекурсивные порождения имеют свои пространства имён каждое.

''Область видимости'' (&lt;tt&gt;scope&lt;/tt&gt;) — это текстовая область в программе на Python, из которой прямым образом доступно пространство имён. «Прямым образом доступно» подразумевает, что явная ссылка на имя вынуждает интерпретатор искать это имя в пространстве имён.

Несмотря на то, что области видимости определяются статически, используются они динамически. В любой момент во время выполнения существует как минимум три вложенных области видимости, чьи пространства имён доступны прямым образом: самая внутренняя&lt;ref&gt;''(Прим. перев.)'' ''Innermost scope'', ''outermost scope'' {{ref-en}} — самая внутренняя и самая внешняя области видимости&lt;/ref&gt; область видимости (по ней поиск осуществляется в первую очередь) содержит локальные имена; пространства имён всех объемлющих [данный код] функций, поиск по которым начинается с ближайшей объемлющей [код] области видимости; область видимости среднего уровня, по ней следующей проходит поиск и она содержит глобальные имена текущего модуля; и самая внешняя область видимости (заключительный поиск) — это пространство имён, содержащее встроенные имена.

Если имя определено глобально, тогда все ссылки и присваивания уходят прямо в область видимости среднего уровня, содержащую глобальные имена модуля. Чтобы сменить привязку у всех переменных, найденных вне самой внутренней области видимости, можно использовать оператор &lt;code&gt;nonlocal&lt;/code&gt;; если такая переменная не объявлена как &lt;code&gt;nonlocal&lt;/code&gt;, то она используется только для чтения (попытка записать значение в такую переменную создаст новую локальную переменную в самой внутренней области видимости, оставляя идентично названную вовне переменную без изменений).

Обычно локальная область видимости ссылается на локальные имена текущей (на уровне текста) функции. Вне функций локальная область видимости ссылается на то же пространство имён, что и глобальная область видимости: пространство имён модуля. Определения классов помещают в локальную область видимости ещё одно пространство имён.

Важно осознавать, что области видимости ограничиваются на текстовом уровне: глобальная область видимости функции, определённая в модуле, является пространством имён этого модуля, независимо от того, откуда или по какому псевдониму была эта функция вызвана. С другой стороны, фактический поиск имён осуществляется динамически, во время выполнения. Как бы то ни было, язык развивается в сторону статического разрешения имён (во время компиляции), так что не стоит полагаться на динамическое разрешение имён. (Фактически, локальные переменные уже определены статично.)

Особая хитрость в Python состоит в том, что — при условии, что в данной области не включены операторы &lt;code&gt;global&lt;/code&gt; или &lt;code&gt;nonlocal&lt;/code&gt; — присваивания именам всегда уходят в самую внутреннюю область видимости. Присваивания не копируют данных, а лишь связывают имена с объектами. То же самое верно и для удалений: оператор «&lt;code&gt;del x&lt;/code&gt;» удаляет связь &lt;code&gt;x&lt;/code&gt; из пространства имён, на которое ссылается локальная область видимости. В действительности, все операции, вводящие новые имена, используют локальную область видимости: в частности, операторы импорта и описаний функций связывают имя модуля или функции в локальной области видимости соответственно. (Для того, чтобы указать определённой переменной, что она должна быть расположена в глобальной области видимости, может использоваться оператор &lt;code&gt;global&lt;/code&gt;.)

Оператор &lt;code&gt;global&lt;/code&gt; можно использовать для того, чтобы объявить определённые переменные как привязанные к глобальной области видимости и указывает, что их переназначения должны происходить в ней; оператор &lt;code&gt;nonlocal&lt;/code&gt; помечает переменные как привязанные к окружающей их области видимости и указывает, что их переназначения должны происходить в ней.

=== Пример по областям видимости и пространствам имён ===

Приведём пример, показывающий, каким образом можно ссылаться на разные области видимости и пространства имён и как &lt;code&gt;global&lt;/code&gt; и &lt;code&gt;nonlocal&lt;/code&gt; влияют на привязку переменной.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def scope_test():
    def do_local():
        spam = &quot;локальный спам&quot;
    def do_nonlocal():
        nonlocal spam
        spam = &quot;нелокальный спам&quot;
    def do_global():
        global spam
        spam = &quot;глобальный спам&quot;

    spam = &quot;тестовый спам&quot;
    do_local()
    print(&quot;После локального присваивания:&quot;, spam)
    do_nonlocal()
    print(&quot;После нелокального присваивания:&quot;, spam)
    do_global()
    print(&quot;После глобального присваивания:&quot;, spam)

scope_test()
print(&quot;В глобальной области видимости:&quot;, spam)&lt;/syntaxhighlight&gt;

Вывод кода из примера таков:

&lt;syntaxhighlight lang=&quot;text&quot;&gt;После локального присваивания: тестовый спам
После нелокального присваивания: нелокальный спам
После глобального присваивания: нелокальный спам
В глобальной области видимости: глобальный спам&lt;/syntaxhighlight&gt;

Заметьте, что локальное присваивание (работающее по умолчанию) не заменяет глобальную привязку на связывание из &lt;code&gt;scope_test&lt;/code&gt;. Нелокальное присваивание заменило глобальную привязку на связывание из &lt;code&gt;scope_test&lt;/code&gt;, а глобальное присваивание заменило привязку на связывание на уровне модуля.

Можно увидеть, что до глобального присваивания у переменной &lt;code&gt;spam&lt;/code&gt; не было предшествующих связываний.

=== Первый взгляд на классы ===

В описании классов представлено немного нового синтаксиса, три новых типа объектов&lt;ref&gt;''(Прим. перев.)'' ''Class Objects'', ''Instance Objects'', ''Method Objects'' {{ref-en}} — объекты классов, объекты экземпляров, объекты методов; по тексту перевода, хоть и могут восприниматься непривычно, используются термины «объекты-классы», «объекты-экземпляры» и «объекты-методы» — ввиду того, что словосочетание «объект класса» может обозначать и принадлежность объекта классу&lt;/ref&gt; и некоторое количество новой семантики.

==== Синтаксис определения класса ====

Простейшая форма определения класса выглядит так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class ИмяКласса:
    &lt;оператор-1&gt;
    .
    .
    .
    &lt;оператор-N&gt;
&lt;/syntaxhighlight&gt;

Определения классов, как и определения функций (операторы &lt;code&gt;def&lt;/code&gt;), должны быть исполнены для того, чтобы определить действие. (Вы можете, предположим, поместить определение класса в ветку оператора &lt;code&gt;if&lt;/code&gt; или внутрь функции.)

На практике, внутри определения класса обычно помещаются определения функций, но позволено использовать и другие операторы — и иногда с пользой — как мы увидим позже. Определения функций внутри класса имеют особенную форму списка аргументов, в связи с соглашениями по вызову методов — опять же, это будет рассмотрено ниже.

При вводе определения класса создаётся новое пространство имён, которое и используется в качестве локальной области видимости. Таким образом, все присваивания локальным переменным происходят в этом новом пространстве имён. В частности, определения функций связываются здесь с именами новых функций.

При успешном окончании парсинга определения класса (по достижении конца определения), создаётся ''объект-класс'' (&lt;tt&gt;class object&lt;/tt&gt;). По существу, это обёртка вокруг содержимого пространства имён, созданного во время определения класса; подробнее объекты классов мы изучим в следующем разделе. Оригинальная локальная область видимости (та, которая действовала в последний момент перед вводом определения класса) восстанавливается, а объект-класс тут же связывается в ней с именем класса, указанном в заголовке определения класса (в примере — ''&lt;code&gt;ИмяКласса&lt;/code&gt;'').

==== Объекты-классы ====

Объекты-классы поддерживают два вида операций: ссылки на атрибуты и создание экземпляра.

''Ссылки на атрибуты'' (&lt;tt&gt;Attribute references&lt;/tt&gt;) используют стандартный синтаксис, использующийся для всех ссылок на атрибуты в Python: &lt;code&gt;''объект''.''имя''&lt;/code&gt;. Корректными именами атрибутов являются все имена, которые находились в пространстве имён класса при создании объекта-класса. Таким образом, если определение класса выглядело так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class MyClass:
    &quot;&quot;&quot;Простой пример класса&quot;&quot;&quot;
    i = 12345
    def f(self):
        return 'привет мир'&lt;/syntaxhighlight&gt;

то &lt;code&gt;MyClass.i&lt;/code&gt; и &lt;code&gt;MyClass.f&lt;/code&gt; являются корректными ссылками на атрибуты, возвращающими целое и ''объект-функцию'' (&lt;tt&gt;function object&lt;/tt&gt;) соответственно. Атрибутам класса можно присваивать значение, так что вы можете изменить значение &lt;code&gt;MyClass.i&lt;/code&gt; через присваивание. &lt;code&gt;__doc__&lt;/code&gt; также является корректным атрибутом, возвращающим строку документации, принадлежащей классу: &lt;code&gt;&quot;Простой пример класса&quot;&lt;/code&gt;.

Создание экземпляра класса использует синтаксис вызова функции. Просто представьте, что объект-класс — это непараметризированная функция, которая возвращает новый экземпляр класса. Например (предполагая класс, приведённый выше):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;x = MyClass()&lt;/syntaxhighlight&gt;

создаёт новый экземпляр класса и присваивает этот объект локальной переменной &lt;code&gt;x&lt;/code&gt;.

Операция ''создания экземпляра'' (&lt;tt&gt;instantiation&lt;/tt&gt;) создаёт объект данного класса. Большая часть классов предпочитает создавать экземпляры, имеющие определённое начальное состояние. Для этого класс может определять специальный метод под именем &lt;code&gt;__init__()&lt;/code&gt;, например так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def __init__(self):
    self.data = []&lt;/syntaxhighlight&gt;

Когда в классе определён метод &lt;code&gt;__init__()&lt;/code&gt;, при создании экземпляра автоматически вызывается &lt;code&gt;__init__()&lt;/code&gt; нового, только что созданного объекта. Так, в этом примере, новый инициализированный экземпляр может быть получен за счёт выполнения кода:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;x = MyClass()&lt;/syntaxhighlight&gt;

Конечно же, для большей гибкости, метод &lt;code&gt;__init__()&lt;/code&gt; может иметь параметры. В этом случае аргументы, переданные оператору создания экземпляра класса, передаются методу &lt;code&gt;__init__()&lt;/code&gt;. Например,

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; class Complex:
...     def __init__(self, realpart, imagpart):
...         self.r = realpart
...         self.i = imagpart
...
&gt;&gt;&gt; x = Complex(3.0, -4.5)
&gt;&gt;&gt; x.r, x.i
(3.0, -4.5)&lt;/syntaxhighlight&gt;

==== Объекты-экземпляры ====

Теперь, что же мы можем делать с объектами-экземплярами? Единственные операции, доступные объектам-экземплярам — это ссылки на атрибуты. Есть два типа корректных имён атрибутов — это атрибуты-данные и методы.

''Атрибуты-данные'' (&lt;tt&gt;data attributes&lt;/tt&gt;) аналогичны «переменным экземпляров» в Smalltalk и «членам-данным» в C++. Атрибуты-данные не нужно описывать: как и переменные, они начинают существование в момент первого присваивания. Например, если &lt;code&gt;x&lt;/code&gt; — экземпляр созданного выше &lt;code&gt;MyClass&lt;/code&gt;, следующий отрывок кода выведет значение &lt;code&gt;16&lt;/code&gt;, не вызвав ошибок:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;x.counter = 1
while x.counter &lt; 10:
    x.counter = x.counter * 2
print(x.counter)
del x.counter&lt;/syntaxhighlight&gt;

Другой тип ссылок на атрибуты экземпляра — это ''метод'' (&lt;tt&gt;method&lt;/tt&gt;). Метод — это функция, «принадлежащая» объекту. (В Python термин не уникален для экземпляров класса: другие объекты также могут иметь методы. Например, объекты-списки имеют методы &lt;code&gt;append&lt;/code&gt;, &lt;code&gt;insert&lt;/code&gt;, &lt;code&gt;remove&lt;/code&gt;, &lt;code&gt;sort&lt;/code&gt; и т. п. Тем не менее, ниже под термином «метод» мы будем понимать только методы объектов-экземпляров классов, пока отдельно не будет указано иное.)

Корректные имена методов объектов-экземпляров зависят от их класса. По определению, все атрибуты класса, являющиеся объектами-функциями, описывают соответствующие методы его экземпляров. Так, в нашем примере, &lt;code&gt;x.f&lt;/code&gt; является корректной ссылкой на метод, а &lt;code&gt;x.i&lt;/code&gt; ей не является, поскольку не является и &lt;code&gt;MyClass.i&lt;/code&gt;. Но при этом &lt;code&gt;x.f&lt;/code&gt; — это не то же самое, что &lt;code&gt;MyClass.f&lt;/code&gt;: это объект-метод, а не объект-функция.

==== Объекты-методы ====

Обычно, метод вызывают сразу после его связывания [с функцией]:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;x.f()&lt;/syntaxhighlight&gt;

На примере &lt;code&gt;MyClass&lt;/code&gt; такой код возвратит строку &lt;code&gt;'привет мир'&lt;/code&gt;. Однако, не обязательно вызывать метод так уж сразу: &lt;code&gt;x.f&lt;/code&gt; — это объект-метод, он может быть отложен и вызван когда-либо позже. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;xf = x.f
while True:
    print(xf())&lt;/syntaxhighlight&gt;

будет печатать &lt;code&gt;'привет мир'&lt;/code&gt; до конца времён.

Что конкретно происходит при вызове метода? Вы, возможно, заметили, что &lt;code&gt;x.f()&lt;/code&gt; выше был вызван без аргументов, хотя в описании функции &lt;code&gt;f&lt;/code&gt; аргумент был указан. Что же случилось с аргументом? Несомненно, Python порождает исключение когда функция, требующая присутствия аргумента, вызвана без единого — даже, если он на самом деле не используется…

Теперь вы, возможно, догадались: отличительная особенность методов состоит в том, что в качестве первого аргумента функции передаётся объект. В нашем примере вызов &lt;code&gt;x.f()&lt;/code&gt; полностью эквивалентен вызову &lt;code&gt;MyClass.f(x)&lt;/code&gt;. В общем случае, вызов метода со списком из ''n'' аргументов эквивалентен вызову соответствующей функции со списком аргументов, созданным за счёт вставки объекта, вызвавшего метод, перед первым аргументом.

Если вы всё ещё не поняли, как работают методы, взгляд на реализацию возможно прояснит происходящее. Когда атрибут экземпляра ссылается на что-либо, не являющееся атрибутом-данными, производится поиск по классу. Если имя указывает корректный атрибут класса, являющийся объектом-функцией, создаётся метод: через упаковку (указателя на) объекта-экземпляра и найденного объекта-функции в абстрактный объект, получается объект-метод. Когда объект-метод вызывается со списком аргументов, он снова распаковывается и новый список аргументов конструируется из объекта-экземпляра и оригинального списка аргументов, и затем уже с новым списком аргументов вызывается объект-функция.

=== Различные замечания ===

Атрибуты-данные переопределяют атрибуты-методы с тем же именем; для того, что обезопасить себя от случайных конфликтов имён, которые могут привести к трудно-обнаруживаемым ошибкам в больших программах, разумно использовать какое-нибудь соглашение, которое могло бы уменьшить шансы возникновения конфликтов. Возможные соглашения включают в себя: написание имён методов строчными буквами, предварение имени атрибутов-данных некоторой короткой уникальной строкой (предположим, лишь символом подчёркивания («&lt;code&gt;_&lt;/code&gt;»)), или использование глаголов для именования методов и существительных для именования данных.

Методы могут ссылаться на атрибуты-данные также как и обычные пользователи («клиенты») объекта. Другими словами, классы не подходят для разработки чистых абстрактных типов данных. Фактически же в Python нет ничего, вынуждающего вас скрывать данные: сокрытие основано на соглашении между программистами. (С другой стороны, реализация Python, написанная на C, может полностью скрывать детали разработки и, если нужно, контролировать доступ к объекту, это можно делать в расширениях для Python, написанных на C.)

Клиенты должны использовать атрибуты-данные с осторожностью, так как иначе они могут нарушить инварианты, подразумеваемые методами класса при использовании атрибутов-данных. Заметьте, что обычно клиенты могут добавлять собственные атрибуты-данные к объектам-экземплярам, не нарушая работы методов, если не происходит конфликтов имён. Опять же, соглашение об именовании может избавить вас от головной боли и в этих случаях.

''(Прим. перев.)'' Автором здесь не упомянут механизм свойств (&lt;tt&gt;property&lt;/tt&gt;). Свойство синтаксически является атрибутом-данным, но за кулисами с ним могут быть связаны отдельные методы для чтения, записи и удаления. Документация к функции-декоратору &lt;code&gt;property&lt;/code&gt; хорошо проясняет суть дела:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print(property.__doc__)
property(fget=None, fset=None, fdel=None, doc=None) -&gt; property attribute

fget - функция для чтения, fset - для записи, fdel - для удаления атрибута.
Типичный пример использования для управляемого атрибута x:
class C(object):
    def getx(self): return self._x
    def setx(self, value): self._x = value
    def delx(self): del self._x
    x = property(getx, setx, delx, &quot;Я - свойство 'x'.&quot;)

Декораторы упрощают определение новых свойств и изменение существующих:
class C(object):
    @property
    def x(self): return self._x
    @x.setter
    def x(self, value): self._x = value
    @x.deleter
    def x(self): del self._x
&lt;/syntaxhighlight&gt;
''(Конец прим.)''

У методов нет краткой записи для ссылок изнутри на атрибуты-данные (и другие методы!). Я нахожу, что это и вправду повышает читабельность методов: нет шанса спутать локальные переменные и переменные экземпляров при просмотре тела метода.

Обычно, первый аргумент метода называется &lt;code&gt;self&lt;/code&gt;. Это не более чем соглашение: имя &lt;code&gt;self&lt;/code&gt; не имеет абсолютно никакого специального смысла для языка Python. (Однако, обратите внимание, что если вы не следуете соглашениям, ваш код может стать менее читабелен для других программистов; и также, потенциально, программа навигации по классам может опираться на такие соглашения.)

Любой объект-функция, являющийся атрибутом класса, определяет метод для экземпляров этого класса. Не так важно, чтобы текст определения функции был заключен в определение класса: присваивание объекта-функции локальной переменной класса также работает неплохо. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;# Функция, определённая вне класса
def f1(self, x, y):
    return min(x, x+y)

class C:
    f = f1
    def g(self):
        return 'привет мир'
    h = g&lt;/syntaxhighlight&gt;

Теперь &lt;code&gt;f&lt;/code&gt;, &lt;code&gt;g&lt;/code&gt; и &lt;code&gt;h&lt;/code&gt; — все являются атрибутами класса &lt;code&gt;C&lt;/code&gt;, ссылающимися на объекты-функции, и следовательно, все они являются методами экземпляров &lt;code&gt;C&lt;/code&gt; — &lt;code&gt;h&lt;/code&gt; становится полностью эквивалентен &lt;code&gt;g&lt;/code&gt;. Заметьте, что такая практика обычно лишь запутывает читателя программы.

Методы могут вызывать другие методы за счёт использования атрибутов-методов аргумента &lt;code&gt;self&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class Bag:
    def __init__(self):
        self.data = []
    def add(self, x):
        self.data.append(x)
    def addtwice(self, x):
        self.add(x)
        self.add(x)&lt;/syntaxhighlight&gt;

Методы могут ссылаться на глобальные имена таким же образом, как и обычные функции. Глобальная область видимости, связанная с методом — это модуль, содержащий определение класса. (Сам класс никогда не используется в качестве глобальной области видимости!) В то время, как одни редко находят причины для использования глобальных данных в методах, существует множество разумных причин использовать глобальную область видимости: для примера, функции и модули, импортированные в глобальную область видимости, могут использоваться в методах так же, как в функциях и классах, в ней определённых. Обычно класс, содержащий метод, сам определён в этой глобальной области видимости, и в следующем разделе мы найдём пару хороших причин, почему методу может быть необходимо ссылаться на собственный класс!

=== Наследование ===

Конечно же, не поддерживай «класс» наследование, не стоило бы называть его «классом». Синтаксис производного класса выглядит так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class ИмяПроизводногоКласса(ИмяБазовогоКласса):
    &lt;оператор-1&gt;
    .
    .
    .
    &lt;оператор-N&gt;&lt;/syntaxhighlight&gt;

Имя ''&lt;code&gt;ИмяБазовогоКласса&lt;/code&gt;'' должно быть определено в области видимости, содержащей определение производного класса. Вместо имени базового класса также позволяется использовать другие выражения. Это может быть полезно, например, когда базовый класс определён в другом модуле:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class ИмяПроизводногоКласса(имямодуля.ИмяБазовогоКласса):&lt;/syntaxhighlight&gt;

Использование определения производного класса проходит таким же образом, как и базового. Базовый класс полностью сохраняется по завершению конструирования объекта-класса. Такой метод используется для разрешения ссылок на атрибуты&lt;ref&gt;''(Прим. перев.)'' ''Resolving attribute references'' {ref-en} — разрешение (поиск значений) ссылок на атрибуты&lt;/ref&gt;: если запрошенный атрибут не был найден в самом классе, поиск продолжается в базовом классе. Правило применяется рекурсивно, если базовый класс сам является производным от некоторого другого класса.

В создании экземпляров производных классов нет ничего особенного: &lt;code&gt;ИмяПроизводногоКласса()&lt;/code&gt; создаёт новый экземпляр класса. Ссылки на методы разрешаются следующим образом: производится поиск соответствующего атрибута класса (спускаясь вниз по цепочке базовых классов, если необходимо) и ссылка на метод считается корректной, если она порождает объект-функцию.

Производные классы могут перегружать методы своих базовых классов. Поскольку у методов нет особых привилегий при вызове других методов того же объекта, метод базового класса, вызывающий другой метод, определённый в этом же классе, может вызвать перегруженный метод производного класса. (Для программистов на C++: все методы в Python фактически виртуальны.)

При перегрузке метода в производном классе возможна не только замена действия метода базового класса с тем же именем, но и его расширение. Существует простой способ вызвать метод базового класса прямым образом: просто вызовите «&lt;code&gt;ИмяБазовогоКласса.имяметода(self, аргументы)&lt;/code&gt;». Такой способ будет неожиданно полезным и для клиентов. (Обратите внимание, что он работает только если базовый класс определён и импортирован прямо в глобальную область видимости.)

В языке Python есть функции, которые работают с наследованием:

* Используйте &lt;code&gt;isinstance()&lt;/code&gt; чтобы проверить тип объекта: &lt;code&gt;isinstance(obj, int)&lt;/code&gt; возвратит &lt;code&gt;True&lt;/code&gt; только если &lt;code&gt;obj.__class__&lt;/code&gt; является &lt;code&gt;int&lt;/code&gt; или некоторым классом, наследованным от &lt;code&gt;int&lt;/code&gt;.
* Используйте &lt;code&gt;issubclass()&lt;/code&gt; чтобы проверить наследственность класса: &lt;code&gt;issubclass(bool, int)&lt;/code&gt; возвратит &lt;code&gt;True&lt;/code&gt;, поскольку класс &lt;code&gt;bool&lt;/code&gt; является наследником (&lt;tt&gt;subclass&lt;/tt&gt;) &lt;code&gt;int&lt;/code&gt;. Однако, &lt;code&gt;issubclass(float, int)&lt;/code&gt; возвратит &lt;code&gt;False&lt;/code&gt;, поскольку класс &lt;code&gt;float&lt;/code&gt; не является наследником &lt;code&gt;int&lt;/code&gt;.

==== Множественное наследование ====

Python также поддерживает форму ''множественного наследования'' (&lt;tt&gt;multiple inheritance&lt;/tt&gt;). Определение класса с несколькими базовыми классами будет выглядеть так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class ИмяПроизводногоКласса(Базовый1, Базовый2, Базовый3):
    &lt;оператор-1&gt;
    .
    .
    .
    &lt;оператор-N&gt;&lt;/syntaxhighlight&gt;

В простейших случаях и для большинства задач, вы можете представлять себе поиск атрибутов, наследованных от родительского класса в виде «сперва вглубь», затем «слева-направо». Таким образом, если атрибут не найден в ''&lt;code&gt;ИмяПроизводногоКласса&lt;/code&gt;'', его поиск выполняется в ''&lt;code&gt;Базовом1&lt;/code&gt;'', затем (рекурсивно) в базовых классах ''&lt;code&gt;Базового1&lt;/code&gt;'' и только если он там не найден, поиск перейдёт в ''&lt;code&gt;Базовый2&lt;/code&gt;'' и так далее.

На самом деле всё немного сложнее. Порядок разрешения методов&lt;ref&gt;''(Прим. перев.)'' другими словами — поиска корректной привязки для метода&lt;/ref&gt; (&lt;tt&gt;method resolution order&lt;/tt&gt;) меняется динамически, чтобы обеспечить возможность сотрудничающих вызовов &lt;code&gt;super()&lt;/code&gt;. Этот способ известен в некоторых других языках с поддержкой множественного наследования как «вызов-следующего-метода» («&lt;tt&gt;call-next-method&lt;/tt&gt;») и имеет больше возможностей, чем вызов родительского метода в языках с единичным наследованием.

Динамическое упорядочивание (&lt;tt&gt;dynamic ordering&lt;/tt&gt;) имеет важность, поскольку все вариации множественного наследования проявляют в себе эффект ромбовых отношений (когда как минимум один родительский класс может быть доступен различными путями из низшего в иерархии класса). Например, все классы наследуются от &lt;code&gt;object&lt;/code&gt;, так что множественное наследование в любом виде предоставляет более одного пути для того, чтобы достичь &lt;code&gt;object&lt;/code&gt;. Чтобы защитить базовые классы от двойных и более запросов, динамический алгоритм «выпрямляет» (&lt;tt&gt;linearizes&lt;/tt&gt;) порядок поиска таким образом, что тот сохраняет указанный слева-направо порядок для каждого класса, который вызывает каждый родительский класс только единожды и является монотонным (значит, класс можно сделать наследником, не взаимодействуя с порядком предшествования его родителей). Обобщённые вместе, эти свойства позволяют разрабатывать надёжные и расширяемые классы, используя множественное наследование. С подробностями можно ознакомиться по этой ссылке: http://www.python.org/download/releases/2.3/mro/ ([[Python — Порядок разрешения методов|перевод]]).

=== Приватные переменные ===

В Python имеется ограниченная поддержка идентификаторов, приватных для класса. Любой идентификатор в форме &lt;code&gt;__spam&lt;/code&gt; (как минимум два предшествующих символа подчёркивания, как максимум один завершающий) заменяется дословно на &lt;code&gt;_classname__spam&lt;/code&gt;, где &lt;code&gt;classname&lt;/code&gt; — текущее имя класса, лишённое предшествующих символов подчёркивания. Это ''искажение'' (&lt;tt&gt;mangling&lt;/tt&gt;) производится без оглядки на синтаксическую позицию идентификатора, поэтому может использоваться для определения переменных, приватных для класса экземпляров, переменных класса, методов, переменных в глобальной области видимости (&lt;tt&gt;globals&lt;/tt&gt;), и даже переменных, использующихся в экземплярах, приватных для этого класса на основе экземпляров ''других'' классов. Имя может быть обрезано, если его длина превышает 255 символов. Вне классов, или когда имя состоит из одних символов подчёркивания, искажения не происходит.

Предназначение искажения имён состоит в том, чтобы дать классам лёгкую возможность определить «приватные» переменные экземпляров и методы, не беспокоясь о переменных экземпляров, определённых в производных классах, и о забивании кодом вне класса переменных экземпляров. Обратите внимание, что правила искажения имён разработаны, в основном, чтобы исключить неприятные случайности — решительная душа всё ещё может получить доступ или изменить переменные, предполагавшиеся приватными. В некотором особом окружении, таком как отладчик, это может оказаться полезным — и это единственная причина, по которой лазейка не закрыта. (Внимание: наследование класса с таким же именем как и у базового делает возможным использование приватных переменных базового класса.)

Заметьте, что код, переданный в &lt;code&gt;exec()&lt;/code&gt; или &lt;code&gt;eval()&lt;/code&gt;, не предполагает в качестве текущего имени класса имя класса, порождающего вызов — так же, как и в случае эффекта с оператором &lt;code&gt;global&lt;/code&gt; — эффекта, который также ограничен для всего побайтно-компилирующегося кода. И, такое же ограничение применимо для функций &lt;code&gt;getattr()&lt;/code&gt;, &lt;code&gt;setattr()&lt;/code&gt; и &lt;code&gt;delattr()&lt;/code&gt;, и также для прямой ссылки на &lt;code&gt;__dict__&lt;/code&gt;.

=== Всякая всячина ===

Иногда бывает полезен тип данных, похожий на &lt;code&gt;record&lt;/code&gt; из языка Pascal или &lt;code&gt;struct&lt;/code&gt; из языка C, например, для хранения нескольких поименованных элементов данных. Для этой цели подойдет даже пустое определение класса&lt;ref&gt;''(Прим. перев.)'':&lt;syntaxhighlight lang=&quot;python&quot;&gt;class Рабочий:
    pass

джон = Рабочий() # Создать пустую запись о рабочем

# Заполнить поля записи
джон.имя = 'Джон До'
джон.отдел = 'компьютерная лаборатория'
джон.зарплата = 1000&lt;/syntaxhighlight&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class Employee:
    pass

john = Employee() # Создать пустую запись о рабочем

# Заполнить поля записи
john.name = 'John Doe'
john.dept = 'computer lab'
john.salary = 1000&lt;/syntaxhighlight&gt;

Фрагменту кода на Python, требующему на входе некоторого абстрактного типа данных, можно дать экземпляр, эмулирующий методы этого типа данных. Например, если имеется функция, умеющая форматировать данные из файлового объекта, то можно определить класс с методами &lt;code&gt;read()&lt;/code&gt; и &lt;code&gt;readline()&lt;/code&gt; (работающие с данными, скажем, из строкового буфера) и передать ей экземпляр этого класса в качестве аргумента.

Объекты-методы экземпляров также имеют атрибуты: &lt;code&gt;m.__self__&lt;/code&gt; — исходный объект-экземпляр с методом &lt;code&gt;m()&lt;/code&gt;, а &lt;code&gt;m.__func__&lt;/code&gt; — объект-функция, соответствующий методу.

=== Исключения — тоже классы ===

Исключения, определённые пользователем, могут быть также отождествлены с классами. При использовании этого механизма становится возможным создавать расширяемые иерархии исключений.

Оператор &lt;code&gt;raise&lt;/code&gt; имеет следующие (синтаксически) правильные формы:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;raise Класс

raise Экземпляр&lt;/syntaxhighlight&gt;

В первой форме, ''&lt;code&gt;Класс&lt;/code&gt;'' должен быть экземпляром типа или класса, производного от него. Первая форма является краткой записью следующего кода:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;raise Class()&lt;/syntaxhighlight&gt;

Класс в блоке &lt;code&gt;except&lt;/code&gt; является сопоставимым с исключением, если является этим же классом или самим по себе базовым классом (никаких других способов обхода — описанный в блоке &lt;code&gt;except&lt;/code&gt; производный класс не сопоставим с базовым). Например, следующий код выведет B, C, D в этом порядке:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class B(Exception):
    pass
class C(B):
    pass
class D(C):
    pass

for c in [B, C, D]:
    try:
        raise c()
    except D:
        print(&quot;D&quot;)
    except C:
        print(&quot;C&quot;)
    except B:
        print(&quot;B&quot;)&lt;/syntaxhighlight&gt;

Обратите внимание, что если бы блоки &lt;code&gt;except&lt;/code&gt; шли в обратном порядке (начиная с «&lt;code&gt;except B&lt;/code&gt;»), код вывел бы B, B, B — сработал бы первый совпадающий блок &lt;code&gt;except&lt;/code&gt;.

При выводе сообщения об ошибке о необработанном исключении, выводится класс исключения, затем двоеточие и пробел, и наконец экземпляр, приведённый к строке за счёт встроенной функции &lt;code&gt;str()&lt;/code&gt;.

=== Итераторы ===

К этому моменту вы, возможно, заметили, что используя оператор &lt;code&gt;for&lt;/code&gt; можно организовать цикл по большинству объектов-контейнеров:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;for element in [1, 2, 3]:
    print(element)
for element in (1, 2, 3):
    print(element)
for key in {'один':1, 'два':2}:
    print(key)
for char in &quot;123&quot;:
    print(char)
for line in open(&quot;myfile.txt&quot;):
    print(line)&lt;/syntaxhighlight&gt;

Такой стиль доступа к элементам прост, лаконичен и удобен. Использованием ''итераторов'' (&lt;tt&gt;iterators&lt;/tt&gt;) пропитан язык Python, и это его выделяет среди других. Негласно, оператор &lt;code&gt;for&lt;/code&gt; вызывает метод &lt;code&gt;iter()&lt;/code&gt; объекта-контейнера. Функция возвращает объект итератора, который определяет метод &lt;code&gt;__next__()&lt;/code&gt;, который по очереди получает доступ к элементам в контейнере, по одному за раз. Если больше не остаётся элементов, метод &lt;code&gt;__next__()&lt;/code&gt; порождает исключение &lt;code&gt;StopIteration&lt;/code&gt;, которое сообщает оператору &lt;code&gt;for&lt;/code&gt; о необходимости завершения прохода. Вы можете вызывать метод &lt;code&gt;__next__()&lt;/code&gt; посредством встроенной функции &lt;code&gt;next()&lt;/code&gt;; следующий пример показывает, как это работает:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; s = 'абв'
&gt;&gt;&gt; it = iter(s)
&gt;&gt;&gt; it
&lt;iterator object at 0x00A1DB50&gt;
&gt;&gt;&gt; next(it)
'а'
&gt;&gt;&gt; next(it)
'б'
&gt;&gt;&gt; next(it)
'в'
&gt;&gt;&gt; next(it)

Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
    next(it)
StopIteration&lt;/syntaxhighlight&gt;

Ознакомившись с механизмами, скрытыми за протоколом итераторов, легко добавить возможность итерирования к вашим классам. Определите метод &lt;code&gt;__iter__()&lt;/code&gt;, который возвращает объект с методом &lt;code&gt;next()&lt;/code&gt;. Если класс определяет и метод &lt;code&gt;next()&lt;/code&gt;, тогда &lt;code&gt;__iter__()&lt;/code&gt; может просто возвращать &lt;code&gt;self&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class Reverse:
    &quot;Итератор по последовательности в обратном направлении&quot;
    def __init__(self, data):
        self.data = data
        self.index = len(data)
    def __iter__(self):
        return self
    def __next__(self):
        if self.index == 0:
            raise StopIteration
        self.index = self.index - 1
        return self.data[self.index]

&gt;&gt;&gt; for char in Reverse('спам'):
...     print(char)
...
м
а
п
с&lt;/syntaxhighlight&gt;

=== Генераторы ===

''Генераторы'' (&lt;tt&gt;generators&lt;/tt&gt;) — простой и мощный инструмент для создания итераторов. Они записываются как обычная функция, но где бы им ни было необходимо вернуть данные, используется оператор &lt;code&gt;yield&lt;/code&gt;. Каждый раз, когда над ним вызывается &lt;code&gt;__next__()&lt;/code&gt;, генератор возвращается к месту, где он был оставлен (он запоминает все значения данных, а также какой оператор был выполнен последним). Пример показывает, что создание генераторов может быть тривиально простым:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def reverse(data):
    for index in range(len(data)-1, -1, -1):
        yield data[index]
	
&gt;&gt;&gt; for char in reverse('гольф'):
...     print(char)
...
ф
ь
л
о
г&lt;/syntaxhighlight&gt;

Всё, что можно сделать с использованием генераторов, может быть сделано с использованием основанных на итераторах классов, как описано в предыдущем разделе. Благодаря автоматическому созданию методов &lt;code&gt;__iter__()&lt;/code&gt; и &lt;code&gt;next()&lt;/code&gt; генераторы так компактны.

Другая важная особенность состоит в том, что между вызовами сохраняются локальные переменные и ''состояние выполнения'' (&lt;tt&gt;execution state&lt;/tt&gt;). Это позволяет конструкциям функций быть проще, а получению переменных экземпляров быть намного легче, нежели с использованием &lt;code&gt;self.index&lt;/code&gt; и &lt;code&gt;self.data&lt;/code&gt;.

В дополнение к автоматическому созданию методов и сохранению состояния, когда генераторы заканчивают своё действие, они автоматически порождают исключение &lt;code&gt;StopIteration&lt;/code&gt;. В комбинации, эти особенности позволяют легко создавать итераторы не прилагая усилий больших, чем нужно для написания обычной функции.

=== Выражения-генераторы ===

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

Примеры&lt;ref&gt;''(Прим. перев.)'':&lt;br /&gt;
&lt;br /&gt;
&lt;code&gt;&gt;&gt;&gt; ''сумма''(i*i '''для''' i '''в''' ''диапазон''(10))                 # сумма квадратов&lt;br/&gt;
285&lt;br/&gt;
&lt;br/&gt;
&gt;&gt;&gt; вектор_а = [10, 20, 30]&lt;br/&gt;
&gt;&gt;&gt; вектор_б = [7, 5, 3]&lt;br/&gt;
&gt;&gt;&gt; ''сумма''(x*y '''для''' x,y '''в''' ''зип''(вектор_а, вектор_б))         # скалярное произведение&lt;br/&gt;
260&lt;br/&gt;
&lt;br/&gt;
&gt;&gt;&gt; '''из''' матем '''импорт''' пи, ''синус''&lt;br/&gt;
&gt;&gt;&gt; таблица_синусов = {x:  ''синус''(x*пи/180)) '''для''' x '''в''' ''диапазон''(0, 91)}&lt;br/&gt;
&lt;br/&gt;
&gt;&gt;&gt; уникальные_слова = ''набор''(слово&amp;nbsp;&amp;nbsp;'''для''' строка '''в''' страница&amp;nbsp;&amp;nbsp;'''для''' слово '''в''' строка.''разбить''())&lt;br/&gt;
&lt;br/&gt;
&gt;&gt;&gt; выпускники = ''макс''((студент.ср_балл, студент.имя) '''для''' студент '''в''' окончившие)&lt;br/&gt;
&lt;br/&gt;
&gt;&gt;&gt; данные = 'гольф'&lt;br/&gt;
&gt;&gt;&gt; ''список''(данные[i] '''для''' i '''в''' ''диапазон''(''длина''(данные)-1, -1, -1))&lt;br/&gt;
['ф', 'ь', 'л', 'о', 'г']&lt;/code&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; sum(i*i for i in range(10))                 # сумма квадратов
285

&gt;&gt;&gt; xvec = [10, 20, 30]
&gt;&gt;&gt; yvec = [7, 5, 3]
&gt;&gt;&gt; sum(x*y for x,y in zip(xvec, yvec))         # скалярное произведение
260

&gt;&gt;&gt; from math import sin, radians
&gt;&gt;&gt; sine_table = {x: sin(radians(x)) for x in range(0, 91)}

&gt;&gt;&gt; unique_words = set(word  for line in page  for word in line.split())

&gt;&gt;&gt; valedictorian = max((student.gpa, student.name) for student in graduates)

&gt;&gt;&gt; data = 'golf'
&gt;&gt;&gt; list(data[i] for i in range(len(data)-1, -1, -1))
['f', 'l', 'o', 'g']&lt;/syntaxhighlight&gt;

== Краткий обзор стандартной библиотеки ==

=== Взаимодействие с операционной системой ===

Модуль &lt;tt&gt;os&lt;/tt&gt; предоставляет десятки функций для взаимодействия с операционной системой.
&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import os
&gt;&gt;&gt; os.getcwd()                     # возвращает путь к текущему каталогу
'C:\\Python31'
&gt;&gt;&gt; os.system('dir *.txt')          # выполнить указанную команду ОС
...список текстовых файлов, выведенных командой...
0
&gt;&gt;&gt; os.chdir('/server/accesslogs')  # сменить текущий каталог
&lt;/syntaxhighlight&gt;

Лучше всего применять &lt;code&gt;import os&lt;/code&gt; вместо &lt;code&gt;from os import *&lt;/code&gt;. Это предохранит встроенную функцию &lt;code&gt;open()&lt;/code&gt; от замещения функцией &lt;code&gt;os.open()&lt;/code&gt;, имеющей несколько иное назначение.

В интерактивном режиме встроенные функции &lt;code&gt;dir()&lt;/code&gt; и &lt;code&gt;help()&lt;/code&gt; помогут разобраться с большими модулями вроде &lt;tt&gt;os&lt;/tt&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import os
&gt;&gt;&gt; dir(os)
...список всех атрибутов модуля...
&gt;&gt;&gt; help(os)
...страница руководства по модулю на основе строк документации...
&lt;/syntaxhighlight&gt;

Для управления файлами и каталогами удобный высокоуровневый интерфейс предоставляет модуль &lt;tt&gt;shutil&lt;/tt&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import shutil
&gt;&gt;&gt; shutil.copyfile('data.db', 'archive.db')         # копировать файл
&gt;&gt;&gt; shutil.move('/build/executables', 'installdir')  # переместить каталог
&lt;/syntaxhighlight&gt;

=== Wildcard-шаблоны для имён файлов ===

Модуль &lt;tt&gt;glob&lt;/tt&gt; предоставляет функцию для получения списка файлов на основе заданного шаблона:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import glob
&gt;&gt;&gt; glob.glob('*.py')
['primes.py', 'random.py', 'quote.py']
&lt;/syntaxhighlight&gt;

=== Аргументы командной строки ===

Сценарии общего назначения часто нуждаются в аргументах командной строки. Эти аргументы хранятся в атрибуте &lt;tt&gt;argv&lt;/tt&gt; модуля &lt;tt&gt;sys&lt;/tt&gt; в виде списка. Например, при запуске &lt;code&gt;python demo.py one two three&lt;/code&gt; в командной строке шелла для сценария &lt;tt&gt;demo.py&lt;/tt&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import sys
print(sys.argv)
&lt;/syntaxhighlight&gt;

будет выведено &lt;code&gt;['demo.py', 'one', 'two', 'three']&lt;/code&gt;.

Модуль &lt;tt&gt;getopt&lt;/tt&gt; обрабатывает &lt;code&gt;sys.argv&lt;/code&gt;, используя соглашения функции &lt;code&gt;getopt()&lt;/code&gt; системы Unix.
Более мощную и гибкую обработку аргументов командной строки осуществляет модуль &lt;tt&gt;optparse&lt;/tt&gt;.

=== Стандартный вывод. Завершение сценария ===

Модуль &lt;tt&gt;sys&lt;/tt&gt; имеет атрибуты &lt;code&gt;stdin&lt;/code&gt;, &lt;code&gt;stdout&lt;/code&gt; и &lt;code&gt;stderr&lt;/code&gt; (для стандартного ввода, вывода и вывода ошибок соответственно). Последний может быть полезен для вывода предупреждений и сообщений об ошибках когда стандартный вывод перенаправлен&lt;ref&gt;''(Прим. перев.)'' разумеется, если стандартный вывод ошибок перенаправлен не был&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; sys.stderr.write('Внимание! Файл журнала не найден.\n')
Внимание! Файл журнала не найден.
34
&lt;/syntaxhighlight&gt;

Для завершения сценария можно использовать &lt;code&gt;sys.exit()&lt;/code&gt;.

=== Сравнение строк по шаблонам ===

Модуль &lt;tt&gt;re&lt;/tt&gt; предоставляет инструментарий для работы с регулярными выражениями для нетривиальной обработки текста. С помощью регулярных выражений можно создавать выразительные и оптимизированные решения для поиска и обработки строк.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import re
&gt;&gt;&gt; re.findall(r'\bf[a-z]*', 'which foot or hand fell fastest')
['foot', 'fell', 'fastest']
&gt;&gt;&gt; re.sub(r'(\b[a-z]+) \1', r'\1', 'cat in the the hat')
'cat in the hat'
&lt;/syntaxhighlight&gt;

Когда требуются более простые возможности, методы строковых объектов предпочтительнее, так как их легче читать и отлаживать:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 'чай для двоих'.replace('для', 'на')
'чай на двоих'
&lt;/syntaxhighlight&gt;

=== Математические функции ===

Модуль &lt;tt&gt;math&lt;/tt&gt; предоставляет доступ к библиотеке языка C для функций над числами с плавающей запятой:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import math
&gt;&gt;&gt; math.cos(math.pi / 4)
0.70710678118654757
&gt;&gt;&gt; math.log(1024, 2)
10.0
&lt;/syntaxhighlight&gt;

С помощью модуля &lt;tt&gt;random&lt;/tt&gt; можно делать случайный выбор:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import random
&gt;&gt;&gt; random.choice(['яблоко', 'груша', 'банан'])
'яблоко'
&gt;&gt;&gt; random.sample(range(100), 10)   # выборка без повторений
[30, 83, 16, 4, 8, 81, 41, 50, 18, 33]
&gt;&gt;&gt; random.random()        # случайное число с плавающей запятой
0.17970987693706186
&gt;&gt;&gt; random.randrange(6)    # случайное целое из диапазона range(6)
4
&gt;&gt;&gt; random.sample([1, 2, 3, 4, 5],  3)  # случайные три элемента из списка
[4, 1, 5]

&lt;/syntaxhighlight&gt;
Проект SciPy &lt;http://scipy.org&gt; имеет много других модулей для численных расчётов.

=== Протоколы интернет ===

В стандартной библиотеке имеется целый набор модулей для различных сервисов и протоколов интернет. Наиболее употребимыми можно считать &lt;code&gt;urllib.request&lt;/code&gt; для получения данных по заданному адресу (URL) и &lt;code&gt;smtplib&lt;/code&gt; для отправки сообщений электронной почты:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from urllib.request import urlopen
&gt;&gt;&gt; for line in urlopen('http://tycho.usno.navy.mil/cgi-bin/timer.pl'):
...     if 'EST' in line or 'EDT' in line:  # временные зоны
...         print(line)

&lt;BR&gt;Nov. 25, 09:43:32 PM EST

&gt;&gt;&gt; import smtplib
&gt;&gt;&gt; server = smtplib.SMTP('localhost')
&gt;&gt;&gt; server.sendmail('soothsayer@example.org', 'jcaesar@example.org',
... &quot;&quot;&quot;To: jcaesar@example.org
... From: soothsayer@example.org
...
... Beware the Ides of March.
... &quot;&quot;&quot;)
&gt;&gt;&gt; server.quit()
&lt;/syntaxhighlight&gt;

Заметьте, что второй пример требует почтового сервера на той же машине.

=== Дата и время ===

Модуль &lt;code&gt;datetime&lt;/code&gt; предлагает классы для работы с датами и временем как в простых, так и сложных случаях. Кроме поддержки календарной арифметики, реализация обращает особенное внимание на эффективность вычисления составных частей для вывода и дальнейших манипуляций. Модуль также предлагает объекты с поддержкой временных зон.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;# даты можно легко составлять и выводить в требуемом формате
&gt;&gt;&gt; from datetime import date
&gt;&gt;&gt; now = date.today()
&gt;&gt;&gt; now
datetime.date(2009, 2, 3)
&gt;&gt;&gt; now.strftime(&quot;%d.%m.%Y&quot;)
'03.02.2009'

# даты поддерживают календарную арифметику
&gt;&gt;&gt; birthday = date(1964, 7, 31)
&gt;&gt;&gt; age = now - birthday
&gt;&gt;&gt; age.days
16258
&lt;/syntaxhighlight&gt;

=== Сжатие данных и архивы ===

Наиболее распространённые форматы сжатия и архивации напрямую поддерживаются модулями стандартной библиотеки: &lt;tt&gt;zlib&lt;/tt&gt;, &lt;tt&gt;gzip&lt;/tt&gt;, &lt;tt&gt;bz2&lt;/tt&gt;, &lt;tt&gt;zipfile&lt;/tt&gt; и &lt;tt&gt;tarfile&lt;/tt&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import zlib
&gt;&gt;&gt; s = &quot;Закрой замок на замок, чтобы замок не замок&quot;
&gt;&gt;&gt; len(bytes(s, &quot;utf-8&quot;))
78
&gt;&gt;&gt; t = zlib.compress(s)
&gt;&gt;&gt; len(t)
54
&gt;&gt;&gt; print(str(zlib.decompress(t), &quot;utf-8&quot;))
Закрой замок на замок, чтобы замок не замок
&gt;&gt;&gt; zlib.crc32(s)
2392363341
&lt;/syntaxhighlight&gt;

=== Измерение производительности ===

Некоторым пользователям Python интересно знать относительную производительность различных подходов к решению одной и той же проблемы. Python предлагает инструмент для немедленного ответа на эти вопросы.

Например, очень заманчиво использовать присваивание кортежей вместо традиционного подхода к замене значений переменных местами. Модуль &lt;code&gt;timeit&lt;/code&gt; быстро продемонстрирует незначительное превосходство кортежей:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from timeit import Timer
&gt;&gt;&gt; Timer('a, b = b, a', 'a=1; b=2').timeit()
0.15707302093505859
&gt;&gt;&gt; Timer('t=a; a=b; b=t', 'a=1; b=2').timeit()
0.19421601295471191
&lt;/syntaxhighlight&gt;

В отличие от высокого разрешения модуля &lt;code&gt;timeit&lt;/code&gt;, модули &lt;code&gt;profile&lt;/code&gt; и &lt;code&gt;pstats&lt;/code&gt; предлагают возможность обнаружить критические по времени участки в больших фрагментах кода.

=== Контроль качества ===

Один из подходов к разработке высококачественного программного обеспечения заключается в написании тестов для каждой функции при её разработке и регулярном запуске этих тестов во время всего процесса разработки.

Модуль &lt;code&gt;doctest&lt;/code&gt; имеет средства для просмотра модуля и проверки результатов тестов, заложенных в строках документации. Написание теста для функции заключается в копировании и вставке типичного вызова функции и ее результатов в строку документации. Это улучшает документацию, предоставляя пользователю реальный пример, а модуль &lt;code&gt;doctest&lt;/code&gt; проверяет, что код соответствует документации.


&lt;syntaxhighlight lang=&quot;python&quot;&gt;def average(values):
    &quot;&quot;&quot;Вычисляет среднее арифметическое списка чисел.

    &gt;&gt;&gt; print(average([20, 30, 70]))
    40.0
    &quot;&quot;&quot;
    return sum(values) / len(values)

import doctest
doctest.testmod()   # автоматически проверяет тесты в документации
&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;unittest&lt;/code&gt; не менее прост в использовании чем &lt;code&gt;doctest&lt;/code&gt;, но позволяет создавать более полный набор тестов, располагающийся в отдельном файле:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import unittest

class TestStatisticalFunctions(unittest.TestCase):

    def test_average(self):
        self.assertEqual(average([20, 30, 70]), 40.0)
        self.assertEqual(round(average([1, 5, 7]), 1), 4.3)
        self.assertRaises(ZeroDivisionError, average, [])
        self.assertRaises(TypeError, average, 20, 30, 70)

unittest.main() # Вызов из командной строки выполняет проверку всех тестов этого модуля

&lt;/syntaxhighlight&gt;

=== «Батарейки в комплекте» ===

Python руководствуется философией «батарейки в комплекте». Это можно проследить по сложным и устойчивым к ошибкам возможностям его пакетов побольше. Примеры:

* Модули &lt;code&gt;xmlrpc.client&lt;/code&gt; и &lt;code&gt;xmlrpc.server&lt;/code&gt; делают реализацию удалённых вызовов почти тривиальной задачей. Несмотря на названия, знания об обработке XML не требуются.

* Пакет &lt;code&gt;email&lt;/code&gt; — это библиотека для работы с сообщениями электронной почты, включая MIME и другие основанные на {{RFC|2822}} документы-сообщения. В отличие от &lt;code&gt;smtplib&lt;/code&gt; и &lt;code&gt;poplib&lt;/code&gt;, которые занимаются непосредственно отправкой и приёмом сообщений, пакет &lt;code&gt;email&lt;/code&gt; является полным набором инструментов для построения и декодирования сообщений сложной структуры (включая вложения) и для реализации интернетного кодирования и протокола заголовков.

* Пакеты &lt;code&gt;xml.dom&lt;/code&gt; и &lt;code&gt;xml.sax&lt;/code&gt; предоставляют ошибко-устойчивую поддержку парсинга XML — этого популярного формата для обмена данными. Аналогично, модуль &lt;code&gt;csv&lt;/code&gt; поддерживает чтение и запись в распространённом формате баз данных. Вместе эти модули серьёзно облегчают обмен данными между приложениями на Python и другими приложениями.

* Интернационализация поддерживается благодаря ряду модулей, включая &lt;code&gt;gettext&lt;/code&gt;, &lt;code&gt;locale&lt;/code&gt; и пакет &lt;code&gt;codecs&lt;/code&gt;.

== Второй краткий обзор стандартной библиотеки ==

=== Форматирование вывода ===

Модуль &lt;code&gt;reprlib&lt;/code&gt; предоставляет версию функции &lt;code&gt;repr()&lt;/code&gt;, настроенную на сокращённый вывод больших и многократно вложенных контейнеров:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import reprlib
&gt;&gt;&gt; reprlib.repr(set('supercalifragilisticexpialidocious'))
&quot;set(['a', 'c', 'd', 'e', 'f', 'g', ...])&quot;
&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;pprint&lt;/code&gt; предлагает более утончённый контроль над выводом встроенных и определённых пользователем объектов способом, подходящим для интерпретатора. Когда результат не умещается на строке, умный &lt;code&gt;pprint&lt;/code&gt; добавляет по необходимости разбивку на строки и отступы, помогающие выделить структуру данных:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import pprint
&gt;&gt;&gt; t = [[[['чёрный', 'бирюзовый'], 'белый', ['зелёный', 'красный']], [['пурпурный', 'жёлтый'], 'голубой']]]
&gt;&gt;&gt; pprint.pprint(t, width=30)
[[[['чёрный', 'бирюзовый'],
   'белый',
   ['зелёный', 'красный']],
  [['пурпурный', 'жёлтый'],
   'голубой']]]
&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;textwrap&lt;/code&gt; форматирует абзацы текста под определённую ширину:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import textwrap
&gt;&gt;&gt; doc = &quot;&quot;&quot;Метод wrap() аналогичен fill(), но он возвращает список строк, а не одну большую строку с признаками концов строк.&quot;&quot;&quot;
&gt;&gt;&gt; print(textwrap.fill(doc, width=40))
Метод wrap() аналогичен fill(), но он
возвращает список строк, а не одну
большую строку с признаками концов
строк.
&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;locale&lt;/code&gt; дает доступ к базе данных форматов различных культурных сред. Например, параметр &lt;code&gt;grouping&lt;/code&gt; функции &lt;code&gt;format&lt;/code&gt; этого модуля позволяет использовать группировку цифр принятыми в данной культурной среде разделителями:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import locale
&gt;&gt;&gt; locale.setlocale(locale.LC_ALL, 'en_US.UTF8')
'en_US.UTF8'
&gt;&gt;&gt; conv = locale.localeconv()          # получить отображение соглашений
&gt;&gt;&gt; x = 1234567.8
&gt;&gt;&gt; locale.format(&quot;%d&quot;, x, grouping=True)
'1,234,567'
&gt;&gt;&gt; locale.format(&quot;%s%.*f&quot;, (conv['currency_symbol'], conv['frac_digits'], x), grouping=True)
'$1,234,567.80'
&lt;/syntaxhighlight&gt;

=== Работа с шаблонами ===

Модуль &lt;code&gt;string&lt;/code&gt; включает в себя гибкий класс &lt;code&gt;Template&lt;/code&gt;, реализующий шаблоны с простым синтаксисом, доступным для редактирования конечными пользователями. Использование этого класса позволит пользователям настраивать приложения без изменений в них самих.

Формат использует имена полей для подстановки, записываемых как знак доллара (&lt;code&gt;$&lt;/code&gt;) с последующим идентификатором, состоящим, как и имена в программах на Python, из букв, цифр и подчёркиваний&lt;ref&gt;(''Прим. перев.'') вопреки ожиданиям, имена полей нельзя писать кириллицей.&lt;/ref&gt;. Фигурные скобки вокруг идентификатора позволяют использовать алфавитно-цифровые символы сразу после поля подстановки, без дополнительных пробелов. Собственно знак доллара необходимо записывать сдвоенно: &lt;code&gt;$$&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from string import Template
&gt;&gt;&gt; t = Template('${village}folk send $$10 to $cause.')
&gt;&gt;&gt; t.substitute(village='Nottingham', cause='the ditch fund')
'Nottinghamfolk send $10 to the ditch fund.'
&lt;/syntaxhighlight&gt;

Метод &lt;code&gt;substitute()&lt;/code&gt; возбуждает &lt;code&gt;KeyError&lt;/code&gt; в случае, когда значение для поля отсутствует в переданных параметрах. Для приложений вроде массовой персонализированной рассылки, часть данных может отсутствовать. В таком случае лучше использовать метод &lt;code&gt;safe_substitute()&lt;/code&gt;: он оставит разметку полей подстановки в случае отсутствия данных.&lt;ref&gt;(''Прим. перев.'') разумеется, ещё лучше позаботиться, чтобы у полей были удачные значения по умолчанию.&lt;/ref&gt;

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; t = Template('Return the $item to $owner.')
&gt;&gt;&gt; d = dict(item='unladen swallow')
&gt;&gt;&gt; t.substitute(d)
Traceback (most recent call last):
  . . .
KeyError: 'owner'
&gt;&gt;&gt; t.safe_substitute(d)
'Return the unladen swallow to $owner.'&lt;/syntaxhighlight&gt;

Производные от &lt;code&gt;Template&lt;/code&gt; классы могут переопределить разделитель. Например, утилита переименования файлов просмотрщика фотографий может использовать знаки процента в разметке полей подстановки: текущая дата, номер изображения по порядку, формат файла:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import time, os.path
&gt;&gt;&gt; photofiles = ['img_1074.jpg', 'img_1076.jpg', 'img_1077.jpg']
&gt;&gt;&gt; class BatchRename(Template):
...     delimiter = '%'
&gt;&gt;&gt; fmt = input('Введите стиль переименования (%d - дата, %n - номер п/п, %f - формат):  ')
Введите стиль переименования (%d - дата, %n - номер п/п, %f - формат):  Ashley_%n%f

&gt;&gt;&gt; t = BatchRename(fmt)
&gt;&gt;&gt; date = time.strftime('%d%b%y')
&gt;&gt;&gt; for i, filename in enumerate(photofiles):
...     base, ext = os.path.splitext(filename)
...     newname = t.substitute(d=date, n=i, f=ext)
...     print('{0} --&gt; {1}'.format(filename, newname))

img_1074.jpg --&gt; Ashley_0.jpg
img_1076.jpg --&gt; Ashley_1.jpg
img_1077.jpg --&gt; Ashley_2.jpg&lt;/syntaxhighlight&gt;

Другое приложение для использования шаблонов — отделение логики от деталей реализации различных выходных форматов. Это даёт возможность строить шаблоны для XML-файлов, текстовых отчётов и веб-отчётов на HTML.

=== Работа с записями двоичных данных ===

Модуль &lt;code&gt;struct&lt;/code&gt; предлагает функции &lt;code&gt;pack()&lt;/code&gt; и &lt;code&gt;unpack()&lt;/code&gt; для работы с форматами двоичных записей переменной длины. Следующий пример показывает как можно получить заголовочную информацию из ZIP-файла без использования модуля &lt;code&gt;zipfile&lt;/code&gt;. Коды &lt;code&gt;&quot;H&quot;&lt;/code&gt; и &lt;code&gt;&quot;I&quot;&lt;/code&gt; представляют двух- и четырехбайтовых беззнаковых числа соответственно. Код &lt;code&gt;&quot;&lt;&quot;&lt;/code&gt; обозначает, что числа стандартного размера и байты записаны в порядке «сначала младший» (little-endian):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import struct

data = open('myfile.zip', 'rb').read()
start = 0
for i in range(3):                      # показать первые три заголовка
    start += 14
    fields = struct.unpack('&lt;IIIHH', data[start:start+16])
    crc32, comp_size, uncomp_size, filenamesize, extra_size = fields

    start += 16
    filename = data[start:start+filenamesize]
    start += filenamesize
    extra = data[start:start+extra_size]
    print(filename, hex(crc32), comp_size, uncomp_size)

    start += extra_size + comp_size     # пропустить до следующего заголовка
&lt;/syntaxhighlight&gt;

=== Многопоточность ===

Потоки (threads) могут использоваться для разделения задач, которые могут выполняться по времени независимо друг от друга. Разделение на потоки может применяться для улучшения времени отклика приложений, ведущих диалог с пользователем пока другие задачи выполняются в фоновом режиме. Похожая ситуация с произведением ввода-вывода одновременно с вычислениями в другом потоке.

Следующий пример показывает, как высокоуровневый модуль &lt;code&gt;threading&lt;/code&gt; может выполнять фоновые задачи, продолжая выполнение основной программы:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import threading, zipfile

class AsyncZip(threading.Thread):
    def __init__(self, infile, outfile):
        threading.Thread.__init__(self)
        self.infile = infile
        self.outfile = outfile
    def run(self):
        f = zipfile.ZipFile(self.outfile, 'w', zipfile.ZIP_DEFLATED)
        f.write(self.infile)
        f.close()
        print('Завершён фоновый zip для:', self.infile)

background = AsyncZip('mydata.txt', 'myarchive.zip')
background.start()
print('Главная программа на переднем плане.')

background.join()    # Ждём завершения фоновой задачи
print('Главная программа дождалась завершения фоновой задачи.')
&lt;/syntaxhighlight&gt;

Основной трудностью многопоточных приложений является координирование потоков, разделяющих общие данные или другие ресурсы. В помощь этому модуль &lt;code&gt;threading&lt;/code&gt; предлагает целый ряд простых средств: замки́, события, переменные условий, семафоры и другие.

Несмотря на достаточную мощь представленных средств, даже небольшие погрешности в дизайне многопоточного приложения могут вызвать трудноповторимые проблемы. Таким образом, рекомендуемым подходом к координированию задач является централизация доступа к некоторому ресурсу в одном потоке и использование модуля &lt;code&gt;queue&lt;/code&gt; для направления запросов из других потоков. Приложения, использующие Queue-объекты для межпотоковой связи и координирования, легче проектировать, сопровождать исходный код, они более надёжны.

=== Запись в журнал ===

Модуль &lt;code&gt;logging&lt;/code&gt; предлагает богатую возможностями и гибкую систему ведения журнала. В простейшем случае сообщения отправляются на стандартный вывод ошибок — &lt;code&gt;sys.stderr&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import logging
logging.debug('Отладочная информация')
logging.info('Для информации')
logging.warning('Предупреждение: файл %s не найден', 'server.conf')
logging.error('Произошла ошибка!')
logging.critical('Критическая ошибка - выход')&lt;/syntaxhighlight&gt;

Результат выполнения этого примера:

&lt;syntaxhighlight lang=&quot;text&quot;&gt;WARNING:root:Предупреждение: файл server.conf не найден
ERROR:root:Произошла ошибка!
CRITICAL:root:Критическая ошибка - выход
&lt;/syntaxhighlight&gt;

Без дополнительной настройки информационные и отладочные сообщения подавляются, а вывод направляется в &lt;code&gt;sys.stderr&lt;/code&gt;. Другие варианты вывода: отправка сообщений по электронной почте, дейтаграммами, сокеты, на HTTP сервер. Другие фильтры могут выбирать различные варианты доставки в зависимости от приоритета: &lt;tt&gt;DEBUG&lt;/tt&gt;, &lt;tt&gt;INFO&lt;/tt&gt;, &lt;tt&gt;WARNING&lt;/tt&gt;, &lt;tt&gt;ERROR&lt;/tt&gt; или &lt;tt&gt;CRITICAL&lt;/tt&gt;.

Система записи в журнал может быть сконфигурирована напрямую из Python. Конфигурация также может быть загружена из конфигурационного файла и не требовать изменений в коде приложения.

=== Слабые ссылки ===

Python имеет автоматическое управление памятью: подсчёт ссылок для большинства объектов и сборка мусора для удаления циклов. Память освобождается сразу после того, как была удалена последняя ссылка на объект.

Этот подход отлично работает для большинства приложений, но иногда возникает необходимость вести учёт объектов только когда они используются где-нибудь ещё. К сожалению, само слежение за объектами уже создает ссылку и тем самым объекты остаются в памяти. Модуль &lt;code&gt;weakref&lt;/code&gt; (от англ. weak reference — слабая ссылка) даёт средство для учёта объектов без создания ссылок на них. Когда объект больше не нужен, он автоматически удаляется из таблицы слабых ссылок и производится обратный вызов &lt;code&gt;weakref&lt;/code&gt;-объектов. Типичное применение модуля — кэширование объектов, которые затратно воспроизвести снова.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import weakref, gc
&gt;&gt;&gt; class A:
...     def __init__(self, value):
...             self.value = value
...     def __repr__(self):
...             return str(self.value)
...
&gt;&gt;&gt; a = A(10)                   # создаёт ссылку
&gt;&gt;&gt; d = weakref.WeakValueDictionary()  # словарь, использующий слабые ссылки
&gt;&gt;&gt; d['primary'] = a            # не создаёт ссылки
&gt;&gt;&gt; d['primary']                # достать объект, если он все ещё &quot;жив&quot;
10
&gt;&gt;&gt; del a                       # удалить одну ссылку
&gt;&gt;&gt; gc.collect()                # произвести сборку мусора
0
&gt;&gt;&gt; d['primary']                # запись была автоматически удалена
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in &lt;module&gt;
    d['primary']
  File &quot;C:/python31/lib/weakref.py&quot;, line 46, in __getitem__
    o = self.data[key]()
KeyError: 'primary'
&lt;/syntaxhighlight&gt;

=== Работа со списками ===

В Python список может заменить многие структуры данных. Однако иногда необходимы альтернативные реализации, которые имеют другое компромиссное решение в отношении производительности.

Модуль &lt;code&gt;array&lt;/code&gt; (массив) предоставляет объект &lt;code&gt;array&lt;/code&gt;, отличающийся от списка лишь возможностью более компактно хранить однородные данные. Следующий пример показывает массив чисел, хранимый в виде двухбайтных беззнаковых чисел (типокод «&lt;code&gt;H&lt;/code&gt;»), а не в обычном списке, где каждый элемент типа &lt;code&gt;int&lt;/code&gt; обычно занимает 16 байт:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from array import array
&gt;&gt;&gt; a = array('H', [4000, 10, 700, 22222])
&gt;&gt;&gt; sum(a)
26932
&gt;&gt;&gt; a[1:3]
array('H', [10, 700])&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;collections&lt;/code&gt; (коллекции) среди прочего предоставляет объект &lt;code&gt;deque&lt;/code&gt; (дек, двухсторонняя очередь). Объекты этого типа имеют более быстрые операции вставки (append) и извлечения (pop) слева, но более медленный поиск внутренних элементов. Эти объекты хорошо подходят для реализации очередей и деревьев поиска в ширину:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from collections import deque
&gt;&gt;&gt; d = deque([&quot;задача1&quot;, &quot;задача2&quot;, &quot;задача3&quot;])
&gt;&gt;&gt; d.append(&quot;task4&quot;)
&gt;&gt;&gt; print(&quot;Обрабатывается&quot;, d.popleft())
Обрабатывается задача1

unsearched = deque([starting_node])
def breadth_first_search(unsearched):
    node = unsearched.popleft()
    for m in gen_moves(node):
        if is_goal(m):
            return m
        unsearched.append(m)
&lt;/syntaxhighlight&gt;

В дополнение к альтернативным реализациям списков библиотека также предлагает средства вроде модуля &lt;code&gt;bisect&lt;/code&gt; с функциями для манипуляции отсортированными списками:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import bisect
&gt;&gt;&gt; scores = [(100, 'perl'), (200, 'tcl'), (400, 'lua'), (500, 'python')]
&gt;&gt;&gt; bisect.insort(scores, (300, 'ruby'))  # вставка значения в отсортированный список
&gt;&gt;&gt; scores
[(100, 'perl'), (200, 'tcl'), (300, 'ruby'), (400, 'lua'), (500, 'python')]
&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;heapq&lt;/code&gt; имеет функции для реализации кучи, основанной на обычных списках. Элемент с наименьшим значением всегда находится в позиции с индексом 0. Это свойство может с успехом быть задействовано в приложениях, где особенно частый доступ необходим к наименьшему элементу, но полную сортировку проводить накладно.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from heapq import heapify, heappop, heappush
&gt;&gt;&gt; data = [1, 3, 5, 7, 9, 2, 4, 6, 8, 0]
&gt;&gt;&gt; heapify(data)                      # сделать из списка кучу
&gt;&gt;&gt; heappush(data, -5)                 # добавить новый элемент
&gt;&gt;&gt; [heappop(data) for i in range(3)]  # извлечь три наименьших значения
[-5, 0, 1]
&lt;/syntaxhighlight&gt;

=== Десятичная арифметика чисел с плавающей запятой ===

Модуль &lt;code&gt;decimal&lt;/code&gt; предоставляет тип данных &lt;code&gt;Decimal&lt;/code&gt; для десятичной арифметики с плавающей запятой. В сравнении со встроенной двоичной арифметикой, новый класс особенно полезен в финансовых приложениях и других случаях, требующих точного десятичного представления, управления точностью, округлением c соблюдением законодательных и нормативных требований, отслеживания количества значащих цифр или для приложений, от которых ожидается совпадение с результатами, проделанными «вручную».

Например, вычисление 5%-ного налога на 70 копеечный телефонный счет даёт различные результаты при использовании десятичной и двоичной арифметик. Разница становится значащей при округлении до ближайшей копейки:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from decimal import *
&gt;&gt;&gt; Decimal('0.70') * Decimal('1.05')
Decimal(&quot;0.7350&quot;)
&gt;&gt;&gt; .70 * 1.05
0.73499999999999999
&lt;/syntaxhighlight&gt;


== Что дальше? ==

Чтение этого учебника, возможно, усилило ваш интерес к применению Python, и вы жаждете использовать этот язык для решения конкретных задач. Где можно пополнить знания о Python?

Этот учебник является частью набора документации Python. В этом наборе есть и другие документы.

----

'''Сноски:'''

&lt;references /&gt;</text>
      <sha1>14e70awlfgll8o8kpex9uose3cp094g</sha1>
    </revision>
  </page>
  <page>
    <title>Понятие о помехах и методы борьбы с ними</title>
    <ns>0</ns>
    <id>7884</id>
    <revision>
      <id>270431</id>
      <parentid>262110</parentid>
      <timestamp>2026-10-27T07:12:46Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270431</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="155577" sha1="qrgu6k0jeadyly8kpvg1jxsm8xciw6v" xml:space="preserve">{{Название учебника
|Категория = Информатика, Физика
|Тип = Одностраничный
}}
== Помехи: понятие и характеристики ==
'''Помехой''' называется стороннее возмущение, действующее в системе передачи и препятствующее правильному приёму сигналов.

Источники помех могут находиться как вне, так и внутри самой системы передачи.

Если помеха регулярна и известна, то борьба с ней не представляет затруднений. Например, фон переменного тока может быть устранён компенсацией; помеха от определенной радиостанции с модуляционным спектром нормальной ширины устраняется соответствующим фильтром. Борьба же со случайными помехами представляет наибольшее затруднение.

В общем виде влияние помехи &lt;math&gt;\xi&lt;/math&gt; на передаваемый сигнал &lt;math&gt;s&lt;/math&gt; может быть выражено оператором
: &lt;math&gt;x=f(s,\;\xi).\qquad\qquad(1)&lt;/math&gt;
В том частном случае, когда этот оператор вырождается в сумму
: &lt;math&gt;x=s+\xi\qquad\qquad(2)&lt;/math&gt;
помеха &lt;math&gt;\xi&lt;/math&gt; называется '''аддитивной'''. Аддитивную помеху часто называют '''шумом'''.

Если же &lt;math&gt;x&lt;/math&gt; может быть представлен в виде
: &lt;math&gt;x=\nu s,\qquad\qquad(3)&lt;/math&gt;
где случайный процесс (см. ниже) &lt;math&gt;\nu(t)&lt;/math&gt; неотрицателен, то помеху &lt;math&gt;\nu&lt;/math&gt; называют '''мультипликативной'''. Если &lt;math&gt;\nu&lt;/math&gt; — медленный (по сравнению с &lt;math&gt;s&lt;/math&gt;) процесс, то явление, вызываемое мультипликативной помехой, носит название '''замирание''' ('''фединг''').

В более общем случае оператор &lt;math&gt;f&lt;/math&gt; не может быть приведён к основным формам (2) и (3). При одновременном наличии шума и мультипликативной помехи удобно ввести два случайных процесса, выражающих оба вида помехи:
: &lt;math&gt;x=\nu s+\xi.\qquad\qquad(4)&lt;/math&gt;
С физической точки зрения случайные помехи порождаются различного рода флуктуациями. '''Флуктуациями''' в физике называют случайные отклонения тех или иных физических величин от их средних значений. Так, источником шума в электрических цепях постоянного тока могут являться флуктуации тока около среднего значения, обусловленные дискретной природой носителей заряда (ионов и электронов). Это явление носит название '''дробового эффекта'''.

Наиболее универсальной причиной шума являются флуктуации, обусловленные тепловым движением. Случайное тепловое движение носителей заряда в любом проводнике вызывает случайную разность потенциалов на его концах. Эта разность потенциалов флуктуирует около среднего значения, равного нулю; её средний квадрат пропорционален абсолютной температуре. Возникающая помеха называется '''тепловым шумом'''.

Из сказанного видно, что флуктуации и обусловленные ими помехи заложены глубоко в природе вещей.

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

Имеется ещё один источник принципиально неустранимого шума, возникающего из-за дискретной природы электромагнитного излучения. Согласно современным воззрениям излучение совершается дискретными порциями — квантами, энергия которых равна &lt;math&gt;h\nu&lt;/math&gt;, где &lt;math&gt;h&lt;/math&gt; — постоянная Планка, &lt;math&gt;\nu&lt;/math&gt; — частота. Квант электромагнитного излучения называется фотоном. В настоящее время в технике имеются две ясные тенденции: к увеличению расстояний и к повышению частоты. Увеличение расстояний означает уменьшение потока энергии, а повышение частоты — укрупнение фотонов. Таким образом, при определённых условиях не только начинает ощущаться дискретная фотонная структура излучения, но обусловленный этой причиной шум может превзойти все остальные помехи. Канал, работающий при таких условиях, получил название '''фотонного канала'''.

Выше перечисленные шумы являются аддитивными, но имеется обширный класс мультипликативных помех.

Природа этих помех состоит в случайном изменении параметров канала передачи. При передаче сигнал подвергается искажениям вследствие того, что коэффициент передачи канала не является постоянным числом; свойства канала описываются частотными или временны́ми характеристиками, определяющими так называемые линейные искажения. Кроме того, канал может вносить и нелинейные искажения, обусловленные нелинейностью тех или иных звеньев канала.

Как линейные, так и нелинейные искажения обусловлены известными характеристиками канала, а потому, по крайней мере в принципе, могут быть устранены путем надлежащей коррекции. Поэтому искажения следует чётко отделить от действия помехи случайного характера, которая заранее не может быть известна.

Если же коэффициент передачи канала претерпевает случайные изменения, то влияние этих изменений следует уже рассматривать как действие случайной помехи, которая и является мультипликативной помехой.

Примером медленной мультипликативной помехи является изменение силы принимаемого сигнала, обусловленное интерференцией при многолучевом распространении (замирание). Быстрая мультипликативная помеха возникает при использовании шума в качестве переносчика.&lt;ref&gt;{{книга|автор=Варакин, Л. Е.|заглавие=Теория систем сигналов|место={{М.}}|издательство=Советское радио|год=1978|страниц=375}}&lt;/ref&gt;

Помеха представляется случайной функцией времени. Случайную функцию дискретного времени называют '''случайной последовательностью''', случайную функцию непрерывного времени — '''случайным процессом'''. Случайные функции характеризуются своими распределениями. Применяются также числовые характеристики в виде моментов распределения. Обычно рассматриваются стационарные случайные процессы.

Важнейшей характеристикой канала с аддитивной помехой является отношение средних мощностей сигнала &lt;math&gt;E_s&lt;/math&gt; и помехи &lt;math&gt;E_n&lt;/math&gt;
: &lt;math&gt;\frac{E_s}{E_n}.\qquad\qquad(5)&lt;/math&gt;
Это отношение, кратко называемое '''отношение «сигнал/помеха»''', играет большую роль в теории помехоустойчивости.

На практике отношение «сигнал/помеха» выражают в логарифмических безразмерных единицах — децибелах (dB, дБ):
: &lt;math&gt;\mathrm{dB}=10\,\mathrm{lg}\frac{E_s}{E_n}.\qquad\qquad(6)&lt;/math&gt;
Случайные процессы характеризуются определённым набором показателей.

Момент первого порядка ('''первый момент''')
: &lt;math&gt;M\xi=\int\limits_{-\infty}^{+\infty}xw(x)\,dx\qquad\qquad(7)&lt;/math&gt;
выражает '''математическое ожидание''', или '''постоянную составляющую процесса'''.

Центральный момент второго порядка ('''второй момент''') называется дисперсией и равен:
: &lt;math&gt;D\xi=\int\limits_{-\infty}^{+\infty}(x-M\xi)^2w(x)\,dx=M(\xi^2)-(M\xi)^2=\sigma^2.\qquad\qquad(8)&lt;/math&gt;
Дисперсия выражает '''мощность переменной составляющей''', а средний квадрат &lt;math&gt;M(\xi^2)&lt;/math&gt; — '''общую мощность'''. В большинстве случаев &lt;math&gt;M\xi=0&lt;/math&gt;, так что дисперсия совпадает со средним квадратом.

Смешанный второй момент
: &lt;math&gt;M[\xi(t)\xi(t+\tau)]=\int\limits_{-\infty}^{+\infty}\int\limits_{-\infty}^{+\infty}x_1x_2w(x_1,\;x_2)\,dx_1dx_2=R(\tau).\qquad\qquad(9)&lt;/math&gt;
называется '''функцией автокорреляций процесса''' &lt;math&gt;\xi(t)&lt;/math&gt;. Величина &lt;math&gt;R(0)&lt;/math&gt; есть мощность процесса. Действительно
: &lt;math&gt;R(0)=M(\xi^2)=E.\qquad\qquad(10)&lt;/math&gt;
Многие случайные процессы, встречающиеся в практике, обладают свойством '''эргодичности'''. Это свойство состоит в том, что средние по множеству (то есть математические ожидания, вычисляемые по распределениям) с вероятностью единица совпадают со средними по времени, найденными по одной реализации процесса. Тогда для эргодических процессов имеем
: &lt;math&gt;\begin{cases}a=\lim\limits_{T\to\infty}\dfrac{1}{2T}\int\limits_{-T}^T\xi(t)\,dt, \\ P=\lim\limits_{T\to\infty}\dfrac{1}{2T}\int\limits_{-T}^T\xi^2(t)\,dt, \\ R(\tau)=\lim\limits_{T\to\infty}\dfrac{1}{2T}\int\limits_{-T}^T\xi(t)\xi(t+\tau)\,dt.\end{cases}\qquad\qquad(11)&lt;/math&gt;
'''Спектральная плотность мощности''' &lt;math&gt;G(\omega)&lt;/math&gt; (или просто '''спектр''') связана с функцией автокорреляции парой преобразований Фурье:
: &lt;math&gt;\begin{cases}G(\omega)=\dfrac{2}{\pi}\int\limits_0^{+\infty}R(\tau)\cos\omega\tau\,d\tau, \\ R(\tau)=\int\limits_0^{+\infty}G(\omega)\cos\omega\tau\,d\omega.\end{cases}\qquad\qquad(12)&lt;/math&gt;
Положив во второй формуле &lt;math&gt;\tau=0&lt;/math&gt;, получим соотношение, поясняющее смысл функции :
: &lt;math&gt;R(0)=\int\limits_0^{+\infty}G(\omega)\,d\omega=E.\qquad\qquad(13)&lt;/math&gt;
Наряду с &lt;math&gt;G(\omega)&lt;/math&gt; часто пользуются функцией &lt;math&gt;A(f)=2\pi G(\omega)&lt;/math&gt; — мощность, приходящаяся на полосу 1 Гц. Поэтому удобнее записать (12) в виде
: &lt;math&gt;\begin{cases}A(f)=4\int\limits_0^{+\infty}R(\tau)\cos 2\pi f\tau\,d\tau, \\ R(\tau)=\int\limits_0^{+\infty}A(f)\cos2\pi f\tau\,df.\end{cases}\qquad\qquad(14)&lt;/math&gt;
Задание &lt;math&gt;G(\omega)&lt;/math&gt; исчерпывающим образом характеризует любой случайный процесс.

== Некоторые виды шумов ==

=== Гауссов шум ===
Среди всех случайных процессов особое место занимает процесс с нормальным распределением ('''гауссов процесс'''). Дело в том, что большое число действительных случайных процессов является гауссовыми. Это обстоятельство находит себе объяснение в известной теореме Ляпунова, согласно которой распределение суммы независимых случайных величин (при некоторых достаточно широких условиях) сходится к нормальному, вне зависимости от характера распределения слагаемых.

'''Гауссов шум''', или '''гауссов случайный процесс''', возникает при суммировании статистически независимых белых шумов (см. ниже). Он преобладает в практических задачах. Случайный процесс &lt;math&gt;x(t)&lt;/math&gt; называется '''гауссовым''', если для любого набора фиксированных моментов времени &lt;math&gt;t_n&lt;/math&gt; случайные величины &lt;math&gt;x_n&lt;/math&gt; подчиняются нормальному распределению. Плотность вероятностей мгновенных значений &lt;math&gt;x(t)&lt;/math&gt; гауссова процесса определяется выражением:
: &lt;math&gt;w(x)=\frac{1}{\sqrt{2\pi\sigma^2}}e^{-\frac{(x-\mu)^2}{2\sigma^2}},\qquad\qquad(15)&lt;/math&gt;
где &lt;math&gt;\mu&lt;/math&gt; — среднее значение;

&lt;math&gt;\sigma^2&lt;/math&gt; — стандартное (среднеквадратичное) отклонение.

Среднее значение для гауссова распределения равно математическому ожиданию:
: &lt;math&gt;\mu=\int\limits_{-\infty}^{+\infty}xw(x)\,dx.\qquad\qquad(16)&lt;/math&gt;
Стандартное (среднеквадратичное) отклонение:
: &lt;math&gt;\sigma^2=\int\limits_{-\infty}^{+\infty}(x-\mu)^2w(x)\,dx.\qquad\qquad(17)&lt;/math&gt;

[[Файл:Зависимость формы распределения Гаусса от среднеквадратичного отклонения.png|frame|center|Рисунок 1 — Зависимость формы распределения Гаусса от среднеквадратичного отклонения.]]

Следовательно, плотность вероятностей гауссова процесса полностью характеризуется спектральной плотностью, по которой можно определить значение дисперсии процесса. На рисунке 1 показана зависимость формы распределения Гаусса от среднеквадратичного отклонения.

=== Белый шум ===
Помеху, представляющую собой случайный процесс с равномерным спектром, то есть
: &lt;math&gt;A(f)=A_0=\mathrm{const},\qquad\qquad(18)&lt;/math&gt;
называют '''белым шумом'''. Мощность белого шума в полосе &lt;math&gt;F&lt;/math&gt; равна
: &lt;math&gt;E_F=\int\limits_0^F A(f)\,df=A_0F.\qquad\qquad(19)&lt;/math&gt;
По-другому, белый шум (рисунок 2) можно определить как стационарный случайный процесс &lt;math&gt;x(t)&lt;/math&gt; с постоянной спектральной плотностью &lt;math&gt;G(\omega)=\sigma^2&lt;/math&gt;, равной дисперсии значений &lt;math&gt;D(x)&lt;/math&gt; — все спектральные составляющие белого шума имеют одинаковую энергию (отсюда аналогия с белым цветом, который содержит все цвета видимого спектра).

Как уже было сказано выше, по своему физическому смыслу спектральная плотность — это мощность процесса, которая приходится на 1 Гц полосы частот. Но тогда идеального белого шума на практике не может существовать, так как для него должно было бы выполняться условие:
: &lt;math&gt;R(0)=\int\limits_0^{+\infty}G(\omega)\,d\omega=\frac{\sigma^2}{2}\delta(0)=+\infty,\qquad\qquad(20)&lt;/math&gt;
где &lt;math&gt;\delta(0)&lt;/math&gt; — дельта-функция Дирака. Таким образом, мощность белого шума равна бесконечности, а значения шума не коррелированны для любых &lt;math&gt;\tau\neq 0&lt;/math&gt;, так как корреляционная функция представляет собой дельта-импульс. Тем не менее, многие помехи в радиотехнике, в технике связи и в других отраслях рассматривают как белый шум, если выполняется следующее соотношение между шириной спектров полезных сигналов &lt;math&gt;B_s&lt;/math&gt; и шумов &lt;math&gt;B_n&lt;/math&gt;
: &lt;math&gt;\frac{B_s}{B_n}\ll 1\qquad\qquad(21)&lt;/math&gt;
и спектральная плотность шумов слабо изменяется в интервале спектра сигнала.

[[Файл:Выборка белого шума.png|frame|center|Рисунок 2 — Выборка белого шума.]]

Примером белого шума может служить тепловой шум. Согласно формуле Найквиста мощность теплового шума, приходящаяся на полосу длиною &lt;math&gt;B&lt;/math&gt;, равна:
: &lt;math&gt;E_F=4kTB,\qquad\qquad(22)&lt;/math&gt;
где &lt;math&gt;k&lt;/math&gt; — постоянная Больцмана, &lt;math&gt;T&lt;/math&gt; — абсолютная температура. Таким образом, &lt;math&gt;A_0=akT&lt;/math&gt;.

=== Периодический случайный шум ===
'''Периодический случайный шум''' представляет собой результат суммирования синусоид с одинаковыми амплитудами и случайными фазами. Шум содержит все частоты, которые могут быть представлены целым числом периодов на определённом числе выборок.

Распределение периодического шума при большом количестве выборок стремится к гауссову шуму.

Часто периодический шум рассматривают как выборку гауссова шума, ограниченную по величине следующими значениями:
: &lt;math&gt;\begin{cases}A\left(\dfrac{N}{2}-1\right), &amp; N=2k,\;k=1,\;2,\;\ldots; \\ A\left(\dfrac{N-1}{2}\right), &amp; N=2k-1,\;k=1,\;2,\;\ldots, \end{cases}\qquad\qquad(23)&lt;/math&gt;
где &lt;math&gt;A&lt;/math&gt; — заданная амплитуда спектра;

&lt;math&gt;N&lt;/math&gt; — выборка.

[[Файл:Частотная характеристика периодического случайного шума.png|thumb|center|400px|Рисунок 3 — Частотная характеристика периодического случайного шума.]]

Таким образом, периодический случайный шум имеет импульсный характер, а следовательно дискретную частотную характеристику (рисунок 3).

== Способы проникновения шумов ==

=== Типичные пути проникновения шумов ===
Из рисунка 4 видно, что проблема шумоподавления возникает при наличии трёх необходимых элементов: во-первых, должен быть источник шумов; во-вторых, должна быть схема-приёмник, чувствительная к шумам; в-третьих, необходимо наличие канала связи для передачи шумов от источника к приемнику.

[[Файл:Принципиальная схема системы с шумами.png|thumb|center|500px|Рисунок 4 — Принципиальная схема системы с шумами.]]

При анализе проблемы шумов, прежде всего, следует определить, что является источником шумов, что служит их приёмником и каким образом источник и приёмник связаны друг с другом. Отсюда вытекает, что возможны три способа устранения прохождения шумов:
# подавление шумов в источнике;
# создание приёмника, нечувствительного к шумам;
# минимизация передачи шумов через канал связи.
В некоторых случаях необходимо применять два или даже все три указанных способа подавления шумов.

=== Шумы, наводимые на провода ===
Одним из наиболее очевидных, но часто упускаемых из виду путей проникновения шумов в схему являются провода. Проходя через «зашумлённое» пространство, проводник получает шумовые наводки, а затем передаёт их другой схеме. Это вызывает помехи. Решение состоит в защите проводника от шумов или в обеспечении развязки, благодаря которой шумы отводятся с проводника прежде, чем попадут в чувствительную схему.

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

=== Связь через общее сопротивление ===
Связь через общее сопротивление встречается там, где токи от двух различных схем проходят через одно сопротивление. При этом падение напряжения, создаваемое каждой из схем на этом сопротивлении, является для другой схемы помехой. Классический пример такого рода связи показан на рисунке 5, а. Оба возвратных тока (1 и 2) проходят на землю через общее сопротивление. Что касается схемы 1, то потенциал ее общей точки относительно земли модулируется возвратным током 2, протекающим через общее сопротивление шины земли. Поэтому от схемы 2 к схеме 1 через общее сопротивление поступает некоторый шумовой сигнал.

&lt;center&gt;&lt;gallery widths=&quot;400px&quot; perrow=2&gt;
Файл:Схема с общей шиной.png|а)
Файл:Схема с общим источником питания.png|б)
&lt;/gallery&gt;
Рисунок 5 — Примеры связей: а) — связь двух схем через общую шину заземления; б) — связь двух схем через общий источник питания.&lt;/center&gt;

Другим примером проблемы такого рода является представленная на рисунке 5, б схема разводки питания. Любое изменение тока, потребляемого схемой 2, будет изменять напряжение на зажимах питания схемы 1 из-за наличия общих сопротивлений шин питания и внутреннего сопротивления источника питания. Положение можно несколько улучшить, подключив схему 2 ближе к выходным зажимам источника питания и уменьшив тем самым величину общего сопротивления шин питания. Однако связь через внутреннее сопротивление источника питания остаётся.

=== Электрические и магнитные поля ===
Еще один вид связи представляет собой излучение электрического и магнитного полей. Все элементы схем, включая проводники, при движении по ним электрических зарядов излучают электромагнитные поля. Кроме такого не предусмотренного разработкой излучения, существует проблема преднамеренного излучения от таких источников, как радиовещательные и радиолокационные станции. Когда приёмник расположен вблизи источника (в ближнем поле), электрическое и магнитное поля рассматривают раздельно. Если же приемник находится далеко от источника (в дальнем поле), излучение рассматривается как комбинация электрического и магнитного полей, то есть как электромагнитное излучение.

[[Файл:Схема с шумами.png|thumb|center|500px|Рисунок 6 — Воздействие шумов от электродвигателя на цепь с сигналами низкого уровня.]]

Это имеет место, например, в схеме, показанной на рисунке 6. В этой схеме экранированный двигатель постоянного тока соединен со схемой управления. Шумы от двигателя вызывают помехи в слаботочной схеме, расположенной в той же установке. Шумовые токи, возникающие на коллекторе двигателя, выходят за пределы экрана, проходя по проводам к схеме управления. Провода излучают шумы, наводя их на слаботочные цепи.

В этом примере источником шумов является искрение между щетками и коллектором двигателя. Канал связи состоит из двух частей: проводов, подведённых к двигателю, и излучения от этих проводов. Приёмником служит слаботочная цепь. В данном случае шумы источника и приёмника практически не устранимы. Поэтому помехи должны быть подавлены в канале связи. Можно блокировать шумы, проходящие по проводам за пределы экрана, или подавить излучение проводов.

=== Второстепенные источники шумов ===
'''Гальванический процесс.''' При использовании в слаботочной сигнальной цепи разнородных металлов в результате образования из них гальванической пары могут возникать напряжения шумов. При наличии на стыке двух металлов загрязнений или водяных паров создается электрохимический элемент. Развиваемая им ЭДС зависит от используемых металлов, то есть от их расположения в, так называемом, гальваническом ряду. Чем дальше в этом ряду металлы отстоят друг от друга, тем больше будет развиваемое ими напряжение. Если контакт образован одноимёнными металлами, разность потенциалов между ними отсутствует.

При использовании разнородных металлов, помимо возникновения напряжения шумов, может существовать и проблема коррозии. Гальваническая коррозия приводит к тому, что положительные ионы одного металла переносятся в другой металл. Это постепенно разрушает материал анода. Скорость коррозии зависит от степени загрязнения окружающей среды и от того, насколько далеко отстоят друг от друга металлы в гальваническом ряду. Чем дальше они расположены в этом ряду, тем быстрее происходит перенос ионов. Самой распространённой комбинацией металлов является медь и алюминий. При этом алюминий в конце концов разъедается. Однако, если медь покрыта оловянно-свинцовым припоем, реакция замедляется, поскольку медь и оловянно-свинцовый припой расположены в гальваническом ряду ближе, чем медь и алюминий.

Для гальванического процесса необходимо наличие четырёх элементов:
# материала анода;
# электролита (здесь — в виде загрязнения);
# материала катода;
# электропроводного соединения между анодом и катодом (обычно представляет собой цепь утечки).
Гальванический процесс может иметь место даже в том случае, если между анодом и катодом нет загрязнения. Всё, что необходимо для возникновения гальванического процесса, это некоторое количество грязи на поверхности соприкосновения двух металлов.

'''Электролитический процесс.''' Другой вид коррозии обусловлен электролитическим процессом. Он вызывается постоянным током, протекающим между двумя металлами при наличии между ними электролита (в качестве последнего может фигурировать грязь даже со слабыми кислотными свойствами). Коррозия такого типа не зависит от вида применяемых металлов и наблюдается даже между однородными металлами. Скорость коррозии зависит от величины тока и проводимости электролита.

'''Трибоэлектрический эффект.''' В том случае, если диэлектрик внутри кабеля не имеет контакта с проводниками кабеля, на нём может накапливаться заряд. Это явление называется трибоэлектрическим эффектом. Обычно он вызывается механическим изгибом кабеля. Такой заряд действует как источник напряжения шумов, находящийся внутри кабеля. Трибоэлектрический эффект минимизируют, избегая резких перегибов кабеля и его перемещения. Выпускается специальный «малошумящий» кабель, в котором диэлектрик проходит специальную химическую обработку, сводящую к минимуму возможность накопления на нём заряда.

'''Перемещение проводника.''' Если проводник движется в магнитном поле, на концах его возникает разность потенциалов. Паразитные магнитные поля, вызванные наличием больших токов в силовых цепях, а также в других схемах, имеются почти в любой точке окружающего пространства. Данная проблема усугубляется при наличии вибрации. Решается она устранением перемещения проводников путём закрепления кабелей скобами и другими приспособлениями.

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

Источники помех здесь можно разделить на две большие группы. К первой группе относятся устройства, генерирующие относительно регулярные высокочастотные колебания, не предназначенные для излучения, такие, как системы развертки электронно-лучевых трубок, различного рода промышленные, медицинские высокочастотные установки и так далее. Помехи, излучаемые такими источниками, как на основной рабочей частоте, так и на гармониках представляют собой колебания, близкие к синусоидальным. Эти источники относительно легко определяются, допускают простое прогнозирование эффектов, порождаемых их воздействием, но нелегко контролируются.

К источникам второй группы, являющейся наиболее обширной, относятся различные электрические устройства, не вырабатывающие периодических высокочастотных сигналов. К ним относятся линии передачи электроэнергии, системы зажигания автомобильных двигателей, высокочастотная аппаратура для дуговой сварки, газоразрядные устройства, динамомашины, генераторы электрического тока, индукционная и переключающая аппаратура.

Исследования показали, что «удельные веса» той или иной группы источников помех оказываются приблизительно одинаковыми в различных районах с примерно одинаковым уровнем развития промышленности. Так, в крупных промышленных центрах и прилегающих к ним районах основными источниками помех рассматриваемого типа являются системы зажигания двигателей внутреннего сгорания, линии электропередачи и аппаратура, используемая при дуговой сварке.

На частотах, превышающих 30 МГц, помехи, порождаемые системами зажигания, обычно преобладают над помехами, создаваемыми другими источниками. На частотах же, меньших 30 МГц, преобладающими обычно являются помехи, порождаемые линиями электропередачи.

'''Помехи от системы зажигания''' автомобильного двигателя представляют собой приблизительно периодический импульсный сигнал сложной формы. При скоплении в различных точках большого числа автомобилей, движущихся с различными скоростями, измеряющая аппаратура регистрирует серии импульсов со случайными амплитудами и временны́ми интервалами. Длительность регистрируемых групп импульсов колеблется в пределах от нескольких микросекунд до нескольких миллисекунд, а длительность отдельных импульсов от 1 до 6 нс.

В современном городе общая интенсивность помех рассматриваемого типа характеризуется суточными изменениями приблизительно в 16 дБ (между периодами максимальной и минимальной плотности движения). При этом наблюдается корреляция абсолютного уровня помех с численностью населения в городе. Рассматриваемый вид индустриальных помех практически всегда преобладает над другими их типами в полосах местности шириной 60—80 м, прилегающих к автострадам и шоссе с интенсивным автомобильным движением.

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

В засушливых районах увеличению интенсивности помех способствует большая турбулентность воздуха и повышенный уровень солнечной радиации. Уровень помех резко возрастает при неисправности линии передачи.

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

Причиной возникновения помех от линий электропередачи являются переходные процессы, вызываемые электрическими разрядами, которые хаотически возникают на поверхностях проводников и изоляторов линии. Импульсные токи, появляющиеся при таких разрядах, распространяются вдоль линии, которая может выступать либо в качестве коаксиального волновода (в этом случае поток энергии ограничивается внутренним проводом и оплеткой), либо в качестве одиночной линии над земной поверхностью.

'''Помехи от аппаратуры дуговой сварки.''' Аппаратура дуговой сварки создает помехи очень высокого уровня. Только тот факт, что в пределах каждого локального района одновременно может работать, как правило, лишь незначительное количество таких аппаратов, не делает эту аппаратуру основным источником индустриальных помех. Чего нельзя сказать о машиностроительных предприятиях с интенсивным использованием сварочной техники. Спектры помех, возникающих при работе аппаратуры различной конструкции, не совпадают друг с другом. Результаты измерений, проведенных с большим числом аппаратов разной конструкции, показали наличие трёх широких резонансных полос, центры которых соответствуют частотам 750 кГц, 3 МГц и 20 МГц. Спектр излучения каждого отдельно взятого аппарата не обязательно включает в себя все три резонансные полосы.

== Технические методы устранения помех ==
В своей работе «Методы подавления шумов и помех в электронных системах»&lt;ref&gt;{{книга|автор=Отт, Г.|заглавие=Методы подавления шумов и помех в электронных системах|ответственный=Пер. с англ|место={{М.}}|издательство=Мир|год=1979|страниц=318}}&lt;/ref&gt; Г. Отт перечислил основные методы и дал практические рекомендации по борьбе с помехами:
# экранирование;
# заземление;
# балансировка;
# фильтрация;
# изоляция;
# разнесение и ориентация;
# регулировка величины полного сопротивления схемы;
# выбор кабеля;
# подавление (в частотной или временной области).

=== Подавление шумов в источнике ===
# Необходимо заключать источники шумов в экран.
# Необходимо подключать фильтры ко всем проводникам, проходящим в зашумленном пространстве.
# Необходимо ограничивать время нарастания импульса.
# Для катушек реле следует предусмотреть цепи подавления выбросов напряжения.
# Необходимо скручивать шумящие проводники.
# Необходимо экранировать витые пары шумящих проводов.
# Необходимо заземлять оба конца экранов, используемых для подавления помех излучения (экраны не обязательно должны быть изолированы).

=== Устранение связи по шумам ===
# Необходимо скручивать проводники с малым уровнем сигнала.
# Необходимо располагать малосигнальные проводники ближе к шине (особенно при высоком уровне полного сопротивления цепи).
# Необходимо скручивать и экранировать сигнальные проводники (на высоких частотах можно использовать коаксиальный кабель).
# В экранированных кабелях, используемых для защиты малосигнальных проводов, экраны следует заземлять только с одного конца (на высоких частотах можно применять коаксиальный кабель с экраном, заземленным с обоих концов).
# Необходимо изолировать экран сигнальных проводов от случайного заземления в непредусмотренной точке.
# Когда малосигнальные и шумящие провода проходят через общий разъём, необходимо их разделять, помещая между ними заземлённые провода.
# Необходимо пропускать экранирующую оплётку сигнальных проводов через отдельный контакт разъёма.
# Необходимо избегать использования общих проводов заземления для устройств с высоким и низким уровнями сигнала.
# Необходимо выполнять заземление оборудования так, чтобы оно было отделено от земель схем.
# Необходимо выполнять заземление возможно более короткими проводами.
# Для защиты металлических поверхностей необходимо применять проводящие покрытия.
# Необходимо разносить шумящие и не создающие шумов проводники.
# Необходимо заземлять цепи только в одной точке (кроме высокочастотных цепей).
# Необходимо избегать ненадёжных или случайных заземлений.
# Для очень чувствительных схем необходимо использовать источник и нагрузку, симметричные относительно земли.
# Необходимо заключать чувствительные устройства в экранирующие корпуса.
# Необходимо ставить фильтры или цепи развязки на любой проводник, входящий в корпус с заключённым в нем чувствительным устройством.
# Необходимо делать чувствительные проводники как можно короче.
# Необходимо делать как можно короче проводники, выходящие за пределы экрана кабеля.
# Необходимо применять для разводки питания шины с малым полным сопротивлением.
# Необходимо избегать образования контуров заземления.
# Необходимо внимательно рассмотреть использование для разрыва контуров заземления следующих устройств:
#* изолирующих трансформаторов;
#* нейтрализующих трансформаторов;
#* оптронов;
#* дифференциальных усилителей;
#* усилителей с защитным экранированием;
#* балансных схем.

=== Подавление шумов в приёмнике ===
# Не следует делать полосу пропускания шире, чем это необходимо.
# По возможности необходимо использовать селективные частотные фильтры.
# Необходимо обеспечивать соответствующую развязку по питанию.
# Необходимо шунтировать электролитические конденсаторы с малой ёмкостью, работающие на высокой частоте.
# Необходимо разделять сигнальные, шумящие и корпусные земли.
# Необходимо применять экранирующие корпуса.
# У трубчатых конденсаторов необходимо заземлять внешнюю обкладку.

== Методы защиты от помех офисных и промышленных сетей ==
Различают локальные вычислительные сети (ЛВС) для офисного (домашнего) и промышленного применения. В офисных приложениях ЛВС к ним предъявляются в основном требования по скорости передачи данных (особенно это актуально для мультимедиа-приложений реального времени). В офисных и домашних условиях уровень помех не так сильно велик, по сравнению с производственными, поэтому в правильно сконфигурированных сетях коллизии возникают редко. Минимальные простои, связанные с повторной передачей искаженных и потерянных пакетов данных, не так критичны, как в промышленных сетях. В приложениях интернет-вещания в режиме реального времени неправильные кадры могут быть восстановлены по экстраполяционному принципу, основываясь на предыдущих данных, так как обычно искажения такого рода малозаметны или имеют приемлемый характер.

К сетям полевого уровня (''fieldbus''), напротив, предъявляются жесткие требования по помехоустойчивости и предсказуемости. Обычно к промышленным сетям предъявляются следующие требования:
# жёсткая детерминированность поведения;
# обеспечение функций реального времени;
# работа на длинных линиях с использованием недорогих физических сред (в частности, витой пары);
# повышенная надёжность физического и канального уровней передачи данных в условиях производственной среды (например, при наличие мощных электромагнитных помех);
# наличие специальных высоконадежных механических соединений компонентов, обеспечивающих защиту контактов от агрессивной производственной среды.
В настоящий момент в промышленности пользуется популярностью расширение «офисного» ''Ethernet'' (IEEE 802.3) — ''Industrial Ethernet''.

Стандарт ''Industrial Ethernet'' определяет проводные соединения и электрические сигналы на физическом уровне, формат пакетов и протоколы управления доступом к среде. В ''Industrial Ethernet'' применяются промышленные витые пары ({{lang-en|Industrial Twisted Pair}}, ITP) с двойным экранированием, IE FC TP-кабелей для быстрого монтажа и ТР-кордов или стеклянные оптоволоконные кабели.

Дополнение стека протоколов TCP/IP протоколом {{RFC|1006}} обеспечивает регулярную и частую передачу по сети небольших объемов информации, что свойственно для обмена данными между промышленными контроллерами.

C помощью специальных коммутаторов можно организовать кольцевую топологию, которая при обрыве восстанавливает связь, то есть находит новый путь для передачи данных значительно быстрее, чем применяемый в обычных сетях «алгоритм избыточного дерева». При этом используется алгоритм резервирования, который позволяет провести реконфигурацию сети за 0,3 с.

Метод управления доступом — множественный доступ с контролем несущей и обнаружением коллизий ({{lang-en|Carrier Sense Multiple Access with Collision Detection}}, CSMA/CD). Скорость передачи данных для ''Industrial Ethernet'' составляет 10 Мбит/с, а для ''Industrial Fast Ethernet'' (IEEE 802.3u) — 100 Мбит/с, размер пакета данных — от 72 до 1526 байт.

Для защиты от помех в офисных и промышленных ЛВС применяют следующие методы:
# Применение витой пары в качестве среды передачи данных. Витые пары с двойным экранированием позволяют подавить синфазную помеху на 70 дБ.&lt;ref name=&quot;ZiminWW&quot;&gt;{{книга|автор=Зимин, В. В.|заглавие=Промышленные сети: Учеб. пособие для студентов вузов|место=Н. Новгород|издательство=НГТУ им. Р. Е. Алексеева|год=2008|страниц=252|isbn=978-5-93272-554-2}}.&lt;/ref&gt;
# Применение волоконно-оптических кабелей в качестве среды передачи данных, которые менее подвержены электромагнитным помехам. Но с другой стороны, этот метод сопряжен с накладными расходами по приобретению дополнительных модулей сопряжения с оптическими устройствами.&lt;ref name=&quot;ZiminWW&quot;&gt;&lt;/ref&gt;
# Применение кодирования (см. [[#Устранение помех канальным кодированием|ниже]]):
## В сетях классического ''Ethernet'' для передачи данных используется импульсная модуляция на основе манчестерского кодирования. Это импульсный код с самосинхронизацией: логическая единица кодируется перепадом потенциала от низкого уровня сигнала к высокому, а логический ноль — наоборот. Уровень высокого сигнала составляет плюс 0,85 В, низкого — минус 0,85 В. В ''Fast Ethernet'' и ''Gigabit Ethernet'' применяется избыточное кодирование: 4B/5B для первого и 8B/10B — для второго.&lt;ref&gt;{{книга|автор=Таненбаум, Э.|заглавие=Компьютерные сети|издание=4-е изд|место=Спб.|издательство=Питер|год=2003|страниц=992|isbn=5-318-00492-X}}.&lt;/ref&gt;
## На уровне физического кодирования в сетях ''TokenRing'' (IEEE 802.5) применяется дифференциальное манчестерское кодирование.&lt;ref&gt;{{книга|автор=Гук, М.|заглавие=Аппаратные средства локальных сетей. Энциклопедия|место=Спб.|издательство=Питер|год=2000|страниц=576|isbn=5-8046-0113-X}}.&lt;/ref&gt;
## В промышленной сети PROFIBUS ({{lang-en|PROcess FIeld BUS}}), описанной в EN 50170, используется способ передачи RS-485, базирующийся на полудуплексной, асинхронной синхронизации. Для физического кодирования используется код без возврата к нулю ({{lang-en|Non-Return to Zero}}, NRZ).
## В сетях CAN ({{lang-en|Controller Area Network}}, ISO 11898) также применяется NRZ-кодирование.
## В ЛВС для связи устройств АСУТП ''Foundation Fieldbus'' (IEC 61158-2) сигналы полевой шины шифруются кодом Манчестер biphase-L ({{lang-en|Manchester bi-φ-L}}).
# В некоторых случаях при передаче данных на физическом уровне OSI применяется скремблирование. '''Скремблирование''' — это приведение информации к виду, по различным характеристикам похожему на случайные данные, что выравнивает спектр сигнала, частоты появления различных символов и их цепочек, а это позволяет подавить слишком сильные спектральные составляющие сигнала, которые вызывают нежелательные наводки на соседние линии и излучение в окружающую среду.
# Для достоверности принятой информации на канальном уровне применяют дополнение пакета данных некой служебной информацией о целостности пакета. Это может быть простая контрольная сумма, выраженная в виде бита чётности (см. [[#Структурированные последовательности|ниже]]) или же набор битов. Наиболее распространенным методом верификации принятых данных является избыточный циклический контроль CRC ({{lang-en|Cycled Redundancy Control}}), и в частности, его 16-битная реализация — CRC16.
# Для увеличения надёжности применяют резервирование линий передачи данных. Например, в сетях ''TokenRing'' используется топология типа «кольцо», которая имеет преимущество по сравнению с другими типами топологий в том, что при обрыве одной связывающей линии данные будут передаваться через другую. Протокол Ethernet не позволяет использовать данный способ напрямую, но контроллеры сети ''Industrial Ethernet'' имеют возможность использовать некоторые свои входы/выходы для целей резервирования и включать их в работу во время обрыва основной линии.
# Переход в АСУТП на полевом уровне от аналогового сигнала (чаще всего, 4—20 мА) к цифровому позволяет повысить достоверность показаний измерительных приборов, так как в цифровой сигнал имеет конечное количество состояний.
# Имеется возможность совместного использования аналоговых и цифровых сигналов. Такую возможность предоставляет протокол первичной связи HART ({{lang-en|Highway Addressable Remote Transducer}} — адресуемый дистанционный магистральный преобразователь). Данный протокол основан на методе передачи данных с помощью частотной модуляции ({{lang-en|Frequency Shift Keying}}, FSK, ЧМ) в соответствие со стандартом Bell 202. Цифровая информация передаётся частотами 1200 Гц (логическая единица) и 2200 Гц (логический ноль), которые накладываются на аналоговый токовый сигнал. Так как частотно-модулированный сигнал является двуполярным, то при применении однополосной низкочастотной фильтрации аналоговые приборы не будут чувствительны к цифровому сигналу (фильтр с полосой пропускания 10 Гц вносит искажение в исходный сигнал в ±0,01 % от максимального значения аналогового сигнала).&lt;ref name=&quot;ZiminWW&quot;&gt;&lt;/ref&gt;

== Устранение помех канальным кодированием ==
Под ''кодированием'' понимается процесс представления определённых данных с помощью ограниченного набора представлений — '''символов'''. Кодовые комбинации образовываются по некой наперёд заданной совокупности правил кодирования. Данная совокупность образует так называемую '''систему кодирования'''. Обратное преобразование информации называется '''декодированием'''.

При передаче данных используется так называемое '''канальное кодирование''', которое представляет собой класс преобразований сигнала, выполняемых для повышения качества связи. В результате этого сигнал становится менее уязвимым к шуму, помехам и замираниям. Данный метод позволил более чем на 10 дБ повысить производительность при значительно меньших затратах по сравнению с другими методами, например методами увеличения мощности передатчика или размера антенны.

=== Кодирование сигнала и структурированные последовательности ===
Тему канального кодирования можно условно разделить на два раздела: кодирование (или обработка) сигнала и структурированные последовательности (или структурированная избыточность). Кодирование сигнала означает преобразование сигнала в некий «улучшенный сигнал», позволяющий сделать процесс детектирования менее подверженным ошибкам. Метод структурированных последовательностей — это преобразование последовательности данных в новую, «улучшенную последовательность», обладающую структурной избыточностью (которая вмещает избыточные биты). Эти избыточные разряды служат для определения и исправления ошибок. На выходе процедуры кодирования получается закодированный (формой сигнала или структурированной последовательностью) сигнал, имеющий лучшие пространственные характеристики, чем некодированный.

Для оценки целесообразности применения кодирования вводится понятие '''эффективности кодирования'''. При данной вероятности битовой ошибки эффективность кодирования определяется как уменьшение нормированного отношения «сигнал/шум» &lt;math&gt;E_b/N_0&lt;/math&gt;, которое достигается при использовании кодирования. Эффективность кодирования &lt;math&gt;G&lt;/math&gt; выражается в децибелах:
: &lt;math&gt;G\;(\mathrm{dB})=\left(\frac{E_b}{N_0}\right)_\mathrm{s}\;(\mathrm{dB})-\left(\frac{E_b}{N_0}\right)_\mathrm{c}\;(\mathrm{dB}),\qquad\qquad(24)&lt;/math&gt;
где &lt;math&gt;(E_b/N_0)_\mathrm{s}&lt;/math&gt; и &lt;math&gt;(E_b/N_0)_\mathrm{c}&lt;/math&gt; — значения для исходного и кодированного сигнала соответственно.

Нормированное отношение «сигнал/шум» &lt;math&gt;E_b/N_0&lt;/math&gt; определяется как
: &lt;math&gt;\frac{E_b}{N_0}=\frac{E_sT_b}{E_n/B}=\frac{E_s}{E_n}\left(\frac{B}{R_b}\right),\qquad\qquad(25)&lt;/math&gt;
где &lt;math&gt;E_b&lt;/math&gt; — энергия бита;

&lt;math&gt;N_0&lt;/math&gt; — спектральная плотность мощности шума;

&lt;math&gt;T_b&lt;/math&gt; — время передачи одного бита;

&lt;math&gt;R_b=1/T_b&lt;/math&gt; — скорость передачи битов;

&lt;math&gt;B&lt;/math&gt; — ширина полосы.

=== Кодирование сигнала ===
Для кодирования информации используют различные сигналы. Рассмотрим некоторые из них.

[[Файл:Пример антиподных сигналов.png|thumb|center|400px|Рисунок 7 — Пример антиподных сигналов.]]

'''Антиподные сигналы''' являются зеркальными отображениями друг друга, либо один сигнал является отрицательным по отношению к другому, либо они различаются между собой на 180° (противофазные сигналы). На рисунке 7 изображён набора синусоидальных антиподных сигналов таких, что &lt;math&gt;s_1(t)=-s_2(t)=\sin\omega t&lt;/math&gt;, &lt;math&gt;0\leqslant t\leqslant T&lt;/math&gt;.

Набор равноэнергетических сигналов &lt;math&gt;s_i(t)&lt;/math&gt;, &lt;math&gt;i=1,\;2,\;\ldots&lt;/math&gt;, называется '''ортонормированным''' ('''ортогональным'''), если выполняется условие:
: &lt;math&gt;\rho_{ij}=\frac{1}{E}\int\limits_0^T s_i(t)s_j(t)\,dt=\delta_{ij},\qquad\qquad(26)&lt;/math&gt;
где &lt;math&gt;\rho_{ij}&lt;/math&gt; — коэффициент взаимной корреляции;

&lt;math&gt;\delta_{ij}=\begin{cases}1, &amp; i=j, \\ 0, &amp; i\neq j\end{cases}&lt;/math&gt; — символ Кронекера;

&lt;math&gt;E&lt;/math&gt; — энергия сигнала
: &lt;math&gt;E=\int\limits_0^T s^2(t)\,dt.\qquad\qquad(27)&lt;/math&gt;
Примером таких сигналов могут служить гармонические функции. На рисунке 8 изображены сигнал &lt;math&gt;s_1(t)=\sin\omega t&lt;/math&gt; и &lt;math&gt;s_2(t)=\cos\omega t=\sin\left(\omega+\frac{\pi}{2}\right)t&lt;/math&gt;, &lt;math&gt;0\leqslant t\leqslant T&lt;/math&gt;.

[[Файл:Пример гармонических ортогональных сигналов.png|thumb|center|400px|Рисунок 8 — Пример гармонических ортогональных сигналов.]]

Ортогональными могут быть также наборы импульсных сигналов. На рисунке 9 показан набор ортогональных сигналов, которые имеют вид импульсов, имеющих следующее аналитическое выражение: &lt;math&gt;s_1(t)=p(t)&lt;/math&gt; и &lt;math&gt;s_2(t)=p\left(t-\frac{T}{2}\right)&lt;/math&gt;, &lt;math&gt;0\leqslant t\leqslant T&lt;/math&gt;. Импульс &lt;math&gt;p(t)&lt;/math&gt; имеет длительность &lt;math&gt;\tau=\frac{T}{2}&lt;/math&gt;, где &lt;math&gt;T&lt;/math&gt; — период.

[[Файл:Пример импульсного ортогонального сигнала.png|thumb|center|400px|Рисунок 9 — Пример импульсного ортогонального сигнала.]]

Если расширить значение коэффициента взаимной корреляции &lt;math&gt;\rho_{ij}&lt;/math&gt; в область отрицательных значений, то антиподные сигналы можно считать частным случаем ортогональных сигналов с &lt;math&gt;\rho_{ij}=-1&lt;/math&gt;.

Временно́е разделение сигналов позволяет осуществлять '''&lt;math&gt;M&lt;/math&gt;-арную передачу сигналов''', при которой процессор за один такт работы принимает &lt;math&gt;k&lt;/math&gt; бит данных. Процессор указывает модулятору произвести один из &lt;math&gt;M=2^k&lt;/math&gt; сигналов. Частным случаем при &lt;math&gt;k=1&lt;/math&gt; является '''двоичная передача сигнала'''. При &lt;math&gt;k&gt;1&lt;/math&gt; &lt;math&gt;M&lt;/math&gt;-арную передачу сигналов можно рассматривать как процедуру кодирования формы сигнала. При ортогональной передаче сигналов увеличение &lt;math&gt;k&lt;/math&gt; приводит к повышению достоверности передачи или уменьшению требуемого &lt;math&gt;E_s/E_n&lt;/math&gt; за счёт увеличения полосы пропускания. При неортогональной передаче сигналов улучшение эффективности использования полосы пропускания происходит за счёт снижения достоверности передачи или возрастания требуемого &lt;math&gt;E_s/E_n&lt;/math&gt;.

Как уже было сказано выше, процедура кодирования сигнала состоит в преобразовании набора сигналов (представляющих набор сообщений) в усовершенствованный набор сигналов, но при этом каждый сигнал набора пытаются сделать настолько непохожим на другие, насколько это возможно. Это требование выражает значение коэффициент взаимной корреляции &lt;math&gt;\rho_{ij}&lt;/math&gt;, которое должно быть как можно меньше. Строго это условие выполняется тогда, когда сигналы антикоррелируют (при &lt;math&gt;\rho_{ij}=-1&lt;/math&gt;). Этого можно добиться только в том случае, если в наборе всего два значения (&lt;math&gt;M=2&lt;/math&gt;) и они антиподны друг другу. На практике используют набор сигналов с большим количеством элементов. Поэтому наименьшее значение &lt;math&gt;\rho_{ij}=0&lt;/math&gt;, что соответствует системе ортогональных сигналов.

=== Ортогональные коды ===
Для набора кодовых слов, состоящего из &lt;math&gt;M&lt;/math&gt; сигналов, условие ортогональности примет вид:
: &lt;math&gt;z_{ij}=\frac{n_s-n_n}{N}=\delta_{ij},\qquad\qquad(28)&lt;/math&gt;
где &lt;math&gt;n_s&lt;/math&gt; — количество совпавших бит;

&lt;math&gt;n_n&lt;/math&gt; — количество несовпавших бит;

&lt;math&gt;N&lt;/math&gt; — общее количество бит в последовательности.

Набор однобитовых данных можно преобразовать с помощью ортогональных кодовых слов, состоящих из двух разрядов каждое, которые описываются строками матрицы &lt;math&gt;H_1&lt;/math&gt;:
{|align=center
 |align=center|Набор данных||style=&quot;width:100px&quot;|&amp;nbsp;||Набор ортогональных&lt;br /&gt;кодовых слов
 |-
 |align=center|&lt;math&gt;\begin{matrix}0 \\ 1\end{matrix}&lt;/math&gt;||style=&quot;width:100px&quot;|&amp;nbsp;||&lt;math&gt;H_1=\begin{bmatrix}0 &amp; 0 \\ 0 &amp; 1\end{bmatrix}&lt;/math&gt;
|}
Вообще, для набора &lt;math&gt;k&lt;/math&gt;-битовых данных из матрицы &lt;math&gt;H_{k-1}&lt;/math&gt; можно построить набор кодовых слов &lt;math&gt;H_k&lt;/math&gt; размерностью &lt;math&gt;2^k\times 2^k&lt;/math&gt;, который называется '''матрицей Адамара''':
: &lt;math&gt;H_k=\begin{bmatrix}H_{k-1} &amp; H_{k-1} \\ H_{k-1} &amp; \overline{H_{k-1}}\end{bmatrix},\qquad\qquad(29)&lt;/math&gt;
где черта над &lt;math&gt;H_{k-1}&lt;/math&gt; означает логическое отрицание.

Каждая пара слов в каждом наборе кодовых слов &lt;math&gt;H_1,\;H_2,\;\ldots,\;H_k,\;\ldots,\;H_{2^k}&lt;/math&gt; содержит одинаковое количество совпадающих и несовпадающих разрядов, поэтому, в соответствии с уравнением (28), &lt;math&gt;z_{ij}&lt;/math&gt; (при &lt;math&gt;i\neq j&lt;/math&gt;) и каждый из этих наборов ортогонален.

Для одинаковых, равноэнергетических ортогональных сигналов '''вероятность ошибки в кодовом слове (символе)''' &lt;math&gt;P_{\mathrm{err}}&lt;/math&gt;, можно оценить сверху, как
: &lt;math&gt;P_{\mathrm{err}}(M)\leqslant(M-1)\mathrm{erfc}\left(\sqrt{\frac{E_s}{N_0}}\right),\qquad\qquad(30)&lt;/math&gt;
где &lt;math&gt;M=2^k&lt;/math&gt; — размер набора кодовых слов;

&lt;math&gt;k&lt;/math&gt; — число информационных бит;

&lt;math&gt;E_s=kE_b&lt;/math&gt; — энергия кодового слова;

&lt;math&gt;E_b&lt;/math&gt; — энергия одного бита;

&lt;math&gt;N_0&lt;/math&gt; — спектральная плотность мощности шума;

&lt;math&gt;\mathrm{erfc}(x)&lt;/math&gt; — гауссов интеграл ошибки, равный:
: &lt;math&gt;\mathrm{erfc}(x)=\frac{1}{2\pi}\int\limits_x^\infty e^{-\frac{t^2}{2}}\,dt.\qquad\qquad(31)&lt;/math&gt;
'''Вероятность появления ошибочного бита''' &lt;math&gt;P_{\mathrm{erb}}&lt;/math&gt; можно определить как:
: &lt;math&gt;P_{\mathrm{erb}}=\frac{M}{2}\mathrm{erfc}\left(k\frac{E_s}{N_0}\right).\qquad\qquad(32)&lt;/math&gt;
Модификацией ортогонального кода является '''биортогональный код'''. Биортогональный набор сигналов, состоящий из &lt;math&gt;M&lt;/math&gt; кодовых слов (сигналов), получается из &lt;math&gt;M/2&lt;/math&gt; ортогонального набора, состоящего из сигналов, путем дополнения последнего отрицанием каждого сигнала:
: &lt;math&gt;B_k=\begin{bmatrix}H_{k-1} \\ \overline{H_{k-1}}\end{bmatrix}.\qquad\qquad(33)&lt;/math&gt;
Биортогональный набор состоит из комбинации ортогональных и антиподных сигналов, поэтому если использовать коэффициент &lt;math&gt;z_{ij}&lt;/math&gt;, то биортогональные коды можно представить следующим образом:
: &lt;math&gt;z_{ij}=\begin{cases}1, &amp; i=j; \\ -1, &amp; i\neq j,\;|i-j|=\dfrac{M}{2}; \\ 0, &amp; i\neq j,\;|i-j|\neq\dfrac{M}{2}.\end{cases}\qquad\qquad(34)&lt;/math&gt;
Одно из преимуществ биортогональных кодов перед ортогональными заключается в том, что при передаче аналогичной информации размер кодового слова биортогональных кодов вдвое меньше размера кодового слова ортогональных кодов. Следовательно, при использовании биортогональных кодов требования к полосе пропускания вдвое слабее, чем при использовании ортогональных кодов. Поскольку антиподные векторы сигналов имеют лучшие пространственные характеристики, чем ортогональные.

Для одинаковых, равноэнергетических биортогональных сигналов вероятность ошибки в кодовом слове (символе) можно оценить следующим образом:
: &lt;math&gt;P_{\mathrm{err}}(M)\leqslant(M-2)\mathrm{erfc}\left(\sqrt{\frac{E_s}{N_0}}\right)+\mathrm{erfc}\left(\sqrt{\frac{2E_s}{N_0}}\right),\qquad\qquad(35)&lt;/math&gt;

Для биортогональных кодов довольно трудно получить оценку &lt;math&gt;P_{\mathrm{erb}}&lt;/math&gt;, поэтому пользуются следующей аппроксимацией, имеющей место при &lt;math&gt;M&gt;8&lt;/math&gt;, или &lt;math&gt;k&gt;3&lt;/math&gt;:
: &lt;math&gt;P_{\mathrm{erb}}=\frac{1}{2}\left((M-2)\mathrm{erfc}\left(\sqrt{\frac{E_s}{N_0}}\right)+\mathrm{erfc}\left(\sqrt{\frac{2E_s}{N_0}}\right)\right).\qquad\qquad(36)&lt;/math&gt;
Описанные биортогональные коды значительно снижают &lt;math&gt;P_{\mathrm{erb}}&lt;/math&gt; по сравнению с ортогональными кодами и требуют только половину полосы пропускания ортогональных кодов.

Код, получаемый из ортогонального ряда путём удаления первого разряда каждого кодового слова, называется '''трансортогональным''', или '''симплексным кодом'''. Такой код описывается следующими значениями &lt;math&gt;z_{ij}&lt;/math&gt;:
: &lt;math&gt;z_{ij}=\begin{cases}1, &amp; i=j; \\ \dfrac{-1}{M-1}, &amp; i\neq j.\end{cases}\qquad\qquad(37)&lt;/math&gt;
С точки зрения минимальной энергии, необходимой для поддержания заданной вероятности ошибки, симплексный код эквивалентен равновероятному ортогональному набору.

Сравнивая достоверность передачи ортогонального, биортогонального и симплексного кодов, можно сказать, что симплексный код имеет наименьшее требуемое &lt;math&gt;E_b/N_0&lt;/math&gt; для получения определенной частоты появления символьных ошибок. Впрочем, при больших &lt;math&gt;M&lt;/math&gt; все три схемы очень похожи между собой в смысле достоверности передачи. При этом биортогональное кодирование, по сравнению с другими методами, требует лишь половины полосы пропускания.

=== Структурированные последовательности ===
Структурированные последовательности делятся на три подкатегории:
* блочные;
* свёрточные;
* турбокоды.
Рассмотрим каждый из этих типов.

При использовании '''блочных кодов''' исходные данные делятся на блоки из &lt;math&gt;k&lt;/math&gt; бит, которые называют '''информационными битами''', или '''битами сообщения'''. Каждый блок может представлять любое из &lt;math&gt;2^k&lt;/math&gt; отдельных сообщений. В процессе кодирования каждый &lt;math&gt;k&lt;/math&gt;-битовый блок данных преобразуется в больший блок из &lt;math&gt;n&lt;/math&gt; бит, который называется '''кодовым битом''', или '''канальным символом'''. К каждому блоку данных кодирующее устройство прибавляет &lt;math&gt;(n-k)&lt;/math&gt; бит, которые называются '''избыточными битами''', или '''контрольными битами'''. Если &lt;math&gt;n-k=1&lt;/math&gt;, то контрольный бит называется '''битом чётности''', или '''битом паритета''' (от {{lang-en|parity}} — чётный). Новой информации контрольные биты не несут. Блочные коды обозначаются как &lt;math&gt;(n,\;k)&lt;/math&gt;.

Отношение числа избыточных бит к числу информационных бит:
: &lt;math&gt;\frac{n-k}{k}\qquad\qquad(38)&lt;/math&gt;
называется '''избыточностью кода'''.

Отношение числа бит данных к общему числу бит &lt;math&gt;k/n&lt;/math&gt; носит название '''степень кодирования'''. Под степенью кодирования подразумевается доля кода, которая приходится на полезную информацию. Например, в коде со степенью 1/2, каждый кодовый бит несёт 1/2 бита информации.

'''Коды с контролем чётности''' для обнаружения или исправления ошибок используют линейную сумму информационных битов, которая представляется одним контрольным битом, который позже прибавляется к блоку информационных битов. Этот бит (бит чётности) может быть равен нулю или единице, причём его значение выбирается так, чтобы сумма всех битов в кодовом слове была чётной или нечётной. В операции суммирования используется арифметика по модулю 2 (операция исключающего ИЛИ). Если бит чётности выбран так, что результат чётный, то говорят, что схема имеет '''положительную чётность'''; в противном случае, говорят об '''отрицательной чётности'''.

Расширением кодов с битом паритета является '''прямоугольный''', или '''композиционный код'''. Он создаётся следующим образом. Вначале из битов сообщения строится прямоугольник, состоящий из &lt;math&gt;M&lt;/math&gt; строк и &lt;math&gt;N&lt;/math&gt; столбцов. Затем к каждой строке и каждому столбцу прибавляется бит чётности, что в результате даёт матрицу размером &lt;math&gt;(M+1)\times(N+1)&lt;/math&gt;. Любая отдельная ошибка в разряде приведёт к нарушению чётности в одном столбце и в одной из строк матрицы. Следовательно, прямоугольный код может исправить любую единичную ошибку, поскольку расположение такой ошибки однозначно определяется пересечением строки и столбца, в которых была нарушена чётность.

'''Линейные блочные коды''' — это класс кодов с контролем чётности, которые можно описать парой чисел &lt;math&gt;(n,\;k)&lt;/math&gt;. В процессе кодирования блок из &lt;math&gt;k&lt;/math&gt; символов сообщения ('''вектор сообщения''') преобразуется в больший блок из &lt;math&gt;n&lt;/math&gt; символов кодового слова ('''кодовый вектор'''), образованного с использованием элементов данного алфавита. Если алфавит состоит только из двух элементов (0 и 1), код является '''двоичным''' и включает двоичные разряды (биты). Это самые распространённые виды линейных блочных кодов.

&lt;math&gt;k&lt;/math&gt;-Битовые сообщения формируют набор из &lt;math&gt;2^k&lt;/math&gt; последовательностей сообщения, называемых '''&lt;math&gt;k&lt;/math&gt;-кортежами''' (последовательностями &lt;math&gt;k&lt;/math&gt; цифр). Процедура кодирования сопоставляет с каждым из &lt;math&gt;2^k&lt;/math&gt; &lt;math&gt;k&lt;/math&gt;-кортежей сообщения один из &lt;math&gt;2^n&lt;/math&gt; &lt;math&gt;n&lt;/math&gt;-кортежей. Следовательно, линейные блочные коды представляют взаимно однозначное соответствие, которое производится согласно, так называемой, '''таблице соответствия'''. Данный вид кодов используется в расширении сетевой технологии ''Ethernet'': в ''Fast Ethernet'' используется код 4B/5B — кодирование 4 битов информации 5 канальными битами, в ''Gigabit Ethernet'' — 8B/10B (8 бит информации — 10 канальных бит).

Важным подклассом линейных блочных кодов являются '''двоичные циклические коды'''. Линейный код &lt;math&gt;(n,\;k)&lt;/math&gt; называется '''циклическим''', если он обладает следующим свойством. Если &lt;math&gt;n&lt;/math&gt;-кортеж &lt;math&gt;U=(u_0,\;u_1,\;u_2,\;\ldots,\;u_{n-1})&lt;/math&gt; является кодовым словом, тогда &lt;math&gt;n&lt;/math&gt;-кортеж &lt;math&gt;U(1)=(u_{n-1},\;u_0,\;u_1,\;u_2,\;\ldots,\;u_{n-2})&lt;/math&gt;, полученный из &lt;math&gt;U&lt;/math&gt; с помощью циклического сдвига, также является кодовым словом. Вообще, &lt;math&gt;U(i)=(u_{n-i},\;u_{n-i+1},\;\ldots,\;u_{n-1}\;u_0,\;u_1,\;\ldots,\;u_{n-i-1})&lt;/math&gt;, полученный &lt;math&gt;i&lt;/math&gt; циклическими сдвигами, является также является кодовым словом. Данный код легко реализуется на регистре сдвига с обратной связью.

'''Коды Хэмминга''' — это простой класс блочных кодов, которые имеют следующую структуру:
: &lt;math&gt;(n,\;k)=(2^m-1,\;2^m-1-m),\qquad\qquad(39)&lt;/math&gt;
где &lt;math&gt;m=2,\;3,\;\ldots&lt;/math&gt; Они способны исправлять все однобитовые ошибки или определять все модели из двух ошибок в блоке. Для декодирование кодов Хэмминга особенно хорошо подходят, так называемые, синдромы — матрицы, представляющие собой результат проверки чётности, выполняемой над сигналом для определения его принадлежности заданному набору кодовых слов. Хотя коды Хэмминга не являются слишком мощными, они принадлежат к очень ограниченному классу блочных кодов, называемых '''совершенными'''.

Одним из наиболее практичных блочных кодов является '''двоичный расширенный код Голея''' &lt;math&gt;(24,\;12)&lt;/math&gt;, который образован путём прибавления битов чётности к совершенному коду &lt;math&gt;(23,\;12)&lt;/math&gt;, известному как '''код Голея'''. Эти дополнительные биты дают степень кодирования 1/2, реализовать которую проще (с точки зрения системного тактового генератора), чем степень кодирования кода Голея, равную 12/23. Расширенный код Голея значительно мощнее рассмотренного выше кода Хэмминга. Цена, которую приходится платить за повышение эффективности, заключается в более сложном декодере и, соответственно, более широкой полосе пропускания.

'''Коды Боуза — Чоудхури — Хоквенгема''' ('''БЧХ-коды''') являются результатом обобщения кодов Хэмминга, которое позволяет исправлять множественные ошибки. Они составляют мощный класс циклических кодов, который обеспечивает достаточную свободу выбора длины блока, степени кодирования, размеров алфавита и возможностей коррекции ошибок. Коды БХЧ очень важны, поскольку при блоках, длина которых равна порядка несколько сотен, коды БХЧ превосходят своими качествами все другие блочные коды с той же длиной блока и степенью кодирования. В наиболее часто применяемых кодах БХЧ используется двоичный алфавит и блок кодового слова длиной &lt;math&gt;n=2^m-1&lt;/math&gt;, где &lt;math&gt;m=3,\;4,\;\ldots&lt;/math&gt;

'''Коды Рида — Соломона''' — это недвоичные циклические коды, символы которых представляют собой &lt;math&gt;m&lt;/math&gt;-битовые последовательности, где &lt;math&gt;m&gt;1&lt;/math&gt;. Коды Рида — Соломона определены на &lt;math&gt;m&lt;/math&gt;-битовых символах при всех &lt;math&gt;n&lt;/math&gt; и &lt;math&gt;k&lt;/math&gt;, для которых &lt;math&gt;0&lt;k&lt;n&lt;2^m+2&lt;/math&gt;, где &lt;math&gt;k&lt;/math&gt; — число информационных битов, подлежащих кодированию, а &lt;math&gt;n&lt;/math&gt; — число кодовых символов в кодируемом блоке. Для большинства кодов Рида — Соломона
: &lt;math&gt;(n,\;k)=(2^m-1,\;2^m-1-2t),\qquad\qquad(40)&lt;/math&gt;
где &lt;math&gt;t&lt;/math&gt; — количество ошибочных битов в символе, которые может исправить код, а &lt;math&gt;2t=n-2k&lt;/math&gt; — число контрольных символов. '''Расширенный код Рида — Соломона''' можно получить при &lt;math&gt;n=2^m&lt;/math&gt; или &lt;math&gt;n=2^m+1&lt;/math&gt;, но не более того.

Коды Рида — Соломона чрезвычайно эффективны для исправления пакетов ошибок, поэтому их разновидность, называемая '''кодом Рида — Соломона с перекрестным чередованием''' ({{lang-en|cross-interleave Reed — Solomon code}}, CIRC), используется в системе цифровой записи на компакт-дисках ({{lang-en|compact disc digital audio}}, CD-DA). В данном случае существует несколько источников канальных ошибок: маленькие нежелательные частички или воздушные пузырьки в материале пластика или неточное расположение впадин при изготовлении диска и отпечатки пальцев или царапины, появившиеся при эксплуатации. Можно сказать, что канал, в основном, склонен вносить пакетоподобные ошибки, поскольку царапины или пятна от пальцев будут вызывать ошибки в нескольких последовательных фрагментах данных.

Рассмотрим теперь '''свёрточные коды'''. Для их реализации используются специальные свёрточные кодеры. Рассмотрим принцип их работы.

Исходное сообщение на входе обозначается последовательностью &lt;math&gt;\mathbf{m}=m_1,\;m_2,\;\ldots,\;m_i,\;\ldots&lt;/math&gt;, где &lt;math&gt;m_i&lt;/math&gt; — двоичный знак (бит), а &lt;math&gt;i&lt;/math&gt; — индекс времени. Предполагается, что все &lt;math&gt;m_i&lt;/math&gt; равновероятно равны единице или нулю и независимы между собой. Будучи независимой, последовательность битов нуждается в некоторой избыточности, то есть знание о бите &lt;math&gt;m_i&lt;/math&gt; не даёт никакой информации о бите &lt;math&gt;m_j&lt;/math&gt; (при &lt;math&gt;i\neq j&lt;/math&gt;). Кодер преобразует каждую последовательность &lt;math&gt;\mathbf{m}&lt;/math&gt; в уникальную последовательность кодовых слов &lt;math&gt;\mathbf{U}=G(\mathbf{m})&lt;/math&gt;. Даже несмотря на то, что последовательность &lt;math&gt;\mathbf{m}&lt;/math&gt; однозначно определяет последовательность &lt;math&gt;\mathbf{U}&lt;/math&gt;, ключевой особенностью свёрточных кодов является то, что данный &lt;math&gt;k&lt;/math&gt;-кортеж внутри &lt;math&gt;\mathbf{m}&lt;/math&gt; не однозначно определяет связанные с ним &lt;math&gt;n&lt;/math&gt;-кортежи внутри &lt;math&gt;\mathbf{U}&lt;/math&gt;, поскольку кодирование каждого из &lt;math&gt;k&lt;/math&gt;-кортежей является функцией не только &lt;math&gt;k&lt;/math&gt;-кортежей, но и предыдущих &lt;math&gt;K&lt;/math&gt; &lt;math&gt;k&lt;/math&gt;-кортежей. Последовательность &lt;math&gt;\mathbf{U}&lt;/math&gt; можно разделить на последовательность кодовых слов: &lt;math&gt;\mathbf{U}=U_1,\;U_2,\;\ldots,\;U_i,\;\ldots&lt;/math&gt; Каждое кодовое слово &lt;math&gt;U_i&lt;/math&gt; состоит из двоичных кодовых символов, часто называемых '''канальными символами''', '''канальными битами''', или '''битами кода''', в отличие от битов входного сообщения, кодовые символы не являются независимыми.

[[Файл:Свёрточный кодер.png|thumb|center|500px|Рисунок 10 — Свёрточный кодер с длиной кодового ограничения &lt;math&gt;\scriptstyle{K}&lt;/math&gt; и степенью кодирования &lt;math&gt;\scriptstyle{k/n}&lt;/math&gt;.]]

Обычный свёрточный кодер, показанный на рисунке 10, реализуется &lt;math&gt;kK&lt;/math&gt;-разрядным регистром сдвига и &lt;math&gt;n&lt;/math&gt; сумматорами по модулю 2, где &lt;math&gt;K&lt;/math&gt; — длина кодового ограничения. '''Длина кодового ограничения''' — это количество &lt;math&gt;k&lt;/math&gt;-битовых сдвигов, после которых один информационный бит может повлиять на выходной сигнал кодера. В каждый момент времени на место первых &lt;math&gt;k&lt;/math&gt; разрядов регистра перемещаются &lt;math&gt;k&lt;/math&gt; новых бит. Все биты в регистре смещаются на &lt;math&gt;k&lt;/math&gt; разрядов вправо, и выходные данные &lt;math&gt;n&lt;/math&gt; сумматоров последовательно дискретизируются, давая, в результате, биты кода. Затем эти символы кода используются модулятором для формирования сигналов, которые будут переданы по каналу. Поскольку для каждой входной группы из &lt;math&gt;k&lt;/math&gt; бит сообщения имеется &lt;math&gt;n&lt;/math&gt; бит кода, степень кодирования равна &lt;math&gt;k/n&lt;/math&gt; бит сообщения на бит кода, где &lt;math&gt;k&lt;n&lt;/math&gt;.

Наиболее часто используются двоичные свёрточные кодеры, для которых &lt;math&gt;k=1&lt;/math&gt;, то есть биты сообщения сдвигаются по одному биту за такт. Таким образом, за &lt;math&gt;i&lt;/math&gt;-й момент времени бит сообщения &lt;math&gt;m_i&lt;/math&gt; будет перемещён на место первого разряда регистра сдвига, все предыдущие биты в регистре будут смещены на один разряд вправо, а выходной сигнал &lt;math&gt;n&lt;/math&gt; сумматоров будет последовательно оцифрован и передан. Поскольку для каждого бита сообщения имеется &lt;math&gt;n&lt;/math&gt; бит кода, то степень кодирования равна &lt;math&gt;1/n&lt;/math&gt;. Имеющиеся в момент времени &lt;math&gt;t_i&lt;/math&gt; &lt;math&gt;n&lt;/math&gt; кодовых символов составляют &lt;math&gt;i&lt;/math&gt;-е кодовое слово ветви &lt;math&gt;U_1=u_{1i},\;u_{2i},\;\ldots,\;u_{ni}&lt;/math&gt;, где &lt;math&gt;u_{ji}&lt;/math&gt; (&lt;math&gt;j=1,\;2,\;\ldots,\;n&lt;/math&gt;) — это &lt;math&gt;j&lt;/math&gt;-й кодовый символ, принадлежащий &lt;math&gt;i&lt;/math&gt;-му кодовому слову ветви.

Для описания свёрточного кода нужно определить кодирующую функцию &lt;math&gt;G(\mathbf{m})&lt;/math&gt;. Для этого существует несколько методов, наиболее наглядный из которых является представление функции в виде древовидной диаграммы, где каждый лист является одной из возможных альтернатив значения &lt;math&gt;u_{ji}&lt;/math&gt;.

Для приёма сообщений, представленных свёрточными кодами, используются '''свёрточные декодеры'''. При передаче информации по линиям связи в зашумленной среде неизбежно происходит искажение информации. Поэтому цель декодера не просто обратить действие кодера на информацию, но и сделать это с максимально возможной степенью правдоподобия.

Принятие решений о том, что принятая искажённая последовательность соответствует переданной, основывается на '''принципе максимального правдоподобия'''. Принцип — это формализация способа принятия решений, основанного на «здравом смысле», когда имеются статистические данные о вероятностях. В основу принципа положено предположение, что если все входные последовательности сообщений равновероятны, то минимальная вероятность ошибки получается при использовании декодера, который сравнивает условные вероятности и выбирает максимальную. Условные вероятности также называются '''функциями правдоподобия''' &lt;math&gt;P\left(\mathbf{Z}\mid\mathbf{U}^{(m)}\right)&lt;/math&gt;, где &lt;math&gt;\mathbf{Z}&lt;/math&gt; — это принятая последовательность, а &lt;math&gt;\mathbf{U}^{(m)}&lt;/math&gt; — одна из возможных переданных последовательностей. Декодер выбирает &lt;math&gt;\mathbf{U}^{(m')}&lt;/math&gt;, если
: &lt;math&gt;P\bigl(\mathbf{Z}\mid\mathbf{U}^{(m')}\bigr)=\max_{\forall\mathbf{U}^{(m)}}P\left(\mathbf{Z}\mid\mathbf{U}^{(m)}\right).\qquad\qquad(41)&lt;/math&gt;
Улучшением декодера максимального правдоподобия являются декодеры, построенные по '''алгоритму декодирования Витерби'''. Данный алгоритм уменьшает вычислительную нагрузка за счёт использования особенностей структуры конкретной решётки кода. Преимущество декодирования Витерби, по сравнению с декодированием по методу «грубой силы», заключается в том, что сложность декодера Витерби не является функцией количества символов в последовательности кодовых слов. Алгоритм включает в себя вычисление '''расстояния''' (мера подобия) между сигналом, полученным в момент времени &lt;math&gt;t_i&lt;/math&gt; и всеми путями решётки, входящими в каждое состояние в момент времени &lt;math&gt;t_i&lt;/math&gt;. В алгоритме Витерби не рассматриваются те пути решётки, которые, согласно принципу максимального правдоподобия, заведомо не могут быть оптимальными. Если в одно и то же состояние входят два пути, выбирается тот, который имеет лучшую метрику; такой путь называется '''выживающим'''. Отбор выживающих путей выполняется для каждого состояния. Таким образом, декодер углубляется в решётку, принимая решения путём исключения менее вероятных путей. Предварительный отказ от маловероятных путей упрощает процесс декодирования.

В качестве меры подобия используется '''расстояние Хэмминга''' — метрика различия объектов одинаковой размерности. Расстоянием Хэмминга &lt;math&gt;d(\mathbf{X},\;\mathbf{Y})&lt;/math&gt; между двумя двоичными последовательностями &lt;math&gt;\mathbf{X}&lt;/math&gt; и &lt;math&gt;\mathbf{Y}&lt;/math&gt; длины &lt;math&gt;n&lt;/math&gt; называется число позиций, в которых они различны.

'''Турбокоды''' впервые были введены в 1993 году Берру, Главье и Цитимаджимой. Турбокод можно считать обновлением структуры каскадного кодирования с итеративным алгоритмом декодирования связанной кодовой последовательности. Схема '''каскадного кодирования''' впервые была предложена Форни как метод получения высокоэффективного кода посредством комбинации двух или более компонуемых (составных) кодов. В результате, такие коды могут корректировать ошибки в значительно более длинных кодах и имеют структуру, которая позволяет относительно легко осуществить декодирование средней сложности. Последовательные каскадные коды часто используются в системах с ограничением мощности, таких как космические зонды. Самая распространенная из этих схем содержит внешний код Рида — Соломона (выполняется первым, убирается последним), который следует за свёрточным внутренним кодом (выполняется последним, убирается первым). Туброкоды могут быть последовательными и параллельными с последующей конкатенацией (объединением) результатов. Кодирование производится как итерационными, так и рекурсивными методами.

'''Декодирование турбокодов''' производится методами аналогичными методам декодирования свёрточных кодов. Здесь имеет место быть '''принцип максимума апостериорной вероятности''' ({{lang-en|maximum a posteriori}}, MAP). Аналогом алгоритма Витерби при турбокодирование являются алгоритмы Бала или его модификация — алгоритм Берру.

Наличие нескольких декодеров в составе декодера турбокода позволяет осуществлять, так называемую, '''обратную связь декодирования''', которая позволяет влиять результатам декодирования одного декодера на результаты другого.

== Методы приёма сигналов ==
Приём сигналов базируется на следующем утверждении: принимая любой сигнал, мы обязательно что-то о нём знаем и чего-то не знаем. Предварительные сведения о сигнале используются для рационального выбора метода приёма в соответствии с поставленными целями. Если бы о сигнале заранее не было известно абсолютно ничего, то его нельзя было бы принять, так как не известно было бы, чем сигнал отличается от несигнала, в частности, от любой помехи.

То, чего мы заранее не знаем, может являться носителем полезной информации. Если бы о сигнале нам абсолютно все было известно наперед, то такой сигнал не нужно было бы и передавать: он не принес бы нам никакой информации.

Говоря конкретно, объектом априорного знания или незнания могут являться те или иные физические параметры сигнала, например, интенсивность, несущая частота, время появления, длительность, и так далее.

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

Другие же параметры можно так или иначе модулировать. Эти параметры называются информационными. В их изменениях, неизвестных заранее на приёмной стороне, заложена переносимая сигналом информация. Обычно известен лишь диапазон возможных изменений информационных параметров.

В зависимости от назначения сигналов, задачи приёма сводятся к трём основным:
# обнаружение сигнала;
# различение сигналов;
# восстановление сообщения.

=== Обнаружение сигнала ===
Под '''обнаружением''' (детектированием) сигнала понимается установление его наличия. При наличии шума (аддитивной помехи) задача сводится к получению ответа на вопрос — имеется ли на входе приёмника сигнал плюс шум, или только шум?

Кратко, обнаружение сигнала — это констатация наличия сигнала.

Часто ошибочно полагают, что обнаружение сигнала не требует измерения каких-либо параметров сигнала. Всякое обнаружение неразрывно связано с измерением тех или иных параметров. Более того: обнаружение это, в сущности, и есть измерение, хотя и грубое. В самом деле: когда обнаруживают сигнал, то обнаруживают его не вообще, а в определённой полосе частот, в определённом интервале времени и так далее. Интервалы, в которых заключены значения этих параметров, определяют точность, с которой они измеряются. В дальнейшем, если требуется, точность может быть повышена.

Если имеется возможность обнаружить сигнал, то есть отличить наличие сигнала от его отсутствия, то это открывает возможность передачи любой информации при помощи двоичного кода. Наличие сигнала (посылка) будет соответствовать символу 1, отсутствие сигнала (пауза) — символу 0. Такая система носит название '''передачи с пассивной паузой''', так как в паузе передатчик бездействует.

В теории приёма-передачи данных важным понятием является «оптимальный приёмник», или применительно к поставленной задаче — «'''оптимальный обнаружитель'''». Под оптимальным обнаружителем понимается теоретически наилучший вид приёмника, позволяющий детектировать наличие заранее известного сигнала при максимальном уровне отношения «сигнал/помеха». В качестве такого может служить '''согласованный фильтр'''. Согласованный фильтр рассчитывается для обнаружения сигнала заранее известной формы, выходной сигнал фильтра при этом не совпадает по форме ни со входным, ни с сигналом, для обнаружения которого фильтр предназначен (кроме импульса с огибающей гауссовой формы). Сигнал, с которым фильтр согласован, детектируется однозначно, поскольку именно при его наличии во входном сигнале с шумом амплитуда выходного сигнала фильтра максимальна.&lt;ref&gt;{{книга|автор=Гоноровский, И. С.|заглавие=Радиотехнические цепи и сигналы: Учебник для вузов|издание=4-е изд., перераб. и доп|место={{М.}}|издательство=Радио и связь|год=1986|страниц=512}}&lt;/ref&gt;

Передаточная функция фильтра имеет вид:
: &lt;math&gt;\mathbf{K}(i\omega)=K(\omega)\cdot e^{i\varphi_K(\omega)},\qquad\qquad(42)&lt;/math&gt;
где &lt;math&gt;K(\omega)&lt;/math&gt; — амплитудно-частотная характеристика (АЧХ) фильтра;

&lt;math&gt;\varphi_K(\omega)&lt;/math&gt; — фазочастотная характеристика (ФЧХ) фильтра.

Для отыскания оптимальной передаточной функции, максимизирующей отношение «сигнал/помеха» на выходе фильтра при наличии помехи с равномерной спектральной плотностью мощности, необходимо составить отношение:
: &lt;math&gt;\frac{s_\mathrm{out}(t_0)}{\sigma_\mathrm{out}}=\frac{\left|\dfrac{1}{2\pi}\int\limits_{-\infty}^{+\infty}\mathbf{S}(i\omega)\mathbf{K}(i\omega)e^{i\cdot\omega t_0}\,d\omega\right|}{\sqrt{\dfrac{N_0}{2\pi}\int\limits_{-\infty}^{+\infty}K^2(\omega)\,d\omega}},\qquad\qquad(43)&lt;/math&gt;
где &lt;math&gt;t_0&lt;/math&gt; — момент времени, в который наблюдается максимум выходного сигнала;

&lt;math&gt;s_\mathrm{out}(t_0)&lt;/math&gt; — пиковое значение сигнала на выходе фильтра;

&lt;math&gt;\sigma_\mathrm{out}&lt;/math&gt; — среднеквадратичное значение помехи на выходе фильтра;

&lt;math&gt;\mathbf{S}(i\omega)&lt;/math&gt; — спектральная плотность сигнала.

Используя неравенство Буняковского — Шварца, получим:
: &lt;math&gt;\frac{s_\mathrm{out}(t_0)}{\sigma_\mathrm{out}}\leqslant\frac{1}{\sqrt{N_0}}\cdot\sqrt{\frac{1}{2\pi}\int\limits_{-\infty}^{+\infty}S^2(\omega)\,d\omega}=\sqrt{\frac{E}{N_0}},\qquad\qquad(44)&lt;/math&gt;
где &lt;math&gt;E&lt;/math&gt; — полная энергия входного сигнала.

Неравенство (44) обращается в равенство при
: &lt;math&gt;\mathbf{K}(i\omega)e^{i\omega t_0}=A\cdot\mathbf{S}^*(i\omega),\qquad\qquad(45)&lt;/math&gt;
где &lt;math&gt;A&lt;/math&gt; — произвольная постоянная;

&lt;math&gt;\mathbf{S}^*(i\omega)&lt;/math&gt; — функция, комплексно-сопряженная с  &lt;math&gt;\mathbf{S}(i\omega)&lt;/math&gt;,

Выражение (45) можно представить как
: &lt;math&gt;\mathbf{K}(i\omega)e^{i\omega t_0}=A\cdot S(\omega)\cdot e^{-i\cdot(\varphi_S(\omega)+\omega t)},\qquad\qquad(46)&lt;/math&gt;
где &lt;math&gt;\varphi_S(\omega)&lt;/math&gt; — фаза спектральной плотности сигнала;

&lt;math&gt;S(\omega)&lt;/math&gt; — модуль спектральной плотности сигнала.

Отношение (46) определяет передаточную функцию фильтра, обеспечивающего максимум отношения «сигнал/помеха» на выходе.

Из принципа физической реализуемости согласованного фильтра следует, что время достижения максимального сигнала на выходе фильтра &lt;math&gt;t_0&lt;/math&gt; равно длительности импульса &lt;math&gt;T_s&lt;/math&gt;.

Для того чтобы достоверно говорить об обнаружении сигнала в смеси «сигнал+шум», необходимо, чтобы выполнялось неравенство&lt;ref&gt;{{книга|автор=Харкевич, А. А.|заглавие=Борьба с помехами|издание=2-е изд., доп. и перераб|место={{М.}}|издательство=Наука|год=1965|страниц=276}}&lt;/ref&gt;:
: &lt;math&gt;s_\mathrm{out}\geqslant s_p,\qquad\qquad(47)&lt;/math&gt;
где &lt;math&gt;s_p&lt;/math&gt; — некое пороговое значение напряжения, конкретно заданное для каждого вида сигнала.

'''Пороговое напряжение''' &lt;math&gt;s_p&lt;/math&gt; определяется как:
: &lt;math&gt;s_p=E_\mathrm{mix}E_\mathrm{s}\cos\vartheta,\qquad\qquad(48)&lt;/math&gt;
где &lt;math&gt;E_\mathrm{mix}&lt;/math&gt; — энергия смеси «сигнал+шум»;

&lt;math&gt;E_\mathrm{s}&lt;/math&gt; — энергия сигнала;

&lt;math&gt;\cos\vartheta&lt;/math&gt; — косинус угла при вершине конуса, образованного векторами системы сигналов.

Например, для ортогональных сигналов &lt;math&gt;\cos\vartheta=0&lt;/math&gt;. Таким образом, для определения наличия сигнала в смеси, нужно наличие положительного потенциала на выходе согласованного фильтра в момент времени &lt;math&gt;t_0=T_s&lt;/math&gt;.

=== Различение сигналов ===
При передаче двух различных сигналов, &lt;math&gt;s_1&lt;/math&gt; и &lt;math&gt;s_2&lt;/math&gt;, положение несколько иное. Здесь речь идёт уже не об обнаружении, а о различении двух сигналов. Дело сводится к ответу на вопрос: имеется ли на входе приёмника сигнал &lt;math&gt;s_1&lt;/math&gt; плюс шум, или сигнал &lt;math&gt;s_2&lt;/math&gt; плюс шум? Ответ на этот вопрос определяется уже не свойствами каждого сигнала в отдельности, эти свойства в принципе могли бы оставаться неизвестными, а '''физическим различием''' между сигналами. Сигналы могут различаться между собою значениями тех или иных параметров. При выборе двух сигналов нужно стремиться к тому, чтобы различие между ними было по возможности более стойким по отношению к действию помехи. Это значит, прежде всего, что различие должно быть по возможности велико, с тем, что если оно уменьшится в процессе передачи под действием помехи, то оставшееся различие должно быть все же достаточно для уверенного различения сигналов. Но, кроме того, нужно выбирать различие по тому параметру (из всех параметров данного сигнала), который в наименьшей степени подвержен влиянию помехи данного типа.

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

Передача двоичным кодом, в котором символу 1 соответствует сигнал &lt;math&gt;s_1&lt;/math&gt;, а символу 0 — сигнал &lt;math&gt;s_2&lt;/math&gt;, называется '''передачей с активной паузой'''.

Случай различения многих сигналов в принципиальном отношении мало отличается от случая различения двух сигналов. Все сказанное выше по поводу различения двух сигналов должно быть отнесено в случае набора из нескольких сигналов к любой паре сигналов, входящих в этот набор. Однако техника различения многих сигналов может оказаться существенно отличной от техники различения двух сигналов.

=== Восстановление сигналов ===
Задача '''восстановления''' сообщения значительно отличается от задач обнаружения и различения сигналов. Она состоит в том, чтобы получить выходной сигнал &lt;math&gt;y(t)&lt;/math&gt;, наименее отличающийся от передаваемого сообщения &lt;math&gt;x(t)&lt;/math&gt;. При этом существенно, что сообщение &lt;math&gt;x&lt;/math&gt; заранее неизвестно; известно лишь, что оно принадлежит к некоторому множеству. При таких условиях можно рассматривать данное сообщение как одну из реализаций некоторого случайного процесса. Следовательно, заранее известными могут быть только распределения или моменты распределения этого процесса. В частности, на приёмной стороне могут быть заранее известны мощность и спектр случайного процесса, реализацией которого является передаваемое сообщение. Борьба с помехами при такой постановке задачи, конечно, более трудна.

При восстановлении сообщения нужно опираться на некоторый '''критерий верности''', на основе которого оценивается уклонение выходного сигнала &lt;math&gt;y&lt;/math&gt; от передаваемого сообщения &lt;math&gt;x&lt;/math&gt;. Этот критерий должен, вообще говоря, выводиться из требований, предъявляемых к передаче данного вида сообщений.

Существует несколько критериев верности:
# Часто применяется '''критерий квадратичного уклонения'''. Для непрерывных функций, заданных на интервале &lt;math&gt;(a,\;b)&lt;/math&gt;, квадратичное уклонение выражается соотношением:
#: &lt;math&gt;\varepsilon_2=\int\limits_a^b [x(t)-y(t)]^2\,dt.\qquad\qquad(49)&lt;/math&gt;
# Можно применить '''критерий абсолютного уклонения''':
#: &lt;math&gt;\varepsilon_\mathrm{abs}=\int\limits_a^b |x(t)-y(t)|\,dt.\qquad\qquad(50)&lt;/math&gt;
# Можно также воспользоваться '''критерием наибольшего уклонения''':
#: &lt;math&gt;\varepsilon_{\max}=\max_{a\leqslant t\leqslant b} |x(t)-y(t)|.\qquad\qquad(51)&lt;/math&gt;
Нет решительно никаких общих оснований для предпочтения одного критерия другому. Критерий квадратичного уклонения применяется особенно часто только потому, что при пользовании этим критерием получаются, как правило, сравнительно простые выкладки.

Если получателем сообщения является человек, то критерий верности должен, естественно, выбираться на основе свойств восприятия человеком данного вида сообщений. Так, например, при передаче звука критерий верности должен строиться на основе психофизиологических свойств слуха, а при передаче изображений — на основе свойств зрения.

Если непрерывное сообщение &lt;math&gt;x(t)&lt;/math&gt; вырабатывается некой телеметрической системой и отображает изменение во времени наблюдаемой физической величины, то критерий верности сводится к точности измерения, требования к которой выводятся из общего назначения данного измерения и условий применения его результатов.

== Понятие помехоустойчивости ==
Основы теории помехоустойчивости заложены В. А. Котельниковым в работе «Теория потенциальной помехоустойчивости»&lt;ref&gt;{{книга|автор=Котельников, В. А.|заглавие=Теория потенциальной помехоустойчивости|место={{М.}}|издательство=Госэнергонздат|год=1956|страниц=152}}&lt;/ref&gt; (1956). В этой работе впервые поставлены и решены многие основные задачи и введён ряд фундаментальных понятий. Она с полным основанием считается классическим исследованием проблемы помехоустойчивости.

'''Помехоустойчивость технического устройства (системы)''' — способность устройства (системы) выполнять свои функции при наличии помех. Её оценивают интенсивностью помех, при которых нарушение функций устройства ещё не превышает допустимых пределов.&lt;ref&gt;''Кобзарев, Ю. Б.'' Помехоустойчивость / БСЭ. — 3-е изд. — {{М.}}: Большая советская энциклопедия, 1974. — Т. 46.&lt;/ref&gt; Эта общая формулировка должна быть уточнена применительно к различным условиям передачи, то есть должна быть установлена количественная мера помехоустойчивости.

Прежде всего, помехоустойчивость понимается как свойство системы передачи в целом. Но из-за сложности данной задачи имеет смысл говорить о помехоустойчивости отдельных звеньев системы. Так, можно говорить о помехоустойчивости кодов, о помехоустойчивости видов модуляции, о помехоустойчивости приёмников. При этом часто достаточно оперировать сравнительной или относительной помехоустойчивостью, что позволяет сравнить между собою различные варианты технических решений.

Требования к помехоустойчивости различных устройств отличаются большим разнообразием: так, в радиолокационных системах иногда считают допустимым пропуск отдельных радиолокационных станцией (за время однократного обзора контролируемой ею области пространства) до половины объектов, подлежащих обнаружению, а в системах передачи данных, использующих ЭВМ, часто недопустима потеря даже одного передаваемого бита из порядка &lt;math&gt;10^9&lt;/math&gt;.

Предельно достижимая помехоустойчивость называется, по В. А. Котельникову, '''потенциальной помехоустойчивостью'''. Сравнение фактической помехоустойчивости каждого конкретного устройства с его потенциальной помехоустойчивостью даёт оценку качества устройства и показывает наличие ещё неиспользованных резервов.

Действие помехи проявляется в том, что принятый сигнал (а следовательно, и сообщение) отличается от переданного. Поэтому помехоустойчивость можно характеризовать как степень соответствия принятого сигнала (или сообщения) переданному при заданной помехе. Таким образом, при сравнении нескольких систем та из них будет более помехоустойчивой, в которой при одинаковой помехе различие между принятым и переданным сигналами (или сообщениями) будет меньше.

Ввести единое количественное определение помехоустойчивости затруднительно, так как критерий соответствия принятого сигнала переданному и характеристики действующей в системе помехи могут в зависимости от условий передачи существенно различаться.

Вместе с тем оказывается полезным ввести определение меры соответствия принятого сигнала переданному. С одной стороны, эта мера зависит от помехи, и характеризует помехоустойчивость с необходимой полнотой. С другой стороны, эта мера, взятая не как функция помехи, а как численный показатель системы, работающей в заданных условиях, представляет собой показатель, вполне характеризующий систему с точки зрения потребителя.

Для обозначения степени соответствия принятого сообщения переданному используют термин '''верность'''. Количественную меру соответствия выбирают в зависимости от характера сообщения: дискретный или непрерывный.

Рассмотрим первый случай. Пусть сообщение представляет собой последовательность символов из некоторого ансамбля (то есть конечного множества, заданного вместе с априорными вероятностями его элементов). В этом случае влияние помехи проявляется в том, что вместо фактически переданного символа принимается какой-либо другой. Такое событие называют '''ошибкой'''. Так как ошибка есть случайное событие, то верность естественно характеризовать вероятностью отсутствия ошибки, то есть вероятностью правильного приёма. Если вероятность ошибки обозначена &lt;math&gt;P_\mathrm{err}&lt;/math&gt;, то вероятность правильного приёма
: &lt;math&gt;P_\mathrm{pr}=1-P_\mathrm{err}.\qquad\qquad(52)&lt;/math&gt;
На практике мера верности или, верность выражается положительным числом &lt;math&gt;S&lt;/math&gt;, определяемым как:
: &lt;math&gt;S=-\mathrm{lg}\,P_\mathrm{err}=-\mathrm{lg}\,(1-P_\mathrm{pr}).\qquad\qquad(53)&lt;/math&gt;
В случае передачи непрерывных функций нельзя столь же легко ввести количественную меру верности, так как в этом случае нет простой системы событий (ошибка есть — ошибки нет). При передаче непрерывного сообщения отличие принятого сообщения от переданного имеет также непрерывный характер. Поэтому мерой несоответствия или уклонения может служить некоторая величина &lt;math&gt;\varepsilon&lt;/math&gt;, представляющая собой расстояние между принятым и переданным сообщениями, или критерий верности, рассмотренный ранее.

Количественную меру верности вводят, определив её возрастающей функцией вероятности:
: &lt;math&gt;P=P(\varepsilon\leqslant\varepsilon_0),\qquad\qquad(54)&lt;/math&gt;
то есть вероятности того, что уклонение &lt;math&gt;\varepsilon&lt;/math&gt; не превзойдёт некоторой заранее назначенной величины &lt;math&gt;\varepsilon_0&lt;/math&gt;.

Выясним связь между верностью и отношением «сигнал/помеха».

Верность тем ниже, чем больше относительная интенсивность помехи, то есть чем меньше отношение «сигнал/помеха», или верность есть возрастающая функция отношения «сигнал/помеха». Но что отношение «сигнал/помеха» — не единственный фактор, влияющий на верность. Во-первых, при неизменной мощности сигнала можно выбирать разные системы сигналов — строить множество сигналов с различными расстояниями между элементами этого множества. Выбор расстояний должен быть таков, чтобы помеха с заданными свойствами в наименьшей степени влияла на различимость принятых сигналов. В простейшем случае дело сводится к построению системы сигналов с наибольшими расстояниями. Во-вторых, верность зависит от способа приёма, так что она может быть различной при одном и том же отношении «сигнал/помеха». Часто отношение «сигнал/помеха» в некотором звене приёмника больше, чем то же отношение на входе приёмника. Канал же характеризуется именно отношением «сигнал/помеха» на выходе линии, то есть на входе приёмника. Правильно сконструированный приёмник может увеличить отношение «сигнал/помеха», и притом весьма значительно.

Как уже было сказано выше, следует говорить о помехоустойчивости отдельных звеньев системы передачи.

Под '''помехоустойчивостью кода''' нужно понимать верность при заданном отношении «сигнал/помеха» и при определённом способе приёма.

'''Помехоустойчивость системы модуляции''' непосредственно характеризуется относительным изменением модулируемого параметра под действием данной помехи. Можно сравнивать различные системы модуляции по относительному увеличению отношения «сигнал/помеха», даваемому некоторым идеализированным приёмником.

'''Помехоустойчивость приёмника''' также удобно выражать относительным увеличением отношения «сигнал/помеха», сравнивая значение этого отношения на выходе звена приемника, производящего основную обработку сигнала, со значением того же отношения на входе приёмника.

Более широким понятием, чем помехоустойчивость, является '''помехозащищённость'''. Это способность системы связи противостоять воздействию мощных помех. Помехозащищённость включает в себя скрытность системы связи и ее помехоустойчивость, так как для создания мощных помех надо сначала обнаружить систему связи и измерить основные параметры её сигналов, а затем организовать мощную, наиболее сильнодействующую помеху. Чем выше скрытность и помехоустойчивость, тем выше помехозащищённость системы связи.

== Литература ==
# {{книга|автор=Бойерле, Х. П., Беценар, Г. Бах|заглавие=Коммуникация в технике автоматизации|издание=Пер. с нем|место=Берлин, Мюнхен|издательство=АО Siemens|год=1991|страниц=155|isbn=3-8009-1563-4}}.
# {{книга|автор=Варакин, Л. Е.|заглавие=Теория систем сигналов|место={{М.}}|издательство=Советское радио|год=1978|страниц=375}}
# {{книга|автор=Гоноровский, И. С.|заглавие=Радиотехнические цепи и сигналы: Учебник для вузов|издание=4-е изд., перераб. и доп|место={{М.}}|издательство=Радио и связь|год=1986|страниц=512}}
# {{книга|автор=Гук, М.|заглавие=Аппаратные средства локальных сетей. Энциклопедия|место=Спб.|издательство=Питер|год=2000|страниц=576|isbn=5-8046-0113-X}}.
# {{книга|заглавие=Защита от радиопомех|ответственный=Под ред. М. В. Максимова|место={{М.}}|издательство=Советское радио|год=1976|страниц=496}}
# {{книга|автор=Зимин, В. В.|заглавие=Промышленные сети: Учеб. пособие для студентов вузов|место=Н. Новгород|издательство=НГТУ им. Р. Е. Алексеева|год=2008|страниц=252|isbn=978-5-93272-554-2}}.
# {{книга|автор=Олифер, В. Г., Олифер,  Н. А.|заглавие=Компьютерные сети. Принципы, технологии, протоколы: Учебник для вузов|издание=3-е изд|место=СПб.|издательство=Питер|год=2006|страниц=958|isbn=5-469-00504-6}}.
# {{книга|автор=Осмоловский, С. А.|заглавие=Стохастические методы передачи данных|место={{М.}}|издательство=Радио и связь|год=1991|страниц=240}}
# {{книга|автор=Отт, Г.|заглавие=Методы подавления шумов и помех в электронных системах|ответственный=Пер. с англ|место={{М.}}|издательство=Мир|год=1979|страниц=318}}
# {{книга|автор=Скляр, Б.|заглавие=Цифровая связь. Теоретические основы и практическое применение|ответственный=Пер. с англ|издание=2-е изд, испр|место={{М.}}|издательство=Издательский дом «Вильямс»|год=2003|страниц=1104|isbn=5-8459-0497-8}}.
# {{книга|автор=Таненбаум, Э.|заглавие=Компьютерные сети|издание=4-е изд|место=Спб.|издательство=Питер|год=2003|страниц=992|isbn=5-318-00492-X}}.
# {{книга|автор=Трахтман, А. М., Трахтман, В. А.|заглавие=Основы теории дискретных сигналов на конечных интервалах|место={{М.}}|издательство=Советское радио|год=1975|страниц=208}}
# {{книга|автор=Тузов, Г. И.|заглавие=Статистическая теория приёма сложных сигналов|место={{М.}}|издательство=Советское радио|год=1977|страниц=400}}
# {{книга|автор=Финк, Л. М.|заглавие=Теория передачи дискретных сообщений|издание=2-е изд., перераб. и доп|место={{М.}}|издательство=Советское радио|год=1970|страниц=728}}
# {{книга|автор=Харкевич, А. А.|заглавие=Борьба с помехами|издание=2-е изд., доп. и перераб|место={{М.}}|издательство=Наука|год=1965|страниц=276}}
# {{книга|автор=Хармут, Х. Ф.|заглавие=Передача информации ортогональными функциями|место={{М.}}|издательство=Связь|год=1975|страниц=272}}
# {{книга|автор=Хелд, Г.|заглавие=Технология передачи данных|издание=7-е изд|место=СПб.|издательство=Питер|год=2003|страниц=720|isbn=5-94723-472-6}}.

== Примечания ==
{{примечания}}</text>
      <sha1>qrgu6k0jeadyly8kpvg1jxsm8xciw6v</sha1>
    </revision>
  </page>
  <page>
    <title>Iptables</title>
    <ns>0</ns>
    <id>10981</id>
    <revision>
      <id>270435</id>
      <parentid>256788</parentid>
      <timestamp>2026-10-27T07:38:31Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270435</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="409244" sha1="kebkhdjg3mul0fcwwahi0p551eopidf" xml:space="preserve">{{Название учебника
|Категория = Программное обеспечение
|Тип = Одностраничный
|Готовность = 50%
}}
{{Википедия}}
'''iptables''' — утилита командной строки, является стандартным интерфейсом управления работой межсетевого экрана '''{{w |netfilter}}''' для [[w:Ядро Linux|ядер Linux]] версий 2.4, 2.6, 3.x, 4.x. 

Иногда под словом iptables имеется в виду и сам межсетевой экран netfilter.

== История ==
Изначально разработка netfilter и iptables шла совместно, поэтому в ранней истории этих проектов есть много общего. Подробности см. в статье про {{w |netfilter}}.

Предшественниками iptables были проекты {{w |ipchains}} (применялась для администрирования фаервола ядра Linux версии 2.2) и [[ipfwadm]] (аналогично для ядер Linux версий 2.0). Последний был основан на {{w |BSD}}-утилите {{w |ipfw}}.

iptables сохраняет идеологию, ведущую начало от ipfwadm: функционирование фаервола определяется набором правил, каждое из которых состоит из критерия и действия, применяемого к пакетам, подпадающим под этот критерий. В ipchains появилась концепция ''цепочек'' — независимых списков правил. Были введены отдельные цепочки для фильтрации входящих (INPUT), исходящих (OUTPUT) и транзитных (FORWARD) пакетов. В продолжении этой идеи, в iptables появились ''таблицы'' — независимые группы цепочек. Каждая таблица решала свою задачу — цепочки таблицы filter отвечали за фильтрацию, цепочки таблицы nat — за преобразование сетевых адресов ({{w |NAT}}), к задачам таблицы mangle относились прочие модификации заголовков пакетов (например, изменение [[w:Time to live|TTL]] или [[w:Тип обслуживания|TOS]]). Кроме того, была слегка изменена логика работы цепочек: в ipchains все входящие пакеты, включая транзитные, проходили цепочку INPUT. В iptables через INPUT проходят только пакеты, адресованные самому хосту.

Такое разделение функциональности позволило iptables при обработке отдельных пакетов использовать информацию о соединениях в целом (ранее это было возможно только для NAT). В этом iptables значительно превосходит ipchains, так iptables может отслеживать состояние соединения и перенаправлять, изменять или отфильтровывать пакеты, основываясь не только на данных из их заголовков (источник, получатель) или содержимом пакетов, но и на основании данных о соединении. Такая возможность фаервола называется stateful-фильтрацией, в отличие от реализованной в ipchains примитивной stateless-фильтрации (подробнее о видах фильтрации см. статью о [[w:Межсетевой экран|фаерволах]]). Можно сказать, что iptables анализирует не только передаваемые данные, но и контекст их передачи, в отличие от ipchains, и поэтому может принимать более обоснованные решения о судьбе каждого конкретного пакета. Более подробно о stateful-фильтрации в netfilter/iptables см. [[w:Netfilter#Механизм определения состояний]].

В будущем, разработчики netfilter планируют заменить iptables на [[nftables]] — инструмент нового поколения, пока находящийся в ранней стадии разработки&lt;ref&gt;[http://www.opennet.ru/opennews/art.shtml?num=20843 Разработчики Netfilter представили замену iptables]&lt;/ref&gt;.

== Архитектура ==

=== Основные понятия ===
Ключевыми понятиями iptables являются:
* '''Правило''' — состоит из ''критерия'', ''действия'' и ''счетчика''. Если пакет соответствует критерию, к нему применяется действие, и он учитывается счетчиком. Критерия может и не быть — тогда неявно предполагается критерий «все пакеты». Указывать действие тоже не обязательно — в отсутствие действия правило будет работать только как счетчик.
** '''Критерий''' — логическое выражение, анализирующее свойства пакета и/или соединения и определяющее, подпадает ли данный конкретный пакет под действие текущего правила.
** '''Действие''' — описание действия, которое нужно проделать с пакетом и/или соединением в том случае, если они подпадают под критерий этого правила. О действиях более подробно будет рассказано ниже.
** '''Счетчик''' — компонент правила, обеспечивающий учет количества пакетов, которые попали под критерий данного правила. Также счетчик учитывает суммарный объем таких пакетов в байтах.
* '''Цепочка''' — упорядоченная последовательность правил. Цепочки можно разделить на ''пользовательские'' и ''базовые''.
** '''Базовая цепочка''' — цепочка, создаваемая по умолчанию при инициализации таблицы. Каждый пакет, в зависимости от того, предназначен ли он самому хосту, сгенерирован им или является транзитным, должен пройти положенный ему набор базовых цепочек различных таблиц. &lt;strike&gt;Схема следования пакетов приведена на рисунке.&lt;/strike&gt; Кроме того, базовая цепочка отличается от пользовательской наличием «действия по умолчанию» (default policy). Это действие применяется к тем пакетам, которые не были обработаны другими правилами этой цепочки и вызванных из нее цепочек (см. переходы). Имена базовых цепочек всегда записываются в верхнем регистре (PREROUTING, INPUT, FORWARD, OUTPUT, POSTROUTING).
** '''Пользовательская цепочка''' — цепочка, созданная пользователем. Может использоваться только в пределах своей таблицы. Рекомендуется не использовать для таких цепочек имена в верхнем регистре, чтобы избежать путаницы с базовыми цепочками и встроенными действиями.
* '''Таблица''' — совокупность ''базовых'' и ''пользовательских'' цепочек, объединенных общим функциональным назначением. Имена таблиц (как и модулей критериев) записываются в нижнем регистре, так как в принципе не могут конфликтовать с именами пользовательских цепочек. При вызове команды iptables таблица указывается в формате &lt;tt&gt;-t имя_таблицы&lt;/tt&gt;. При отсутствии явного указания, используется таблица filter. Более подробно таблицы будут рассмотрены ниже.

=== Принцип работы ===
Все пакеты пропускаются через определенные для них последовательности цепочек (см. рис.) При прохождении пакетом цепочки, к нему последовательно применяются все правила этой цепочки в порядке их следования. Под применением правила понимается: во-первых, проверка пакета на соответствие критерию, и во-вторых, если пакет этому критерию соответствует, применение к нему указанного действия. Под действием может подразумеваться как элементарная операция (встроенное действие, например, ACCEPT, MARK), так и переход в одну из пользовательских цепочек. В свою очередь, действия могут быть как терминальными, то есть прекращающими обработку пакета в рамках данной базовой цепочки (например, ACCEPT, REJECT), так и нетерминальными, то есть не прерывающими процесса обработки пакета (MARK, TOS). Если пакет прошел через всю базовую цепочку и к нему так и не было применено ни одного терминального действия, к нему применяется действие по умолчанию для данной цепочки (обязательно терминальное). Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -F # Очищаем все цепочки таблицы filter
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT # Ко всем пакетам, которые относятся к уже установленным
# соединениям, применяем терминальное действие ACCEPT — принять пакет
iptables -P INPUT DROP # В качестве действия по умолчанию для входящих пакетов устанавливаем DROP — блокирование пакета
iptables -P OUTPUT ACCEPT # Разрешаем все исходящие пакеты
&lt;/syntaxhighlight&gt;
Теперь цепочка INPUT таблицы filter содержит единственное правило, которое пропускает все пакеты, относящиеся к уже установленным соединениям. Ко всем остальным входящим пакетам будет применено действие по умолчанию — DROP. Цепочка же OUTPUT вообще не содержит правил, поэтому ко всем исходящим пакетам будет применяться действие по умолчанию ACCEPT. Таким образом хост, настроенный согласно этому примеру и подключенный к {{w |Интернет}}у, будет недоступен извне (все попытки установить соединение снаружи блокируются), однако с самого хоста доступ к Интернету будет свободный (исходящие пакеты разрешены, а ответы на них уже относятся к установленным соединениям).

=== Основные компоненты ===

==== netfilter ====
&lt;!-- Пока здесь будет англоязычный оригинал. Постараюсь в ближайшее время перевести — FIXED --&gt;
[[Файл:Netfilter-components-ru.svg|600px|thumb|Взаимосвязь основных компонентов netfilter и conntrack]]
&lt;!-- Поставил 600, потому что иначе нифига не разглядеть. С удовольствием приму ценные предложения по улучшению верстки для небольших экранных разрешений --&gt;

Компонент ядра [[Linux]], обеспечивающий фильтрацию и модификацию трафика. Собственно, именно он и является фаерволом. В состав netfilter входят следующие модули:
* '''ip_tables''' — фаервол для протокола [[w:IPv4|IPv4]]. Обеспечивает фильтрацию пакетов, модификацию их заголовков и [[w:NAT|трансляцию сетевых адресов]].
* '''ip6_tables''' — фаервол для протокола [[w:IPv6|IPv6]]. Обеспечивает фильтрацию пакетов и модификацию их заголовков.
* '''arp_tables''' — фаервол для протоколов [[w:ARP|ARP]] и [[w:RARP|RARP]]. Обеспечивает фильтрацию и модификацию пакетов.
* '''x_tables''' — бэкенд для ip_tables, ip6_tables и arp_tables. В этом модуле определены основные операции для работы с фаерволами «таблично-цепочечной» структуры и их компонентами.
* '''ebtables''' — [[w:Ethernet|Ethernet]]-фаервол (префикс eb от Ethernet Bridge). В отличие от трех перечисленных выше фаерволов, работающих с протоколами [[w:Сетевой уровень|сетевого]] и более высоких уровней, ebtables работает на канальном уровне, выполняя фильтрацию и модификацию ethernet-кадров, проходящих через [[w:Сетевой мост|сетевые мосты]], если таковые имеются на хосте.

Принципы работы с ip_tables и ip6_tables практически идентичны, с тем небольшим отличием, что в ip6_tables отсутствует таблица nat и соответствующие действия (NAT уже присутствует в ip6tables). В то же время, принципы построения правил в arp_tables и ebtables несколько иные. В частности, arp_tables и ebtables имеют четыре базовых действия — ACCEPT (пропустить), DROP (заблокировать), CONTINUE (продолжить обработку в данной цепочке) и RETURN (прекратить обработку в данной цепочке, вернуть в цепочку уровнем выше). Эти действия могут использоваться отдельно, либо применяться к пакетам после выполнения какого-либо преобразующего действия (например, маркировки). Таким образом, после применения преобразования пакет может быть, скажем, немедленно пропущен фаерволом (ACCEPT), либо будет вынужден проследовать через последующие правила (CONTINUE). Этим arptables и ebtables отличаются от ip_tables и ip6_tables — в последних существует четкое разделение действий на терминальные и нетерминальные, которое нельзя изменить при составлении набора правил, а чтобы, например, пропустить пакет после некоторого нетерминального преобразования, необходимо добавлять дополнительное правило («&lt;tt&gt;iptables ... -j MARK ...; iptables ... -j ACCEPT&lt;/tt&gt;» вместо «&lt;tt&gt;ebtables ... -j mark ... --mark-target ACCEPT&lt;/tt&gt;»). Также, система conntrack не производит отслеживание соединений для ARP/RARP и Ethernet, поэтому возможности stateful-фильтрации в arp_tables и ebtables отсутствуют (нет критерия conntrack и таблицы raw).

В данной статье рассматриваются только аспекты работы с ip_tables и ip6_tables. В их задачи входит:
* Классификация пакетов на основе различных критериев. В качестве критерия могут выступать, например, [[w:IP-адрес|IP-адреса]] источника и/или назначения, состояние соединения (новое/уже установленное), [[w:Порт (TCP/IP)|порты]] источника и/или назначения (для протоколов [[w:Транспортный уровень|транспортного уровня]], имеющих порты), вспомогательные значения в заголовках пакетов (скажем, длина пакета, [[w:Type of Service|TOS]], [[w:Time to live|TTL]]) и т. п. Результаты этой классификации используются при решении других задач из данного списка.
* Фильтрация входящих (INPUT), исходящих (OUTPUT) и транзитных (FORWARD) пакетов, сводящаяся либо к их пропусканию (ACCEPT), либо к блокированию (DROP или REJECT). Также поддерживаются дополнительные возможности, например, блокирование попыток сканирования портов (DELUDE и CHAOS), эффективное противодействие [[w:DoS-атака|(D)DoS-атакам]] (TARPIT).
* Модификация заголовков пакетов и связанной информации. К этому классу задач можно отнести:
** Трансляцию сетевых адресов ([[w:NAT|NAT]]), включая [[w:маскарадинг|маскарадинг]] (SNAT или MASQUERADE), [[w:Трансляция порт-адрес|«проброс»]] адресов и портов (DNAT) и даже целых подсетей (NETMAP). Эта задача касается только модуля ip_tables. Модуль ip6_tables не производит трансляции адресов.
** Изменение различных вспомогательных величин в заголовках пакетов, например, [[w:Type of Service|TOS]], [[w:Time to live|TTL]], [[:en:Maximum Segment Size|TCP MSS]].
** Установку и изменение маркировки пакетов и соединений. Впоследствии эта маркировка может быть использована системой [[w:iproute2|iproute2]] для [[w:Маршрутизация|маршрутизации]] и [[w:Шейпинг (информатика)|шейпинга]] трафика.
* Учет количества обработанных пакетов и их суммарного размера при помощи счетчиков.
* Занесение информации о пакетах в [[w:syslog|системный журнал]] (LOG и LOGMARK).
* Передача на обработку userspace-[[w:Демон (программа)|демонам]] пакетов целиком (NFQUEUE) либо информации о них (NFLOG), что позволяет решать самый широкий круг задач по фильтрации, модификации и учету трафика.
* Внутренние задачи, связанные с обеспечением работы критериев и действий netfilter. Например, сопровождение списков [[w:IP-адрес|IP-адресов]] для критериев recent и hashlimit.

==== iptables ====
Userspace-утилита, через которую [[w:Root|системный администратор]] может управлять {{w |IPv4}}-фаерволом (ip_tables). К ее задачам относятся:
* Создание и удаление пользовательских цепочек.
* Установка действий по умолчанию для базовых цепочек.
* Добавление и удаление правил.
* Установка и обнуление счетчиков пакетов и байт.
* Просмотр цепочек и правил, а также значений счетчиков.
* Проверка корректности задания параметров, определяющих работу критериев и действий.
* Вывод справки по использованию критериев (&lt;tt&gt;iptables -m ''критерий'' -h&lt;/tt&gt;) и действий (&lt;tt&gt;iptables -j ''действие'' -h&lt;/tt&gt;).
Также в комплект поставки вместе с iptables обычно входят вспомогательные утилиты, обеспечивающие сохранение (iptables-save) и последующее восстановление (iptables-restore) состояния фаервола, его инициализацию при запуске системы ({{w |init}}-скрипт) и т. п.

Сегментом фаервола, отвечающим за фильтрацию {{w |IPv6}}-пакетов (ip6_tables), управляет утилита ip6tables. Так как обычно она поставляется вместе с iptables, имеет похожий синтаксис и выполняет схожие задачи, под термином «iptables» часто подразумевают сразу обе эти утилиты.

Также в рамках данного проекта разрабатываются два набора библиотек:
* '''libiptc''' — содержит функции, осуществляющие вышеперечисленные операции по управлению цепочками и правилами. Именно с этими функциями и работают утилиты iptables (библиотека libip4tc) и ip6tables (библиотека libip6tc). Приложения, использующие эти библиотеки, могут обращаться к netfilter напрямую, минуя вызов утилит iptables и ip6tables. В качестве примера такого приложения можно назвать [[Perl]]-модуль [http://search.cpan.org/~hawk/IPTables-libiptc-0.18/lib/IPTables/libiptc.pm IPTables::libiptc], предоставляющий доступ к функциям этих библиотек из Perl-{{w |скрипт}}ов.
* '''libipq''' — содержит функции, позволяющие пользовательским приложениям принимать [[IP-пакет]]ы на обработку. Отправка со стороны ядра выполняется через модуль ip_queue (ip6_queue для IPv6), что соответствует действию QUEUE. В настоящее время этот механизм [http://netfilter.org/projects/libnetfilter_queue/index.html объявлен устаревшим], и вместо него рекомендуется использовать действие NFQUEUE, работа которого реализуется через модуль ядра nfnetlink_queue и библиотеку libnetfilter_queue.

==== conntrack ====
Компонент netfilter, обеспечивающий отслеживание состояния соединений и классификацию пакетов с точки зрения принадлежности к соединениям, что позволяет netfilter осуществлять полноценную stateful-фильтрацию трафика. Как и netfilter, система conntrack является частью ядра [[Linux]]. К его задачам относятся:
* Отслеживание состояний отдельных соединений с тем, чтобы классифицировать каждый пакет либо как относящийся к уже установленному соединению, либо как открывающий новое соединение. При этом понятие «состояние соединения» искусственно вводится для протоколов, в которых оно изначально отсутствует ({{w |UDP}}, {{w |ICMP}}). При работе же с протоколами, поддерживающими состояния (например, {{w |TCP}}), conntrack активно использует эту возможность, тесно взаимодействуя с базовой сетевой подсистемой ядра Linux.
* Отслеживание связанных соединений, например, {{w |ICMP}}-ответов на {{w |TCP}} и {{w |UDP}}-пакеты. Более сложный вариант — протоколы, использующие несколько соединений в одной сессии, например, {{w |FTP}}. Для правильной обработки таких протоколов conntrack использует специальные модули (conntrack helpers), которые анализируют трафик и «выхватывают» информацию протокола о новых соединениях (например, порт, на который оно будет открыто), что позволяет обеспечить их корректную фильтрацию, маршрутизацию, шейпинг и пропускание через NAT.

Более подробно о возможностях системы conntrack и их использовании при работе с iptables/netfilter см. [[#Механизм определения состояний|чуть ниже]].

В состав conntrack входят следующие компоненты:
* Главный модуль nf_conntrack. Реализует базовую функциональность отслеживания соединений, интерфейсы для работы с модулями расширений, а также механизмы отслеживания протоколов {{w |TCP}} и {{w |UDP}}.
* Трекеры протоколов [[w:Протоколы сетевого уровня|сетевого уровня]]: nf_conntrack_ipv4 и nf_conntrack_ipv6. Реализуют операции, специфичные для «своих» протоколов ({{w |IPv4}} и {{w |IPv6}} соответственно), а также механизмы отслеживания соответствующих протоколов управляющих сообщений ({{w |ICMP}} и {{w |ICMPv6}} соответственно).
* Трекеры протоколов [[w:Транспортный уровень|транспортного уровня]] (кроме {{w |TCP}} и {{w |UDP}}, реализованных в главном модуле): nf_conntrack_proto_sctp ({{w |SCTP}}), nf_conntrack_proto_dccp ({{w |DCCP}}), nf_conntrack_proto_gre ([[w:GRE (протокол)|GRE]]), nf_conntrack_proto_udplite ({{w |UDP Lite}}).
* Вспомогательные модули (helpers), обеспечивающие отслеживание протоколов [[w:Протоколы прикладного уровня|прикладного]] и [[w:Сеансовый уровень|сеансового]] уровней: nf_conntrack_ftp, nf_conntrack_irc, nf_conntrack_pptp, nf_conntrack_netbios_ns и т. п. Требуются далеко не для всех протоколов, а только для тех, отслеживание которых требует знания специфики протокола. Например, неоднократно упоминающийся в этой статье протокол {{w |FTP}} использует в одном сеансе два соединения (управляющее соединение и соединение передачи данных), и чтобы корректно отследить соединение передачи данных, необходимо анализировать трафик управляющего соединения и выделять в нем информацию, касающуюся открытия соединения данных.
* Модуль nf_nat. Реализует базовую функциональность [[w:NAT|трансляции сетевых адресов]] и [[w:Трансляция порт-адрес|портов]] с учетом информации о соединениях. Также этот модуль содержит механизмы трансляции для протоколов {{w |IPv4}}, {{w |TCP}}, {{w |UDP}} и {{w |ICMP}} ({{w |IPv6}} и {{w |ICMPv6}} не поддерживаются NAT-подсистемой conntrack).
* NAT-трекеры протоколов [[w:Транспортный уровень|транспортного уровня]]: nf_nat_proto_sctp, nf_nat_proto_dccp, nf_nat_proto_gre, nf_nat_proto_udplite.
* Вспомогательные модули NAT для протоколов [[w:Протоколы прикладного уровня|прикладного]] и [[w:Сеансовый уровень|сеансового]] уровней: nf_nat_ftp, nf_nat_irc, nf_nat_pptp и т. п.
* Модуль взаимодействия с userspace через протокол nfnetlink (см. следующий раздел) nf_conntrack_netlink, которому соответствует userspace-библиотека libnetfilter_conntrack.
* Кроме того, к conntrack можно условно отнести и модули netfilter, обеспечивающие взаимодействие этих двух подсистем: критерий conntrack (xt_conntrack), действия NOTRACK и CT (xt_NOTRACK и xt_CT), практически все действия [[#Таблица nat|таблицы nat]], а также соответствующие модули (библиотеки iptables/ip6tables): libxt_conntrack, libxt_NOTRACK, libxt_CT и т. п.

Для взаимодействия с системой conntrack из userspace разработан комплект [http://conntrack-tools.netfilter.org/ conntrack-tools], содержащий две утилиты:
* '''conntrack''' — инструмент, позволяющий [[w:Root|системному администратору]] наблюдать таблицы состояний соединений и взаимодействовать с ними: очищать таблицы целиком, удалять отдельные записи, маркировать соединения вручную (аналог действия CONNMARK), устанавливать [[Тайм-аут (Телекоммуникации)|тайм-ауты]] соединений. Поддерживается фильтрация вывода (например, на основании адресов и/или портов источника и/или назначения), а также вывод в различных форматах, включая {{w |XML}}. Кроме того, данная утилита позволяет отслеживать в реальном времени события системы conntrack, например, открытие новых соединений или изменение состояния существующих.
* '''conntrackd''' — демон, обеспечивающий синхронизацию таблиц состояний с другими хостами, что в сочетании с возможностями демона [[keepalived]] позволяет создавать фаерволы на {{w |кластер}}ах высокой доступности (High Availability) — при выходе из строя одного из хостов кластера его соединения будут «подхвачены» другими хостами кластера и корректно обработаны с учетом состояний. Также conntrackd можно использовать просто для удаленного сбора статистики по соединениям.

Взаимодействие conntrack с этими программами производится посредством интерфейса nfnetlink, который будет рассмотрен в следующем разделе.

==== nfnetlink ====
Интерфейс, позволяющий различным userspace-приложениям взаимодействовать с netfilter и conntrack. Со стороны userspace он обеспечивается набором библиотек libnfnetlink. Ключевые библиотеки из этого набора:
* '''libnetfilter_conntrack''' (ранее libnfnetlink_conntrack и libctnetlink) — обеспечивает взаимодействие приложений с системой conntrack. В качестве примеров приложений, использующих эту библиотеку, можно упомянуть:
** Описанные выше программы '''conntrack''' и '''conntrackd''' из комплекта conntrack-tools.
** '''iptstate''' — в какой-то мере аналог утилиты conntrack, хотя и не имеющий таких богатых возможностей. Предназначена для непрерывного вывода таблицы состояний соединений с периодическим обновлением, в стиле широко известной утилиты {{w |top}}. Поддерживает различные виды сортировки (по адресам/портам источника/назначения, [[Тайм-аут (Телекоммуникации)|тайм-ауту]], счетчикам и т. п.). Позволяет удалять записи из таблицы состояний. Не поддерживает работу с таблицей ожидаемых (expected) соединений.
* '''libnetfilter_queue''' (ранее libnfnetlink_queue) — отвечает за передачу пакетов демонам на предмет анализа. По результатам этого анализа пакет может быть заблокирован или пропущен. При пропускании пакета возможна установка или изменение его маркировки (nfmark). Идеологическим предшественником libnetfilter_queue была ныне устаревшая библиотека libipq. В качестве примеров приложений, использующих libnetfilter_queue, можно упомянуть:
** '''nufw''' — фаервол, выполняющий фильтрацию трафика на основе авторизации пользователей. Позволяет устанавливать ограничения на доступ к сетям, находящимся за фаерволом, для отдельных пользователей. Авторизация пользователей на фаерволе обеспечивается отдельным демоном nuauth. Например, в случае, если клиенты используют [[Linux]], авторизация может выполняться совершенно прозрачно, благодаря возможностям {{w |PAM}} (модуль pam_nufw) в момент входа пользователя в систему. Особенно удобны подобные системы в корпоративных сетях, где используются системы централизованного управления аккаунтами пользователей (nufw/nuauth поддерживает {{w |LDAP}} и [[winbind]]).
** '''{{w |l7-filter}}-userspace''' — демон, позволяющий определить протокол [[w:Протоколы прикладного уровня|7-го (прикладного) уровня]] [[w:Сетевая модель OSI|модели OSI]], которому принадлежит полученный пакет, на основании анализа его содержимого при помощи [[Регулярные выражения|регулярных выражений]]. Результат анализа возвращает в маркировке пакета. Полезен при фильтрации и [[w:Шейпинг (информатика)|шейпинге]] трафика протоколов, не имеющих фиксированных номеров портов для соединений данных, например, [[BitTorrent]]. Впрочем, в настоящее время существуют и альтернативные решения — {{w |P2P}}-протоколы можно выделять при помощи критерия ipp2p (из набора xtables-addons), а вспомогательные соединения в известных системе conntrack протоколах ({{w |FTP}}, {{w |IRC}}, {{w |SIP}}) можно выделять при помощи критерия helper и маркировки соединений.
** '''iplist''' — userspace-альтернатива ipset. Как и ipset, позволяет считывать большие списки {{w |IP-адрес}}ов и проверять пакеты на предмет нахождения адреса их источника/назначения в данном списке. В зависимости от результата проверки, пакет может быть пропущен или заблокирован, либо промаркирован соответствующим образом. Разумеется, ipset, работая на уровне ядра, обеспечивает более высокую скорость проверки, а также поддерживает дополнительные возможности, например, динамическое изменение списков при помощи действия SET (добавление и удаление записей), сохранение дополнительной информации (номера [[w:Порт (компьютерные сети)|портов]], {{w |MAC-адрес}}а, [[Тайм-аут (Телекоммуникации)|тайм-ауты]] записей). Несмотря на то, что в настоящий момент ipset пока что не принят в ядро, современные дистрибутивы ipset позволяет произвести сборку и установку необходимых компонентов без необходимости наложения {{w |патч}}ей на ядро и iptables, благодаря возможностям подгружаемых модулей ([[:en:LKM]]) ядра [[Linux]]. Поэтому, с учетом вышесказанного, необходимость в iplist в настоящее время сомнительна.
* '''libnetfilter_log''' (ранее libnfnetlink_log) — предоставляет демонам интерфейс для получения служебной информации о пакетах на предмет регистрации и учета трафика. В настоящее время известен только один проект, использующий данную библиотеку — '''ulogd2''' ([netfilter] userspace logging daemon, версия 2). Данный проект находится пока в бета-стадии разработки. Надо заметить, что ulogd2 может получать информацию не только через libnetfilter_log (действие NFLOG), но и через классический механизм libipulog (действие ULOG), а также через libnetfilter_conntrack (данный метод позволяет получать информацию не об отдельных пакетах, а о соединениях в целом).

Со стороны ядра взаимодействие обеспечивается базовым модулем nfnetlink и «специализированными» модулями nf_conntrack_netlink, nfnetlink_queue и nfnetlink_log соответственно.

Кроме того, такие программы, как nfnl_osf (передает ядру список сигнатур для критерия детекции операционной системы osf) и ipset начиная с версии 5 (см. ниже) также используют для коммуникаций ядро-userspace интерфейс nfnetlink, но эти задачи являются узкоспециализированными и поэтому реализованы без использования специальных библиотек и модулей ядра.

==== ipset ====
Представляет собой набор инструментов, позволяющий работать с большими списками (sets) {{w |IP-адрес}}ов и/или [[w:Порт (компьютерные сети)|портов]]. Поддерживается возможность динамического обновления списков при прохождении пакетов через правила {{w |netfilter}}.

В версии ipset 4 и более ранних поддерживалась работа только с семейством адресов {{w |IPv4}}, однако начиная с пятой версии реализована также и поддержка {{w |IPv6}}.

Стоит отметить, что долгое время проект ipset существовал вне основной ветки развития [[w:Ядро Linux|ядра Linux]]. В частности, в четвертой версии ipset «ядерные» компоненты приходилось собирать отдельно, используя заголовочные файлы текущего ядра. Однако, после выхода пятой версии, в которой были учтены все предыдущие замечания, началась работа по включению ipset в основную ветку. Она [http://www.spinics.net/lists/netfilter-devel/msg17027.html завершилась успехом]: поддержка ipset присутствует в Linux начиная с 2.6.39. В ходе этих работ протокол взаимодействия ядерной и userspace-частей ipset подвергся значительной переработке, и окончательная версия [http://git.netfilter.org/cgi-bin/gitweb.cgi?p=ipset.git;a=commit;h=d6ee5bb4e5346b84efa33858091ba4add2b26de2 получила] номер 6.0. Таким образом, в современных ядрах поддержка ipset присутствует штатно, а пользователи более старых ядер могут воспользоваться реализациями ipset версий 4 и 5, включенными в набор [http://xtables-addons.sourceforge.net/ xtables-addons].

ipset состоит из следующих элементов:
* Модуль ядра ip_set, обеспечивающий базовый инструментарий работы со списками записей, который используется модулями расширений.
* Модули расширений, определяющие конкретные структуры записей и методы работы с ними, например, ip_set_hash_ip (тип данных hash: ip), ip_set_bitmap_port (тип данных bitmap: port) и т. д.
* Userspace-утилита ipset, позволяющая выполнять различные операции со списками и записями в них:
** Создание, удаление, переименование, вывод, очистка списков.
** Добавление и удаление записей из списков, проверка наличия записи в списке.
** Вывод справочной информации по работе со списками различного типа.
* Модули расширений для утилиты ipset, соответствующие модулям расширений в ядре, например, ipset_hash_ip (тип данных hash: ip), ipset_bitmap_port (тип данных bitmap: port) и т. д. Каждый такой модуль отвечает за обеспечение {{w |интерфейс}}а между «своим» модулем ядра и конечным пользователем, в частности, проверку корректности вводимых и форматирование выводимых данных, а также вывод справочной информации по допустимым командам и параметрам. В ранних версиях ipset (до 4 включительно) такие модули выделялись в виде подгружаемых библиотек, однако в современных версиях ipset они статически включаются в основной бинарник, поэтому разделение существует лишь в исходном коде.
* Модуль netfilter xt_set (критерий set и действие SET), а также соответствующие модули (библиотеки) iptables (libxt_set и libxt_SET). Критерий set позволяет проверять различные параметры пакета ([[w:IP-адрес|IP]]/{{w |MAC-адрес}}а, {{w |TCP}}/{{w |UDP}}-[[w:Порт (компьютерные сети)|порты]] источника и/или получателя) на предмет нахождения или отсутствия в списке. Действие SET позволяет добавлять или удалять записи из списка на основании указанных параметров пакета. &lt;!-- Отметим, что, начиная с версии iptables 1.4.9 {{w |IPv4}}-специфичные модули libipt_set и libipt_SET [http://git.netfilter.org/cgi-bin/gitweb.cgi?p=iptables.git;a=commit;h=d40f1628c3717daebc437a398a285e371b5b6f7f заменены] на более универсальные libxt_set и libxt_SET, которые могут использоваться как в iptables, так и в ip6tables. --&gt;

ipset поддерживает следующие типы данных (в скобках приведены названия согласно терминологии устаревшей версии ipset 4):
* '''bitmap: ip''' (ipmap) — полный перечень {{w |IP-адрес}}ов.
* '''bitmap: ip, mac''' (macipmap) — полный перечень IP-адресов, причем вместе с каждым IP-адресом может быть сохранен {{w |MAC-адрес}}.
* '''bitmap: port''' (portmap) — полный перечень [[w:Порт (компьютерные сети)|портов]].
* '''hash: ip''' (iphash) — выборочный перечень IP-адресов (либо IP-подсетей с одинаковой маской).
* '''hash: net''' (nethash) — выборочный перечень IP-подсетей (блоков IP-адресов). В отличие от hash: ip, в одном списке могут присутствовать подсети с различными масками.
* '''hash: ip, port''' (ipporthash) — выборочный перечень IP-адресов, причем с каждым адресом может быть сохранен порт. В версии ipset 4 и более ранних существует ограничение: адреса в пределах одного перечня должны принадлежать одному [[w:Бесклассовая адресация|блоку /16]] (/255.255.0.0, максимум 65536 адресов). Начиная с версии ipset 5, для каждого номера порта можно также сохранять идентификатор протокола [[w:Транспортный уровень|транспортного уровня]].
* '''hash: ip, port, ip''' (ipportiphash) — выборочный перечень IP-адресов, причем с каждым адресом может быть сохранен порт и еще один IP-адрес. В версии ipset 4 и более ранних ограничение на «первичные» адреса (первые в тройке адрес-порт-адрес) такое же, как и для ipporthash. Начиная с версии ipset 5, для каждого номера порта можно также сохранять идентификатор протокола транспортного уровня.
* '''hash: ip, port, net''' (ipportnethash) — выборочный перечень IP-адресов, причем с каждым адресом может быть сохранен порт и IP-подсеть. В версии ipset 4 и более ранних ограничение на «первичные» адреса такое же, как и у типа ipporthash. Начиная с версии ipset 5, для каждого номера порта можно также сохранять идентификатор протокола транспортного уровня.
* '''list: set''' (setlist) — список списков. Может содержать списки любого перечисленного здесь типа, кроме list: set. При обращении к такому объекту из netfilter, включенные в него списки рассматриваются как один большой список. Поиск записей (критерий set) производится по всем вложенным спискам соответствующего типа. При добавлении записей (действие SET), вложенные списки поочередно проверяются (согласно порядку их перечисления) на соответствие типа и наличие свободного места, и запись добавляется в первый же подходящий. В то же время, при обращении к такому списку через утилиту ipset, он рассматривается именно как совокупность элементов-списков, что позволяет добавлять, удалять и проверять наличие именно вложенных списков, но не их элементов.
* '''hash: net, iface''' — выборочный перечень IP-подсетей, причем с каждой подсетью может быть сохранено название сетевого интерфейса. Появился в версии ipset 6.7 (входит в [[w:Ядро Linux|Linux]] 3.1), ранние версии ipset не имеют подобных возможностей. Существует ограничение: нельзя сохранять более 64 имен интерфейсов с одним и тем же адресом подсети. Этот тип данных удобен при наличии в системе большого количества сетевых интерфейсов (например, сотен {{w |VLAN}}-интерфейсов).

В четвертой версии дополнительно присутствовали два типа списков, упраздненные в более поздних версиях:
* '''iptree''' — выборочный перечень IP-адресов, причем с каждым адресом может быть сохранено значение [[Тайм-аут (Телекоммуникации)|тайм-аута]] в секундах. По истечении тайм-аута адрес удаляется из списка. Чтобы активировать возможность использование тайм-аутов для определенного списка, нужно при его создании задать тайм-аут по умолчанию (опция &lt;tt&gt;--timeout&lt;/tt&gt;). Начиная с версии ipset 5, данный тип не поддерживается, при попытке его использования автоматически заменяется на hash: ip. Заметим, что начиная с пятой версии тайм-ауты реализованы для всех поддерживаемых типов данных.
* '''iptreemap''' — гибридный перечень, позволяющий сохранять адреса, блоки и диапазоны адресов. Начиная с версии ipset 5, данный тип не поддерживается, при попытке его использования автоматически заменяется на hash: ip. Стоит отметить, что в современных версиях ipset при работе с адресами IPv4 можно указывать диапазоны адресов и подсети, которые при обращении к внутренним спискам будут автоматически преобразованы в наборы соответствующих элементов, Например, &lt;tt&gt;ipset create foo hash:ip; ipset add foo 192.168.0.0-192.168.0.3&lt;/tt&gt; добавит в список &lt;tt&gt;foo&lt;/tt&gt; адреса 192.168.0.0, 192.168.0.1, 192.168.0.2 и 192.168.0.3 (аналогичный эффект может быть достигнут и командой &lt;tt&gt;ipset add foo 192.168.0.0/3&lt;/tt&gt;).

Практически для всех типов списков, реализованных в ipset, существует общее ограничение на максимальный размер: 65536 записей.

Большинство перечисленных типов данных можно разделить на две группы: полные перечни (map, bitmap) и выборочные перечни (hash, tree). Разница между этими типами состоит в следующем: если выборочный перечень сохраняет только те элементы, которые в него входят, то полный перечень представляет собой таблицу логических значений ({{w |бит}}ов) для всех элементов, которые могут входить в данный перечень, и вхождение конкретного элемента в перечень определяется значением соответствующего бита. Полный перечень всегда формируется на базе ''одного непрерывного'' диапазона значений.

Таким образом, выбор необходимого вам типа данных определяется конкретными условиями задачи, прежде всего, отношением усредненного количества элементов в списке к требуемому диапазону охвата. Например, если вы собираетесь хранить в списке блэк-листы адресов, замеченных в атаках на ваш сервер, целесообразнее использовать тип hash: ip, потому что атакующие вас ботнеты, как бы они ни были велики, все равно занимают незначительную долю адресного пространства {{w |IPv4}}. К тому же, как следует из сказанного в предыдущем абзаце, тип bitmap: ip все равно не может хранить адреса, выходящие за предел одной подсети [[w:Бесклассовая адресация|префикса 16]]. Но в том случае, если вам, например, нужно задать список хостов из вашей локальной сети, имеющих доступ к каким-либо услугам (службам вашего {{w |сервер}}а, выходу в {{w |Интернет}}), и этот доступ должно иметь значительное количество хостов (а не единицы), то целесообразнее будет использовать bitmap: ip.

По поводу хранения адресов подсетей ([[w:Бесклассовая адресация|блоков]] {{w |IP-адрес}}ов) можно сказать следующее. Если вам нужно хранить большое количество блоков одного размера из ограниченного диапазона (не более 65536 возможных значений), например, блоки /24 из подсети /8, вы можете использовать тип bitmap: ip, указав маску. Если же вам нужно хранить блоки одного размера из достаточно широкого диапазона, например, /24 из всего адресного пространства {{w |IPv4}}, используйте тип hash: ip, также с указанием маски. При необходимости хранить в одном списке блоки ''разного'' размера, воспользуйтесь типом hash: net.

Что касается улучшений в версиях 5 и 6 по сравнению с четвертой и более ранними, то, помимо уже упомянутых (поддержка адресов {{w |IPv6}}, поддержка [[Тайм-аут (Телекоммуникации)|тайм-аутов]] для всех типов данных, возможность сохранения идентификатора протокола транспортного уровня в типах hash: ip, port, hash: ip, port, ip и hash: ip, port, net), стоит также отметить переход на использование nfnetlink (см. выше) для связи ядра и userspace, а также более простой синтаксис. Например, те действия, которые в ipset 4 выглядели бы так:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
ipset -N foo macipmap --network 192.168.0.0/16 # Создаем список
ipset -A foo 192.168.1.1,12:34:56:78:9A:BC # Добавляем запись
ipset -T foo 192.168.1.1,12:34:56:78:9A:BC # Проверяем ее наличие в списке
ipset -L foo # Выводим список на экран (точнее, на stdout)
ipset -F foo # Очищаем список
ipset -X foo # Удаляем список
&lt;/syntaxhighlight&gt;
в современных версиях ipset будут выглядеть следующим образом:
&lt;syntaxhighlight lang=&quot;text&quot;&gt;
ipset create foo bitmap:ip,mac range 192.168.0.0/16
ipset add foo 192.168.1.1,12:34:56:78:9A:BC
ipset test foo 192.168.1.1,12:34:56:78:9A:BC
ipset list foo
ipset flush foo
ipset destroy foo
&lt;/syntaxhighlight&gt;
Кроме того, современные версии ipset поддерживают работу в режиме простой [[w:Командный интерпретатор|оболочки]], принимающей команды со [[stdin]]. При этом в них обеспечивается полная обратная совместимость синтаксиса с четвертой версией, то есть синтаксис, корректно работающий для четвертой версии ipset, будет точно так же работать в пятой и шестой.

==== ipvs ====
Разработанный в рамках проекта [http://www.linuxvirtualserver.org/ Linux Virtual Server] инструментарий для балансировки входящих соединений на [[w:Транспортный уровень|транспортном уровне]], позволяющий создавать отказоустойчивые (highly available, HA) [[w:Кластер (группа компьютеров)|кластеры]] с балансировкой нагрузки. В структуру такого кластера входит один или несколько хостов-балансировщиков (front-end), а также группа хостов-обработчиков (back-end). Хост-балансировщик принимает входящие соединения и перенаправляет их на хосты-обработчики, причем выбор хоста-обработчика осуществляется по специальному алгоритму, обеспечивающему гибкое распределение нагрузки между обработчиками. В кластере также могут присутствовать дополнительные (резервные) балансировщики, которые вступают в игру в случае отказа основного балансировщика.

Как правило, IPVS работает в связке с демоном [[keepalived]], который обеспечивает отказоустойчивость балансировщика (с использованием протокола [[:en:VRRP|VRRP]]) и поддержку в актуальном состоянии списка обработчиков (демон периодически проверяет работоспособность обработчиков и выводит из состава кластера неработоспособные хосты). Также допускается «ручное» управление настройками кластера — через программу [[ipvsadm]].

Как уже упоминалось выше, IPVS обеспечивает балансировку нагрузки на транспортном уровне, то есть конфигурационной единицей IPVS является ''кластерная служба''. Она характеризуется адресом ({{w |IPv4}} или {{w |IPv6}}), протоколом транспортного уровня (на данный момент IPVS поддерживает протоколы {{w |TCP}}, {{w |UDP}} и {{w |SCTP}}) и номером [[w:Порт (компьютерные сети)|порта]]. Обычно для кластерных служб выделяется отдельный адрес, который присваивается активному (на данный момент) балансировщику. В случае его отказа, адрес автоматически передается резервному балансировщику, и кластер продолжает работу. Обратите внимание, что обеспечением отказоустойчивости занимается не IPVS, а keepalived. Впрочем, использование keepalived не является строго обязательным — существуют и альтернативные подходы, например, встраивание IPVS в кластерный стек [http://linux-ha.org/ Linux-HA] (см. [[:en:Heartbeat (program)|Heartbeat]]). В том случае, если отказоустойчивость не критична (требуется только балансировка нагрузки), можно вообще обойтись без дополнительного демона, выполняя всю настройку через ipvsadm.

Для перенаправления пакетов на выбранный обработчик, IPVS может использовать один из следующих методов:
* '''Прямая {{w |маршрутизация}} (gatewaying)''' — применяется в том случае, если между балансировщиком и обработчиками отсутствуют {{w |маршрутизатор}}ы, то есть они находятся в одном сегменте сети. В этом случае адрес назначения в заголовке пакетов сохраняется неизменным («кластерный» адрес), подменяются лишь {{w |MAC-адрес}}а назначения при отправке [[w:Кадр (телекоммуникации)|кадров]] с этими пакетами.
* '''[[w:Инкапсуляция (компьютерные сети)|Инкапсуляция]] IPIP''' — модификация предыдущего метода на тот случай, когда балансировщик и обработчики находятся в разных сегментах сети. При помощи инкапсуляции IP-в-IP создаются [[w:Туннелирование (компьютерные сети)|сетевые туннели]], которые объединяют балансировщик и обработчик в один сегмент виртуальной сети.
* '''{{w |Маскарадинг}} ({{w |NAT}})''' — наиболее гибкое и универсальное решение: балансировщик подменяет адреса/порты назначения проходящих пакетов на реальные адреса/порты обработчиков ({{w |трансляция порт-адрес}}). При этом обеспечивается как простота настройки (не нужно поднимать дополнительные адреса на обработчиках и туннели между балансировщиком и обработчиком), так и гибкость (целевой порт обработчика может отличаться от порта кластерной службы, что невозможно в рамках других методов). Недостатком данного метода является несколько большее потребление системных ресурсов (трансляция адресов является довольно ресурсоемкой задачей).

В настоящее время существует довольно обширная библиотека алгоритмов балансировки нагрузки между обработчиками:
* '''rr (round robin)''' — классическая [[w:Round-robin (алгоритм)|кольцевая схема]], когда все обработчики получают новые соединения поочередно.
* '''wrr (weighted round robin)''' — модификация кольцевой схемы на тот случай, когда одни сервера могут обрабатывать больше соединений, чем другие. Такие сервера включаются в один проход очереди по нескольку раз, и соответственно получают больше соединений.
* '''lc (least-connection)''' — новое соединение передается тому серверу, который на текущий момент обрабатывает наименьшее число соединений.
* '''wlc (weighted least-connection)''' — модификация предыдущего метода на случай, когда возможности серверов отличаются. При выборе нового сервера сравниваются не непосредственно количества открытых соединений, а отношения количества соединений к весовому коэффициенту (весу) обработчика (который и характеризует его возможности).
* '''lblc (locality-based least-connection)''' — формирует привязку обработчиков к кластерному адресу назначения (их может быть несколько). В том случае, если для запрошенного адреса такой привязки еще нет, или привязанный обработчик сильно перегружен ­— выбирает (по алгоритму lc) и привязывает новый обработчик.
* '''lblcr (locality-based least-connection with replication)''' — несколько усложненный вариант предыдущего алгоритма. К каждому кластерному адресу привязывается группа обработчиков, которая периодически обновляется (исключаются наиболее нагруженные обработчики, вместо них включаются наименее нагруженные).
* '''dh (destination hashing)''' — обеспечивает жесткую, неуправляемую привязку обработчиков к кластерным адресам назначения (выбор обработчика производится исключительно на основании элементарных арифметических операций над кластерным адресом и ''никак не учитывает'' загруженности обработчиков). Может привести к перегрузкам отдельных обработчиков — в этом случае кластер просто перестает обслуживать соответствующий адрес. В такой ситуации нужно либо увеличить лимит соединений на обработчик, либо выбрать другой алгоритм.
* '''sh (source hashing)''' — аналогично dh, но обработчики привязываются к адресам клиентов. Как и dh, в случае перегрузки прекращает обслуживание. Отметим, что для формирования ''временных'' привязок обработчиков к адресам клиентов целесообразнее использовать механизм устойчивых соединений (persistent connections), доступный для всех алгоритмов.
* '''sed (shortest expected delay)''' — выбирает сервер с наименьшей ожидаемой задержкой ответа. Эта задержка определяется как отношение числа обрабатываемых соединений плюс единица к весу обработчика. Таким образом, этот метод по принципу близок к wlc (отличается лишь прибавлением единицы к числителю сравниваемой величины, что немного меняет влияние веса обработчика на выбор).
* '''nq (never queue)''' — пытается передать новое соединение обработчику, который в данный момент не обрабатывает других соединений. Если все обработчики уже заняты, использует предыдущий алгоритм (sed).

Для отслеживания соединений к кластерным службам IPVS использует собственную систему трекинга соединений, более примитивную, но менее ресурсоемкую, нежели классический conntrack. При этом поддерживается экспорт информации о кластерных соединениях в conntrack, в целях обеспечения их корректной обработки фаерволом и трансляции адресов (при трансляции адресов используются штатные средства netfilter). Однако, для корректной обработки протоколов, использующих связанные соединения (например, {{w |FTP}}), IPVS использует возможности conntrack. Синхронизация таблицы соединений между основным и дублирующими балансировщиками полностью реализована на уровне ядра (для сравнения, в conntrack эту задачу выполняет userspace-демон conntrackd).

=== Механизм определения состояний ===
Важной особенностью iptables/{{w |netfilter}} является механизм определения состояний (connection tracking, nf_[[conntrack]]) — специальная подсистема, отслеживающая состояния соединений и позволяющая использовать эту информацию при принятии решений о судьбе отдельных пакетов. Наличие этого механизма делает netfilter полноценным stateful-фаерволом.

Определение состояния соединения порой бывает довольно сложной задачей. Скажем, в случае {{w |TCP}} все относительно просто — контроль состояний реализован средствами самого протокола, установлены специальные процедуры открытия и закрытия соединения. А вот в протоколе {{w |UDP}} для этого специальных процедур не предусмотрено, поэтому UDP-соединением с точки зрения [[conntrack]] является поток пакетов, следующих с интервалом, не превышающим заданный тайм-аут ({{w |sysctl}}-параметр &lt;tt&gt;net.netfilter.nf_conntrack_udp_timeout&lt;/tt&gt;, по умолчанию 30 секунд), с одного и того же порта одного хоста, на один и тот же порт другого хоста.

Заметим, что классификация пакетов по отношению к соединениям, реализуемая системой conntrack, во многих случаях отличается от официального описания сетевых протоколов. Например, с точки зрения критерия conntrack, TCP-пакет SYN/ACK (отвечающий на SYN) — уже часть существующего сеанса, а по определению TCP такой пакет — всего лишь элемент открытия сеанса.

Существует также понятие «связанных соединений». Например, когда в ответ на {{w |UDP}}-пакет с нашего хоста удаленный хост отвечает {{w |ICMP}}-пакетом icmp-port-unreachable, формально этот ответ является отдельным соединением, так как использует совсем другой протокол. {{w |netfilter}} отслеживает подобные ситуации и присваивает таким соединениям статус «связанных» (RELATED), позволяя корректно пропускать их через фильтры фаервола.

Более сложный вариант связанного соединения — соединение данных в пассивном режиме {{w |FTP}}. FTP-сервер самостоятельно выбирает порт для прослушивания из достаточно большого диапазона, и сообщает номер порта клиенту через управляющее соединение, после чего клиент подключается к этому порту и передает данные. {{w |netfilter}}, а точнее модуль conntrack_ftp, выделяет в потоке данных управляющего соединения нужный номер порта, что позволяет корректно определить новое соединение как связанное и, соответственно, корректно пропустить его через правила фильтрации.

В некоторых случаях целесообразно отключить отслеживание состояния соединений. Например, если ваш сервер находится под [[w:DoS-атака|(D)DoS-атакой]] типа флуд, и вам удалось локализовать ее источники, отслеживать соединения с атакующих хостов и тратить для этого ресурсы своей системы явно не имеет смысла. В подобных случаях используется действие NOTRACK, применяемое в [[#Таблица raw|таблице raw]].

Ниже кратко перечислены возможности, предоставляемые системой отслеживания состояний:

==== Критерий состояния соединения ====
При помощи [[#conntrack 2|критерия conntrack]] вы можете классифицировать пакеты на основании их отношения к соединениям. В частности, состояние NEW позволяет выделять только пакеты, открывающие новые соединения, состояние ESTABLISHED — пакеты, принадлежащие к установленным соединениям, состоянию RELATED соответствуют пакеты, открывающие новые соединения, логически связанные с уже установленными (например, соединение данных в пассивном режиме {{w |FTP}}). Состояние INVALID означает, что принадлежность пакета к соединению установить не удалось.

Например, одним простым правилом
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -m conntrack --ctstate ESTABLISHED -j ACCEPT
&lt;/syntaxhighlight&gt;
вы можете обеспечить корректное пропускание всех входящих пакетов, принадлежащих установленным соединениям, и сконцентрироваться только на фильтрации новых соединений.

Заменив в предыдущем правиле &lt;tt&gt;ESTABLISHED&lt;/tt&gt; на &lt;tt&gt;ESTABLISHED,RELATED&lt;/tt&gt; и подгрузив соответствующие модули ядра, вы автоматически обеспечите корректную фильтрацию протоколов, использующих связанные соединения — {{w |FTP}}, {{w |SIP}}, {{w |IRC}}, {{w |H.323}} и других. Такое простое (с точки зрения пользователя) решение сложной (с технической точки зрения) проблемы является безусловным достоинством фаервола {{w |netfilter}} и ядра [[Linux]] в целом.

Более подробно об использовании этого критерия вы можете почитать [[#conntrack 2|ниже]].

Кроме критерия conntrack, стоит упомянуть и его идеологического предшественника — [[#state|критерий state]]. Изначально для определения состояния соединения использовался именно он, то есть вместо &lt;tt&gt;-m conntrack --ctstate ESTABLISHED,RELATED&lt;/tt&gt; использовалось &lt;tt&gt;-m state --state ESTABLISHED,RELATED&lt;/tt&gt;. Подобные формулировки до сих пор сохраняются во многих руководствах по iptables. Однако в настоящее время критерий state считается устаревшим, и разработчики iptables [http://jengelh.medozas.de/documents/Perfect_Ruleset.pdf рекомендуют] использовать вместо него критерий conntrack. Также заметим, что критерий conntrack обладает более широкими возможностями, нежели state, и позволяет использовать дополнительную информацию о соединении, в частности, состояние самого соединения (ctstatus), факт применения к нему [[w:NAT|трансляции адресов]], тайм-аут для «повисших» соединений (ctexpire) и т. п.

==== Маркировка соединений ====
Этот прием позволяет классифицировать соединение в целом на основании информации об отдельном пакете. Выделив этот пакет, вы применяете к нему действие CONNMARK, и выбранную вами маркировку автоматически приобретают все пакеты в соединении. Впоследствии вы можете, например, модифицировать эти пакеты каким-либо образом, или использовать эту маркировку для [[w:Маршрутизация|маршрутизации]] или [[w:Шейпинг (информатика)|шейпинга]] пакетов. Таким образом, вы оперируете с соединением как с единым целым. Более того, эта маркировка автоматически копируется и на соединения, связанные с текущим.

==== [[w:NAT|Трансляция сетевых адресов]] ====
В операциях NAT, производимых с помощью iptables, отслеживание состояний используется автоматически. Вам достаточно указать критерии, под которые подпадет лишь первый пакет в соединении — и трансляция адресов будет применена ко всем пакетам в этом соединении, а также в связанных с ним соединениях.

==== Использование статистики по соединениям ====
Применяя критерий connbytes, вы можете контролировать количество байт или пакетов, переданных по каждому конкретному соединению. В простейшем случае этот механизм может использоваться, скажем, для назначения квот. Более сложный пример — шейпинг пакетов в зависимости от «весовой категории» соединения (ставить пониженный приоритет загрузкам больших файлов).

Этот критерий рассмотрен ниже, в разделе [[#Лимитирующие критерии|лимитирующие критерии]].

==== Ограничение количества соединений ====
Используя критерий connlimit, вы можете ограничивать количество одновременно открытых {{w |TCP}}-соединений с каждого хоста или подсети на ваш сервер, что позволяет обеспечить эффективную защиту от [[w:DoS-атака|DoS-атак]] или просто некорректно работающего клиентского [[w:Программное обеспечение|ПО]].

Этот критерий рассмотрен ниже, в разделе [[#Лимитирующие критерии|лимитирующие критерии]].

==== Отслеживание информации о соединениях ====
Пользователь (точнее, [[w:Root|системный администратор]]) или его процессы могут непосредственно наблюдать таблицу контроля состояний, считывать статистику по передаче данных, а также модифицировать эту таблицу (например, удалять из нее соединения). Для этого существуют специальные утилиты, такие как [[conntrack (Программа)|conntrack]] или [[iptstate]]. Впрочем, можно читать информацию и напрямую из псевдофайлов &lt;tt&gt;/proc/net/nf_conntrack&lt;/tt&gt; и &lt;tt&gt;/proc/net/nf_conntrack_expect&lt;/tt&gt;.

== Действия ==

=== Переходы ===
Для организации перехода пакета из текущей цепочки в другую (определенную пользователем), просто используйте действие &lt;tt&gt;-j имя_цепочки&lt;/tt&gt;. В случае применения в этой цепочке к пакету действия RETURN (см. ниже), пакет вернется в исходную цепочку и продолжит ее прохождение начиная со следующего правила (для базовой цепочки к пакету сразу будет применено действие по умолчанию).

Также, существует довольно редко используемое действие «безвозвратного перехода» &lt;tt&gt;-g имя_цепочки&lt;/tt&gt;. В таком случае, после прохождения пакетом этой цепочки либо при применении в этой цепочке к пакету действия RETURN, пакет вернется к месту последнего перехода по &lt;tt&gt;-j&lt;/tt&gt;. Если таких переходов не было, к пакету сразу будет применено действие по умолчанию для базовой цепочки.

Заметим, что нельзя перейти в любую встроенную цепочку из любой другой, а также в цепочку, определенную в другой таблице (так как это даже нельзя указать параметрами). Но в пользовательских можно переходить в текущую цепочку (но не желательно во избежание зацикливания).

=== Встроенные действия ===
Как уже было сказано выше, каждое встроенное действие реализует какую-либо одну операцию, например, ACCEPT пропускает пакет, MARK меняет его маркировку, MASQUERADE обеспечиват {{w |маскарадинг}} соединения. Наиболее общими действиями являются:
* '''ACCEPT''', '''DROP''' и '''REJECT''' — базовые операции фильтрации. Более подробно они рассмотрены ниже, при описании таблицы filter.
* '''RETURN''' — обеспечивает возврат из текущей цепочки. В частности, если из цепочки A правилом номер 3 пакет был направлен в цепочку B, то применение к нему в цепочке B действия RETURN приведет к его переходу обратно в цепочку A, и он продолжит ее прохождение со следующего правила (номер 4). Для базовой цепочки к пакету сразу будет применено действие по умолчанию.
Например, предположим, что нам нужно обеспечить доступ к определенным [[w:Порт (компьютерные сети)|портам]] нашего сервера для всех хостов из подсети 10.134.0.64/26, ''кроме'' 10.134.0.67 и 10.134.0.100.
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -F # Очищаем все цепочки таблицы filter
iptables -N our_subnet # Создаем специальную цепочку для проверки пакетов из нашей подсети
iptables -A our_subnet -s 10.134.0.67 -j RETURN # Запрещенный хост — выходим
iptables -A our_subnet -s 10.134.0.100 -j RETURN # Запрещенный хост — выходим
# Всем остальным разрешаем доступ к нужным портам
iptables -A our_subnet -p tcp -m multiport --dports 22,53,8080,139,445 -j ACCEPT
iptables -A our_subnet -p udp -m multiport --dports 53,123,137,138 -j ACCEPT
iptables -A our_subnet -p icmp --icmp-type 8 -j ACCEPT
# Разрешаем пакеты по уже установленным соединениям
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT
# Все пакеты из нашей подсети отправляем на проверку
iptables -A INPUT -s 10.134.0.64/26 -j our_subnet
iptables -P INPUT DROP # Что не разрешено — то запрещено
iptables -P OUTPUT ACCEPT # На выход — можно все
&lt;/syntaxhighlight&gt;
Теперь все новые входящие пакеты, отправленные из нашей подсети 10.134.0.64/26, отправляются на проверку в цепочку &lt;tt&gt;our_subnet&lt;/tt&gt;. К пакетам с «запрещенных» хостов применяется операция RETURN, и они покидают эту цепочку и впоследствии блокируются действием по умолчанию цепочки INPUT. Пакеты с остальных хостов этой подсети пропускаются в том случае, если они адресованы на порты [[w:Прокси-сервер|прокси]] (8080/tcp), {{w |SSH}} (22/tcp), {{w |SMB}} (139,445/tcp, 137,138/udp), {{w |DNS}} (53/tcp, udp), {{w |NTP}} (123/udp). Также для этих хостов разрешены {{w |ICMP}}-эхо-запросы (пинги). Все остальные пакеты (включая пакеты не из нашей подсети, пакеты с запрещенных хостов и пакеты на неразрешенные порты) блокируются действием по умолчанию DROP.

Нетрудно заметить, что в нашем простом примере вместо RETURN можно было использовать и DROP. Однако, существует понятие «принципа одного запрета». При организации фильтрующих правил в рамках этого принципа, сначала следует серия разрешающих правил, исключения оформляются в виде RETURN, а все не разрешенные пакеты доходят до конца базовой цепочки и блокируются действием по умолчанию либо последним правилом. Следование этому принципу позволяет достичь гибкости в выборе и смене метода блокирования пакетов. Допустим, вы хотите сменить блокирующее действие DROP на REJECT. Нет ничего проще — просто меняете правило по умолчанию. Так же просто вводятся специфические методы блокировки для TCP, например, REJECT &lt;tt&gt;--reject-with tcp-reset&lt;/tt&gt; или DELUDE — достаточно просто добавить это действие (вместе с указанием протокола &lt;tt&gt;-p tcp&lt;/tt&gt;) в конец цепочки. Все не-TCP пакеты при этом будут по-прежнему блокироваться действием по умолчанию.

Впрочем, изложенный принцип теряет первоначальный смысл, если в разных случаях нужно обеспечить разные способы блокирования. Рассмотрим чуть более сложный пример: допустим, наш сервер подключен к локальной сети 10.0.0.0/8. В ней есть некий «недоверенный» сегмент, скажем, 10.122.0.0/16, для которого нужно полностью заблокировать доступ к нашему серверу. Но в этом сегменте есть несколько «хороших» хостов (скажем, 10.122.72.11 и 10.122.180.91), которые блокировать не нужно. Поставленную задачу можно решить следующим образом:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -F # Очищаем все цепочки таблицы filter
iptables -N check_untrusted # Создаем специальную цепочку для проверки пакетов из нашей подсети
iptables -A check_untrusted -s 10.122.72.11 -j RETURN # Разрешенный хост — выходим
iptables -A check_untrusted -s 10.122.180.91 -j RETURN # Разрешенный хост — выходим
iptables -A check_untrusted -j DROP # Остальных — молча игнорируем
# Разрешаем пакеты по уже установленным соединениям
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT
# Пакеты из недоверенной подсети проверяем по списку
iptables -A INPUT -s 10.122.0.0/16 -j check_untrusted
# Всем остальным разрешаем доступ к нужным портам
iptables -A INPUT -p tcp -m multiport --dports 22,53,8080,139,445 -j ACCEPT
iptables -A INPUT -p udp -m multiport --dports 53,123,137,138 -j ACCEPT
iptables -A INPUT -p icmp --icmp-type 8 -j ACCEPT
# «Хорошим» хостам, обращающимся на неправильные TCP-порты, вежливо сообщаем об отказе
iptables -A INPUT -p tcp -j REJECT --reject-with tcp-reset
# Для всех остальных протоколов используем стандартный REJECT с icmp-port-unreachable
iptables -P INPUT REJECT
iptables -P OUTPUT ACCEPT # На выход — можно все
&lt;/syntaxhighlight&gt;
Заметим, что в данном примере хосты из недоверенного сегмента блокируются «молча» (DROP), в то время как при обращении «хороших» хостов на неправильные порты сервер вежливо сообщает им об отказе (REJECT). Этот принцип также является очень важным при построении фаерволов — чем меньше информации попадает к потенциальному злоумышленнику, тем лучше, поэтому на опасных направлениях целесообразно использовать «молчаливое» блокирование, в то время как явные сообщения для «своих» упрощают диагностику работы сети и поиск ошибок.

: ''Примечание: следующий пример планируется к переносу в еще не написанный раздел статьи (Прочие критерии → mac)''.
Например, предположим, что у нас есть объединенная через один [[w:Сетевой коммутатор|свитч]] подсеть 10.134.0.64/26, к которой наш компьютер подключен через интерфейс eth1. Тогда защиту от {{w |спуфинг}}а (подделки адресов отправителя) через проверку {{w |MAC-адрес}}а можно обеспечить следующим образом:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
sysctl net.ipv4.ip_forward=1 # Разрешаем шлюзу передавать транзитный трафик
iptables -F # Очищаем все цепочки таблицы filter
iptables -N check_ours_sp00f # Создаем цепочку, в которой будут проверяться MAC-адреса
iptables -A check_ours_sp00f -s 10.134.0.67 -m mac --mac-source 00:1D:60:2E:ED:A5 -j RETURN
iptables -A check_ours_sp00f -s 10.134.0.68 -m mac --mac-source 00:1D:60:2E:ED:CD -j RETURN
iptables -A check_ours_sp00f -s 10.134.0.69 -m mac --mac-source 00:1D:60:2E:ED:D7 -j RETURN
iptables -A check_ours_sp00f -s 10.134.0.70 -m mac --mac-source 00:1D:60:2E:ED:E0 -j RETURN
# Аналогичным образом проверяем все адреса нашей подсети
# И в конце обязательно добаляем правило для НЕпрошедших проверку
iptables -A check_ours_sp00f -j DROP
iptables -N check_ours # Создаем цепочку, которая будет описывать логику работы с нашей подсетью
iptables -A check_ours ! -i eth1 -j DROP # С других интерфейсов пакеты от них прийти не могут
iptables -A check_ours -j check_ours_sp00f # Прогоняем их через проверку на спуфинг
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT # Как обычно, пропускаем все, что идет по установленным соединениям
iptables -A INPUT -s 10.134.0.64/26 -j check_ours # Тех, кто претендует на звание своих, прогоняем через проверку
# Прошедшим проверку разрешаем пользоваться нащей проксёй и самбой, а также соединяться по ssh
iptables -A INPUT -s 10.134.0.64/26 -m multiport --dports 22,8080,139,445 -j ACCEPT
iptables -P INPUT DROP # Остальных блокируем
iptables -A FORWARD -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT # Как обычно, пропускаем все, что идет по установленным соединениям
iptables -A FORWARD -s 10.134.0.64/26 -j check_ours # Проверка
iptables -A FORWARD -s 10.134.0.64/26 -j ACCEPT # Прошедшим проверку разрешаем передавать через нас транзитный трафик
iptables -P FORWARD DROP # Остальных блокируем
iptables -P OUTPUT ACCEPT # Исходящий трафик разрешаем
&lt;/syntaxhighlight&gt;
&lt;!--В демонстрационных целях этот пример был слегка упрощён (вместо повтора правил с критерием &lt;tt&gt;-s 10.134.0.64/26&lt;/tt&gt; эти правила логичнее было бы вынести в отдельные цепочки) но, тем не менее, наглядно показывает принципы работы действия RETURN.--&gt;
Все новые входящие пакеты с обратным адресом из подсети 10.134.0.64/26 проходят двойную проверку в цепочке &lt;tt&gt;check_ours&lt;/tt&gt;. Первый этап проверки — соответствие интерфейса. Ведь к нашей подсети, по условию задачи, мы подключены только интерфейсом eth1. Если пакет якобы из этой подсети придет с любого другого интерфейса, он будет заблокирован. Второй этап проверки заключается в последовательном чтении списка соответствующих [[w:IP-адрес|IP]]- и {{w |MAC-адрес}}ов (цепочка &lt;tt&gt;check_ours_sp00f&lt;/tt&gt;). Каждое правило этой цепочки, кроме последнего, выделяет пакеты от одного конкретного хоста нашей подсети. К пакетам, прошедшим проверку, применяется операция RETURN, выводящая пакет из этой цепочки. Если же пакет не подошел ни по одному из этих правил, он считается не прошедшим проверки и блокируется последним правилом &lt;tt&gt;-j DROP&lt;/tt&gt;. Для прошедших же проверку пакетов дальнейшая судьба зависит от того, кому они адресованы. Если они идут через наш хост в другие подсети, то они пропускаются. Если же они адресованы непосредственно нашему хосту, то пропускаются только соединения на некоторые {{w |TCP}}-[[w:Порт (компьютерные сети)|порты]] ([[w:Прокси-сервер|прокси]], {{w |SSH}}, {{w |SMB}}).
* '''LOG''' — позволяет записывать информацию о пакетах в журнал ядра (см. {{w |syslog}}).
Например, если в предыдущем примере перед строкой
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -p tcp -m multiport --dports 22,53,8080,139,445 -j ACCEPT
&lt;/syntaxhighlight&gt;
мы добавим строку
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -p tcp -m multiport --dports 22,53,8080,139,445 -j LOG --log-level INFO --log-prefix &quot;New connection from ours: &quot;
&lt;/syntaxhighlight&gt;
то для каждого нового соединения к нашему хосту из нашей подсети в системном журнале будет появляться запись примерно такого вида:
 Jul 16 20:10:40 interdictor kernel: New connection from ours: IN=eth0 OUT= MAC=00:15:17:4c:89:35:00:1d:60:2e:ed:a5:08:00 SRC=10.134.0.67 
 DST=10.134.0.65 LEN=48 TOS=0x00 PREC=0x00 TTL=112 ID=38914 DF PROTO=TCP SPT=31521 DPT=8080 WINDOW=65535 RES=0x00 SYN URGP=0
Такая запись содержит очень много полезной информации. Начинается она с даты и времени получения пакета. Затем идет имя нашего хоста (interdictor) и источник сообщения (для сообщений фаервола это всегда ядро). Потом идет заданный нами префикс (&lt;tt&gt;New connection from ours:&lt;/tt&gt;), после чего следуют данные о самом пакете: входящий интерфейс (определен для цепочек PREROUTING, INPUT и FORWARD), исходящий интерфейс (определен для цепочек FORWARD, OUTPUT и POSTROUTING), далее — сцепленные вместе {{w |MAC-адрес}}а источника и назначения (сначала идет адрес назначения, в данном случае это наш интерфейс eth1 с маком 00:15:17:4C:89:35, затем адрес источника, в нашем случае это 00:1D:60:2E:ED:A5, и в конце следует значение [[:en:EtherType|EtherType]], 08:00 соответствует протоколу {{w |IPv4}}&lt;ref&gt;Если кратко, EtherType указывает тип протокола, инкапсулированного в {{w |Ethernet}}-[[w:Кадр (телекоммуникации)|кадр]]. При работе с iptables это значение будет всегда равно 08:00 (протокол {{w |IPv4}}), при работе с ip6tables — 86:DD ({{w |IPv6}}). Полный список EtherTypes доступен [https://www.iana.org/assignments/ieee-802-numbers/ieee-802-numbers.xhtml#ieee-802-numbers-1 на сайте IANA], список поддерживаемых netfilter’ом — в файле /etc/ethertypes, который в большинстве дистрибутивов находится в пакете {{w |ebtables}}.&lt;/ref&gt;), потом {{w |IP-адрес}}а источника (10.134.0.67) и получателя (10.134.0.65, это наш хост), а затем идет различная техническая информация. Например, протокол ({{w |TCP}}), [[w:Порт (компьютерные сети)|порты]] источника и назначения (31521 и 8080 соответственно), [[w:Тип обслуживания|TOS]] и [[w:Time to live|TTL]], длина пакета (48 байт), наличие флага SYN и т. д.

Указав соответствующие параметры действия LOG, можно дополнить эту информацию [[w:TCP#Номер последовательности|номером TCP-последовательности]] (опция &lt;tt&gt;--log-tcp-sequence&lt;/tt&gt;), выводом включенных опций протоколов TCP (опция &lt;tt&gt;--log-tcp-options&lt;/tt&gt;) и {{w |IP}} (&lt;tt&gt;--log-ip-options&lt;/tt&gt;), а также идентификатором пользователя, процесс которого отправил данный пакет (&lt;tt&gt;--log-uid&lt;/tt&gt;, имеет смысл только в цепочках OUTPUT и POSTROUTING).

Параметр &lt;tt&gt;--log-prefix&lt;/tt&gt; позволяет задать поясняющую надпись, упрощающую поиск сообщений в системных журналах. Параметр &lt;tt&gt;--log-level&lt;/tt&gt; определяет уровень важности лог-сообщения, от которого зависит, в частности, в какой именно из журналов будет записано это сообщение. За более подробными сведениями обратитесь к документации по вашему [[w:Syslog|демону системного лога]].
* '''LOGMARK''' — специальная модификация действия LOG, реализованная в комплекте xtables-addons. Отличается тем, что заносит в лог информацию, специфичную для системы [[conntrack]], в частности, маркировку соединения (connmark aka ctmark), состояния соединения (ctstate и ctstatus) и т. п. Например:
  Jul 16 20:10:40 interdictor kernel: New connection from ours: iif=1 hook=INPUT nfmark=0x0 secmark=0x0 classify=0x0 ctdir=ORIGINAL 
  ct=0xf5436bcc ctmark=0x0 ctstate=NEW ctstatus=
&lt;tt&gt;iif&lt;/tt&gt; показывает внутренний идентификатор интерфейса, через который прошел пакет (1 в данном случае соответствует eth0, 0 — lo), &lt;tt&gt;hook&lt;/tt&gt; — имя цепочки, из которой было вызвано действие LOGMARK, &lt;tt&gt;nfmark&lt;/tt&gt; — маркировку пакета (mark), &lt;tt&gt;secmark&lt;/tt&gt; — контекст безопасности {{w |SELinux}} данного пакета (secmark), &lt;tt&gt;classify&lt;/tt&gt; — класс шейпера (также известный как &lt;tt&gt;skb-&gt;priority&lt;/tt&gt;, соответствует обычной для [[w:Iproute2|tc]] форме записи ''MAJOR'':''MINOR'' согласно формуле &lt;tt&gt;skb-&gt;priority == ''MAJOR'' &lt;&lt; 16 | ''MINOR''&lt;/tt&gt;), &lt;tt&gt;ctdir&lt;/tt&gt; — направление передачи информации с точки зрения conntrack, &lt;tt&gt;ct&lt;/tt&gt; — внутренний идентификатор соединения в системе conntrack (точнее говоря, адрес в памяти, по которому расположена структура, хранящая информацию о соединении), &lt;tt&gt;ctmark&lt;/tt&gt; — маркировку соединения (connmark), &lt;tt&gt;ctstate&lt;/tt&gt; — состояние соединения, &lt;tt&gt;ctstatus&lt;/tt&gt; — статус соединения в системе cоnntrack. Более подробно о параметрах ctdir, ctstate и ctstatus вы можете прочитать [[#conntrack|ниже]], в описании критерия conntrack. Здесь же ограничимся замечаниями, что «&lt;tt&gt;ctstate=NEW ctstatus=&lt;/tt&gt;» соответствует первому пакету в соединении, «&lt;tt&gt;ctstate=ESTABLISHED ctstatus=SEEN_REPLY,CONFIRMED&lt;/tt&gt;» — второму и нескольким последующим пакетам, «&lt;tt&gt;ctstate=ESTABLISHED ctstatus=SEEN_REPLY,ASSURED,CONFIRMED&lt;/tt&gt;» — пакетам в полностью установленном соединении, «&lt;tt&gt;ct=NULL ctmark=NULL ctstate=INVALID ctstatus=NONE&lt;/tt&gt;» — пакету, который не удалось отнести к существующим соединениям, «&lt;tt&gt;ct=UNTRACKED ctmark=NULL ctstate=UNTRACKED ctstatus=NONE&lt;/tt&gt;» — пакету, для которого была отключена трассировка conntrack (обычно это выполняется действием NOTRACK в таблице raw, см. [[#Таблица raw|ниже]]).

Таким образом, в сочетании с традиционным LOG, действие LOGMARK позволяет заносить в системный журнал исчерпывающую информацию о пакетах и соединениях.

Заметим, что LOGMARK принимает описанные выше опции &lt;tt&gt;--log-prefix&lt;/tt&gt; и &lt;tt&gt;--log-level&lt;/tt&gt;.
* '''ULOG''' — позволяет передавать информацию об обработанных пакетах специальным демонам, таким, как [http://www.netfilter.org/projects/ulogd/ ulogd]. Такой подход позволяет эффективно управлять информацией о трафике, в частности, заносить ее в {{w |базы данных}}, такие как {{w |MySQL}}, {{w |PostgreSQL}} или {{w |SQLite}}. Впоследствии эти данные могут быть проанализированы и визуализированы с помощью таких средств, как [http://software.inl.fr/trac/wiki/EdenWall/NuLog NuLog].
* '''NFLOG''' — более универсальный вариант ULOG, обеспечивающий передачу информации о пакете не напрямую в netlink-[[w:Сокет (программный интерфейс)|сокет]] (как это делает ULOG), а специальной подсистеме — logging backend. Например, бэкенд nfnetlink_log обеспечивает передачу данных в netlink-сокет, то есть с ним NFLOG работает аналогично ULOG.
* '''NFQUEUE''' — во многом похоже на ULOG, но передает специальному демону не информацию о пакете, а сам пакет целиком. Применяется, в частности, для организации работы {{w |l7-filter}}-userspace.
Например, если демон l7-filter был запущен командой
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
l7-filter -f /etc/l7-filter.conf -q 2
&lt;/syntaxhighlight&gt;
то передать ему на обработку все входящие и локально сгенерированные пакеты можно командами
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -F # На всякий случай очищаем таблицу mangle
iptables -t mangle -A PREROUTING -j NFQUEUE --queue-num 2
iptables -t mangle -A OUTPUT -j NFQUEUE --queue-num 2
&lt;/syntaxhighlight&gt;
Опция &lt;tt&gt;--queue-num&lt;/tt&gt; позволяет указать номер очереди пакетов. Он должен быть совпадать с номером, указанным при запуске демона l7-filter (параметр &lt;tt&gt;-q&lt;/tt&gt;).
* '''QUEUE''' — устаревшая версия NFQUEUE. Не имеет параметров, так как работает только с очередью номер 0.

Выше были рассмотрены действия «общего назначения», то есть не привязанные по своей специфике к таблицам. Далее, при рассмотрении отдельных таблиц, будут описываться действия, специфичные для каждой таблицы. Термин «специфичные» надо понимать так: совсем не обязательно, что действие, специфичное для одной таблицы, будет в принципе недопустимо в другой, но в любом случае использование этого действия в других таблицах будет «плохим тоном» — ведь таблицы и действия четко разделены по назначению. Не стоит «забивать гвозди микроскопом».

Порой эта разница бывает довольно тонкой. Например, если действие NFQUEUE передает пакеты демону {{w |l7-filter}}-userspace (который занимается маркировкой пакетов на основе анализа их содержимого), то правильнее будет разместить вызов такого действия в таблице mangle. Если же оно передает пакеты демону [[nufw]] (который обеспечивает разрешение или запрещение трафика на основе авторизации пользователя), то логичнее разместить это действие в таблице filter.

Кроме того, существуют и ограничения, наложенные непосредственно в коде iptables. Например, действия таблицы nat жестко защищены от употребления за ее пределами. Другой пример: действие REDIRECT можно применять только в цепочках PREROUTING и OUTPUT таблицы nat, то есть ограничения могут быть не только на таблицы, но на отдельные цепочки. Данная статья ни в коем случае не претендует на полноту изложения, поэтому, перед тем как использовать какое-либо действие, обязательно ознакомьтесь с документацией, прилагающейся к вашей версии iptables.
* '''TRACE''' - трассировка прохождения пакетов по цепочке
Для включения трассировки нужно загрузить модуль ядра xt_LOG:
  modprobe xt_LOG
  echo xt_LOG &gt; /proc/sys/net/netfilter/nf_log/2
доступно только для таблицы raw. Пример правила:
  iptables -I PREROUTING 1 -t raw -s 192.168.200.25 -d 1.1.1.1 -j TRACE
Лог трассировки по умолчанию записывается в /var/log/syslog. Для удобства, можно раскрашивать вывод с помощью небольшого скрипта view-trace.sh

=== Терминальные и нетерминальные действия ===
* ''Терминальными'' называются действия, которые прерывают прохождение пакета через текущую базовую цепочку. То есть если к пакету в рамках некоторого правила было применено терминальное действие, он уже не проверяется на соответствие всем следующим правилам в этой цепочке (и в тех цепочках, из которых она была вызвана, если это пользовательская цепочка). Терминальными являются все действия, специфичные для таблиц filter и nat. Из приведенных выше в этом разделе — ACCEPT, DROP, REJECT, NFQUEUE, QUEUE.
Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -p tcp --dport 80 -j ACCEPT
iptables -A INPUT -p tcp --dport 80 -j LOG --log-prefix &quot;IN HTTP: &quot;
&lt;/syntaxhighlight&gt;
Второе из приведенных правил (логгирование) никогда не будет срабатывать, так как все пакеты, удовлетворяющие этому критерию (входящие TCP-пакеты на порт 80), будут пропущены по первому из этих правил, и до второго просто не дойдут.

* ''Нетерминальными'', соответственно, являются действия, ''не'' прерывающие процесс прохождения пакета через цепочки. Нетерминальными являются действия, специфичные для таблицы mangle, а из перечисленных выше — LOG, ULOG и NFLOG.
Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -p tcp --dport 80 -j LOG --log-prefix &quot;IN HTTP: &quot;
iptables -A INPUT -p tcp --dport 80 -j ACCEPT
&lt;/syntaxhighlight&gt;
Теперь все входящие на TCP-порт 80 пакеты будут сначала заноситься в лог, и только потом пропускаться.

Действие RETURN с точки зрения такой классификации занимает промежуточное положение — оно может прервать прохождение пакета через отдельную цепочку (или несколько цепочек, если для перехода в них использовалась опция &lt;tt&gt;-g&lt;/tt&gt;, а не &lt;tt&gt;-j&lt;/tt&gt;), но совсем не обязательно, чтобы это приводило к завершению обработки пакета в рамках текущей базовой цепочки.

== Таблицы ==
[[Файл:Netfilter-diagram-rus.png|thumb|400px|Путь проверки пакета в системе netfilter]]

=== Таблица mangle ===
Данная таблица предназначена для операций по классификации и маркировке пакетов и соединений, а также модификации заголовков пакетов (поля [[w:Time to live|TTL]] и [[w:Тип обслуживания|TOS]]).

==== Цепочки ====
Таблица mangle содержит следующие цепочки:
* '''PREROUTING''' — позволяет модифицировать пакет ''до'' принятия решения о маршрутизации.
* '''INPUT''' — позволяет модифицировать пакет, предназначенный самому хосту.
* '''FORWARD''' — цепочка, позволяющая модифицировать транзитные пакеты.
* '''OUTPUT''' — позволяет модифицировать пакеты, исходящие от самого хоста.
* '''POSTROUTING''' — дает возможность модифицировать все исходящие пакеты, как сгенерированные самим хостом, так и транзитные.

Заметим, что все цепочки таблицы mangle пакеты проходят раньше, чем одноименные цепочки таблиц nat и filter. Это позволяет классифицировать и маркировать пакеты и соединения в цепочках этой таблицы. Впоследствии эти маркировки могут быть использованы в цепочках двух других таблиц при принятии решений о фильтрации и трансляции адресов.

==== Действия ====
Допустимыми действиями в этой таблице являются:
* '''TOS''' — изменяет поле [[w:Тип обслуживания|TOS]] данного пакета. Поддерживаются опции &lt;tt&gt;--set-tos&lt;/tt&gt; (установить поле TOS в заданное значение), а также &lt;tt&gt;--and-tos&lt;/tt&gt;, &lt;tt&gt;--or-tos&lt;/tt&gt; и &lt;tt&gt;--xor-tos&lt;/tt&gt;, комбинирующие текущее значение поля TOS с заданным в правиле значением по соответствующему логическому правилу и записывающие результат как новое значения поля TOS.

Кроме того, опция &lt;tt&gt;--set-tos&lt;/tt&gt; поддерживает расширенный синтаксис &lt;tt&gt;--set-tos ''значение''/''маска''&lt;/tt&gt;. При использовании такого синтаксиса в исходном значении TOS пакета зануляются те биты, которые установлены в маске, затем полученное число XOR’ится с указанным в параметрах значением, и полученная величина записывается в поле TOS. Используя синтаксис [[w:Си (язык программирования)|языка C]], это можно записать так: &lt;tt&gt;NEW_TOS = (OLD_TOS &amp; ~''маска'') ^ ''значение''&lt;/tt&gt;. Заметим, что в случае с {{w |IPv6}} операция отрицания маски не выполняется (то есть в исходном значении зануляются те биты, которые в маске ''не установлены''), хотя это и не отражено в документации.

Также, в случае {{w |IPv4}} (iptables) в параметре &lt;tt&gt;--set-tos&lt;/tt&gt; вы можете указать одно из допустимых символьных обозначений: Minimize-Delay (TOS 16, требование минимальной задержки), Maximize-Throughput (TOS 8, требование максимальной пропускной способности), Maximize-Reliability (TOS 4, максимальная надежность доставки), Minimize-Cost (TOS 2, минимальная стоимость), Normal-Service (TOS 0, специальные требования отсутствуют). В ip6tables использование этих обозначений не запрещено, однако в этом случае более корректным будет использование действия DSCP (см. ниже).

Практический пример использования действия TOS представлен [[#Лимитирующие критерии|ниже]], в описании критерия connbytes.

Отметим, что, в соответствии с современными соглашениями, поле TOS в заголовке IP-пакета разделяется на две части: {{w |DSCP}} (первые шесть бит кода TOS) и [[w:Explicit Congestion Notification|ECN]] (последние два бита TOS). Современные версии netfilter/iptables не поддерживают изменение значений ECN в IP-заголовках, поэтому фактически действие TOS работает только с полем DSCP, отличаясь от действия DSCP (см. чуть ниже) разве что интерфейсом (фактически, синтаксисом).

* '''DSCP''' — изменяет поле {{w |DSCP}} (класс [[:en:Differentiated services|DiffServ]]) в заголовке пакета. Поддерживаются опции &lt;tt&gt;--set-dscp&lt;/tt&gt; (позволяет задать значение DSCP числом) и &lt;tt&gt;--set-dscp-class&lt;/tt&gt; (позволяет установить заданный класс DiffServ, например, EF или AF13).
* '''TTL''' — изменяет поле [[w:Time to live|TTL]] данного пакета (работает только с {{w |IPv4}}, для {{w |IPv6}} используется действие HL). Поддерживаются опции &lt;tt&gt;--ttl-set&lt;/tt&gt; (установить поле TTL в заданное значение), а также &lt;tt&gt;--ttl-inc&lt;/tt&gt; и &lt;tt&gt;--ttl-dec&lt;/tt&gt; (соответственно увеличить или уменьшить текущее значение поля TTL на заданное значение). Допустимые значения TTL — от 0 до 255. При достижении TTL=0 пакет уничтожается.

В качестве полезного примера использования этого действия можно привести команду
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -I PREROUTING -j TTL --ttl-inc 1
&lt;/syntaxhighlight&gt;
делающую наш шлюз невидимым для большинства [[w:Traceroute|трассировщиков]].

Обратите внимание, что автоматически выполняемая сетевым стеком ядра операция уменьшения TTL на единицу и проверки на равенство нулю выполняется ''после'' цепочки PREROUTING, но ''до'' цепочки FORWARD. Таким образом, переместив это правило в цепочку FORWARD, вы обеспечите «невидимость» следующего за вами шлюза.

Другой полезный пример — выравнивание TTL на выходе в Интернет (интерфейс eth0)
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -I POSTROUTING -o eth0 -j TTL --ttl-set 64
&lt;/syntaxhighlight&gt;
Некоторые домашние провайдеры, пытаясь бороться с нелегальной перепродажей канала их клиентами, блокируют доступ тем клиентам, на выходе которых замечены пакеты с разными значениями TTL, потому что этот факт косвенно указывает на наличие у клиента внутренней подсети. Предложенное правило, будучи применено на шлюзе такой подсети, делает ее детекцию по TTL крайне затруднительной.

'''Будьте очень осторожны''' с правилами, которые увеличивают или, что особенно опасно, напрямую задают значение TTL, так как, при наличии определенных ошибок маршрутизации, это может привести к появлению «бессмертных» пакетов, которые будут долго циркулировать между одними и теми же узлами, захламляя канал и затрудняя работу сетевого оборудования.

* '''HL''' — изменяет поле Hop Limit в заголовке {{w |IPv6}}-пакета. Является аналогом IPv4-действия TTL и поддерживает те же операции: &lt;tt&gt;--hl-set&lt;/tt&gt; (установить поле HL в заданное значение), а также &lt;tt&gt;--hl-inc&lt;/tt&gt; и &lt;tt&gt;--hl-dec&lt;/tt&gt; (соответственно увеличить или уменьшить текущее значение поля HL на заданное значение).
* '''MARK''' — устанавливает или изменяет маркировку пакета. Поддерживает опции &lt;tt&gt;--set-mark&lt;/tt&gt;, &lt;tt&gt;--and-mark&lt;/tt&gt;, &lt;tt&gt;--or-mark&lt;/tt&gt; и &lt;tt&gt;--xor-mark&lt;/tt&gt;, аналогичные опциям действия TOS. Важно понимать, что маркировка пакета не хранится в его заголовке или содержимом, и поэтому действует только в пределах одного хоста. Также нужно отличать маркировку пакета от маркировки соединения. Маркировка пакетов может применяться для их дальнейшей обработки фаерволом (критерии mark и connmark), а также для классификации трафика фильтрами [[w:Шейпинг (информатика)|шейпинговой]] подсистемы [[w:Iproute2|tc]] (лексема handle ''mark'' fw).
* '''CONNMARK''' — устанавливает или изменяет маркировку соединения. Поддерживает те же опции, что и MARK, а также дополнительные опции &lt;tt&gt;--restore-mark&lt;/tt&gt; (копирует маркировку соединения в маркировку пакета) и &lt;tt&gt;--save-mark&lt;/tt&gt; (копирует маркировку пакета в маркировку соединения).
* '''CLASSIFY''' — устанавливает [[:en:Class Based Queueing|CBQ]]-класс пакета для его последующей обработки [[w:Шейпинг (информатика)|шейпером]] (опция &lt;tt&gt;--set-class&lt;/tt&gt;).
* '''TCPMSS''' — устанавливает [[:en:Maximum segment size|максимальный размер TCP-сегмента]]. Бывает крайне полезной при использовании {{w |VPN}}-подключения&lt;ref&gt;Обычно проблемы с пониженным {{w |MTU}} в {{w |Ethernet}}-сетях возникают как раз из-за {{w |VPN}}-туннелей&lt;/ref&gt; в том случае, если VPN-сервер блокирует {{w |ICMP}}-сообщения destination unreachable/fragmentation needed (тип 3, код 4), тем самым нарушая работу процедуры [[w:Maximum transmission unit#Технология Path MTU discovery|Path MTU discovery]].

С точки зрения клиента, эта проблема выглядит так: {{w |пинг}}и проходят нормально, но при попытке открыть какую-либо {{w |веб}}-страницу, {{w |браузер}} «подвисает». При этом с самого шлюза все работает нормально. В этом случае достаточно применить на шлюзе следующую команду
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -I FORWARD -p tcp --tcp-flags SYN,RST SYN -j TCPMSS --clamp-mss-to-pmtu
&lt;/syntaxhighlight&gt;
которая обеспечит автоматическую установку размера сегмента в TCP-заголовках SYN- и RST,SYN-пакетов в соответствии с минимальным из известных нашему шлюзу значений {{w |MTU}} на пути следования пакета. Например, если пакет пришел с интерфейса eth0 (MTU 1500) и уходит через интерфейс ppp0 (MTU 1492), а суммарный размер заголовков [[w:Протоколы сетевого уровня|сетевого]] и [[w:Транспортный уровень|транспортного]] уровней составляет 40 {{w |байт}} (20 байт {{w |TCP}} и 20 байт {{w |IP}}), то целесообразно установить MSS равным 1452 байтам.

Помимо возможности автоматического выбора TCP MSS, вы можете задать необходимое значение и вручную, используя параметр &lt;tt&gt;--set-mss ''значение''&lt;/tt&gt;. Это бывает полезным в том случае, если вам заведомо известно, что дальше на маршруте встречаются участки с еще меньшим MTU, а пограничные сервера этих участков опять же блокируют ICMP destination unreachable/fragmentation needed.
* '''ECN''' — обеспечивает обнуление [[w:Explicit Congestion Notification|ECN]]-битов (флаги CWR и ECE) в TCP-заголовке (единственная опция &lt;tt&gt;--ecn-tcp-remove&lt;/tt&gt;). Может использоваться только в {{w |IPv4}}-модуле (iptables, но не ip6tables) для {{w |TCP}}-пакетов (&lt;tt&gt;-p tcp&lt;/tt&gt;). Данное действие предназначено для защиты пакетов от ECN blackholes (маршрутизаторов, которые некорректно обрабатывают пакеты с установленными в TCP-заголовке ECN-битами) — рекомендуется применять это действие ко всем пакетам, уходящим на такие маршрутизаторы. Обратите внимание, что данное действие никак не влияет на ECN-биты в {{w |IP}}-заголовках (последние два бита поля [[w:Тип обслуживания|TOS]]).

Кроме того, данное действие поддерживает три потенциально опасные опции, не отраженные в документации: &lt;tt&gt;--ecn-tcp-cwr&lt;/tt&gt; (установка значения бита CWR в TCP-заголовке, 0 или 1), &lt;tt&gt;--ecn-tcp-ece&lt;/tt&gt; (установка значения бита ECE в TCP-заголовке, 0 или 1) и &lt;tt&gt;--ecn-ip-ect&lt;/tt&gt; (установка значения ECT codepoint в IPv4-заголовке, от 0 до 3). Использование этих опций настолько опасно, что они не отражены даже во встроенной справке iptables (&lt;tt&gt;iptables -j ECN -h&lt;/tt&gt;) — их можно увидеть, только изучив [https://git.netfilter.org/iptables/tree/extensions/libipt_ECN.c исходный код]. Без крайней необходимости применять их не рекомендуется.
* '''TCPOPTSTRIP''' — выполняет удаление заданных TCP-опций из заголовка TCP-пакета (единственный параметр &lt;tt&gt;--strip-options ''значение''[,''значение''[,...]]&lt;/tt&gt;). Удаляемые опции могут быть указаны через их номера (согласно [http://www.iana.org/assignments/tcp-parameters/tcp-parameters.xhtml списку на сайте IANA]) или в виде символьных обозначений (список обозначений, поддерживаемых в вашей версии iptables можно посмотреть, выполнив команду &lt;tt&gt;iptables -j TCPOPTSTRIP -h&lt;/tt&gt;). Разумеется, данное действие допустимо только для протокола TCP (&lt;tt&gt;-p tcp&lt;/tt&gt;). Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -A POSTROUTING -p tcp -j TCPOPTSTRIP --strip-options timestamp
&lt;/syntaxhighlight&gt;
обеспечит удаление штампов времени ({{RFC|1323}}). С одной стороны, такое правило будет препятствовать удаленному злоумышленнику определить {{w |аптайм}} нашего хоста, а также тех хостов, маршрут от которых до злоумышленника проходит через наш хост. С другой стороны, блокирование штампов времени может негативно сказаться на быстродействии сети, особенно если вы используете подключения на скорости [[w:Fast Ethernet|100 МБит]] и выше. Заметим также, что если вам нужно управлять использованием именно штампов времени для TCP IPv4-пакетов, исходящих от вашего хоста, вы можете воспользоваться {{w |sysctl}}-параметром net.ipv4.tcp_timestamps (1 — штампы включены, 0 — выключены).
* '''TPROXY''' — реализует механизм полностью прозрачного [[w:Прокси-сервер|проксирования]]. Такой подход отличается от традиционно используемого «прозрачного» проксирования (действие REDIRECT [[#Таблица nat|таблицы nat]], см. ниже) тем, что заголовок пакета никак не модифицируется, в том числе не заменяется {{w |IP-адрес}} назначения (при традиционном прозрачном проксировании он заменяется на адрес проксирующего хоста). Кроме того, полностью прозрачное проксирование является прозрачным с точки зрения обеих общающихся сторон. Например, при проксировании обращений некоторой подсети клиентов к серверам из другой подсети, можно сделать так, чтобы не только клиенты считали, что обращаются напрямую к серверам, но и сервера «видели» настоящие исходные адреса клиентов и могли бы устанавливать с ними обратные соединения (например, в случае активного режима {{w |FTP}}). При традиционном же «прозрачном» проксировании, сервера могут видеть только адрес прокси-сервера.

TPROXY позволяет перенаправить транзитный пакет на локальный [[w:Сокет (программный интерфейс)|сокет]] типа AF_INET (iptables) или AF_INET6 (ip6tables), заданный портом, а также может промаркировать пакет таким образом, чтобы система марушрутизации ({{w |iproute2}}) не позволила пакету покинуть наш хост. Разумеется, поддержка полностью прозрачного проксирования должна быть реализована и в самом {{w |прокси-сервер}}е. В частности, прозрачное проксирование {{w |IPv4}} {{w |HTTP}} [http://wiki.squid-cache.org/Features/Tproxy4 поддерживается] прокси-сервером {{w |Squid}} начиная с версии 3.1.

В качестве примера можно привести простейший случай конфигурации iptables и iproute2 для обеспечения полностью прозрачного проксирования {{w |IPv4}} {{w |HTTP}}.
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
# Добавляем принудительную локальную маршрутизацию для всех адресов в таблицу 120
ip route add local 0.0.0.0/0 dev lo table 120
# Все пакеты, имеющие соответствующую маркировку, направляем в эту таблицу
ip rule add fwmark 120 table 120
# Выполняем проксирование для новых соединений
iptables -t mangle -I PREROUTING -p tcp --dport 80 -j TPROXY --tproxy-mark 120 --on-port 3129
# Перехватываем, маркируем и пропускаем пакеты, принадлежащие проксируемым соединениям
iptables -t mangle -N proxypackets
iptables -t mangle -A proxypackets -j MARK --set-mark 120
iptables -t mangle -A proxypackets -j ACCEPT
# Такие пакеты можно выделять с помощью критерия socket
iptables -t mangle -I PREROUTING -m socket -j proxypackets
&lt;/syntaxhighlight&gt;
Таким образом, пакеты, перехваченные TPROXY-правилом, маркируются и направляются на локальный сокет (порт 3129), который должен прослушиваться специально сконфигурированным прокси-сервером (в случае Squid, в файл конфигурации &lt;tt&gt;squid.conf&lt;/tt&gt; нужно добавить строку &lt;tt&gt;http_port 3129 tproxy&lt;/tt&gt;). Все пакеты, принадлежащие уже проксируемым соединениям, перехватываются правилом с критерием socket (этот критерий позволяет определить, существует ли на нашем хосте сокет, связанный с данным пакетом), маркируются и немедленно пропускаются. Отметим, что последнее правило будет обрабатываться раньше, чем правило с TPROXY, так как параметр &lt;tt&gt;-I&lt;/tt&gt; обеспечивает вставку правил ''в начало'' цепочки, и при последовательном добавлении нескольких правил с этим параметром, порядок добавленных правил будет обратным порядку их ввода.

=== Таблица nat ===
Предназначена для операций stateful-преобразования [[w:IP-адрес|сетевых адресов]] и [[w:Порт (компьютерные сети)|портов]] обрабатываемых пакетов.

==== Цепочки ====
Таблица nat содержит следующие цепочки:
* '''PREROUTING''' — в эту цепочку пакеты попадают ''до'' принятия решения о маршрутизации. По сути, термин «решение о маршрутизации» подразумевает деление трафика на входящий (предназначенный самому хосту) и транзитный (идущий через этот хост на другие хосты). Именно на данном этапе нужно проводить операции проброса (DNAT, REDIRECT, NETMAP).
* '''OUTPUT''' — через эту цепочку проходят пакеты, сгенерированные процессами самого хоста. На данном этапе при необходимости можно повторить операции проброса, так локально сгенерированные пакеты ''не'' проходят цепочку PREROUTING и ''не'' обрабатываются ее правилами. См. пример для действия DNAT ниже.
* '''POSTROUTING''' — через эту цепочку проходят все исходящие пакеты, поэтому именно в ней целесообразно проводить операции {{w |маскарадинг}}а (SNAT и MASQUERADE).

==== Действия ====
Допустимыми действиями в таблице nat являются:
* '''MASQUERADE''' — подменяет адрес источника для исходящих пакетов адресом того интерфейса, с которого они исходят, то есть осуществляет {{w |маскарадинг}}. Такая операция позволяет, например, предоставлять доступ в {{w |Интернет}} целым [[w:Локальная вычислительная сеть|локальным сетям]] через один [[w:Сетевой шлюз|шлюз]].

Допустим, у нас есть локальная сеть 192.168.1.0/255.255.255.0 с несколькими компьютерами, имеющими адреса 192.168.1.2, 192.168.1.3 и т. д. Адрес 192.168.1.1 имеет внутренний (подключенный к локальной сети) сетевой интерфейс шлюза, назовем этот интерфейс eth1. Другой его интерфейс, назовем его eth0, подключен к сети Интернет и имеет адрес, допустим, 208.77.188.166. Тогда, чтобы обеспечить выход хостов из этой локальной сети в Интернет, на шлюзе достаточно выполнить следующие команды
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
sysctl net.ipv4.ip_forward=1 # Разрешаем шлюзу передавать транзитный трафик
iptables -F FORWARD # На всякий случай очистим цепочку FORWARD
# Разрешаем проходить пакетам по уже установленным соединениям
iptables -A FORWARD -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT
# Разрешаем исходящие соединения из локальной сети к интернет-хостам
iptables -A FORWARD -m conntrack --ctstate NEW -i eth1 -s 192.168.1.0/24 -j ACCEPT
iptables -P FORWARD DROP # Весь остальной транзитный трафик — запрещаем.
iptables -t nat -F POSTROUTING # На всякий случай очистим цепочку POSTROUTING таблицы nat
# Маскарадим весь трафик, идущий через eth0
iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
&lt;/syntaxhighlight&gt;
Теперь, если один из хостов локальной сети, например, 192.168.1.2, попытается связаться с одним из интернет-хостов, например, 199.204.44.194 (kernel.org), при проходе его пакетов через шлюз, их исходный адрес будет подменяться на внешний адрес шлюза, то есть 208.77.188.166. С точки зрения удаленного хоста (kernel.org), это будет выглядеть, как будто с ним связывается непосредственно сам шлюз. Когда же удаленный хост начнет ответную передачу данных, он будет адресовать их именно шлюзу, то есть 208.77.188.166. Однако, на шлюзе адрес назначения этих пакетов будет подменяться на 192.168.1.2, после чего пакеты будут передаваться настоящему получателю. Для такого обратного преобразования никаких дополнительных правил указывать не нужно — это будет делать все та же операция MASQUERADE. Простота трансляции сетевых адресов является одним из важнейших достоинств stateful-фильтрации.

Если же такой трансляции не производить, удаленный хост просто не сможет ответить на адрес 192.168.1.2, так как адресные пространства локальных сетей изолировано от адресного пространства Интернета. В мире могут существовать миллионы локальных сетей 192.168.1.0/255.255.255.0, и в каждой может быть свой хост 192.168.1.2. Эти сети могут и не быть связаны с Интернетом. Но если они с ним связаны — то только благодаря механизмам трансляции сетевых адресов.

* '''SNAT''' (Source Network Address Translation) — работает аналогично MASQUERADE, однако позволяет указать адрес «внешнего» интерфейса (опция &lt;tt&gt;--to-source&lt;/tt&gt;). Такой подход позволяет экономить процессорное время шлюза, так как в случае с MASQUERADE для каждого пакета адрес внешнего интерфейса определяется заново при каждом новом коннекте (например к сайту на другом хосту). Таким образом, если в предыдущем примере внешний адрес шлюза 208.77.188.166 является статическим (то есть никогда не меняется), команду
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
&lt;/syntaxhighlight&gt;
целесообразно заменить на
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A POSTROUTING -o eth0 -j SNAT --to-source 208.77.188.166
&lt;/syntaxhighlight&gt;
Однако, в случае, если внешний адрес шлюза динамический, то есть меняется в начале каждой новой сессии, правильнее будет использовать именно MASQUERADE.

Дополнительно, если на внешнем интерфейсе шлюза «висит» несколько статических адресов, например, 208.77.188.166, 208.77.188.167 и 208.77.188.168, можно использовать балансировку между этими адресами:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A POSTROUTING -o eth0 -j SNAT --to-source 208.77.188.166-208.77.188.168
&lt;/syntaxhighlight&gt;
Теперь для каждого нового соединения адрес для подмены будет выбираться случайным образом.

* '''DNAT''' (Destination Network Address Translation) — подменяет адрес назначения для входящих пакетов, позволяя «пробрасывать» адреса или отдельные порты внутрь локальной сети.

Возвращаясь к предыдущему примеру, предположим, что нам нужно «пробросить» внешний адрес шлюза 208.77.188.166 на хост 192.168.1.2, то есть все, кто будет обращаться по внешнему адресу шлюза 208.77.188.166, должны попадать на хост 192.168.1.2. Это достигается следующими командами:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
# Разрешаем шлюзу передавать транзитный трафик
sysctl net.ipv4.ip_forward=1
iptables -t nat -F PREROUTING # На всякий случай очистим цепочку PREROUTING таблицы nat
# Пробрасываем 208.77.188.166 на 192.168.1.2
iptables -t nat -A PREROUTING -d 208.77.188.166 -j DNAT --to-destination 192.168.1.2
iptables -F FORWARD # На всякий случай очистим цепочку FORWARD
# Разрешаем проходить пакетам по уже установленным соединениям
iptables -A FORWARD -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT
# Разрешаем входящие соединения к 192.168.1.2
iptables -A FORWARD -m conntrack --ctstate NEW -d 192.168.1.2 -j ACCEPT
iptables -P FORWARD DROP # Весь остальной транзитный трафик — запрещаем.
&lt;/syntaxhighlight&gt;
В лучших традициях stateful-фаерволинга, подменяются не только адреса назначения для входящих пакетов (208.77.188.166 -&gt; 192.168.1.2), но и адреса источника для исходящих пакетов (192.168.1.2 -&gt; 208.77.188.166), поэтому для интернет-хостов создается полное впечатление, что они общаются именно с 208.77.188.166.

Однако, при всей своей простоте и наглядности, этот пример имеет два недостатка. Во-первых, из нашей локальной сети 192.168.1.0/24 адрес 208.77.188.166 может быть недоступен, так как 192.168.1.2, увидев, что запрос исходит из его сети, может отправить ответ непосредственно отправителю (например, 192.168.1.3), минуя сам шлюз. Отправитель же будет ждать ответа от 208.77.188.166, и просто проигнорирует ответ от 192.168.1.2. Впрочем, эта проблема легко исправляется добавлением SNAT’а для пробрасываемых пакетов:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A POSTROUTING -d 192.168.1.2 -s 192.168.1.0/24 -j SNAT --to-source 192.168.1.1
&lt;/syntaxhighlight&gt;
Теперь, с точки зрения 192.168.1.2, к нему будет обращаться только сам шлюз (192.168.1.1), поэтому ответ также пойдет через шлюз, где будет корректно оттранслирован. Такое решение тоже имеет недостаток — подмена исходного адреса пакета приводит к тому, что компьютер, на который мы пробрасываем соединение, не может определить реального инициатора соединения. Чтобы уменьшить «вредность» этого правила, в него добавлена опция «-s 192.168.1.0/24», которая ограничивает применение этого правила только пакетами из локальной сети. Таким образом, соединения из локальной сети будут выглядеть как соединения, инициированные шлюзом, а соединения из внешней сети будут иметь свои оригинальные адреса.

Вторым недостатком предложенного примера является некорректная обработка запросов с самого шлюза. Ведь пакеты, генерируемые локальными процессами, не проходят цепочку PREROUTING. Поэтому правило DNAT нужно также добавить и в цепочку OUTPUT таблицы nat:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A OUTPUT -d 208.77.188.166 -j DNAT --to-destination 192.168.1.2
&lt;/syntaxhighlight&gt;
Разумеется, исходящие соединения к 192.168.1.2 и ответы на них должны быть разрешены соответственно в цепочках OUTPUT и INPUT таблицы filter. Самый простой способ сделать это —
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -F INPUT # Очищаем цепочку INPUT
# Разрешаем входящие пакеты по уже установленным соединениям
iptables -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
iptables -P INPUT DROP # Все остальные входящие пакеты — запрещаем
iptables -F OUTPUT # Очищаем цепочку OUTPUT
iptables -P OUTPUT ACCEPT # Разрешаем исходящие пакеты безо всяких ограничений
&lt;/syntaxhighlight&gt;

Кроме того, при помощи действия DNAT можно пробрасывать не только сразу весь IP-адрес, но и отдельные {{w |TCP}}- или {{w |UDP}}-[[w:Порт (компьютерные сети)|порты]]. Например, если в предыдущем примере мы в каждое из правил
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A PREROUTING -d 208.77.188.166 -j DNAT --to-destination 192.168.1.2
iptables -t nat -A POSTROUTING -d 192.168.1.2 -s 192.168.1.0/24 -j SNAT --to-source 192.168.1.1
iptables -t nat -A OUTPUT -d 208.77.188.166 -j DNAT --to-destination 192.168.1.2
&lt;/syntaxhighlight&gt;
добавим
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
-p tcp --dport 80
&lt;/syntaxhighlight&gt;
то мы «пробросим» не сам адрес 208.77.188.166, а только его {{w |TCP}}-[[w:Порт (компьютерные сети)|порт]] 80 ({{w |HTTP}}). Обращения на все остальные {{w |TCP}}- и {{w |UDP}}-порты, а также {{w |ICMP}}-пакеты, поступившие на адрес 208.77.188.166, будут обрабатываться шлюзом, и лишь входящие TCP-соединения на порт 80 будут передаваться на 192.168.1.2.

Как и SNAT, DNAT поддерживает указание диапазонов адресов для подмены. Таким образом можно, например, балансировать нагрузку между несколькими серверами.

* '''REDIRECT''' — подменяет номер порта в TCP- или UDP-пакете, а также подменяет адрес назначения на свой собственный. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A PREROUTING -i eth1 -p tcp --dport 80 -j REDIRECT --to-port 8080
&lt;/syntaxhighlight&gt;
позволяет «завернуть» все исходящие из локальной сети TCP-соединения на порт 80, на TCP-порт 8080 шлюза. Если этот порт обслуживается специально настроенным {{w |прокси-сервер}}ом, то можно организовать «прозрачное проксирование» — клиенты из локальной сети даже не будут подозревать, что их запросы идут через прокси-сервер. Разумеется, входящие соединения из локалки на TCP-порт 8080 должны быть разрешены в таблице filter.

Другой полезный пример:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A PREROUTING -i eth0 -s 213.180.0.0/16 \
    -p tcp --dport 80 -j REDIRECT --to-port 8000
&lt;/syntaxhighlight&gt;
«заворачивает» все входящие из Интернета, а точнее подсети 213.180.0.0/255.255.0.0 TCP-соединения на порт 80, переадресуя их на порт 8000 того же сервера (где, например, может работать специальный веб-сервер). Как обычно, входящие соединения на TCP-порт 8000 должны быть разрешены в таблице filter.

* '''SAME''' — в зависимости от цепочки (PREROUTING или POSTROUTING) может работать как DNAT или SNAT. Однако, при указании (в параметре &lt;tt&gt;--to-ip&lt;/tt&gt;) одного или нескольких диапазонов IP-адресов, определяет для каждого нового соединения подставляемый адрес не случайно, а базируясь на IP-адресе клиента. Таким образом, адрес для подмены остается постоянным для одного и того же клиента при повторных соединениях (что ''не'' выполняется для обычных DNAT/SNAT). В некоторых случаях это бывает важным. Примечание: в соответствии с iptables-extensions’s man page действие SAME убрано и заменено на опцию --persistent для действий '''DNAT'''/'''SNAT'''.
* '''NETMAP''' — позволяет «пробросить» целую сеть. Например, для шлюза, стоящего между сетями 192.168.1.0/24 и 192.168.2.0/24 можно организовать следующий проброс:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A PREROUTING -s 192.168.1.0/24 -d 192.168.3.0/24 -j NETMAP --to 192.168.2.2/24
&lt;/syntaxhighlight&gt;
Теперь, при обращении, например, хоста 192.168.1.3 на IP-адрес 192.168.3.2 он будет попадать на 192.168.2.2 (при условии, что такой транзитный трафик разрешен на шлюзе в цепочке FORWARD таблицы filter, а также на хостах сети 192.168.1.0/24 наш шлюз [[w:Маршрутизация|прописан]] в качестве шлюза для подсети 192.168.3.0/24).

: ''Примечание: следующее действие планируется к переносу в еще не написанный раздел статьи (Устаревшие критерии и действия)''.
* '''MIRROR''' — довольно интересная игрушка. Меняет местами адрес источника и назначения и высылает пакет обратно. Создано исключительно для демонстрационных целей. Однако, может, например, применяться для защиты от сканирования портов — в результате атакующий сканирует свои собственные порты. Однако наличие двух встречных MIRROR’ов на двух хостах может повлечь бесконечное блуждание одних и тех же пакетов, забивающее канал. Поэтому применяйте это действие с осторожностью.

=== Таблица filter ===
Предназначена для фильтрации трафика, то есть разрешения и запрещения пакетов и соединений.

==== Цепочки ====
Таблица filter содержит следующие цепочки:
* '''INPUT''' — эта цепочка обрабатывает трафик, поступающий непосредственно самому хосту.
* '''FORWARD''' — позволяет фильтровать транзитный трафик.
* '''OUTPUT''' — эта цепочка позволяет фильтровать трафик, исходящий от самого хоста.

==== Действия ====
Допустимыми действиями в таблице filter являются:
* '''ACCEPT''' — пропуск пакета. Пакет покидает текущую базовую цепочку и следует дальше по потоковой диаграмме (см. рис.).
* '''REJECT''' — заблокировать пакет и сообщить его источнику об отказе. По умолчанию об отказе сообщается отправкой ответного {{w |ICMP}}-пакета «icmp-port-unreachable». Однако, это действие поддерживает опцию &lt;tt&gt;--reject-with&lt;/tt&gt;, позволяющую указать формулировку сообщения об отказе (возможные значения: &lt;tt&gt;icmp-net-unreachable&lt;/tt&gt;, &lt;tt&gt;icmp-host-unreachable&lt;/tt&gt;, &lt;tt&gt;icmp-proto-unreachable&lt;/tt&gt;, &lt;tt&gt;icmp-net-prohibited&lt;/tt&gt;, &lt;tt&gt;icmp-host-prohibited&lt;/tt&gt;). Для протокола {{w |TCP}} поддерживается отказ в форме отправки RST-пакета (&lt;tt&gt;--reject-with tcp-reset&lt;/tt&gt;).
* '''DROP''' — заблокировать пакет, не сообщая источнику об отказе. Более предпочтительна при фильтрации трафика на интерфейсах, подключенных к интернету, так как понижает информативность сканирования портов хоста злоумышленниками.

Также определенный интерес представляют действия, предоставляемые модулями [http://xtables-addons.sourceforge.net/ xtables-addons] (в настоящее время этот проект уже [http://packages.debian.org/squeeze/xtables-addons-common включен] в {{w |Debian}} testing). Некоторые из них:
* '''STEAL''' — аналогично DROP, но в случае использования в цепочке OUTPUT при блокировании исходящего пакета не сообщает об ошибке приложению, пытавшемуся отправить этот пакет.
* '''TARPIT''' — «подвесить» {{w |TCP}}-соединение. Используется лишь в самых крайних случаях, например, при борьбе с {{w |DoS-атака}}ми. Отвечает на входящее соединение, после чего уменьшает размер фрейма до нуля, блокируя возможность передачи данных. Соединение будет «висеть» в таком состоянии пока не истечет тайм-аут на атакующей стороне (обычно 20—30 минут). При этом на такое соединение расходуются системные ресурсы атакующей стороны (процессорное время и оперативная память), что может быть весьма ощутимо при значительном количестве соединений. В случае правильного использования действия TARPIT ресурсы атакуемой стороны практически не расходуются.
Под правильным применением понимается предотвращение обработки таких соединений подсистемой [[conntrack]], так как в противном случае будут расходоваться системные ресурсы самого атакуемого хоста. Например, перед добавлением правила блокирования порта
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p tcp --dport 25 -j TARPIT
&lt;/syntaxhighlight&gt;
обязательно добавляйте в таблицу raw соответствующее правило
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t raw -I PREROUTING -p tcp --dport 25 -j NOTRACK
&lt;/syntaxhighlight&gt;
предотвращающее обработку блокируемых соединений подсистемой conntrack.
* '''DELUDE''' — создать видимость открытого TCP-порта. На SYN-пакеты отвечает пакетами SYN/ACK, на все прочие пакеты отвечает RST. Очень полезно для введения в заблуждение злоумышленника, сканирующего порты вашего хоста.
* '''CHAOS''' — для каждого нового TCP-соединения случайно выбрать одно из двух действий. Первое из них — REJECT, второе, в зависимости от выбранной опции, либо TARPIT (&lt;tt&gt;--tarpit&lt;/tt&gt;), либо DELUDE (&lt;tt&gt;--delude&lt;/tt&gt;). В частности, при использовании действия &lt;tt&gt;CHAOS --delude&lt;/tt&gt; для всех неиспользуемых портов, сканирующий ваши порты злоумышленник получит совершенно неверную информацию о состоянии ваших портов. В случае с &lt;tt&gt;CHAOS --tarpit&lt;/tt&gt; ситуация усугубится еще и «подвисающими» соединениями.

Особо заметим, что все действия, перечисленные в качестве допустимых в таблице filter, можно применять в любой из цепочек любой из таблиц (конечно, с разумными ограничениями — например, не стоит ставить действия TARPIT, CHAOS и DELUDE для собственных исходящих пакетов). Однако эти действия предназначены именно для фильтрации, и применение их за пределами таблицы filter является дурным тоном. Как и, например, применение действий, специфичных для таблицы mangle, в таблицах filter и nat.

=== Таблица security ===
Предназначена для изменения маркировки безопасности (меток {{w |SELinux}}) пакетов и соединений.

==== Цепочки ====
Аналогичны цепочкам таблицы filter:
* '''INPUT''' — эта цепочка обрабатывает трафик, поступающий непосредственно самому хосту.
* '''FORWARD''' — через эту цепочку проходит транзитный трафик.
* '''OUTPUT''' — эта цепочка позволяет обрабатывать трафик, исходящий от самого хоста.

Так как эта таблица появилась относительно недавно, ее редко можно увидеть на схемах следования пакетов через цепочки и таблицы {{w |netfilter}}'а. Поэтому стоит отметить, что все цепочки таблицы security пакеты проходят непосредственно после одноименных цепочек таблицы filter.

==== Действия ====
Данная таблица добавлена в ядро [[w:Ядро Linux|Linux]] в версии 2.6.27. Ранее операции с метками безопасности выполнялись в таблице mangle, и в целях обратной совместимости все действия, разрешенные для таблицы security, можно использовать и в таблице mangle.

* '''SECMARK''' — устанавливает для пакета контекст безопасности {{w |SELinux}} (единственная допустимая опция &lt;tt&gt;--selctx&lt;/tt&gt;).
* '''CONNSECMARK''' — позволяет скопировать контекст безопасности SELinux с отдельного пакета на соединение в целом (опция &lt;tt&gt;--save&lt;/tt&gt;) и наоборот (опция &lt;tt&gt;--restore&lt;/tt&gt;).

=== Таблица raw ===
Предназначена для выполнения действий с пакетами до их обработки системой [[conntrack]].

Обратите внимание, что в данной таблице не будут срабатывать критерии, которым для корректной работы необходим conntrack (это критерии conntrack, connmark, connlimit, connbytes).

==== Цепочки ====
* '''PREROUTING''' — в эту цепочку входящие пакеты попадают раньше, чем в любую другую из цепочек iptables, и ''до'' обработки их системой conntrack.
* '''OUTPUT''' — аналогично для пакетов, сгенерированных самим хостом.

==== Действия ====
&lt;!-- В таблице raw целесообразно применять действие '''NOTRACK''', позволяющее предотвратить обработку пакетов системой conntrack. Разумеется, применять ее стоит не ко всем пакетам подряд, а только к тем, для которых такая обработка не нужна и даже вредна. Например, к пакетам, к которым впоследствии применяется действие TARPIT (см. выше). --&gt;
* '''NOTRACK''' — позволяет предотвратить обработку пакетов системой conntrack. Разумеется, применять его стоит не ко всем пакетам подряд, а только к тем, для которых такая обработка не нужна и даже вредна. Например, к пакетам, к которым впоследствии применяется действие TARPIT (см. выше).
* '''CT''' — более функциональный инструмент, добавленный в версии [[w:Ядро Linux|Linux]] 2.6.34. Позволяет задать различные настройки [[conntrack]], в соответствии с которыми будет обрабатываться соединение, открытое данным пакетом. В частности, можно:
:* Отключить отслеживание соединения (опция &lt;tt&gt;--notrack&lt;/tt&gt;). Таким образом, функциональность действия CT включает и функциональность NOTRACK, так что, возможно, действие NOTRACK будет объявлено устаревшим.
:* Задать вспомогательный модуль (conntrack helper) для данного соединения. Если раньше указать нестандартные порты для такого модуля можно было только в параметрах его загрузки (&lt;tt&gt;/etc/modprobe.conf&lt;/tt&gt; или &lt;tt&gt;/etc/modprobe.d/netfilter.conf&lt;/tt&gt;, например, &lt;tt&gt;options nf_conntrack_ftp ports=2121&lt;/tt&gt;), то теперь это можно сделать и через правила netfilter:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t raw -I PREROUTING -p tcp --dport 2121 -j CT --helper ftp
&lt;/syntaxhighlight&gt;
:* Ограничить список событий conntrack, которые будут генерироваться для данного соединения. Например, правило
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t raw -I PREROUTING -p tcp --dport 8000 -j CT --ctevents new,destroy
&lt;/syntaxhighlight&gt;
: будет предписывать для всех соединений на {{w |TCP}}-[[w:Порт (компьютерные сети)|порт]] 8000 генерировать только события «открытие соединения» (NEW) и «завершение соединения» (DESTROY), игнорируя все прочие события. Полный список возможных событий: new, related, destroy, reply, assured, protoinfo, helper, mark, natseqinfo, secmark.
:* Задать ''зону conntrack'' для данного пакета (параметр &lt;tt&gt;--zone&lt;/tt&gt;). Механизм зон conntrack позволяет корректно отслеживать, фильтровать и {{w |NAT}}'ить соединения даже в том случае, если хост подключен к нескольким сетям, использующим одинаковые пространства имен, через различные интерфейсы (например, интерфейсы eth0 и eth1 подключены к двум разным сетям, но обе эти сети используют пространство 192.168.0.0/24). Традиционно, для идентификации соединений conntrack использует кортежи (tuples) — набор значений в который входят адреса и порты (в случае ICMP — типы и коды ICMP) источника и назначения при передаче данных в прямом и обратном направлении. Очевидно, что при наличии нескольких подсетей с одинаковыми адресными пространствами, возможно возникновение путаницы, когда сразу нескольким соединениям ставится в соответствие одна и та же запись в таблице соединений. Чтобы избежать такой ситуации, в кортеж был добавлен идентификатор зоны conntrack — целое число, которое можно устанавливать через специальное правило в таблице raw в зависимости от входящего/исходящего интерфейса (как уже говорилось выше, цепочки таблицы raw пакеты проходят еще до обработки их conntrack’ом). Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t raw -I PREROUTING -i eth1 -j CT --zone 1
iptables -t raw -I OUTPUT -o eth1 -j CT --zone 1
&lt;/syntaxhighlight&gt;
: Таким образом, пакеты, входящие или исходящие через интерфейс eth1, будут получать идентификатор зоны 1, в то время как пакеты интерфейса eth0 будут по-прежнему использовать зону по умолчанию (идентификатор 0), и путаницы не произойдет.
: Кроме того, идентификатор зоны можно задать для каждого интерфейса через {{w |sysfs}}, минуя iptables (псевдофайл &lt;tt&gt;/sys/class/net/имя_интерфейса/nf_ct_zone&lt;/tt&gt;):
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
echo 1 &gt; /sys/class/net/eth1/nf_ct_zone
&lt;/syntaxhighlight&gt;
: Однако, стоит заметить, что iptables/netfilter позволяют реализовать более гибкую логику управления идентификатором зоны, опирающуюся на различные параметры пакетов, и поэтом данный параметр действия CT может быть полезен при решении различных сложных задач управления трафиком при использовании зон conntrack.
* '''RAWDNAT''' — позволяет выполнять [[w:NAT|«проброс»]] адресов и портов «сырым» методом — без использования системы conntrack, то есть без учета состояний соединений. Это действие реализовано в рамках проекта xtables-addons. Применять его можно только в таблице raw. Имеет единственную опцию &lt;tt&gt;--to-destination ''адрес''[/''маска'']&lt;/tt&gt;, по смыслу аналогичную опции &lt;tt&gt;--to&lt;/tt&gt; действия NETMAP, то есть при указании маски заменяются только те биты в адресе, которые соответствуют единичным битам маски. Биты адреса, соответствующие нулевым битам маски, остаются неизменными. При отсутствии маски изменяется весь адрес.

: Отметим, что в отличие от действий [[#Таблица nat|таблицы nat]], которые работают только с соединениями в целом, операции «сырого» преобразования адресов работают только с отдельными пакетами, никак не учитывая контекст их передачи. Вышесказанное можно проиллюстрировать, скажем, таким простым примером: для элементарной операции «проброса» внешнего адреса на другой адрес при использовании обычных операций NAT достаточно одного правила&lt;ref&gt;На самом деле, для «чистого» проброса адреса, даже при использовании stateful NAT, необходимо обычно два или три правила, в частности, для проброса соединений с самого сервера в цепочке OUTPUT. Более подробно это описано при рассмотрении операции DNAT [[#Таблица nat|таблицы nat]], и здесь, с целью упрощения понимания примера, эти аспекты опущены&lt;/ref&gt;
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A PREROUTING -i eth0 -d 212.201.100.135 -j  DNAT --to-destination 199.181.132.250
&lt;/syntaxhighlight&gt;
: в то время как для той же операции при использовании «сырых» преобразований необходимо минимум два правила
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t raw -A PREROUTING -i eth0 -d 212.201.100.135 -j  RAWDNAT --to-destination 199.181.132.250
iptables -t rawpost -A POSTROUTING -o eth0 -s 199.181.132.250 -j RAWSNAT --to-source 212.201.100.135
&lt;/syntaxhighlight&gt;
: Как уже говорилось выше, при использовании обычной операции DNAT в ответных пакетах, приходящих с пробрасываемого адреса (199.181.132.250), производится автоматическая (без необходимости писать для этого отдельные правила) подмена исходного адреса на изначальный (212.201.100.135), и обращающиеся по адресу 212.201.100.135 хосты даже не подозревают, что общаются с кем-то другим. В случае же «сырого» преобразования такая автоматическая обработка невозможна, так как она требует возможности проверять пакеты на принадлежность соединению. С другой стороны, операции «сырого» преобразования являются более гибким инструментом, а также могут работать даже с UNTRACKED и INVALID-пакетами.

=== Таблица rawpost ===
Данная таблица предназначена для выполнения операций «сырого» преобразования адресов (без использования информации о соединениях), которые не могут быть реализованы в рамках таблицы raw, а именно, для операции «сырой» подмены исходного адреса ({{w |маскарадинг}}а).

Как и в таблице raw, в rawpost отсутствует возможность обращения к [[conntrack]], поэтому критерии, использующие эту подсистему (conntrack, connmark, connlimit, connbytes), в этой таблице работать не будут.

Данная таблица реализована в рамках проекта xtables-addons и отсутствует в стандартном комплекте iptables/netfilter.

==== Цепочки ====
* '''POSTROUTING''' — обрабатывает весь исходящий трафик.

==== Действия ====
В таблице rawpost можно использовать действие '''RAWSNAT''', выполняющее операцию «сырой» подмены исходного адреса. Имеет единственную опцию &lt;tt&gt;--to-source ''адрес''[/''маска'']&lt;/tt&gt;, позволяющую задать новый исходный адрес для обрабатываемых пакетов. Как обычно, при наличии маски, в обрабатываемых адресах изменяются только те биты, которые в маске установлены в единицу, при отсутствии маски адрес изменяется целиком. Например, если по правилу
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t rawpost -A POSTROUTING -o eth0 -s 10.125.0.0/16 -d 172.18.1.100 -j RAWSNAT --to-source 192.168.0.20/16
&lt;/syntaxhighlight&gt;
будет обработан пакет с исходным адресом 10.125.32.28, то этот адрес будет заменен на 192.168.32.28.

Если же при задании правила маску /16 в параметре &lt;tt&gt;--to-source&lt;/tt&gt; опустить, адрес будет заменен на 192.168.0.20. Но так лучше не делать, потому что мы выполняем трансляцию для всех пакетов из подсети 10.125.0.0/16, и без отслеживания соединений не сможем отличить, какие пакеты следует вернуть 10.125.32.28, а какие — другим хостам из этой подсети. Сама же операция «возвращения» пакетов требует отдельного RAWDNAT-правила:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t raw -A PREROUTING -i eth0 -s 172.18.1.100 -d 192.168.0.0/16 -j RAWDNAT --to-destination 10.125.0.0/16
&lt;/syntaxhighlight&gt;
которое выполняет обратную подмену, заменяя адреса назначения в пакетах-ответах. Таким образом, хост 172.18.1.100 будет считать, что к нему обращаются хосты из подести 10.125.0.0/16, а вовсе не из 192.168.0.0/16.

Для сравнения, с использованием stateful-преобразования достаточно одного правила
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A POSTROUTING -o eth0 -s 10.125.0.0/16 -d 172.18.1.100 -j NETMAP --to 192.168.0.0/16
&lt;/syntaxhighlight&gt;
которое будет обеспечивать все необходимые преобразования адресов.

Заметим, что для корректной работы обеих описанных конфигураций требуется, чтобы хост 172.18.1.100, а также маршрутизаторы на пути от нашего хоста к нему, считали наш хост шлюзом для сети 192.168.0.0/16.

== Критерии ==
Напоминаем, критерий — это логическое выражение, определяющее, соответствует ли пакет или соединение данному конкретному правилу.

В одном правиле можно указать несколько критериев. Для того, чтобы пакет был обработан правилом, должны выполняться ''все'' критерии, то есть критерии неявно объединяются логическим AND.

Также многие критерии и параметры критериев можно инвертировать, поставив перед ними восклицательный знак. В описании синтаксиса таких критериев присутствует пометка «&lt;tt&gt;[!]&lt;/tt&gt;». Инверсия меняет смысл критерия или его параметра на ровно противоположный. Например, критерию &lt;tt&gt;-s 127.0.0.1&lt;/tt&gt; соответствуют все пакеты, имеющие обратный адрес 127.0.0.1, а критерию &lt;tt&gt;! -s 127.0.0.1&lt;/tt&gt; — все пакеты, ''кроме'' имеющих обратный адрес 127.0.0.1. В ранних версиях iptables восклицательный знак можно было ставить между названием критерия и значением, например, &lt;tt&gt;-s ! 127.0.0.1&lt;/tt&gt;, однако последние версии iptables (в частности, 1.4.3.2 и выше), уже не поддерживают этот синтаксис, выдавая следующую ошибку:
 Using intrapositioned negation (`--option ! this`) is deprecated in favor of extrapositioned (`! --option this`).

Далее мы кратко рассмотрим наиболее важные и интересные критерии.

=== Универсальные критерии ===
Под этим термином понимаются критерии, применимые ко все пакетам и соединениям, независимо от протокола транспортного уровня, и не требующие подключения внешних модулей (&lt;tt&gt;-m&lt;/tt&gt;).

* &lt;tt&gt;[!] '''-p'''&lt;/tt&gt;, &lt;tt&gt;--protocol ''протокол''&lt;/tt&gt;

Позволяет указать протокол транспортного уровня. Наиболее часто употребляются &lt;tt&gt;[[tcp]]&lt;/tt&gt;, &lt;tt&gt;[[udp]]&lt;/tt&gt;, &lt;tt&gt;[[icmp]]&lt;/tt&gt; и &lt;tt&gt;all&lt;/tt&gt;. Протокол также можно указать с помощью номера или названия согласно перечню, приведенному в &lt;tt&gt;/etc/protocols&lt;/tt&gt;. Значение «любой протокол» можно указать с помощью слова &lt;tt&gt;all&lt;/tt&gt; или числа 0. Если протокол не указан, подразумевается «любой протокол».

При указании протокола становится возможным использовать специфичные для него критерии. Например, для {{w |TCP}} и {{w |UDP}} доступны критерии &lt;tt&gt;--sport&lt;/tt&gt; и &lt;tt&gt;--dport&lt;/tt&gt;, для {{w |ICMP}} — &lt;tt&gt;--icmp-type&lt;/tt&gt;. Подробнее эти критерии будут рассмотрены ниже.

* &lt;tt&gt;[!] '''-s'''&lt;/tt&gt;, &lt;tt&gt;--src&lt;/tt&gt;, &lt;tt&gt;--source ''адрес''[/''маска''][,''адрес''[/''маска'']...]&lt;/tt&gt;

Определяет адрес отправителя. В качестве адреса может выступать {{w |IP-адрес}} (возможно с [[w:Маска подсети|маской]]), имя хоста из /etc/hosts, или {{w |доменное имя}} (в последних двух случаях перед добавлением правила в цепочку имя [[w:DNS|резольвится]] в IP-адрес). Маска подсети может быть указана в классическом формате (например, 255.255.0.0) либо в формате {{w |CIDR}} (например, 16)&lt;ref&gt;Заметим, что для расчета масок подсетей и диапазонов адресов существует очень удобная утилита [[ipcalc]].&lt;/ref&gt;. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -i eth0 -s 192.168.0.0/16 -j DROP
&lt;/syntaxhighlight&gt;
(где eth0 — интерфейс, подключенный к интернету), позволяет заблокировать простейший вид {{w |спуфинг}}а — из интернета ''не могут'' приходить пакеты с обратным адресом, принадлежащим к диапазону, зарезервированному для локальных сетей.

Начиная с версии iptables 1.4.6, в одном параметре &lt;tt&gt;-s&lt;/tt&gt; можно указывать более одного адреса, разделяя адреса запятой. При этом для каждого адреса будет добавлено ''отдельное'' правило. Например, запись
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -i eth0 -s 192.168.0.0/16,172.16.0.0/12,10.0.0.0/8 -j DROP
&lt;/syntaxhighlight&gt;
эквивалентна записи
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -i eth0 -s 192.168.0.0/16 -j DROP
iptables -A INPUT -i eth0 -s 172.16.0.0/12 -j DROP
iptables -A INPUT -i eth0 -s 10.0.0.0/8 -j DROP
&lt;/syntaxhighlight&gt;
При добавлении через команду &lt;tt&gt;-A&lt;/tt&gt; (вставка в конец цепочки) порядок добавляемых правил будет соответствовать порядку перечисления адресов в исходной команде, при использовании команды &lt;tt&gt;-I&lt;/tt&gt; (вставка в начало цепочки либо после заданного правила) порядок будет обратным исходному.

Настойчиво не рекомендуется использовать доменные имена, для разрешения (резольва) которых требуются {{w |DNS}}-запросы, так как на этапе конфигурирования фаервола DNS может работать некорректно. Также, заметим, имена резольвятся всего один раз — при добавлении правила в цепочку. Впоследствии соответствующий этому имени IP-адрес может измениться, но на уже записанные правила это никак не повлияет (в них останется старый адрес). Если указать доменное имя, которое резольвится в несколько {{w |IP-адрес}}ов, то для каждого адреса будет добавлено отдельное правило (как и в случае перечисления нескольких адресов, см. выше).

* &lt;tt&gt;[!] '''-d'''&lt;/tt&gt;, &lt;tt&gt;--dst&lt;/tt&gt;, &lt;tt&gt;--destination ''адрес''[/''маска''][,''адрес''[/''маска'']...]&lt;/tt&gt;

Определяет адрес получателя. Синтаксис аналогичен &lt;tt&gt;-s&lt;/tt&gt;.

Заметим, что, если использовать возможность указания нескольких адресов (перечислив их явно или указав доменное имя, резольвящееся на несколько адресов) ''одновременно'' в параметрах &lt;tt&gt;-s&lt;/tt&gt; и &lt;tt&gt;-d&lt;/tt&gt;, то на каждое возможное сочетание адресов будет добавлено свое правило. Например, запись
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A FORWARD -s 192.168.1.1,192.168.1.2 -d 192.168.1.3,192.168.1.4 -j REJECT
&lt;/syntaxhighlight&gt;
эквивалентна
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A FORWARD -s 192.168.1.1 -d 192.168.1.3 -j REJECT
iptables -A FORWARD -s 192.168.1.1 -d 192.168.1.4 -j REJECT
iptables -A FORWARD -s 192.168.1.2 -d 192.168.1.3 -j REJECT
iptables -A FORWARD -s 192.168.1.2 -d 192.168.1.4 -j REJECT
&lt;/syntaxhighlight&gt;

* &lt;tt&gt;[!] '''-i'''&lt;/tt&gt;, &lt;tt&gt;--in-interface ''имя_интерфейса''&lt;/tt&gt;

Определяет входящий сетевой интерфейс. Если указанное имя интерфейса заканчивается знаком «+» (например, &lt;tt&gt;tun+&lt;/tt&gt;), то критерию соответствуют все интерфейсы, чьи названия начинаются на указанное имя (для нашего примера tun0, tun1, …). Данный критерий можно использовать в цепочках PREROUTING, INPUT и FORWARD. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -i lo -j ACCEPT
&lt;/syntaxhighlight&gt;
позволит принимать весь трафик, входящий через интерфейс [[w:Loopback|обратной петли]].

* &lt;tt&gt;[!] '''-o'''&lt;/tt&gt;, &lt;tt&gt;--out-interface ''имя_интерфейса''&lt;/tt&gt;

Определяет исходящий сетевой интерфейс. Синтаксис аналогичен &lt;tt&gt;-i&lt;/tt&gt;. Критерий можно использовать в цепочках FORWARD, OUTPUT и POSTROUTING. Вспоминая один из наших примеров,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -I POSTROUTING -o eth0 -j MASQUERADE
&lt;/syntaxhighlight&gt;
будет [[w:Маскарадинг|маскарадить]] весь трафик, исходящий через интерфейс eth0.

=== Критерии, специфичные для протоколов ===

==== Протоколы [[w:Транспортный уровень|транспортного уровня]] ====

===== {{w |TCP}} =====
* &lt;tt&gt;[!] '''--sport'''&lt;/tt&gt;, &lt;tt&gt;--source-port ''порт''[:''порт'']&lt;/tt&gt;

Позволяет указать исходящий порт (или их диапазон). Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -m conntrack --ctstate NEW -p tcp --sport 0:1023 -j DROP
&lt;/syntaxhighlight&gt;
заблокирует все исходящие соединения с [[w:Список портов TCP и UDP|привилегированных]] портов (''привилегированными'' в TCP/UDP считаются порты с 0 по 1023 включительно, так как для их использования нужны привилегии [[w:Root|суперпользователя]], и обычно такие порты используются [[w:Демон (программа)|демонами]] только в режиме прослушивания).

* &lt;tt&gt;[!] '''--dport'''&lt;/tt&gt;, &lt;tt&gt;--destination-port ''порт''[:''порт'']&lt;/tt&gt;

Позволяет указать порт назначения (или их диапазон). Синтаксис аналогичен &lt;tt&gt;--sport&lt;/tt&gt;. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p tcp --dport 80 -j ACCEPT
&lt;/syntaxhighlight&gt;
разрешит все входящие пакеты на 80 порт ({{w |HTTP}}).

* &lt;tt&gt;[!] '''--tcp-flags''' ''маска'' ''установленные_флаги''&lt;/tt&gt;

Позволяет указать список установленных и снятых [[w:TCP#Флаги (управляющие биты)|TCP-флагов]]. В ''маске'' перечисляются (через запятую, без пробелов) все проверяемые флаги, далее, после пробела, перечисляются (также через запятую) те из них, которые должны быть установлены. Все остальные перечисленные в маске флаги должны быть сняты. Возможные флаги: SYN ACK FIN RST URG PSH. Также можно использовать псевдофлаги ALL и NONE, обозначающие «все флаги» и «ни одного флага» соответственно.

Пример:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p tcp --tcp-flags SYN,RST,ACK,FIN SYN -j LOG --log-level DEBUG --log-prefix &quot;TCP SYN: &quot;
&lt;/syntaxhighlight&gt;
будет заносить в лог все входящие TCP SYN-пакеты. У обычного SYN-пакета всегда установлен флаг SYN и сняты флаги RST, ACK и FIN.

Другой пример:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -m conntrack --ctstate NEW,INVALID -p tcp --tcp-flags SYN,ACK SYN,ACK -j REJECT --reject-with tcp-reset
&lt;/syntaxhighlight&gt;
будет препятствовать {{w |спуфинг}}у от нашего имени. Ведь если мы получаем пакет с установленными флагами SYN и ACK (такой комбинацией флагов обладает только ответ на SYN-пакет) по еще не открытому соединению, это означает, что кто-то послал другому хосту SYN-пакет от нашего имени, и ответ пришел к нам. Однако добавление такого правила в конфигурацию фаервола ''не рекомендуется'', поскольку стандартом также предусмотрено использование случайного начального номера последовательности для каждого нового TCP-соединения, как раз для предотвращения возможности спуфинг-атаки. Шансов угадать начальный номер у злоумышленника практически нет, тогда как наш ответ RST-пакетом на такой пакет может серьезно нарушить работоспособность некоторых систем защиты от DoS-атак, полагающихся на метод, называемый out-of-sequence ACK. В случае добавления этого правила в конфигурацию фаервола, системы защиты будут считать, что, раз уж мы отвечаем RST на out-of-sequence ACK, вы действительно пытались установить соединение с ресурсом, и пропустят все последующие поддельные пакеты злоумышленника, отправленные от вашего имени. В результате вы заметно облегчите злоумышленнику осуществление DoS-атаки от вашего имени, и при расследовании этого эпизода следы приведут к вам.

* &lt;tt&gt;[!] '''--syn'''&lt;/tt&gt;

Позволяет отлавливать TCP SYN-пакеты (сокращение для &lt;tt&gt;--tcp-flags SYN,RST,ACK,FIN SYN&lt;/tt&gt;). Так что приведенный выше пример про логгирование SYN-пакетов можно записать в виде
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p tcp --syn -j LOG --log-level DEBUG --log-prefix &quot;TCP SYN: &quot;
&lt;/syntaxhighlight&gt;

Более интересный пример:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -m conntrack --ctstate NEW -p tcp ! --syn -j DROP
&lt;/syntaxhighlight&gt;
будет блокировать все попытки открыть входящее TCP-соединение ''не'' SYN-пакетом. Попытка установить соединение таким образом может быть либо ошибкой, либо атакой.

* &lt;tt&gt;[!] '''--tcp-option''' ''номер''&lt;/tt&gt;

Позволяет проверить, установлена ли в заголовке TCP-пакета соответствующая опция. Полный список опций с их номерами представлен [http://www.iana.org/assignments/tcp-parameters/tcp-parameters.xhtml на сайте IANA].

===== {{w |UDP}} =====
* &lt;tt&gt;[!] '''--sport'''&lt;/tt&gt;, &lt;tt&gt;--source-port ''порт''[:''порт'']&lt;/tt&gt;

Позволяет указать исходящий порт (или их диапазон). Синтаксис и принцип работы аналогичен описанной выше одноименной опции TCP.

* &lt;tt&gt;[!] '''--dport'''&lt;/tt&gt;, &lt;tt&gt;--destination-port ''порт''[:''порт'']&lt;/tt&gt;

Позволяет указать входящий порт (или их диапазон). Синтаксис и принцип работы аналогичен описанной выше одноименной опции TCP.

===== {{w |SCTP}} =====
* &lt;tt&gt;[!] '''--sport'''&lt;/tt&gt;, &lt;tt&gt;--source-port ''порт''[:''порт'']&lt;/tt&gt;

Позволяет указать исходящий порт (или их диапазон). Синтаксис и принцип работы аналогичен описанной выше одноименной опции TCP.

* &lt;tt&gt;[!] '''--dport'''&lt;/tt&gt;, &lt;tt&gt;--destination-port ''порт''[:''порт'']&lt;/tt&gt;

Позволяет указать входящий порт (или их диапазон). Синтаксис и принцип работы аналогичен описанной выше одноименной опции TCP.

* &lt;tt&gt;[!] '''--chunk-types''' {all|any|only} ''тип_секции''[:''флаги''][,''тип_секции''[:''флаги'']...]&lt;/tt&gt;

Позволяет анализировать набор [[:en:SCTP packet structure|секций (chunks)]], входящих в состав SCTP-пакета. Возможные типы секций: DATA INIT INIT_ACK SACK HEARTBEAT HEARTBEAT_ACK ABORT SHUTDOWN SHUTDOWN_ACK ERROR COOKIE_ECHO COOKIE_ACK ECN_ECNE ECN_CWR SHUTDOWN_COMPLETE ASCONF ASCONF_ACK. Также, для секций, имеющих флаги (DATA, ABORT и SHUTDOWN_COMPLETE) можно проверить состояние флагов, указав соответствующие буквы после названия секции (для DATA — U, B и E, для ABORT и SHUTDOWN_COMPLETE — T). Литера в верхнем регистре предполагает установленный флаг, в нижнем — снятый. Ключевое слово в начале позволяет определить логику работы: в случае &lt;tt&gt;all&lt;/tt&gt; должны присутствовать ''все'' перечисленные секции, для &lt;tt&gt;any&lt;/tt&gt; — хотя бы одна из них, для &lt;tt&gt;only&lt;/tt&gt; — пакет должен состоять только из перечисленных секций. Примеры:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p sctp --chunk-types only DATA,INIT -j DROP
&lt;/syntaxhighlight&gt;
заблокирует все входящие SCTP-пакеты, состоящие только из секций DATA и INIT, а
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p sctp --chunk-types any DATA:Be -j ACCEPT
&lt;/syntaxhighlight&gt;
разрешит входящие SCTP-пакеты, содержащие секцию DATA с установленным флагом B и снятым флагом E, то есть первый фрагмент фрагментированной DATA-секции.

===== {{w |DCCP}} =====
* &lt;tt&gt;[!] '''--sport'''&lt;/tt&gt;, &lt;tt&gt;--source-port ''порт''[:''порт'']&lt;/tt&gt;

Позволяет указать исходящий порт (или их диапазон). Синтаксис и принцип работы аналогичен описанной выше одноименной опции TCP.

* &lt;tt&gt;[!] '''--dport'''&lt;/tt&gt;, &lt;tt&gt;--destination-port ''порт''[:''порт'']&lt;/tt&gt;

Позволяет указать входящий порт (или их диапазон). Синтаксис и принцип работы аналогичен описанной выше одноименной опции TCP.

* &lt;tt&gt;[!] '''--dccp-types''' ''маска''&lt;/tt&gt;

Позволяет указать тип DCCP-пакета. В ''маске'' через запятую перечисляются DCCP-типы (допустимые названия: REQUEST RESPONSE DATA ACK DATAACK CLOSEREQ CLOSE RESET SYNC SYNCACK INVALID). Пакет считается удовлетворяющим критерию, если имеет один из типов, перечисленных в маске. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p dccp --dccp-types RESET,INVALID -j LOG --log-level DEBUG --log-prefix &quot;DCCP RESET or INVALID: &quot;
&lt;/syntaxhighlight&gt;
занесет в лог все входящие RESET и INVALID DCCP-пакеты.

===== {{w |UDP Lite}} =====
Поддержка специфических опций протокола UDPLite (а именно, проверки портов источника и/или назначения) в netfilter реализована не вполне очевидным образом: через критерий multiport (см. раздел [[#Вспомогательные критерии|вспомогательные критерии]]).

Если для обычного {{w |UDP}} соответствие номера порта проверялось выражением вида &lt;tt&gt;-p udp --dport ''номер_порта''&lt;/tt&gt; (или &lt;tt&gt;-p udp --sport ''номер_порта''&lt;/tt&gt;), то в случае UDPLite аналогичное выражение будет выглядеть как &lt;tt&gt;-p udplite -m multiport --dports ''номер_порта''&lt;/tt&gt; (или &lt;tt&gt;-p udplite -m multiport --sports ''номер_порта''&lt;/tt&gt;). Все опции критерия multiport для UDPLite поддерживаются в полном объеме.

==== {{w |IPv4}} ====
Ниже перечислены критерии, которые реализованы только для протокола IPv4 и, соответственно, могут быть вызваны только через iptables, но не через ip6tables.

* &lt;tt&gt;[!] '''-f'''&lt;/tt&gt;, &lt;tt&gt;--fragment&lt;/tt&gt;

Проверка фрагментации: критерию соответствуют только фрагменты пакета, начиная со второго фрагмента. Пример:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p icmp -f -j DROP
&lt;/syntaxhighlight&gt;
блокирует фрагменты {{w |ICMP}}-пакетов. Так как, в силу функционального назначения протокола, ICMP-пакеты должны быть очень небольшими и нормально укладываться в {{w |MTU}}, наличие их фрагментов обычно свидетельствует об ошибке или попытке атаки.

У второго и последующего фрагментов нет заголовка транспортного уровня, поэтому бессмысленно пытаться использовать для них критерии номеров [[w:Порт (компьютерные сети)|TCP/UDP-портов]] или типа ICMP.

* '''addrtype''' — позволяет проверить тип адреса источника и/или назначения с точки зрения подсистемы маршрутизации сетевого стека ядра. Допустимые типы адресов: UNSPEC (адрес 0.0.0.0), [[w:Unicast|UNICAST]], LOCAL (адрес принадлежит нашему хосту), [[w:Broadcast|BROADCAST]], [[w:Anycast|ANYCAST]], [[w:Мультивещание|MULTICAST]], [[:en:Black hole (networking)|BLACKHOLE]], UNREACHABLE, PROHIBIT, THROW, NAT, XRESOLVE. Подробнее о большинстве перечисленных типов адресов и их использовании в [[w:Ядро Linux|Linux]] (точнее, в подсистеме {{w |iproute2}}) можно почитать [http://linux-ip.net/html/routing-tables.html здесь]. Данный критерий поддерживает следующие параметры:

&lt;tt&gt;[!] --src-type ''тип''[,''тип''...]&lt;/tt&gt; — проверка, принадлежит ли исходный адрес пакета одному из перечисленных типов.

&lt;tt&gt;[!] --dst-type ''тип''[,''тип''...]&lt;/tt&gt; — проверка, принадлежит ли адрес назначения пакета одному из перечисленных типов.

&lt;tt&gt;--limit-iface-in&lt;/tt&gt; — ограничивает проверку типа адреса только записями для интерфейса, через который пакет вошел на хост. Допускается использовать этот параметр только в цепочках PREROUTING, INPUT и FORWARD.

&lt;tt&gt;--limit-iface-out&lt;/tt&gt; — ограничивает проверку типа адреса только записями для интерфейса, через который пакет вышел с хоста. Допускается использовать этот параметр только в цепочках POSTROUTING, OUTPUT и FORWARD.

Критерии &lt;tt&gt;--limit-iface-in&lt;/tt&gt; и &lt;tt&gt;--limit-iface-out&lt;/tt&gt; нельзя указывать одновременно.

В качестве практического примера использования данного критерия можно привести простейшую защиту от {{w |спуфинг}}а:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -m addrtype --src-type LOCAL ! -i lo -j DROP
&lt;/syntaxhighlight&gt;
Это правило заблокирует пакеты, которые пришли с внешних интерфейсов, но при этом в качестве обратного адреса у них указан один из адресов, принадлежащих нашему хосту (например, {{w |127.0.0.1}}).

* '''ecn''' — позволяет проверять значения битов [[w:Explicit Congestion Notification|ECN]] в заголовках {{w |TCP}} и {{w |IPv4}}. Допустимые параметры:

&lt;tt&gt;[!] --ecn-tcp-cwr&lt;/tt&gt; — проверка флага ECN CWR (Congestion Window Received) в TCP-заголовке пакета.

&lt;tt&gt;[!] --ecn-tcp-ece&lt;/tt&gt; — проверка флага ECN ECE (ECN Echo) в TCP-заголовке пакета.

&lt;tt&gt;[!] --ecn-ip-ect ''значение''&lt;/tt&gt; — проверка значения, сформированного ECN-битами поля [[w:Тип обслуживания|TOS]] (последние два бита). Возможные значения от 0 до 3.

* '''realm''' — проверка области маршрутизации (realm) пакета. Имеет единственный параметр

&lt;tt&gt;[!] --realm ''значение''[/''маска'']&lt;/tt&gt;, позволяющий указать численный идентификатор области. Если указана маска, то значение realm каждого проверяемого пакета сначала объединяется с маской при помощи [[w:Битовые операции#Побитовое И (AND)|побитового AND]], а затем сравнивается со значением, указанным в правиле. Также вместо числа можно указать символьное название области согласно обозначениям в файле &lt;tt&gt;/etc/iproute2/rt_realms&lt;/tt&gt; (в этом случае маску использовать нельзя).

* '''ttl''' — обеспечивает проверку поля [[w:Time to live|TTL]] в заголовке пакета. Позволяет установить, является ли значение TTL проверяемого пакета большим (&lt;tt&gt;--ttl-gt&lt;/tt&gt;), меньшим (&lt;tt&gt;--ttl-lt&lt;/tt&gt;), равным или не равным (&lt;tt&gt;[!] --ttl-eq&lt;/tt&gt;) указанному значению.

===== {{w |ICMP}} =====
ICMP является протоколом контрольных сообщений IPv4. Несмотря на то, что ICMP формально является самостоятельным протоколом, и обращение к соответствующему критерию должно производиться с использованием синтаксиса для протокола (&lt;tt&gt;-p&lt;/tt&gt;), а не для вспомогательного критерия (&lt;tt&gt;-m&lt;/tt&gt;), де-факто этот протокол неотделим от IPv4, и поэтому соответствующий критерий может использоваться только в iptables, но не в ip6tables.

Критерий этого протокола имеет единственный параметр

&lt;tt&gt;[!] '''--icmp-type''' ''тип''&lt;/tt&gt; — обеспечивает проверку [[w:ICMP#Типы ICMP пакетов (полный список)|типа]] ICMP-пакета. Список возможных типов выводится по команде &lt;tt&gt;iptables -p icmp -h&lt;/tt&gt;. Также можно указать стандартные числовые тип и, при
необходимости, код. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p icmp --icmp-type echo-request -j ACCEPT
&lt;/syntaxhighlight&gt;
как и аналогичное
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p icmp --icmp-type 8 -j ACCEPT
&lt;/syntaxhighlight&gt;
пропустят все входящие ICMP-эхо-запросы (пинги).

==== {{w |IPv6}} ====
Ниже перечислены критерии, которые реализованы только для протокола IPv6 и, соответственно, могут быть вызваны только через ip6tables, но не через iptables.

Особо отметим, что критерии для некоторых подзаголовков IPv6 (dst, frag, hbh, rt) корректно вызываются ''только'' с использованием синтаксиса для расширенных критериев (ключ &lt;tt&gt;-m&lt;/tt&gt;), хотя имеют номера протоколов в &lt;tt&gt;/etc/protocols&lt;/tt&gt; и, формально, могут быть вызваны с использованием синтаксиса для протоколов (ключ &lt;tt&gt;-p&lt;/tt&gt;) что, однако, является неверным. В таких случаях ip6tables выдает предупреждение вида
&lt;syntaxhighlight lang=&quot;text&quot;&gt;
Warning: never matched protocol: ipv6-frag. use extension match instead.
&lt;/syntaxhighlight&gt;
гласящее, что в такое правило никогда не будет срабатывать. Если вы видите подобное предупреждение, удалите правило, которое его вызвало, и перепишите это правило с использованием корректного синтаксиса (&lt;tt&gt;-m&lt;/tt&gt;).

С другими же критериями, которые представляют более или менее самостоятельные протоколы ({{w |ICMPv6}}, [[MH]], {{w |IPSec}} [[:en:IPSec#Authentication Header|AH]] и [[:en:IPSec#Encapsulating Security Payload|ESP]]), все ровно наоборот, и для них корректным будет использование именно синтаксиса протокола (ключ &lt;tt&gt;-p&lt;/tt&gt;), а не расширенного критерия. Во избежание путаницы, такие критерии вынесены в отдельные подзаголовки, по аналогии с протоколами транспортного уровня (выше).

* '''dst''' — проверят опции назначения (подзаголовок 60 Destination Options). Имеет две опции:

&lt;tt&gt;[!] --dst-len ''значение''&lt;/tt&gt; — проверяет длину подзаголовка;

&lt;tt&gt;[!] --dst-opts ''код''[:''длина''][,''код''[:''длина'']...]&lt;/tt&gt; — позволяет проверить вхождение в данный подзаголовок конкретных опций. Также можно проверить длину каждой из них. Можно указать до 16 опций (представленных числовыми кодами), разделяя их запятой.

* '''eui64''' — сравнивает младшие 64 бита исходного IPv6-адреса с битами исходного {{w |MAC-адрес}}а, преобразованными согласно правилам автоконфигурирования IPv6-адресов на основании MAC-адресов. Таким образом, позволяет проверить, является ли IPv6-адрес отправителя пакета автоматически сконфигурированным (работает, если отправитель находится в одном [[w:Широковещательный домен|широковещательном домене]] с нашим хостом, так как в противном случае сохранность MAC-адреса отправителя не может быть гарантирована).
* '''frag''' — позволяет проверять параметры фрагментации (подзаголовок 44 Fragment). Допустимые опции:

&lt;tt&gt;[!] --fragid ''мин''[:''макс'']&lt;/tt&gt; — сверяет величину идентификатора фрагмента. Если указано одно значение, проверяется равенство, если указан диапазон — проверяется вхождение значения в этот диапазон (включая границы).

&lt;tt&gt;--fragres&lt;/tt&gt; — проверяет, заполнены ли нулями зарезервированные поля заголовка (биты 29-30).

&lt;tt&gt;--fragfirst&lt;/tt&gt; — проверяет, является ли данный фрагмент первым в последовательности.

&lt;tt&gt;--fraglast&lt;/tt&gt;/&lt;tt&gt;--fragmore&lt;/tt&gt; — проверяют M-флаг, показывающий, является ли данный фрагмент последним в последовательности (в этом случае &lt;tt&gt;--fraglast&lt;/tt&gt; дает истину, а &lt;tt&gt;--fragmore&lt;/tt&gt; ложь), или после него должны быть еще фрагменты (соответственно, наоборот). Эти две опции являются взаимоисключающими.

Также в документации можно найти упоминание параметра &lt;tt&gt;--fraglen &lt;/tt&gt;, который якобы проверяет длину подзаголовка Fragment. Однако, согласно текущим соглашениям, длина этого подзаголовка фиксирована и равна 8 {{w |байт}}ам, а названная опция ни на что не влияет.

* '''hbh''' — проверяет опции Hop-by-Hop (подзаголовок 0 Hop-by-Hop). Синтаксис аналогичен параметру dst.
* '''hl''' — обеспечивает проверку поля Hop Limit в IPv6-заголовке. Позволяет установить, является ли значение HL проверяемого пакета большим (&lt;tt&gt;--hl-gt&lt;/tt&gt;), меньшим (&lt;tt&gt;--hl-lt&lt;/tt&gt;), равным или не равным (&lt;tt&gt;[!] --hl-eq&lt;/tt&gt;) указанному значению.
* '''ipv6header''' — позволяет проверить наличие вспомогательных подзаголовков IPv6. Допустимыми типами заголовков являются: hop (hop-by-hop 0), dst (ipv6-opts 60), route (ipv6-route 43), frag (ipv6-frag 44), auth (ah 50), esp (esp 59). В скобках указаны «длинные» названия и числовые идентификаторы протокола. Используя опцию

&lt;tt&gt;[!] --header ''тип''[,''тип''...]&lt;/tt&gt;

вы можете указывать любые из этих обозначений — короткие названия, длинные названия или числовые идентификаторы. Отметим, что пакет будет соответствовать критерию в том случае, если будет содержать ''только'' перечисленные подзаголовки. Изменить это поведение можно, указав опцию &lt;tt&gt;--soft&lt;/tt&gt; — в этом случае достаточно, чтобы пакет содержал хотя бы один из перечисленных подзаголовков.

* '''rt''' — позволяет проверять параметры маршрутизации пакета (подзаголовок 43 Routing). Допустимые параметры:

&lt;tt&gt;[!] --rt-type ''тип''&lt;/tt&gt; — тип маршрутизации (0, 1 или 2);

&lt;tt&gt;[!] --rt-segsleft ''мин''[:''макс'']&lt;/tt&gt; — проверка значения поля Segment Left (показывает, сколько еще узлов должен пройти данный пакет, прежде чем достигнет цели);

&lt;tt&gt;[!] --rt-len ''значение''&lt;/tt&gt; — проверка длины всего подзаголовка.

Следующие три параметра работают для типа 0 (&lt;tt&gt;--rt-type 0&lt;/tt&gt;):

&lt;tt&gt;--rt-0-res&lt;/tt&gt; — проверять зарезервированные поля;

&lt;tt&gt;--rt-0-addrs ''адрес''[,''адрес''...]&lt;/tt&gt; — проверяет адреса, перечисленные в подзаголовке. Можно указать не более 16 адресов, разделяя их запятыми. Пакет считается удовлетворяющим критерию, если подзаголовок содержит все адреса, которые были перечислены в правиле, в том же порядке;

&lt;tt&gt;--rt-0-not-strict&lt;/tt&gt; — делает условие проверки по предыдущем параметру не таким жестким: достаточно, чтобы хотя бы один из перечисленных адресов совпадал с соответствующим адресом в подзаголовке, при соблюдении порядка перечисления.

===== {{w |ICMPv6}} =====
ICMPv6 является протоколом контрольных сообщений IPv6. Несмотря на то, что ICMPv6 формально является самостоятельным протоколом, и обращение к соответствующему критерию должно производиться с использованием синтаксиса для протокола (&lt;tt&gt;-p&lt;/tt&gt;), а не для вспомогательного критерия (&lt;tt&gt;-m&lt;/tt&gt;), де-факто этот протокол неотделим от IPv6, и поэтому соответствующий критерий может использоваться только в ip6tables, но не в iptables.

Критерий этого протокола имеет единственный параметр

&lt;tt&gt;[!] '''--icmpv6-type''' ''тип''&lt;/tt&gt;

по смыслу и синтаксису аналогичный параметру &lt;tt&gt;--icmp-type&lt;/tt&gt; критерия icmp (см. предыдущий раздел). Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
ip6tables -I INPUT -p icmpv6 --icmpv6-type echo-request -j ACCEPT
&lt;/syntaxhighlight&gt;
как и аналогичное
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
ip6tables -I INPUT -p icmpv6 --icmpv6-type 128 -j ACCEPT
&lt;/syntaxhighlight&gt;
пропустит входящие ICMPv6-эхо-запросы (пинги).

Как и в случае icmp, вы можете получить список допустимых типов сообщений, введя
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
ip6tables -p icmpv6 -h
&lt;/syntaxhighlight&gt;

===== [[MH]] =====
Критерий mh позволяет определять пакеты с подзаголовком IPv6 Mobility Header ({{RFC|3775}}). Как и в случае с ICMPv6, вызов данного критерия должен выполняться в соответствии с синтаксисом для протокола (через ключ &lt;tt&gt;-p&lt;/tt&gt;). Имеет единственную опцию

&lt;tt&gt;[!] '''--mh-type''' ''мин''[:''макс'']&lt;/tt&gt;

позволяющую указать точное значение типа или диапазон допустимых значений. Перечень поддерживаемых типов MH можно получить, введя команду
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
ip6tables -p mh -h
&lt;/syntaxhighlight&gt;

Также к данному критерию допустимо обращение по названию ipv6-mh (&lt;tt&gt;-p ipv6-mh&lt;/tt&gt;).

==== {{w |IPsec}} ====
netfilter «знает» два протокола из семейства IPsec: [[:en:IPSec#Authentication Header|Authentication Header]] (&lt;tt&gt;-p ah&lt;/tt&gt;) и [[:en:IPSec#Encapsulating Security Payload|Encapsulating Security Payload]] (&lt;tt&gt;-p esp&lt;/tt&gt;).

===== AH =====
Для протокола AH поддерживается единственная опция
* &lt;tt&gt;'''--ahspi''' ''значение''[:''значение'']&lt;/tt&gt; — позволяет указать значение (или диапазон значений) [[:en:Security Parameter Index|SPI (Security Parameter Index)]].

===== ESP =====
Протокол ESP имеет аналогичную по смыслу опцию
* &lt;tt&gt;'''--espspi''' ''значение''[:''значение'']&lt;/tt&gt;

В большинстве конфигураций IPsec-пакеты просто пропускаются фаерволом (пусть с ними разбирается IPsec-подсистема):
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p ah -j ACCEPT
iptables -I INPUT -p esp -j ACCEPT
&lt;/syntaxhighlight&gt;

=== Критерии состояния соединения ===

==== conntrack ====
Основной критерий, используемый для контроля состояния соединения. Он предоставляет эффективный набор инструментов, позволяющий использовать информацию системы [[conntrack]] о состоянии соединения. Затронутую тему весьма проблематично осветить в двух словах и привести по ней простые примеры, не выходя за краткий формат, принятый для нашей статьи. Поэтому ограничимся мы подробным рассмотрением лишь наиболее важного параметра данного критерия — ctstate. Для прочих параметров мы лишь кратко опишем синтаксис и назначение. За более подробной информацией обратитесь к документации, прилагаемой к вашему дистрибутиву. Итак,

* &lt;tt&gt;[!] '''--ctstate''' ''маска''&lt;/tt&gt;

''Маска'' содержит перечисление через запятую список возможных состояний соединения. Пакет считается удовлетворяющим критерию, если соединение, по которому он проходит, находится в одном из перечисленных состояний.

Возможные состояния:

:* '''NEW''' — соединение не открыто, то есть пакет является первым в соединении. Полезные примеры использования этого состояния приведены выше, в частности, при описании [[#TCP|TCP-специфичных критериев]].

:* '''ESTABLISHED''' — пакет относится к уже установленному соединению. Обычно такие пакеты принимаются без дополнительной фильтрации, как и в случае с RELATED.

:* '''RELATED''' — пакет открывает новое соединение, логически связанное с уже установленными, например, открытие канала данных в пассивном режиме {{w |FTP}}.
Например:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
modprobe nf_conntrack_ftp # Подгружаем модуль для распознавания связанных FTP-соединений
# В старых системах этот модуль может называться ip_conntrack_ftp
iptables -F # Очищаем все цепочки таблицы filter
# Ко всем пакетам, которые относятся к уже установленным соединениям, применяем терминальное действие ACCEPT — пропустить
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT
iptables -A INPUT -m conntrack --ctstate NEW -p tcp --dport 21 -j ACCEPT # Разрешаем открывать соединения на 21 TCP-порт.
iptables -P INPUT DROP # В качестве действия по умолчанию устанавливаем DROP — блокирование пакета
iptables -P OUTPUT ACCEPT # Разрешаем все исходящие пакеты
&lt;/syntaxhighlight&gt;
Этот набор команд обеспечит функционирование на хосте FTP-сервера с поддержкой как активного, так и пассивного режимов. В пассивном режиме FTP клиент сначала устанавливает управляющее соединение на TCP-порт 21 сервера. Когда возникнет необходимость передачи данных, клиент даст серверу команду PASV. Сервер выберет высокий порт и подключится к нему в режиме прослушивания, отправив номер порта клиенту по управляющему соединению. Система [[conntrack]], при наличии подгруженного модуля ядра nf_conntrack_ftp, зафиксирует это сообщение и выделит номер порта. Когда клиент откроет соединение данных на этот высокий порт, система conntrack присвоит первому пакету статус RELATED, в результате чего пакет пройдет по нашему правилу и будет принят. Остальные пакеты в этом соединении будут иметь уже статус ESTABLISHED и тоже будут приняты.

Возможность корректно обрабатывать пассивный режим FTP, как это было описано выше, из всех [[unix]]-фаерволов доступна только в iptables. В других фаерволах для решения данной проблемы используются различные «костыли». Например, в {{w |pf}} управляющие FTP-соединения [http://www.openbsd.org/faq/pf/ftp.html#client пропускаются] через специальную программу [http://www.openbsd.org/cgi-bin/man.cgi?query=ftp-proxy&amp;sektion=8 ftp-proxy], которая анализирует трафик подобно conntrack и «на лету» добавляет правила для соединений данных. Однако даже подобные «костыли» существуют далеко не для всех протоколов. Поэтому можно утверждать, что в данном аспекте iptables находится вне конкуренции.

С обработкой активного режима таких проблем не возникает, так как сервер сам устанавливает соединение данных с порта 20, поэтому первый пакет пропускается согласно правилу по умолчанию цепочки OUTPUT. Правда, проблемы могут возникнуть на стороне фаервола клиента, но это уже не относится к компетенции сервера.

:* '''INVALID''' — пакет по смыслу должен принадлежать уже установленному соединению (например, ICMP-сообщение port-unreachable), однако такое соединение в системе не зарегистрировано. Обычно к таким пакетам применяют действие DROP:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -m conntrack --ctstate INVALID -j DROP
&lt;/syntaxhighlight&gt;

:* '''UNTRACKED''' — отслеживание состояния соединения для данного пакета было отключено. Обычно оно отключается с помощью действия NOTRACK в таблице raw.

:* '''DNAT''' — показывает, что к данному соединению применена операция подмены адреса назначения (об операциях преобразования адресов см. [[#Таблица nat|выше]]).

:* '''SNAT''' — показывает, что к данному соединению применена операция подмены адреса источника (об операциях преобразования адресов см. [[#Таблица nat|выше]]).

Остальные параметры критерия conntrack, как уже говорилось, мы опишем лишь конспективно.

* &lt;tt&gt;[!] '''--ctstatus''' ''маска''&lt;/tt&gt;

Применяется для определения статуса соединения в системе conntrack. Возможные статусы:
:* '''EXPECTED''' — данное соединение ожидалось системой conntrack по результатам анализа других соединений. Например, после того, как клиент и сервер через управляющее {{w |FTP}}-соединение согласуют номер порта для соединения данных в пассивном режиме, система [[conntrack]] на сервере будет ожидать входящее соединение на этот порт.
:* '''CONFIRMED''' — подтвержденное соединение. Такой статус присваивается соединению после того, как инициатор начал передачу пакетов.
:* '''SEEN_REPLY''' — соединение, по которому поступил ответ, то есть имеет место передача данных в обоих направлениях (поддержка данного состояния появилась сравнительно недавно).
:* '''ASSURED''' — соединение можно считать полностью установленным. Этот статус присваивается соединению после передачи определенного количества данных. Присвоение данного статуса приводит к увеличению conntrack-тайм-аута для данного соединения (эти тайм-ауты используются для определения и удаления «повисших» и оборванных соединений).
:* '''NONE''' — нет статуса. Соединение не соответствует ни одному из перечисленных критериев.

* &lt;tt&gt;[!] '''--ctproto''' ''протокол''&lt;/tt&gt;

Протокол [[w:Транспортный уровень|транспортного уровня]], определенный системой conntrack. Синтаксис аналогичен стандартному критерию &lt;tt&gt;-p&lt;/tt&gt;.

* &lt;tt&gt;[!] '''--ctdir''' {ORIGINAL|REPLY}&lt;/tt&gt;

Позволяет указать направление прохождения пакетов (ORIGINAL — от инициатора к отвечающему, REPLY — наоборот). Если не указывать эту опцию, под критерий будут подпадать пакеты, идущие в обоих направлениях.

* &lt;tt&gt;[!] '''--ctorigsrc''' ''адрес''[/''маска'']&lt;/tt&gt;, &lt;tt&gt;[!] '''--ctorigdst''' ''адрес''[/''маска'']&lt;/tt&gt;, &lt;tt&gt;[!] '''--ctreplsrc''' ''адрес''[/''маска'']&lt;/tt&gt;, &lt;tt&gt;[!] '''--ctrepldst''' ''адрес''[/''маска'']&lt;/tt&gt;

Позволяет определять адреса источника (src) и назначения (dst) при передаче данных от инициатора к отвечающему (orig) и наоборот (repl). Синтаксис аналогичен описанному выше стандартному критерию &lt;tt&gt;-s&lt;/tt&gt;.

Обычно адрес-порт источника при передаче в прямом направлении совпадают с адресом-портом назначения при передаче в обратном направлении, и наоборот, адрес-порт источника при передаче в обратном направлении совпадает с адресом-портом назначения при передаче в прямом направлении. То есть, если клиент 192.168.1.2 обращается к серверу 192.168.1.1, то с точки зрения системы conntrack ситуация выглядит следующим образом:
: → В прямом направлении (от инициатора к отвечающему):
:: — Адрес источника (ctorigsrc): 192.168.1.2 (адрес клиента)
:: — Адрес назначения (ctorigdst): 192.168.1.1 (адрес сервера)
: ← В обратном направлении (от отвечающего к инициатору):
:: — Адрес источника (ctreplsrc): 192.168.1.1 (адрес сервера)
:: — Адрес назначения (ctrepldst): 192.168.1.2 (адрес клиента)

Однако для соединений, к которым применена трансляция адресов или портов, это может не выполняться. Например, рассмотрим ситуацию, когда клиент из нашей подсети (192.168.1.2) обращается к некоторому серверу в интернете (204.152.191.37) через наш сервер (внешний адрес нашего сервера 208.77.188.166, внутренний 192.168.1.1). Для корректной работы такой схемы нужно обеспечить на нашем сервере подмену исходного адреса (SNAT), например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A POSTROUTING -o eth0 -j SNAT --to-source 208.77.188.166
&lt;/syntaxhighlight&gt;
Тогда, с точки зрения системы conntrack нашего сервера,
: → В прямом направлении (от инициатора к отвечающему):
:: — Адрес источника (ctorigsrc): 192.168.1.2 (внутренний адрес клиента)
:: — Адрес назначения (ctorigdst): 204.152.191.37 (адрес интернет-сервера)
: ← В обратном направлении (от отвечающего к инициатору):
:: — Адрес источника (ctreplsrc): 204.152.191.37 (адрес интернет-севера)
:: — Адрес назначения (ctrepldst): 208.77.188.166 (внешний адрес нашего сервера)

В том случае, если адрес-порт источника при передаче в прямом направлении отличаются от адреса-порта назначения при передаче в обратном направлении, соединению будет присвоен статус SNAT.

Аналогично, если один из внешних адресов нашего сервера «проброшен» на внутренний сервер, например, так
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A PREROUTING -d 208.77.188.166 -j DNAT --to-destination 192.168.1.2
&lt;/syntaxhighlight&gt;
то при обращении на этот адрес клиента извне (допустим, все тот же 204.152.191.37), получим
: → В прямом направлении (от инициатора к отвечающему):
:: — Адрес источника (ctorigsrc): 204.152.191.37 (адрес клиента)
:: — Адрес назначения (ctorigdst): 208.77.188.166 (наш внешний адрес)
: ← В обратном направлении (от отвечающего к инициатору):
:: — Адрес источника (ctreplsrc): 192.168.1.2 (адрес внутреннего сервера)
:: — Адрес назначения (ctrepldst): 204.152.191.37 (адрес клиента)

В том случае, если адрес-порт назначения при передаче в прямом направлении отличаются от адреса-порта источника при передаче в обратном направлении, соединению будет присвоен статус DNAT.

* &lt;tt&gt;[!] '''--ctorigsrcport''' ''порт''&lt;/tt&gt;, &lt;tt&gt;[!] '''--ctorigdstport''' ''порт''&lt;/tt&gt;, &lt;tt&gt;[!] '''--ctreplsrcport''' ''порт''&lt;/tt&gt;, &lt;tt&gt;[!] '''--ctrepldstport''' ''порт''&lt;/tt&gt;

Позволяет определять порты источника (src) и назначения (dst) при передаче данных от инициатора к отвечающему (orig) и наоборот (repl) для протоколов транспортного уровня, имеющих порты (TCP, UDP, SCTP, DCCP).

Ситуация с портами в принципе аналогична описанной выше ситуации с адресами, поэтому рассматривать ее отдельно мы не будем.

* &lt;tt&gt;[!] '''--ctexpire''' ''мин_время''[:''макс_время'']&lt;/tt&gt;

Позволяет указать в качестве критерия оставшееся по тайм-ауту время в секундах для данного соединения.

Система conntrack присваивает каждому соединению тайм-аут (счетчик обратного отсчета времени). Когда этот счетчик доходит до нуля, система conntrack удаляет информацию о соединении из своих таблиц. Тайм-аут устанавливается в значение по умолчанию каждый раз, когда по соединению передаются данные. Таким образом, активно используемые соединения никогда не будут сброшены.

Заметим, что значения тайм-аута по умолчанию для разных протоколов, и даже для одного протокола на разных стадиях установки соединения, могут различаться. Например, для протокола {{w |TCP}} вводятся отдельные значения тайм-аутов для состояний SYN_SENT, SYN_RECV, ESTABLISHED (не путать TCP-состояние ESTABLISHED с conntrack-состоянием ESTABLISHED), FIN_WAIT, CLOSE_WAIT, LAST_ACK, TIME_WAIT, CLOSE. Для {{w |UDP}} существуют два тайм-аута: для соединений, не получивших статуса ASSURED (conntrack_udp_timeout) и для соединений, по которым передано достаточное количество данных в обе стороны для получения этого статуса (conntrack_udp_timeout_stream). Для {{w |ICMP}} тайм-аут только один.

==== state ====
Идеологический предшественник критерия conntrack. Имеет единственный параметр &lt;tt&gt;--state&lt;/tt&gt;, аналогичный параметру &lt;tt&gt;--ctstate&lt;/tt&gt; критерия conntrack (но, в отличие от него, не поддерживающий состояния DNAT и SNAT).

Долгое время был основным критерием определения состояния, и до сих пор фигурирует во многих руководствах и примерах. Однако в настоящее время разработчики iptables рекомендуют использовать вместо него критерий conntrack. Возможно, что критерий state вообще будет удален из будущих версий iptables/netfilter.

=== Дополнительные критерии ===
Дополнительные критерии iptables подгружаются при помощи параметра &lt;tt&gt;-m&lt;/tt&gt; (&lt;tt&gt;--match&lt;/tt&gt;). Далее можно указать дополнительные параметры, специфичные для данного конкретного критерия. Если дополнительных критериев несколько, не смешивайте их параметры — указывайте нужные параметры каждого критерия непосредственно после его вызова через &lt;tt&gt;-m&lt;/tt&gt;.

Перед некоторыми дополнительными параметрами критерия может стоять восклицательный знак. В соответствии с принятыми в iptables соглашениями, это означает логическую инверсию параметра, то есть его смысл меняется на противоположный. Но такая возможность предусмотрена отнюдь не для всех параметров.

Заметим, что перечисленные выше критерии состояния и критерии, специфичные для протоколов, по сути также являются параметрами соответствующих дополнительных критериев (например, при указании &lt;tt&gt;-p tcp&lt;/tt&gt; подразумевается еще и &lt;tt&gt;-m tcp&lt;/tt&gt;). Однако в силу ряда причин более логичным и понятным было их отделение от остальных дополнительных критериев. Обратите внимание, что ''все'' параметры вышеперечисленных критериев допускают логическое отрицание (например, &lt;tt&gt;-m conntrack ! --ctstate NEW&lt;/tt&gt;).

Справочную информацию по любому из дополнительных критериев можно получить, используя команду
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -m название_критерия -h
&lt;/syntaxhighlight&gt;

==== Вспомогательные критерии ====
К этой группе можно отнести критерии, расширяющие возможности других критериев.

* '''multiport''' — позволяет указать несколько (до 15) портов и/или их диапазонов (для протоколов {{w |TCP}}, {{w |UDP}}, {{w |SCTP}}, {{w |DCCP}} и {{w |UDP Lite}}). Поддерживает следующие параметры

&lt;tt&gt;[!] --sports&lt;/tt&gt;, &lt;tt&gt;--source-ports ''порт''[:''порт''][,''порт''[:''порт''][,...]]&lt;/tt&gt; — улучшенная версия критерия &lt;tt&gt;--sport&lt;/tt&gt;, описанного выше. Позволяет перечислить (без пробелов, через запятую) до 15 портов или их диапазонов.

&lt;tt&gt;[!] --dports&lt;/tt&gt;, &lt;tt&gt;--destination-ports ''порт''[:''порт''][,''порт''[:''порт''][,...]]&lt;/tt&gt; — улучшенная версия критерия &lt;tt&gt;--dport&lt;/tt&gt;, описанного выше. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -p tcp -m multiport --dports 80,8000:8008 -j ACCEPT
&lt;/syntaxhighlight&gt;
позволит принимать TCP-пакеты, приходящие на порты 80 и с 8000 по 8008.

&lt;tt&gt;[!] --ports ''порт''[:''порт''][,''порт''[:''порт''][,...]]&lt;/tt&gt; — пакет будет подпадать под этот критерий, если его исходный порт ''или'' порт назначения присутствует в указанном списке.

* '''iprange''' — позволяет указать диапазон {{w |IP-адрес}}ов, не являющийся подсетью. Поддерживает следующие параметры:

&lt;tt&gt;[!] --src-range ''адрес''[-''адрес'']&lt;/tt&gt; — позволяет указать диапазон исходных адресов. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -m iprange --src-range 192.168.0.8-192.168.0.25 -j DROP
&lt;/syntaxhighlight&gt;
заблокирует все пакеты, исходный адрес которых лежит в диапазоне с 192.168.0.8 по 192.168.0.25 включительно.

&lt;tt&gt;[!] --dst-range ''адрес''[-''адрес'']&lt;/tt&gt; — позволяет указать диапазон адресов назначения.

==== Критерии маркировки ====
* '''mark''' — позволяет выделять пакеты с заданной маркировкой (nfmark). Имеет единственную опцию

&lt;tt&gt;[!] --mark ''значение''[/''маска'']&lt;/tt&gt; — указывает значение маркировки. Простейший пример:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
-m mark --mark 15
&lt;/syntaxhighlight&gt;
будет выделять пакеты с маркировкой 15.

Если указана маска, то перед сравнением с заданным значением маркировка каждого пакета комбинируется с этой маской посредством логической операции [[w:Конъюнкция|AND]], то есть проверяется условие &lt;tt&gt;x &amp; ''маска'' == ''значение''&lt;/tt&gt; (где x — маркировка текущего пакета). Такой подход позволит сравнивать значения отдельных {{w |бит}}. Например, критерию
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
-m mark --mark 64/64
&lt;/syntaxhighlight&gt;
будет отлавливать пакеты, в маркировке которых установлен 7-й бит (&lt;math&gt;2^6=64&lt;/math&gt;, при этом первый бит соответствует &lt;math&gt;2^0&lt;/math&gt;). В частности, 64…127, 192…255, 320…383 и т. д.

Еще один пример —
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
-m mark --mark 2/3
&lt;/syntaxhighlight&gt;
будет определять пакеты, в маркировке которых установлен второй бит, но снят первый. Такие числа будут нацело делиться на два, но не делиться на четыре — 2, 6, 10, 14, …

* '''connmark''' — полностью аналогичен mark, но проверяет не маркировку пакета (nfmark), а маркировку соединения (ctmark). Также имеет параметр &lt;tt&gt;--mark&lt;/tt&gt; с аналогичным синтаксисом.

В качестве практического примера использования меток пакетов и соединений рассмотрим улучшение работы {{w |l7-filter}}-userspace.

Userspace-вариант {{w |l7-filter}} является [[w:Демон (программа)|демоном]], взаимодействующим с {{w |netfilter}} через подсистему nfnetlink_queue — действие NFQUEUE в терминологии iptables. При помощи этого действия определенные пакеты можно направить на анализ демону l7-filter. По результатам анализа демон выставит маркировку пакетов: 1 — пакет принадлежит новому соединению, тип которого пока не идентифицирован; 2 — пакет принадлежит соединению, тип которого идентифицировать так и не удалось. Другие значения соответствуют установленным типам соединений (соответствие задается в конфигурационном файле демона) [http://l7-filter.sourceforge.net/HOWTO-userspace#Does].

Задача l7-filter — определить тип протокола [[w:Протоколы прикладного уровня|прикладного уровня]] (см. {{w |модель OSI}}) для данного пакета/соединения. Решается эта задача путем анализа содержимого пакета с применением [[Регулярные выражения|регулярных выражений]], позволяющих определить типовые лексемы, характерные для различных протоколов (например, «&lt;tt&gt;220 ftp server ready&lt;/tt&gt;» для {{w |FTP}} или «&lt;tt&gt;HTTP/1.1 200 OK&lt;/tt&gt;» для {{w |HTTP}}). Пакет, в котором встречаются такие лексемы, может быть однозначно классифицирован. В принципе, это дает достаточное основание классифицировать соединение в целом. Однако, в этом поведение kernel и userspace версий l7-filter существенно различается.

Как описывается в [http://l7-filter.sourceforge.net/technicaldetails документации], версия l7-filter-kernel ''хранит'' данные о соединениях и ''использует'' их для классификации пакетов, принадлежащих к соединениям, тип которых уже установлен. В то же время, аналогичное утверждение в отношении l7-filter-userspace в документации отсутствует. И, как показывает практика, userspace-версия ''не использует'' информацию о соединениях. Возможно, это обусловлено техническими ограничениями nfnetlink_queue как средства взаимодействия l7-filter с системой netfilter.

Описанный недостаток значительно снижает эффективность l7-filter — ведь однозначно классифицированы могут быть всего несколько пакетов из каждого соединения, а всего в соединении могут быть миллионы и миллиарды пакетов. Соответственно, применение l7-filter по своему основному назначению — классификация трафика для последующего [[w:Шейпинг (информатика)|шейпинга]] — не оправдывает себя.

Итак, рассмотрим, как, используя возможности netfilter, можно исправить этот недостаток.

Идея решения проста: после обработки пакетов демоном l7-filter, нужно добавить операции по переносу маркировки пакета на соединение (чтобы классифицировать соединение в целом) и с соединения на пакеты (чтобы пометить уже ''все'' пакеты в соединении для дальнейшей обработки шейпером, так как шейпер воспринимает только метки пакетов). Таким образом, классификация одного пакета в соединении влечет классификацию всех последующих пакетов.

Для начала, запустим демон l7-filter-userspace. Небольшое замечание: в его конфигурационном файле (назовем его, например, &lt;tt&gt;l7-filter.conf&lt;/tt&gt;) будем помечать протоколы метками в диапазоне от 16 до 31 включительно (почему — станет понятно из дальнейших пояснений).
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
l7-filter -f /etc/l7-filter.conf -q 2 -m 0x1f
&lt;/syntaxhighlight&gt;
Параметр &lt;tt&gt;-f&lt;/tt&gt; указывает путь к конфигурационному файлу, &lt;tt&gt;-q&lt;/tt&gt; — номер очереди, &lt;tt&gt;-m&lt;/tt&gt; — задает биты маркировки, модифицируемые демоном l7-filter (в нашем случае — с первого по пятый, что соответствует диапазону значений маркировки от 0 до 31).

Далее, добавим правила, направляющие весь входящий и исходящий трафик (кроме локального) на анализ демону l7-filter:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -F # На всякий случай очищаем таблицу mangle
# Направляем на анализ входящий трафик, включая транзитный
iptables -t mangle -A PREROUTING ! -i lo -j NFQUEUE --queue-num 2
# Направляем на анализ исходящий трафик, кроме транзитного
iptables -t mangle -A OUTPUT ! -o lo -j NFQUEUE --queue-num 2
&lt;/syntaxhighlight&gt;
Добавлять второе из этих правил в цепочку POSTROUTING не стоило — ведь в нее попадает как трафик, исходящий от самого хоста, так и транзитный трафик, который уже был обработан ранее, в цепочке PREROUTING. Посмотрев на диаграмму выше, вы можете убедиться, что приведенные правила обрабатывают весь трафик, как принадлежащий самому хосту, так и транзитный, за исключением локального. Локальный трафик (идущий через интерфейс [[w:Loopback|lo]]), бессмысленно шейпить, а значит, не стоит и классифицировать.

Теперь добавим правила, обеспечивающие копирование маркировки пакетов в маркировку соединений и обратно:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
# Для входящего трафика (кроме транзитного)
# Копируем маркировку пакетов в маркировку соединений
iptables -t mangle -A INPUT -m mark --mark 0x10/0xfffffff0 -j CONNMARK --save-mark
# И наоборот
iptables -t mangle -A INPUT -m connmark --mark 0x10/0xfffffff0 -j CONNMARK --restore-mark
# Аналогично для исходящего трафика (включая транзитный)
iptables -t mangle -A POSTROUTING -m mark --mark 0x10/0xfffffff0 -j CONNMARK --save-mark
iptables -t mangle -A POSTROUTING -m connmark --mark 0x10/0xfffffff0 -j CONNMARK --restore-mark
&lt;/syntaxhighlight&gt;
Поясним два момента. Во-первых, добавление этих правил в цепочки PREROUTING и OUTPUT, сразу после правил, передающих трафик демону l7-filter, не имеет смысла — после обработки пакетов демон [http://l7-filter.sourceforge.net/HOWTO-userspace#Does применяет] к ним действие ACCEPT, прекращающее обработку пакета в рамках исходных цепочек. Поэтому мы добавляем эти правила в цепочки, идущие «ниже по течению». Как вы можете заметить по диаграмме выше, такая комбинация правил также обеспечивает обработку всего трафика.

Второй момент, который стоит пояснить — маски специального вида. По сути, они позволяют проверить, лежит ли маркировка пакета в диапазоне от 16 до 31. Такая защита позволяет избежать обработки маркировок 0 (такую маркировку имеет локальный трафик, так как он не проходит процедуру анализа), 1 и 2 (эти значения маркировки, как уже было замечено выше, означают, что тип пакета не определен), а также 32 и выше (эти значения мы оставляем для других задач).

Как показывает [http://www.linux.org.ru/jump-message.jsp?msgid=3790164&amp;cid=3791754 практика], даже в самом примитивном случае (детекция протокола {{w |HTTP}}, сервер — {{w |nginx}} 0.6.32, клиент — [http://www.hping.org/wbox/ wbox] 4), эффективность детекции возрастает — без использования маркировки соединений регистрируются лишь 2 исходящих пакета (l7-filter работает на сервере), с использованием — 3 исходящих и 2 входящих. Детальное исследование показывает, что детекции избегают лишь первые четыре пакета в соединении — 2 SYN-пакета и 2 пакета с данными. Это цифры, характерные для тестовой задачи — при передаче больших объемов данных количество детектированных пакетов будет значительно больше, в то время как количество не определенных пакетов сохранит тот же порядок.

Более того, предложенный метод решает задачу, не решенную даже в реализации l7-filter-kernel — маркировка связанных соединений. Согласно документации iptables, маркировка соединений автоматически копируется с исходных соединений на связанные с ними (например, с управляющего {{w |FTP}}-соединения на соединение данных).

: ''Примечание: следующий пример планируется к переносу в еще не написанный раздел статьи (Прочие критерии → statistic)''.

В качестве практического примера использования меток пакетов и соединений можно рассмотреть задачу [[w:Случайная величина|стохастической]] балансировки соединений между несколькими [[аплинк]]ами.
Допустим, у нас есть три провайдера, подключенных к интерфейсам eth0, eth1 и eth2 (это могут быть и {{w |VLAN}}-порты одного интерфейса, суть от этого не меняется, только названия), и их шлюзы имеются соответственно {{w |IP-адрес}}а 208.77.188.1, 208.77.189.1, 208.77.190.1.

Для начала, создадим для каждого провайдера свою таблицу маршрутизации
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
echo -e &quot;\n110\tstatic\n111\tprov1\n112\tprov2\n113\tprov3&quot; &gt;&gt; /etc/iproute2/rt_tables
&lt;/syntaxhighlight&gt;

Этот код добавит в конец файла &lt;tt&gt;/etc/iproute2/rt_tables&lt;/tt&gt; строки
  110    static
  111    prov1
  112    prov2
  113    prov3
устанавливающие соответствие между внутренними номерами таблиц маршрутизации и их символьными именами. Используемые здесь имена prov1, prov2 и prov3, разумеется, условны. Таблица static — особая, ее мы рассмотрим чуть ниже.

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

Далее, сделаем каждого провайдера шлюзом по умолчанию в «своей» таблице:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
ip route add default via 208.77.188.1 dev eth0 table prov1
ip route add default via 208.77.189.1 dev eth1 table prov2
ip route add default via 208.77.190.1 dev eth2 table prov3
&lt;/syntaxhighlight&gt;

Добавим для каждой таблицы правило, отправляющее в нее пакеты с соответствующей маркировкой:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
ip rule add fwmark 1 table prov1
ip rule add fwmark 2 table prov2
ip rule add fwmark 3 table prov3
# Но прежде всего пакеты должны пройти таблицу static
ip rule add table static prio 1
&lt;/syntaxhighlight&gt;

Таблица static предназначена для обслуживания статических маршрутов. В частности, в нее мы занесем подсети провайдеров (предположим, что все они [[w:Бесклассовая адресация|класса 1C]]), а также наши внутренние локальные сети (если таковые есть):
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
# Провайдеры
ip route add 208.77.188.0/24 dev eth0 table static
ip route add 208.77.189.0/24 dev eth1 table static
ip route add 208.77.190.0/24 dev eth2 table static
# Две наших локалки
ip route add 192.168.1.0/24 dev eth3 table static
ip route add 192.168.2.0/24 dev eth4 table static
# Сбрасываем кеш маршрутов
ip route flush cache
&lt;/syntaxhighlight&gt;
Таким образом, если нашему хосту нужно будет обратиться в подсеть провайдера prov2 (208.77.189.0/24), то маршрут пойдет сразу через интерфейс eth1. Также в этой таблице присутствуют маршруты для наших внутренних локальных сетей — с ними тоже все просто.

По сути дела, таблица static обычно содержит те же маршруты, что и таблица main (главная таблица маршрутизации), за исключением маршрута по умолчанию — таких маршрутов у нас несколько и каждый из них размещается в отдельной таблице, выбор между которыми осуществляется на основании назначенной iptables/netfilter маркировки.

Заметим, что ни в таблицу static, ни в какие-либо другие таблицы не нужно вносить {{w |loopback}}-маршруты, например «127.0.0.1/8 dev lo», так как все эти маршруты фигурируют в автоматически создаваемой таблице local, которую любой пакет проходит в первую очередь (нетрудно убедиться в этом, посмотрев вывод команды «ip rule show»).

Далее, отключим статическую антиспуфинговую фильтрацию:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
sysctl net.ipv4.conf.all.rp_filter=0
&lt;/syntaxhighlight&gt;
Reverse path filtering — штука, конечно, удобная и полезная но, к сожалению, совершенно не совместимая с динамической маршрутизацией.

Если вы планируете использовать этот компьютер не только как [[w:Сетевой шлюз|шлюз]], и но и как интернет-{{w |сервер}} (то есть предоставлять доступ к нему извне), необходимо выполнить привязку входящих соединений к их интерфейсам — в противном случае могут возникнуть проблемы, если обращение извне придет через одного провайдера, а сервер ответит через другого.
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -N bind_connect # Создаем отдельную цепочку (для простоты управления)
# Следите за правильным соответствием значений меток и интерфейсов!
iptables -t mangle -A bind_connect -i eth0 -j CONNMARK --set-mark 1
iptables -t mangle -A bind_connect -i eth1 -j CONNMARK --set-mark 2
iptables -t mangle -A bind_connect -i eth2 -j CONNMARK --set-mark 3
# Пропускаем через эту процедуру все новые соединения к нашему серверу
iptables -t mangle -I INPUT -m conntrack --ctstate NEW -j bind_connect
&lt;/syntaxhighlight&gt;
Теперь, в сочетании с операцией &lt;tt&gt;-j CONNMARK --restore-mark&lt;/tt&gt;, которой мы подвергнем исходящий с нашего сервера трафик (см. ниже), эта процедура обеспечит корректную обработку входящих соединений. (Отметим, что, если бы нам не нужно было бы балансировать исходящие соединения, мы могли бы обойтись вообще без помощи iptables/netfilter, выполнив привязку входящих соединений через правила вида &lt;tt&gt;ip rule add from 208.77.188.100 table prov1&lt;/tt&gt; и т. п. — ответные пакеты всегда уходят с того же адреса, на который пришел запрос, так что в качестве критерия для выбора шлюза можно использовать исходный адрес.)

Ввиду того, что выбор исходящего адреса для каждого нового соединения осуществляется на основании правил статической маршрутизации (таблица main), могут возникнуть ошибки. Например, если в маршруте по умолчанию (default) в таблице main указан интерфейс eth0, то все исходящие от нас во внешнюю сеть (интернет) соединения будут иметь в качестве исходного адреса первый адрес интерфейса eth0, и ответные пакеты пойдут именно на этот интерфейс. Чтобы избежать возникновения таких ситуаций, добавим {{w |маскарадинг}} для всех исходящих соединений (предполагается, что у всех провайдеров наши внешние адреса имеют вид 208.77.x.100):
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t nat -A POSTROUTING -o eth0 -j SNAT --to-source 208.77.188.100
iptables -t nat -A POSTROUTING -o eth1 -j SNAT --to-source 208.77.189.100
iptables -t nat -A POSTROUTING -o eth2 -j SNAT --to-source 208.77.190.100
&lt;/syntaxhighlight&gt;

А теперь — самое интересное. Используя описанный ниже критерий statistic, мы будем случайно распределять метки между пакетами.
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -N select_prov # Создаем для этого специальную цепочку
iptables -t mangle -A select_prov -j CONNMARK --set-mark 1 # Ставим всем соединениям маркировку 1
iptables -t mangle -A select_prov -m statistic --mode random --probability 0.34 -j RETURN # С вероятностью 34% выходим из этой цепочки
iptables -t mangle -A select_prov -j CONNMARK --set-mark 2 # Ставим всем оставшимся соединениям маркировку 2
iptables -t mangle -A select_prov -m statistic --mode random --probability 0.5 -j RETURN # С вероятностью 50% выходим из этой цепочки
iptables -t mangle -A select_prov -j CONNMARK --set-mark 3 # Всем, кто дошел досюда, ставим маркировку 3
&lt;/syntaxhighlight&gt;
Первое правило в этой цепочке пройдут все пакеты, вошедшие в нее. После этого, 34 % (примерно треть из них) покинет цепочку согласно второму правилу. Далее, оставшиеся пакеты (66 % от первоначального количества) получат маркировку 2. После этого половина из них (то есть 33 % от начального) покинут цепочку с этой маркировкой. Оставшаяся половина (тоже 33 % от начального количества) получат маркировку 3.

После этого, создадим вспомогательную цепочку, осуществляющую маркировку соединений и пакетов:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -N sort_connect
iptables -t mangle -A sort_connect -o lo -j RETURN # Локальным соединениям балансировка не нужна
# Аналогично выгоняем пакеты, выходящие через интерфейсы внутренней локалки, если она есть
iptables -t mangle -A sort_connect -o eth3 -j RETURN
iptables -t mangle -A sort_connect -o eth4 -j RETURN
iptables -t mangle -A sort_connect -m conntrack --ctstate NEW -j select_prov # Все новые пакеты прогоняем через процедуру случайного выбора
iptables -t mangle -A sort_connect -j CONNMARK --restore-mark # Копируем маркировку соединений на пакеты
&lt;/syntaxhighlight&gt;
Через цепочку &lt;tt&gt;select_prov&lt;/tt&gt; мы прогоняем только новые пакеты, то есть первые пакеты каждого соединения. После этой процедуры соединение уже имеет маркировку. К сожалению, на данный момент роутинговая подсистема ядра [[w:Ядро Linux|Linux]] не умеет маршрутизировать пакеты на основании маркировки соединения — только на основании маркировки пакетов. Поэтому действием &lt;tt&gt;CONNMARK --restore-mark&lt;/tt&gt; мы копируем маркировку соединений в маркировку пакетов.

Осталось только добавить вызов этой цепочки в таблицу mangle:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -I OUTPUT -j sort_connect
&lt;/syntaxhighlight&gt;
Теперь все ваши исходящие соединения будут балансироваться согласно описанным правилам.

Аналогичную функциональность можно реализовать и для транзитных соединений. Для этого достаточно добавить вызов &lt;tt&gt;sort_connect&lt;/tt&gt; в цепочку FORWARD таблицы mangle:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -I FORWARD -j sort_connect
&lt;/syntaxhighlight&gt;

Разумеется, при этом должна быть разрешена передача транзитного трафика, как в таблице filter, так и на уровне sysctl. Как это делается — см. выше.

Заметим, что кроме алгоритма случайной балансировки, критерий statistic позволяет реализовать балансировку в режим [[w:Round-robin (алгоритм)|round robin]]. Для этого поменяем цепочку &lt;tt&gt;select_prov&lt;/tt&gt; следующим образом:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -F select_prov # Очищаем ее
iptables -t mangle -A select_prov -j CONNMARK --set-mark 1 # Ставим всем соединениям маркировку 1
iptables -t mangle -A select_prov -m statistic --mode nth --every 3 -j RETURN # Первый из трех пакетов - выходим
iptables -t mangle -A select_prov -j CONNMARK --set-mark 2 # Ставим всем оставшимся соединениям маркировку 2
iptables -t mangle -A select_prov -m statistic --mode nth --every 2 -j RETURN # Один из оставшихся двух - выходим
iptables -t mangle -A select_prov -j CONNMARK --set-mark 3 # Последний
&lt;/syntaxhighlight&gt;

Подробнее о принципах работы критерия statistic см. ниже.

В завершение нашего обсуждения стоит заметить, что в некоторых случаях для балансировки соединений достаточно единственной команды
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
ip route add default scope global nexthop via 208.77.188.1 dev eth0 weight 1 nexthop via 208.77.189.1 dev eth1 weight 1 # И т.д.
&lt;/syntaxhighlight&gt;
Стоит обратить особое внимание на тот факт, что данный метод балансирует ''пакеты'', а не соединения. Например, в том случае, если вы хотите организовать выход в интернет из локальной сети через нескольких провайдеров, не имея единого внешнего адреса, этот метод может работать некорректно — часть пакетов пройдет через одного провайдера и после операции {{w |NAT}} получит один исходный адрес, часть пойдет через другого и соответственно получит другой адрес, и в результате удаленные хосты не смогут правильно обрабатывать соединения, исходящие из вашей сети. Однако, в большинстве случаев этот негативный эффект нивелируется другим фактором — кэшированием маршрутов. При прохождении через такое правило серии пакетов, адресованных некоторому хосту, действительно случайным выбор будет только для первого из них, после чего выбранный маршрут будет закэширован, и остальные пакеты к этому хосту будут маршрутизироваться через тот же шлюз. С одной стороны, подобный эффект позволяет соединениям корректно функционировать, с другой стороны — балансировка оказывается не такой уж и случайной. К тому же, после очистки кэша маршрутов (например, посредством ввода команды &lt;tt&gt;ip route flush cached&lt;/tt&gt;), работа существующих на этот момент соединений может быть нарушена. В качестве наиболее безопасного и целесообразного применения описанного метода можно привести задачу балансировки транзитного трафика в сетях без NAT (условия «прямой видимости» между балансирующим маршрутизатором и точкой схождения потоков трафика). В том случае, если доступ к шлюзам осуществляется через один сетевой интерфейс, этим методом можно балансировать и соединения, исходящие от самого хоста.

Также заметим, что описанные в этом примере методы балансировки не учитывают загруженность каналов. Для этого рекомендуется использовать критерий rateest и действие RATEEST совместно с уже знакомым нам CONNMARK.

==== Лимитирующие критерии ====
К этой группе относятся критерии, позволяющие ограничивать количество пакетов, соединений, и переданных байт.

* '''limit''' — позволяет ограничить количество пакетов в единицу времени. Параметры:

&lt;tt&gt;--limit ''количество''[/second|/minute|/hour|/day]&lt;/tt&gt; — задает ограничение на количество пакетов в секунду (second), минуту (minute), час (hour) или сутки (day). Пакеты в пределах этого количества считаются удовлетворяющими критерию, сверх этого количества — не удовлетворяющими.

&lt;tt&gt;--limit-burst ''количество''&lt;/tt&gt; — задает длину очереди, то есть максимальную пропускную способность.

Критерий -limit использует модель «дырявого ведра», и --limit-burst задает «объем ведра», а --limit — «скорость вытекания». Каждому такому критерию соответствует своя очередь, длина которой задается параметром --limit-burst. Если в очереди есть пакеты, то со скоростью, заданной в --limit, они покидают очередь и считаются удовлетворяющими критерию. Если же вся очередь занята, то новые пакеты в ней не регистрируются и считаются ''не'' удовлетворяющими критерию.
Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -I INPUT -m limit --limit 3/min --limit-burst 5 -j LOG --log-level debug --log-prefix &quot;INPUT packet: &quot;
&lt;/syntaxhighlight&gt;
предполагает очередь на пять пакетов, которая «продвигается» со скоростью 3 пакета в минуту. При непрерывном поступлении входящих пакетов, очередь всегда будет заполнена, и в лог будут заноситься в среднем по три пакета в минуту. Однако, если входящих пакетов долго не будет, то очередь успеет очиститься, и при поступлении пяти и менее новых пакетов, они пойдут в лог подряд. В любом случае, скорость попадания пакетов в лог остается неизменной.

Типичная ошибка новичков — использовать limit для ограничения TCP-трафика, например, так:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -p tcp --dport 80 -m limit --limit 10000/sec --limit-burst 10000 -j ACCEPT
iptables -P INPUT DROP
&lt;/syntaxhighlight&gt;
Это пример попытки защитить {{w |web-сервер}} от [[w:DoS-атака|DDoS-атаки]], ограничив количество пакетов в единицу времени. Однако, это правило не помешает без особого труда завалить сервер запросами (считая, что на один запрос требуется два входящих пакета — SYN-пакет и пакеты данных, содержащий, например, только GET /, согласно спецификации HTTP 0.9). При этом могут возникнуть помехи для легальных пользователей, например, загружающих на сервер большой файл методом POST. Более корректным решением будет ограничивать не скорость входящего потока данных, а скорость открытия новых соединений:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -p tcp --dport 80 -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT
iptables -A INPUT -p tcp --dport 80 -m conntrack --ctstate NEW -m limit --limit 32/sec --limit-burst 32 -j ACCEPT
iptables -P INPUT DROP
&lt;/syntaxhighlight&gt;
Теперь мы ограничиваем количество не всех пакетов, а только новых, то есть мы разрешаем открывать не более 32 новых соединений в секунду. Впрочем, число 32 приведено здесь только для примера. Конкретное значение скорости для вашей задачи рекомендуем определять самостоятельно.

* '''hashlimit''' — позволяет применять ограничения, аналогичные критерию limit, к группам хостов, подсетей или портов, используя всего одно правило. При этом для каждого хоста, подсети или порта создается отдельная очередь. Можно задвать, например, такие критерии:

«1000 пакетов в секунду с каждого хоста из подсети 192.168.0.0/16»
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
-s 192.168.0.0/16 -m hashlimit --hashlimit-upto 1000/sec --hashlimit-mode srcip
&lt;/syntaxhighlight&gt;

«100 пакетов в секунду с каждого TCP-порта хоста 192.168.1.1»
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
-s 192.168.1.1 -m hashlimit --hashlimit-upto 100/sec --hashlimit-mode srcport
&lt;/syntaxhighlight&gt;

«10000 пакетов в минуту с каждой подсети префикса 28 (маска 255.255.255.240) из диапазона 10.0.0.0/8»
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
-s 10.0.0.0/8 -m hashlimit --hashlimit-upto 10000/min --hashlimit-mode srcip --hashlimit-srcmask 28
&lt;/syntaxhighlight&gt;

Обратите внимание, что в ''каждом'' из этих правил нужно обязательно указать имя таблицы очередей (haslimit-name, см. ниже), однако, в целях простоты изложения, в некоторых примерах этот параметр опущен.

Рассмотрим основные параметры этого критерия более подробно:

&lt;tt&gt;--hashlimit-mode {srcip|srcport|dstip|dstport}[,...]&lt;/tt&gt; — задает список контролируемых параметров: адреса (ip) и порты (port) источника (src) и назначения (dst). Например, если указать параметр
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
--hashlimit-mode srcip,dstip
&lt;/syntaxhighlight&gt;
то будет создаваться отдельная очередь для каждой пары «адрес источника — адрес назначения», то есть ограничение будет вводиться на количество пакетов, передаваемых с каждого хоста на другой хост (разумеется, если эти пакеты идут через наш сервер). Или, например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
--hashlimit-mode srcip,srcport
&lt;/syntaxhighlight&gt;
будет создавать отдельную очередь для каждого исходного порта каждого хоста.

&lt;tt&gt;--hashlimit-upto ''количество''[/second|/minute|/hour|/day]&lt;/tt&gt; — этот параметр задает скорость движения очереди (аналог &lt;tt&gt;--limit&lt;/tt&gt;). Если пакеты поступают с такой же или меньшей скоростью, они считаются подпадающими под критерий. Обратите внимание, что этот параметр ''не'' поддерживает логической инверсии (отрицания) через восклицательный знак (см. ниже).

&lt;tt&gt;--hashlimit-above ''количество''[/second|/minute|/hour|/day]&lt;/tt&gt; — этот параметр таке задает скорость движения очереди, но смысл его противоположный — если пакеты поступают с ''большей'' скоростью, они считаются подпадающими под критерий.

&lt;tt&gt;--hashlimit-burst ''количество''&lt;/tt&gt; — задает длину каждой очереди. Аналогичен &lt;tt&gt;--limit-burst&lt;/tt&gt;.

&lt;tt&gt;--hashlimit-srcmask ''префикс''&lt;/tt&gt; — задает размер подсети исходных адресов, для которой вводится своя очередь. Имеет смысл, только если в haslimit-mode указан режим srcip. Как уже говорилось выше,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
-m hashlimit --hashlimit-mode srcip --hashlimit-srcmask 28
&lt;/syntaxhighlight&gt;
будет заводить отдельную очередь для каждой подсети с маской 255.255.255.240 (подробнее про префиксы и маски см. {{w |CIDR}}).
По умолчанию 32 (своя очередь для каждого отдельного хоста). Если указать 0, то контроль по параметру srcip теряет смысл.

&lt;tt&gt;--hashlimit-dstmask ''префикс''&lt;/tt&gt; — задает размер подсети исходных адресов, для которой вводится своя очередь. Имеет смысл, только если в haslimit-mode указан режим dstip. Принцип использования аналогичен hashlimit-srcmask.

&lt;tt&gt;--hashlimit-name ''имя''&lt;/tt&gt; — позволяет использовать несколько независимых таблиц очередей (hashes), распознаваемых по имени. Обязательный параметр. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -F INPUT # Очищаем цепочку INPUT
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT # Пропускаем все, что идет по уже установленным соединениям
# Вводим ограничения для новых подключений по FTP
iptables -A INPUT -m conntrack --ctstate NEW -p tcp --dport 21 -m hashlimit --hashlimit-upto 5/min --hashlimit-mode srcip --hashlimit-name ftphash -j ACCEPT
# Вводим ограничения для новых подключений по rsync.
iptables -A INPUT -m conntrack --ctstate NEW -p tcp --dport 873 -m hashlimit --hashlimit-upto 5/min --hashlimit-mode srcip --hashlimit-name rsynchash -j ACCEPT
iptables -P INPUT DROP # Всех остальных не пускаем
&lt;/syntaxhighlight&gt;
Теперь очереди ограничений для подключения к службам {{w |FTP}} и {{w |rsync}} для нашего сервера будут вводиться независимо, то есть если какой-либо хост превысит предел подключений по FTP, то это никак не повлияет на подключения по rsync. Заметим, что в данном конкретном случае аналогичную функциональность можно реализовать, даже не используя разные хеши:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -F INPUT # Очищаем цепочку INPUT
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT # Пропускаем все, что идет по уже установленным соединениям
# Вводим ограничения для новых подключений по FTP и rsync
iptables -A INPUT -m conntrack --ctstate NEW -p tcp -m multiport --dports 21,873 -m hashlimit --hashlimit-upto 5/min --hashlimit-mode srcip,dstport --hashlimit-name ftprsynchash -j ACCEPT
iptables -P INPUT DROP # Всех остальных не пускаем
&lt;/syntaxhighlight&gt;
Впрочем, выбирая между этими двумя реализациями, стоит учитывать, что размер каждого хеша ограничен.

Не забывайте указывать имя таблицы очередей при каждом использовании критерия hashlimit. Если вы не планируете совместно использовать одни и те же таблицы в нескольких правилах, эти имена должны различаться.

Доступ к таблицам очередей возможен через procfs (файл &lt;tt&gt;/proc/net/ipt_hashlimit/имя_таблицы&lt;/tt&gt;). Подробнее о формате этого файла можно почитать [http://www.opennet.ru/base/net/iptables_tbf.txt.html здесь], однако учтите, что большая часть сведений, приведенных в указанной статье, устарела.

Критерий haslimit также имеет ряд параметров, не описанных здесь (максимальный размер таблицы, время жизни записи в таблице, интервал [[w:Сборка мусора (программирование)|«сбора мусора»]], и т. п.). За подробными сведениями обратитесь к документации.

* '''connlimit''' — позволяет ограничивать количество одновременно открытых соединений с каждого IP-адреса (или подсети). Параметры:

&lt;tt&gt;[!] --connlimit-above количество&lt;/tt&gt; — минимальное количество соединений. Все пакеты, проходящие по соединениям, установленным сверх заданного количества, считаются удовлетворяющими критерию. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -p tcp --dport 80 -m connlimit --connlimit-above 3 -j DROP
iptables -A INPUT -p tcp --dport 80 -j ACCEPT
&lt;/syntaxhighlight&gt;
разрешит не более трех одновременных соединений к нашему веб-серверу с одного IP-адреса. Аналогичного эффекта можно добиться командами
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -p tcp --dport 80 -m connlimit ! --connlimit-above 3 -j ACCEPT
iptables -A INPUT -p tcp --dport 80 -j DROP
&lt;/syntaxhighlight&gt;

&lt;tt&gt;--connlimit-mask&lt;/tt&gt; — маска подсети, для которой устанавливается общее ограничение на количество соединений. Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -p tcp --dport 80 -m connlimit --connlimit-above 5 --connlimit-mask 24 -j DROP
iptables -A INPUT -p tcp --dport 80 -j ACCEPT
&lt;/syntaxhighlight&gt;
разрешит не более пяти одновременных соединений на порт 80 с каждой подсети [[w:Бесклассовая адресация|класса 1C]].

Не надо путать connlimit с hashlimit — hashlimit позволяет ограничить ''скорость'' поступления пакетов с хостов или подсетей (в сочетании с &lt;tt&gt;-m conntrack --ctstate NEW&lt;/tt&gt; — скорость открытия новых соединений), а connlimit — ''количество'' одновременно открытых соединений.

* '''connbytes''' — позволяет ограничивать количество переданных байт или пакетов. Параметры:

&lt;tt&gt;[!] --connbytes ''мин'':[''макс'']&lt;/tt&gt; — собственно задает количество пакетов или байт. Можно указать просто минимальное количество или диапазон.

&lt;tt&gt;--connbytes-dir {original|reply|both}&lt;/tt&gt; — задает направление движения пакетов. Проверяются только пакеты, движущиеся от инициатора соединения к отвечающему (original), наоборот (reply) или в обоих направлениях (both).

&lt;tt&gt;--connbytes-mode {packets|bytes|avgpkt}&lt;/tt&gt; — задает собственно учитываемую величину: количество пакетов (packets), количество байт (bytes) или средний размер пакета (avgpkt).

Пример:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
# Для соединений, по которым передано более 500 КБ, ставим минимальный приоритет TOS (требование максимальной полосы)
iptables -t mangle -I INPUT -m connbytes --connbytes 512000: --connbytes-dir both --connbytes-mode bytes -j TOS --set-tos Maximize-Throughput
iptables -t mangle -I OUTPUT -m connbytes --connbytes 512000: --connbytes-dir both --connbytes-mode bytes -j TOS --set-tos Maximize-Throughput
# Для соединений, по которым передано менее 50 КБ, ставим максимальный приоритет TOS (требование минимальной задержки)
iptables -t mangle -I INPUT -m connbytes ! --connbytes 51200: --connbytes-dir both --connbytes-mode bytes -j TOS --set-tos Minimize-Delay
iptables -t mangle -I OUTPUT -m connbytes ! --connbytes 51200: --connbytes-dir both --connbytes-mode bytes -j TOS --set-tos Minimize-Delay
&lt;/syntaxhighlight&gt;
Таким образом, все пакеты, принадлежащие «легким» соединениям, будут маркироваться как наиболее приоритетные, а пакеты, проходящие по «тяжеловесным» соединениям — как наименее приоритетные. Такой подход позволит рационально распределять канал между различными задачами, например, просмотром веб-страниц («легкие» соединения) и скачиванием файлов («тяжелые» соединения).

Конечно, при таком подходе даже «тяжелые» соединения будут занимать канал с наивысшим приоритетом, пока не превысят ограничение. Но даже на медленных соединениях (128 Кбит/с) для этого достаточно всего четырех секунд (если эта закачка в данный момент единственная). После превышения лимита 50 Кбайт соединение получит средний приоритет ([[w:Тип обслуживания|TOS]] не установлен), а еще через некоторое время соединение превысит второй лимит — 500 Кбайт, и получит минимальный приоритет. В то же время, «легкие» соединения в большинстве случаев не превышают даже первого лимита, и поэтому целиком проходят с повышенным приоритетом.

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

&lt;tt&gt;--quota количество_байт&lt;/tt&gt; — собственно задает квоту.

Для каждого правила, содержащего такой критерий, создается счетчик, который уменьшается с каждым прошедшим по этому правилу пакетом на количество байт, равное размеру этого пакета. Когда значение счетчика доходит до нуля, правило перестает срабатывать. Чтобы восстановить счетчик, удалите правило и добавьте его снова.

Например:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
sysctl net.ipv4.ip_forward=1 # Разрешаем шлюзу передавать транзитный трафик
iptables -F FORWARD # Очищаем цепочку FORWARD
iptables -A FORWARD -m quota --quota 1073741824 -j ACCEPT
iptables -P FORWARD DROP
&lt;/syntaxhighlight&gt;
разрешает хосту передавать не более одного гигабайта транзитного трафика (учитывается трафик в обоих направлениях).

* '''quota2''' — критерий из уже упоминавшегося набора xtables-addons. Является результатом развития идей, заложенных в критерии quota. Позволяет создавать именованные счетчики квот (для совместного использования одного счетчика в нескольких правилах), считать не только байты, но и пакеты, а также создавать отдельные правила для пакетов, превышающих квоту (логическая инверсия параметра &lt;tt&gt;--quota&lt;/tt&gt;). Поддерживаются следующие параметры:

&lt;tt&gt;--name ''имя''&lt;/tt&gt; — задает имя счетчика. Текущее значение счетчика содержится в файле &lt;tt&gt;/proc/net/xt_quota/''имя''&lt;/tt&gt;. Его можно вывести на экран
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
cat /proc/net/xt_quota/имя
&lt;/syntaxhighlight&gt;
или задать вручную
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
echo значение &gt; /proc/net/xt_quota/имя
&lt;/syntaxhighlight&gt;
Для осуществления этих действий, как и для работы с iptables, нужны полномочия [[w:Root|суперпользователя]].

&lt;tt&gt;[!] --quota ''количество''&lt;/tt&gt; — проверяет текущее значение счетчика и уменьшает его на размер текущего пакета. Этот же параметр задает начальное значение счетчика (если счетчик с таким именем уже существует, он не сбрасывается). Пакет считается подпадающим под критерий, если счетчик еще не дошел до нуля (при указании логической инверсии — наоборот). Если немного усложнить наш предыдущий пример,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
sysctl net.ipv4.ip_forward=1 # Разрешаем шлюзу передавать транзитный трафик
iptables -F FORWARD # Очищаем цепочку FORWARD
# Устанавливаем квоту для первой подсети
iptables -A FORWARD -s 192.168.1.0/24 -m quota2 --name first --quota 1073741824 -j ACCEPT
# Для тех, кто идет из первой подсети сверх квоты - блокируем и сообщаем об отказе.
# Кстати, счетчик first уже создан, поэтому теперь в параметре quota можно писать любое число. Но мы все-таки напишем 1 Гб.
iptables -A FORWARD -s 192.168.1.0/24 -m quota2 --name first ! --quota 1073741824 -j REJECT
# Устанавливаем квоту для второй подсети
iptables -A FORWARD -s 192.168.2.0/24 -m quota2 --name second --quota 536870912 -j ACCEPT
iptables -P FORWARD DROP
&lt;/syntaxhighlight&gt;
Теперь для подсети 192.168.1.0/24 установлена квота в 1 Гб, и при превышении этой квоты пакеты блокируются, причем их отправителям хост отвечает пакетами icmp-port-unreachable, уведомляя их, что передача данных заблокирована. Для подсети 192.168.2.0/24 устанавливается квота 512 Мб, и при ее превышении никаких сообщений не посылается (пакеты блокируются «молча»). Так же молча блокируются транзитные пакеты из всех остальных подсетей.

&lt;tt&gt;--packets&lt;/tt&gt; — при указании этого параметра счетчик учитывает количество пакетов, а не их суммарный размер.

&lt;tt&gt;--grow&lt;/tt&gt; — ''увеличивает'' счетчик, вместо того, чтобы уменьшать его. Критерий с этим параметром всегда возвращает истину. Позволяет создавать счетчики «приходно-расходного типа». Например,
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
-A INPUT -p tcp --dport 6881 -m quota2 --name bt --grow
-A OUTPUT -p tcp --sport 6881 -m quota2 --name bt
&lt;/syntaxhighlight&gt;
позволяет в любой момент определять разность сумм входящих (на TCP-порт [[BitTorrent|6881]]) и исходящих (с этого же порта) байт через файл &lt;tt&gt;/proc/net/xt_quota/bt&lt;/tt&gt;.

Вот [http://jengelh.medozas.de/2009/0717-bandwidth-monitoring.php еще один пример] использования этого критерия для сбора статистики по трафику.

Обратите внимание, что при указании параметра grow критерий quota2 ''всегда'' будет возвращать истину. Действие для такого правила обычно назначать не имеет смысла — правило изменяет только счетчик квоты, а не сам пакет.

* '''length''' — позволяет использовать в качестве критерия размер пакета. Проверятся размер пакета протокола транспортного уровня ({{w |TCP}}, {{w |UDP}}, {{w |SCTP}}, {{w |DCCP}} и т. д.) или, иначе говоря, размер пакета протокола сетевого уровня ({{w |IP}}, {{w |IPv6}}) за вычетом размера заголовков сетевого уровня. Данный критерий имеет единственный параметр

&lt;tt&gt;[!] --length ''размер''[:''макс_размер'']&lt;/tt&gt;, который может употребляться в нескольких формах:

: &lt;tt&gt;--length ''размер''&lt;/tt&gt; — пакет проверяется на точное соответствие заданному размеру,

: &lt;tt&gt;--length ''мин_размер'':&lt;/tt&gt; — размер пакета должен быть больше или равен заданной величине,

: &lt;tt&gt;--length :''макс_размер''&lt;/tt&gt; — размер пакета должен быть меньше или равен заданной величине,

: &lt;tt&gt;--length ''мин_размер'':''макс_размер''&lt;/tt&gt; — размер пакета должен попадать в указанный диапазон (включая границы).

Смысл всех приведенных форм может быть заменен на противоположный, как обычно, указанием перед данным параметром восклицательного знака. Все размеры задаются в байтах.

В качестве практического примера использования данного критерия можно рассмотреть установку высокого приоритета [[w:Тип обслуживания|TOS]] (требование минимальной задержки) для небольших транзитных пакетов (размер до 512 байт):
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -t mangle -I INPUT -m length --length :512 -j TOS --set-tos Minimize-Delay
&lt;/syntaxhighlight&gt;

* '''length2''' — расширение критерия length, доступное в наборе xtables-addons. Отличается от классического length возможностью проверять размеры пакетов на различных уровнях [[w:Сетевая модель OSI|модели OSI]]. Принимает следующие опции:

&lt;tt&gt;--layer3&lt;/tt&gt; — проверка размера пакета сетевого уровня (например, IPv4-пакета).

&lt;tt&gt;--layer4&lt;/tt&gt; — проверка размера пакета транспортного уровня (например, TCP-пакета).

&lt;tt&gt;--layer5&lt;/tt&gt; — проверка размера полезной нагрузки транспортного уровня (например, содержимого TCP-пакета, ''не'' учитывая размер заголовков TCP). Работает корректно только для некоторых протоколов транспортного уровня, на момент написания этих строк (конец 2009) поддерживаются: {{w |TCP}}, {{w |UDP}}, [[UDPLite]] ([[:en:UDPLite|en]]), {{w |ICMP}}, {{w |ICMPv6}} ([[:en:ICMPv6|en]]), {{w |DCCP}}, {{w |SCTP}}, {{w |IPSec}} (AH и ESP). Для {{w |SCTP}}-пакета в этот размер включаются все [[:en:SCTP packet structure|секции (chunks)]] вместе с их заголовками.

&lt;tt&gt;--layer7&lt;/tt&gt; — для SCTP проверяется суммарный размер DATA-секций в пакете (то есть его полезная нагрузка), для остальных протоколов аналогично &lt;tt&gt;--layer5&lt;/tt&gt;.

По умолчанию используется &lt;tt&gt;--layer3&lt;/tt&gt;, однако во избежание недоразумений рекомендуется явно указывать одну из перечисленных опций. Если этого не делать, при вводе соответствующей команды появится сообщение
  iptables: length match: Defaulting to --layer3. Consider specifying it explicitly.
Это ''не'' является ошибкой (только предупреждением о возможной неоднозначности). Заданное вами правило должно добавиться успешно.

&lt;tt&gt;[!] --length ''размер''[:''макс_размер'']&lt;/tt&gt; — собственно, задает нужные значения размера. В отличие от аналогичного параметра в классическом критерии length, его синтаксические формы несколько беднее. Допускаются два варианта записи:

: &lt;tt&gt;--length ''размер''&lt;/tt&gt; — пакет проверяется на точное соответствие заданному размеру,

: &lt;tt&gt;--length ''мин_размер'':''макс_размер''&lt;/tt&gt; — размер пакета должен быть попадать в указанный диапазон (включая границы).

Впрочем, недостающие варианты легко выразить через имеющиеся: для имитации &lt;tt&gt;--length :''макс_размер''&lt;/tt&gt; используйте &lt;tt&gt;--length 0:''макс_размер''&lt;/tt&gt;, а вместо &lt;tt&gt;--length ''мин_размер'':&lt;/tt&gt; применяйте &lt;tt&gt;--length ''мин_размер'':65535&lt;/tt&gt;.

Будьте внимательны: в отличие от length, length2 не проверяет взаимное соответствие границ диапазона (&lt;tt&gt;''мин_размер'' &lt;= ''макс_размер''&lt;/tt&gt;), и если вы зададите их неправильно (&lt;tt&gt;''мин_размер'' &gt; ''макс_размер''&lt;/tt&gt;), ваше правило просто никогда не будет срабатывать. &lt;!-- По крайней мере в xtables-addons 1.21 этот баг присутствует. --&gt;

'''Подводя краткий итог по разделу «Лимитирующие критерии»''', хотелось бы заметить, что перечисленные в этом разделе критерии предназначены главным образом для ограничения доступа и защиты от различных атак. Не стоит пытаться ограничивать с их помощью трафик. Для ограничения и приоритизации трафика в [[Linux]] рекомендуется использовать стандартный [[w:Шейпинг (информатика)|шейпер]] ядра, управляемый при помощи утилиты [[w:Iproute2|tc]].
&lt;!-- Если же вам нужно ограничить именно трафик, а не отдельные пакеты или соединения, то рекомендуем использовать для этого [[w:Шейпинг (информатика)|шейпер]]. Управление шейпером ядра Linux производится при помощи утилиты [[w:Iproute2|tc]]. Впрочем, этот шейпер позволяет эффективно управлять лишь исходящим трафиком.--&gt;

==== Критерий recent ====
recent — это специальный критерий, позволяющий запоминать проходящие через него пакеты, а затем использовать полученную информацию для принятия решений. Ввиду его уникальности, широких возможностей и, как следствие, некоторых трудностей в понимании новичками принципов его использования, рассказ о нем был вынесен в отдельный подраздел.

Если быть точным, recent запоминает не сами пакеты, а их количество, время поступления, адрес источника (в последних версиях iptables также может запоминать и адрес назначения), а также, при необходимости, [[w:Time to live|TTL]].

В начале кратко рассмотрим его опции:

&lt;tt&gt;[!] --set&lt;/tt&gt; — запомнить адрес источника/назначения пакета (внести его во внутренний список). Если такая запись уже присутствует в списке — обновить время последнего доступа для нее. Обратите внимание, что критерию recent с опцией &lt;tt&gt;--set&lt;/tt&gt; удовлетворяют ''все'' пакеты. Чтобы ему не удовлетворял ни один пакет — используйте логическую инверсию (&lt;tt&gt;! --set&lt;/tt&gt;).

&lt;tt&gt;[!] --rcheck&lt;/tt&gt; — позволяет проверить, присутствует ли адрес источника/назначения пакета во внутреннем списке. Критерий recent с этой опцией вернет истину, если адрес в списке присутствует.

&lt;tt&gt;[!] --update&lt;/tt&gt; — работает аналогично &lt;tt&gt;--rcheck&lt;/tt&gt;, но еще и обновляет время последнего доступа для данной записи.

&lt;tt&gt;[!] --remove&lt;/tt&gt; — работает аналогично &lt;tt&gt;--rcheck&lt;/tt&gt;, но еще и удаляет найденную запись из списка. Если запись не найдена, пакет считается ''не'' соответствующим критерию.

&lt;tt&gt;--seconds ''число''&lt;/tt&gt; — дополнительная опция в режимах &lt;tt&gt;--rcheck&lt;/tt&gt; и &lt;tt&gt;--update&lt;/tt&gt;. Пакет считается соответствующим критерию, только если последний доступ к записи был не позднее, чем ''число'' секунд назад.

&lt;tt&gt;--hitcount ''число''&lt;/tt&gt; — дополнительная опция в режимах &lt;tt&gt;--rcheck&lt;/tt&gt; и &lt;tt&gt;--update&lt;/tt&gt;. Пакет считается удовлетворяющим критерию, если было не менее ''число'' обращений к данной записи. Обычно используется вместе с &lt;tt&gt;--seconds&lt;/tt&gt; — тогда критерий имеет смысл «не менее n обращений за последние m секунд».

Заметим, что, хотя в официальной документации для параметров &lt;tt&gt;--seconds&lt;/tt&gt; и &lt;tt&gt;--hitcount&lt;/tt&gt; указывается возможность отрицания (указания перед ними восклицательного знака), на самом деле такое отрицание никак не обрабатывается в коде и не меняет смысла параметров, так что указывать его бессмысленно. Эта ошибка в документации исправлена в версии iptables 1.4.7.

&lt;tt&gt;--rttl&lt;/tt&gt; — дополнительно к адресу источника/назначения, заносить в список и проверять еще и [[w:Time to live|TTL]] пакета.

&lt;tt&gt;--rsource&lt;/tt&gt; — эта опция появилась в последних версиях iptables, с тех пор, как критерий recent начал поддерживать запоминание адресов не только источника, но и назначения. Позволяет явно указать, что в список вносится именно адрес источника пакета. Однако в целях обратной совместимости этот режим используется по умолчанию, и поэтому указывать данную опцию не обязательно.

&lt;tt&gt;--rdest&lt;/tt&gt; — эта опция появилась в последних версиях iptables. Позволяет явно указать, что в список вносится именно адрес назначения пакета.

&lt;tt&gt;--name ''имя''&lt;/tt&gt; — позволяет указать имя списка при использовании нескольких списков. По умолчанию используется список DEFAULT. Каждый список представлен псевдофайлом &lt;tt&gt;/proc/net/xt_recent/''имя''&lt;/tt&gt; (на старых ядрах критерий recent реализован только для {{w |IPv4}}, но не для {{w |IPv6}}, поэтому вместо &lt;tt&gt;xt_recent&lt;/tt&gt; будет &lt;tt&gt;ipt_recent&lt;/tt&gt;). В частности, вы можете:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
cat /proc/net/xt_recent/имя # вывести список на экран
echo +адрес &gt; /proc/net/xt_recent/имя # добавить адрес в список
echo -адрес &gt; /proc/net/xt_recent/имя # удалить адрес из списка
echo / &gt; /proc/net/xt_recent/имя # очистить список
&lt;/syntaxhighlight&gt;

Теперь давайте рассмотрим несколько примеров.
* Блокирование {{w |bruteforce}}-атак (подбор пароля вслепую) на {{w |SSH}} и аналогичные сервисы.
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -N ssh_brute_check # Создаем цепочку для проверки попыток соединений на защищаемый порт
# Если за последние 10 минут (600 секунд) с одного адреса было 3 или более новых соединений — блокируем этот адрес
iptables -A ssh_brute_check -m conntrack --ctstate NEW -m recent --update --seconds 600 --hitcount 3 -j DROP
# В противном случае — разрешаем, и при этом заносим в список
iptables -A ssh_brute_check -m recent --set -j ACCEPT
iptables -F INPUT # Очищаем цепочку INPUT
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT # Разрешаем пакеты по установленным соединениям
# Все попытки открыть новое соединение по SSH направляем на проверку
iptables -A INPUT -m conntrack --ctstate NEW -p tcp --dport 22 -j ssh_brute_check
# Здесь можно разрешать те порты, для которых такая проверка не нужна. Например, HTTP
iptables -A INPUT -m conntrack --ctstate NEW -p tcp --dport 80 -j ACCEPT
iptables -P INPUT DROP # Что не разрешено — то запрещено
&lt;/syntaxhighlight&gt;
Теперь все попытки открыть новое SSH-соединение проверяются, и с одного {{w |IP-адрес}}а можно открывать не более 2 соединений за 10 минут. Обратите внимание, что за одно соединение злоумышленник может проверить несколько паролей — число попыток аутентификации до обрыва соединения задает параметр MaxAuthTries в файле &lt;tt&gt;/etc/ssh/sshd_config&lt;/tt&gt;. По умолчанию это число равно 6, так что в нашем примере злоумышленник сможет проверять не более 12 паролей за 10 минут.

Впрочем, данный пример весьма тривиален, и сходную функциональность можно получить и при помощи критерия hashlimit:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -A INPUT -m conntrack --ctstate NEW -p tcp --dport 22 -m hashlimit --hashlimit-mode srcip --hashlimit-upto 5/hour --hashlimit-name ssh -j ACCEPT
&lt;/syntaxhighlight&gt;
разрешит не более 5 новых соединений в час.
Данная реализация имеет недостаток по сравнению с recent — вы не можете произвольно задавать временной период.

* Защита от сканирования портов (заметим, что кроме критерия recent для этой задачи можно также использовать критерии psd и lscan из комплекта xtables-addons).
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -F INPUT # Очищаем цепочку INPUT
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT # Разрешаем пакеты по установленным соединениям
# Если за последний час было 10 или более запросов на нерабочие порты — блокируем
iptables -A INPUT -m recent --rcheck --seconds 3600 --hitcount 10 --rttl -j RETURN
# Если за последнюю минуту было 2 или более запросов на нерабочие порты — блокируем
iptables -A INPUT -m recent --rcheck --seconds 60 --hitcount 2 --rttl -j RETURN
# Разрешаем рабочие порты
iptables -A INPUT -m conntrack --ctstate NEW -p tcp -m multiport --dport 21,25,53,80,110 -j ACCEPT
iptables -A INPUT -m conntrack --ctstate NEW -p udp -m multiport --dport 53,123 -j ACCEPT
# Всех, кто ломится в нерабочие порты — регистрируем
iptables -A INPUT -m recent --set
iptables -P INPUT DROP # Что не разрешено — то запрещено
&lt;/syntaxhighlight&gt;
Все пакеты, попадающие на нерабочие порты сервера, регистрируются. После нескольких таких попыток за заданный интервал времени адрес их источника блокируется. Проверка TTL добавлена для защиты от блокировки легитимных клиентов после спуфинга злоумышленником от их имени. Хотя, с другой стороны, эта мера позволяет ему обойти защиту от сканирования, выставляя своим пакетам различный TTL. Так что вопрос о нужности этой проверки в вашем конкретном случае вам придется решать самостоятельно.

Другой пример использования критерия recent для детекции и блокирования сканирования портов:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
# Создаем цепочку для проверки и блокирования портсканов
iptables -N portscan_check
# Блокируем тех, кто был уличен в портскане в течение последних суток
iptables -A portscan_check -m recent --name portscan --rcheck --seconds 86400 -j DROP
# По прошествии суток можно удалять их из списка
iptables -A portscan_check -m recent --name portscan --remove
# Ну а сейчас — собственно процедура определения портскана
iptables -A portscan_check -p tcp --dport 139 -m recent --name portscan --set -j DROP
# Пускаем на проверку всех, кто пришел к нам из интернета (интерфейс eth0)
iptables -I INPUT -i eth0 -j portscan_check
&lt;/syntaxhighlight&gt;
В данном случае сканированием портов считается обращение на порт 139/tcp ({{w |SMB}}). Впрочем, вы можете задать другой порт или, используя критерий multiport, даже список портов. В отличие от предыдущего примера, здесь производится автоматическая очистка списка {{w |IP-адрес}}ов: по прошествии суток с момента блокировки, первое же обращение с заблокированного адреса на наш сервер приводит к удалению этого адреса из нашего recent-списка. Однако, если это обращение вновь является попыткой сканирования портов, то есть направлено на порт 139/tcp, адрес тут же блокируется вновь. Именно поэтому процедура блокировки расположена «ниже по течению», чем процедура удаления адреса из списка.

Для предыдущего примера реализация очистки списка адресов достигается следующим образом:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
# Создаем цепочку для проверки на необходимость удаления
iptables -N recent_remove
# Последнее обращение на неиспользуемые порты было менее суток назад
# поэтому оставим-ка пока этот адресок в черном списке
iptables -A recent_remove -m recent --rcheck --seconds 86400 -j RETURN
# Если адрес в есть в списке — удаляем его оттуда
iptables -A recent_remove -m recent --remove
# Вставляем эту проверку вторым правилом (сразу после проверки ctstate)
iptables -I INPUT 2 -j recent_remove
&lt;/syntaxhighlight&gt;

Проводя аналогию с ныне почившим проектом [http://www.opennet.ru/docs/RUS/portsentry/portsentry-security.html.gz PortSentry], первый наш пример соответствует режиму PortSentry «Advanced Stealth Scan Detection», а второй — «Enhanced Stealth Scan Detection». (Правда, заметим, что в режиме Advanced Stealth Scan Detection блокировка производится после ''первого'' попадания пакета на нерабочий порт — для достижения такого же эффекта в нашем примере достаточно выкинуть проверки на seconds и hitcount из блокирующих правил.) Однако, использование iptables/recent имеет значительное преимущество перед примитивными userspace-системами наподобие PortSentry — возможность интеграции с системой [[conntrack]], что позволяет избежать ошибочной блокировки, например, при использовании высоких портов для {{w |NAT}}.

* Открытие порта «по стуку».

Port knocking — метод защиты портов, при котором доступ к определенному порту с отдельно взятого IP-адреса открывается после серии пакетов на заданную последовательность портов с заданными интервалами. &lt;!-- Обычно эта задача решается демоном [[knockd]]. Также сходной функциональностью обладает критерий [http://www.netfilter.org/projects/patch-o-matic/pom-external.html#pom-external-pknock pknock] из [http://www.netfilter.org/projects/patch-o-matic/pom-external.htm patch-o-matic-ng], однако он, к сожалению, потерял разработчика и прекратил развиваться.--&gt; Обычно эта задача решается при помощи демона [[knockd]] либо критерия pknock из комплекта xtables-addons.

Несколько самых простых вариантов такой защиты можно организовать и средствами критерия recent.

Самое простое — открывать порт ssh (22) после стука в заданный высокий порт:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -N ssh_knock # Создаем цепочку для проверки попыток соединений на защищаемый порт
# Если за последние 60 секунд было 2 и более стука — блокируем, на всякий случай
iptables -A ssh_knock -m recent --rcheck --seconds 60 --hitcount 2 -j RETURN
# Если за последние 10 секунд стук в нужный порт был — разрешить соединение
iptables -A ssh_knock -m recent --rcheck --seconds 10 -j ACCEPT
iptables -F INPUT # Очищаем цепочку INPUT
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT # Разрешаем пакеты по установленным соединениям
# Все попытки открыть новое соединение по SSH направляем на проверку
iptables -A INPUT -m conntrack --ctstate NEW -p tcp --dport 22 -j ssh_knock
# Здесь мы добавляем правило для регистрации стука
iptables -A INPUT -m conntrack --ctstate NEW -p tcp --dport 27520 -m recent --set
# Опять же на всякий случай — при стуке в соседние порты закрываем SSH
iptables -A INPUT -m conntrack --ctstate NEW -p tcp -m multiport --dport 27519,27521 -m recent --remove
iptables -P INPUT DROP # Что не разрешено — то запрещено
&lt;/syntaxhighlight&gt;
Даже в таком простом примере присутствуют жесткие меры защиты: защищаемый порт (22) открывается на 10 секунд после стука в заданный порт (27520), при этом более одного стука в этот порт в течение минуты считается ошибкой. Также стук в соседние с заданным порты сразу закрывает защищаемый порт. Это делается в целях защиты от подбора стука.

Если вам не интересны такие параноидальные меры безопасности, то обратите внимание на этот простой пример:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -N ssh_knock # Создаем цепочку для проверки
# Если за последние 10 минут было 5 и более попыток соединения — блокируем
iptables -A ssh_knock -m recent --name ssh --update --seconds 600 --hitcount 5 -j RETURN
# Регистрируем
iptables -A ssh_knock -m recent --name ssh --set
# Если за последние 5 секунд было менее двух попыток — блокируем
iptables -A ssh_knock -m recent --name ssh ! --rcheck --seconds 5 --hitcount 2 -j RETURN
# Все остальное — разрешаем
iptables -A ssh_knock -j ACCEPT
iptables -F INPUT # Очищаем цепочку INPUT
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT # Разрешаем пакеты по установленным соединениям
# Все попытки открыть новое соединение по SSH направляем на проверку
iptables -A INPUT -m conntrack --ctstate NEW -p tcp --dport 22 -j ssh_knock
iptables -P INPUT DROP # Что не разрешено — то запрещено
&lt;/syntaxhighlight&gt;
Идея метода проста: защищаемый порт открывается со второй попытки, то есть стук идет непосредственно в него. Вторую попытку нужно сделать в течение 5 секунд после первой. При этом 5 и более попыток за десять минут блокируются (во избежание брутфорса).

Также можно организовать защиту через стук в серию портов:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iptables -N reset_knock # Цепочка для сброса процесса стука
iptables -A reset_knock -m recent --name PHASE1 --remove
iptables -A reset_knock -m recent --name PHASE2 --remove
iptables -A reset_knock -m recent --name PHASE3 --remove
iptables -A reset_knock -m recent --name PHASE4 --remove
iptables -N in_phase_2 # Создаем цепочку для фазы 2
iptables -A in_phase_2 -m recent --name PHASE1 --remove # Удаляем запись из списка первой фазы
iptables -A in_phase_2 -m recent --name PHASE2 --set # Добавляем ее в список второй фазы
iptables -N in_phase_3 # Создаем цепочку для фазы 3
iptables -A in_phase_3 -m recent --name PHASE2 --remove # Удаляем запись из списка второй фазы
iptables -A in_phase_3 -m recent --name PHASE3 --set # Добавляем ее в список третьей фазы
iptables -N in_phase_4 # Создаем цепочку для фазы 4
iptables -A in_phase_4 -m recent --name PHASE3 --remove # Удаляем запись из списка третьей фазы
iptables -A in_phase_4 -m recent --name PHASE4 --set # Добавляем ее в список четвертой фазы
iptables -N checked # Для записей, прошедших проверку
iptables -A checked -j reset_knock # Очищаем списки
iptables -A checked -j ACCEPT # Разрешаем пакет
iptables -F INPUT # Очищаем цепочку INPUT
iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT # Разрешаем пакеты по установленным соединениям
# Первая фаза
iptables -A INPUT -p tcp --dport 21210 -m recent --name PHASE1 --set -j RETURN
# Для тех, кто присутствует в списке первой фазы — переход во вторую
iptables -A INPUT -p tcp --dport 11992 -m recent --rcheck --name PHASE1 --seconds 5 -g in_phase_2
# И т.д.
iptables -A INPUT -p tcp --dport 16043 -m recent --rcheck --name PHASE2 --seconds 5 -g in_phase_3
iptables -A INPUT -p tcp --dport 23050 -m recent --rcheck --name PHASE3 --seconds 5 -g in_phase_4
# Если стучатся не в том порядке — сброс
iptables -A INPUT -p tcp -m multiport --dport 21210,11992,16043,23050 -j reset_knock
# Для тех, кто прошел все четыре фазы — разрешаем доступ
iptables -A INPUT -p tcp --dport 22 -m conntrack --ctstate NEW -m recent --rcheck --name PHASE4 --seconds 5 -j checked
iptables -P INPUT DROP # Дефолтное правило цепочки INPUT
&lt;/syntaxhighlight&gt;
Принцип прост — при стуке в порт, соответствующий очередной фазе, проверяется наличие записи в предыдущей фазе. Теперь порт 22 откроется на 5 секунд после стука в порты 21210, 11992, 16043, 23050 со строгим соблюдением порядка перечисления и интервалами не более 5 секунд.

Обратите внимание на технику реализации процесса — цепочки фаз вызываются не через &lt;tt&gt;-j&lt;/tt&gt;, а через &lt;tt&gt;-g&lt;/tt&gt;, поэтому после прохождения этих цепочек к пакетам сразу применяется правило по умолчанию цепочки INPUT, то есть DROP. В противном случае пакеты доходили бы до правила сброса (которое с multiport), и процесс стука все время сбрасывался бы.

Последовательный стук в порты можно организовать, например, утилитой {{w |netcat}}
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
for it in {21210,11992,16043,23050}; do
    echo &quot; &quot; | nc -w 1 host $it
done
ssh user@host
&lt;/syntaxhighlight&gt;

Другие примеры реализации port knocking’а при помощи критерия recent можно посмотреть на [http://wiki.opennet.ru/Iptables_-m_recent OpenNet wiki], [http://www.debian-administration.org/articles/268 debian-administration.org], [http://silverghost.org.ua/2007/06/13/ssh-portknocking/ silverghost.org.ua], [http://www.opennet.ru/openforum/vsluhforumID3/41732.html#32 форуме OpenNet].

==== Критерий u32 ====
Данный критерий предоставляет очень гибкий инструмент, позволяющий производить сложные операции по анализу содержимого пакета. Алгоритм обработки содержимого исследуемого пакета задается на специальном [[Язык программирования|языке программирования]], своеобразном «[[w:Язык ассемблера|ассемблере]]». Такой подход позволяет получить огромную гибкость, но при этом его изучение и использование может представлять определенные трудности для пользователей, не знакомых с основами [[Программирование|программирования]] и принципами работы [[Машина Тьюринга|машины Тьюринга]].

Этот критерий имеет единственный параметр — &lt;tt&gt;[!] --u32&lt;/tt&gt;, после которого в двойных кавычках записывается текст «программы». Если все проверки, заданные в программе, дают истинный результат, пакет считается удовлетворяющим данному критерию. Традиционно, если перед параметром указан восклицательный знак, означающий логическое отрицание, то удовлетворяющими критерию считаются только те пакеты, для которых хотя бы одна проверка дала ложный результат.

Ключевые операторы языка критерия u32:
* '''=''' — оператор сравнения. Собственно, на его основе и формируются все производимые проверки. Синтаксис его вполне очевиден: &lt;tt&gt;выражение = значение&lt;/tt&gt;. В качестве значения можно использовать одно число, диапазон (в формате &lt;tt&gt;мин:макс&lt;/tt&gt;) или список чисел и/или диапазонов разделенных запятой (например, &lt;tt&gt;1,3:5,8,11:14&lt;/tt&gt;). В одном списке можно указывать не более 10 чисел/диапазонов.
* '''&amp;&amp;''' — оператор логического И, объединяющий все производимые в программе проверки. В одном критерии u32 можно указывать не более 10 таких проверок. Обратите внимание, что операция логического ИЛИ отсутствует, так как это противоречит идеологии iptables (в каждом правиле все проверки объединяются логическим И, а логическое ИЛИ объединяет правила в одной цепочке).
* '''&amp;''' — оператор побитового логического И, позволяющий применить к обрабатываемому значению битовую маску.
* '''«''' и '''»''' — операторы побитового сдвига влево и вправо соответственно. Эквивалентны домножению или делению обрабатываемого значения на 2 в соответствующей степени. Обратите внимание, что в одном выражении для проверки можно использовать не более 9 операторов &amp;, &lt;&lt; и &gt;&gt;.
* '''@''' — оператор задания смещения. Добавляет результат предыдущего выражения к текущему значению начального смещения (в начале работы программы, до выполнения @-операций, начальное смещение считается нулевым). Очень полезен в тех случаях, когда нужно сместиться на некоторое значение, полученное в результате обработки пакета, например, узнав после некоторых вычислений длину IP-заголовка, мы можем сместиться на данные непосредственно после него, то есть на начало полезной нагрузки IP-пакета (как правило, там находится заголовок [[w:Транспортный уровень|транспортного уровня]]).

Все операторы имеют равный приоритет, исполнение операций всегда происходит слева направо.

Обратите внимание, что программа рассматривает все значения как целые беззнаковые величины, заданные 32 битами, или четырьмя октетами (что соответствует значениям от 0 до 4294967295). Именно поэтому критерий имеет такое название (u32 — unsigned 32-bit).

Другой не вполне очевидный момент — синтаксис операторов =, &amp;, &lt;&lt; и &gt;&gt;. Дело в том, что в качестве первого операнда указывается не само значение, а его ''адрес'' в пределах пакета, заданный смещением в байтах от текущего начального смещения. Например, &lt;tt&gt;8 = 0x12345678&lt;/tt&gt; означает, что нужно взять четыре байта, начиная с восьмого (обратите внимание, что нумерация байтов в пакете начинается с нуля), то есть байты 8, 9, 10 и 11, и сравнить полученное значение с шестнадцатеричным числом 0x12345678. Как уже говорилось, критерий u32 ''всегда'' манипулирует блоками по четыре байта, поэтому, если вас интересуют блоки меньшего размера, используйте оператор &amp; и маску, например, &lt;tt&gt;8 &amp; 0xFF = 0x78&lt;/tt&gt; позволяет проверить только последний в блоке (11-й от начального смещения) байт. Также можно использовать и оператор смещения, например, &lt;tt&gt;8 &gt;&gt; 24 = 0x12&lt;/tt&gt; возьмет первый в блоке (8-й от начального смещения) байт и сравнит его с числом 0x12. Более подробно о битовых операциях можно почитать в [[w:Битовые операции|соответствующей статье]].

Рассмотрим возможности критерия u32 на нескольких простых примерах из официальной документации:
* Проверить, превышает ли длина пакета величину 256 байт: &lt;tt&gt;--u32 &quot;0 &amp; 0xFFFF = 0x100:0xFFFF&quot;&lt;/tt&gt;.
Эта программа предписывает взять четыре байта, начиная с нулевого, затем занулить первые два байта (в них [[w:IP#Пакет (датаграмма)|содержится]] информация о версии протокола, длине заголовка и [[w:Тип обслуживания|типе обслуживания]], которая нас сейчас не интересует), и проверить значение, формируемого оставшимися двумя байтами (это и есть полная длина пакета в байтах) на принадлежность диапазону от 0x100 (256 в десятичном счислении) до 0xFFFF (65535, максимально возможная длина пакета).
* Проверить, является ли данный пакет {{w |ICMP}}-пакетом с типом 0 (эхо-ответ). Учитывая переменную длину IP-заголовка, эта проверка требует несколько большего количества операций: &lt;tt&gt;--u32 &quot;6 &amp; 0xFF = 1 &amp;&amp; 4 &amp; 0x3FFF = 0 &amp;&amp; 0 &gt;&gt; 22 &amp; 0x3C @ 0 &gt;&gt; 24 = 0&quot;&lt;/tt&gt;
Рассмотрим эти операции последовательно:
:* '''6 &amp; 0xFF = 1''' — проверка кода протокола. Код протокола хранится в 9-м (считая с нуля) байте IPv4-заголовка. Чтобы получить это значение, мы берем 4-х байтовый блок с шестого по девятый байт, а затем при помощи маски выделяем последний, интересующий нас байт в это блоке, и сравниваем его с единицей (код протокола ICMP).
:* '''4 &amp; 0x3FFF = 0''' — проверка, не является ли наш пакет фрагментом. Фрагменты ICMP-пакетов не содержат ICMP-заголовка, в котором должен храниться тип ICMP, поэтому для них дальнейшая проверка не имеет смысла. Пользуясь описанным выше принципом, наша программа выделяет последние 14 бит в блоке с 4-го по 7-й байт, и сравнивает полученное значение с нулем. Строго говоря, для наших целей достаточно было бы и 13 бит (маска 0x1FFF), выделяющих только поле смещения фрагмента (fragment offset, оно должно быть равным нулю для первого пакета в цепочке фрагментов), а использование 14 бит, как это сделано в примере из официальной документации, также захватит и флаг MF (more fragments), что отсечет вообще все фрагментированные пакеты, даже те, которые являются первыми в последовательности и содержат все нужные нам заголовки.
:* '''0 &gt;&gt; 22 &amp; 0x3C @''' — определение длины IP-заголовка в байтах. Последние четыре бита в первом байте IP-пакета показывают длину IP-заголовка в блоках по четыре байта. Смещая это значение на 22 позиции вправо, мы оставляем справа «зазор» в два бита, которые впоследствии зануляем при помощи маски (3C&lt;sub&gt;16&lt;/sub&gt; = 111100&lt;sub&gt;2&lt;/sub&gt;). Также эта маска отсекает лишние биты слева (версия протокола). Полученные два нулевых бита справа соответствуют умножению на четыре, так что в результате мы получаем длину заголовка уже в байтах. Например, если длина IP-заголовка составляет 5 четырехбайтовых блоков (то есть 20 байт), то изначально первый блок заголовка имеет вид &lt;tt&gt;xxxx0101 yyzzzzzz uuuuuuuu uuuuuuuu&lt;/tt&gt; (где биты &lt;tt&gt;xxxx&lt;/tt&gt; задают версию протокола, 0101&lt;sub&gt;2&lt;/sub&gt;=5&lt;sub&gt;10&lt;/sub&gt;­ — собственно длину заголовка, &lt;tt&gt;yyzzzzzz&lt;/tt&gt; — тип обслуживания, а два байта &lt;tt&gt;uuuuuuuu uuuuuuuu&lt;/tt&gt; показывают полную длину пакета вместе с нагрузкой), то после смещения вправо на 22 бита мы получим в этом блоке следующую картину: &lt;tt&gt;00000000 00000000 000000xx xx0101yy&lt;/tt&gt;. После применения маски она пример вид &lt;tt&gt;00000000 00000000 00000000 00010100&lt;/tt&gt;. Полученное число — 10100&lt;sub&gt;2&lt;/sub&gt;=20&lt;sub&gt;10&lt;/sub&gt; и будет равно длине заголовка в байтах. Наконец, оператор @ устанавливает полученное значение в качестве начального смещения, поэтому вся дальнейшая адресация ведется уже начиная с начала ICMP-заголовка, который следует непосредственно после IP-заголовка.
:* '''0 &gt;&gt; 24 = 0''' — выделяет блок с нулевого по третий байт ICMP-заголовка, а затем при помощи смещения (на три байта вправо) оставляет от него только один, нулевой, байт, в котором и хранится тип ICMP. Нас интересует тип 0, поэтому мы и сравниваем этот байт с нулем.
* Проверить, задают ли байты с восьмого по одиннадцатый полезной нагрузки {{w |TCP}}-пакета одно из значений: 1, 2, 5, 8. Достигается следующим кодом: &lt;tt&gt;--u32 &quot;6 &amp; 0xFF = 6 &amp;&amp; 4 &amp; 0x3FFF = 0 &amp;&amp; 0 &gt;&gt; 22 &amp; 0x3C @ 12 &gt;&gt; 26 &amp; 0x3C @ 8 = 1,2,5,8&quot;&lt;/tt&gt;
:* '''6 &amp; 0xFF = 6''' — выделение байта с кодом протокола и сравнение его с кодом 6 (соответствует TCP). Описание этой проверки уже приведено при рассмотрении предыдущего примера.
:* '''4 &amp; 0x3FFF = 0''' — проверка, не является ли данный пакет фрагментом. Полностью аналогична описанной в предыдущем примере.
:* '''0 &gt;&gt; 22 &amp; 0x3C @''' — определение длины IP-заголовка в байтах. Также полностью аналогично описанному в предыдущем примере. После данной операции, начальное смещение указывает на нулевой байт TCP-заголовка.
:* '''12 &gt;&gt; 26 &amp; 0x3C @''' — определение длины TCP-заголовка в байтах. Принцип действия аналогичен предыдущей операции, с тем лишь отличием, что длина TCP-заголовка закодирована в первых четырех битах двенадцатого байта (а не в последних четырех битах нулевого байта, как в случае с IP-заголовком), поэтому необходимое нам смещение вправо составляет уже 26 бит. Как и в предыдущей операции, мы оставляем справа зазор в два бита, которые впоследствии зануляем маской, и таким образом сразу получаем длину заголовка в байтах. Итак, после второго оператора @, начальное смещение будет указывать на начало полезной нагрузки TCP-пакета (следует непосредственно после заголовка).
:* '''8 = 1,2,5,8''' — эта операция сравнения вполне тривиальна: выделяется четырехбайтовый блок, начиная с восьмого байта (разумеется, считая от начала полезной нагрузки), и полученное значение сравнивается с одним из допустимых по условию задачи.

Также, в качестве полезных примеров использования критерия u32, можно упомянуть проверку портов источника и назначения в протоколе [[UDPLite]] ([[:en:UDPLite|en]]): &lt;tt&gt;--u32 &quot;6 &amp; 0xFF = 136 &amp;&amp; 4 &amp; 0x3FFF = 0 &amp;&amp; 0 &gt;&gt; 22 &amp; 0x3C @ 0 &gt;&gt; 16 = исходный_порт&quot;&lt;/tt&gt; и &lt;tt&gt;--u32 &quot;6 &amp; 0xFF = 136 &amp;&amp; 4 &amp; 0x3FFF = 0 &amp;&amp; 0 &gt;&gt; 22 &amp; 0x3C @ 0 &amp; OxFFFF = порт_назначения&quot;&lt;/tt&gt; соответственно (после сказанного выше нетрудно догадаться, что исходный порт указывается в первой паре байт UDPLite-заголовка, а порт назначения — во второй, согласно {{RFC|3828}}).

==== Прочие критерии ====
{{В планах}}

==== Критерии из набора xtables-addons ====
{{В планах}}

== Программы ==

=== Основные ===

==== iptables ====

===== Работа с цепочками =====
  iptables [-t table] -N chain

Создать цепочку

  iptables [-t table] {-F|-L|-Z} [chain [rulenum]] [options...]

* -F — Удалить все правила из цепочки
* -L — Просмотреть цепочку
* -Z — Обнулить счётчики пакетов в цепочке

  iptables [-t table] -P chain target

Установить политику по умолчанию для цепочки

  iptables [-t table] -X {chain}

Удалить цепочку. Внимание! На удаляемую цепочку не должно быть ссылок.

===== Работа с правилами =====
  iptables [-t table] -I chain [rulenum] rule-specification

Вставить правило в начало цепочки (или в позицию rulenum, считая с 1)

  iptables [-t table] -R chain rulenum rule-specification

Заменить правило с номером rulenum на rule-specification

  iptables [-t table] {-A|-C|-D} chain rule-specification

* -A — добавить правило в конец
* -С — проверить, что такое правило есть в таблице
* -D — удалить правило по описанию или по rulenum

===== Вывод информации =====
Скрипты, которые удобно использовать для вывода информации о правилах.

'''1. Скрипт - показать DNAT (show-dnat.sh)'''
  #!/bin/bash
  clear &amp; \
  iptables --line-numbers -nv -t nat -L PREROUTING | \
  cut -b72-89,120- | \
  awk 'NR&lt;3{print $0;next}{print $0| &quot;sort -r&quot;}'

''Пример вывода''
  destination
  111.239.125.50    multiport dports 44123 match-set WL_1CUNIVER src to:192.168.200.21:80
  111.239.125.50    multiport dports 44122 match-set WL_1CUNIVER src to:192.168.1.155:80
  111.234.95.9      multiport dports 22,80 to:192.168.200.24
  111.234.95.8      multiport dports 8443 to:192.168.200.25:8443
  111.234.95.8      multiport dports 8080 to:10.3.10.6:80

'''2. Скрипт показать правила preMANGLE (show-pre-mangle.sh)'''
  #!/bin/bash
  clear &amp; \
  iptables --line-numbers -nv -t mangle -L PREROUTING

''Пример вывода''
  Chain PREROUTING (policy ACCEPT 302M packets, 242G bytes)
  num   pkts bytes target     prot opt in     out     source               destination
  1       75  4124 WWW_SERV   tcp  --  eth2   *       10.192.0.0/14        0.0.0.0/0            multiport dports 80,443 state NEW
  2      678 44648 DROP       all  --  eth2   *       0.0.0.0/0            10.0.0.0/8           connmark match ! 0x210000/0xff0000
  3        0     0 DROP       all  --  eth3   *       0.0.0.0/0            10.0.0.0/8
  4        0     0 DROP       all  --  eth4   *       0.0.0.0/0            10.0.0.0/8
  5    1721K  326M DIVERT     all  --  *      *       0.0.0.0/0            0.0.0.0/0            socket
  6    3675K  224M WWW_SERV   all  --  !eth0  *       0.0.0.0/0            0.0.0.0/0            match-set DNAT dst state NEW
  7      36M   10G LOCAL_WWW  all  --  eth0   *       192.168.0.0/16       0.0.0.0/0
  8     103M   97G LOCAL_WWW  all  --  eth0   *       10.0.0.0/8           0.0.0.0/0

'''3. Скрипт раскрашивает вывод трейсов из syslog  (view-trace.sh)'''
  #!/bin/bash
  # выводит последние N строк из  /var/log/syslog
  
  tail /var/log/syslog -n $1 | cut -d&quot; &quot; -f8-10,12-14,20-22,31 | \
  sed '
  s/raw/\o33[30;47m&amp;\o033[0m/g;
  s/filter/\o33[31m&amp;\o33[0m/g;
  s/mangle/\o33[33m&amp;\o033[0m/g;
  s/nat/\o33[32m&amp;\o033[0m/g;
  s/OUT=/\o033[1m&amp;\o033[0m/g;
  s/IN=/\o33[1m&amp;\o033[0m/g;
  s/PROTO=/\o33[1m&amp;\o033[0m/g;
  s/MARK=/\o33[1m&amp;\o033[0m/g;
  s/DPT=/\o33[1m&amp;\o033[0m/g;
  s/SPT=/\o33[1m&amp;\o033[0m/'
  
''Пример вывода''

==== iptables-save, iptables-restore и iptables-xml ====

==== /etc/init.d/iptables ====

==== iptables-apply ====

==== ipset ====
ipset работает с типами данных, которые представляют собой (man ipset):
* bitmap: ip — список IP адресов из определенной подсети
* bitmap: ip, mac — связки IP+MAC
* bitmap: port — список портов
* hash: ip — произвольный набор IP
* hash: net — произвольный набор сетей
* hash: mac
* hash: net, net
* hash: ip, port
* hash: net, port
* hash: ip, port, ip
* hash: ip, port, net
* hash: ip, mark
* hash: net, port, net
* hash: net, iface
* list: set


Пример правила iptables с применением ipset (man iptables-extensions):
 iptables -I INPUT 1 -i eth0 -p tcp -m tcp --dport 8080 -m set --match-set test123 src  -j ACCEPT

-где test123 это заданное имя сета
 ipset create test123 hash:net

=== Вспомогательные ===

==== Полезные при конфигурировании фаервола ====
&lt;!-- Пожалуй, стоит оформить их просто как список, и не мусорить в оглавлении

===== sysctl =====

===== modprobe =====

===== shell =====

===== ipcalc =====
--&gt;

==== Полезные при тестировании фаервола ====
&lt;!-- Пожалуй, стоит оформить их просто как список, и не мусорить в оглавлении

===== ping =====

===== nmap =====

===== nc и telnet =====

===== netstat и ss =====
--&gt;&lt;blockquote&gt;iptables -L -n -v #Статистика всех правил iptables и счетчики обработанных пакетов&lt;br&gt;
&lt;/blockquote&gt;

== Фронтенды ==

=== С удобным интерфейсом ===

=== С графическим интерфейсомм ===

=== С веб-интерфейсом ===
[http://www.117.su iptadmin] — это пользовательский web интерфейс для iptables, редактор настроек файрволла операционной системы Linux. Реализован в виде отдельного http(s) сервера.

Особенностью программы являются подробные сообщения об ошибках при редактировании правил файрволла.

iptadmin работает на уровне iptables. Настройки файрволла сохраняются в стандартных файлах. В системе не создаются никакие вспомогательные данные. Логика работы спроектирована таким образом, что нарушение целостности конфигурации iptables исключено. Iptadmin можно в любой момент установить или удалить без потери настроек файрволла.

=== Программные интерфейсы ===

== Модули ядра ==

=== Модули conntrack и nat ===

=== Модули критериев и действий ===

== Параметры {{w |sysctl}}/{{w |procfs}} ==

=== Псевдофайлы procfs ===

==== Базовые ====

==== Относящиеся к критериям и действиям ====

=== Основные параметры sysctl ===
ip_forward=1

=== Параметры конфигурации интерфейсов ===

=== Параметры, относящиеся к протоколам ===

==== {{w |TCP}} ====

==== {{w |UDP}} ====

==== {{w |ICMP}} ====

=== Параметры [[conntrack]] ===

== Расширения ==

=== Userspace-компоненты ===

==== NuFW ====

==== l7-filter-userspace ====

==== iplist ====

=== Наборы дополнительных критериев и действий ===

==== Patch-o-Matic ====
Смотри на официальном сайте http://www.netfilter.org/projects/patch-o-matic/pom-external.html

==== Patch-o-Matic-NG ====

==== xtables-addons ====

== Команды ==
Программа позволяет задать правила, которым должны соответствовать проходящие через [[w:Межсетевой экран|брандмауэр]] [[IP-пакет]]ы. Эти правила, как и все настройки [[Linux]], записываются в текстовый файл, находящийся в папке /etc. Последовательность правил называется цепочкой (CHAIN). Для одного и того же сетевого интерфейса используются несколько цепочек. Если проходящий пакет не соответствует ни одному из правил, то выполняется действие по умолчанию.

При вызове, параметром указывается команда, которую нужно выполнить. Обычно можно указать только одну команду (но есть исключения). Команду можно указать одной большой буквой или словом. Если при вызове любой команды не указано название таблицы, то команда выполняется в таблице filter. Программа имеет подробную справку, вызываемую командой ''man iptables''.

;Вывести правила (&lt;tt&gt;-L&lt;/tt&gt;, &lt;tt&gt;--list&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -L [''цепочка''] [''параметры'']&lt;/tt&gt;

Вывести список правил для указанной таблицы и цепочки. Если цепочка не указана, то выводятся список правил для каждой цепочки. Например для вывода правил из таблицы nat:
&lt;tt&gt;iptables -t nat -n -L&lt;/tt&gt;

Часто используются параметры -n (во избежение медленных запросов {{w |DNS}}) и -v (для вывода более подробной информации).

Команду -L можно использовать с -Z (&lt;tt&gt;iptables -L -Z&lt;/tt&gt;) для вывода значений счетчиков и одновременного их обнуления.

;Удалить все правила из цепи (&lt;tt&gt;-F&lt;/tt&gt;, &lt;tt&gt;--flush&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -[F] [''цепочка''] [''параметры'']&lt;/tt&gt;

Если цепочка не указана, то удаляются все цепочки из таблицы.

;Обнулить все счетчики (&lt;tt&gt;-Z&lt;/tt&gt;, &lt;tt&gt;--zero&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -Z [''цепочка''] [''параметры'']&lt;/tt&gt;

Присваивает счетчикам числа пакетов и объема данных нулевые значения. Если цепочка не указана, то обнуление выполняется для всех цепочек.

Команду -Z можно использовать с -L (&lt;tt&gt;iptables -L -Z&lt;/tt&gt;) для вывода значений счетчиков и одновременного их обнуления.

;Создать новую цепочку (&lt;tt&gt;-N&lt;/tt&gt;, &lt;tt&gt;--new-chain&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -N ''цепочка''&lt;/tt&gt;

Создать новую цепочку в указанной таблице с указанным именем. Если в указанной таблице уже есть цепочка с указанным именем, то новая не создается.

;Удалить созданную цепочку (&lt;tt&gt;-X&lt;/tt&gt;, &lt;tt&gt;--delete-chain&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -X [''цепочка'']&lt;/tt&gt;

Удалить цепочку ранее созданную с помощью команды '''-N'''. Перед удалением цепи необходимо удалить или заменить все правила, которые ссылаются на эту цепочку. Если цепочка не указана, то из таблицы будут удалены все цепи кроме стандартных (INPUT, OUTPUT, FORWARD, PREROUTING, POSTROUTING). Стандартные цепочки не удаляются.

;Переименование цепи (&lt;tt&gt;-E&lt;/tt&gt;, &lt;tt&gt;--rename-chain&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -E ''цепочка'' ''новое_название''&lt;/tt&gt;

Присваивает указанной цепочке новое название. Косметическая функция, не влияющая на функциональность.

;Установить политику для стандартной цепи (&lt;tt&gt;-P&lt;/tt&gt;, &lt;tt&gt;--policy&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -P ''цепочка'' ''действие'' [''параметры'']&lt;/tt&gt;

Над пакетами которые доходят до конца указанной цепочки будет выполняться указанное действие. В качестве действия можно указать только ACCEPT или DROP. Устанавливать политику можно только на встроенных цепочках. Например:
&lt;tt&gt;iptables -P INPUT DROP.&lt;/tt&gt;

=== Команды модификации правил ===
;Добавить новое правило (&lt;tt&gt;-A&lt;/tt&gt;, &lt;tt&gt;--append chain&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -A ''цепочка'' ''спецификация_правила'' [''параметры'']&lt;/tt&gt;

Правило добавляется в конец указанной цепочки. Если в спецификации правила указано имя отправителя или получателя, которое одновременно соответствует нескольким адресам, то в конец цепочки добавляются правила для всех возможных комбинаций.

;Вставить новое правило (&lt;tt&gt;-I&lt;/tt&gt;, &lt;tt&gt;--insert&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -I ''цепочка'' [''номер_правила''] спецификация_правила [''параметры'']&lt;/tt&gt;

Указанное правило вставляется в указанное место указанной цепочки. Правила нумеруются с 1, поэтому если указать номер 1 (или не указать вообще), то правило будет вставлено в начало цепочки.

;Удалить правило (&lt;tt&gt;-D&lt;/tt&gt;, &lt;tt&gt;--delete&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -D ''цепочка'' ''номер_правила'' [''параметры'']&lt;/tt&gt;

&lt;tt&gt;'''iptables''' [-t ''таблица''] -D ''цепочка'' ''спецификация_правила'' [''параметры'']&lt;/tt&gt;

Правило можно указывать при помощи его номера в цепочке (нумерация начинается с 1) или его спецификации.

;Заменить правило (&lt;tt&gt;-R&lt;/tt&gt;, &lt;tt&gt;--replace&lt;/tt&gt;)
&lt;tt&gt;'''iptables''' [-t ''таблица''] -R ''цепочка'' ''номер_правила'' ''спецификация_правила'' [''параметры'']&lt;/tt&gt;

Заменить правило с указанным номером в указанной цепочке. Правила нумеруются с 1. Спецификация правила не может содержать имени отправителя или получателя, которое одновременно соответствует нескольким адресам.

=== Параметры определения правил ===
'''Важно.'''
В последующих версиях описанный ниже синтаксис изменился. Например, старому синтаксису
* &lt;tt&gt;'''-s'''&lt;/tt&gt;, &lt;tt&gt;--src&lt;/tt&gt;, &lt;tt&gt;--source [!] ''адрес''[/''маска'']&lt;/tt&gt;
теперь соответствует новый
* &lt;tt&gt;[!] '''-s'''&lt;/tt&gt;, &lt;tt&gt;--src&lt;/tt&gt;, &lt;tt&gt;--source ''адрес''[/''маска'']&lt;/tt&gt;

Перечисленные ниже параметры используются при задании спецификации правил и указываются с командами модификации правил. Эти параметры ограничивают применение правил — если обрабатываемый пакет не соответствует указанным в спецификации критериям, то указанное в правиле действие на этот пакет не распространяется.

* &lt;tt&gt;'''-p'''&lt;/tt&gt;, &lt;tt&gt;--protocol [!] ''протокол''&lt;/tt&gt;

Ограничение протокола. Основные значения: &lt;tt&gt;[[tcp]]&lt;/tt&gt;, &lt;tt&gt;[[udp]]&lt;/tt&gt;, &lt;tt&gt;[[icmp]]&lt;/tt&gt;, или &lt;tt&gt;all&lt;/tt&gt;. Протокол также можно указать с помощью номера, или названия указанного в файле &lt;tt&gt;/etc/protocols&lt;/tt&gt;. Знак «!» перед именем протокола изменяет критерий на противоположенный (например &lt;tt&gt;!tcp&lt;/tt&gt; означает «любой протокол, кроме TCP»). Значение «Любой протокол» можно указать с помощью слова &lt;tt&gt;all&lt;/tt&gt; или числа 0. Если протокол не указан, то подразумевается «Любой протокол».

* &lt;tt&gt;'''-s'''&lt;/tt&gt;, &lt;tt&gt;--src&lt;/tt&gt;, &lt;tt&gt;--source [!] ''адрес''[/''маска'']&lt;/tt&gt;

Ограничение отправителя. Адрес может быть {{w |IP-адрес}}ом (возможно с [[w:Маска подсети|маской]]), именем хоста, или доменным именем. Маска может быть в стандартном формате (например 255.255.255.0) или же в виде числа, указывающего число единиц с «левой стороны» маски (например 24). Знак «!» перед адресом изменяет критерий на противоположенный.

Настоятельно не рекомендуется использовать имена, для разрешения которых требуется удаленный запрос, например по системе {{w |DNS}}.

* &lt;tt&gt;'''-d'''&lt;/tt&gt;, &lt;tt&gt;--dst&lt;/tt&gt;, &lt;tt&gt;--destination [!] ''address''[/''mask'']&lt;/tt&gt;

Ограничение получателя. Синтаксис такой же, как у --src.

* &lt;tt&gt;'''-i'''&lt;/tt&gt;, &lt;tt&gt;--in-interface [!] ''имя_интерфейса''&lt;/tt&gt;

Ограничение входящего сетевого интерфейса. Знак «!» перед адресом изменяет критерий на противоположенный. Если указанное имя интерфейса заканчивается на «+», то критерию соответствуют все интерфейсы, чьи имена начинаются на указанное имя. Если параметр --in-interface не указан, то критерию соответствуют пакеты из любого сетевого интерфейса.

* &lt;tt&gt;'''-o'''&lt;/tt&gt;, &lt;tt&gt;--out-interface [!] ''имя_интерфейса''&lt;/tt&gt;

Ограничение выходящего сетевого интерфейса. Синтаксис такой же, как и для --in-interface.

* &lt;tt&gt;[!] '''-f'''&lt;/tt&gt;, &lt;tt&gt;--fragment&lt;/tt&gt;

Ограничение по фрагментам: критерию соответствуют только фрагменты пакета, начиная со второго фрагмента. Знак «!» перед адресом изменяет критерий на противоположенный.

У таких фрагментов начиная со второго нет заголовка с портами отправителя и получателя (или с типом ICMP). Следовательно, такие фрагменты не соответствуют критериям, указывающим номера портов.

* &lt;tt&gt;'''-j'''&lt;/tt&gt;, &lt;tt&gt;--jump ''действие_или_цепочка''&lt;/tt&gt;
* &lt;tt&gt;'''-g'''&lt;/tt&gt;, &lt;tt&gt;--goto ''цепочка''&lt;/tt&gt;

Спецификация действий и переходов. Если указанно название цепочки ранее созданной командой -N, то пакеты соответствующие критериям правила переносится в начало указанной цепочки (запрещено указывать название цепочки, в котором это правило находится). Если указано действие, то оно выполняется над пакетами соответствующим критериям правила. Если в правиле нет параметров --jump и --goto, то правило не влияет на проверяемые пакеты (но счетчик правила продолжает работать).

--goto отличается от --jump поведением при действии RETURN. Действие RETURN переводит пакет в правило, следующее после того, которое вызвало предыдущий переход --jump. То есть, если пакет перешел из цепочки X в цепочку Y при помощи --jump, а потом в Z опять при помощи --jump, то действие RETURN из цепочки Z возвращает его в Y. Если же пакет перешел в Z при помощи --goto, то RETURN возвращает его в X.

* &lt;tt&gt;'''-c'''&lt;/tt&gt;, &lt;tt&gt;--set-counters ''пакеты байты''&lt;/tt&gt;

Параметр позволяет при добавлении или изменении правил одновременно инициализировать счетчики числа пакетов и размера данных.
&lt;sub&gt;Подстрочный текст&lt;/sub&gt;

== Модули ==
Кроме фильтров по умолчанию поддерживаются дополнительные модули, подключающиеся автоматически при выборе протокола ('''-p''') или вручную опцией '''-m''' (''--match''), после которой следует имя подключаемого фильтра и его опции. Также как и для остальных правил фильтрации, здесь можно использовать '''!''' в качестве отрицания.

=== Некоторые из встроенных (входящие в стандартный пакет) ===

==== state ====
Соединением для NetFilter является закономерно оформленная последовательность обмена пакетами между хостами, с выделением роли каждого пакета в соединении. Эта особенность позволяет контролировать трафик с точки зрения транспортного уровня (модели OSI). Ядро NetFilter отслеживает соединения и ведёт активное наблюдение за открытием новых, протеканием и завершением установленных соединений. Каждый пакет может быть классифицирован по одному из следующих состояний: NEW, ESTABLISHED, RELATED и INVALID.

NEW — типов пакетов, участвующих в установке нового соединения.

ESTABLISHED — пакет уже установленного соединения

RELATED — Соединение получает статус RELATED если оно связано с другим соединением, имеющим признак ESTABLISHED. Это означает, что соединение получает признак RELATED тогда, когда оно инициировано из уже установленного соединения, имеющего признак ESTABLISHED.

Состояние RELATED относится к служебному трафику, протоколу ICMP стека TCP/IP.

INVALID — неправильный/ошибочный/испорченный пакет. Обычно для таких пакетов применяют действие DROP

ПРИМЕР:
 
 iptables -t nat -A PREROUTING -s 10.10.10.10 -m conntrack --ctstate NEW,INVALID -j DROP

Все новые и ошибочные пакеты, идущие с адреса 10.10.10.10 отбрасываются

==== connlimit ====
Позволяет задавать возможное количество одновременных подключений к машине от заданного IP или блока адресов

&lt;tt&gt;[!] --connlimit-above n&lt;/tt&gt; — пакет подойдет под описание, если количество одновременных подключений на данный момент больше (меньше), чем n

&lt;tt&gt;--connlimit-mask bits&lt;/tt&gt; — позволяет задать маску блока адресов

 iptables -A INPUT -p tcp --syn --dport 80 -m connlimit --connlimit-above 20 -j REJECT --reject-with tcp-reset

==== iprange ====
Выделяет не один адрес, как &lt;tt&gt;--src&lt;/tt&gt;, а все адреса от ip1 до ip2

Нужно учитывать тот факт что перед использованием данного критерия, необходимо подгрузить модуль его реализующий «-m iprange»

&lt;tt&gt;[!]--src-range ip1-ip2&lt;/tt&gt;

&lt;tt&gt;[!]--dst-range ip1-ip2&lt;/tt&gt;

==== multiport ====
Выделяет не один порт, как &lt;tt&gt;--dport&lt;/tt&gt; или &lt;tt&gt;--sport&lt;/tt&gt;, а несколько по списку (до 15 штук). Можно задавать диапазоны как первый_порт: последний_порт. Может быть использовано только вместе с &lt;tt&gt;-p udp&lt;/tt&gt; или &lt;tt&gt;-p tcp&lt;/tt&gt;.

&lt;tt&gt;[!]--source-ports port1,port2,port3:port4&lt;/tt&gt;

&lt;tt&gt;[!]--destination-ports port1,port2,port3:port4&lt;/tt&gt;

&lt;tt&gt;[!]--ports port1,port2,port3:port4&lt;/tt&gt;

==== mac ====
Сравнение не IP источника пакета, а его {{w |ethernet}}-адреса

&lt;tt&gt;[!] --mac-source address&lt;/tt&gt;. {{w |MAC-адрес}} должен быть указан в стандартном формате XX:XX:XX:XX:XX:XX.

Если нужна фильтрация по MAC-адресу в мостовых соединениях (например, pppoe), то можно воспользоваться утилитой {{w |ebtables}}, которая предназначена как раз для более низкоуровневой фильтрации пакетов.

Фиксируем получение IP-адреса по DHCP не из доверенного источника (MAC-адреса 00:50:8D:FD:E6:32):

 iptables -A INPUT -i eth0 -p UDP --sport 68 --dport 67 -m mac ! --mac-source 00:50:8D:FD:E6:32 -m limit --limit 3/minute -j LOG  --log-prefix &quot;IPT::DHCP: &quot; --log-level warning
 iptables -A INPUT -i eth0 -p UDP --sport 68 --dport 67 -j ACCEPT

== Примечания ==
{{примечания}}

== Литература ==
* {{книга
|заглавие = Linux iptables. Pocket Reference
|автор = Gregor N. Purdy
|isbn = 0-596-00569-5
|страницы = 97
|год = 2004
|издательство = O’Reilly
}}

== Ссылки ==
* [[Настройка межсетевого экрана в Linux]]
* https://netfilter.org — Сайт проекта {{w |Netfilter}}
* [http://security.maruhn.com/iptables-manual.html Man page of iptables]{{ref-en}}
* [http://www.frozentux.net/documents/iptables-tutorial/ Frozentux Iptables Tutorial]*{{ref-en}}
* [http://www.opennet.ru/docs/RUS/iptables Руководство по iptables (Iptables Tutorial 1.1.19)]*{{ref-ru}}
* [http://wiki.archlinux.org/index.php/Simple_stateful_firewall_HOWTO#Prerequisites Простой полноценный межсетевой экран (готовый шаблон для дектопа)]{{ref-en}}
* [http://posix.ru/network/iptables Настройка межсетевого экрана Iptables (готовый шаблон для дектопа)]*{{ref-ru}}
* http://freecode.com/projects/flex-fw — гибкая надстройка над iptables для построения сервис-ориентированного statefull-фаервола с простым синтаксисом команд.
* {{Unix man |iptables|8}}{{ref-en}}
* {{Unix man |ufw|8}}{{ref-en}}
* {{Unix man |gufw|8}}{{ref-en}}
* https://help.ubuntu.com/community/IptablesHowTo{{ref-en}}
* https://help.ubuntu.com/community/UFW{{ref-en}}
* https://help.ubuntu.com/community/Gufw{{ref-en}}
* https://help.ubuntu.com/9.10/serverguide/C/firewall.html{{ref-en}}
* https://wiki.ubuntu.com/UncomplicatedFirewall{{ref-en}}
* https://help.ubuntu.com/community/Firewall{{ref-en}}</text>
      <sha1>kebkhdjg3mul0fcwwahi0p551eopidf</sha1>
    </revision>
  </page>
  <page>
    <title>Библиотека классов RxFtp</title>
    <ns>0</ns>
    <id>12649</id>
    <revision>
      <id>270429</id>
      <parentid>258181</parentid>
      <timestamp>2026-10-27T07:11:20Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270429</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="128533" sha1="j7p3h3o9wvvbe48qkkenqptgniv0p36" xml:space="preserve">{{Название учебника
|Категория = Программирование
|Тип = Одностраничный
}}

&lt;div align=&quot;center&quot;&gt;
&lt;font size=&quot;+3&quot;&gt;
'''&lt;br /&gt;Open Object Rexx&lt;br /&gt;Библиотека классов RxFtp&lt;br /&gt;Cправочник&lt;br /&gt;&lt;br /&gt;&lt;br /&gt;W. David Ashley&lt;br /&gt;Rony G. Flatscher&lt;br /&gt;Mark Hessling&lt;br /&gt;Rick McGuire&lt;br /&gt;Mark Miesfeld&lt;br /&gt;Lee Peedin&lt;br /&gt;Jon Wolfers'''
&lt;/font&gt;
&lt;/div&gt;

&lt;div align=&quot;center&quot;&gt;
&lt;br /&gt;Перевод, комментарии и дополнения&lt;ref name=&quot;tolmach&quot; /&gt;: [[Участник:StLeutnant|StLeutnant]]
&lt;br /&gt;Оригинал: смотри на [http://www.oorexx.org/ сайте ooRexx]
&lt;/div&gt;

&lt;div align=&quot;justify&quot;&gt;
&lt;br /&gt;Версия 4.1.1
&lt;br /&gt;Опубликовано {{nobr|в мае}} 2012 года.
&lt;br /&gt;Copyright (с) 1995, 2004 IBM Corporation и другие.
Все права защищены.
&lt;br /&gt;Copyright (с) 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 Rexx Language Association.
Все права защищены.

Данная программа {{nobr|и сопутствующие}} материалы доступны {{nobr|для использования}} {{nobr|в соответствии}} {{nobr|с условиями}} [[w:Common_Public_License|Common Public License {{nobr|Version 1.0}}]].
{{nobr|Перед использованием}} {{nobr|этой информации}} {{nobr|и продуктов}}, доступных {{nobr|на данных}} условиях, внимательно прочитайте общие положения {{nobr|в разделах}} Уведомления.

Собственником {{nobr|и обладателем}} прав {{nobr|на данный}} документ изначально являлась [[w:IBM|{{nobr|IBM Corporation}}]].
{{nobr|В 2004 году}} {{nobr|он был}} пожертвован Rexx Language Association {{nobr|на условиях}} [[w:Common_Public_License|Common Public License {{nobr|Version 1.0}}]], как «[[w:Открытое_программное_обеспечение|программное обеспечение {{nobr|с открытым}} исходным кодом]]».

Благодарим Julian Choy {{nobr|за разработку}} [[w:Логотип|логотипа]] [[w:Object_REXX|ooRexx]].
&lt;/div&gt;

== Об этой книге ==
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Данная книга содержит описание библиотеки {{nobr|классов RxFtp}} Open Object Rexx {{nobr|и её методов}}.

Она ориентирована {{nobr|на тех пользователей}}, которые планируют вести разработку приложений {{nobr|для [[w:FTP|FTP]]}}, {{nobr|используя [[w:Rexx|Rexx]]}}, {{nobr|и может}} использоваться широким кругом читателей — {{nobr|от новичков}}, обладающих некоторыми навыками программирования {{nobr|на каком-либо}} языке, {{nobr|но не знающих}} {{nobr|ни [[w:Rexx|Rexx]]}}, {{nobr|ни [[w:FTP|FTP]]}}, {{nobr|до матёрых}} разработчиков приложений, имеющих опыт работы {{nobr|и с [[w:Object_REXX|Object Rexx]]}}, {{nobr|и с [[w:FTP|FTP]]}}.

Эта книга — справочник, {{nobr|а не учебное}} пособие.
Подразумевается, {{nobr|что читатели}} уже знакомы {{nobr|с концепциями}} [[w:Объектно-ориентированное_программирование|{{nobr|объектно-ориентированного}} программирования]].

Описания включают {{nobr|в себя}} синтаксис {{nobr|и использование}} конструкций языка, {{nobr|а также}} объяснение того, {{nobr|как языковый}} процессор интерпретирует их {{nobr|во время}} выполнения программы.
 |}
&lt;/div&gt;

=== Связанная информация ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Смотри также: '''Open Object Rexx: Справочник'''
 |}
&lt;/div&gt;

=== Как читать синтаксические диаграммы ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
В тексте этой книги синтаксис описывается {{nobr|в соответствии}} {{nobr|с приведёнными}} ниже правилами.

* Синтаксические диаграммы читаются слева направо, сверху вниз, следуя вдоль линии маршрута. &lt;br /&gt;Символы &lt;span style=&quot;color:#004040&quot;&gt;&lt;tt&gt;{{nobr|&amp;gt;&amp;gt;——}}&lt;/tt&gt;&lt;/span&gt; начинают описание синтаксиса оператора. &lt;br /&gt;Символы &lt;span style=&quot;color:#004040&quot;&gt;&lt;tt&gt;{{nobr|——&amp;gt;}}&lt;/tt&gt;&lt;/span&gt; обозначают, {{nobr|что описание}} синтаксиса оператора будет продолжено {{nobr|на следующей}} строке. &lt;br /&gt;Символы &lt;span style=&quot;color:#004040&quot;&gt;&lt;tt&gt;{{nobr|&amp;gt;——}}&lt;/tt&gt;&lt;/span&gt; отмечают продолжение описания синтаксиса оператора, начатого {{nobr|в предыдущей}} строке. &lt;br /&gt;Символы &lt;span style=&quot;color:#004040&quot;&gt;&lt;tt&gt;{{nobr|——&amp;gt;&amp;lt;}}&lt;/tt&gt;&lt;/span&gt; завершают описание синтаксиса оператора. &lt;br /&gt;Диаграммы синтаксических единиц, {{nobr|не являющихся}} полностью законченными операторами, начинаются {{nobr|с символов}} &lt;span style=&quot;color:#004040&quot;&gt;&lt;tt&gt;{{nobr|&amp;gt;——}}&lt;/tt&gt;&lt;/span&gt; {{nobr|и заканчиваются}} символами &lt;span style=&quot;color:#004040&quot;&gt;&lt;tt&gt;{{nobr|——&amp;gt;}}&lt;/tt&gt;&lt;/span&gt;.
* Обязательные элементы размещаются {{nobr|на линии}} главного маршрута (горизонтальная линия {{nobr|на диаграмме}}).
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——ОПЕРАТОР——обязательный_элемент—————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

* Необязательные (дополнительные) элементы размещаются ниже линии главного маршрута.
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——ОПЕРАТОР——+————————————————————————+———————————————————————&amp;gt;&amp;lt;
               +—дополнительный_элемент—+&lt;/span&gt;

* Если требуется сделать выбор одного {{nobr|из двух}} {{nobr|или более}} элементов, {{nobr|то элементы}} помещаются {{nobr|в вертикальный}} список. &lt;br /&gt;{{nobr|Если выбор}} надо сделать обязательно, {{nobr|то первый}} элемент списка размещается {{nobr|на линии}} главного маршрута.
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——ОПЕРАТОР——+—обязательный_выбор1—+——————————————————————————&amp;gt;&amp;lt;
               +—обязательный_выбор2—+&lt;/span&gt;

* Если выбор необязательный, {{nobr|то весь}} список размещается ниже линии главного маршрута.
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——ОПЕРАТОР——+——————————————————+—————————————————————————————&amp;gt;&amp;lt;
               +—возможный_выбор1—+
               +—возможный_выбор2—+&lt;/span&gt;

* Если один {{nobr|из элементов}} списка используется {{nobr|как выбор}} {{nobr|по умолчанию}}, {{nobr|то этот}} элемент размещается выше линии главного маршрута, {{nobr|а остальной}} список — ниже.
               &lt;span style=&quot;color:#004040&quot;&gt;+—выбор_по_умолчанию——+
 &amp;gt;&amp;gt;——ОПЕРАТОР——+—————————————————————+——————————————————————————&amp;gt;&amp;lt;
               +—возможный_выбор1————+
               +—возможный_выбор2————+&lt;/span&gt;

* Стрелка, возвращающаяся влево выше линии главного маршрута, означает, {{nobr|что элемент}} может повторяться.
               &lt;span style=&quot;color:#004040&quot;&gt;+———————————————————————+
               V                       |
 &amp;gt;&amp;gt;——ОПЕРАТОР————повторяющийся_элемент—+————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

* Стрелка повторения элементов {{nobr|над списком}} означает, {{nobr|что можно}} повторно выбирать элементы {{nobr|из этого}} списка.
* Две вертикальные полосы вокруг элемента отмечают фрагмент. Часть синтаксической диаграммы, относящаяся {{nobr|к нему}}, будет приведена {{nobr|с высокой}} детализацией сразу {{nobr|после главной}} диаграммы. 
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——ОПЕРАТОР——&amp;#124; фрагмент &amp;#124;—————————————————————————————————————&amp;gt;&amp;lt;
 
 фрагмент:
 &amp;#124;——расширение_с_высокой_детализациeй———————————————————————————&amp;#124;&lt;/span&gt;

* Ключевые слова отображаются {{nobr|на диаграмме}} прописными буквами (например, &lt;span style=&quot;color:#004040&quot;&gt;&lt;tt&gt;PARM1&lt;/tt&gt;&lt;/span&gt;). {{nobr|В тексте}} программы они {{nobr|должны быть}} записаны точно {{nobr|так же}}, {{nobr|как и на диаграмме}}, {{nobr|но можно}} использовать {{nobr|как прописные}}, {{nobr|так и строчные}} буквы. &lt;br /&gt;Переменные отображаются {{nobr|на диаграмме}} строчными буквами (например, &lt;span style=&quot;color:#004040&quot;&gt;&lt;tt&gt;parmx&lt;/tt&gt;&lt;/span&gt;). {{nobr|Они представляют}} собой назначаемые пользователем имена {{nobr|или значения}}&lt;ref name=&quot;keywords&quot; /&gt;.
* Если {{nobr|на диаграмме}} отображены знаки пунктуации, скобки, арифметические операторы {{nobr|или другие}} символы, {{nobr|то их требуется}} вводить {{nobr|как часть}} синтаксиса. Следующий пример показывает {{nobr|как описывается}} синтаксис {{nobr|в таком}} случае:
           &lt;span style=&quot;color:#004040&quot;&gt;+—,——————+
           V        |
 &amp;gt;&amp;gt;——MAX(————number—+——)————————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

 |}
&lt;/div&gt;

=== Замечание о примере программы в этом документе===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Пример программы {{nobr|в этом}} документе представлен {{nobr|с использованием}} моноширинного шрифта, который {{nobr|не всегда}} совместим {{nobr|с функциями}} {{nobr|копирования-вставки}} текстовых редакторов.
Вставка текста {{nobr|в редактор}} может привести {{nobr|к такому}} результату, {{nobr|когда часть}} символов выйдет {{nobr|за пределы}} стандартного набора {{nobr|[[w:Ascii|ASCII]]-символов}}.
Особенно часто {{nobr|при вставке}} {{nobr|в текстовые}} редакторы некорректно конвертируются символы «одиночная кавычка» {{nobr|и «двойная}} кавычка».
 |}
&lt;/div&gt;

=== Помощь и обратная связь ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Проект Open Object Rexx позволяет пользователям получить помощь {{nobr|и обеспечить}} обратную связь {{nobr|с разработчиками}} несколькими способами.
{{nobr|Эти способы}} перечислены ниже {{nobr|в произвольном}} порядке.
 |}
&lt;/div&gt;

==== Почтовая рассылка Rexx Language Association ====
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
[http://www.rexxla.org/ Rexx Language Association] обеспечивает членов ассоциации почтовой рассылкой.
{{nobr|Эта почтовая}} рассылка доступна только членам ассоциации RexxLA.
{{nobr|Таким образом}}, {{nobr|для включения}} {{nobr|в список}} рассылки требуется вступить {{nobr|в RexxLA}}.
Взносы {{nobr|для членов}} ассоциации невелики {{nobr|и оплачиваются}} ежегодно.
{{nobr|За подробностями}} вступления {{nobr|в RexxLA}} следует обратиться [http://rexxla.org/ {{nobr|на домашнюю}} страницу {{nobr|сайта RexxLA}}] или [http://www.rexxla.org/rexxla/join.html {{nobr|на страницу}} оформления заявки {{nobr|на вступление}}].
 |}
&lt;/div&gt;

==== Проект Open Object Rexx на сайте SourceForge ====
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
[http://www.oorexx.org/ Проект Open Object Rexx] использует [http://sourceforge.net/ SourceForge] {{nobr|в качестве}} домашней площадки [http://sourceforge.net/projects/oorexx проекта ooRexx] {{nobr|для организации}} хранилищ исходных кодов, почтовых рассылок {{nobr|и прочих служб}} проекта.
{{nobr|Ниже приведён}} список наиболее востребованных возможностей.

'''Форумы ooRexx'''

Проект ooRexx обслуживает группу форумов, {{nobr|на которых}} каждый может поднять любые темы, связанные {{nobr|с ooRexx}}, принять участие {{nobr|в их обсуждении}} {{nobr|или наблюдать}} {{nobr|за обсуждением}}.
Форумы размещены [http://sourceforge.net/forum/?group_id=119701 {{nobr|на странице}} фoрумов ooRexx].
{{nobr|В настоящее}} время доступны три форума: Помощь, Разработчики {{nobr|и Открытое}} Обсуждение.
Дополнительно, можно наблюдать {{nobr|за дискуссиями}} {{nobr|на форумах}} {{nobr|с помощью}} электронной почты.

'''Список почтовой рассылки разработчиков'''

Подписаться {{nobr|на почтовую}} рассылку разработчиков ooRexx можно [http://sourceforge.net/mail/?group_id=119701 {{nobr|на странице}} подписки {{nobr|на почтовые}} рассылки ooRexx].
{{nobr|Эта рассылка}} предназначена {{nobr|для обсуждения}} новых разработок проекта ooRexx {{nobr|и дальнейших}} усовершенствований интерпретатора.
Также поддерживается исторический архив прошедших обсуждений.

'''Список почтовой рассылки пользователей'''

Подписаться {{nobr|на почтовую}} рассылку пользователей ooRexx можно [http://sourceforge.net/mail/?group_id=119701 {{nobr|на странице}} подписки {{nobr|на почтовые}} рассылки ooRexx].
{{nobr|Эта рассылка}} предназначена {{nobr|для обсуждения}} применения ooRexx.
Также поддерживается исторический архив прошедших обсуждений.

'''Список почтовой рассылки оповещений'''

Подписаться {{nobr|на почтовую}} рассылку оповещений {{nobr|о событиях}} ooRexx можно [http://sourceforge.net/mail/?group_id=119701 {{nobr|на странице}} подписки {{nobr|на почтовые}} рассылки ooRexx].
{{nobr|Эта рассылка}} используется только {{nobr|для оповещения}} {{nobr|о значимых}} {{nobr|для проекта}} ooRexx событиях.

'''Список почтовой рассылки системы учёта ошибок'''

Подписаться {{nobr|на почтовую}} рассылку системы учёта ошибок ooRexx можно [http://sourceforge.net/mail/?group_id=119701 {{nobr|на странице}} подписки {{nobr|на почтовые}} рассылки ooRexx].
{{nobr|Эта рассылка}} используется только {{nobr|для наблюдения}} {{nobr|за изменением}} состояния записей {{nobr|в системе}} учёта ошибок ooRexx.

'''Отчёты от ошибках'''

Создать отчёт {{nobr|об ошибках}} можно [http://sourceforge.net/tracker/?group_id=119701&amp;atid=684730 {{nobr|на странице}} отчётов {{nobr|об ошибках}} ooRexx].
Пожалуйста, убедитесь, {{nobr|что в отчёте}} предоставлено {{nobr|как можно}} больше информации, {{nobr|чтобы разработчики}} могли {{nobr|как можно}} быстрее решить проблему.
Примеры программ, {{nobr|в которых}} воспроизводится возникшая проблема, позволят облегчить поиски {{nobr|её решения}}.

'''Обратная связь для обсуждения документации'''

Предоставить обратный адрес {{nobr|для обсуждения}} документации {{nobr|или сообщить}} {{nobr|об ошибках}} {{nobr|в ней}} можно [http://sourceforge.net/tracker/?group_id=119701&amp;atid=1001880 {{nobr|на странице}} отчётов {{nobr|о документации}} ooRexx].
Пожалуйста, убедитесь, {{nobr|что в отчёте}} предоставлено {{nobr|как можно}} больше информации.
Выделение проблемного места кавычками, {{nobr|в дополнение}} {{nobr|к распечатке}} документа {{nobr|и указанию}} номера раздела, поможет разработчикам определить местоположение текста {{nobr|в исходном}} материале, использованном {{nobr|при подготовке}} документации (номера разделов генерируются {{nobr|при подготовке}} документации {{nobr|и отсутствуют}} {{nobr|в исходных}} материалах {{nobr|как таковые}}).
{{nobr|Также следует}} включить предложения {{nobr|о том}}, {{nobr|как перефразировать}} {{nobr|или исправить}} существующий текст.

'''Запрос на усовершенствование'''

Предложить реализовать новые возможности ooRexx можно [http://sourceforge.net/tracker/?group_id=119701&amp;atid=684733 {{nobr|на странице}} запросов усовершенствований ooRexx].

'''Отчёты об исправлениях'''

Если вы создали исправление, улучшающее функционирование {{nobr|или расширяющее}} возможности ooRexx, пожалуйста, {{nobr|перешлите его}}, используя [http://sourceforge.net/tracker/?group_id=119701&amp;atid=684732 страницу отчётов {{nobr|об исправлениях}} ooRexx].
Пожалуйста, предоставьте {{nobr|в отчёте}} {{nobr|как можно}} больше информации {{nobr|об исправлении}}, {{nobr|чтобы разработчики}} могли {{nobr|как можно}} быстрее {{nobr|оценить его}}.
Пожалуйста, {{nobr|не пересылайте}} {{nobr|этим путём}} исправления, устраняющие ошибки; используйте {{nobr|для этого}} отчёт {{nobr|об ошибках}} {{nobr|и вложите}} {{nobr|в сообщение}} {{nobr|своё исправление}}.
 |}
&lt;/div&gt;

==== Группа новостей comp.lang.rexx ====
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Группа новостей comp.lang.rexx — прекрасное место {{nobr|для получения}} помощи {{nobr|от множества}} представителей сообщества специалистов, {{nobr|использующих Rexx}}.
{{nobr|Здесь можно}} получить помощь {{nobr|не только}} {{nobr|по Open}} Object Rexx, {{nobr|но и по любому}} количеству других интерпретаторов {{nobr|и инструментов Rexx}}.
 |}
&lt;/div&gt;

== Что такое RxFtp? ==
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
RxFtp — это библиотека классов Object Rexx, предоставляющая доступ {{nobr|к [[w:TCP|TCP]]/[[w:IP|IP]]}} {{nobr|интерфейсу [[w:FTP|FTP]]}}, основанному {{nobr|на {{RFC|959}}}}.
Предполагается, {{nobr|что читатель}} знаком {{nobr|с базовой}} {{nobr|функциональностью [[w:FTP|FTP]]}} {{nobr|и её}} спецификой {{nobr|в системе}}.
{{nobr|За более}} подробной информацией обратитесь {{nobr|к книге}} {{nobr|Douglas Comer}} «Internetworking {{nobr|with TCP/IP}}, {{nobr|Volume I}}: Principles, Protocols {{nobr|and Architecture}}» (Prentice {{nobr|Hall PTR}}).
{{nobr|Для работы}} {{nobr|пакету RxFtp}} требуется пакет внешних {{nobr|функций RxSock}}, поддерживаемый Open Object Rexx.
 |}
&lt;/div&gt;

== Установка ==
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Пакет RxFtp содержится {{nobr|в файле '''rxftp.cls'''}}.
{{nobr|Этот файл}} {{nobr|должен быть}} помещен {{nobr|в один}} {{nobr|из каталогов}}, перечисленных {{nobr|в переменной}} {{nobr|окружения PATH}}.
{{nobr|Для получения}} доступа {{nobr|к классу}} {{nobr|и его методам}} необходимо добавить {{nobr|директиву '''::REQUIRES'''}} {{nobr|в каждый}} скрипт {{nobr|Object Rexx}}, {{nobr|который будет}} использовать {{nobr|этот класс}}:
 &lt;span style=&quot;color:#004040&quot;&gt;. . .
 ::requires &amp;quot;rxftp.cls&amp;quot;&lt;/span&gt;

Создать конкретный экземпляр класса можно {{nobr|по обычным}} соглашениям {{nobr|Object Rexx}}:
 &lt;span style=&quot;color:#004040&quot;&gt;obj = .rxftp~new&lt;/span&gt;

Каждый экземпляр класса полностью инкапсулирует сессию {{nobr|с сервером [[w:FTP|FTP]]}}.
{{nobr|Это значит}}, {{nobr|что возможно}} создание множества экземпляров класса {{nobr|и наличие}} множества открытых соединений {{nobr|с серверами [[w:FTP|FTP]]}} одновременно.
 |}
&lt;/div&gt;

=== Замечания по использованию RxFtp ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
# Метод '''FtpProxy''' отсутствует в классе RxFtp.
# [[w:Firewall|Межсетевые экраны]] могут препятствовать нормальной работе многих {{nobr|методов RxFtp}}, например, ограничением передачи данных {{nobr|как в активном}}, {{nobr|так и в пассивном}} {{nobr|режимах [[w:FTP|FTP]]}}. Особенно {{nobr|это касается}} активного {{nobr|режима [[w:FTP|FTP]]}}, {{nobr|когда клиент}} работает {{nobr|за локальным}} [[w:Firewall|межсетевым экраном]] (например, {{nobr|в [[w:Windows_XP|WindowsXP]] SP2}} {{nobr|или в большинстве}} современных {{nobr|сборок [[w:Linux|Linux]]}}).
# Каждый экземпляр класса RxFtp устанавливает собственное соединение {{nobr|с сервером [[w:FTP|FTP]]}}. {{nobr|Таким образом}}, можно создать множество экземпляров {{nobr|этого класса}} {{nobr|и соединиться}} {{nobr|с множеством}} {{nobr|серверов [[w:FTP|FTP]]}} одновременно. {{nobr|Также каждый}} экземпляр класса можно использовать повторно — экземпляр класса, деинициализированный методом '''FtpLogoff''', {{nobr|можно повторно}} инициализировать методом '''FtpSetUser''', {{nobr|который установит}} {{nobr|новое соединение}} {{nobr|с сервером [[w:FTP|FTP]]}}.
 |}
&lt;/div&gt;

== Методы RxFtp ==
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Каждый параграф этой главы описывает вызов одного из методов RxFtp в программном окружении [[w:Rexx|Rexx]].
 |}
&lt;/div&gt;

=== FtpAppend ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpAppend''' дописывает содержимое локального файла {{nobr|в конец}} существующего {{nobr|на сервере [[w:FTP|FTP]]}} файла.
{{nobr|Если указанный}} файл {{nobr|не существует}} {{nobr|на сервере [[w:FTP|FTP]]}}, {{nobr|то он создаётся}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpAppend(——localfile,——remotefile——+———————————+——)———————&amp;gt;&amp;lt;
                                             +——,——type——+&lt;/span&gt;

'''''Аргументы''''':

:'''localfile'''
::Имя и, возможно, путь {{nobr|к локальному}} файлу, {{nobr|который будет}} дописан {{nobr|к файлу}} {{nobr|на сервере [[w:FTP|FTP]]}}.

:'''remotefile'''
::Имя и, возможно, путь {{nobr|к файлу}} {{nobr|на сервере [[w:FTP|FTP]]}}, {{nobr|к которому}} будет дописано содержимое локального файла. {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то используется}} текущий каталог {{nobr|на сервере [[w:FTP|FTP]]}}. {{nobr|Если файл}} отсутствует {{nobr|на сервере [[w:FTP|FTP]]}}, {{nobr|то он создаётся}}.

:'''type'''&lt;ref name=&quot;transfer_mode&quot; /&gt;
::Строка, идентифицирующая тип представления данных, используемый {{nobr|при передаче}}:

::'ASCII'
:::Данные в текстовом представлении [[w:Ascii|ASCII]].
::'BINARY'
:::Данные в двоичном представлении.

::Значащим является только первый символ строки, независимо от регистра. {{nobr|Если аргумент}} опущен, {{nobr|то используется}} текущий&lt;ref name=&quot;default&quot; /&gt; тип представления.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpChDir ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpChDir''' назначает текущим каталогом {{nobr|на сервере [[w:FTP|FTP]]}} указанный каталог.
{{nobr|Если во время}} выполнения возникли ошибки, {{nobr|то текущий}} каталог {{nobr|не изменяется}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpChDir(——remotedir——)————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:'''remotedir'''
::Имя и, возможно, путь {{nobr|к каталогу}} {{nobr|на сервере [[w:FTP|FTP]]}}, который будет назначен текущим.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpDelete ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpDelete''' удаляет указанный файл {{nobr|с сервера [[w:FTP|FTP]]}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpDelete(——remotefile——)——————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:'''remotefile'''
::Имя и, возможно, путь {{nobr|к файлу}} {{nobr|на сервере [[w:FTP|FTP]]}}, который будет удалён.  {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то используется}} текущий каталог {{nobr|на сервере [[w:FTP|FTP]]}}.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpDir ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpDir''' возвращает список содержимого каталога {{nobr|сервера [[w:FTP|FTP]]}} {{nobr|в полном}} формате.
{{nobr|Список содержимого}} каталога помещается {{nobr|в атрибут '''Response'''}} экземпляра класса {{nobr|в виде}} массива Object Rexx, элементами которого являются строки этого списка.
{{nobr|В случае}} ошибки возвращается пустой массив.

{{nobr|Формат возвращаемого}} списка содержимого каталога зависит {{nobr|от операционной}} системы, установленной {{nobr|на машине}} {{nobr|с сервером [[w:FTP|FTP]]}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpDir(——+———————————+——)——————————————————————————————————&amp;gt;&amp;lt;
                  +——pattern——+&lt;/span&gt;

'''''Аргументы''''':

:'''pattern'''
::Шаблон имени файлов, применяемый {{nobr|для выборки}} содержимого каталога. {{nobr|В шаблоне}} можно использовать стандартные {{nobr|символы-заменители}} '*' {{nobr|и '?'}}. {{nobr|Если аргумент}} опущен, {{nobr|то, по умолчанию,}} используется {{nobr|шаблон './*'}}.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpGet ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpGet''' получает {{nobr|от сервера [[w:FTP|FTP]]}} одиночный файл.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpGet(——localfile,——remotefile——+———————————+——)——————————&amp;gt;&amp;lt;
                                          +——,——type——+&lt;/span&gt;

'''''Аргументы''''':

:'''localfile'''
::Имя и, возможно, путь {{nobr|к локальному}} файлу, {{nobr|в котором}} будет сохранён полученный {{nobr|от сервера [[w:FTP|FTP]]}} файл. {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то используется}} локальный текущий каталог.

:'''remotefile'''
::Имя и, возможно, путь {{nobr|к отправляемому}} {{nobr|сервером [[w:FTP|FTP]]}} файлу. {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то будет}} отправлен файл {{nobr|из текущего}} каталога {{nobr|сервера [[w:FTP|FTP]]}}.
 
:'''type'''&lt;ref name=&quot;transfer_mode&quot; /&gt;
::Строка, идентифицирующая тип представления данных, используемый {{nobr|при передаче}}:

::'ASCII'
:::Данные в текстовом представлении [[w:Ascii|ASCII]].
::'BINARY'
:::Данные в двоичном представлении.

::Значащим является только первый символ строки, независимо от регистра. {{nobr|Если аргумент}} опущен, {{nobr|то используется}} текущий&lt;ref name=&quot;default&quot; /&gt; тип представления.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpGetMode ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpGetMode'''&lt;ref name=&quot;typo_get&quot; /&gt; возвращает строку, идентифицирующую текущий&lt;ref name=&quot;default&quot; /&gt; {{nobr|режим [[w:FTP|FTP]]}}&lt;ref name=&quot;ftp_mode&quot; /&gt;.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpGetMode()———————————————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:Аргументов нет.

'''''Возвращаемое значение''''':

:Строка, идентифицирующая текущий {{nobr|режим [[w:FTP|FTP]]}}:

:'ACTIVE'
::Активный режим [[w:FTP|FTP]].
:'PASSIVE'
::Пассивный режим [[w:FTP|FTP]].

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpGetType ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpGetType'''&lt;ref name=&quot;typo_get&quot; /&gt; возвращает строку, идентифицирующую текущий&lt;ref name=&quot;default&quot; /&gt; тип представления&lt;ref name=&quot;ftp_type&quot; /&gt; данных, использующийся {{nobr|при приёме/передаче}} данных.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpGetType()———————————————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:Аргументов нет.

'''''Возвращаемое значение''''':

:Строка, идентифицирующая текущий тип представления данных, использующийся {{nobr|при приёме/передаче}} данных:

:'ASCII'
::Данные в текстовом представлении [[w:Ascii|ASCII]].
:'BINARY'
::Данные в двоичном представлении.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpLogoff ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpLogoff''' завершает сессию {{nobr|и закрывает}} соединение {{nobr|с сервером [[w:FTP|FTP]]}}.
{{nobr|Он также}} переинициализирует экземпляр класса {{nobr|и его}} {{nobr|можно будет}} использовать снова.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpLogoff()————————————————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:Аргументов нет.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpLs ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpLs''' возвращает список содержимого каталога {{nobr|сервера [[w:FTP|FTP]]}} {{nobr|в кратком}} формате.
{{nobr|Список содержимого}} каталога помещается {{nobr|в атрибут '''Response'''}} экземпляра класса {{nobr|в виде}} массива Object Rexx, элементами которого являются строки этого списка.
{{nobr|В случае}} ошибки возвращается пустой массив.

Обычно {{nobr|в элементы}} массива помещаются только имена файлов {{nobr|из списка}} содержимого указанного каталога.
{{nobr|Но формат}} данных может отличаться {{nobr|в некоторых}} случаях.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpLs(——+———————————+——)———————————————————————————————————&amp;gt;&amp;lt;
                 +——pattern——+&lt;/span&gt;

'''''Аргументы''''':

:'''pattern'''
::Шаблон имени файлов, применяемый {{nobr|для выборки}} содержимого каталога. {{nobr|В шаблоне}} можно использовать стандартные {{nobr|символы-заменители}} '*' {{nobr|и '?'}}. {{nobr|Если аргумент}} опущен, {{nobr|то, по умолчанию,}} используется {{nobr|шаблон './*'}}.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpMkDir ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpMkDir''' создаёт новый подкаталог {{nobr|на сервере [[w:FTP|FTP]]}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpMkDir(——remotedir——)————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:'''remotedir'''
::Имя нового подкаталога {{nobr|на сервере [[w:FTP|FTP]]}} и, возможно, путь {{nobr|к нему}}. {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то подкаталог}} создаётся {{nobr|в текущем}} каталоге {{nobr|на сервере [[w:FTP|FTP]]}}.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpPut ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpPut''' передаёт {{nobr|на сервер [[w:FTP|FTP]]}} одиночный файл.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpPut(——localfile,——remotefile——+———————————+——)——————————&amp;gt;&amp;lt;
                                          +——,——type——+&lt;/span&gt;

'''''Аргументы''''':

:'''localfile'''
::Имя и, возможно, путь {{nobr|к локальному}} файлу, {{nobr|который будет}} передан {{nobr|на сервер [[w:FTP|FTP]]}}. {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то используется}} локальный текущий каталог.

:'''remotefile'''
::Имя и, возможно, путь {{nobr|к файлу}} {{nobr|на сервере [[w:FTP|FTP]]}}, {{nobr|в который}} будет сохранён передаваемый {{nobr|локальный файл}}. {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то файл}} будет сохранён {{nobr|в текущий}} каталог {{nobr|сервера [[w:FTP|FTP]]}}.
 
:'''type'''&lt;ref name=&quot;transfer_mode&quot; /&gt;
::Строка, идентифицирующая тип представления данных, используемый {{nobr|при передаче}}:

::'ASCII'
:::Данные в текстовом представлении [[w:Ascii|ASCII]].
::'BINARY'
:::Данные в двоичном представлении.

::Значащим является только первый символ строки, независимо от регистра. {{nobr|Если аргумент}} опущен, {{nobr|то используется}} текущий&lt;ref name=&quot;default&quot; /&gt; тип представления.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpPutUnique ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpPutUnique''' передаёт {{nobr|на сервер [[w:FTP|FTP]]}} одиночный файл. {{nobr|Если файл}} существует {{nobr|на сервере [[w:FTP|FTP]]}}, {{nobr|то он}} сохраняется {{nobr|с новым}} уникальным именем&lt;ref name=&quot;name_unique&quot; /&gt;.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpPutUnique(——localfile,——remotefile——+———————————+——)————&amp;gt;&amp;lt;
                                                +——,——type——+&lt;/span&gt;

'''''Аргументы''''':

:'''localfile'''
::Имя и, возможно, путь {{nobr|к локальному}} файлу, {{nobr|который будет}} передан {{nobr|на сервер [[w:FTP|FTP]]}}. {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то используется}} локальный текущий каталог.

:'''remotefile'''
::Имя и, возможно, путь {{nobr|к файлу}} {{nobr|на сервере [[w:FTP|FTP]]}}, {{nobr|в который}} будет сохранён передаваемый {{nobr|локальный файл}}.  {{nobr|Если файл}} существует {{nobr|на сервере [[w:FTP|FTP]]}}, {{nobr|то он}} сохраняется {{nobr|с новым}} уникальным именем&lt;ref name=&quot;name_unique&quot; /&gt;. {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то файл}} будет сохранён {{nobr|в текущий}} каталог {{nobr|сервера [[w:FTP|FTP]]}}.
 
:'''type'''&lt;ref name=&quot;transfer_mode&quot; /&gt;
::Строка, идентифицирующая тип представления данных, используемый {{nobr|при передаче}}:

::'ASCII'
:::Данные в текстовом представлении [[w:Ascii|ASCII]].
::'BINARY'
:::Данные в двоичном представлении.

::Значащим является только первый символ строки, независимо от регистра. {{nobr|Если аргумент}} опущен, {{nobr|то используется}} текущий&lt;ref name=&quot;default&quot; /&gt; тип представления.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpPwd ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpPwd''' возвращает имя текущего каталога {{nobr|на сервере [[w:FTP|FTP]]}}, {{nobr|включая путь}} {{nobr|к нему}}.
{{nobr|Информация помещается}} {{nobr|в атрибут '''Response'''}} экземпляра класса {{nobr|в виде}} массива Object Rexx, единственным элементом которого является строка {{nobr|с именем}} текущего каталога, {{nobr|включая путь}} {{nobr|к нему}}.
{{nobr|В случае}} ошибки возвращается пустой массив.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpPwd()———————————————————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:Аргументов нет.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpQuote ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpQuote''' отправляет {{nobr|серверу [[w:FTP|FTP]]}} команду {{nobr|на выполнение}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpQuote(——command——)——————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:'''command'''
::Команда, которую должен выполнить {{nobr|сервер [[w:FTP|FTP]]}}.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpRename ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpRename''' переименовывает существующий файл {{nobr|на сервере [[w:FTP|FTP]]}}.
{{nobr|На серверах [[w:FTP|FTP]]}}, работающих {{nobr|под [[w:UNIX|UNIX]]}}, {{nobr|этот метод}} может также перемещать файл {{nobr|из одного}} каталога {{nobr|в другой}} {{nobr|с новым}} {{nobr|или прежним}} именем.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpRename(——remoteold,——remotenew——)———————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:'''remoteold'''
::Имя и, возможно, путь {{nobr|к файлу}} {{nobr|на сервере [[w:FTP|FTP]]}}, {{nobr|который будет}} переименован.

:'''remotenew'''
::Новое имя и, возможно, путь {{nobr|к файлу}} {{nobr|на сервере [[w:FTP|FTP]]}}.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpRmDir ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpRmDir''' удаляет каталог {{nobr|с сервера [[w:FTP|FTP]]}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpRmDir(——remotedir——)————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:'''remotedir'''
::Имя удаляемого каталога {{nobr|на сервере [[w:FTP|FTP]]}} и, возможно, путь {{nobr|к нему}}. {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то каталог}} удаляется {{nobr|из текущего}} каталога {{nobr|на сервере [[w:FTP|FTP]]}}.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpSetMode ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpSetMode''' устанавливает текущий&lt;ref name=&quot;default&quot; /&gt; {{nobr|режим [[w:FTP|FTP]]}} {{nobr|для приёма/передачи}} данных.
{{nobr|В случае}} ошибки текущий {{nobr|режим [[w:FTP|FTP]]}} {{nobr|не изменяется}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpSetMode(——mode——)———————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:'''mode'''
::Строка, идентифицирующая {{nobr|режим [[w:FTP|FTP]]}}, устанавливаемый {{nobr|в качестве}} текущего:

::'ACTIVE'
:::Активный режим [[w:FTP|FTP]].
::'PASSIVE'
:::Пассивный режим [[w:FTP|FTP]].

::Значащим является только первый символ строки, независимо от регистра.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpSetType ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpSetType''' устанавливает текущий&lt;ref name=&quot;default&quot; /&gt; тип представления&lt;ref name=&quot;ftp_type&quot; /&gt; данных, использующийся {{nobr|при приёме/передаче}} данных.
{{nobr|В случае}} ошибки текущий тип представления данных {{nobr|не изменяется}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpSetType(——type——)———————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:'''type'''
::Строка, идентифицирующая тип представления данных, устанавливаемый {{nobr|в качестве}} текущего:

::'ASCII'
:::Данные в текстовом представлении [[w:Ascii|ASCII]].
::'BINARY'
:::Данные в двоичном представлении.

::Значащим является только первый символ строки, независимо от регистра.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpSetUser ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpSetUser''' открывает сессию {{nobr|с сервером [[w:FTP|FTP]]}}, {{nobr|то есть}} устанавливает соединение {{nobr|и регистрирует}} пользователя.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpSetUser(——host,——user——+————————————————————————+——)————&amp;gt;&amp;lt;
                                   +——,——passw——+———————————+
                                                +——,——accn——+&lt;/span&gt;

'''''Аргументы''''':

:'''host'''
::Имя или [[w:IP|IP]]-адрес узла сервера [[w:FTP|FTP]].

:'''user'''
::Имя пользователя на сервере [[w:FTP|FTP]].

:'''passw'''
::Пароль пользователя.

:'''accn'''
::Информация об аккаунте пользователя.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.
:'''FTPHOST'''
::Имя узла неизвестно или сервер не отвечает.
:'''FTPSOCKET'''
::Ошибка функции библиотеки RxSock.
:'''FTPCONNECT'''
::Сервер не отвечает или не доступен.
:'''FTPLOGIN'''
::Имя пользователя, пароль или информация об аккаунте не верны.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpSite ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpSite''' отправляет {{nobr|серверу [[w:FTP|FTP]]}} сервисную команду.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpSite(——command——)———————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:'''command'''
::Сервисная команда, управляющая {{nobr|сервером [[w:FTP|FTP]]}}.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpSys ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpSys''' возвращает информацию {{nobr|об операционной}} системе {{nobr|сервера [[w:FTP|FTP]]}}.
{{nobr|Информация помещается}} {{nobr|в атрибут '''Response'''}} экземпляра класса {{nobr|в виде}} массива Object Rexx, единственным элементом которого является строка {{nobr|с информацией}} {{nobr|об операционной}} системе.
{{nobr|В случае}} ошибки возвращается пустой массив.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpSys()———————————————————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:Аргументов нет.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpTrace ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpTrace''' запускает трассировку {{nobr|команд [[w:FTP|FTP]]}}.
{{nobr|В начальном}} состоянии трассировка отключена.
{{nobr|После включения}} трассировки {{nobr|на консоли}} будут отображаться {{nobr|все команды}}, отправляемые {{nobr|на сервер [[w:FTP|FTP]]}}, {{nobr|и полученные}} {{nobr|от него}} ответы.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpTrace()—————————————————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:Аргументов нет.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpTraceLog ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpTraceLog''' помещает {{nobr|все команды}}, отправляемые {{nobr|на сервер [[w:FTP|FTP]]}}, {{nobr|и полученные}} {{nobr|от него}} ответы {{nobr|в текущий}} буфер трассировки {{nobr|с последующей}} записью его {{nobr|в файл}} журнала.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpTraceLog(——localfile——+—————————————+——)————————————————&amp;gt;&amp;lt;
                                  +——,——action——+&lt;/span&gt;

'''''Аргументы''''':

:'''localfile'''
::Имя и, возможно, путь {{nobr|к локальному}} файлу журнала. {{nobr|Если путь}} {{nobr|не указан}}, {{nobr|то используется}} локальный текущий каталог.

:'''action'''
::Строка, задающая действие {{nobr|при записи}} файла журнала:

::'REPLACE'
:::Если файл журнала уже существует, то перед записью новых данных {{nobr|он будет}} очищен.

::Значащим является только первый символ строки, независимо от регистра. {{nobr|Если аргумент}} опущен {{nobr|и файл}} журнала существует, {{nobr|то новые}} данные дописываются {{nobr|в конец}} файла.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpTraceLogoff ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpTraceLogoff''' останавливает трассировку {{nobr|команд [[w:FTP|FTP]]}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpTraceLogoff()———————————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:Аргументов нет.

'''''Возвращаемое значение''''':

::Значение '''0''' возвращается {{nobr|в случае}} успешного выполнения. Значение '''-1''' возвращается {{nobr|в случае}} возникновение ошибки {{nobr|в ходе}} выполнения. Конкретный код ошибки можно узнать, обратившись {{nobr|к атрибуту '''FtpErrno'''}} экземпляра класса.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpVersion ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Метод '''FtpVersion''' возвращает номер версии библиотеки {{nobr|классов RxFtp}} {{nobr|в формате '''x.y.z'''}}.

'''''Синтаксис''''':
 &lt;span style=&quot;color:#004040&quot;&gt;&amp;gt;&amp;gt;——obj~FtpVersion()———————————————————————————————————————————————&amp;gt;&amp;lt;&lt;/span&gt;

'''''Аргументы''''':

:Аргументов нет.

'''''Возвращаемое значение''''':

:Строка с номером версии библиотеки {{nobr|классов RxFtp}} {{nobr|в формате '''x.y.z'''}}.

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

== Дополнительные атрибуты RxFtp ==
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Каждый параграф этой главы описывает один {{nobr|из дополнительных}} атрибутов {{nobr|класса RxFtp}}.
 |}
&lt;/div&gt;

=== BufSize ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Атрибут '''BufSize''' содержит размер буфера, используемого {{nobr|методами RxFtp}}.
{{nobr|По умолчанию}}, {{nobr|он равен 4096}} {{nobr|и может быть}} изменён присвоением любого целого положительного значения.
Увеличение размера буфера может ускорить выполнение {{nobr|транзакций [[w:FTP|FTP]]}}.
{{nobr|Однако, чрезмерно}} большой размер буфера может, наоборот, {{nobr|замедлить их}}.
{{nobr|В каждом}} конкретном случае {{nobr|это выясняется}} экспериментальным путём.
{{nobr|Приведённый ниже}} пример демонстрирует отображение текущего размера буфера {{nobr|на консоли}} {{nobr|и изменение}} его размера {{nobr|до 8192}}.

'''''Пример''''':

 &lt;span style=&quot;color:#004040&quot;&gt;. . .
 say obj~BufSize
 obj~BufSize = 8192
 . . .&lt;/span&gt;

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== CmdResponse ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Атрибут '''CmdResponse''' представляет собой массив Object Rexx, содержащий, {{nobr|в качестве}} элементов, строки {{nobr|с командами}}, отправленными {{nobr|серверу [[w:FTP|FTP]]}}, {{nobr|и его ответы}} {{nobr|на них}}.
{{nobr|Новые элементы}} последовательно добавляются {{nobr|к этому}} массиву {{nobr|при каждом}} вызове методов класса {{nobr|в текущей}} {{nobr|сессии [[w:FTP|FTP]]}}.
{{nobr|Этот массив}} содержит полный протокол действий пользователя {{nobr|и реакции}} сервера
{{nobr|на них}} {{nobr|в форме}} {{nobr|«команда - ответ»}}.
{{nobr|Приведённый ниже}} пример отображает {{nobr|на консоли}} содержимое атрибута.

'''''Пример''''':

 &lt;span style=&quot;color:#004040&quot;&gt;. . .
 do i = 1 to obj~cmdresponse~items
    say obj~cmdresponse[i]
 end
 . . .&lt;/span&gt;

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== CR_Remove ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Атрибут '''CR_Remove''' может находиться {{nobr|в одном}} {{nobr|из двух}} состояний.
{{nobr|Если он}} установлен {{nobr|в состояние '''.true'''}}, {{nobr|то символы}} {{nobr|«возврат каретки» ('0D'x, CR)}} будут автоматически удаляться {{nobr|при загрузке}} файлов {{nobr|в текстовом}} {{nobr|представлении [[w:Ascii|ASCII]]}}, {{nobr|когда класс RxFtp}} исполняется {{nobr|на платформе [[w:UNIX|UNIX]]}}.
{{nobr|Если он}} установлен {{nobr|в состояние '''.false'''}}, {{nobr|то символы}} {{nobr|«возврат каретки» ('0D'x, CR)}} останутся {{nobr|в сохраняемом}} {{nobr|локальном файле}}.
{{nobr|Атрибут игнорируется}} машинами {{nobr|на платформах}}, отличных {{nobr|от [[w:UNIX|UNIX]]}}.
{{nobr|По умолчанию}} используется {{nobr|значение '''.true'''}}.
{{nobr|Приведённый ниже}} пример отключает удаление {{nobr|символов «возврат каретки»}}.

'''''Пример''''':

 &lt;span style=&quot;color:#004040&quot;&gt;. . .
 obj~cr_remove = .false
 . . .&lt;/span&gt;

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== Debug ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Атрибут '''Debug''' может находиться {{nobr|в одном}} {{nobr|из двух}} состояний.
{{nobr|Если он}} установлен {{nobr|в состояние '''.true'''}}, {{nobr|то на STDOUT}} будут отправляться отладочные сообщения.
{{nobr|Если он}} установлен {{nobr|в состояние '''.false'''}}, {{nobr|то все}} отладочные сообщения подавляются.
{{nobr|По умолчанию}} используется {{nobr|значение '''.false'''}}.
{{nobr|Приведённый ниже}} пример включает режим отладки.

'''''Пример''''':

 &lt;span style=&quot;color:#004040&quot;&gt;. . .
 obj~debug = .true
 . . .&lt;/span&gt;

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== FtpErrno ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Атрибут '''FtpErrno''' содержит расширенную информацию {{nobr|об ошибке}}, возникшей {{nobr|во время}} выполнения {{nobr|метода RxFtp}}. 
{{nobr|Это может быть}} строка {{nobr|с кодом}} ошибки {{nobr|или строка}} нулевой длины, {{nobr|если метод}} завершился {{nobr|без ошибок}}.

'''''Возможные значения кода ошибки''''':

:'''FTPCOMMAND'''
::Ошибка {{nobr|при выполнении}} внутренней {{nobr|команды [[w:FTP|FTP]]}} {{nobr|или в аргументах}}, переданных методу {{nobr|при вызове}}.
:'''FTPHOST'''
::Имя узла неизвестно или сервер не отвечает.
:'''FTPSOCKET'''
::Ошибка функции библиотеки RxSock.
:'''FTPCONNECT'''
::Сервер не отвечает или не доступен.
:'''FTPLOGIN'''
::Имя пользователя, пароль или информация об аккаунте не верны.

{{nobr|Приведённый ниже}} пример демонстрирует отображение информации {{nobr|об ошибке}} {{nobr|на консоли}}.

'''''Пример''''':

 &lt;span style=&quot;color:#004040&quot;&gt;. . .
 if obj~ftperrno &amp;lt;&amp;gt; &amp;quot;&amp;quot; then say obj~ftperrno
 . . .&lt;/span&gt;

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

=== Response ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Атрибут '''Response''' может находиться {{nobr|в одном}} {{nobr|из двух}} состояний.
{{nobr|Если он}} тождественнен {{nobr|объекту '''.nil'''}}, {{nobr|то это}} значит, {{nobr|что выполненная}} команда {{nobr|не сгенерировала}} ответ.
{{nobr|Во всех}} остальных случаях {{nobr|атрибут '''Response'''}} представляет собой массив {{nobr|Object Rexx}}, содержащий, {{nobr|в качестве}} элементов, строки сгенерированного {{nobr|командой ответа}}.
Типичным {{nobr|значением '''Response'''}} можно считать возвращаемый {{nobr|методом '''FtpDir'''}} список содержимого каталога.
{{nobr|Приведённый ниже}} пример отображает {{nobr|на консоли}} содержимое атрибута.

'''''Пример''''':

 &lt;span style=&quot;color:#004040&quot;&gt;. . .
 if obj~response &amp;lt;&amp;gt; .nil then do i = 1 to obj~response~items
    say obj~response[i]
 end
 . . .&lt;/span&gt;

[[#BufSize|BufSize]]&amp;nbsp;.
[[#CmdResponse|CmdResponse]]&amp;nbsp;.
[[#CR_Remove|CR_Remove]]&amp;nbsp;.
[[#Debug|Debug]]&amp;nbsp;.
[[#FtpAppend|FtpAppend]]&amp;nbsp;.
[[#FtpChDir|FtpChDir]]&amp;nbsp;.
[[#FtpDelete|FtpDelete]]&amp;nbsp;.
[[#FtpDir|FtpDir]]&amp;nbsp;.
[[#FtpErrno|FtpErrno]]&amp;nbsp;.
[[#FtpGet|FtpGet]]&amp;nbsp;.
[[#FtpGetMode|FtpGetMode]]&amp;nbsp;.
[[#FtpGetType|FtpGetType]]&amp;nbsp;.
[[#FtpLogoff|FtpLogoff]]&amp;nbsp;.
[[#FtpLs|FtpLs]]&amp;nbsp;.
[[#FtpMkDir|FtpMkDir]]&amp;nbsp;.
[[#FtpPut|FtpPut]]&amp;nbsp;.
[[#FtpPutUnique|FtpPutUnique]]&amp;nbsp;.
[[#FtpPwd|FtpPwd]]&amp;nbsp;.
[[#FtpQuote|FtpQuote]]&amp;nbsp;.
[[#FtpRename|FtpRename]]&amp;nbsp;.
[[#FtpRmDir|FtpRmDir]]&amp;nbsp;.
[[#FtpSetMode|FtpSetMode]]&amp;nbsp;.
[[#FtpSetType|FtpSetType]]&amp;nbsp;.
[[#FtpSetUser|FtpSetUser]]&amp;nbsp;.
[[#FtpSite|FtpSite]]&amp;nbsp;.
[[#FtpSys|FtpSys]]&amp;nbsp;.
[[#FtpTrace|FtpTrace]]&amp;nbsp;.
[[#FtpTraceLog|FtpTraceLog]]&amp;nbsp;.
[[#FtpTraceLogoff|FtpTraceLogoff]]&amp;nbsp;.
[[#FtpVersion|FtpVersion]]&amp;nbsp;.
[[#Response|Response]]&amp;nbsp;.
 |}
&lt;/div&gt;

== Приложения ==

=== Пример программы, использующей класс RxFtp ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Следующий ниже пример демонстрирует использование методов библиотеки {{nobr|классов RxFtp}}.

 &lt;span style=&quot;color:#004040&quot;&gt;
 /*============================================================*/
 /* Basic RxFTP sample to send a file with cmd/reply logging   */
 /*============================================================*/
 
 /* Define the variables for: */
 server = &amp;quot;127.0.0.1&amp;quot; /* IP address or server name */
 userid = &amp;quot;remote_user_ID&amp;quot;
 passwd = &amp;quot;password_of_remote_user&amp;quot;
 trclog = &amp;quot;logfile.txt&amp;quot; /* Trace log file name */
 retc = 0 /* Set return code to 0 */
 myftp = .rxftp~new()
 
 /* Start tracing FTP commands and logging of replies */
 retc = myftp~FtpTrace()
 
 /* Trace log file will be replaced, not appended to. */
 retc = myftp~FtpTraceLog(trclog, &amp;quot;R&amp;quot;)
 If retc = 0 then 
    Say &amp;quot; Replies will be written to log file: &amp;quot;trclog&amp;quot;.&amp;quot;
 Else 
    Say &amp;quot; No writing to log file: &amp;quot;trclog&amp;quot; possible.&amp;quot;
 
 /* Define remote host and user to be used during the session */
 retc = myftp~FtpSetUser(server, userid, passwd)
 If retc = 0 then Say &amp;quot; Connection established.&amp;quot;
 Else Call Terminate &amp;quot; *** Connection failed.&amp;quot;
 
 /* Transfer an ASCII file to the remote ftp server */
 retc = myftp~FtpPut(&amp;quot;sample.rex&amp;quot;, &amp;quot;sample.put&amp;quot;, &amp;quot;ASCII&amp;quot;)
 If retc = 0 then Call Terminate &amp;quot; File has been sent. &amp;quot;
 Else Call Terminate &amp;quot; *** File has NOT been sent.&amp;quot;
 
 /* Terminate the file transfer */
 Terminate:
 Parse Arg Message
 Say Message
 Say &amp;quot;FtpErrNo =&amp;quot; myftp~ftperrno
 retc = myftp~FtpLogoff()
 retc = myftp~FtpTraceLogoff()
 retc = myftp~FtpTrace()
 exit retc
 
 ::requires &amp;quot;rxftp.cls&amp;quot;
 &lt;/span&gt;

 |}
&lt;/div&gt;

=== Замечания ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Любая ссылка {{nobr|на продукт}}, программу {{nobr|или службу}}, {{nobr|не являющуюся}} программным обеспечением {{nobr|с открытым}} исходным кодом, {{nobr|не означает}} {{nobr|и не подразумевает}}, {{nobr|что может}} использоваться только продукт, программа {{nobr|или служба}}, {{nobr|не явлющаяся}} программным обеспечением {{nobr|с открытым}} {{nobr|исходным кодом}}.
{{nobr|Вместо этого}} может использоваться любой функционально эквивалентный продукт, программа {{nobr|или служба}}, {{nobr|не нарушающая}} право интеллектуальной собственности Rexx Language {{nobr|Association (RexxLA)}}.
{{nobr|Однако, пользователь}} может оценить {{nobr|и проверить}} работу {{nobr|любого продукта}}, программы {{nobr|или службы}}, {{nobr|не явлющихся}} программным обеспечением {{nobr|с открытым}} исходным кодом.

{{nobr|Все данные}} {{nobr|о производительности}}, {{nobr|содержащиеся здесь}}, {{nobr|были получены}} {{nobr|в определенной}} {{nobr|операционной среде}}.
{{nobr|Поэтому результаты}}, полученные {{nobr|в другой}} операционной среде, могут {{nobr|значительно отличаться}}.
{{nobr|Некоторые замеры}}, возможно, были сделаны {{nobr|в системах}} уровня разработки {{nobr|и нет}} {{nobr|никакой гарантии}}, {{nobr|что такие же}} замеры дадут {{nobr|те же самые}} результаты {{nobr|в общедоступных}} системах.
{{nobr|Кроме того}}, некоторые результаты, возможно, были получены методом экстраполяции.
{{nobr|Фактические же}} результаты могут отличаться.
Пользователи этого документа должны проверить применимость данных {{nobr|для своей}} операционной среды.

Информация {{nobr|о продуктах}}, {{nobr|не являющихся}} программным обеспечением {{nobr|с открытым}} исходным кодом, была получена {{nobr|от поставщиков}} {{nobr|этих продуктов}}, опубликованных объявлений {{nobr|или других}} публично доступных источников.
{{nobr|RexxLA не тестировала}} {{nobr|эти продукты}} {{nobr|и не может}} подтвердить точность сведений {{nobr|о производительности}}, совместимости {{nobr|или любых}} {{nobr|других требований}}, связанных {{nobr|с пакетами}}, {{nobr|не принадлежащими RexxLA}}.
Вопросы {{nobr|о возможностях}} пакетов, {{nobr|не принадлежащих RexxLA}}, должны адресоваться поставщикам {{nobr|этих продуктов}}.

{{nobr|Все заявления}} относительно будущего направления {{nobr|и перспектив}} {{nobr|развития  RexxLA}} {{nobr|могут быть}} измененены {{nobr|или отброшены}} {{nobr|без уведомления}} {{nobr|и отражают}} только поставленные цели {{nobr|и задачи}}.

Этот документ содержит примеры данных {{nobr|и отчетов}}, использующихся {{nobr|в ежедневных}} {{nobr|деловых операциях}}.
{{nobr|Чтобы проиллюстрировать}} их максимально полно, примеры включают {{nobr|в себя}} имена людей, компаний, брендов {{nobr|и продуктов}}.
{{nobr|Все эти имена}} — вымышленные {{nobr|и любые}} совпадения имен {{nobr|и адресов}}, используемых вымышленными коммерческими предприятиями, полностью случайны.
 |}
&lt;/div&gt;

==== Торговые марки ====
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Open Object Rexx и ooRexx — торговая марка Rexx Language Association.

Следующие названия являются торговыми марками IBM Corporation {{nobr|в США}}, {{nobr|в других}} странах {{nobr|или во всём}} мире:
:1-2-3
:AIX
:IBM
:Lotus
:OS/2
:S/390
:VisualAge

AMD — торговая марка Advance Micro Devices, Inc.

Intel, Intel Inside (логотипы), MMX и Pentium  — торговые марки Intel Corporation {{nobr|в США}}, {{nobr|в других}} странах {{nobr|или во всём}} мире.

Java и все, относящиеся к Java, торговые марки принадлежат Sun {{nobr|Microsystems, Inc}}. {{nobr|в США}}, {{nobr|в других}} странах {{nobr|или во всём}} мире.

Linux — торговая марка Linus Torvalds {{nobr|в США}}, {{nobr|в других}} странах {{nobr|или во всём}} мире.

Microsoft, Windows, Windows NT и логотип Windows — торговые марки Microsoft Corporation {{nobr|в США}}, {{nobr|в других}} странах {{nobr|или во всём}} мире.

UNIX — зарегистрированная торговая марка Open Group {{nobr|в США}} {{nobr|и в других}} странах.

Имена других компаний, продуктов {{nobr|или служб}} могут быть {{nobr|чьими-то}} торговыми {{nobr|или сервисными}} марками.
 |}
&lt;/div&gt;

==== Исходный код документа ====
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
Исходный код этого документа доступен {{nobr|на условиях}} [[w:Common_Public_License|Common Public License {{nobr|Version 1.0}}]], которая распространяется {{nobr|вместе с документом}} {{nobr|и доступна}} {{nobr|в приложении}} «Common Public License {{nobr|Version 1.0}}».
{{nobr|Сам исходный код}} документа доступен {{nobr|на странице}}
[http://sourceforge.net/project/showfiles.php?group_id=119701 http://sourceforge.net/project/showfiles.php?group_id=119701].
{{nobr|Исходный код}} {{nobr|этого документа}} подготовлен {{nobr|в формате}} DocBook {{nobr|SGML/XML}}.
 |}
&lt;/div&gt;

=== Common Public License Version 1.0 ===
&lt;div align=&quot;justify&quot; style=&quot;background:#e8e8e8&quot;&gt;
{| border=&quot;0&quot; cellpadding=&quot;10&quot;
 |
'''От переводчика:''' ссылки {{nobr|на перевод}} текста лицензии можно найти {{nobr|на странице}} [[w:Common_Public_License|Common Public License {{nobr|Version 1.0}}]] {{nobr|в Википедии}}.
 |}
&lt;/div&gt;

== Примечания переводчика ==
&lt;div align=&quot;justify&quot;&gt;
&lt;references&gt;
&lt;ref name=&quot;tolmach&quot;&gt;Дополнения от переводчика, касающиеся сравнения данной библиотеки {{nobr|с библиотекой}} {{nobr|функций RxFtp}} {{nobr|Classic Rexx}}, вынесены {{nobr|на отдельные}} страницы.
&lt;/ref&gt;
&lt;ref name=&quot;keywords&quot;&gt;Дополнительно к сказанному, авторы документа придерживаются правила записи имен методов {{nobr|и атрибутов}} класса {{nobr|на синтаксических}} диаграммах смешанным стилем {{nobr|с использованием}} прописных {{nobr|и строчных}} букв, например, &lt;span style=&quot;color:#004040&quot;&gt;&lt;tt&gt;FtpAppend&lt;/tt&gt;&lt;/span&gt;.
&lt;/ref&gt;
&lt;ref name=&quot;transfer_mode&quot;&gt;В оригинале — '''mode'''.
{{nobr|А в описании}} аргумента авторы используют термин «режим передачи» ({{lang-en|transfer mode}}).
Однако, {{nobr|в {{RFC|959}}}} понятие «режим передачи» ({{lang-en|transfer mode}}) увязано {{nobr|со способом}} организации данных {{nobr|для передачи}}, задаваемым {{nobr|командой [[w:FTP|FTP]]}} '''MODE''': STREAM, BLOCK {{nobr|или COMPRESSED}}.
{{nobr|А ключевые}} слова BINARY {{nobr|и ASCII}} связаны {{nobr|с понятием}} «тип представления» ({{lang-en|representation type}}), {{nobr|то есть с тем}}, {{nobr|что представляют}} собой передаваемые данные — {{nobr|текст в [[w:Ascii|ASCII]]}}, {{nobr|текст в [[w:EBCDIC|EBCDIC]]}}, просто двоичные данные {{nobr|и так далее}}.
Задаёт тип представления данных, используемый {{nobr|при передаче}} {{nobr|и хранении}}, {{nobr|команда [[w:FTP|FTP]]}} '''TYPE''': ASCII, EBCDIC, IMAGE {{nobr|(он же BINARY)}} {{nobr|и так далее}}.
Поэтому {{nobr|при переводе}}, {{nobr|чтобы устранить}} возникающую путаницу, переводчик счёл возможным изменить имя аргумента '''mode''' {{nobr|на '''type'''}} {{nobr|в описании}} синтаксиса {{nobr|и применить}} более подходящий термин «тип представления» {{nobr|в описании}} аргумента.
&lt;/ref&gt;
&lt;ref name=&quot;default&quot;&gt;При инициализации экземпляра класса текущими становятся пассивный {{nobr|режим [[w:FTP|FTP]]}} {{nobr|и тип}} представления данных {{nobr|в виде}} {{nobr|текста [[w:Ascii|ASCII]]}}.
&lt;/ref&gt;
&lt;ref name=&quot;typo_get&quot;&gt;В оригинале — '''FtpSetType''', но это явно опечатка.
&lt;/ref&gt;
&lt;ref name=&quot;ftp_mode&quot;&gt;В оригинале — {{lang-en|transfer mode}} (режим передачи).
Однако, {{nobr|в {{RFC|959}}}} понятие «режим передачи» ({{lang-en|transfer mode}}) увязано {{nobr|со способом}} организации данных {{nobr|для передачи}}, задаваемым {{nobr|командой [[w:FTP|FTP]]}} '''MODE''': STREAM, BLOCK {{nobr|или COMPRESSED}}.
{{nobr|Понятия же}} {{nobr|«активный режим»}} {{nobr|и «пассивный режим»}} связаны {{nobr|с различием}} способов организации канала данных, применяемых {{nobr|командами [[w:FTP|FTP]]}} '''PORT''' {{nobr|и '''PASV'''}}.
Поэтому {{nobr|при переводе}}, {{nobr|чтобы устранить}} возникающую путаницу, переводчик использовал термин {{nobr|«режим [[w:FTP|FTP]]»}}.
&lt;/ref&gt;
&lt;ref name=&quot;ftp_type&quot;&gt;В оригинале — {{lang-en|transfer type}} (тип передачи).
Переводчик счёл более уместным использовать термин {{nobr|«тип представления»}} {{nobr|({{lang-en|representation type}})}} {{nobr|из {{RFC|959}}}}.
&lt;/ref&gt;
&lt;ref name=&quot;name_unique&quot;&gt;Новое уникальное имя обычно образуется добавлением цифрового индекса {{nobr|к имени}} файла.
&lt;/ref&gt;
&lt;/references&gt;
&lt;/div&gt;</text>
      <sha1>j7p3h3o9wvvbe48qkkenqptgniv0p36</sha1>
    </revision>
  </page>
  <page>
    <title>Python/Учебник Python 3.6</title>
    <ns>0</ns>
    <id>21968</id>
    <revision>
      <id>270437</id>
      <parentid>256476</parentid>
      <timestamp>2026-10-27T07:39:27Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270437</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="374445" sha1="271qn6cc1zofvsrbfjb9tpuic6smdv0" xml:space="preserve">{{Python/DocPart}}

__TOC__


=== Описание ===

Python — мощный и простой для изучения язык программирования. В нём предоставлены проработанные высокоуровневые структуры данных и простой, но эффективный подход к объектно-ориентированному программированию. Сочетание изящного синтаксиса и динамической типизации, совмещённых с интерпретируемой сущностью, делает Python идеальным языком для написания сценариев и ускоренной разработки приложений в различных сферах и на большинстве платформ.

Интерпретатор Python и разрастающаяся стандартная библиотека находятся в свободном доступе в виде исходников и бинарных файлов для всех основных платформ на официальном сайте Python http://www.python.org и могут распространяться без ограничений. Кроме этого на сайте содержатся дистрибутивы и ссылки на многочисленные модули третьих сторон для языка Python, различные программы и инструменты, а также дополнительная документация.

Интерпретатор Python может быть легко расширен с помощью новых функций и типов данных, написанных на C/C++ (или других языков, к которым можно получить доступ из C). Также Python можно применять как язык расширений для настраиваемых приложений.

Этот учебник неформально представляет читателю основные концепции и возможности языка и системы Python. Полезно держать интерпретатор Python под рукой для получения практического опыта, но при этом все примеры самодостаточны, так что учебник вполне возможно читать вне сети.

Описание стандартных объектов и модулей вы можете найти в [[Справочник по библиотеке Python 3.1|справочнике по библиотеке Python]]. [[Справочник по языку Python 3.1|Руководство по языку]] даёт более формальное описание языка. Перед написанием расширений на C/C++ ознакомьтесь с [[Расширение и встраивание - Python 3.1|руководством по расширению и встраиванию в интерпретатор]] и [[Python 3.1 - C API|справочником по Python/C API]]. Существует также несколько книг, в которых подробно рассмотрен язык Python.

Этот учебник не претендует на звание всеобъемлющего и не описывает каждую особенность Python: он даже не описывает ''всех'' его часто использующихся особенностей. Вместо этого он знакомит читателя с наиболее заслуживающими внимания из них и даёт вам представление о стиле и ''привкусе'' языка. После прочтения учебника вы сможете писать и читать программы и модули, написанные на Python, и будете готовы узнать больше о различных модулях библиотеки Python, описанных в [[Справочник по библиотеке Python 3.1|справочнике по библиотеке Python]].

Кроме того, будет нелишним полистать [[Глоссарий Python 3.1|Глоссарий]].

== Разжигая ваш аппетит ==

Если вы много работаете за компьютером — то периодически обнаруживаете задачи, которые хотели бы автоматизировать. Например, вы были бы не против ускорить операцию поиска и замены большого количества текстовых файлов, или как-то своеобразно переименовать и отсортировать набор фотографий. Возможно, вам хотелось бы написать небольшую базу данных на заказ, специализированное GUI-приложение или простую игру.

Если вы профессиональный разработчик программных продуктов — вероятно, вы привыкли работать с несколькими библиотеками на C/C++/Java, но находите обычный цикл написания/компиляции/тестирования/перекомпиляции кода чересчур медленным. Возможно, вы пишете набор тестов для такой библиотеки и процесс написания тестирующего кода воспринимается утомительным. Или же вы написали программу, которая должна использовать специальный язык для расширений и не хотите проектировать и разрабатывать полностью новый язык для вашего приложения.

Python — язык, который вам подойдёт.

Вы можете написать шелл-сценарий для Unix или использовать пакетные файлы Windows для некоторых из этих задач, но шелл-сценарии хороши лишь для перемещения файлов и замены текстовых данных — они вряд ли подойдут для написания приложений, снабженных графическим интерфейсом, или игр. Вы можете написать программу на C/C++/Java, но разработка может занять довольно много времени — даже на то, чтобы получить первый рабочий набросок, его требуется немало. Python — проще в использовании, доступен на операционных системах Windows, Mac OS X и Unix, и поможет сделать работу намного быстрее.

Даже учитывая лёгкость использования, Python — полноценный язык программирования, предлагающий много больше возможностей для структурирования и поддержки крупных программ, чем могут позволить себе шелл-сценарии или пакетные файлы. С другой стороны, Python также предоставляет намного больше информации для отладки ошибок чем C и, будучи ''сверх-высокоуровневым-языком'', имеет встроенные высокоуровневые типы данных — такие, как гибкие массивы и словари. Благодаря наличию обобщённых типов данных Python применим для более широкого круга приложений, чем Awk или даже Perl, и при этом очень многие вещи остаются в языке Python как минимум настолько же простыми, насколько просты в этих языках.

Python позволяет вам разделить вашу программу на модули, которые могут быть заново использованы в других программах на Python. Он поставляется вместе с внушительной коллекцией стандартных модулей, которые вы можете использовать в качестве фундамента ваших программ; или в качестве примеров для того, чтобы начать изучение Python. Многие из этих модулей предоставляют различную полезную функциональность: например, ввод-вывод для файлов, системные вызовы, сокеты, и даже инструменты для создания графического пользовательского интерфейса&amp;nbsp;— например, Tk.

Python — интерпретируемый язык, и это может сохранить вам немало времени при разработке — в компиляции и связывании нет необходимости. Интерпретатор может использоваться в интерактивном режиме, что позволяет легко экспериментировать с возможностями языка, писать программы-однодневки или проверять функции во время разработки программ методом снизу-вверх. И, кроме всего прочего — это удобный настольный калькулятор.

Python даёт возможность писать компактные и удобочитаемые программы. Программы, написанные на Python, отличаются большей краткостью, чем эквиваленты на C, C++ или Java по нескольким причинам:

* высокоуровневые типы данных позволяют вам выражать сложные операции в одной инструкции;
* группировка инструкций выполняется отступами, а не операторными скобками;
* нет необходимости в описании переменных или аргументов.

Python ''расширяем'': если вы знаете, как программировать на C, то вам легко будет добавить к интерпретатору новую встроенную функцию или модуль, выполнить критические операции на максимальной скорости или связать программы на Python с библиотеками, которые могут быть доступны только в бинарной форме (например, зависящие от поставщика графические библиотеки). Если вы действительно увлечены — вы можете привязать интерпретатор Python к приложению, написанному на C — чтобы использовать его как язык расширений или командный язык этого приложения.

Кстати, язык назван в честь шоу «Летающий цирк Монти Пайтона» на BBC и не имеет ничего общего с рептилиями. Ссылки на скетчи Монти Пайтона в документации не только позволены, но и поощряются!

Теперь, когда ваш интерес к Python полностью пробужден, вам наверняка захочется изучить его более детально. В связи с тем, что лучший способ выучить язык — использовать его — автор приглашает вас использовать интерпретатор Python в процессе чтения.

В следующей главе описана механика использования интерпретатора. Это довольно приземленная информация, но она необходима для работы с примерами, которые будут представлены позже.

Остальная часть учебника описывает различные возможности языка и системы Python за счёт примеров — начиная с простых выражений, операторов и типов данных, рассматривая функции и модули, и заканчивая прикосновением к таким продвинутым концепциям как исключения и определённые пользователем&lt;ref&gt;''(Прим. перев.)'' Здесь и далее по учебнику понятия пользователя и программиста в некоторые моменты пересекаются, ввиду того что последний рассматривается как «пользователь языка». Обычно это понятно из контекста, но тем не менее, на всякий случай, поясняю.&lt;/ref&gt; классы.

== Использование интерпретатора Python ==

=== Запуск интерпретатора ===

Интерпретатор Python после установки располагается, обычно, по пути &lt;tt&gt;/usr/local/bin/python3.1&lt;/tt&gt; — на тех компьютерах, где этот путь доступен. Добавление каталога &lt;tt&gt;/usr/local/bin&lt;/tt&gt; к пути поиска Unix-шелла (переменная &lt;tt&gt;PATH&lt;/tt&gt;) позволит запустить интерпретатор набором команды

&lt;code&gt;python3.1&lt;/code&gt;

прямо из шелла&lt;ref&gt;В случае операционных систем UNIX, интерпретатор версии 3.1 по умолчанию устанавливается с исполняемым файлом, имеющим имя, отличное от &lt;tt&gt;python&lt;/tt&gt; — дабы не иметь конфликтов с (возможно) установленным исполняемым файлом версии 2.6&lt;/ref&gt;. Поскольку выбор каталога, в котором будет обитать интерпретатор, осуществляется при его установке, то возможны и другие варианты — посоветуйтесь с вашим Python-гуру или системным администратором. (Например, путь &lt;tt&gt;/usr/local/python&lt;/tt&gt; тоже популярен в качестве альтернативного расположения.)

На машинах с ОС Windows, инсталляция Python обычно осуществляется в каталог &lt;tt&gt;C:\Python31&lt;/tt&gt;, но и он может быть изменён во время установки. Чтобы добавить этот каталог к вашему пути поиска, вы можете набрать в окне DOS следующую команду, в ответ на приглашение:

&lt;code&gt;set path=%path%;C:\python31&lt;/code&gt;

При наборе символа конца файла (&lt;tt&gt;Ctrl-D&lt;/tt&gt; в Unix, &lt;tt&gt;Ctrl-Z&lt;/tt&gt; в Windows) в ответ на основное приглашение интерпретатора, последний будет вынужден закончить работу с нулевым статусом выхода. Если это не сработает — вы можете выйти из интерпретатора путём ввода следующих команд:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import sys; sys.exit()&lt;/syntaxhighlight&gt;

Особенности редактирования строк в интерпретаторе не оказываются обычно чересчур сложными. Те, кто установил интерпретатор на машину Unix, потенциально имеют поддержку библиотеки &lt;tt&gt;GNU readline&lt;/tt&gt;, обеспечивающей усовершенствованное интерактивное редактирование и сохранение истории. Самый быстрый, наверное, способ проверить, поддерживается ли расширенное редактирование командной строки, заключается в нажатии &lt;tt&gt;Ctrl-P&lt;/tt&gt; в ответ на первое полученное приглашение Python. Если вы услышите сигнал — значит вам доступно редактирование командной строки — тогда обратитесь к [[Учебник Python 3.1 — Приложения#Интерактивное редактирование входных данных и подстановка истории|Приложению об Интерактивном редактировании входных данных]] за описанием клавиш. Если на ваш взгляд ничего не произошло или отобразился символ &lt;tt&gt;^P&lt;/tt&gt; — редактирование командной строки недоступно — удалять символы из текущей строки возможно будет лишь использованием клавиши &lt;tt&gt;Backspace&lt;/tt&gt;.

Интерпретатор ведёт себя сходно шеллу Unix: если он вызван, когда ''стандартный ввод'' привязан к устройству &lt;tt&gt;tty&lt;/tt&gt; — он считывает и выполняет команды в режиме диалога; будучи вызванным с именем файла в качестве параметра или с файлом, назначенным на ''стандартный ввод'' — он читает и выполняет сценарий из этого файла.

Другой способ запустить интерпретатор — директива &lt;code&gt;'''python -c''' ''команда'' &lt;tt&gt;[arg]&lt;/tt&gt; ...&lt;/code&gt; — при её использовании поочередно выполняются инструкции(-ция) из ''команды'' (как при использовании опции '''-c''' Unix-шелла). В связи с тем, что инструкции Python часто содержат пробелы или другие специальные для шелла символы, рекомендуется заключать ''команды'' полностью в одинарные кавычки.

Некоторые модули Python оказываются полезными при использовании их в качестве сценариев. Они могут быть запущены в этом виде командой &lt;code&gt;'''python -m''' ''модуль'' &lt;tt&gt;[arg]&lt;/tt&gt; ...&lt;/code&gt; — таким образом исполняется исходный файл модуля (как произошло бы, если бы вы ввели его полное имя в командной строке).

Обратите внимание на различие между командами &lt;tt&gt;python file&lt;/tt&gt; и &lt;tt&gt;python &lt;file&lt;/tt&gt;. В последнем случае запросы на ввод из программы, такие как вызов &lt;code&gt;sys.stdin.read()&lt;/code&gt;, удовлетворяются из самого файла. Поскольку файл уже был прочитан до конца ещё до начала выполнения программы — символ конца файла будет обнаружен программой незамедлительно. В большинстве случаев (это, чаще всего, и есть те ситуации, которых вы ожидали) вызовы удовлетворяются независимо от того, файл или устройство привязаны к стандартному вводу интерпретатора Python.

При использовании файла сценария иногда полезно иметь возможность запустить сценарий и затем войти в интерактивный режим. Это может быть сделано через указание параметра '''-i''' перед именем сценария. (Этот способ не сработает, если сценарий считывается со стандартного ввода — по той самой причине, которая описана в предыдущем абзаце).

==== Передача параметров ====

В случае, если интерпретатору известны имя сценария и дополнительные параметры, с которыми он вызван, все они передаются сценарию в переменной &lt;code&gt;sys.argv&lt;/code&gt;, представляющей собой список (&lt;code&gt;list&lt;/code&gt;) строк. Длина (&lt;code&gt;length&lt;/code&gt;) списка — минимум, единица; если не переданы ни имя сценария, ни аргументы — то &lt;code&gt;sys.argv[0]&lt;/code&gt; содержит пустую строку. Когда в качестве имени сценария передан &lt;code&gt;'-'&lt;/code&gt; (означает ''стандартный ввод''), &lt;code&gt;sys.argv[0]&lt;/code&gt; устанавливается в &lt;code&gt;'-'&lt;/code&gt;. Если используется директива '''-c''' ''команда'' — &lt;code&gt;sys.argv[0]&lt;/code&gt; содержит &lt;code&gt;'-c'&lt;/code&gt;. В случае, если используется директива '''-m''' ''модуль'' — то &lt;code&gt;sys.argv[0]&lt;/code&gt; устанавливается равным полному имени модуля по расположению. Опции, обнаруженные после сочетаний '''-c''' ''команда'' или '''-m''' ''модуль'' не обрабатываются интерпретатором Python, но остаются в переменной &lt;code&gt;sys.argv&lt;/code&gt;, дабы обеспечить возможность отслеживания в самой команде или в модуле.

==== Интерактивный режим ====

Если команды считываются с &lt;tt&gt;tty&lt;/tt&gt; — говорят, что интерпретатор находится в ''интерактивном режиме'' (режиме диалога). В этом режиме он приглашает к вводу следующей команды, отобразив ''основное приглашение''&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;primary prompt&lt;/tt&gt; — ''зд.'', основное приглашение: приглашение к вводу команды или нескольких команд (сценария);&lt;/ref&gt; (обычно это три знака «больше-чем» — &lt;tt&gt;&amp;gt;&amp;gt;&amp;gt;&lt;/tt&gt;); в то же время, для ''продолжающих строк''&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;continuation lines&lt;/tt&gt; — ''зд.'', продолжающие строки (строки продолжения): строки, продолжающие текст команды (оператора, выражения), или раскрывающие внутреннее устройство внешнего оператора (команды, выражения), в последнем случае определяются дополнительным отступом от края — углублением в структуру;&lt;/ref&gt; выводится ''вспомогательное приглашение''&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;secondary prompt&lt;/tt&gt; — ''зд.'', вспомогательное приглашение: приглашение к продолжению ввода команды или набора команд (сценария) с использованием ''продолжающих строк'';&lt;/ref&gt; (по умолчанию — три точки — &lt;tt&gt;...&lt;/tt&gt;). Перед выводом первого приглашения интерпретатор отображает приветственное сообщение, содержащее номер его версии и пометку о правах копирования:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;$ python3.1
Python 3.1a1 (py3k, Sep 12 2007, 12:21:02)
[GCC 3.4.6 20060404 (Red Hat 3.4.6-8)] on linux2
Type &quot;help&quot;, &quot;copyright&quot;, &quot;credits&quot; or &quot;license&quot; for more information.
&gt;&gt;&gt;&lt;/syntaxhighlight&gt;

''Продолжающие строки'' используются в случаях, когда необходимо ввести многострочную конструкцию. Взгляните, например, на следующий оператор &lt;code&gt;if&lt;/code&gt;&lt;ref&gt;''(Прим. перев.)'' Здесь и далее тексты некоторых исходных кодов также будут переведены в примечаниях (вместе с ключевыми словами, поэтому их нельзя будет запустить в интерпретаторе), чтобы показать их смысл или задумку, которые не всегда очевидны без перевода (если он вам нужен :)):&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;&lt;span style=&quot;color: #aaa&quot;&gt;&gt;&gt;&gt;&lt;/span&gt; мир_плоский = 1&lt;br/&gt;
&lt;span style=&quot;color: #aaa&quot;&gt;&gt;&gt;&gt;&lt;/span&gt; '''если''' мир_плоский:&lt;br/&gt;
&lt;span style=&quot;color: #aaa&quot;&gt;...&lt;/span&gt;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;Будьте осторожны — не упадите!&quot;)&lt;br/&gt;
&lt;span style=&quot;color: #aaa&quot;&gt;...&lt;/span&gt; &lt;br/&gt;
&lt;span style=&quot;color: #030&quot;&gt;Будьте осторожны — не упадите!&lt;/span&gt;&lt;/code&gt;&lt;br /&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; the_world_is_flat = 1
&gt;&gt;&gt; if the_world_is_flat:
...     print(&quot;Be careful not to fall off!&quot;)
...
Be careful not to fall off!&lt;/syntaxhighlight&gt;

=== Интерпретатор и его окружение ===

==== Обработка ошибок ====

В случае появления ошибки интерпретатор выводит сообщение об ошибке, завершая его стеком вызовов. В интерактивном режиме он снова возвращается в состояние приглашения для ввода команд; если ввод происходит из файла — интерпретатор выходит с ненулевым статусом, сразу после распечатки стека вызовов. (Исключения, обрабатываемые в блоке &lt;code&gt;except&lt;/code&gt; оператора &lt;code&gt;try&lt;/code&gt; в этом контексте не считаются ошибками.) Некоторые ошибки исключительно фатальны и вызывают собой принудительное завершение работы с ненулевым статусом — это применимо к внутренним противоречиям языка и к некоторым случаям нехватки памяти. Все сообщения об ошибках выводятся в ''стандартный поток ошибок'' (&lt;tt&gt;error stream&lt;/tt&gt;). Обычный вывод исполняемых команд направляется в ''стандартный вывод''.

Нажатие клавиш прерывания процесса (обычно &lt;tt&gt;Ctrl-C&lt;/tt&gt; или &lt;tt&gt;DEL&lt;/tt&gt;), в ответ на приглашение в основном или вспомогательном режиме, отменяет ввод и возвращает вас к основному приглашению.&lt;ref&gt;Известная проблема в пакете &lt;tt&gt;GNU Readline&lt;/tt&gt; может этому помешать.&lt;/ref&gt; Символ прерывания, набранный во время выполнения какой-либо команды порождает исключение &lt;code&gt;KeyboardInterrupt&lt;/code&gt;, которое, в свою очередь, может быть перехвачено оператором &lt;code&gt;try&lt;/code&gt;.

==== Исполняемые сценарии на Python ====

На Unix-системах семейства BSD сценарии на Python могут быть сделаны исполняемыми, также как и шелл-сценарии, путём добавления следующей строки

&lt;code&gt;#! /usr/bin/env python3.1&lt;/code&gt;

(предполагается, что интерпретатор может быть найден по одному из путей, указанных в пользовательской переменной &lt;tt&gt;PATH&lt;/tt&gt;) в начало сценария и установки файла в исполняемый режим. Символы &lt;tt&gt;#!&lt;/tt&gt; должны быть первыми символами в файле. На некоторых платформах строка должна оканчиваться символом конца строки в стиле Unix (&lt;tt&gt;'\n'&lt;/tt&gt;), а не в стиле Windows (&lt;tt&gt;'\r\n'&lt;/tt&gt;). Заметьте, что символ решётки &lt;tt&gt;'#'&lt;/tt&gt; используется в Python для указания начала комментария.

Исполняемый режим (или разрешение на исполнение) может быть установлен сценарию использованием команды '''chmod''':

&lt;code&gt;$ chmod +x myscript.py&lt;/code&gt;

У систем с операционной системой Windows нет такого понятия, как исполняемый режим. Установщик Python автоматически связывает файлы &lt;tt&gt;.py&lt;/tt&gt; с файлом &lt;tt&gt;python.exe&lt;/tt&gt;, таким образом двойной клик на файле Python запустит его в виде сценария. Расширение может быть и &lt;tt&gt;.pyw&lt;/tt&gt; в случае, если окно консоли (которое, обычно, отображается) при запуске сценария подавляется.

==== Кодировка исходных файлов ====

По умолчанию, исходники Python считаются созданными в кодировке &lt;tt&gt;UTF-8&lt;/tt&gt;. В этой кодировке в строковых литералах, идентификаторах и комментариях могут быть использованы символы большинства языков мира — учитывая то, что стандартная библиотека Python использует символы &lt;tt&gt;ASCII&lt;/tt&gt; для именования идентификаторов — и этому соглашению должен следовать любой переносимый код. Для корректного отображения всех этих символов, ваш редактор должен опознавать файл как закодированный в &lt;tt&gt;UTF-8&lt;/tt&gt; и должен использовать шрифт, который содержит все символы, используемые в файле.

Также, есть возможность указать другую кодировку для исходных файлов. Для этого нужно добавить специальный комментарий следом за строкой &lt;tt&gt;#!&lt;/tt&gt;, дабы описать кодировку исходного файла:

&lt;code&gt;# -*- coding: encoding -*-&lt;/code&gt;

Если используется это описание — всё, что находится в этом файле будет опознаваться как имеющее соответствующую кодировку ''&lt;tt&gt;encoding&lt;/tt&gt;'', а не &lt;tt&gt;UTF-8&lt;/tt&gt;. Список возможных кодировок представлен в [[Справочник по библиотеке Python 3.1|Справочнике по библиотеке]] — в разделе, описывающем модуль [[Справочник по библиотеке Python 3.1#codecs|codecs]].

Например, если выбранный вами редактор не поддерживает файлы, закодированные &lt;tt&gt;UTF-8&lt;/tt&gt; и требует применения какой-либо другой кодировки, допустим &lt;tt&gt;Windows-1252&lt;/tt&gt;, вы можете написать:

&lt;code&gt;# -*- coding: cp-1252 -*-&lt;/code&gt;

И, с этого момента, использовать в исходных файлах только символы из таблицы символов &lt;tt&gt;Windows-1252&lt;/tt&gt;. Устанавливающий (отличную от установленной по умолчанию) кодировку специальный комментарий должен являться первой или второй строкой файла.

==== Интерактивный файл запуска ====

Если вы используете Python интерактивно — часто бывает удобным выполнить некоторые стандартные команды перед запуском интерпретатора. Вы можете сделать это, установив переменную окружения с именем &lt;tt&gt;PYTHONSTARTUP&lt;/tt&gt; равной имени файла, содержащего ваши команды запуска. Способ схож с использованием файла &lt;tt&gt;.profile&lt;/tt&gt; в Unix-шелле.

Этот файл читается только в интерактивных сессиях, но не в случае считывания команд из сценария, и не в случае, если &lt;tt&gt;/dev/tty&lt;/tt&gt; назначен как независимый источник команд (который в других случаях ведет себя сходно интерактивным сессиям). Файл исполняется в том же пространстве имён, что и исполняемые команды — поэтому объекты и импортированные модули, которые он определяет могут свободно использоваться в интерактивной сессии. Также в этом файле вы можете изменить приглашения: &lt;code&gt;sys.ps1&lt;/code&gt; и &lt;code&gt;sys.ps2&lt;/code&gt;.

Если вы хотите прочитать дополнительный файл запуска из текущего каталога — вы можете использовать код вроде:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;if os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())&lt;/syntaxhighlight&gt;

Если вы хотите использовать файл запуска в сценарии — вам нужно будет указать это явно:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import os
filename = os.environ.get('PYTHONSTARTUP')
if filename and os.path.isfile(filename):
    exec(open(filename).read())&lt;/syntaxhighlight&gt;


== Неформальное введение в Python ==

В приведенных далее примерах, ввод и вывод различаются присутствием и отсутствием приглашений соответственно (приглашениями являются &lt;tt&gt;&gt;&gt;&gt;&lt;/tt&gt; и &lt;tt&gt;...&lt;/tt&gt;): чтобы воспроизвести пример — вам нужно ввести всё, что следует за приглашением, после его появления; строки, не начинающиеся с приглашений являются выводом интерпретатора. Обратите внимание, что строка, в которой содержится лишь вспомогательное приглашение («&lt;tt&gt;... &lt;/tt&gt;») означает, что вам нужно ввести пустую строку — этот способ используется для завершения многострочных команд.

Большинство примеров в этом руководстве — даже те, которые вводятся в интерактивном режиме — содержат комментарии. Комментарии в Python начинаются с символа решетки # (&lt;tt&gt;hash&lt;/tt&gt;) — и продолжаются до физического конца строки. Комментарии могут находиться как в начале строки, так и следовать за пробельными символами или кодом — но не содержаться внутри строки. Символ решётки в строке остаётся лишь символом решётки. Поскольку комментарии предназначены для того, чтобы сделать код более понятным, и не интерпретируются Python — при вводе примеров они могут быть опущены.

Несколько примеров:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;# это первый комментарий
SPAM = 1                 # а это второй комментарий
                         # ... и наконец третий!
STRING = &quot;# Это не комментарий.&quot;&lt;/syntaxhighlight&gt;

=== Использование Python в качестве калькулятора ===

Давайте опробуем несколько простых команд Python. Запустите интерпретатор и дождитесь появления основного приглашения — &lt;tt&gt;&gt;&gt;&gt;&lt;/tt&gt;. (Это не должно занять много времени.)

==== Числа ====
Вот вам маленький пример:
print(&quot;Привет, как дела?&quot;)

Поведение интерпретатора сходно поведению калькулятора: вы вводите выражение, а в ответ он выводит значение. Синтаксис выражений привычен: операции &lt;code&gt;+&lt;/code&gt;, &lt;code&gt;-&lt;/code&gt;, &lt;code&gt;*&lt;/code&gt; и &lt;code&gt;/&lt;/code&gt; работают так же как и в большинстве других языков (например, Паскале или C); для группировки можно использовать скобки. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 2+2
4
&gt;&gt;&gt; # Это комментарий
... 2+2
4
&gt;&gt;&gt; 2+2  # а вот комментарий на одной строке с кодом
4
&gt;&gt;&gt; (50-5*6)/4
5.0
&gt;&gt;&gt; 8/5 # При делении целых чисел дробные части не теряются
1.6000000000000001
&lt;/syntaxhighlight&gt;

''Заметьте'': Вы можете получить результат, несколько отличный от представленного: результаты деления с плавающей запятой могут различаться на разных системах. Позже мы расскажем о том, как контролировать вывод чисел с плавающей запятой. Здесь использован наиболее информативный вариант вывода этого значения, а не более легко-читаемый, какой возможен:
&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print(8/5)
1.6
&lt;/syntaxhighlight&gt;

Чтобы учебник читался легче, мы будем показывать упрощённый вывод чисел с плавающей точкой и объясним позже, почему эти два способа отображения чисел с плавающей точкой стали различными. Обратитесь к приложению [[Учебник Python 3.1 — Приложения#Арифметика с плавающей точкой - Проблемы и ограничения|Арифметика с плавающей точкой: Проблемы и ограничения]], чтобы ознакомиться с подробным обсуждением.

Для получения целого результата при делении целых чисел, отсекая дробные результаты, предназначена другая операция: &lt;tt&gt;//&lt;/tt&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # Деление целых чисел возвращает округлённое к минимальному значение:
... 7//3
2
&gt;&gt;&gt; 7//-3
-2&lt;/syntaxhighlight&gt;

Знак равенства (&lt;code&gt;'='&lt;/code&gt;) используется для присваивания переменной какого-либо значения. После этого действия в интерактивном режиме ничего не выводится:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; width = 20
&gt;&gt;&gt; height = 5*9
&gt;&gt;&gt; width * height
900&lt;/syntaxhighlight&gt;

Значение может быть присвоено нескольким переменным одновременно:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; x = y = z = 0  # Нулевые x, y и z
&gt;&gt;&gt; x
0
&gt;&gt;&gt; y
0
&gt;&gt;&gt; z
0&lt;/syntaxhighlight&gt;

Переменные должны быть ''определены'' (&lt;tt&gt;defined&lt;/tt&gt;) (должны иметь присвоенное значение) перед использованием, иначе будет сгенерирована ошибка:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # попытка получить доступ к неопределённой переменной
... n
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in &lt;module&gt;
NameError: name 'n' is not defined&lt;/syntaxhighlight&gt;

Присутствует полная поддержка операций с плавающей точкой; операции над операндами смешанного типа конвертируют целочисленный операнд в число с плавающей запятой:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 3 * 3.75 / 1.5
7.5
&gt;&gt;&gt; 7.0 / 2
3.5&lt;/syntaxhighlight&gt;

Поддерживаются и комплексные числа, добавлением к мнимым частям суффикса &lt;code&gt;j&lt;/code&gt; или &lt;code&gt;J&lt;/code&gt;. Комплексные числа с ненулевым вещественным компонентом записываются в виде &lt;code&gt;(''&lt;вещественная_часть&gt;''+''&lt;мнимая_часть&gt;''j)&lt;/code&gt;, или могут быть созданы с помощью функции &lt;code&gt;complex(''&lt;вещественная_часть&gt;'', ''&lt;мнимая_часть&gt;'')&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 1j * 1J
(-1+0j)
&gt;&gt;&gt; 1j * complex(0, 1)
(-1+0j)
&gt;&gt;&gt; 3+1j*3
(3+3j)
&gt;&gt;&gt; (3+1j)*3
(9+3j)
&gt;&gt;&gt; (1+2j)/(1+1j)
(1.5+0.5j)&lt;/syntaxhighlight&gt;

Комплексные числа всегда представлены в виде двух чисел с плавающей запятой — вещественной и мнимой частями. Для получения этих частей из комплексного числа &lt;code&gt;z&lt;/code&gt; используется &lt;code&gt;z.real&lt;/code&gt; и &lt;code&gt;z.imag&lt;/code&gt; соответственно.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a=1.5+0.5j
&gt;&gt;&gt; a.real
1.5
&gt;&gt;&gt; a.imag
0.5&lt;/syntaxhighlight&gt;

Функции конвертации (приведения) к вещественным и целым числам (&lt;code&gt;float()&lt;/code&gt;, &lt;code&gt;int()&lt;/code&gt;) не работают с комплексными числами, так как нет единственно правильного способа сконвертировать комплексное число в вещественное. Используйте функцию &lt;code&gt;abs(z)&lt;/code&gt; чтобы получить ''модуль'' числа (в виде числа с плавающей точкой) или &lt;code&gt;z.real&lt;/code&gt; чтобы получить его вещественную часть:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a=3.0+4.0j
&gt;&gt;&gt; float(a)
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
TypeError: can`t convert complex to float; use abs(z)
&gt;&gt;&gt; a.real
3.0
&gt;&gt;&gt; a.imag
4.0
&gt;&gt;&gt; abs(a)  # sqrt(a.real**2 + a.imag**2)
5.0
&gt;&gt;&gt;&lt;/syntaxhighlight&gt;

В интерактивном режиме последнее выведенное выражение сохраняется в переменной &lt;code&gt;_&lt;/code&gt;. Это значит, что если вы используете Python в качестве настольного калькулятора — всегда есть способ продолжить вычисления с меньшими усилиями, например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; tax = 12.5 / 100
&gt;&gt;&gt; price = 100.50
&gt;&gt;&gt; price * tax
12.5625
&gt;&gt;&gt; price + _
113.0625
&gt;&gt;&gt; round(_, 2)
113.06
&gt;&gt;&gt;&lt;/syntaxhighlight&gt;

Эта переменная для пользователя должна иметь статус ''только для чтения''. Не навязывайте ей значение собственноручно — вы создадите независимую переменную с таким же именем, скрывающую встроенную переменную вместе с её магическими свойствами.

==== Строки ====

Помимо чисел, Python может работать со строками, которые, в свою очередь, могут быть описаны различными способами. Строки могут быть заключены в одинарные или двойные кавычки:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 'spam eggs'
'spam eggs'
&gt;&gt;&gt; 'doesn\'t'
&quot;doesn't&quot;
&gt;&gt;&gt; &quot;doesn't&quot;
&quot;doesn't&quot;
&gt;&gt;&gt; '&quot;Yes,&quot; he said.'
'&quot;Yes,&quot; he said.'
&gt;&gt;&gt; &quot;\&quot;Yes,\&quot; he said.&quot;
'&quot;Yes,&quot; he said.'
&gt;&gt;&gt; '&quot;Isn\'t,&quot; she said.'
'&quot;Isn\'t,&quot; she said.'&lt;/syntaxhighlight&gt;

Интерпретатор выводит результаты операций над строками тем же способом, каким они были введены: обрамляя в кавычки, и, кроме того, экранируя обратными слэшами внутренние кавычки и другие забавные символы — для того, чтобы отобразить точное значение. Строка заключается в двойные кавычки, если строка содержит одинарные кавычки и ни одной двойной, иначе она заключается в одинарные кавычки. Повторимся, функция &lt;tt&gt;print()&lt;/tt&gt; предоставляет более читаемый вывод.

Строковые литералы могут быть разнесены на несколько строк различными способами. Могут быть использованы ''продолжающие строки'', с обратным слэшем в качестве последнего символа строки, сообщающим о том, что следующая строка есть продолжение текущей&lt;ref&gt;''(Прим. перев.):''&lt;syntaxhighlight lang=&quot;python&quot;&gt;hello = &quot;Это довольно длинная строка, содержащая\n\
 несколько строк текста — такой вы бы представили её в C.\n\
    Обратите внимание, что пробельное пространство в начале строки\
 имеет значение.&quot;

print(hello)&lt;/syntaxhighlight&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;hello = &quot;This is a rather long string containing\n\
 several lines of text just as you would do in C.\n\
    Note that whitespace at the beginning of the line is\
 significant.&quot;

print(hello)&lt;/syntaxhighlight&gt;

Обратите внимание, что новые строки все ещё нужно подключать в строку через &lt;code&gt;\n&lt;/code&gt;; новая строка, за которой следут обратный слэш — не обрабатывается. Запуск примера выведет следующее:

&lt;pre&gt;This is a rather long string containing
several lines of text just as you would do in C.
    Note that whitespace at the beginning of the line is significant.&lt;/pre&gt;

Если мы объявим строковой литерал ''сырым'' (&lt;tt&gt;raw&lt;/tt&gt;)&lt;ref&gt;''(Прим. перев.)'' ''raw string'' — для описания ''сырой строки'' (не требующей последующей обработки) используется префикс '''&lt;code&gt;r&lt;/code&gt;'''.&lt;/ref&gt; — символы &lt;code&gt;\n&lt;/code&gt; не будут конвертированы в новые строки, но и обратный слэш в конце строки, и символ новой строки в исходном коде — будут добавлены в строку в виде данных. Следовательно, код из примера:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;hello = r&quot;This is a rather long string containing\n\
several lines of text much as you would do in C.&quot;

print(hello)&lt;/syntaxhighlight&gt;

выведет:

&lt;pre&gt;This is a rather long string containing\n\
several lines of text much as you would do in C.&lt;/pre&gt;

Или, строки могут быть обрамлены совпадающей парой тройных кавычек: &lt;code&gt;&quot;&quot;&quot;&lt;/code&gt; или &lt;code&gt;&lt;nowiki&gt;'''&lt;/nowiki&gt;&lt;/code&gt;. Окончания строк не нужно завершать тройными кавычками — при этом будут включены в строку.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;print(&quot;&quot;&quot;
Usage: thingy [OPTIONS]
     -h                        Display this usage message
     -H hostname               Hostname to connect to
&quot;&quot;&quot;)&lt;/syntaxhighlight&gt;

выводит в результате следующее:

&lt;syntaxhighlight lang=&quot;text&quot;&gt;Usage: thingy [OPTIONS]
     -h                        Display this usage message
     -H hostname               Hostname to connect to&lt;/syntaxhighlight&gt;

Строки могут конкатенироваться (склеиваться вместе) операцией &lt;code&gt;+&lt;/code&gt; и быть повторенными операцией &lt;code&gt;*&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word = 'Help' + 'A'
&gt;&gt;&gt; word
'HelpA'
&gt;&gt;&gt; '&lt;' + word*5 + '&gt;'
'&lt;HelpAHelpAHelpAHelpAHelpA&gt;'&lt;/syntaxhighlight&gt;

Два строковых литерала, расположенные друг за другом, автоматически конкатенируются; первая строка в предыдущем примере также могла быть записана как &lt;code&gt;word = 'Help' 'A'&lt;/code&gt;; это работает только с двумя литералами — не с произвольными выражениями, содержащими строки.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 'str' 'ing'                   #  &lt;-  Так — верно
'string'
&gt;&gt;&gt; 'str'.strip() + 'ing'   #  &lt;-  Так — верно
'string'
&gt;&gt;&gt; 'str'.strip() 'ing'     #  &lt;-  Так — не верно
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
    'str'.strip() 'ing'
                      ^
SyntaxError: invalid syntax&lt;/syntaxhighlight&gt;

Строки могут быть проиндексированы; также как и в C, первый символ строки имеет индекс &lt;tt&gt;0&lt;/tt&gt;. Отсутствует отдельный тип для символов; символ является строкой с единичной длиной. Как и в языке программирования Icon, подстроки могут определены через нотацию срезов (&lt;tt&gt;slice&lt;/tt&gt;): два индекса, разделенных двоеточием.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[4]
'A'
&gt;&gt;&gt; word[0:2]
'He'
&gt;&gt;&gt; word[2:4]
'lp'&lt;/syntaxhighlight&gt;

Индексы срезов имеют полезные значения по умолчанию; опущенный первый индекс заменяется нулём, опущенный второй индекс подменяется размером срезаемой строки.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[:2]    # Первые два символа
'He'
&gt;&gt;&gt; word[2:]    # Всё, исключая первые два символа
'lpA'&lt;/syntaxhighlight&gt;

В отличие от строк в C, строки Python не могут быть изменены. Присваивание по позиции индекса строки вызывает ошибку:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[0] = 'x'
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
TypeError: 'str' object doesn't support item assignment
&gt;&gt;&gt; word[:1] = 'Splat'
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
TypeError: 'str' object doesn't support slice assignment&lt;/syntaxhighlight&gt;

Тем не менее, создание новой строки со смешанным содержимым — процесс легкий и очевидный:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 'x' + word[1:]
'xelpA'
&gt;&gt;&gt; 'Splat' + word[4]
'SplatA'&lt;/syntaxhighlight&gt;

Полезный инвариант операции среза: &lt;code&gt;s[:i] + s[i:]&lt;/code&gt; эквивалентно &lt;code&gt;s&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[:2] + word[2:]
'HelpA'
&gt;&gt;&gt; word[:3] + word[3:]
'HelpA'&lt;/syntaxhighlight&gt;

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

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[1:100]
'elpA'
&gt;&gt;&gt; word[10:]
''
&gt;&gt;&gt; word[2:1]
''&lt;/syntaxhighlight&gt;

Индексы могут быть отрицательными числами, обозначая при этом отсчет справа налево. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[-1]     # Последний символ
'A'
&gt;&gt;&gt; word[-2]     # Предпоследний символ
'p'
&gt;&gt;&gt; word[-2:]    # Последние два символа
'pA'
&gt;&gt;&gt; word[:-2]    # Всё, кроме последних двух символов
'Hel'&lt;/syntaxhighlight&gt;

Но обратите внимание, что &lt;tt&gt;-0&lt;/tt&gt; действительно эквивалентен &lt;tt&gt;0&lt;/tt&gt; — это не отсчет справа.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[-0]     # (поскольку -0 равен 0)
'H'&lt;/syntaxhighlight&gt;

Отрицательные индексы вне диапазона обрезаются, но не советуем делать это с одно-элементными индексами (''не-срезами''):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; word[-100:]
'HelpA'
&gt;&gt;&gt; word[-10]    # ошибка
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
IndexError: string index out of range&lt;/syntaxhighlight&gt;

Один из способов запомнить, как работают срезы — думать о них, как об указателях на места между символами, где левый край первого символа установлен в ноль, а правый край последнего символа строки из &lt;code&gt;n&lt;/code&gt; символов имеет индекс &lt;code&gt;n&lt;/code&gt;, например:

&lt;pre&gt; +---+---+---+---+---+
 | H | e | l | p | A |
 +---+---+---+---+---+
 0   1   2   3   4   5
-5  -4  -3  -2  -1&lt;/pre&gt;

Первый ряд чисел дает позицию индексов строки от 0 до 5; второй ряд описывает соответствующие отрицательные индексы. Срез от i до j состоит из всех символов между правым и левым краями, отмеченными, соответственно, через &lt;code&gt;i&lt;/code&gt; и &lt;code&gt;j&lt;/code&gt;.

Для всех индексов, больших или равных нулю, длина среза — разность между индексами, при условии что оба индекса находятся в диапазоне. Например, длина &lt;code&gt;word[1:3]&lt;/code&gt; — 2.

Встроенная функция &lt;code&gt;len()&lt;/code&gt; возвращает длину строки&lt;ref&gt;''(Прим. перев.)'': [[w:en:Supercalifragilisticexpialidocious|Supercalifragilisticexpialidocious]] — английское слово из одноименной песни, прозвучавшей в фильме [[w:en:Mary Poppins (film)|Мэри Поппинс]]&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; s = 'supercalifragilisticexpialidocious'
&gt;&gt;&gt; len(s)
34&lt;/syntaxhighlight&gt;

{{Смотрите также|
;[[Справочник по библиотеке Python 3.1#Перечисляемые типы|Перечисляемые типы]]: Строки — вид перечисляемых типов и они поддерживают привычные для этих типов операции.
;[[Справочник по библиотеке Python 3.1#Строковые методы|Строковые методы]]: Строки поддерживают большое количество методов для поиска и простых трансформаций.
;[[Справочник по библиотеке Python 3.1#Форматирование строк|Форматирование строк]]: Здесь описано форматирование строк с применением функции &lt;code&gt;str.format()&lt;/code&gt;
;[[Справочник по библиотеке Python 3.1#Форматирование строк в старом стиле|Операции форматирования строк в старом стиле]]:Операции форматирования, вызывающиеся тогда, когда обычные строки или строки в Unicode оказываются левым операндом относительно операции &lt;code&gt;%&lt;/code&gt;, более детально рассмотрены здесь.&lt;ref&gt;''(Прим. перев.) Эти операции будут отключены в финальном релизе 3.1''&lt;/ref&gt;
}}

==== О Unicode ====

Начиная с Python версии 3.0, строковый тип поддерживает только Unicode (см. http://www.unicode.org/).

Преимущество набора Unicode состоит в том, что он предоставляет порядковый номер для любого символа из любой письменности, использовавшейся в современных или древнейших текстах. До этих пор для символов в сценарии было доступно лишь 256 номеров. Тексты обычно привязывались к кодовой странице, которая устанавливала в соответствие порядковые номера и символы сценария. Это приводило к серьезной путанице, особенно в том, что касалось интернационализации&lt;ref&gt;Часто записывается как &lt;tt&gt;'''i18n'''&lt;/tt&gt; — &lt;tt&gt;''internationalization'' = '''i''' + '''18''' символов + '''n'''&lt;/tt&gt;&lt;/ref&gt; программного продукта. Unicode решает эти проблемы, определяя единую кодовую страницу для всех письменностей.

Для вставки в строку специального символа можно использовать Unicode-экранирование (&lt;tt&gt;Python Unicode-Escape encoding&lt;/tt&gt;). Следующий пример всё пояснит:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 'Hello\u0020World !'
'Hello World !'&lt;/syntaxhighlight&gt;

Экранированная последовательность &lt;code&gt;\u0020&lt;/code&gt; задаёт символ Unicode с порядковым номером &lt;tt&gt;0x0020&lt;/tt&gt; (символ пробела).

Другие символы интерпретируются с использованием соответствующих им порядковых значений тем же способом, что и порядковые номера Unicode. Первые 128 символов кодировки Unicode полностью совпадают с 128 символами кодировки &lt;tt&gt;Latin-1&lt;/tt&gt;, использующейся во многих западных странах.

Помимо стандартных способов кодирования, Python предоставляет целый набор различных способов создания Unicode-строк, основываясь на известной кодировке.

Для конвертирования Unicode-строки в последовательность байтов с использованием желаемой кодировки, строковые объекты предоставляют метод &lt;code&gt;encode()&lt;/code&gt;, принимающий единственный параметр — название кодировки. Предпочитаются названия кодировок, записанные в нижнем регистре.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt;&quot;Äpfel&quot;.encode('utf-8') 
b'\xc3\x84pfel'&lt;/syntaxhighlight&gt;

==== Списки ====

В языке Python доступно некоторое количество ''составных'' типов данных, использующихся для группировки прочих значений вместе. Наиболее гибкий из них — список (&lt;tt&gt;list&lt;/tt&gt;). Его можно выразить в тексте программы через разделённые запятыми значения (''элементы''), заключённые в квадратные скобки. Элементы списка могут быть разных типов.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = ['spam', 'eggs', 100, 1234]
&gt;&gt;&gt; a
['spam', 'eggs', 100, 1234]&lt;/syntaxhighlight&gt;

Подобно индексам в строках, индексы списков начинаются с нуля, списки могут быть срезаны, объединены (''конкатенированы'') и так далее:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a[0]
'spam'
&gt;&gt;&gt; a[3]
1234
&gt;&gt;&gt; a[-2]
100
&gt;&gt;&gt; a[1:-1]
['eggs', 100]
&gt;&gt;&gt; a[:2] + ['bacon', 2*2]
['spam', 'eggs', 'bacon', 4]
&gt;&gt;&gt; 3*a[:3] + ['Boo!']
['spam', 'eggs', 100, 'spam', 'eggs', 100, 'spam', 'eggs', 100, 'Boo!']&lt;/syntaxhighlight&gt;

В отличие от строк, являющихся неизменяемыми, изменить индивидуальные элементы списка вполне возможно:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a
['spam', 'eggs', 100, 1234]
&gt;&gt;&gt; a[2] = a[2] + 23
&gt;&gt;&gt; a
['spam', 'eggs', 123, 1234]&lt;/syntaxhighlight&gt;

Присваивание срезу также возможно, и это действие может даже изменить размер списка или полностью его очистить:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # Заменим некоторые элементы:
... a[0:2] = [1, 12]
&gt;&gt;&gt; a
[1, 12, 123, 1234]
&gt;&gt;&gt; # Удалим немного:
... a[0:2] = []
&gt;&gt;&gt; a
[123, 1234]
&gt;&gt;&gt; # Вставим пару:
... a[1:1] = ['bletch', 'xyzzy']
&gt;&gt;&gt; a
[123, 'bletch', 'xyzzy', 1234]
&gt;&gt;&gt; # Вставим (копию) самого себя в начало
&gt;&gt;&gt; a[:0] = a
&gt;&gt;&gt; a
[123, 'bletch', 'xyzzy', 1234, 123, 'bletch', 'xyzzy', 1234]
&gt;&gt;&gt; # Очистка списка: замена всех значений пустым списком
&gt;&gt;&gt; a[:] = []
&gt;&gt;&gt; a
[]&lt;/syntaxhighlight&gt;

Встроенная функция &lt;code&gt;len()&lt;/code&gt; также применима к спискам:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = ['a', 'b', 'c', 'd']
&gt;&gt;&gt; len(a)
4&lt;/syntaxhighlight&gt;

Вы можете встраивать списки (создавать списки, содержащие другие списки), например так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; q = [2, 3]
&gt;&gt;&gt; p = [1, q, 4]
&gt;&gt;&gt; len(p)
3
&gt;&gt;&gt; p[1]
[2, 3]
&gt;&gt;&gt; p[1][0]
2&lt;/syntaxhighlight&gt;

Вы можете добавить что-нибудь в конец списка.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; p[1].append('xtra')
&gt;&gt;&gt; p
[1, [2, 3, 'xtra'], 4]&lt;/syntaxhighlight&gt;

Обратите внимание, что в последнем примере &lt;code&gt;p[1]&lt;/code&gt; и &lt;code&gt;q&lt;/code&gt; на самом деле ссылаются на один и тот же объект!

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; q
[2, 3, 'xtra']&lt;/syntaxhighlight&gt;

Мы вернёмся к ''семантике объектов'' позже.

=== Первые шаги к программированию ===

Безусловно, Python можно использовать для более сложных задач, чем сложение двух чисел. Например, мы можем вывести начало последовательности чисел Фибоначчи таким образом:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # Ряд Фибоначчи:
... # сумма двух элементов определяет следующий элемент
... a, b = 0, 1
&gt;&gt;&gt; while b &lt; 10:
...     print(b)
...     a, b = b, a+b
...
1
1
2
3
5
8&lt;/syntaxhighlight&gt;

Этот пример показывает нам некоторые новые возможности.

* Первая строка содержит ''множественное присваивание'' (&lt;tt&gt;multiple assignment&lt;/tt&gt;): переменные &lt;code&gt;a&lt;/code&gt; и &lt;code&gt;b&lt;/code&gt; параллельно получают новые значения — &lt;code&gt;0&lt;/code&gt; и &lt;code&gt;1&lt;/code&gt;. В последней строке этот метод используется снова, демонстрируя тот факт, что выражения по правую сторону [от оператора присваивания] всегда вычисляются раньше каких бы то ни было присваиваний. Сами же разделённые запятыми выражения вычисляются слева направо.

* Цикл &lt;code&gt;while&lt;/code&gt; (пока) исполняется до тех пор, пока условие (здесь: &lt;code&gt;b &lt; 10&lt;/code&gt;) остается истиной. В Python, также как и в C, любое ненулевое значение является истиной (&lt;code&gt;True&lt;/code&gt;); ноль является ложью (&lt;code&gt;False&lt;/code&gt;). Условием может быть строка, список или вообще любая последовательность; все, что имеет ненулевую длину, играет роль истины, пустые последовательности — лжи. Использованная в примере проверка — простое условие. Стандартные операции сравнения записываются так же, как и в C: &lt;code&gt;&lt;&lt;/code&gt; (меньше чем), &lt;code&gt;&gt;&lt;/code&gt; (больше чем), &lt;code&gt;==&lt;/code&gt; (равно), &lt;code&gt;&lt;=&lt;/code&gt; (меньше или равно), &lt;code&gt;&gt;=&lt;/code&gt; (больше или равно) и &lt;code&gt;!=&lt;/code&gt; (не равно).

* ''Тело'' цикла выделено ''отступом'' (&lt;tt&gt;indented&lt;/tt&gt;). Отступы — это средство группировки операторов в Python. Интерактивный режим Python (пока!) не имеет какого-либо разумного и удобного средства для редактирования строк ввода, поэтому необходимо использовать табуляции или пробелы для отступа в каждой строке. На практике более сложный текст на Python готовится в текстовом редакторе, большинство из которых имеют функцию авто-отступа. По окончании ввода составного выражения в интерактивном режиме его необходимо закончить пустой строкой — признаком завершения (поскольку интерпретатор не может угадать, когда вами была введена последняя строка). Обратите внимание, что размер отступа в каждой строке основного блока должен быть одним и тем же&lt;ref&gt;''(Прим. перев.)'' Размер отступа для блока не унифицирован — табуляция может чередоваться с пробелами, это может быть один пробел или же пять — главное, чтобы у всего блока он был одинаковым и был больше по величине чем у внешнего (обрамляющего) блока. Тем не менее, чаще всего программисты на Python устанавливают в редакторах режим замены табуляции четырьмя пробелами и при наборе кода вложенность блока обозначают отступом с соответствующим количеством нажатий клавиш табуляции. Благодаря этому код остается читабельным во всех текстовых редакторах и в большинстве браузеров (или, в редких случаях, требует минимального форматирования для корректного отображения)).''&lt;/ref&gt;.

* Функция &lt;code&gt;print()&lt;/code&gt; выводит значения переданных ей выражений. Поведение этой функции отличается от обычного вывода выражения (как происходило выше в примерах с калькулятором) тем, каким способом обрабатываются ряды выражений, величины с плавающей точкой и строки. Строки выводятся без кавычек, и между элементами вставляются пробелы, благодаря чему форматирование вывода улучшается — как, например, здесь:
&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; i = 256*256
&gt;&gt;&gt; print('Значением i является', i)
Значением i является 65536&lt;/syntaxhighlight&gt;
: Для отключения перевода строки после вывода или завершения вывода другой строкой используется именованный параметр &lt;code&gt;end&lt;/code&gt;:
&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a, b = 0, 1
&gt;&gt;&gt; while b &lt; 1000:
...     print(b, end=' ')
...     a, b = b, a+b
...
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987&lt;/syntaxhighlight&gt;

== Больше средств для управления потоком команд&lt;ref&gt;''(Прим. перев.)'' More Control Flow Tools; [[w:en:Control Flow|Control Flow]] — поток команд, процесс управления, алгоритм; подразделы в оригинале используют множественное число: &quot;Операторы (выражения, инструкции) &lt;code&gt;if&lt;/code&gt;, «Операторы (выражения, инструкции) &lt;code&gt;for&lt;/code&gt;», и. т. п.&lt;/ref&gt; ==

Помимо описанного выше оператора &lt;code&gt;while&lt;/code&gt;, в Python доступны привычные операторы управления потоком из других языков, но с некоторыми особенностями.

=== Оператор &lt;code&gt;if&lt;/code&gt; ===

Возможно, наиболее широко известный тип оператора — оператор &lt;code&gt;if&lt;/code&gt; (если). Пример:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; x = int(input(&quot;Введите, пожалуйста, целое число: &quot;))
Введите, пожалуйста, целое число: 42
&gt;&gt;&gt; if x &lt; 0:
...      x = 0
...      print('Отрицательное значение, изменено на ноль')
... elif x == 0:
...      print('Ноль')
... elif x == 1:
...      print('Один')
... else:
...      print('Больше')
...&lt;/syntaxhighlight&gt;

Блока &lt;code&gt;elif&lt;/code&gt; может не быть вообще, он может быть один или их может быть несколько, а блок &lt;code&gt;else&lt;/code&gt; (иначе) необязателен. Ключевое слово &lt;tt&gt;elif&lt;/tt&gt; — краткая запись &lt;tt&gt;else if&lt;/tt&gt; (иначе если) — позволяет избавиться от чрезмерного количества отступов. Оператор &lt;code&gt;if&lt;/code&gt; &lt;tt&gt;...&lt;/tt&gt; &lt;code&gt;elif&lt;/code&gt; &lt;tt&gt;...&lt;/tt&gt; &lt;code&gt;elif&lt;/code&gt; &lt;tt&gt;...&lt;/tt&gt; — аналог оператора выбора &lt;code&gt;switch&lt;/code&gt; или &lt;code&gt;case&lt;/code&gt;, которые можно встретить в других языках программирования.

=== Оператор &lt;code&gt;for&lt;/code&gt; ===

Оператор &lt;code&gt;for&lt;/code&gt; в Python немного отличается от того, какой вы, возможно, использовали в C или Pascal. Вместо неизменного прохождения по арифметической прогрессии из чисел (как в Pascal) или предоставления пользователю возможности указать шаг итерации и условие остановки (как в С), оператор &lt;code&gt;for&lt;/code&gt; в Python проходит по всем элементам любой последовательности (списка или строки) в том порядке, в котором они в ней располагаются. Например (игра слов не подразумевалась):&lt;ref&gt;''(Прим. перев.)'' Defenestrate{{ref-en}} — выкидывать кого-либо из окна с целью покалечить. Другие слова — «кошка» и «окно».&lt;/ref&gt;

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # Измерим несколько строк:
... a = ['cat', 'window', 'defenestrate']
&gt;&gt;&gt; for x in a:
...     print(x, len(x))
...
cat 3
window 6
defenestrate 12&lt;/syntaxhighlight&gt;

Изменять содержимое последовательности, по которой проходит цикл, небезопасно (это в принципе-то возможно только для изменяемых типов, таких как списки). Если необходимо модифицировать список, использующийся для организации цикла, (например, для того чтобы продублировать отдельные элементы) нужно передать циклу его копию. Нотация срезов делает это практически безболезненным:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for x in a[:]:  # создать срез-копию всего списка
...    if len(x) &gt; 6: a.insert(0, x)
...
&gt;&gt;&gt; a
['defenestrate', 'cat', 'window', 'defenestrate']&lt;/syntaxhighlight&gt;

=== Функция &lt;code&gt;range()&lt;/code&gt; ===

Если вам нужно перебрать последовательность чисел, встроенная функция &lt;code&gt;range()&lt;/code&gt; придёт на помощь. Она генерирует арифметические прогрессии:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for i in range(5):
...    print(i)
...
0
1
2
3
4&lt;/syntaxhighlight&gt;

Указанный конец интервала никогда не включается в сгенерированный список; вызов &lt;code&gt;range(10)&lt;/code&gt; генерирует десять значений, которые являются подходящими индексами для элементов последовательности длины 10. Можно указать другое начало интервала и другую, даже отрицательную, величину шага.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;range(5, 10)
   от 5 до 9

range(0, 10, 3)
   0, 3, 6, 9

range(-10, -100, -30)
   -10, -40, -70&lt;/syntaxhighlight&gt;

Чтобы пройти по всем индексам какой-либо последовательности, скомбинируйте вызовы &lt;code&gt;range()&lt;/code&gt; и &lt;code&gt;len()&lt;/code&gt; следующим образом:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = ['Mary', 'had', 'a', 'little', 'lamb']
&gt;&gt;&gt; for i in range(len(a)):
...     print(i, a[i])
...
0 Mary
1 had
2 a
3 little
4 lamb&lt;/syntaxhighlight&gt;

В большинстве таких случаев удобно использовать функцию &lt;code&gt;enumerate()&lt;/code&gt;, обратитесь к [[Учебник Python 3.1#Организация циклов|Организация циклов]].

Странные вещи начинают происходить при попытке вывода последовательности:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print(range(10))
range(0, 10)&lt;/syntaxhighlight&gt;

Во многих случаях объект, возвращаемый функцией &lt;code&gt;range()&lt;/code&gt;, ведёт себя как список, но фактически им не является. Этот объект возвращает по очереди элементы желаемой последовательности, когда вы проходите по нему в цикле, но на самом деле не создаёт списка, сохраняя таким образом пространство в памяти.

Мы называем такие объекты ''итерируемыми'' (&lt;tt&gt;iterable&lt;/tt&gt;), и это все объекты, которые предназначаются для функций и конструкций, ожидающих от них поочерёдного предоставления элементов до тех пор, пока источник не иссякнет. Мы видели, что оператор &lt;code&gt;for&lt;/code&gt; является таким ''итератором'' &lt;tt&gt;iterator&lt;/tt&gt;. Функция &lt;code&gt;list()&lt;/code&gt; тоже из их числа — она создаёт списки из ''итерируемых'' объектов:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; list(range(5))
[0, 1, 2, 3, 4]&lt;/syntaxhighlight&gt;

Позже мы познакомимся и с другими функциями, которые возвращают и принимают ''итерируемые'' объекты в качестве параметров.

=== Операторы &lt;code&gt;break&lt;/code&gt; и &lt;code&gt;continue&lt;/code&gt;, а также условие &lt;code&gt;else&lt;/code&gt; в циклах ===

Оператор &lt;code&gt;break&lt;/code&gt; прерывает выполнение самого ближайшего вложенного цикла &lt;code&gt;for&lt;/code&gt; или &lt;code&gt;while&lt;/code&gt; (по аналогии с языком C).

Оператор &lt;code&gt;continue&lt;/code&gt;, также заимствованный из C, продолжает выполнение цикла со следующей итерации.

Операторы циклов могут иметь ветвь &lt;code&gt;else&lt;/code&gt;. Она исполняется, когда цикл выполнил перебор до конца (в случае &lt;code&gt;for&lt;/code&gt;) или когда условие становится ложным (в случае &lt;code&gt;while&lt;/code&gt;), но не в тех случаях, когда цикл прерывается по &lt;code&gt;break&lt;/code&gt;. Это поведение иллюстрируется следующим примером, в котором производится поиск простых чисел:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for n in range(2, 10): 
...     for x in range(2, int(n ** 0.5) + 1):
...         if n % x == 0:
...             print(n, 'равно', x, '*', n//x)
...             break
...     else:
...             print(n, '- простое число')
...
2 - простое число
3 - простое число
4 равно 2 * 2
5 - простое число
6 равно 2 * 3
7 - простое число
8 равно 2 * 4
9 равно 3 * 3&lt;/syntaxhighlight&gt;

=== Оператор &lt;code&gt;pass&lt;/code&gt; ===

Оператор &lt;code&gt;pass&lt;/code&gt; не делает ничего. Он может использоваться когда синтаксически требуется присутствие оператора, но от программы не требуется действий. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; while True:
...       pass # Ожидание прерывания c клавиатуры (Ctrl+C) в режиме занятости
...&lt;/syntaxhighlight&gt;

Этот оператор часто используется для создания минималистичных классов, к примеру ''исключений'' (&lt;tt&gt;exceptions&lt;/tt&gt;), или для игнорирования нежелательных исключений:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; class ParserError(Exception):
...     pass
...
&gt;&gt;&gt; try:
...     import audioop
... except ImportError:
...     pass
...&lt;/syntaxhighlight&gt;

Другой вариант: &lt;code&gt;pass&lt;/code&gt; может применяться в качестве заглушки для тела функции или условия при создании нового кода, позволяя вам сохранить абстрактный взгляд на вещи. С другой стороны, оператор &lt;code&gt;pass&lt;/code&gt; игнорируется без каких-либо сигналов и лучшим выбором было бы породить исключение &lt;code&gt;NotImplementedError&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def initlog(*args):
...     raise NotImplementedError   # Открыть файл для логгинга, если он ещё не открыт
...     if not logfp:
...         raise NotImplementedError  # Настроить заглушку для логгинга
...     raise NotImplementedError('Обработчик инициализации лога вызовов')
...&lt;/syntaxhighlight&gt;

Если бы здесь использовались операторы &lt;code&gt;pass&lt;/code&gt;, а позже вы бы запускали тесты, они могли бы упасть без указания причины. Использование &lt;code&gt;NotImplementedError&lt;/code&gt; принуждает этот код породить исключение, сообщая вам конкретное место, где присутствует незавершённый код. Обратите внимание на два способа порождения исключений. Первый способ, без сообщения, но сопровождаемый комментарием, позволяет вам оставить комментарий когда вы будете подменять выброс исключения рабочим кодом, который, в свою очередь, в идеале, будет хорошим описанием блока кода, для которого исключение предназначалось заглушкой. Однако, передача сообщения вместе с исключением, как в третьем примере, обуславливает более насыщенный информацией вывод при отслеживании ошибки.

=== Определение функций ===

Мы можем создать функцию, которая выводит числа Фибоначчи до некоторого предела:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def fib(n):    # вывести числа Фибоначчи меньшие (вплоть до) n
...     &quot;&quot;&quot;Выводит ряд Фибоначчи, ограниченный n.&quot;&quot;&quot;
...     a, b = 0, 1
...     while b &lt; n:
...         print(b, end=' ')
...         a, b = b, a+b
...
&gt;&gt;&gt; # Теперь вызовем определенную нами функцию:
... fib(2000)
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597&lt;/syntaxhighlight&gt;

Зарезервированное слово &lt;code&gt;def&lt;/code&gt; предваряет ''определение'' функции. За ним должны следовать имя функции и заключённый в скобки список формальных параметров. Выражения, формирующие тело функции, начинаются со следующей строки и должны иметь отступ.

Первым выражением в теле функции может быть строковой литерал — этот литерал является строкой документации функции, или ''док-строкой'' (&lt;tt&gt;docstring&lt;/tt&gt;). (Больше информации о ''док-строках'' вы найдёте в разделе [[Учебник Python 3.1#Строки документации|Строки документации]]) Существуют инструменты, которые используют ''док-строки'' для того, чтобы сгенерировать печатную или онлайн-документацию или чтобы позволить пользователю перемещаться по коду интерактивно; добавление строк документации в ваш код — это хорошая практика, постарайтесь к ней привыкнуть.

''Исполнение'' функции приводит к созданию новой таблицы символов&lt;ref&gt;''(Прим. перев.)'' Здесь слово «символ» используется не в привычном значении — под ''символом'' подразумевается нечто лингвистическое, описывающее какую-либо сущность (близко к значению ''символизировать''), в данном случае: имя переменной — саму переменную.&lt;/ref&gt;, использующейся для хранения локальных переменных функции. Если быть более точными, все присваивания переменных в функции сохраняют значение в локальной таблице символов; при обнаружении ссылки на переменную, в первую очередь просматривается локальная таблица символов, затем локальная таблица символов для окружающих функций, затем глобальная таблица символов и, наконец, таблица встроенных имён. Таким образом, глобальным переменным невозможно прямо присвоить значения внутри функций (если они конечно не упомянуты в операторе &lt;code&gt;global&lt;/code&gt;) несмотря на то, что ссылки на них могут использоваться.

Фактические параметры при вызове функции помещаются в локальную таблицу символов вызванной функции; в результате аргументы передаются через ''вызов по значению'' (&lt;tt&gt;call by value&lt;/tt&gt;) (где значение — это всегда ''ссылка'' (&lt;tt&gt;reference&lt;/tt&gt;) на объект, а не значение его самого)&lt;ref&gt;На самом деле, лучшим определением был бы ''вызов по ссылке на объект'' (&lt;tt&gt;call by object reference&lt;/tt&gt;), так как при передаче изменяемого объекта, вызывающему будут видны все изменения, которые производит над объектом вызываемый (вставка элементов в список)&lt;/ref&gt;. Если одна функция вызывает другую — то для этого вызова создается новая локальная таблица символов.

При определении функции её имя также помещается в текущую таблицу символов. Тип значения, связанного с именем функции, распознается интерпретатором как функция, определённая пользователем (&lt;tt&gt;user-defined function&lt;/tt&gt;). Само значение может быть присвоено другому имени, которое затем может также использоваться в качестве функции. Эта система работает в виде основного механизма переименования:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; fib
&lt;function fib at 10042ed0&gt;
&gt;&gt;&gt; f = fib
&gt;&gt;&gt; f(100)
1 1 2 3 5 8 13 21 34 55 89&lt;/syntaxhighlight&gt;

Если вы использовали в работе другие языки программирования, вы можете возразить, что &lt;code&gt;fib&lt;/code&gt; — это не функция, а процедура, поскольку не возвращает никакого значения. На самом деле, даже функции без ключевого слова &lt;code&gt;return&lt;/code&gt; возвращают значение, хотя и более скучное. Такое значение именуется &lt;code&gt;None&lt;/code&gt; (это встроенное имя). Вывод значения &lt;code&gt;None&lt;/code&gt; обычно подавляется в интерактивном режиме интерпретатора, если оно оказывается единственным значением, которое нужно вывести. Вы можете проследить за этим процессом, если действительно хотите, используя функцию &lt;code&gt;print()&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; fib(0)
&gt;&gt;&gt; print(fib(0))
None&lt;/syntaxhighlight&gt;

Довольно легко написать функцию, которая возвращает список чисел из ряда Фибоначчи, вместо того, чтобы выводить их:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def fib2(n): # вернуть числа Фибоначчи меньшие (вплоть до) n
...     &quot;&quot;&quot;Возвращает список чисел ряда Фибоначчи, ограниченный n.&quot;&quot;&quot;
...     result = []
...     a, b = 0, 1
...     while b &lt; n:
...         result.append(b)    # см. ниже
...         a, b = b, a+b
...     return result
...
&gt;&gt;&gt; f100 = fib2(100)    # вызываем
&gt;&gt;&gt; f100                # выводим результат
[1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]&lt;/syntaxhighlight&gt;

И на этот раз пример демонстрирует некоторые новые возможности Python:

* Оператор &lt;code&gt;return&lt;/code&gt; завершает выполнение функции, возвращая некоторое значение. Оператор &lt;code&gt;return&lt;/code&gt; без аргумента возвращает &lt;code&gt;None&lt;/code&gt;. Достижение конца функции также возвращает &lt;code&gt;None&lt;/code&gt;.

* Выражение &lt;code&gt;result.append(b)&lt;/code&gt; вызывает метод &lt;code&gt;append&lt;/code&gt; объекта-списка &lt;code&gt;result&lt;/code&gt;. Метод — это функция, которая «принадлежит» объекту и указывается через выражение вида &lt;code&gt;obj.methodname&lt;/code&gt;, где &lt;code&gt;obj&lt;/code&gt; — некоторый объект (может быть выражением), а &lt;code&gt;methodname&lt;/code&gt; — имя метода, присущий объекту данного типа. Различные типы определяют различные методы. Методы разных типов могут иметь одинаковые имена, не вызывая неопределённостей. (Позже в этом учебнике будет рассмотрено как определять собственные типы объектов и методы, используя классы.) Метод &lt;code&gt;append()&lt;/code&gt;, показанный в примере, определён для объектов типа список. Он добавляет в конец списка новый элемент. В данном примере это действие эквивалентно выражению &lt;code&gt;result = result + [b]&lt;/code&gt;, но более эффективно.

=== Подробнее об определении функций ===

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

==== Значения аргументов по умолчанию ====

Наиболее полезной формой является задание значений по умолчанию для одного или более параметров. Таким образом создаётся функция, которая может быть вызвана с меньшим количеством параметров, чем в её определении: при этом неуказанные при вызове параметры примут данные в определении функции значения. Например&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;'''опред''' спросить_подтверждения(вопрос, попытки=4, протест='Да или нет, пожалуйста!'):&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''пока''' ''Истина'':&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;ответ = ''ввод''(вопрос)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''если''' ответ '''среди''' ('д', 'да', 'ага'): '''вернуть''' ''Истина''&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''если''' ответ '''среди''' ('н', 'не', 'нет', 'не-а'): '''вернуть''' ''Ложь''&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;попытки = попытки - 1&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''если''' попытки &lt; 0: '''породить''' ОшибкаВВ('пользователь-отказник')&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(протест)&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;
(''Refusenik''{{ref-en}} — [[w:ru:Отказник|Отказник]]). Ниже: «…&lt;code&gt;спросить_подтверждения('Вы действительно хотите выйти?')&lt;/code&gt; или так: &lt;code&gt;спросить_подтверждения('Согласны ли вы перезаписать файл?', 2)&lt;/code&gt;…»&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def ask_ok(prompt, retries=4, complaint='Yes or no, please!'):
    while True:
        ok = input(prompt)
        if ok in ('y', 'yeah', 'yes', 'yep'): return True
        if ok in ('n', 'no', 'nop', 'nope'): return False
        retries = retries - 1
        if retries &lt; 0:
            raise IOError('refusenik user')
        print(complaint)&lt;/syntaxhighlight&gt;

Эта функция может быть вызвана, например, так: &lt;code&gt;ask_ok('Do you really want to quit?')&lt;/code&gt; или так: &lt;code&gt;ask_ok('OK to overwrite the file?', 2)&lt;/code&gt;.

Этот пример также знакомит вас с зарезервированным словом &lt;code&gt;in&lt;/code&gt;. Посредством его можно проверить, содержит ли последовательность определённое значение или нет.

Значения по умолчанию вычисляются в месте определения функции, в ''определяющей'' области, поэтому код

&lt;syntaxhighlight lang=&quot;python&quot;&gt;i = 5

def f(arg=i):
    print(arg)

i = 6
f()&lt;/syntaxhighlight&gt;

выведет 5.

'''Важное предупреждение:''' Значение по умолчанию вычисляется лишь единожды. Это особенно важно помнить, когда значением по умолчанию является изменяемый объект, такой как список, словарь (&lt;tt&gt;dictionary&lt;/tt&gt;) или экземпляры большинства классов. Например, следующая функция накапливает переданные ей параметры:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def f(a, L=[]):
    L.append(a)
    return L

print(f(1))
print(f(2))
print(f(3))&lt;/syntaxhighlight&gt;

Она выведет

&lt;syntaxhighlight lang=&quot;python&quot;&gt;[1]
[1, 2]
[1, 2, 3]&lt;/syntaxhighlight&gt;

Если вы не хотите, чтобы значение по умолчанию распределялось между последовательными вызовами, вместо предыдущего варианта вы можете использовать такую идиому:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def f(a, L=None):
    if L is None:
        L = []
    L.append(a)
    return L&lt;/syntaxhighlight&gt;

==== Именованные параметры&lt;ref&gt;''(Прим. перев.)'' В оригинале — Keyword Arguments — параметры по ключевым словам, ключевые параметры (далее используется слово ''keywords'' для набора имён параметров непостоянного количества. ''Ключевые'' — возможно, корректнее, но как мне показалось — менее понятно ([http://www.infocity.kiev.ua/prog/python/content/sempit_14.phtml альтернативный перевод]))&lt;/ref&gt; ====

Функции также могут быть вызваны с использованием именованных параметров (&lt;tt&gt;keyword arguments&lt;/tt&gt;) в форме «''имя = значение''». Например, нижеприведённая функция&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;'''опред''' попугай(вольтаж, состояние='труп', действие='ввум', тип='Норвежский Голубой'):&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Этот попугай не сделает &quot;, действие, завершить=' ')&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;если вы пропустите через него &quot;, вольтаж, &quot; вольт.&quot;)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Великолепное оперенье, &quot;, тип)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Он&quot;, состояние, &quot;!&quot;)&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;
(''Из [http://www.ibras.dk/montypython/episode08.htm#6 скетча Монти Пайтона]'')&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def parrot(voltage, state='a stiff', action='voom', type='Norwegian Blue'):
    print(&quot;-- This parrot wouldn't&quot;, action, end=' ')
    print(&quot;if you put&quot;, voltage, &quot;volts through it.&quot;)
    print(&quot;-- Lovely plumage, the&quot;, type)
    print(&quot;-- It's&quot;, state, &quot;!&quot;)&lt;/syntaxhighlight&gt;

могла бы быть вызвана любым из следующих способов&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;попугай(действие='ВВУУУУМ', вольтаж=1000000)&lt;br/&gt;
попугай('тысячу', состояние='слёг в могилу')&lt;br/&gt;
попугай('миллион', 'лишённый жизни', 'прыжок')&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;parrot(1000)
parrot(action='VOOOOOM', voltage=1000000)
parrot('a thousand', state='pushing up the daisies')
parrot('a million', 'bereft of life', 'jump')&lt;/syntaxhighlight&gt;

а эти случаи оказались бы неверными&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;попугай()&lt;br/&gt;
попугай(вольтаж=5.0, 'мёртв')&lt;br/&gt;
попугай(исполнитель='Джон Клиз')&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;parrot()                     # пропущен требуемый аргумент
parrot(voltage=5.0, 'dead')  # позиционный параметр вслед за именованным
parrot(110, voltage=220)     # повторное значение параметра
parrot(actor='John Cleese')  # неизвестное имя параметра&lt;/syntaxhighlight&gt;

В общем случае, список параметров должен содержать любое количество позиционных (&lt;tt&gt;positional&lt;/tt&gt;) параметров, за которыми может следовать любое количество именованных, и при этом имена аргументов выбираются из формальных параметров. Неважно, имеет формальный параметр значение по умолчанию или нет. Ни один из аргументов не может получать значение более чем один раз — имена формальных параметров, совпадающие с именами позиционных параметров, не могут использоваться в качестве именующих в одном и том же вызове&lt;ref&gt;''(Прим. перев.)'' В главе о функциях автор отталкивается не от привычного по другим учебникам первоначального полного описания определения функций, а уже потом — описания их вызова, а объединяет обе темы вместе (как минимум в случае с непостоянным списком аргументов это возможно непривычно, но оправдано), отдавая приоритет описанию вызова. Учебник рассчитан на тех, кто уже программирует на каком-либо языке программирования и потенциально не должен смутить читателя.&lt;/ref&gt;. Вот пример, завершающийся неудачей по причине описанного ограничения:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def function(a):
...     pass
...
&gt;&gt;&gt; function(0, a=0)
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
TypeError: function() got multiple values for keyword argument 'a'&lt;/syntaxhighlight&gt;

Если в определении функции присутствует завершающий параметр в виде ''**имя'', он получит в качестве значения словарь (подробнее в разделе [[Справочник по библиотеке Python 3.1#Типы-отображения|Справочника — Типы-отображения — словари]]), содержащий все именованные параметры и их значения, исключая те, которые соответствуют формальным параметрам. Можно совместить эту особенность с поддержкой формального параметра в формате ''*имя'' (описывается в следующем подразделе), который получает кортеж (&lt;tt&gt;tuple&lt;/tt&gt;), содержащий все позиционные параметры, следующие за списком формальных параметров. (параметр в формате ''*имя'' должен описываться перед параметром в формате ''**имя''.) Например, если мы определим такую функцию&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;'''опред''' лавка_сыров(сорт, *аргументы, **именованные):&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Есть ли у вас &quot;, сорт, '?')&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Простите, весь &quot;, сорт, &quot; у нас закончился.&quot;)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''для''' аргумент '''из''' аргументы: '''вывести'''(аргумент)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''('-' * 40)&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;имена = '''сортированные'''(именованные.''ключи''())&lt;br/&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''для''' имя '''из''' имена: '''вывести'''(имя , &quot;:&quot;, именованные[имя])&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;
(''Из [http://www.ibras.dk/montypython/episode33.htm#7 скетча Монти Пайтона]'')&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def cheeseshop(kind, *arguments, **keywords):
    print(&quot;-- Do you have any&quot;, kind, &quot;?&quot;)
    print(&quot;-- I'm sorry, we're all out of&quot;, kind)
    for arg in arguments: print(arg)
    print(&quot;-&quot; * 40)
    keys = sorted(keywords.keys())
    for kw in keys: print(kw, &quot;:&quot;, keywords[kw])&lt;/syntaxhighlight&gt;

то её можно будет вызвать так&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;лавка_сыров(&quot;Лимбургер&quot;, &quot;Это очень расстраивает, сэр.&quot;,&lt;br /&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&quot;Это действительно очень, ОЧЕНЬ расстраивает, сэр.&quot;,&lt;br /&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;торговец=&quot;Майкл Палин&quot;,&lt;br /&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;клиент=&quot;Джон Клиз&quot;,&lt;br /&gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;скетч=&quot;Скетч о сырной лавке&quot;)&lt;/code&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;cheeseshop('Limburger', &quot;It's very runny, sir.&quot;,
           &quot;It's really very, VERY runny, sir.&quot;,
           client=&quot;John Cleese&quot;,
           shopkeeper=&quot;Michael Palin&quot;,
           sketch=&quot;Cheese Shop Sketch&quot;)&lt;/syntaxhighlight&gt;

и она, конечно же, выведет&lt;ref&gt;''(Прим. перев.):''
&lt;br/&gt;&lt;br/&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;-- Есть ли у вас Лимбургер ?&lt;br/&gt;
-- Простите, весь Лимбургер у нас закончился.&lt;br/&gt;
Это очень расстраивает, сэр.&lt;br/&gt;
Это действительно очень, ОЧЕНЬ расстраивает, сэр.&lt;br/&gt;
&lt;nowiki&gt;----------------------------------------&lt;/nowiki&gt;&lt;br/&gt;
клиент: Джон Клиз&lt;br/&gt;
торговец : Майкл Палин&lt;br/&gt;
скетч : Скетч о сырной лавке&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;&lt;/ref&gt;:

&lt;code&gt;-- Do you have any Limburger ?&lt;br/&gt;
-- I'm sorry, we're all out of Limburger&lt;br/&gt;
It's very runny, sir.&lt;br/&gt;
It's really very, VERY runny, sir.&lt;br/&gt;
&lt;nowiki&gt;----------------------------------------&lt;/nowiki&gt;&lt;br/&gt;
client : John Cleese&lt;br/&gt;
shopkeeper : Michael Palin&lt;br/&gt;
sketch : Cheese Shop Sketch&lt;/code&gt;

Обратите внимание, что список имён (ключей) именованных параметров (&lt;code&gt;keys&lt;/code&gt;) создается посредством сортировки содержимого списка ключей &lt;code&gt;keys()&lt;/code&gt; словаря &lt;code&gt;keywords&lt;/code&gt;; если бы этого не было сделано, порядок вывода параметров был бы произволен.

==== Списки параметров произвольной длины ====

Наконец, наиболее редко используется возможность указания того, что функция может быть вызвана с произвольным числом аргументов. При этом сами параметры будут обёрнуты в кортеж (см. раздел [[Учебник Python 3.1#Кортежи|Кортежи]]). Переменное количество параметров могут предварять ноль или более обычных.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def write_multiple_items(file, separator, *args):
    file.write(separator.join(args))&lt;/syntaxhighlight&gt;

Обычно параметры неизвестного заранее количества (&lt;tt&gt;variadic&lt;/tt&gt;) указываются последними в списке формальных параметров, поскольку включают в себя все остальные переданные в функцию параметры. Все формальные параметры, которые следуют за параметром &lt;code&gt;*args&lt;/code&gt;, должны быть только именованными, то есть, они могут быть заданы только по имени (в отличие от позиционных параметров).

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def concat(*args, sep=&quot;/&quot;):
...    return sep.join(args)
...
&gt;&gt;&gt; concat(&quot;earth&quot;, &quot;mars&quot;, &quot;venus&quot;)
'earth/mars/venus'
&gt;&gt;&gt; concat(&quot;earth&quot;, &quot;mars&quot;, &quot;venus&quot;, sep=&quot;.&quot;)
'earth.mars.venus'&lt;/syntaxhighlight&gt;

==== Распаковка списков параметров ====

Обратная ситуация возникает когда параметры уже содержатся в списке или в кортеже, но должны быть распакованы для вызова функции, требующей отдельных позиционных параметров. Например, встроенная функция &lt;code&gt;range()&lt;/code&gt; ожидает отдельные параметры ''start'' и ''stop'' соответственно. Если они не доступны раздельно, для распаковки аргументов из списка или кортежа в вызове функции используйте *-синтаксис:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; list(range(3, 6))             # обычный вызов с отдельными параметрами
[3, 4, 5]
&gt;&gt;&gt; args = [3, 6]
&gt;&gt;&gt; list(range(*args))            # вызов с распакованными из списка параметрами
[3, 4, 5]&lt;/syntaxhighlight&gt;

Схожим способом, словари могут получать именованные параметры через **-синтаксис&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;'''опред''' попугай(вольтаж, состояние='труп', действие='ввум', тип='Норвежский Голубой'):&lt;br/&gt;
...&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Этот попугай не сделает &quot;, действие, конец=' ')&lt;br/&gt;
...&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;если вы пропустите через него &quot;, вольтаж, &quot; вольт.&quot;, конец=' ')&lt;br/&gt;
...&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''(&quot;-- Это&quot;, состояние, &quot;!&quot;)&lt;br/&gt;
...&lt;br/&gt;
&gt;&gt;&gt; d = {&quot;вольтаж&quot;: &quot;четыре миллиона&quot;, &quot;состояние&quot;: &quot;кровавая кончина&quot;, &quot;действие&quot;: &quot;ВВУМ&quot;}&lt;br/&gt;
&gt;&gt;&gt; попугай(**d)&lt;br/&gt;
-- Этот попугай не сделает ВВУМ если вы пропустите через него четыре миллиона вольт. Это кровавая смерть !&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;
(''Из [http://www.ibras.dk/montypython/episode08.htm#6 скетча Монти Пайтона]'')&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def parrot(voltage, state='a stiff', action='voom'):
...     print(&quot;-- This parrot wouldn't&quot;, action, end=' ')
...     print(&quot;if you put&quot;, voltage, &quot;volts through it.&quot;, end=' ')
...     print(&quot;It's&quot;, state, &quot;!&quot;)
...
&gt;&gt;&gt; d = {&quot;voltage&quot;: &quot;four million&quot;, &quot;state&quot;: &quot;bleedin' demised&quot;, &quot;action&quot;: &quot;VOOM&quot;}
&gt;&gt;&gt; parrot(**d)
-- This parrot wouldn't VOOM if you put four million volts through it. It's bleedin' demised !&lt;/syntaxhighlight&gt;

==== Модель &lt;tt&gt;lambda&lt;/tt&gt; ====

В связи с неустанными просьбами, в Python были добавлены несколько возможностей, которые были привычны для функциональных языков программирования, таких как Lisp. Используя зарезервированное слово &lt;code&gt;lambda&lt;/code&gt;, вы можете создать небольшую безымянную функцию. Например, функцию, которая возвращает сумму двух своих аргументов, можно записать так: &lt;code&gt;lambda a, b: a+b&lt;/code&gt;. Формы &lt;code&gt;lambda&lt;/code&gt; могут быть использованы в любом месте где требуется объект функции. При этом они синтаксически ограничены одним выражением. Семантически, они лишь «синтаксический сахар» для обычного определения функции. Как и определения вложенных функций, &lt;code&gt;lambda&lt;/code&gt;-формы могут ссылаться на переменные из содержащей их области видимости:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def make_incrementor(n):
...     return lambda x: x + n
...
&gt;&gt;&gt; f = make_incrementor(42)
&gt;&gt;&gt; f(0)
42
&gt;&gt;&gt; f(1)
43&lt;/syntaxhighlight&gt;

==== Строки документации ====

Перечислим некоторые существующие соглашения по содержимому строк документации и их форматированию.

По поводу форматирования строк документации и их содержимого постоянно появляются всё новые соглашения.

Первая строка всегда должна быть сжатой, лаконичной сводкой о назначении объекта. Для краткости, в ней не обязательно присутствие имени типа или объекта, поскольку они доступны другими способами (исключая случай, когда имя функции оказывается глаголом, описывающим суть операции). Эта строка должна начинаться с прописной буквы и оканчиваться точкой.

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

Парсер Python не обрабатывает отступы в много-строковых литералах, поэтому инструментам, которые работают над документацией, предлагается, по желанию, делать это самим. Производится это по следующему соглашению. Первая непустая строка после первой строки литерала определяет величину отступа всего литерала документации. (Мы не можем использовать первую строку, поскольку она обычно выравнивается по открывающим кавычкам и её отступ в литерале не явен). Пробельный «эквивалент» этого отступа затем отрезается от начала всех строк литерала. Строк с меньшим отступом не должно обнаруживаться, но если они встретились, весь их начальный отступ должен быть обрезан. Эквивалентность пробельных замен может быть протестирована развертыванием табуляции (обычно, к 8 пробелам).

Вот пример многострочной документации (''док-строки''):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def my_function():
...     &quot;&quot;&quot;Не делаем ничего, но документируем.
...
...     Нет, правда, эта функция ничего не делает.
...     &quot;&quot;&quot;
...     pass
...
&gt;&gt;&gt; print(my_function.__doc__)
Не делаем ничего, но документируем.

    Нет, правда, эта функция ничего не делает.&lt;/syntaxhighlight&gt;

=== Интермеццо: Стиль написания кода ===

Теперь, когда вам предстоит писать более объёмные и сложные блоки кода на Python, настало время поговорить о ''стиле написания кода'' (&lt;tt&gt;coding style&lt;/tt&gt;). Код на большинстве языков программирования может быть записан (или, точнее говоря, ''отформатирован'' (&lt;tt&gt;formatted&lt;/tt&gt;)) различными способами; некоторые из них более читабельны, некоторые — нет. Стремление к написанию лёгкого для прочтения другими кода всегда считалось хорошим тоном, и выбор правильного стиля для кода крайне ему способствует.

В случае языка Python, в качестве руководства по стилю было создано предложение [http://www.python.org/dev/peps/pep-0008 PEP8]&lt;ref&gt;''(Прим. перев.)'' — &lt;tt&gt;[[w:Python_Enhancement_Proposal|PEP]]&lt;/tt&gt; (&lt;/tt&gt;''Python Enchancement Proprosal&lt;/tt&gt;'', Предложение по улучшению Python) — документ, имеющий стандартизированный формат и описывающий какую-либо из возможностей или какое-либо из свойств языка Python, планируемые для разработки в будущем (или уже разработанную). В завершённом варианте используется как основное соглашение по данной функциональности. (см. также [[w:Python#Дальнейшая разработка|пояснение на странице языка Python]])&lt;/ref&gt;, которого придерживаются создатели большинства проектов. В нём учреждается чрезвычайно читабельный и приятный для глаза стиль написания кода. В некоторый момент с ним должен ознакомиться каждый разработчик на Python. Приведём здесь избранные, наиболее важные, пункты:

* Используйте отступ в 4 пробела, не используйте табуляцию
: 4 пробела легко опознаются и в случае небольших отступов (хватает места для глубоких вложений) и в случае больших отступов (приятнее читается). Табуляция вносит путаницу и лучше от неё воздержаться.
* Разделяйте строки так, чтобы их длина не превышала 79-и символов
: Это поможет пользователям с небольшими экранами, а пользователям с большими экранами позволит уложить несколько файлов с исходным кодом рядом.
* Используйте пустые строки для отделения функций, классов, и крупных блоков внутри функций.
* При возможности располагайте комментарий на отдельной строке.
* Используйте строки документации (''док-строки'')
* Применяйте пробелы вокруг символов операций и после запятых, но не добавляйте их в конструкции со скобками: &lt;code&gt;a = f(1, 2) + g(3, 4)&lt;/code&gt;
* Называйте ваши классы и функции единообразно; соглашение следующее: используйте &lt;code&gt;CamelCase&lt;/code&gt;&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;CamelCase&lt;/tt&gt; (''ВерблюжийСтиль'') — стиль именования идентификаторов, при котором все слова, записанные строчными буквами, объединяются в одно и первая буква каждого слова выделяется заглавной буквой — такая запись напоминает верблюжьи горбы, в связи с чем и названа.&lt;/ref&gt; для именования классов и &lt;code&gt;нижний_регистр_с_подчёркиваниями&lt;/code&gt;&lt;/tt&gt;&lt;ref&gt;''(Прим. перев.)'' Пусть данный пример по вине переводчика и использует русские буквы, соглашение корректно настаивает на использовании латиницы для именования идентификаторов, см. следующий пункт соглашения&lt;/ref&gt; для функций и методов. (обращайтесь к разделу [[Учебник Python 3.1#Первый взгляд на классы|Первый взгляд на классы]] за дополнительной информацией о классах и методах)
* Не используйте в вашем коде изощрённых кодировок&lt;ref&gt;''(Прим. перев.)'' В строковых литералах (не комментариях) это, конечно же, позволено&lt;/ref&gt;, если он рассчитан на использование в интернациональной среде. Стандартный набор ASCII всегда работает на ура&lt;ref&gt;''(Прим. перев.)'' Не кодировка, а именно набор символов — латиница, пунктуация и несколько служебных символов. Кодировка по умолчанию для файлов с иходными кодами, начиная с Python 3.0, всегда UTF-8 — дабы существовала возможность использовать национальные символы в строковых литералах и, в редких случаях — комментариях.&lt;/ref&gt;.

== Структуры данных ==

Эта глава описывает подробнее некоторые вещи, которые вы уже изучили, а также раскрывает некоторые новые темы.

=== Подробнее о списках ===

У типа данных список также имеются не описанные ранее методы. Ниже приведены все методы объекта типа список:

;&lt;code&gt;list.append(''x'')&lt;/code&gt;:Добавить элемент к концу списка; эквивалент &lt;code&gt;list[len(list):] = [x]&lt;/code&gt;

;&lt;code&gt;list.extend(''L'')&lt;/code&gt;:Расширить список за счёт добавления всех элементов переданного списка; эквивалентно &lt;code&gt;list[len(list):] = L&lt;/code&gt;.

;&lt;code&gt;list.insert(''i'', ''x'')&lt;/code&gt;:Вставить элемент в указанную позицию. Первый аргумент — это индекс того элемента, перед которым требуется выполнить операцию вставки, поэтому вызов &lt;code&gt;list.insert(0, x)&lt;/code&gt; вставляет элемент в начало списка, а &lt;code&gt;list.insert(len(list), x)&lt;/code&gt; эквивалентно &lt;code&gt;list.append(x)&lt;/code&gt;.

;&lt;code&gt;list.remove(''x'')&lt;/code&gt;:Удалить первый найденный элемент из списка, значение которого — &lt;code&gt;x&lt;/code&gt;. Если элемент не найден, генерируется ошибка.

;&lt;code&gt;list.pop([''i''])&lt;/code&gt;:Удалить элемент, находящийся на указанной позиции в списке, и вернуть его. Если индекс не указан, &lt;code&gt;list.pop()&lt;/code&gt; удаляет и возвращает последний элемент списка. (Квадратные скобки вокруг &lt;code&gt;i&lt;/code&gt; в сигнатуре метода означают, что параметр необязателен, а не необходимость набора квадратных скобок в этой позиции. Вы часто будете встречать такую нотацию в [[Справочник по библиотеке Python 3.1|Справочнике по библиотеке]].)

;&lt;code&gt;list.index(''x'')&lt;/code&gt;:Вернуть индекс первого найденного в списке элемента, значение которого равно &lt;code&gt;x&lt;/code&gt;. Если элемент не найден, генерируется ошибка.

;&lt;code&gt;list.count(''x'')&lt;/code&gt;:Вернуть значение сколько раз, &lt;code&gt;x&lt;/code&gt; встречается в списке.

;&lt;code&gt;list.sort()&lt;/code&gt;:Сортировать элементы списка, на месте.

;&lt;code&gt;list.reverse()&lt;/code&gt;:Обратить порядок элементов списка, на месте.

Пример, использующий большинство методов списка:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = [66.25, 333, 333, 1, 1234.5]
&gt;&gt;&gt; print(a.count(333), a.count(66.25), a.count('x'))
2 1 0
&gt;&gt;&gt; a.insert(2, -1)
&gt;&gt;&gt; a.append(333)
&gt;&gt;&gt; a
[66.25, 333, -1, 333, 1, 1234.5, 333]
&gt;&gt;&gt; a.index(333)
1
&gt;&gt;&gt; a.remove(333)
&gt;&gt;&gt; a
[66.25, -1, 333, 1, 1234.5, 333]
&gt;&gt;&gt; a.reverse()
&gt;&gt;&gt; a
[333, 1234.5, 1, 333, -1, 66.25]
&gt;&gt;&gt; a.sort()
&gt;&gt;&gt; a
[-1, 1, 66.25, 333, 333, 1234.5]&lt;/syntaxhighlight&gt;

==== Использование списка в качестве стека ====

Методы списков позволяют легко использовать список в качестве стека, где последний добавленный элемент становится первым полученным («первый вошёл — последний вышел»). Чтобы положить элемент на вершину стека, используйте метод &lt;code&gt;append()&lt;/code&gt;. Для получения элемента с вершины стека — метод &lt;code&gt;pop()&lt;/code&gt; без указания явного индекса. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; stack = [3, 4, 5]
&gt;&gt;&gt; stack.append(6)
&gt;&gt;&gt; stack.append(7)
&gt;&gt;&gt; stack
[3, 4, 5, 6, 7]
&gt;&gt;&gt; stack.pop()
7
&gt;&gt;&gt; stack
[3, 4, 5, 6]
&gt;&gt;&gt; stack.pop()
6
&gt;&gt;&gt; stack.pop()
5
&gt;&gt;&gt; stack
[3, 4]&lt;/syntaxhighlight&gt;

==== Использование списка в качестве очереди ====

Вы можете без труда использовать список также и в качестве очереди, где первый добавленный элемент оказывается первым полученным («первый вошёл — первый вышел»). Чтобы добавить элемент в конец очереди, используйте метод &lt;code&gt;append()&lt;/code&gt;, а чтобы получить элемент из начала очереди — метод &lt;code&gt;pop()&lt;/code&gt; с нулём в качестве индекса. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; queue = [&quot;Eric&quot;, &quot;John&quot;, &quot;Michael&quot;]
&gt;&gt;&gt; queue.append(&quot;Terry&quot;)           # Прибыл Terry
&gt;&gt;&gt; queue.append(&quot;Graham&quot;)          # Прибыл Graham
&gt;&gt;&gt; queue.pop(0)
'Eric'
&gt;&gt;&gt; queue.pop(0)
'John'
&gt;&gt;&gt; queue
['Michael', 'Terry', 'Graham']&lt;/syntaxhighlight&gt;

==== Генераторы списков&lt;ref&gt;''(Прим. перев.)'' ''Lists Comprehensions'', comprehension — включение, вложение, добавление (понимание, охват, интенция).&lt;/ref&gt; ====

Использование метода списковой сборки — легкий способ создать список на основе последовательности. В большинстве случаев он применяется для создания списков, в которых каждый элемент является результатом некой операции, произведённой над каждым членом последовательности, или для создания выборок из тех элементов, которые удовлетворяют определённому условию.

Любая списковая сборка состоит из выражения, за которым следует оператор &lt;code&gt;for&lt;/code&gt;, а затем ноль или более операторов &lt;code&gt;for&lt;/code&gt; или &lt;code&gt;if&lt;/code&gt;. Результатом станет список, получившийся через вычисление выражения в контексте следующих за ним операторов &lt;code&gt;for&lt;/code&gt; и/или &lt;code&gt;if&lt;/code&gt;. Если в результате вычисления выражения строится кортеж, его нужно явно обернуть в скобки.

В следующем примере на основе списка чисел создаётся список, где каждое число утроено:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; vec = [2, 4, 6]
&gt;&gt;&gt; [3*x for x in vec]
[6, 12, 18]&lt;/syntaxhighlight&gt;

Применим фантазию:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; [[x, x**2] for x in vec]
[[2, 4], [4, 16], [6, 36]]&lt;/syntaxhighlight&gt;

Здесь мы вызываем метод по очереди с каждым элементом последовательности:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; freshfruit = ['  banana', '  loganberry ', 'passion fruit  ']
&gt;&gt;&gt; [weapon.strip() for weapon in freshfruit]
['banana', 'loganberry', 'passion fruit']&lt;/syntaxhighlight&gt;

Используя оператор &lt;code&gt;if&lt;/code&gt;, мы можем отфильтровать поток:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; [3*x for x in vec if x &gt; 3]
[12, 18]
&gt;&gt;&gt; [3*x for x in vec if x &lt; 2]
[]&lt;/syntaxhighlight&gt;

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

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; [x, x**2 for x in vec]   # ошибка - для кортежей необходимы скобки
File &quot;&lt;stdin&gt;&quot;, line 1, in ?
 [x, x**2 for x in vec]
           ^
SyntaxError: invalid syntax
&gt;&gt;&gt; [(x, x**2) for x in vec]
[(2, 4), (4, 16), (6, 36)]&lt;/syntaxhighlight&gt;

Вот несколько вложенных циклов &lt;code&gt;for&lt;/code&gt; и ещё кое-какое забавное поведение:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; vec1 = [2, 4, 6]
&gt;&gt;&gt; vec2 = [4, 3, -9]
&gt;&gt;&gt; [x*y for x in vec1 for y in vec2]
[8, 6, -18, 16, 12, -36, 24, 18, -54]
&gt;&gt;&gt; [x+y for x in vec1 for y in vec2]
[6, 5, -7, 8, 7, -5, 10, 9, -3]
&gt;&gt;&gt; [vec1[i]*vec2[i] for i in range(len(vec1))]
[8, 12, -54]&lt;/syntaxhighlight&gt;

Списковые сборки могут применяться в сложных выражениях и вложенных функциях&lt;ref&gt;''(Прим. перев.)'' в Python, как и в большинстве других языков программирования, используется европейский стандарт разделения целой и дробной части десятичных дробей точкой.&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; [str(round(355/113, i)) for i in range(1, 6)]
['3.1', '3.14', '3.142', '3.1416', '3.14159']&lt;/syntaxhighlight&gt;

==== Вложенные списковые сборки ====

Если вы в состоянии это переварить: списковые сборки могут быть вложенными. Но как любой мощный инструмент, их следует использовать с осторожностью.

Представьте нижеследующий пример матрицы 3x3 в виде списка, содержащего три других списка, по одному в ряд:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; mat = [
...        [1, 2, 3],
...        [4, 5, 6],
...        [7, 8, 9],
...       ]&lt;/syntaxhighlight&gt;

Чтобы поменять строки и столбцы местами, можно использовать такую списковую сборку:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print([[row[i] for row in mat] for i in [0, 1, 2]])
[[1, 4, 7], [2, 5, 8], [3, 6, 9]]&lt;/syntaxhighlight&gt;

Применяя вложенные списковые сборки, необходимо помнить о важной вещи:

: Во избежание недоразумений при конструировании вложенных списковых сборок, читайте их справа налево.

Более многословная, с использованием операторов, версия примера может служить иллюстрацией:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;for i in [0, 1, 2]:
    for row in mat:
        print(row[i], end=&quot;&quot;)
    print()&lt;/syntaxhighlight&gt;

В реальных случаях лучше использовать встроенные функции вместо сложных выражений. В нашем случае поможет функция &lt;code&gt;zip()&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; list(zip(*mat))
[(1, 4, 7), (2, 5, 8), (3, 6, 9)]&lt;/syntaxhighlight&gt;

В разделе [[Учебник Python 3.1#Распаковка списков параметров|Распаковка списков параметров]] описано предназначение звёздочки в этих строках.

Другой пример использования вложенных списковых сборок — произведение матрицы a на матрицу b:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;c=[[sum(x*y for x,y in zip(i,j)) for j in zip(*b)] for i in a]&lt;/syntaxhighlight&gt;

Это можно сделать эффективнее и прозрачнее, но на данном примере видна мощь инструмента.

Получение единичной матрицы порядка n:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;a=[[0]*i+[1]+[0]*(n-i-1) for i in range(n)]&lt;/syntaxhighlight&gt;

=== Оператор &lt;code&gt;del&lt;/code&gt; ===

Существует способ удалить элемент, указывая его индекс, а не его значение: оператор &lt;code&gt;del&lt;/code&gt;. В отличие от метода &lt;code&gt;pop()&lt;/code&gt;, он не возвращает значения. Оператор &lt;code&gt;del&lt;/code&gt; может также использоваться для удаления срезов из списка или полной очистки списка (что мы делали ранее через присваивание пустого списка срезу). Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = [-1, 1, 66.25, 333, 333, 1234.5]
&gt;&gt;&gt; del a[0]
&gt;&gt;&gt; a
[1, 66.25, 333, 333, 1234.5]
&gt;&gt;&gt; del a[2:4]
&gt;&gt;&gt; a
[1, 66.25, 1234.5]
&gt;&gt;&gt; del a[:]
&gt;&gt;&gt; a
[]&lt;/syntaxhighlight&gt;

&lt;code&gt;del&lt;/code&gt; может быть также использован для удаления переменных полностью:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; del a&lt;/syntaxhighlight&gt;

Ссылка на имя &lt;code&gt;a&lt;/code&gt; в дальнейшем вызовет ошибку (по крайней мере до тех пор, пока с ним не будет связано другое значение). Позже мы с вами узнаем другие способы использования &lt;code&gt;del&lt;/code&gt;.

=== Кортежи и последовательности ===

Мы видели, что списки и строки поддерживают много привычных свойств, таких как индексирование и операция получения срезов. Существует два подвида типов данных ''последовательность'' (&lt;tt&gt;sequence&lt;/tt&gt;) (см. [[Справочник по библиотеке Python 3.1#Последовательности|Справочник по библиотеке — Последовательности]]), и поскольку Python — развивающийся язык, со временем могут быть добавлены другие последовательные типы данных. Итак, существует также и другой, достойный рассмотрения, стандартный последовательный тип данных: ''кортеж'' (&lt;tt&gt;tuple&lt;/tt&gt;).

Кортеж состоит из некоторого числа значений разделённых запятыми, например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; t = 12345, 54321, 'hello!'
&gt;&gt;&gt; t[0]
12345
&gt;&gt;&gt; t
(12345, 54321, 'hello!')
&gt;&gt;&gt; # Кортежи могут быть вложенными:
... u = t, (1, 2, 3, 4, 5)
&gt;&gt;&gt; u
((12345, 54321, 'hello!'), (1, 2, 3, 4, 5))&lt;/syntaxhighlight&gt;

Как видите, кортежи на выводе всегда заключены в скобки, таким образом вложенные кортежи интерпретируются корректно; они могут быть введены и с обрамляющими скобками и без, тем не менее в любом случае скобки чаще всего необходимы (если кортеж — часть более крупного выражения).

Кортежи можно использовать в различных целях. Например: &lt;code&gt;(x, y)&lt;/code&gt; пары координат, записи о рабочих из базы данных, и так далее. Кортежи, как и строки, неизменяемы: невозможно присвоить что-либо индивидуальным элементам кортежа (однако, вы можете симулировать большинство схожих эффектов за счёт операций срезов и конкатенации). Также можно создать кортежи, содержащие изменяемые объекты, такие как списки.

Определённая проблема состоит в конструировании кортежей, состоящих из нуля или одного элемента: в синтаксисе языка есть дополнительные хитрости, позволяющие достигнуть этого. Пустые кортежи формируются за счёт пустой пары скобок; кортеж с одним элементом конструируется за счёт запятой, следующей за первым и единственным значением (его не обязательно заключать в скобки). Необычно, но эффективно. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; empty = ()
&gt;&gt;&gt; singleton = 'hello',    # &lt;-- обратите внимание на замыкающую запятую
&gt;&gt;&gt; len(empty)
0
&gt;&gt;&gt; len(singleton)
1
&gt;&gt;&gt; singleton
('hello',)&lt;/syntaxhighlight&gt;

Выражение &lt;code&gt;t = 12345, 54321, 'hello!'&lt;/code&gt; является примером ''упаковки кортежей'' (&lt;tt&gt;tuple packing&lt;/tt&gt;): значения &lt;code&gt;12345&lt;/code&gt;, &lt;code&gt;54321&lt;/code&gt; и &lt;code&gt;'hello!'&lt;/code&gt; упаковываются в кортеж вместе. Обратная операция также возможна:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; x, y, z = t&lt;/syntaxhighlight&gt;

Такое действие называется, довольно удачно, ''распаковкой последовательности'' (&lt;tt&gt;sequence unpacking&lt;/tt&gt;). Для распаковки на левой стороне требуется список переменных с количеством элементов равным длине последовательности. Обратите внимание, что множественное присваивание на самом деле является лишь комбинацией упаковки кортежа и распаковки последовательности.

Здесь есть некоторая асимметрия: упаковка нескольких значений всегда создаёт кортеж, а распаковка работает для любой последовательности.

=== Множества ===

Python имеет также тип данных ''множество'' (&lt;tt&gt;set&lt;/tt&gt;). Множество — это неупорядоченная коллекция без дублирующихся элементов. Основные способы использования — проверка на вхождение и устранение дублирующихся элементов. Объекты этого типа поддерживают обычные математические операции над множествами, такие как объединение, пересечение, разность и симметрическая разность.

Для создания множеств могут быть использованы фигурные скобки или функция &lt;tt&gt;set()&lt;/tt&gt;. ''Заметьте:'' Для создания пустого множества нужно использовать &lt;code&gt;set()&lt;/code&gt;, а не &lt;code&gt;{}&lt;/code&gt;: в последнем случае создаётся пустой ''словарь'' (&lt;tt&gt;dictionary&lt;/tt&gt;) — тип данных, который мы обсудим в следующем разделе.

Продемонстрируем работу с множествами на небольшом примере&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;&gt;&gt;&gt; корзина = {'яблоко', 'апельсин', 'яблоко', 'груша', 'апельсин', 'банан'}&lt;br/&gt;
&gt;&gt;&gt; ''вывести''(корзина)&lt;br/&gt;
{'апельсин', 'банан', 'яблоко', 'груша'}&lt;br/&gt;
&gt;&gt;&gt; список_фруктов = ['яблоко', 'апельсин', 'яблоко', 'груша', 'апельсин', 'банан']&lt;br/&gt;
&gt;&gt;&gt; фрукты = ''множество''(список_фруктов)&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;# создать множество на основе данных из списка (заметьте исчезновение дубликатов -перев.)&lt;br/&gt;
&gt;&gt;&gt; фрукты&lt;br/&gt;
{'апельсин', 'груша', 'яблоко', 'банан'}&lt;br/&gt;
&gt;&gt;&gt; фрукты = {'апельсин', 'яблоко'}&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;# синтаксис {} эквивалентен [] у списков&lt;br/&gt;
 &gt;&gt;&gt; фрукты&lt;br/&gt;
 {'апельсин', 'яблоко'}&lt;br/&gt;
&gt;&gt;&gt; 'апельсин' '''среди''' фрукты&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;# быстрая проверка вхождения&lt;br/&gt;
Истина&lt;br/&gt;
&gt;&gt;&gt; 'росичка' '''среди''' фрукты&lt;br/&gt;
Ложь&lt;/code&gt;&lt;br /&gt;&lt;br /&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; basket = {'apple', 'orange', 'apple', 'pear', 'orange', 'banana'}
&gt;&gt;&gt; print(basket)
{'orange', 'banana', 'pear', 'apple'}
&gt;&gt;&gt; fruit_list = ['apple', 'orange', 'apple', 'pear', 'orange', 'banana']
&gt;&gt;&gt; fruit = set(fruit_list)               # создать множество на основе данных из списка (заметьте исчезновение дубликатов -перев.)
&gt;&gt;&gt; fruit
{'orange', 'pear', 'apple', 'banana'}
&gt;&gt;&gt; fruit = {'orange', 'apple'}       # синтаксис {} эквивалентен [] у списков
&gt;&gt;&gt; fruit
{'orange', 'apple'}
&gt;&gt;&gt; 'orange' in fruit                 # быстрая проверка на вхождение
True
&gt;&gt;&gt; 'crabgrass' in fruit
False&lt;/syntaxhighlight&gt;

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; # Демонстрация операций со множествами на примере букв из двух слов
...
&gt;&gt;&gt; a = set('abracadabra')
&gt;&gt;&gt; b = set('alacazam')
&gt;&gt;&gt; a                                  # уникальные буквы в a
{'a', 'r', 'b', 'c', 'd'}
&gt;&gt;&gt; a - b                              # буквы в a но не в b
{'r', 'd', 'b'}
&gt;&gt;&gt; a | b                              # все буквы, которые встречаются в a или в b
{'a', 'c', 'r', 'd', 'b', 'm', 'z', 'l'}
&gt;&gt;&gt; a &amp; b                              # буквы, которые есть и в a и в b
{'a', 'c'}
&gt;&gt;&gt; a ^ b                              # буквы в a или в b, но не в обоих
{'r', 'd', 'b', 'm', 'z', 'l'}&lt;/syntaxhighlight&gt;

Как и у списков, у множеств существует синтаксис сборок:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = {x for x in 'abracadabra' if x not in 'abc'}
&gt;&gt;&gt; a
{'r', 'd'}&lt;/syntaxhighlight&gt;

=== Словари ===

Другой полезный встроенный в Python тип данных — это ''словарь'' (&lt;tt&gt;dictionary&lt;/tt&gt;) (см. [[Справочник по библиотеке Python 3.1#Связывающие типы|Справочник по библиотеке — Связывающие типы]]). Словари иногда встречаются в других языках в виде «ассоциативных записей» или «ассоциативных массивов». В отличие от последовательностей, которые индексируются по диапазону чисел, словари индексируются по ''ключам'' (&lt;tt&gt;keys&lt;/tt&gt;), которые, в свою очередь, могут быть любого неизменяемого типа; строки и числа всегда могут быть ключами. Кортежи могут быть ключами только если они составлены из строк, чисел или кортежей; если кортеж содержит какой-либо изменяемый объект, явно или неявно, то он не может быть использован в качестве ключа. Вы не можете использовать списки в роли ключей, поскольку списки могут быть изменены на месте присваиванием по индексу, присваиванием по срезу или такими методами как &lt;code&gt;append()&lt;/code&gt; и &lt;code&gt;extend()&lt;/code&gt;.

Лучше всего воспринимать словарь как неупорядоченный набор пар ''ключ: значение'' с требованием, чтобы ключи были уникальны (в пределах одного словаря). Пара скобок создает пустой словарь: &lt;code&gt;{}&lt;/code&gt;. Указывая разделённый запятыми список пар ''ключ: значение'' внутри скобок, вы задаёте содержимое словаря; в таком же формате словарь можно вывести.

Главные операции над словарём — это сохранение значения с каким-либо ключом и извлечение значения по указанному ключу. Также возможно удалить пару ''ключ: значение'' используя оператор &lt;code&gt;del&lt;/code&gt;. Если вы сохраняете значение используя ключ, который уже встречается в словаре — старое значение, ассоциированное с этим ключом, стирается. Извлечение значения по несуществующему ключу вызывает ошибку.

Выполнение конструкции &lt;code&gt;list(d.keys())&lt;/code&gt; с объектом словаря возвращает список всех ключей, использующихся в словаре, в случайном порядке (если вы хотите отсортировать его, к списку ключей можно применить функцию &lt;code&gt;sorted()&lt;/code&gt;). Чтобы проверить, содержит ли словарь определённый ключ, используйте ключевое слово &lt;code&gt;in&lt;/code&gt;.

Вот небольшой пример использования словарей:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; tel = {'jack': 4098, 'sape': 4139}
&gt;&gt;&gt; tel['guido'] = 4127
&gt;&gt;&gt; tel
{'sape': 4139, 'guido': 4127, 'jack': 4098}
&gt;&gt;&gt; tel['jack']
4098
&gt;&gt;&gt; del tel['sape']
&gt;&gt;&gt; tel['irv'] = 4127
&gt;&gt;&gt; tel
{'guido': 4127, 'irv': 4127, 'jack': 4098}
&gt;&gt;&gt; list(tel.keys())
['irv', 'guido', 'jack']
&gt;&gt;&gt; sorted(tel.keys())
['guido', 'irv', 'jack']
&gt;&gt;&gt; 'guido' in tel
True
&gt;&gt;&gt; 'jack' not in tel
False&lt;/syntaxhighlight&gt;

Конструктор &lt;code&gt;dict()&lt;/code&gt; строит словарь непосредственно на основе пар ключей и значений, где каждая пара представлена в виде кортежа. Когда пары могут быть сформированы шаблоном, ''списковые сборки'' помогут описать список пар более компактно.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; dict([('sape', 4139), ('guido', 4127), ('jack', 4098)])
{'sape': 4139, 'jack': 4098, 'guido': 4127}&lt;/syntaxhighlight&gt;

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

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; {x: x**2 for x in (2, 4, 6)}
{2: 4, 4: 16, 6: 36}&lt;/syntaxhighlight&gt;

Позже в учебнике мы изучим выражения-генераторы (&lt;tt&gt;Generator Expressions&lt;/tt&gt;), которые даже лучше подходят для снабжения конструктора &lt;code&gt;dict()&lt;/code&gt; парами ключ-значение.

Если ключи являются простыми строками, иногда легче описать пары используя именованные параметры:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; dict(sape=4139, guido=4127, jack=4098)
{'sape': 4139, 'jack': 4098, 'guido': 4127}&lt;/syntaxhighlight&gt;

=== Организация циклов ===

При организации перебора элементов из словаря ключ и соответствующее ему значение могут быть получены одновременно посредством метода &lt;code&gt;items()&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; knights = {'gallahad': 'the pure', 'robin': 'the brave'}
&gt;&gt;&gt; for k, v in knights.items():
...     print(k, v)
...
gallahad the pure
robin the brave&lt;/syntaxhighlight&gt;

Функция &lt;code&gt;enumerate()&lt;/code&gt; поможет пронумеровать элементы перебираемой в цикле последовательности:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for i, v in enumerate(['tic', 'tac', 'toe']):
...     print(i, v)
...
0 tic
1 tac
2 toe&lt;/syntaxhighlight&gt;

Для того, чтобы организовать цикл параллельно для двух или более последовательностей, элементы можно предварительно сгруппировать функцией &lt;code&gt;zip()&lt;/code&gt;&lt;ref&gt;''(Прим. перев.):''
&lt;br /&gt;&lt;br /&gt;
&lt;code style=&quot;background-color: inherit !important;&quot;&gt;&gt;&gt;&gt; вопросы = ['имя', 'задание', 'любимый цвет']&lt;br/&gt;
&gt;&gt;&gt; ответы = ['ланцелот', 'святой грааль', 'синий']&lt;br/&gt;
&gt;&gt;&gt; '''для''' вопрос, ответ '''из''' ''застегнуть''(вопросы, ответы):&lt;br/&gt;
... &amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'''вывести'''('Каков(о) ваш(е) {0}?  {1}.'.форматировать(вопрос, ответ))&lt;br/&gt;
...&lt;br/&gt;
Каков(о) ваш(е) имя?  ланцелот.&lt;br/&gt;
Каков(о) ваш(е) задание?  святой грааль.&lt;br/&gt;
Каков(о) ваш(е) любимый цвет?  синий.&lt;/code&gt;&lt;/ref&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; questions = ['name', 'quest', 'favorite color']
&gt;&gt;&gt; answers = ['lancelot', 'the holy grail', 'blue']
&gt;&gt;&gt; for q, a in zip(questions, answers):
...     print('What is your {0}?  It is {1}.'.format(q, a))
...
What is your name?  It is lancelot.
What is your quest?  It is the holy grail.
What is your favorite color?  It is blue.&lt;/syntaxhighlight&gt;

Изменить порядок следования последовательности на обратный поможет функция &lt;code&gt;reversed()&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for i in reversed(range(1, 10, 2)):
...     print(i)
...
9
7
5
3
1&lt;/syntaxhighlight&gt;

Для организации цикла по отсортированной последовательности можно применить функцию &lt;code&gt;sorted()&lt;/code&gt;, которая возвращает отсортированный список, оставляя исходный без изменений.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; basket = ['apple', 'orange', 'apple', 'pear', 'orange', 'banana']
&gt;&gt;&gt; for f in sorted(set(basket)):
...     print(f)
...
apple
banana
orange
pear&lt;/syntaxhighlight&gt;

=== Подробнее об условиях ===

Условия в операторах &lt;code&gt;if&lt;/code&gt; и &lt;code&gt;while&lt;/code&gt; могут содержать любые операции, а не только операции сравнения.

Операции сравнения &lt;code&gt;in&lt;/code&gt; и &lt;code&gt;not in&lt;/code&gt; проверяют, встречается значение в последовательности или нет. Операции &lt;code&gt;is&lt;/code&gt; и &lt;code&gt;is not&lt;/code&gt; проверяют, не являются ли два объекта на самом деле одним и тем же (это имеет смысл лишь для изменяемых объектов, таких как списки). Все операции сравнения имеют один и тот же приоритет, меньший чем у любых операций над числами.

Сравнения можно объединять в цепочки. Например, &lt;code&gt;a &lt; b == c&lt;/code&gt; проверяет, меньше ли &lt;code&gt;a&lt;/code&gt; чем &lt;code&gt;b&lt;/code&gt; и, сверх того, равны ли &lt;code&gt;b&lt;/code&gt; и &lt;code&gt;c&lt;/code&gt;.

Сравнения могут быть скомбинированы с использованием булевых операций &lt;code&gt;and&lt;/code&gt; и &lt;code&gt;or&lt;/code&gt;, а результат сравнения (или любого другого булева выражения) можно отрицать используя &lt;code&gt;not&lt;/code&gt;. Эти операции имеют меньший приоритет, чем у операций сравнения; среди них у &lt;code&gt;not&lt;/code&gt; высший приоритет, а у &lt;code&gt;or&lt;/code&gt; — низший, поэтому &lt;code&gt;A and not B or C&lt;/code&gt; эквивалентно &lt;code&gt;(A and (not B)) or C&lt;/code&gt;. Как всегда, явно заданные скобки помогут выразить желаемый порядок выполнения операций.

Булевы операции &lt;code&gt;and&lt;/code&gt; и &lt;code&gt;or&lt;/code&gt; — это так называемые ''коротящие операции''&lt;ref&gt;''(Прим. перев.)'' ''short-circuit''{{ref-en}} — закоротить, обходить, идти обходными путями (для достижения цели), препятствовать&lt;/ref&gt; (&lt;tt&gt;short-circuit operators&lt;/tt&gt;): их операнды вычисляются слева направо и вычисление заканчивается как только результат становится определён (очевиден). Например, если &lt;code&gt;A&lt;/code&gt; и &lt;code&gt;C&lt;/code&gt; истинны, а &lt;code&gt;B&lt;/code&gt; — ложно, в условии &lt;code&gt;A and B and C&lt;/code&gt; выражение &lt;code&gt;C&lt;/code&gt; не вычисляется. Когда ''коротящая операция'' используется не в контексте логической операции, она возвращает последний элемент, который был вычислен.

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

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; string1, string2, string3 = '', 'Trondheim', 'Hammer Dance'
&gt;&gt;&gt; non_null = string1 or string2 or string3
&gt;&gt;&gt; non_null
'Trondheim'&lt;/syntaxhighlight&gt;

Заметьте, что в Python (в отличие от C) присваивание не может использоваться внутри выражений. Программисты на C могут возмутиться по этому поводу, но на самом деле это позволяет избежать ряда проблем, обычного для программ на C: указания оператора присваивания (&lt;code&gt;=&lt;/code&gt;) в выражении, вместо предполагавшегося сравнения (&lt;code&gt;==&lt;/code&gt;).

=== Сравнение последовательностей и других типов ===

Объекты последовательностей можно сравнивать с другими объектами с тем же типом последовательности. Сравнение использует лексикографический порядок: сравниваются первые два элемента, и если они различны — результат сравнения определён; если они равны, сравниваются следующие два элемента и так далее до тех пор, пока одна из последовательностей не будет исчерпана. Если сравниваемые два элемента сами являются последовательностями одного типа, лексикографическое сравнение происходит в них рекурсивно. Если все элементы обеих последовательностей оказались равны, последовательности считаются равными. Если одна последовательность оказывается стартовой последовательностью другой, более короткая последовательность считается меньшей. Лексикографическое упорядочивание строк использует порядок в таблице Unicode для индивидуальных символов. Несколько примеров сравнений между однотипными последовательностями:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;(1, 2, 3)              &lt; (1, 2, 4)
[1, 2, 3]              &lt; [1, 2, 4]
&quot;Пайтон&quot; &lt; &quot;Паскаль&quot; &lt; &quot;Си&quot; &lt; &quot;Си++&quot;
(1, 2, 3, 4)           &lt; (1, 2, 4)
(1, 2)                 &lt; (1, 2, -1)
(1, 2, 3)             == (1.0, 2.0, 3.0)
(1, 2, ('aa', 'ab'), 4)   &lt; (1, 2, ('abc', 'a'))&lt;/syntaxhighlight&gt;

Обратите внимание, что сравнение объектов различных типов операциями &lt;code&gt;&lt;&lt;/code&gt; или &lt;code&gt;&gt;&lt;/code&gt; позволено, если объекты имеют соответствующие методы сравнения. Например, смешанные числовые типы сравниваются в соответствии с их численными значениями, так что &lt;code&gt;0&lt;/code&gt; равен &lt;code&gt;0.0&lt;/code&gt; и т. д. В противном случае интерпретатор, прервав процесс сортировки, возбудит исключение &lt;code&gt;TypeError&lt;/code&gt;.

== Модули ==

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

В языке Python можно поместить требуемые определения в файл и использовать их в сценариях или в интерактивном режиме интерпретатора. Такой файл называется ''модулем'' (&lt;tt&gt;module&lt;/tt&gt;). Определения из модуля могут быть импортированы в других модулях, либо в главном модуле (собрание переменных, к которым есть доступ в сценарии, который непосредственно запускается, и в интерактивном режиме).

Модуль — это файл, содержащий определения и операторы Python. Именем файла является имя модуля с добавленным суффиксом &lt;tt&gt;.py&lt;/tt&gt;. Внутри модуля, имя модуля (в качестве строки) доступно в виде значения глобальной переменной с именем &lt;code&gt;__name__&lt;/code&gt;. Например, используя ваш любимый текстовый редактор, создайте в текущем каталоге файл с именем &lt;tt&gt;fibo.py&lt;/tt&gt; со следующим содержимым:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&quot;&quot;&quot;Модуль вычисления чисел Фибоначчи&quot;&quot;&quot;

def fib(n):    # вывести числа Фибоначчи вплоть до n
    a, b = 0, 1
    while b &lt; n:
        print(b, end=' ')
        a, b = b, a+b
    print()

def fib2(n): # вернуть числа Фибоначчи вплоть до n
    result = []
    a, b = 0, 1
    while b &lt; n:
        result.append(b)
        a, b = b, a+b
    return result&lt;/syntaxhighlight&gt;

Теперь можно войти в интерпретатор Python и импортировать этот модуль следующей командой:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import fibo&lt;/syntaxhighlight&gt;

Это действие не переводит имена определённых в модуле функций в текущую таблицу символов, а лишь имя модуля &lt;code&gt;fibo&lt;/code&gt;. Используя имя модуля, вы можете получить доступ к функциям:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; fibo.fib(1000)
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987
&gt;&gt;&gt; fibo.fib2(100)
[1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]
&gt;&gt;&gt; fibo.__name__
'fibo'&lt;/syntaxhighlight&gt;

Если вы собираетесь использовать функцию часто, можно присвоить её локальному имени:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; fib = fibo.fib
&gt;&gt;&gt; fib(500)
1 1 2 3 5 8 13 21 34 55 89 144 233 377&lt;/syntaxhighlight&gt;

=== Подробнее о модулях ===

Помимо определений функций модуль может содержать исполняемые операторы. Назначение этих операторов — инициализация модуля: они выполняются при первом импортировании модуля где-либо&lt;ref&gt;Фактически, определения функций — те же «исполняемые» «операторы». Выполнение помещает имя функции в ''глобальную таблицу символов''.&lt;/ref&gt;.

Каждый модуль имеет свою собственную ''таблицу символов'', которая используется в качестве глобальной всеми определёнными в модуле функциями. Таким образом, автор модуля может использовать глобальные символы в модуле, не опасаясь неожиданных совпадений с глобальными переменными пользователя. С другой стороны, если вы знаете, что делаете, можно сослаться на глобальные переменные модуля, пользуясь той же нотацией, которая применялась для ссылок на его функции: &lt;tt&gt;''&amp;lt;имя_модуля&gt;''.''&amp;lt;имя_элемента&gt;''&lt;/tt&gt;.

Модули могут импортировать другие модули. Не требуется указывать все операторы &lt;code&gt;import&lt;/code&gt; в начале модуля (или сценария, с той же целью), но обычно так и делается. Имена из импортированного модуля добавляются в ''глобальную таблицу символов'' модуля его импортирующего.

Есть вариант оператора &lt;code&gt;import&lt;/code&gt;, который переносит имена из модуля прямо в таблицу символов импортирующего модуля. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from fibo import fib, fib2
&gt;&gt;&gt; fib(500)
1 1 2 3 5 8 13 21 34 55 89 144 233 377&lt;/syntaxhighlight&gt;

При этом имя самого модуля, из которого переносятся имена элементов, не добавляется в ''локальную таблицу символов'' (так, в этом примере, имя &lt;code&gt;fibo&lt;/code&gt; не определено)

И есть даже способ импортировать все имена, которые определяет данный модуль:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from fibo import *
&gt;&gt;&gt; fib(500)
1 1 2 3 5 8 13 21 34 55 89 144 233 377&lt;/syntaxhighlight&gt;

Импортируются все имена, кроме тех, которые начинаются на подчёркивание (&lt;code&gt;_&lt;/code&gt;). В большинстве случаев программисты на Python не используют эту возможность, поскольку она внедряет в интерпретатор целый набор новых неизвестных имён и может скрыть некоторые объекты, которые вы уже определили.

{{Info2|Для повышения эффективности, каждый модуль импортируется лишь единожды за сеанс работы с интерпретатором. Поэтому, если вы изменили ваши модули, вам придётся перезапустить интерпретатор. Или, если вам нужно перезагрузить конкретный модуль, можно использовать &lt;code&gt;imp.reload()&lt;/code&gt; таким образом: &lt;code&gt;import imp; imp.reload(&lt;имя_модуля&gt;)&lt;/code&gt;}}

==== Выполнение модулей в качестве сценариев ====

Когда вы запускаете модуль Python в виде

&lt;syntaxhighlight lang=&quot;python&quot;&gt;python fibo.py &lt;параметры&gt;&lt;/syntaxhighlight&gt;

то код в этом модуле будет исполнен в момент его импортирования, но значением &lt;code&gt;__name__&lt;/code&gt; будет строка &lt;code&gt;&quot;__main__&quot;&lt;/code&gt;. Это значит, что добавляя следующий код в конец сценария:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;if __name__ == &quot;__main__&quot;:
    import sys
    fib(int(sys.argv[1]))&lt;/syntaxhighlight&gt;

вы можете сделать возможным запуск файла и в качестве сценария, и в качестве импортируемого модуля. Это возможно, поскольку разбирающий командную строку код выполняется только при исполнении модуля как ''основного'' (&lt;tt&gt;main&lt;/tt&gt;) файла:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;$ python fibo.py 50
1 1 2 3 5 8 13 21 34&lt;/syntaxhighlight&gt;

Если модуль импортируется, код не будет выполнен:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import fibo
&gt;&gt;&gt;&lt;/syntaxhighlight&gt;

Такой приём часто используется, чтобы предоставить удобный пользовательский интерфейс к модулю или для тестирования (выполнение модуля в качестве сценария запускает набор тестов).

==== Путь поиска модулей ====

Если импортируется модуль с именем &lt;code&gt;spam&lt;/code&gt;, интерпретатор ищет файл с именем &lt;tt&gt;spam.py&lt;/tt&gt; в текущем каталоге, а затем в каталогах, указанных в переменной окружения &lt;code&gt;PYTHONPATH&lt;/code&gt;. У неё такой же синтаксис, как и у переменной шелла &lt;code&gt;PATH&lt;/code&gt;, которая, в свою очередь, является перечислением каталогов. Когда переменная &lt;code&gt;PYTHONPATH&lt;/code&gt; не установлена, или файл не найден в описанных в ней местах, поиск продолжается по пути по умолчанию, зависящему от указанного при установке; на Unix это обычно &lt;tt&gt;.:/usr/local/lib/python&lt;/tt&gt;.

В действительности поиск модулей производится в списке каталогов в переменной &lt;code&gt;sys.path&lt;/code&gt;, которая обычно содержит: каталог, в котором находится сценарий на входе (или текущий каталог), &lt;code&gt;PYTHONPATH&lt;/code&gt; и умолчанием для каталога, указанного при установке. Это позволяет программам на Python (если программист знает, что делает) изменять или подменять путь поиска модулей. Заметьте: поскольку каталог, содержащий запускаемый вами сценарий, также находится в пути поиска, важно, чтобы в нем не было сценариев с именем стандартного модуля. Иначе, когда этот модуль будет импортироваться, Python будет пытаться загрузить в виде модуля сам сценарий, что в большинстве случаев вызовет ошибку. Для более подробной информации обратитесь к разделу [[Учебник Python 3.1#Стандартные модули|Стандартные модули]].

==== «Скомпилированные» файлы Python ====

Интерпретатор Python применяет один важный приём для ускорения запуска программы: если в каталоге, где располагается файл с некоторым модулем &lt;tt&gt;spam.py&lt;/tt&gt;, находится также файл &lt;tt&gt;spam.pyc&lt;/tt&gt;, предполагается, что это уже скомпилированная в байт-код («&lt;tt&gt;byte-compiled&lt;/tt&gt;») версия модуля &lt;code&gt;spam&lt;/code&gt;. В файле &lt;tt&gt;spam.pyc&lt;/tt&gt; зафиксировано время изменения файла &lt;tt&gt;spam.py&lt;/tt&gt; версии, использовавшейся для создания &lt;tt&gt;spam.pyc&lt;/tt&gt;. Если версии не совпадают — файл &lt;tt&gt;.pyc&lt;/tt&gt; игнорируется.

В обычном случае, вам не нужно ничего делать для создания файла &lt;tt&gt;spam.pyc&lt;/tt&gt;. Каждый раз, когда &lt;tt&gt;spam.py&lt;/tt&gt; успешно компилируется, предпринимается попытка записать скомпилированную версию в &lt;tt&gt;spam.pyc&lt;/tt&gt;. Не считается ошибкой, если попытка неудачна: если по какой-либо причине файл не записан полностью, результирующий файл &lt;tt&gt;spam.pyc&lt;/tt&gt; будет считаться некорректным и по этой причине в дальнейшем игнорироваться. Содержимое файла &lt;tt&gt;spam.pyc&lt;/tt&gt; платформо-независимо, благодаря чему каталог модулей Python может использоваться параллельно машинами с различной архитектурой.

Несколько советов экспертам:

* Когда интерпретатор Python запускается с флагом &lt;tt&gt;'''-O'''&lt;/tt&gt;, в файлах &lt;tt&gt;.pyo&lt;/tt&gt; сохраняется сгенерированный оптимизированный код. На данный момент оптимизатор помогает не сильно — он лишь удаляет операторы &lt;code&gt;assert&lt;/code&gt;. В случае использования &lt;tt&gt;'''-O'''&lt;/tt&gt; оптимизируется весь ''байт-код'' (&lt;tt&gt;bytecode&lt;/tt&gt;); файлы &lt;tt&gt;.pyc&lt;/tt&gt; игнорируются, а файлы &lt;tt&gt;.py&lt;/tt&gt; компилируются в оптимизированный байт-код.

* Передача двух флагов &lt;tt&gt;'''-O'''&lt;/tt&gt; интерпретатору Python (&lt;tt&gt;'''-OO'''&lt;/tt&gt;) принуждает компилятор байт-кода выполнять оптимизации, в редких случаях результат выполнения которых оказывается некачественно функционирующей программой. На данный момент из байт-кода удаляются только строки &lt;code&gt;__doc__&lt;/code&gt;, в результате получаются более компактные файлы &lt;tt&gt;.pyo&lt;/tt&gt;. Поскольку некоторые программы могут рассчитывать на их (строк) доступность, следует использовать эту возможность только в том случае, если вы знаете что делаете.

* Программа сама по себе не работает хоть сколь-нибудь быстрее, будучи прочитанной из файла &lt;tt&gt;.pyc&lt;/tt&gt; или &lt;tt&gt;.pyo&lt;/tt&gt;, чем если бы она была прочитана из файла &lt;tt&gt;.py&lt;/tt&gt;. Единственный процесс, оказывающийся более быстрым при использовании файлов &lt;tt&gt;.pyc&lt;/tt&gt; или &lt;tt&gt;.pyo&lt;/tt&gt; — это скорость их подгрузки.

* Если сценарий запущен из командной строки, его байт-код никогда не будет записан в файл &lt;tt&gt;.pyc&lt;/tt&gt; или &lt;tt&gt;.pyo&lt;/tt&gt;. Таким образом, время запуска сценария может быть уменьшено за счёт перемещения большей части его кода в модули или использования небольшого загрузочного сценария, импортирующего этот модуль. Кроме того, можно указывать файл &lt;tt&gt;.pyc&lt;/tt&gt; или &lt;tt&gt;.pyo&lt;/tt&gt; прямо в командной строке.

* Можно иметь в наличии файл с именем &lt;tt&gt;spam.pyc&lt;/tt&gt; (или &lt;tt&gt;spam.pyo&lt;/tt&gt;, когда используется &lt;tt&gt;'''-O'''&lt;/tt&gt;), не имея файла &lt;tt&gt;spam.py&lt;/tt&gt; для того же модуля. Таким образом можно распространять библиотеки кода Python в том виде, из которого трудно восстановить исходный код.

* Модуль &lt;tt&gt;[[Справочник по библиотеке Python 3.1#compileall|compileall]]&lt;/tt&gt; может создать файлы &lt;tt&gt;.pyc&lt;/tt&gt; (или файлы &lt;tt&gt;.pyo&lt;/tt&gt;, когда используется &lt;tt&gt;'''-O'''&lt;/tt&gt;) для всех модулей в каталоге.

=== Стандартные модули ===

Python поставляется с библиотекой стандартных модулей, описанной в отдельном документе, [[Справочник по библиотеке Python 3.1|Справочнике по библиотеке Python]] (далее — «Справочнику по библиотеке»). Некоторые модули встроены в интерпретатор. Они обеспечивают доступ к операциям, не входящим в ядро языка, и встроены для большей эффективности и предоставления доступа к основным средствам операционной системы, таким как ''системные вызовы'' (&lt;tt&gt;system calls&lt;/tt&gt;). Набор таких модулей — выбор настройки, зависимый от используемой платформы. Например, модуль &lt;code&gt;winreg&lt;/code&gt; предоставляется только на системах с Windows. Один конкретный модуль заслуживает большего внимания: модуль &lt;tt&gt;[[Справочник по библиотеке Python 3.1#sys|sys]]&lt;/tt&gt;, встроенный в каждую версию интерпретатора Python. Переменные &lt;code&gt;sys.ps1&lt;/code&gt; и &lt;code&gt;sys.ps2&lt;/code&gt; определяют строки, использующиеся в качестве основного и вспомогательного приглашений:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import sys
&gt;&gt;&gt; sys.ps1
'&gt;&gt;&gt; '
&gt;&gt;&gt; sys.ps2
'... '
&gt;&gt;&gt; sys.ps1 = &quot;Вводите: &quot;
Вводите: print('Ох!')
Ох!
Вводите:
&lt;/syntaxhighlight&gt;

Эти две переменные определены только для интерактивного режима интерпретатора.

Переменная &lt;code&gt;sys.path&lt;/code&gt; представляет собой список строк, определяющий путь поиска модулей интерпретатора. Она инициализируется значением пути по умолчанию, взятым из переменной окружения &lt;tt&gt;PYTHONPATH&lt;/tt&gt;, или встроенным значением по умолчанию, если &lt;tt&gt;PYTHONPATH&lt;/tt&gt; не установлен. Вы можете изменить её значение, используя стандартные операции со списками:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import sys
&gt;&gt;&gt; sys.path.append('/ufs/guido/lib/python')&lt;/syntaxhighlight&gt;

=== Функция &lt;code&gt;dir()&lt;/code&gt; ===

Встроенная функция &lt;code&gt;dir()&lt;/code&gt; используется для получения имён, определённых в модуле. Она возвращает отсортированный список строк:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import fibo, sys
&gt;&gt;&gt; dir(fibo)
['__name__', 'fib', 'fib2']
&gt;&gt;&gt; dir(sys)
['__displayhook__', '__doc__', '__excepthook__', '__name__', '__stderr__',
 '__stdin__', '__stdout__', '_getframe', 'api_version', 'argv', 
 'builtin_module_names', 'byteorder', 'callstats', 'copyright',
 'displayhook', 'exc_info', 'excepthook',
 'exec_prefix', 'executable', 'exit', 'getdefaultencoding', 'getdlopenflags',
 'getrecursionlimit', 'getrefcount', 'hexversion', 'maxint', 'maxunicode',
 'meta_path', 'modules', 'path', 'path_hooks', 'path_importer_cache',
 'platform', 'prefix', 'ps1', 'ps2', 'setcheckinterval', 'setdlopenflags',
 'setprofile', 'setrecursionlimit', 'settrace', 'stderr', 'stdin', 'stdout',
 'version', 'version_info', 'warnoptions']&lt;/syntaxhighlight&gt;

Будучи использованной без аргументов, функция &lt;code&gt;dir()&lt;/code&gt; возвращает список имён, определённых в данный момент.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; a = [1, 2, 3, 4, 5]
&gt;&gt;&gt; import fibo
&gt;&gt;&gt; fib = fibo.fib
&gt;&gt;&gt; dir()
['__builtins__', '__doc__', '__file__', '__name__', 'a', 'fib', 'fibo', 'sys']&lt;/syntaxhighlight&gt;

Обратите внимание, что список состоит из имён всех типов: переменных, модулей, функций и т. д.

В возвращаемом функцией &lt;code&gt;dir()&lt;/code&gt; списке не содержится встроенных функций и переменных. Если вы хотите получить ''их'' список, то они определены в стандартном модуле &lt;code&gt;builtins&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import builtins
&gt;&gt;&gt; dir(builtins)
['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException', 'Buffer
Error', 'DeprecationWarning', 'EOFError', 'Ellipsis', 'EnvironmentError', 'Excep
tion', 'False', 'FloatingPointError', 'FutureWarning', 'GeneratorExit', 'IOError
', 'ImportError', 'ImportWarning', 'IndentationError', 'IndexError', 'KeyError',
 'KeyboardInterrupt', 'LookupError', 'MemoryError', 'NameError', 'None', 'NotImp
lemented', 'NotImplementedError', 'OSError', 'OverflowError', 'PendingDeprecatio
nWarning', 'ReferenceError', 'RuntimeError', 'RuntimeWarning', 'StopIteration',
'SyntaxError', 'SyntaxWarning', 'SystemError', 'SystemExit', 'TabError', 'True',
 'TypeError', 'UnboundLocalError', 'UnicodeDecodeError', 'UnicodeEncodeError', '
UnicodeError', 'UnicodeTranslateError', 'UnicodeWarning', 'UserWarning', 'ValueE
rror', 'Warning', 'ZeroDivisionError', '__build_class__', '__debug__', '__doc__'
, '__import__', '__name__', 'abs', 'all', 'any', 'basestring', 'bin', 'bool', 'b
uffer', 'bytes', 'chr', 'chr8', 'classmethod', 'cmp', 'compile', 'complex', 'cop
yright', 'credits', 'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval', 'ex
ec', 'exit', 'filter', 'float', 'frozenset', 'getattr', 'globals', 'hasattr', 'h
ash', 'help', 'hex', 'id', 'input', 'int', 'isinstance', 'issubclass', 'iter', '
len', 'license', 'list', 'locals', 'map', 'max', 'memoryview', 'min', 'next', 'o
bject', 'oct', 'open', 'ord', 'pow', 'print', 'property', 'quit', 'range', 'repr
', 'reversed', 'round', 'set', 'setattr', 'slice', 'sorted', 'staticmethod', 'st
r', 'str8', 'sum', 'super', 'trunc', 'tuple', 'type', 'vars', 'zip']&lt;/syntaxhighlight&gt;

=== Пакеты ===

Пакеты — способ структурирования ''пространств имён'' (&lt;tt&gt;namespaces&lt;/tt&gt;) модулей Python за счёт использования имён модулей, разделённых точками («&lt;tt&gt;dotted module names&lt;/tt&gt;»). Например, имя модуля &lt;code&gt;A.B&lt;/code&gt; означает — подмодуль&lt;ref&gt;''(Прим. перев.)'' ''подмодуль'' (&lt;tt&gt;submodule&lt;/tt&gt;), ''зд.'' — модуль, находящийся в пакете. ''подпакет'' (&lt;tt&gt;subpackage&lt;/tt&gt;), ''зд.'' — пакет, расположенный в пакете.&lt;/ref&gt; с именем &lt;code&gt;B&lt;/code&gt; в пакете с именем &lt;code&gt;A&lt;/code&gt;. Так же как использование модулей позволяет авторам различных модулей не заботиться о пересекающихся именах среди глобальных переменных, использование именования через точку позволяет авторам многомодульных пакетов (таких как &lt;tt&gt;NumPy&lt;/tt&gt; или &lt;tt&gt;Python Imaging Library&lt;/tt&gt;) не заботиться о конфликтах имён модулей.

Допустим, вы собираетесь разработать набор модулей (''пакет'', &lt;tt&gt;package&lt;/tt&gt;) для унифицированной работы со звуковыми файлами и звуковыми данными. Существует множество форматов звуковых файлов (обычно их можно распознать по расширению, например: &lt;tt&gt;.wav&lt;/tt&gt;, &lt;tt&gt;.aiff&lt;/tt&gt;, &lt;tt&gt;.au&lt;/tt&gt;). Таким образом, вам может понадобиться создать и поддерживать разрастающуюся коллекцию модулей для конвертирования между различными форматами файлов. Также вам наверняка захочется иметь побольше операций для обработки звуковых данных (таких как смешивание, добавление эха, применение функции эквалайзера, создание искусственного стерео-эффекта), поэтому в дополнение к этому вы будете писать нескончаемый поток модулей для исполнения этих операций. Вот возможная структура вашего пакета (выраженная в терминологии иерархической файловой системы):

&lt;pre style=&quot;color:#00008b;&quot;&gt;sound/                          Пакет верхнего уровня
      __init__.py               Инициализация пакета работы со звуком (sound)
      formats/                  Подпакет для конвертирования форматов файлов
              __init__.py
              wavread.py        (чтение wav)
              wavwrite.py       (запись wav)
              aiffread.py       (чтение aiff)
              aiffwrite.py      (запись aiff)
              auread.py         (чтение au)
              auwrite.py        (запись au)
              ...
      effects/                  Подпакет для звуковых эффектов
              __init__.py
              echo.py           ( эхо )
              surround.py       ( окружение )
              reverse.py        ( обращение )
              ...
      filters/                  Подпакет для фильтров
              __init__.py
              equalizer.py      ( эквалайзер )
              vocoder.py        ( вокодер ) 
              karaoke.py        ( караоке )
              ...&lt;/pre&gt;

При импорте пакета Python ищет подкаталог пакета в каталогах, перечисленных в &lt;code&gt;sys.path&lt;/code&gt;.

Файлы &lt;tt&gt;__init__.py&lt;/tt&gt; необходимы для того, чтобы Python трактовал эти каталоги как содержащие пакеты. Это сделано во избежание нечаянного сокрытия правомерных модулей, встречающихся в дальнейшем по пути поиска, каталогами с часто используемыми именами, таким как «&lt;code&gt;string&lt;/code&gt;». В наипростейшем случае файл &lt;tt&gt;__init__.py&lt;/tt&gt; может быть пустым, но в более сложных может содержать код инициализации пакета или устанавливать значение описанной ниже переменной &lt;code&gt;__all__&lt;/code&gt;.

Пользователи пакета могут импортировать из него конкретные модули, например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import sound.effects.echo&lt;/syntaxhighlight&gt;

Таким образом подгружается подмодуль &lt;code&gt;sound.effects.echo&lt;/code&gt;. Ссылаться на него нужно используя его полное имя:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;sound.effects.echo.echofilter(input, output, delay=0.7, atten=4)&lt;/syntaxhighlight&gt;

Другой способ импортирования подмодуля:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;from sound.effects import echo&lt;/syntaxhighlight&gt;

Так тоже подгружается подмодуль &lt;code&gt;echo&lt;/code&gt;, но теперь он доступен без префикса пакета, поэтому может использоваться следующим образом:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;echo.echofilter(input, output, delay=0.7, atten=4)&lt;/syntaxhighlight&gt;

И еще один вариант — прямое импортирование желаемой функции или переменной:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;from sound.effects.echo import echofilter&lt;/syntaxhighlight&gt;

Опять же, таким образом подгружается подмодуль &lt;code&gt;echo&lt;/code&gt;, но теперь его функция &lt;code&gt;echofilter()&lt;/code&gt; может быть вызвана непосредственно:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;echofilter(input, output, delay=0.7, atten=4)&lt;/syntaxhighlight&gt;

Заметьте, что при использовании выражения &lt;code&gt;from ''пакет'' import ''элемент''&lt;/code&gt;, ''элементом'' может быть подмодуль (или подпакет) пакета или любое другое имя, определённое в пакете — например, функция, класс или переменная. Оператор &lt;code&gt;import&lt;/code&gt; сначала проверяет, определён ли элемент в пакете; если нет — он трактует его как модуль и пытается загрузить. Если не удается его найти, порождается исключение &lt;code&gt;ImportError&lt;/code&gt;.

Напротив, при использовании синтаксиса в стиле &lt;code&gt;import ''элемент''.''подэлемент''.''подэлемент''&lt;/code&gt;, все элементы кроме последнего должны быть пакетами; последний элемент может быть модулем или пакетом, но не может быть классом, функцией или переменной, определёнными в предыдущем элементе.

==== Импорт &lt;code&gt;*&lt;/code&gt; из пакета ====

Что происходит, когда пользователь пишет &lt;code&gt;from sound.effects import *&lt;/code&gt; ? В идеале, мы бы надеялись, что таким образом код выходит в файловую систему и находит какие подмодули существуют в пакете, импортируя их все. К сожалению, такой метод не очень хорошо работает на платформах Windows, поскольку у файловой системы не всегда есть корректная информация о регистре имён файлов. На этих платформах нет гарантированного способа узнать, нужно ли импортировать файл &lt;tt&gt;ECHO.PY&lt;/tt&gt; в качестве модуля &lt;code&gt;echo&lt;/code&gt;, &lt;code&gt;Echo&lt;/code&gt; или &lt;code&gt;ECHO&lt;/code&gt;. (Например, у Windows 95 есть назойливая привычка показывать имена всех файлов с заглавной буквы.) Ограничение DOS на имя файла в формате 8+3 добавляет забавную проблему, связанную с длинными именами модулей.

Единственный выход для автора пакета — предоставить его подробное содержание. Оператор &lt;code&gt;import&lt;/code&gt; использует следующее соглашение: если в коде файла &lt;tt&gt;__init__.py&lt;/tt&gt; текущего пакета определён список &lt;code&gt;__all__&lt;/code&gt;, то он полагается списком имён модулей, которые нужно импортировать в случае &lt;code&gt;from ''пакет'' import *&lt;/code&gt;. На совести автора поддержка этого списка в соответствующем состоянии в каждой новой версии пакета. Впрочем, авторы пакета могут его не поддерживать вообще, если не видят смысла в импортировании &lt;code&gt;*&lt;/code&gt; из их пакета. Например, файл &lt;code&gt;sounds/effects/__init__.py&lt;/code&gt; может содержать следующий код:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;__all__ = [&quot;echo&quot;, &quot;surround&quot;, &quot;reverse&quot;]&lt;/syntaxhighlight&gt;

Это будет значить, что выражение &lt;code&gt;from sound.effects import *&lt;/code&gt; импортирует три именованных подмодуля из пакета &lt;code&gt;sound&lt;/code&gt;.

Если список &lt;code&gt;__all__&lt;/code&gt; не определён, оператор &lt;code&gt;from Sound.Effects import *&lt;/code&gt; не импортирует все подмодули пакета &lt;code&gt;sound.effects&lt;/code&gt; в текущее пространство имён: он лишь убеждается, что импортирован пакет &lt;code&gt;sound.effects&lt;/code&gt; (возможно, выполняя код инициализации из &lt;tt&gt;__init__.py&lt;/tt&gt;), а затем импортирует все определённые в пакете имена. В этот список попадают любые имена, определённые (и загруженные явно подмодулями) в &lt;tt&gt;__init__.py&lt;/tt&gt;. В него также попадают все явно загруженные предшествующими операторами &lt;code&gt;import&lt;/code&gt; подмодули. Рассмотрим следующий код:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import sound.effects.echo
import sound.effects.surround
from sound.effects import *&lt;/syntaxhighlight&gt;

В этом примере модули &lt;code&gt;echo&lt;/code&gt; и &lt;code&gt;surround&lt;/code&gt; импортируются в текущее пространство имён, поскольку они определены в пакете &lt;code&gt;sound.effects&lt;/code&gt; на тот момент, когда исполняется оператор &lt;code&gt;from ... import&lt;/code&gt;. (И это также работает если определён &lt;code&gt;__all__&lt;/code&gt;.)

Обратите внимание, что в общем случае импортирование &lt;code&gt;*&lt;/code&gt; из модуля не приветствуется, поскольку в результате часто получается плохо-читаемый код. Однако, вполне нормально использовать его в интерактивных сессиях, чтобы меньше печатать, а определённые модули разработаны для экспорта только тех имён, которые следуют определённым шаблонам.

Помните: в использовании &lt;code&gt;from ''пакет'' import ''определённый_подмодуль''&lt;/code&gt; нет ничего плохого. На самом деле — это рекомендованная запись, до тех пор пока при импортировании модуля не нужно использовать подмодули с одинаковым именем из разных пакетов.

==== Ссылки внутри пакета ====

Когда пакеты структурированы в подпакеты (например, в случае пакета &lt;code&gt;sound&lt;/code&gt;), для того, чтобы сослаться на пакеты-потомки вы можете использовать абсолютное импортирование (&lt;tt&gt;absolute imports&lt;/tt&gt;). Например, если модуль &lt;code&gt;sound.filters.vocoder&lt;/code&gt; нуждается в модуле &lt;code&gt;echo&lt;/code&gt; из пакета &lt;code&gt;sound.effects&lt;/code&gt;, он должен использовать &lt;code&gt;from sound.effects import echo&lt;/code&gt;.

Вы можете также использовать ''относительное импортирование'' (&lt;tt&gt;relative imports&lt;/tt&gt;), применяя следующую форму оператора &lt;code&gt;import&lt;/code&gt;: &lt;code&gt;from ''модуль'' import ''имя''&lt;/code&gt; . При таком способе импортирования для описания текущего и родительского пакетов используется символ точки. Например, для модуля &lt;code&gt;surround&lt;/code&gt; вы можете написать:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;from . import echo
from .. import formats
from ..filters import equalizer&lt;/syntaxhighlight&gt;

Обратите внимание, что относительное импортирование основано на имени текущего модуля. Поскольку имя главного модуля всегда «&lt;code&gt;__main__&lt;/code&gt;», модули, предназначенные для использования в качестве главных модулей приложения на Python, должны всегда использовать ''абсолютное импортирование'' (&lt;tt&gt;absolute imports&lt;/tt&gt;).

==== Пакеты в нескольких каталогах ====

Пакеты поддерживают ещё один специальный аттрибут: &lt;code&gt;__path__&lt;/code&gt;. Перед исполнением файла &lt;tt&gt;__init__.py&lt;/tt&gt; этого пакета, он инициализируется списком, содержащим имя каталога, в котором этот файл находится. Изменив переменную, можно повлиять на ход поиска модулей и подпакетов, содержащихся в пакете.

Хотя эта возможность нужна не так часто, она может быть использована для расширения набора модулей, находящихся в пакете.

== Ввод и вывод ==

Ознакомить пользователя с выводом программы можно различными способами — данные могут быть выведены в читаемом виде или записаны в файл для последующего использования. Часть возможностей будет обсуждена в этой главе.

=== Удобное форматирование вывода ===

На данный момент мы выяснили два способа вывода значений: ''операторные выражения'' (&lt;tt&gt;expression statements&lt;/tt&gt;) и функция &lt;code&gt;print()&lt;/code&gt;. (Третий способ — использование метода &lt;code&gt;write()&lt;/code&gt; объектов файлов; на файл стандартного вывода можно сослаться как на &lt;code&gt;sys.stdout&lt;/code&gt;. Более подробную информацию по этому пункту смотрите в [[Справочник по библиотеке Python 3.1|Справочнике по библиотеке]].)

Часто возникает желание иметь больший контроль над форматированием вывода, чем обычная печать значений разделённых пробелами. Есть два способа форматирования вашего вывода. Первый способ — выполнять самостоятельно всю работу над строками: используя срезы строк и конкатенацию вы можете создать любой шаблон, какой пожелаете. Стандартный модуль &lt;code&gt;string&lt;/code&gt; содержит много полезных операций для выравнивания строк по определённой ширине колонки (скоро мы их кратко рассмотрим). Второй способ — использование метода &lt;code&gt;str.format()&lt;/code&gt;.

Модуль &lt;code&gt;string&lt;/code&gt; содержит класс &lt;code&gt;Template&lt;/code&gt;, который предоставляет ещё один способ подстановки значений в строки.

Остаётся, конечно, один вопрос: каким образом конвертировать значения в строки? К счастью, в Python есть два способа для преобразования любого значения в строку — это функции &lt;code&gt;repr()&lt;/code&gt; и &lt;code&gt;str()&lt;/code&gt;.

Предназначение функции &lt;code&gt;str()&lt;/code&gt; — возврат значений в довольно-таки читабельной форме; в отличие от &lt;code&gt;repr()&lt;/code&gt;, чьё назначение — генерирование форм&lt;ref&gt;(''Прим. перев.'') ''representation'' {{ref-en}} — представление, образ, форма&lt;/ref&gt;, которые могут быть прочитаны интерпретатором (или вызовут ошибку &lt;code&gt;SyntaxError&lt;/code&gt;, если эквивалентного синтаксиса не существует). Для тех объектов, у которых нет формы для человеческого прочтения функция &lt;code&gt;str()&lt;/code&gt; возвратит такое же значение, как и &lt;code&gt;repr()&lt;/code&gt;. У многих значений, таких как числа или структуры, вроде списков и словарей, одинаковая форма для обеих функций. Строки и числа с плавающей точкой, в частности, имеют по две разных формы.

Несколько примеров:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; s = 'Привет, мир.'
&gt;&gt;&gt; str(s)
'Привет, мир.'
&gt;&gt;&gt; repr(s)
&quot;'Привет, мир.'&quot;
&gt;&gt;&gt; str(0.1)
'0.1'
&gt;&gt;&gt; repr(0.1)
'0.10000000000000001'
&gt;&gt;&gt; x = 10 * 3.25
&gt;&gt;&gt; y = 200 * 200
&gt;&gt;&gt; s = 'Значение x - ' + repr(x) + ', а y - ' + repr(y) + '...'
&gt;&gt;&gt; print(s)
Значение x - 32.5, а y - 40000...
&gt;&gt;&gt; # Функция repr(), применённая к строке, добавляет кавычки и обратные слэши:
... hello = 'привет, мир\n'
&gt;&gt;&gt; hellos = repr(hello)
&gt;&gt;&gt; print(hellos)
'привет, мир\n'
&gt;&gt;&gt; # Параметром функции repr() может быть объект Python:
... repr((x, y, ('фарш', 'яйца')))
&quot;(32.5, 40000, ('фарш', 'яйца'))&quot;&lt;/syntaxhighlight&gt;

Вот два способа вывести таблицу квадратов и кубов:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for x in range(1, 11):
...     print(repr(x).rjust(2), repr(x*x).rjust(3), end=' ')
...     # Обратите внимание на использование end в предыдущей строке
...     print(repr(x*x*x).rjust(4))
...
 1   1    1
 2   4    8
 3   9   27
 4  16   64
 5  25  125
 6  36  216
 7  49  343
 8  64  512
 9  81  729
10 100 1000

&gt;&gt;&gt; for x in range(1, 11):
...     print('{0:2d} {1:3d} {2:4d}'.format(x, x*x, x*x*x))
... 
 1   1    1
 2   4    8
 3   9   27
 4  16   64
 5  25  125
 6  36  216
 7  49  343
 8  64  512
 9  81  729
10 100 1000&lt;/syntaxhighlight&gt;

(Обратите внимание, что в первом примере единичные пробелы между колонками добавлены функцией &lt;code&gt;print()&lt;/code&gt;: она всегда вставляет пробелы между своими параметрами)

Этот пример демонстрирует работу метода строковых объектов &lt;code&gt;rjust()&lt;/code&gt;, выравнивающего строку по правому краю в поле переданной ширины, отступая пробелами слева. Имеются также похожие методы &lt;code&gt;ljust()&lt;/code&gt; и &lt;code&gt;center()&lt;/code&gt;. Эти методы не выводят ничего, они лишь возвращают новую строку. Если строка на входе чересчур длинная, то они не усекают её, что обычно является меньшим из зол. (Для усечения можно добавить операцию среза, например: &lt;code&gt;x.ljust(n)[:n]&lt;/code&gt;.)

Есть другой метод — &lt;code&gt;zfill()&lt;/code&gt;, который заполняет нулями пространство слева от числовой строки. Он распознаёт знаки плюс и минус:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; '12'.zfill(5)
'00012'
&gt;&gt;&gt; '-3.14'.zfill(7)
'-003.14'
&gt;&gt;&gt; '3.14159265359'.zfill(5)
'3.14159265359'&lt;/syntaxhighlight&gt;

Основной способ применения метода &lt;code&gt;str.format()&lt;/code&gt; выглядит так&lt;ref&gt;''(Прим. перев.)'' We are the knights who say «Ni!» (''Мы — те рыцари, что говорят «Ни!»'') — цитата из [http://www.mwscomp.com/movies/grail/grail-13.htm сцены 13-й] фильма Монти Пайтон и Святой Грааль (Monty Python and Holy Grail)&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print('Мы — те {0}, что говорят &quot;{1}!&quot;'.format('рыцари', 'Ни'))
Мы — те рыцари, что говорят &quot;Ни!&quot;&lt;/syntaxhighlight&gt;

Скобки с символами внутри (их называют ''полями форматирования'' (&lt;tt&gt;format fields&lt;/tt&gt;)) заменяются на объекты, переданные методу &lt;code&gt;format&lt;/code&gt;. Номер в скобках обозначает позицию объекта в списке параметров, переданных методу &lt;code&gt;format&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print('{0} и {1}'.format('фарш', 'яйца'))
фарш и яйца
&gt;&gt;&gt; print('{1} и {0}'.format('фарш', 'яйца'))
яйца и фарш&lt;/syntaxhighlight&gt;

Если в методе &lt;code&gt;format&lt;/code&gt; используются именованные параметры, можно ссылаться на их значения, используя имя соответствующего аргумента&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;вывести('Этот {пища} — {прилагательное}.'.format(пища='фарш', прилагательное='непередаваемо ужасен'))&lt;/tt&gt;&lt;/ref&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print('Этот {food} — {adjective}.'.format(
...       food='фарш', adjective='непередаваемо ужасен'))
Этот фарш — непередаваемо ужасен.&lt;/syntaxhighlight&gt;

Позиционные и именованные параметры можно произвольно совмещать&lt;ref&gt;''(Прим. перев.)'' &lt;tt&gt;вывести('История о {0}, {1}, и {другой}.'.format('Билл', 'Манфред', другой='Георг'))&lt;/tt&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print('История о {0}е, {1}е, и {other}е.'.format('Билл', 'Манфред',
                                                       other='Георг'))
История о Билле, Манфреде, и Георге.&lt;/syntaxhighlight&gt;

После имени поля может следовать необязательный спецификатор формата ‘&lt;code&gt;:&lt;/code&gt;’. С его помощью можно управлять форматированием значения. Следующий пример оставляет у числа Пи только три цифры после десятичного разделителя&lt;ref&gt;''(Прим. перев.)'' В качестве десятичного разделителя в Python используется точка, в соответствии со стандартами большинства стран.&lt;/ref&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import math
&gt;&gt;&gt; print('Значение ПИ — примерно {0:.3f}.'.format(math.pi))
Значение ПИ — примерно 3.142.&lt;/syntaxhighlight&gt;

После спецификатора ‘&lt;code&gt;:&lt;/code&gt;’ можно указать число — минимальную ширину поля, выраженную в количестве символов. Это удобно использовать для создания красивых таблиц:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; table = {'Sjoerd': 4127, 'Jack': 4098, 'Dcab': 7678}
&gt;&gt;&gt; for name, phone in table.items():
...     print('{0:10} ==&gt; {1:10d}'.format(name, phone))
... 
Jack       ==&gt;       4098
Dcab       ==&gt;       7678
Sjoerd     ==&gt;       4127&lt;/syntaxhighlight&gt;

Если ваша строка с форматами очень длинна, а вы не хотите разбивать её на подстроки, было бы неплохо если бы вы могли ссылаться на переменные, предназначенные для форматирования, не по позиции, а по имени. Это можно сделать, просто передав словарь и используя квадратные скобки ‘&lt;tt&gt;[]&lt;/tt&gt;’ для доступа к ключам.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; table = {'Sjoerd': 4127, 'Jack': 4098, 'Dcab': 8637678}
&gt;&gt;&gt; print('Jack: {0[Jack]:d}; Sjoerd: {0[Sjoerd]:d}; '
          'Dcab: {0[Dcab]:d}'.format(table))
Jack: 4098; Sjoerd: 4127; Dcab: 8637678&lt;/syntaxhighlight&gt;

Тоже самое можно сделать, передав словарь именованных параметров, используя нотацию «&lt;code&gt;**&lt;/code&gt;»:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; table = {'Sjoerd': 4127, 'Jack': 4098, 'Dcab': 8637678}
&gt;&gt;&gt; print('Jack: {Jack:d}; Sjoerd: {Sjoerd:d}; Dcab: {Dcab:d}'.format(**table))
Jack: 4098; Sjoerd: 4127; Dcab: 8637678&lt;/syntaxhighlight&gt;

В частности, такой приём удобно использовать в сочетании со встроенной функцией &lt;code&gt;vars()&lt;/code&gt;, которая возвращает словарь с локальными переменными.

Подробное описание форматирования строк с применением метода &lt;code&gt;str.format()&lt;/code&gt; описано в разделе [[Справочник по библиотеке Python 3.1#Синтаксис строк форматирования|Синтаксис строк форматирования]].

==== Форматирование строк в старом стиле ====

Для форматирования строк можно использовать и операцию &lt;code&gt;%&lt;/code&gt;. Она интерпретирует левый операнд как строку форматирования в стиле &lt;code&gt;sprintf&lt;/code&gt;, которую следует применить к правому операнду, и возвращает строку, получившуюся в результате этого преобразования. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import math
&gt;&gt;&gt; print 'Значение ПИ — примерно %5.3f.' % math.pi
Значение ПИ — примерно 3.142.&lt;/syntaxhighlight&gt;

Поскольку метод &lt;code&gt;str.format()&lt;/code&gt; довольно нов, большая часть исходных кодов Python всё ещё использует операцию &lt;code&gt;%&lt;/code&gt;. Однако, со временем, форматирование строк будет удалено из языка, поэтому в большинстве случаев следует использовать &lt;code&gt;str.format()&lt;/code&gt;.

Больше информации можно найти в разделе [[Справочник по библиотеке Python 3.1#Операции форматирования строк в старом стиле|Операции форматирования строк в старом стиле]].

=== Запись и чтение файлов ===

Функция &lt;code&gt;open()&lt;/code&gt; возвращает объект файла и в большинстве случаев используется с двумя аргументами: &lt;code&gt;open(''имя_файла'', ''режим'')&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f = open('/tmp/workfile', 'w')&lt;/syntaxhighlight&gt;

Первый параметр — строка, содержащая имя файла. Второй — другая строка, содержащая несколько символов, описывающих способ использования файла. Значение параметра ''режим'' может быть символом &lt;code&gt;'r'&lt;/code&gt;, если файл будет открыт только для чтения, &lt;code&gt;'w'&lt;/code&gt; — открыт только для записи (существующий файл с таким же именем будет стёрт) и &lt;code&gt;'a'&lt;/code&gt; — файл открыт для добавления: любые данные, записанные в файл автоматически добавляются в конец. &lt;code&gt;'r+'&lt;/code&gt; открывает файл и для чтения, и для записи. Параметр ''режим'' необязателен: если он опущен — предполагается, что он равен &lt;code&gt;'r'&lt;/code&gt;.

В обычном случае файлы открываются в ''текстовом режиме'' (&lt;tt&gt;text mode&lt;/tt&gt;) — это значит что вы читаете из файла и записываете в файл строки в определённой кодировке (по умолчанию используется &lt;tt&gt;UTF-8&lt;/tt&gt;). Если добавить к режиму файла символ ‘&lt;code&gt;b&lt;/code&gt;’, файл открывается в ''двоичном режиме'' (&lt;tt&gt;binary mode&lt;/tt&gt;): теперь данные считываются и записываются в виде двоичных объектов. Этот режим следует использовать для всех файлов, которые не содержат текст.

При использовании текстового режима, все окончания строк, по умолчанию, специфичные для платформы (&lt;code&gt;\n&lt;/code&gt; в Unix, &lt;code&gt;\r\n&lt;/code&gt; в Windows) усекаются до символа &lt;code&gt;\n&lt;/code&gt;, при чтении из файла, и конвертируются обратно из &lt;code&gt;\n&lt;/code&gt; в вид, специфичный для платформы, при записи в файл. Эти закулисные изменения в файловых данных корректно работают в случае текстовых файлов, но испортят двоичные данные в файлах вроде &lt;code&gt;JPEG&lt;/code&gt; или &lt;code&gt;EXE&lt;/code&gt;. Внимательно следите за тем, чтобы использовать двоичный режим при чтении и записи таких файлов.

==== Методы объектов-файлов ====

В примерах ниже подразумевается, что заранее создан файловый объект с именем &lt;code&gt;f&lt;/code&gt;.

Чтобы прочитать содержимое файла, вызовите &lt;code&gt;f.read(''размер'')&lt;/code&gt; — функция читает некоторое количество данных и возвращает их в виде строки или байтового объекта. &lt;code&gt;''размер''&lt;/code&gt; — необязательный числовой параметр. Если &lt;code&gt;''размер''&lt;/code&gt; опущен или отрицателен, будет прочитано и возвращено всё содержимое файла; если файл по величине в два раза больше оперативной памяти вашего компьютера, то решение этой проблемы остаётся на вашей совести. В противном случае, будет прочитано и возвращено максимум &lt;code&gt;''размер''&lt;/code&gt; байт. Если был достигнут конец файла, &lt;code&gt;f.read()&lt;/code&gt; вернёт пустую строку (&lt;code&gt;''&lt;/code&gt;).

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f.read()
'Это всё содержимое файла.\n'
&gt;&gt;&gt; f.read()
''&lt;/syntaxhighlight&gt;

&lt;code&gt;f.readline()&lt;/code&gt; читает одну строку из файла; символ новой строки (&lt;code&gt;\n&lt;/code&gt;) остаётся в конце прочитанной строки и отсутствует при чтении последней строки файла только если файл не оканчивается пустой строкой. За счёт этого возвращаемое значение становится недвусмысленным: если &lt;code&gt;f.readline()&lt;/code&gt; возвращает пустую строку — достигнут конец файла, в то же время незаполненная строка, представленная посредством &lt;code&gt;'\n'&lt;/code&gt;, содержит лишь символ новой строки.&lt;ref&gt;''(Прим. перев.)'' В источнике, в большинстве случаев, разделяется понятие ''строки'' как типа данных и ''строки'' как строки текста (ср., ''строчка'') применением слов ''string'' и ''line'' соответственно. В русском языке это различие передать сложно, тем не менее я старался по возможности избежать двусмысленностей.&lt;/ref&gt;

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f.readline()
'Это первая строка файла.\n'
&gt;&gt;&gt; f.readline()
'Вторая строка файла\n'
&gt;&gt;&gt; f.readline()
''&lt;/syntaxhighlight&gt;

&lt;code&gt;f.readlines()&lt;/code&gt; возвращает список, содержащий все строки с данными, обнаруженные в файле. Если передан необязательный параметр &lt;code&gt;подсказка_размера&lt;/code&gt;, функция читает из файла указанное количество байт, плюс некоторое количество байт сверх того, достаточное для завершения строки, и формирует список строк из результата. Функция часто используется для более эффективного (файл не загружается в память полностью) построчного чтения больших файлов. Возвращены будут только полные (завершённые) строки.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f.readlines()
['Это первая строка файла.\n', 'Вторая строка файла\n']&lt;/syntaxhighlight&gt;

Альтернативный способ построчного чтения — организация цикла по файловому объекту. Он быстр, рационально использует память и имеет простой код в результате:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; for line in f:
        print(line, end='')
        
Это первая строка файла.
Вторая строка файла&lt;/syntaxhighlight&gt;

Альтернативный способ проще, но не предоставляет тонкого контроля над происходящим. Поскольку оба этих способа работают с буферизацией строк по-разному, их не следует смешивать.

&lt;code&gt;f.write(''строка'')&lt;/code&gt; записывает содержимое ''строки'' в файл и возвращает количество записанных байтов.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f.write('This is a test\n')
15&lt;/syntaxhighlight&gt;

Чтобы записать в файл нечто отличное от строки, предварительно это нечто нужно в строку сконвертировать&lt;ref&gt;''(Прим. перев.)'' Возможно, подразумевается [[w:ru:Ответ на главный вопрос жизни, вселенной и всего такого|ответ на главный вопрос жизни, вселенной и всего такого]]&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; value = ('ответ', 42)
&gt;&gt;&gt; s = str(value)
&gt;&gt;&gt; f.write(s)
18&lt;/syntaxhighlight&gt;

&lt;code&gt;f.tell()&lt;/code&gt; возвращает целое, представляющее собой текущую позицию в файле &lt;code&gt;f&lt;/code&gt;, измеренную в байтах от начала файла. Чтобы изменить позицию объекта-файла, используйте &lt;code&gt;f.seek(''смещение'', ''откуда'')&lt;/code&gt;. Позиция вычисляется прибавлением смещения к точке отсчёта; точка отсчёта выбирается из параметра &lt;code&gt;''откуда''&lt;/code&gt;. Значение &lt;code&gt;0&lt;/code&gt; параметра &lt;code&gt;''откуда''&lt;/code&gt; отмеряет смещение от начала файла, значение &lt;code&gt;1&lt;/code&gt; применяет текущую позицию в файле, а значение &lt;code&gt;2&lt;/code&gt; в качестве точки отсчёта использует конец файла. Параметр &lt;code&gt;''откуда''&lt;/code&gt; может быть опущен и по умолчанию устанавливается в &lt;code&gt;0&lt;/code&gt;, используя начало файла в качестве точки отсчёта.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f = open('/tmp/workfile', 'rb+')
&gt;&gt;&gt; f.write(b'0123456789abcdef')
16
&gt;&gt;&gt; f.seek(5)     # Перейти к шестому байту в файле
5
&gt;&gt;&gt; f.read(1)        
b'5'
&gt;&gt;&gt; f.seek(-3, 2) # Перейти к третьему байту с конца 
13
&gt;&gt;&gt; f.read(1)
b'd'&lt;/syntaxhighlight&gt;

При работе с текстовыми файлами (открытыми без символа &lt;code&gt;b&lt;/code&gt; в строке режима), выполнять позиционирование (&lt;code&gt;seek&lt;/code&gt;) позволяется только от начала файла (за исключением прокрутки в конец файла с использованием &lt;code&gt;seek(0, 2)&lt;/code&gt;).

Когда вы закончили все действия над файлом, вызовите &lt;code&gt;f.close()&lt;/code&gt; чтобы закрыть его и освободить все системные ресурсы, использованные при открытии этого файла. Все попытки использовать объект-файл после вызова &lt;code&gt;f.close()&lt;/code&gt; приведут к возникновению исключения.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; f.close()
&gt;&gt;&gt; f.read()
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
ValueError: I/O operation on closed file&lt;/syntaxhighlight&gt;

Считается хорошей манерой использовать ключевое слово &lt;code&gt;with&lt;/code&gt; при работе с файловыми объектами. Преимущество этого способа в том, что файл всегда корректно закрывается после выполнения блока, либо если при выполнении было порождено исключение. Кроме того, получающийся код намного короче, чем эквивалентная форма с блоками &lt;tt&gt;&lt;code&gt;try&lt;/code&gt;-&lt;code&gt;finally&lt;/code&gt;&lt;/tt&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; with open('/tmp/workfile', 'r') as f:
...     read_data = f.read()
&gt;&gt;&gt; f.closed
True&lt;/syntaxhighlight&gt;

У объектов-файлов есть ещё несколько дополнительных методов, таких как &lt;code&gt;isatty()&lt;/code&gt; и &lt;code&gt;truncate()&lt;/code&gt;, которые используются не так часто; обратитесь к [[Справочник по библиотеке Python 3.1|Справочнику по библиотеке]] для более полного обзора по файловым объектам.

==== Модуль &lt;code&gt;pickle&lt;/code&gt; ====

Строки могут с лёгкостью быть записаны в файл и прочитаны из файла. В случае чисел нужно применить несколько больше усилий: метод &lt;code&gt;read()&lt;/code&gt; возвращает только строки, которые придётся передать функции вроде &lt;code&gt;int()&lt;/code&gt;, которая принимает строку вида &lt;code&gt;'123'&lt;/code&gt; и возвращает её числовое значение: &lt;code&gt;123&lt;/code&gt;. Однако если вы намереваетесь сохранить более сложные типы данных, такие как списки, словари или экземпляры классов, всё становится несколько запутаннее.

Вместо того чтобы принуждать программиста постоянно писать и отлаживать код для замысловатых типов данных, Python предоставляет стандартный модуль под названием &lt;code&gt;pickle&lt;/code&gt;. Это замечательный модуль, который может принять любой объект Python (даже некоторые формы кода на Python!) и конвертировать его в строковое представление: этот процесс называется ''консервацией'' (&lt;tt&gt;pickling&lt;/tt&gt;). Восстановление объекта из его строкового представления называется ''расконсервацией'' (&lt;tt&gt;unpickling&lt;/tt&gt;): строка, описывающая объект, может быть сохранена в файл, добавлена к некоторым данным, или отослана через соединение по сети на удаленный компьютер.&lt;ref&gt;''(Прим. перев.)'' ''Консервирование'' в Python можно рассматривать как частный случай [[w:ru:Сериализация|сериализации]]; ещё про ''консервирование'' можно почитать [http://www.ibm.com/developerworks/ru/library/l-pypers/index.html здесь].&lt;/ref&gt;

Если у вас есть некоторый объект &lt;code&gt;x&lt;/code&gt; и объект файла &lt;code&gt;f&lt;/code&gt;, открытый на запись в двоичном режиме (binary mode, с параметром 'wb'), простейший способ ''законсервировать'' объект требует одной-единственной строки кода:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;pickle.dump(x, f)&lt;/syntaxhighlight&gt;

Чтобы снова расконсервировать объект, при условии что &lt;code&gt;f&lt;/code&gt; — объект файла, открытого для чтения (так же в двоичном режиме, с параметром 'rb'):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;x = pickle.load(f)&lt;/syntaxhighlight&gt;

(Существуют варианты выполнения этих операций, применяемые при ''расконсервации'' нескольких объектов или когда вам требуется записать ''консервированные'' данные в файл; обратитесь к документации по модулю [[Справочник по библиотеке Python 3.1#pickle|pickle]] из [[Справочник по библиотеке Python 3.1|Справочника по библиотеке]].)

[[Справочник по библиотеке Python 3.1#pickle|pickle]] — стандартный способ для создания объектов Python, которые могут быть повторно использованы другими программами или будущими версиями этой же программы; для них есть технический термин — ''устойчивый объект'' (&lt;tt&gt;persistent object&lt;/tt&gt;). Поскольку [[Справочник по библиотеке Python 3.1#pickle|pickle]] используется часто, многие авторы расширений для Python заботятся о том, чтобы новые типы данных, такие как матрицы, могли быть корректно ''законсервированы'' и ''расконсервированы''.

== Ошибки и исключения ==

До этого момента сообщения об ошибках лишь упоминались, но если вы пробовали примеры на практике — возможно, вы уже видели некоторые. Существует (как минимум) два различимых вида ошибок: ''синтаксические ошибки'' (&lt;tt&gt;syntax errors&lt;/tt&gt;) и ''исключения'' (&lt;tt&gt;exceptions&lt;/tt&gt;).

=== Синтаксические ошибки ===

Синтаксические ошибки, также известные как ошибки разбора кода (''парсинга'', &lt;tt&gt;parsing&lt;/tt&gt;) — вероятно, наиболее привычный вид жалоб компилятора, попадающихся вам при изучении Python:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; while True print('Hello world')
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
    while True print('Hello world')
                   ^
SyntaxError: invalid syntax&lt;/syntaxhighlight&gt;

Парсер&lt;ref&gt;''(Прим. перев.)'' ''Parser'' {{ref-en}} — программа синтаксического анализа, синтаксический анализатор; программа грамматического разбора&lt;/ref&gt; повторно выводит ошибочную строку и отображает небольшую «стрелку», указывающую на самую первую позицию в строке, где была обнаружена ошибка. Причина ошибки (или по крайней мере место обнаружения) находится в символе&lt;ref&gt;''(Прим. перев.)'' ''Token'' {{ref-en}} — некоторая смысловая единица выражения: оператор, ключевое слово, значение переменной, …&lt;/ref&gt;, предшествующем указанному: в приведённом примере ошибка обнаружена на месте вызова функции &lt;code&gt;print()&lt;/code&gt;, поскольку перед ним пропущено двоеточие (&lt;code&gt;':'&lt;/code&gt;). Также здесь выводятся имя файла и номер строки, благодаря этому вы знаете в каком месте искать, если ввод был сделан из сценария.

=== Исключения ===

Даже если выражение или оператор синтаксически верны, они могут вызвать ошибку при попытке их исполнения. Ошибки, обнаруженные при исполнении, называются ''исключениями'' (&lt;tt&gt;exceptions&lt;/tt&gt;). Они не фатальны: позже вы научитесь перехватывать их в программах на Python. Большинство исключений, правда, как правило, не обрабатываются программами и приводят к сообщениям об ошибке, таким как следующие:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 10 * (1/0)
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
ZeroDivisionError: int division or modulo by zero
&gt;&gt;&gt; 4 + spam*3
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
NameError: name 'spam' is not defined
&gt;&gt;&gt; '2' + 2
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
TypeError: coercing to Unicode: need string or buffer, int found&lt;/syntaxhighlight&gt;

Последняя строка сообщения об ошибке описывает произошедшее. Исключения представлены различными типами и тип исключения выводится в качестве части сообщения: в примере это типы &lt;code&gt;ZeroDivisionError&lt;/code&gt;, &lt;code&gt;NameError&lt;/code&gt; и &lt;code&gt;TypeError&lt;/code&gt;. Часть строки, описывающая тип исключения — это имя произошедшего встроенного исключения. Такое утверждение верно для всех встроенных исключений, но не обязано быть истинным для исключений, определённых пользователем (однако, само соглашение — довольно полезное). Имена стандартных исключений — это встроенные идентификаторы (не ключевые слова).

Оставшаяся часть строки описывает детали произошедшего на основе типа исключения, которое было его причиной.

Предшествующая часть сообщения об ошибке показывает контекст, где произошло исключение, в форме стека вызовов. В общем случае она содержит стек, состоящий из списка строк исходного кода; тем не менее, в неё не войдут строки, прочитанные из стандартного ввода.

В разделе [[Справочник по библиотеке Python 3.1#Встроенные исключения|Встроенные исключения]] [[Справочник по библиотеке Python 3.1|Справочника по библиотеке]] вы найдёте список встроенных исключений и их значений.

=== Обработка исключений ===

Существует возможность написать код, который будет перехватывать избранные исключения. Посмотрите на представленный пример, в котором пользователю предлагают вводить число до тех пор, пока оно не окажется корректным целым. Тем не менее, пользователь может прервать программу (используя сочетание клавиш &lt;tt&gt;Control-C&lt;/tt&gt; или какое-либо другое, поддерживаемое операционной системой); заметьте — о вызванном пользователем прерывании сигнализирует исключение &lt;code&gt;KeyboardInterrupt&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; while True:
...     try:
...         x = int(input(&quot;Введите, пожалуйста, число: &quot;))
...         break
...     except ValueError:
...         print(&quot;Ой!  Это некорректное число.  Попробуйте ещё раз...&quot;)
...&lt;/syntaxhighlight&gt;

Оператор &lt;code&gt;try&lt;/code&gt; работает следующим образом:

* В начале исполняется ''блок &lt;code&gt;try&lt;/code&gt;'' (операторы между ключевыми словами &lt;code&gt;try&lt;/code&gt; и &lt;code&gt;except&lt;/code&gt;).

* Если при этом не появляется исключений, ''блок &lt;code&gt;except&lt;/code&gt;'' не выполняется и оператор &lt;code&gt;try&lt;/code&gt; заканчивает работу.

* Если во время выполнения блока &lt;code&gt;try&lt;/code&gt; было возбуждено какое-либо исключение, оставшаяся часть блока не выполняется. Затем, если тип этого исключения совпадает с исключением, указанным после ключевого слова &lt;code&gt;except&lt;/code&gt;, выполняется блок &lt;code&gt;except&lt;/code&gt;, а по его завершению выполнение продолжается сразу после оператора &lt;code&gt;try-except&lt;/code&gt;.

* Если порождается исключение, не совпадающее по типу с указанным в блоке &lt;code&gt;except&lt;/code&gt; — оно передаётся внешним операторам &lt;code&gt;try&lt;/code&gt;; если ни одного обработчика не найдено, исключение считается ''необработанным'' (&lt;tt&gt;unhandled exception&lt;/tt&gt;), и выполнение полностью останавливается и выводится сообщение, схожее с показанным выше.

Оператор &lt;code&gt;try&lt;/code&gt; может иметь более одного блока &lt;code&gt;except&lt;/code&gt; — для описания обработчиков различных исключений. При этом будет выполнен максимум один обработчик. Обработчики ловят только те исключения, которые возникают внутри соответствующего блока &lt;code&gt;try&lt;/code&gt;, но не те, которые возникают в других обработчиках этого же самого оператора &lt;code&gt;try-except&lt;/code&gt;. Блок &lt;code&gt;except&lt;/code&gt; может указывать несколько исключений в виде заключённого в скобки кортежа, например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;... except (RuntimeError, TypeError, NameError):
...     pass&lt;/syntaxhighlight&gt;

В последнем блоке &lt;code&gt;except&lt;/code&gt; можно не указывать имени (или имён) исключений. Тогда он будет действовать как обработчик группы исключений. Используйте эту возможность с особой осторожностью, поскольку таким образом он может с лёгкостью перехватить и фактическую ошибку программиста! Также такой обработчик может быть использован для вывода сообщения об ошибке и порождения исключения заново (позволяя при этом обработать исключение коду, вызвавшему обработчик):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import sys

try:
    f = open('myfile.txt')
    s = f.readline()
    i = int(s.strip())
except IOError as err:
    print(&quot;I/O error: {0}&quot;.format(err))
except ValueError:
    print(&quot;Не могу преобразовать данные в целое.&quot;)
except:
    print(&quot;Неожиданная ошибка:&quot;, sys.exc_info()[0])
    raise&lt;/syntaxhighlight&gt;

У оператора &lt;code&gt;try-except&lt;/code&gt; есть необязательный ''блок &lt;code&gt;else&lt;/code&gt;'', который, если присутствует, должен размещаться после всех блоков &lt;code&gt;except&lt;/code&gt;. Его полезно использовать при наличии кода, который должен быть выполнен, если блок &lt;code&gt;try&lt;/code&gt; не породил исключений. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;for arg in sys.argv[1:]:
    try:
        f = open(arg, 'r')
    except IOError:
        print('не могу открыть', arg)
    else:
        print(arg, 'содержит', len(f.readlines()), 'строк')
        f.close()&lt;/syntaxhighlight&gt;

Использование блока &lt;code&gt;else&lt;/code&gt; предпочтительнее, чем добавление дополнительного кода к блоку &lt;code&gt;try&lt;/code&gt;, поскольку исключает неожиданный перехват исключения, которое появилось не по причине выполнения кода, защищенного оператором &lt;code&gt;try-except&lt;/code&gt;.

При появлении исключения, оно может иметь ассоциированное значение, также известное как ''аргумент'' (&lt;tt&gt;argument&lt;/tt&gt;) исключения. Присутствие и тип аргумента зависят от типа самого исключения.

В блоке &lt;code&gt;except&lt;/code&gt; можно указать переменную, следующую за именем исключения. Переменная связывается с экземпляром исключения, аргументы которого хранятся в &lt;code&gt;instance.args&lt;/code&gt;. Для удобства, экземпляр исключения определяет метод &lt;code&gt;__str__()&lt;/code&gt;, так что вывод аргументов может быть произведён явно, без необходимости отсылки к &lt;code&gt;.args&lt;/code&gt;. Таким образом, вы также можете создать/взять экземпляр исключения перед его порождением и добавить к нему атрибуты по желанию.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; try:
...    raise Exception('spam', 'eggs')
... except Exception as inst:
...    print(type(inst))     # экземпляр исключения
...    print(inst.args)      # аргументы хранятся в .args
...    print(inst)           # __str__ позволяет вывести args явно,
...                          # но может быть переопределён в подклассах исключения
...    x, y = inst           # распаковка args
...    print 'x =', x
...    print 'y =', y
...
&lt;class 'Exception'&gt;
('spam', 'eggs')
('spam', 'eggs')
x = spam
y = eggs&lt;/syntaxhighlight&gt;

Если у исключения есть аргументы, они выводится в качестве последней («детальной») части сообщения о необработанном исключении.

Обработчики исключений перехватывают не только исключения, появившиеся прямо в блоке &lt;code&gt;try&lt;/code&gt;, но также и возбужденные внутри функций, которые были в блоке &lt;code&gt;try&lt;/code&gt; вызваны (даже неявно). Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def this_fails():
...     x = 1/0
... 
&gt;&gt;&gt; try:
...     this_fails()
... except ZeroDivisionError as err:
...     print('Перехват ошибки времени исполнения:', err)
... 
Перехват ошибки времени исполнения: integer division or modulo by zero&lt;/syntaxhighlight&gt;

=== Порождение исключений ===

Оператор &lt;code&gt;raise&lt;/code&gt; позволяет программисту принудительно породить исключение. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; raise NameError('ПриветТам')
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
NameError: ПриветТам&lt;/syntaxhighlight&gt;

Единственный аргумент оператора &lt;code&gt;raise&lt;/code&gt; определяет исключение, которое нужно возбудить. Им может быть либо экземпляр исключения, либо класс исключения (класс, дочерний к классу &lt;code&gt;Exception&lt;/code&gt;).

Если вам нужно определить, было ли возбуждено исключение, не перехватывая его — упрощённая форма оператора &lt;code&gt;raise&lt;/code&gt; позволит возбудить исключение заново:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; try:
...     raise NameError('ПриветТам')
... except NameError:
...     print('Исключение пролетело мимо!')
...     raise
...
Исключение пролетело мимо!
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 2, in ?
NameError: ПриветТам&lt;/syntaxhighlight&gt;

=== Исключения, определённые пользователем ===

В программах можно определять свои собственные исключения — посредством создания нового класса исключения. В общем случае, исключения должны быть унаследованы от класса &lt;code&gt;Exception&lt;/code&gt;: явно или неявно. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; class MyError(Exception):
...     def __init__(self, value):
...         self.value = value
...     def __str__(self):
...         return repr(self.value)
... 
&gt;&gt;&gt; try:
...     raise MyError(2*2)
... except MyError as e:
...     print('Поймано моё исключение со значением:', e.value)
... 
Поймано моё исключение со значением: 4
&gt;&gt;&gt; raise MyError('ой!')
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
__main__.MyError: 'ой!'&lt;/syntaxhighlight&gt;

В этом примере был перегружен конструктор по умолчанию &lt;code&gt;__init__()&lt;/code&gt; класса &lt;code&gt;Exception&lt;/code&gt;. Новое поведение отличается лишь созданием нового атрибута &lt;code&gt;value&lt;/code&gt; и заменяет поведение по умолчанию, при котором создаётся атрибут &lt;code&gt;args&lt;/code&gt;.

Классы исключений могут определять любые действия, которые могут делать все другие классы. Однако, обычно их внутренняя структура довольно проста, и предоставляет лишь некоторые атрибуты, позволяющие обработчикам исключений выяснить информацию об ошибке подробно. При создании модуля, который может породить различные ошибки, обычной практикой будет создание базового класса для исключений, определённых в этом модуле, и подклассов для различных ошибочных состояний:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class Error(Exception):
    &quot;&quot;&quot;Базовый класс для всех исключений в этом модуле.&quot;&quot;&quot;
    pass

class InputError(Error):
    &quot;&quot;&quot;Исключение порождается при ошибках при вводе.

    Атрибуты:
        expression -- выражение на вводе, в котором обнаружена ошибка
        message -- описание ошибки
    &quot;&quot;&quot;

    def __init__(self, expression, message):
        self.expression = expression
        self.message = message

class TransitionError(Error):
    &quot;&quot;&quot;Порождается, когда операция пытается выполнить неразрешённый переход
    из одного состояния в другое.

    Attributes:
        previous -- состояние в начале перехода
        next -- новое состояние, попытка принять которое была принята 
        message -- описание, по какой причине такой переход невозможен
    &quot;&quot;&quot;

    def __init__(self, previous, next, message):
        self.previous = previous
        self.next = next
        self.message = message&lt;/syntaxhighlight&gt;

Большинство исключений имеет имя, заканчивающееся на «&lt;code&gt;Error&lt;/code&gt;», подобно стандартным исключениям.

Много стандартных модулей определяют собственные исключения, сообщающие об ошибках, которые могут появиться в определяющих их модулях. Больше информации о классах представлено в главе 1.10, [[Учебник Python 3.1#Классы|Классы]]

=== Определение действий при подчистке ===

У оператора &lt;code&gt;try&lt;/code&gt; есть другой необязательный блок, предназначенный для операций подчистки, которые нужно выполнить независимо от условий:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; try:
...     raise KeyboardInterrupt
... finally:
...     print('Прощай, мир!')
... 
Прощай, мир!
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 2, in ?
KeyboardInterrupt&lt;/syntaxhighlight&gt;

''Блок &lt;code&gt;finally&lt;/code&gt;'' исполняется всегда, когда интерпретатор покидает оператор &lt;code&gt;try&lt;/code&gt;, независимо — были исключения или нет. Если в блоке &lt;code&gt;try&lt;/code&gt; появилось исключение, которое не было обработано в блоке &lt;code&gt;except&lt;/code&gt; (или появилось в самих блоках &lt;code&gt;except&lt;/code&gt; или &lt;code&gt;else&lt;/code&gt;) — оно порождается заново после выполнения блока &lt;code&gt;finally&lt;/code&gt;. Также блок &lt;code&gt;finally&lt;/code&gt; исполняется «по пути наружу», если какой-либо другой блок оператора &lt;code&gt;try&lt;/code&gt; был покинут за счёт одного из операторов: &lt;code&gt;break&lt;/code&gt;, &lt;code&gt;continue&lt;/code&gt; или &lt;code&gt;return&lt;/code&gt;. Более сложный пример:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; def divide(x, y):
...     try:
...         result = x / y
...     except ZeroDivisionError:
...         print(&quot;деление на ноль!&quot;)
...     else:
...         print(&quot;результат: &quot;, result)
...     finally:
...         print(&quot;выполнение блока finally&quot;)
...
&gt;&gt;&gt; divide(2, 1)
результат:  2
выполнение блока finally
&gt;&gt;&gt; divide(2, 0)
деление на ноль!
выполнение блока finally
&gt;&gt;&gt; divide(&quot;2&quot;, &quot;1&quot;)
выполнение блока finally
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
  File &quot;&lt;stdin&gt;&quot;, line 3, in divide
TypeError: unsupported operand type(s) for /: 'str' and 'str'&lt;/syntaxhighlight&gt;

Как видите, блок &lt;code&gt;finally&lt;/code&gt; выполняется при любом событии. Ошибка &lt;code&gt;TypeError&lt;/code&gt; порождается при делении двух строк и не перехватывается блоком &lt;code&gt;except&lt;/code&gt;, и поэтому порождается заново сразу после выполнения блока &lt;code&gt;finally&lt;/code&gt;.

В приложениях реального мира, блок &lt;code&gt;finally&lt;/code&gt; применяется для освобождения внешних ресурсов (таких как файлы или сетевые соединения), независимо от того, было ли их использование удачным.

=== Предопределённые действия по подчистке ===

Некоторые объекты определяют стандартные действия при подчистке, применяемые если объект больше не нужен, независимо от того, удачна была операция использования объекта или нет. Посмотрите на следующий пример, в которым мы пытаемся открыть файл и вывести его содержимое на экран.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;for line in open(&quot;myfile.txt&quot;):
    print(line)&lt;/syntaxhighlight&gt;

Проблема этого кода в том, что он оставляет файл открытым на неопределённое количество времени после выполнения данной части кода. В простых сценариях это не является проблемой, но может стать ей в больших приложениях. Оператор &lt;code&gt;with&lt;/code&gt; позволяет использовать объекты (такие как, например, файлы) таким образом, чтобы вы всегда могли быть уверены в том, что ресурсы будут сразу и корректно очищены.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;with open(&quot;myfile.txt&quot;) as f:
    for line in f:
        print(line)&lt;/syntaxhighlight&gt;

После выполнения оператора, файл ''&lt;code&gt;f&lt;/code&gt;'' всегда закрывается, даже если при прочтении строк обнаружилась проблема. В документации к объектам, которые поддерживают предопределённые действия по подчистке, таким как файлы, эта их способность будет явно указана.

== Классы ==

За счёт механизма классов Python в язык с минимальным использованием нового синтаксиса и семантики добавляется возможность создания классов. Это смесь классовых механизмов, заимствованных из C++ и Modula-3. Как и в случае модулей, классы в Python не устанавливают абсолютного барьера между определением и программистом, рассчитывая больше на аккуратность и вежливость последнего — чтобы он не «врывался в определения». Наиболее важные возможности классов, тем не менее, содержат в себе всю возможную мощь: механизм наследования классов поддерживает несколько предков для класса, производный класс может переопределять любые методы своего предка или предков, а любой его метод может вызвать метод предка с таким же именем. Объекты могут содержать произвольное количество закрытых (&lt;tt&gt;private&lt;/tt&gt;) данных.

В терминологии C++, члены класса (включая данные-члены), обычно, открыты (&lt;tt&gt;public&lt;/tt&gt;) (исключая [[Учебник Python 3.1#Приватные переменные|Приватные переменные]], описанные ниже), а все функции-члены — виртуальны. Нет специальных конструкторов и деструкторов. Как в Modula-3, нет краткой ссылки на члены объекта из его методов: функция-метод определяется с явным первым аргументом, описывающим объект, который неявно передаётся при вызове. Как в Smalltalk, классы сами по себе являются объектами, хотя и в более широком смысле: в Python все типы данных — объекты. Таким образом обеспечивается семантика для импортирования и переименования. В отличие от C++ и Modula-3 встроенные типы могут использоваться в качестве предков для расширения возможностей пользователем. Кроме того, как в C++, но не как в Modula-3, большинство встроенных операторов со специальным синтаксисом (арифметические операторы, индексирование и т. д.) могут быть переопределены для экземпляров классов.

=== Пара слов о терминологии ===

Обходя стороной поддерживаемую всем миром терминологию, применимую к разговорам о классах, в нашем случае я буду говорить в терминах C++ и Smalltalk. (Предпочёл бы использовать термины языка Modula-3, поскольку Python ближе к ней по объектно-ориентированной семантике, чем к C++, но предполагаю, что немногие читатели слышали о нём.)

Объекты обладают индивидуальностью, и с одним объектом может быть связано несколько имён (в нескольких областях видимости). Такая практика в других языках известна как ''совмещение имён'' (&lt;tt&gt;aliasing&lt;/tt&gt;). На первый взгляд, совмещение малозаметно в Python, и его можно без последствий игнорировать при работе с основными неизменяемыми типами (числами, строками, кортежами). Тем не менее, совмещение имён влияет на семантику программного кода Python, работающего с изменяемыми объектами: списками, словарями и большинством типов, описывающих сущности вне программы (файлы, окна и т. п.). Обычно такая практика считается полезной, поскольку псевдонимы работают подобно указателям и вероятно даже превосходят их возможности. Например, передача объекта — дешевая операция, поскольку по реализации передаётся только указатель. Если функция изменяет переданный в качестве аргумента объект, это будет заметно и в месте вызова. За счёт этого пропадает необходимость в двух различных механизмах передачи аргументов.

=== Области видимости и пространства имён в Python ===

Прежде чем заняться классами необходимо получить представление о правилах областей видимости в Python. Определения классов проделывают над пространствами имён некоторые ловкие трюки. Чтобы полностью понимать происходящее, нужно знать о принципах работы областей видимости и пространств имён. Эти знания не помешают любому профессиональному программисту на Python.

Давайте начнём с нескольких определений.

''Пространство имён'' (&lt;tt&gt;namespace&lt;/tt&gt;) — это набор связей имён с объектами&lt;ref&gt;''(Прим. перев.) A namespace is a mapping from names to objects {{ref-en}} — ''(букв.)'' пространство имён суть отображение имён на объекты''&lt;/ref&gt;. В настоящий момент большинство пространств имён реализованы в виде словарей Python, но не стоит заострять на этом внимание (если только по поводу производительности): возможно, в будущем реализация изменится. Примеры пространств имён: набор встроенных имён (функции вроде &lt;code&gt;abs()&lt;/code&gt; и имён встроенных исключений); глобальные имена в модуле; локальные имена при вызове функции. Важная вещь, которую необходимо знать о пространствах имён — это то, что нет абсолютно никакой связи между именами в разных пространствах имён: например, два разных модуля могут без проблем определять функцию «&lt;code&gt;maximize&lt;/code&gt;», так как пользователи модулей будут использовать имена модулей в качестве префиксов.

Кстати, слово ''атрибут'' (&lt;tt&gt;attribute&lt;/tt&gt;) я применяю к любому имени, следующему за точкой. Например, в выражении &lt;code&gt;z.real&lt;/code&gt;, &lt;code&gt;real&lt;/code&gt; — это атрибут объекта &lt;code&gt;z&lt;/code&gt;. Строго говоря, ссылки на имена в модуле являются ссылками на атрибуты: в выражении &lt;code&gt;''имя_модуля''.''имя_функции''&lt;/code&gt; под ''имя_модуля'' скрывается объект модуля, а под ''имя_функции'' — его атрибут. В таком случае обнаруживается прямая связь между атрибутами модуля и глобальными именами, определёнными в модуле: они разделяют между собой одно и тоже пространство имён&lt;ref&gt;Исключая одну тонкость. У объектов модулей есть скрытый, только для чтения, атрибут под именем &lt;code&gt;__dict__&lt;/code&gt;, возвращающий словарь, использовавшийся для формирования пространства имён модуля; имя &lt;code&gt;__dict__&lt;/code&gt; является атрибутом, но не глобальным именем. Очевидно, что всё это нарушает абстракцию реализации пространства имён и его использование следует ограничить вещами вроде посмертных отладчиков&lt;/ref&gt;.

Запись в атрибуты может быть запрещена (''атрибут только для чтения'', &lt;tt&gt;read-only attribute&lt;/tt&gt;) или разрешена (''перезаписываемый атрибут'', &lt;tt&gt;writable attribute&lt;/tt&gt;). В последнем случае присваивание атрибуту является возможным. Атрибуты модуля перезаписываемы: вы можете написать «&lt;code&gt;modname.the_answer = 42&lt;/code&gt;»&lt;ref&gt;''(Прим. перев.)'' Снова [[w:ru:Ответ на главный вопрос жизни, вселенной и всего такого|ответ на главный вопрос жизни, вселенной и всего такого]]&lt;/ref&gt;. Перезаписываемые атрибуты могут также быть удалены оператором &lt;code&gt;del&lt;/code&gt;. Например, код «&lt;code&gt;del modname.the_answer&lt;/code&gt;» удалит атрибут &lt;code&gt;the_answer&lt;/code&gt; из объекта с именем &lt;code&gt;modname&lt;/code&gt;.

Пространства имён создаются в различные моменты и имеют разное время жизни. Пространство имён, содержащее встроенные имена создаётся при запуске интерпретатора и не удаляется никогда. Глобальное пространство имён модуля создаётся при вычитке определения модуля. Обычно, пространства имён модулей также «живут» до выхода из интерпретатора. Выражения, выполняемые верхне-уровневым порождением интерпретатора, прочитанные из файла сценария или интерактивно, рассматриваются как часть модуля под названием &lt;code&gt;__main__&lt;/code&gt;, поэтому у них есть своё собственное глобальное пространство имён. (Встроенные имена по факту также живут в модуле, он называется &lt;code&gt;builtins&lt;/code&gt;).

Локальное пространство имён функции создаётся при её вызове и удаляется когда функция возвращает значение либо порождает исключение, внутри неё не перехваченное. (На самом деле, лучшим способом объяснить, что происходит на самом деле, было бы «забывание»). Конечно же, рекурсивные порождения имеют свои пространства имён каждое.

''Область видимости'' (&lt;tt&gt;scope&lt;/tt&gt;) — это текстовая область в программе на Python, из которой прямым образом доступно пространство имён. «Прямым образом доступно» подразумевает, что явная ссылка на имя вынуждает интерпретатор искать это имя в пространстве имён.

Несмотря на то, что области видимости определяются статически, используются они динамически. В любой момент во время выполнения существует как минимум три вложенных области видимости, чьи пространства имён доступны прямым образом: самая внутренняя&lt;ref&gt;''(Прим. перев.)'' ''Innermost scope'', ''outermost scope'' {{ref-en}} — самая внутренняя и самая внешняя области видимости&lt;/ref&gt; область видимости (по ней поиск осуществляется в первую очередь) содержит локальные имена; пространства имён всех объемлющих [данный код] функций, поиск по которым начинается с ближайшей объемлющей [код] области видимости; область видимости среднего уровня, по ней следующей проходит поиск и она содержит глобальные имена текущего модуля; и самая внешняя область видимости (заключительный поиск) — это пространство имён, содержащее встроенные имена.

Если имя определено глобально, тогда все ссылки и присваивания уходят прямо в область видимости среднего уровня, содержащую глобальные имена модуля. Чтобы сменить привязку у всех переменных, найденных вне самой внутренней области видимости, можно использовать оператор &lt;code&gt;nonlocal&lt;/code&gt;; если такая переменная не объявлена как &lt;code&gt;nonlocal&lt;/code&gt;, то она используется только для чтения (попытка записать значение в такую переменную создаст новую локальную переменную в самой внутренней области видимости, оставляя идентично названную вовне переменную без изменений).

Обычно локальная область видимости ссылается на локальные имена текущей (на уровне текста) функции. Вне функций локальная область видимости ссылается на то же пространство имён, что и глобальная область видимости: пространство имён модуля. Определения классов помещают в локальную область видимости ещё одно пространство имён.

Важно осознавать, что области видимости ограничиваются на текстовом уровне: глобальная область видимости функции, определённая в модуле, является пространством имён этого модуля, независимо от того, откуда или по какому псевдониму была эта функция вызвана. С другой стороны, фактический поиск имён осуществляется динамически, во время выполнения. Как бы то ни было, язык развивается в сторону статического разрешения имён (во время компиляции), так что не стоит полагаться на динамическое разрешение имён. (Фактически, локальные переменные уже определены статично.)

Особая хитрость в Python состоит в том, что — при условии, что в данной области не включены операторы &lt;code&gt;global&lt;/code&gt; или &lt;code&gt;nonlocal&lt;/code&gt; — присваивания именам всегда уходят в самую внутреннюю область видимости. Присваивания не копируют данных, а лишь связывают имена с объектами. Тоже самое верно и для удалений: оператор «&lt;code&gt;del x&lt;/code&gt;» удаляет связь &lt;code&gt;x&lt;/code&gt; из пространства имён, на которое ссылается локальная область видимости. В действительности, все операции, вводящие новые имена, используют локальную область видимости: в частности, операторы импорта и описаний функций связывают имя модуля или функции в локальной области видимости соответственно. (Для того, чтобы указать определённой переменной, что она должна быть расположена в глобальной области видимости, может использоваться оператор &lt;code&gt;global&lt;/code&gt;.)

Оператор &lt;code&gt;global&lt;/code&gt; можно использовать для того, чтобы объявить определённые переменные как привязанные к глобальной области видимости и указывает, что их переназначения должны происходить в ней; оператор &lt;code&gt;nonlocal&lt;/code&gt; помечает переменные как привязанные к окружающей их области видимости и указывает, что их переназначения должны происходить в ней.

=== Пример по областям видимости и пространствам имён ===

Приведём пример, показывающий, каким образом можно ссылаться на разные области видимости и пространства имён и как &lt;code&gt;global&lt;/code&gt; и &lt;code&gt;nonlocal&lt;/code&gt; влияют на привязку переменной.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def scope_test():
    def do_local():
        spam = &quot;локальный спам&quot;
    def do_nonlocal():
        nonlocal spam
        spam = &quot;нелокальный спам&quot;
    def do_global():
        global spam
        spam = &quot;глобальный спам&quot;

    spam = &quot;тестовый спам&quot;
    do_local()
    print(&quot;После локального присваивания:&quot;, spam)
    do_nonlocal()
    print(&quot;После нелокального присваивания:&quot;, spam)
    do_global()
    print(&quot;После глобального присваивания:&quot;, spam)

scope_test()
print(&quot;В глобальной области видимости:&quot;, spam)&lt;/syntaxhighlight&gt;

Вывод кода из примера таков:

&lt;syntaxhighlight lang=&quot;text&quot;&gt;После локального присваивания: тестовый спам
После нелокального присваивания: нелокальный спам
После глобального присваивания: нелокальный спам
В глобальной области видимости: глобальный спам&lt;/syntaxhighlight&gt;

Заметьте, что локальное присваивание (работающее по умолчанию) не заменяет глобальную привязку на связывание из &lt;code&gt;scope_test&lt;/code&gt;. Нелокальное присваивание заменило глобальную привязку на связывание из &lt;code&gt;scope_test&lt;/code&gt;, а глобальное присваивание заменило привязку на связывание на уровне модуля.

Можно увидеть, что до глобального присваивания у переменной &lt;code&gt;spam&lt;/code&gt; не было предшествующих связываний.

=== Первый взгляд на классы ===

В описании классов представлено немного нового синтаксиса, три новых типа объектов&lt;ref&gt;''(Прим. перев.)'' ''Class Objects'', ''Instance Objects'', ''Method Objects'' {{ref-en}} — объекты классов, объекты экземпляров, объекты методов; по тексту перевода, хоть и могут восприниматься непривычно, используются термины «объекты-классы», «объекты-экземпляры» и «объекты-методы» — ввиду того, что словосочетание «объект класса» может обозначать и принадлежность объекта классу&lt;/ref&gt; и некоторое количество новой семантики.

==== Синтаксис определения класса ====

Простейшая форма определения класса выглядит так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class ИмяКласса:
    &lt;оператор-1&gt;
    .
    .
    .
    &lt;оператор-N&gt;
&lt;/syntaxhighlight&gt;

Определения классов, как и определения функций (операторы &lt;code&gt;def&lt;/code&gt;), должны быть исполнены для того, чтобы определить действие. (Вы можете, предположим, поместить определение класса в ветку оператора &lt;code&gt;if&lt;/code&gt; или внутрь функции.)

На практике, внутри определения класса обычно помещаются определения функций, но позволено использовать и другие операторы — и иногда с пользой — как мы увидим позже. Определения функций внутри класса имеют особенную форму списка аргументов, в связи с соглашениями по вызову методов — опять же, это будет рассмотрено ниже.

При вводе определения класса создаётся новое пространство имён, которое и используется в качестве локальной области видимости. Таким образом, все присваивания локальным переменным происходят в этом новом пространстве имён. В частности, определения функций связываются здесь с именами новых функций.

При успешном окончании парсинга определения класса (по достижении конца определения), создаётся ''объект-класс'' (&lt;tt&gt;class object&lt;/tt&gt;). По существу, это обёртка вокруг содержимого пространства имён, созданного во время определения класса; подробнее объекты классов мы изучим в следующем разделе. Оригинальная локальная область видимости (та, которая действовала в последний момент перед вводом определения класса) восстанавливается, а объект-класс тут же связывается в ней с именем класса, указанном в заголовке определения класса (в примере — ''&lt;code&gt;ИмяКласса&lt;/code&gt;'').

==== Объекты-классы ====

Объекты-классы поддерживают два вида операций: ссылки на атрибуты и создание экземпляра.

''Ссылки на атрибуты'' (&lt;tt&gt;Attribute references&lt;/tt&gt;) используют стандартный синтаксис, использующийся для всех ссылок на атрибуты в Python: &lt;code&gt;''объект''.''имя''&lt;/code&gt;. Корректными именами атрибутов являются все имена, которые находились в пространстве имён класса при создании объекта-класса. Таким образом, если определение класса выглядело так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class MyClass:
    &quot;&quot;&quot;Простой пример класса&quot;&quot;&quot;
    i = 12345
    def f(self):
        return 'привет мир'&lt;/syntaxhighlight&gt;

то &lt;code&gt;MyClass.i&lt;/code&gt; и &lt;code&gt;MyClass.f&lt;/code&gt; являются корректными ссылками на атрибуты, возвращающими целое и ''объект-функцию'' (&lt;tt&gt;function object&lt;/tt&gt;) соответственно. Атрибутам класса можно присваивать значение, так что вы можете изменить значение &lt;code&gt;MyClass.i&lt;/code&gt; через присваивание. &lt;code&gt;__doc__&lt;/code&gt; также является корректным атрибутом, возвращающим строку документации, принадлежащей классу: &lt;code&gt;&quot;Простой пример класса&quot;&lt;/code&gt;.

Создание экземпляра класса использует синтаксис вызова функции. Просто представьте, что объект-класс — это непараметризированная функция, которая возвращает новый экземпляр класса. Например (предполагая класс, приведённый выше):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;x = MyClass()&lt;/syntaxhighlight&gt;

создаёт новый экземпляр класса и присваивает этот объект локальной переменной &lt;code&gt;x&lt;/code&gt;.

Операция ''создания экземпляра'' (&lt;tt&gt;instantiation&lt;/tt&gt;) создаёт объект данного класса. Большая часть классов предпочитает создавать экземпляры, имеющие определённое начальное состояние. Для этого класс может определять специальный метод под именем &lt;code&gt;__init__()&lt;/code&gt;, например так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def __init__(self):
    self.data = []&lt;/syntaxhighlight&gt;

Когда в классе определён метод &lt;code&gt;__init__()&lt;/code&gt;, при создании экземпляра автоматически вызывается &lt;code&gt;__init__()&lt;/code&gt; нового, только что созданного объекта. Так, в этом примере, новый инициализированный экземпляр может быть получен за счёт выполнения кода:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;x = MyClass()&lt;/syntaxhighlight&gt;

Конечно же, для большей гибкости, метод &lt;code&gt;__init__()&lt;/code&gt; может иметь параметры. В этом случае аргументы, переданные оператору создания экземпляра класса, передаются методу &lt;code&gt;__init__()&lt;/code&gt;. Например,

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; class Complex:
...     def __init__(self, realpart, imagpart):
...         self.r = realpart
...         self.i = imagpart
...
&gt;&gt;&gt; x = Complex(3.0, -4.5)
&gt;&gt;&gt; x.r, x.i
(3.0, -4.5)&lt;/syntaxhighlight&gt;

==== Объекты-экземпляры ====

Теперь, что же мы можем делать с объектами-экземплярами? Единственные операции, доступные объектам-экземплярам — это ссылки на атрибуты. Есть два типа корректных имён атрибутов — это атрибуты-данные и методы.

''Атрибуты-данные'' (&lt;tt&gt;data attributes&lt;/tt&gt;) аналогичны «переменным экземпляров» в Smalltalk и «членам-данным» в C++. Атрибуты-данные не нужно описывать: как и переменные, они начинают существование в момент первого присваивания. Например, если &lt;code&gt;x&lt;/code&gt; — экземпляр созданного выше &lt;code&gt;MyClass&lt;/code&gt;, следующий отрывок кода выведет значение &lt;code&gt;16&lt;/code&gt;, не вызвав ошибок:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;x.counter = 1
while x.counter &lt; 10:
    x.counter = x.counter * 2
print(x.counter)
del x.counter&lt;/syntaxhighlight&gt;

Другой тип ссылок на атрибуты экземпляра — это ''метод'' (&lt;tt&gt;method&lt;/tt&gt;). Метод — это функция, «принадлежащая» объекту. (В Python термин не уникален для экземпляров класса: другие объекты также могут иметь методы. Например, объекты-списки имеют методы &lt;code&gt;append&lt;/code&gt;, &lt;code&gt;insert&lt;/code&gt;, &lt;code&gt;remove&lt;/code&gt;, &lt;code&gt;sort&lt;/code&gt; и т. п. Тем не менее, ниже под термином «метод» мы будем понимать только методы объектов-экземпляров классов, пока отдельно не будет указано иное.)

Корректные имена методов объектов-экземпляров зависят от их класса. По определению, все атрибуты класса, являющиеся объектами-функциями, описывают соответствующие методы его экземпляров. Так, в нашем примере, &lt;code&gt;x.f&lt;/code&gt; является корректной ссылкой на метод, а &lt;code&gt;x.i&lt;/code&gt; ей не является, поскольку не является и &lt;code&gt;MyClass.i&lt;/code&gt;. Но при этом &lt;code&gt;x.f&lt;/code&gt; — это не то же самое, что &lt;code&gt;MyClass.f&lt;/code&gt;: это объект-метод, а не объект-функция.

==== Объекты-методы ====

Обычно, метод вызывают сразу после его связывания [с функцией]:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;x.f()&lt;/syntaxhighlight&gt;

На примере &lt;code&gt;MyClass&lt;/code&gt; такой код возвратит строку &lt;code&gt;'привет мир'&lt;/code&gt;. Однако, не обязательно вызывать метод так уж сразу: &lt;code&gt;x.f&lt;/code&gt; — это объект-метод, он может быть отложен и вызван когда-либо позже. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;xf = x.f
while True:
    print(xf())&lt;/syntaxhighlight&gt;

будет печатать &lt;code&gt;'привет мир'&lt;/code&gt; до конца времён.

Что конкретно происходит при вызове метода? Вы, возможно, заметили, что &lt;code&gt;x.f()&lt;/code&gt; выше был вызван без аргументов, хотя в описании функции &lt;code&gt;f&lt;/code&gt; аргумент был указан. Что же случилось с аргументом? Несомненно, Python порождает исключение когда функция, требующая присутствия аргумента, вызвана без единого — даже, если он на самом деле не используется…

Теперь вы, возможно, догадались: отличительная особенность методов состоит в том, что в качестве первого аргумента функции передаётся объект. В нашем примере вызов &lt;code&gt;x.f()&lt;/code&gt; полностью эквивалентен вызову &lt;code&gt;MyClass.f(x)&lt;/code&gt;. В общем случае, вызов метода со списком из ''n'' аргументов эквивалентен вызову соответствующей функции со списком аргументов, созданным за счёт вставки объекта, вызвавшего метод, перед первым аргументом.

Если вы всё ещё не поняли, как работают методы, взгляд на реализацию возможно прояснит происходящее. Когда атрибут экземпляра ссылается на что-либо, не являющееся атрибутом-данными, производится поиск по классу. Если имя указывает корректный атрибут класса, являющийся объектом-функцией, создаётся метод: через упаковку (указателя на) объекта-экземпляра и найденного объекта-функции в абстрактный объект, получается объект-метод. Когда объект-метод вызывается со списком аргументов, он снова распаковывается и новый список аргументов конструируется из объекта-экземпляра и оригинального списка аргументов, и затем уже с новым списком аргументов вызывается объект-функция.

=== Различные замечания ===

Атрибуты-данные переопределяют атрибуты-методы с тем же именем; для того, что обезопасить себя от случайных конфликтов имён, которые могут привести к трудно-обнаруживаемым ошибкам в больших программах, разумно использовать какое-нибудь соглашение, которое могло бы уменьшить шансы возникновения конфликтов. Возможные соглашения включают в себя: написание имён методов строчными буквами, предварение имени атрибутов-данных некоторой короткой уникальной строкой (предположим, лишь символом подчёркивания («&lt;code&gt;_&lt;/code&gt;»)), или использование глаголов для именования методов и существительных для именования данных.

Методы могут ссылаться на атрибуты-данные также как и обычные пользователи («клиенты») объекта. Другими словами, классы не подходят для разработки чистых абстрактных типов данных. Фактически же в Python нет ничего, вынуждающего вас скрывать данные: сокрытие основано на соглашении между программистами. (С другой стороны, реализация Python, написанная на C, может полностью скрывать детали разработки и, если нужно, контролировать доступ к объекту, это можно делать в расширениях для Python, написанных на C.)

Клиенты должны использовать атрибуты-данные с осторожностью, так как иначе они могут нарушить инварианты, подразумеваемые методами класса при использовании атрибутов-данных. Заметьте, что обычно клиенты могут добавлять собственные атрибуты-данные к объектам-экземплярам, не нарушая работы методов, если не происходит конфликтов имён. Опять же, соглашение об именовании может избавить вас от головной боли и в этих случаях.

''(Прим. перев.)'' Автором здесь не упомянут механизм свойств (&lt;tt&gt;property&lt;/tt&gt;). Свойство синтаксически является атрибутом-данным, но за кулисами с ним могут быть связаны отдельные методы для чтения, записи и удаления. Документация к функции-декоратору &lt;code&gt;property&lt;/code&gt; хорошо проясняет суть дела:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; print(property.__doc__)
property(fget=None, fset=None, fdel=None, doc=None) -&gt; property attribute

fget - функция для чтения, fset - для записи, fdel - для удаления атрибута.
Типичный пример использования для управляемого атрибута x:
class C(object):
    def getx(self): return self._x
    def setx(self, value): self._x = value
    def delx(self): del self._x
    x = property(getx, setx, delx, &quot;Я - свойство 'x'.&quot;)

Декораторы упрощают определение новых свойств и изменение существующих:
class C(object):
    @property
    def x(self): return self._x
    @x.setter
    def x(self, value): self._x = value
    @x.deleter
    def x(self): del self._x
&lt;/syntaxhighlight&gt;
''(Конец прим.)''

У методов нет краткой записи для ссылок изнутри на атрибуты-данные (и другие методы!). Я нахожу, что это и вправду повышает читабельность методов: нет шанса спутать локальные переменные и переменные экземпляров при просмотре тела метода.

Обычно, первый аргумент метода называется &lt;code&gt;self&lt;/code&gt;. Это не более чем соглашение: имя &lt;code&gt;self&lt;/code&gt; не имеет абсолютно никакого специального смысла для языка Python. (Однако, обратите внимание, что если вы не следуете соглашениям, ваш код может стать менее читабелен для других программистов; и также, потенциально, программа навигации по классам может опираться на такие соглашения.)

Любой объект-функция, являющийся атрибутом класса, определяет метод для экземпляров этого класса. Не так важно, чтобы текст определения функции был заключен в определение класса: присваивание объекта-функции локальной переменной класса также работает неплохо. Например:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;# Функция, определённая вне класса
def f1(self, x, y):
    return min(x, x+y)

class C:
    f = f1
    def g(self):
        return 'привет мир'
    h = g&lt;/syntaxhighlight&gt;

Теперь &lt;code&gt;f&lt;/code&gt;, &lt;code&gt;g&lt;/code&gt; и &lt;code&gt;h&lt;/code&gt; — все являются атрибутами класса &lt;code&gt;C&lt;/code&gt;, ссылающимися на объекты-функции, и следовательно, все они являются методами экземпляров &lt;code&gt;C&lt;/code&gt; — &lt;code&gt;h&lt;/code&gt; становится полностью эквивалентен &lt;code&gt;g&lt;/code&gt;. Заметьте, что такая практика обычно лишь запутывает читателя программы.

Методы могут вызывать другие методы за счёт использования атрибутов-методов аргумента &lt;code&gt;self&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class Bag:
    def __init__(self):
        self.data = []
    def add(self, x):
        self.data.append(x)
    def addtwice(self, x):
        self.add(x)
        self.add(x)&lt;/syntaxhighlight&gt;

Методы могут ссылаться на глобальные имена таким же образом, как и обычные функции. Глобальная область видимости, связанная с методом — это модуль, содержащий определение класса. (Сам класс никогда не используется в качестве глобальной области видимости!) В то время, как одни редко находят причины для использования глобальных данных в методах, существует множество разумных причин использовать глобальную область видимости: для примера, функции и модули, импортированные в глобальную область видимости, могут использоваться в методах так же, как в функциях и классах, в ней определённых. Обычно класс, содержащий метод, сам определён в этой глобальной области видимости, и в следующем разделе мы найдём пару хороших причин, почему методу может быть необходимо ссылаться на собственный класс!

=== Наследование ===

Конечно же, не поддерживай «класс» наследование, не стоило бы называть его «классом». Синтаксис производного класса выглядит так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class ИмяПроизводногоКласса(ИмяБазовогоКласса):
    &lt;оператор-1&gt;
    .
    .
    .
    &lt;оператор-N&gt;&lt;/syntaxhighlight&gt;

Имя ''&lt;code&gt;ИмяБазовогоКласса&lt;/code&gt;'' должно быть определено в области видимости, содержащей определение производного класса. Вместо имени базового класса также позволяется использовать другие выражения. Это может быть полезно, например, когда базовый класс определён в другом модуле:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class ИмяПроизводногоКласса(имямодуля.ИмяБазовогоКласса):&lt;/syntaxhighlight&gt;

Использование определения производного класса проходит таким же образом, как и базового. Базовый класс полностью сохраняется по завершению конструирования объекта-класса. Такой метод используется для разрешения ссылок на атрибуты&lt;ref&gt;''(Прим. перев.)'' ''Resolving attribute references'' {ref-en} — разрешение (поиск значений) ссылок на атрибуты&lt;/ref&gt;: если запрошенный атрибут не был найден в самом классе, поиск продолжается в базовом классе. Правило применяется рекурсивно, если базовый класс сам является производным от некоторого другого класса.

В создании экземпляров производных классов нет ничего особенного: &lt;code&gt;ИмяПроизводногоКласса()&lt;/code&gt; создаёт новый экземпляр класса. Ссылки на методы разрешаются следующим образом: производится поиск соответствующего атрибута класса (спускаясь вниз по цепочке базовых классов, если необходимо) и ссылка на метод считается корректной, если она порождает объект-функцию.

Производные классы могут перегружать методы своих базовых классов. Поскольку у методов нет особых привилегий при вызове других методов того же объекта, метод базового класса, вызывающий другой метод, определённый в этом же классе, может вызвать перегруженный метод производного класса. (Для программистов на C++: все методы в Python фактически виртуальны.)

При перегрузке метода в производном классе возможна не только замена действия метода базового класса с тем же именем, но и его расширение. Существует простой способ вызвать метод базового класса прямым образом: просто вызовите «&lt;code&gt;ИмяБазовогоКласса.имяметода(self, аргументы)&lt;/code&gt;». Такой способ будет неожиданно полезным и для клиентов. (Обратите внимание, что он работает только если базовый класс определён и импортирован прямо в глобальную область видимости.)

В языке Python есть функции, которые работают с наследованием:

* Используйте &lt;code&gt;isinstance()&lt;/code&gt; чтобы проверить тип объекта: &lt;code&gt;isinstance(obj, int)&lt;/code&gt; возвратит &lt;code&gt;True&lt;/code&gt; только если &lt;code&gt;obj.__class__&lt;/code&gt; является &lt;code&gt;int&lt;/code&gt; или некоторым классом, наследованным от &lt;code&gt;int&lt;/code&gt;.
* Используйте &lt;code&gt;issubclass()&lt;/code&gt; чтобы проверить наследственность класса: &lt;code&gt;issubclass(bool, int)&lt;/code&gt; возвратит &lt;code&gt;True&lt;/code&gt;, поскольку класс &lt;code&gt;bool&lt;/code&gt; является наследником (&lt;tt&gt;subclass&lt;/tt&gt;) &lt;code&gt;int&lt;/code&gt;. Однако, &lt;code&gt;issubclass(float, int)&lt;/code&gt; возвратит &lt;code&gt;False&lt;/code&gt;, поскольку класс &lt;code&gt;float&lt;/code&gt; не является наследником &lt;code&gt;int&lt;/code&gt;.

==== Множественное наследование ====

Python также поддерживает форму ''множественного наследования'' (&lt;tt&gt;multiple inheritance&lt;/tt&gt;). Определение класса с несколькими базовыми классами будет выглядеть так:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class ИмяПроизводногоКласса(Базовый1, Базовый2, Базовый3):
    &lt;оператор-1&gt;
    .
    .
    .
    &lt;оператор-N&gt;&lt;/syntaxhighlight&gt;

В простейших случаях и для большинства задач, вы можете представлять себе поиск атрибутов, наследованных от родительского класса в виде «сперва вглубь», затем «слева-направо». Таким образом, если атрибут не найден в ''&lt;code&gt;ИмяПроизводногоКласса&lt;/code&gt;'', его поиск выполняется в ''&lt;code&gt;Базовом1&lt;/code&gt;'', затем (рекурсивно) в базовых классах ''&lt;code&gt;Базового1&lt;/code&gt;'' и только если он там не найден, поиск перейдёт в ''&lt;code&gt;Базовый2&lt;/code&gt;'' и так далее.

На самом деле всё немного сложнее. Порядок разрешения методов&lt;ref&gt;''(Прим. перев.)'' другими словами — поиска корректной привязки для метода&lt;/ref&gt; (&lt;tt&gt;method resolution order&lt;/tt&gt;) меняется динамически, чтобы обеспечить возможность сотрудничающих вызовов &lt;code&gt;super()&lt;/code&gt;. Этот способ известен в некоторых других языках с поддержкой множественного наследования как «вызов-следующего-метода» («&lt;tt&gt;call-next-method&lt;/tt&gt;») и имеет больше возможностей, чем вызов родительского метода в языках с единичным наследованием.

Динамическое упорядочивание (&lt;tt&gt;dynamic ordering&lt;/tt&gt;) имеет важность, поскольку все вариации множественного наследования проявляют в себе эффект ромбовых отношений (когда как минимум один родительский класс может быть доступен различными путями из низшего в иерархии класса). Например, все классы наследуются от &lt;code&gt;object&lt;/code&gt;, так что множественное наследование в любом виде предоставляет более одного пути для того, чтобы достичь &lt;code&gt;object&lt;/code&gt;. Чтобы защитить базовые классы от двойных и более запросов, динамический алгоритм «выпрямляет» (&lt;tt&gt;linearizes&lt;/tt&gt;) порядок поиска таким образом, что тот сохраняет указанный слева-направо порядок для каждого класса, который вызывает каждый родительский класс только единожды и является монотонным (значит, класс можно сделать наследником, не взаимодействуя с порядком предшествования его родителей). Обобщённые вместе, эти свойства позволяют разрабатывать надёжные и расширяемые классы, используя множественное наследование. С подробностями можно ознакомиться по этой ссылке: http://www.python.org/download/releases/2.3/mro/ ([[Python — Порядок разрешения методов|перевод]]).

=== Приватные переменные ===

В Python имеется ограниченная поддержка идентификаторов, приватных для класса. Любой идентификатор в форме &lt;code&gt;__spam&lt;/code&gt; (как минимум два предшествующих символа подчёркивания, как максимум один завершающий) заменяется дословно на &lt;code&gt;_classname__spam&lt;/code&gt;, где &lt;code&gt;classname&lt;/code&gt; — текущее имя класса, лишённое предшествующих символов подчёркивания. Это ''искажение'' (&lt;tt&gt;mangling&lt;/tt&gt;) производится без оглядки на синтаксическую позицию идентификатора, поэтому может использоваться для определения переменных, приватных для класса экземпляров, переменных класса, методов, переменных в глобальной области видимости (&lt;tt&gt;globals&lt;/tt&gt;), и даже переменных, использующихся в экземплярах, приватных для этого класса на основе экземпляров ''других'' классов. Имя может быть обрезано, если его длина превышает 255 символов. Вне классов, или когда имя состоит из одних символов подчёркивания, искажения не происходит.

Предназначение искажения имён состоит в том, чтобы дать классам лёгкую возможность определить «приватные» переменные экземпляров и методы, не беспокоясь о переменных экземпляров, определённых в производных классах, и о забивании кодом вне класса переменных экземпляров. Обратите внимание, что правила искажения имён разработаны, в основном, чтобы исключить неприятные случайности — решительная душа всё ещё может получить доступ или изменить переменные, предполагавшиеся приватными. В некотором особом окружении, таком как отладчик, это может оказаться полезным — и это единственная причина, по которой лазейка не закрыта. (Внимание: наследование класса с таким же именем как и у базового делает возможным использование приватных переменных базового класса.)

Заметьте, что код, переданный в &lt;code&gt;exec()&lt;/code&gt; или &lt;code&gt;eval()&lt;/code&gt;, не предполагает в качестве текущего имени класса имя класса, порождающего вызов — так же, как и в случае эффекта с оператором &lt;code&gt;global&lt;/code&gt; — эффекта, который также ограничен для всего побайтно-компилирующегося кода. И, такое же ограничение применимо для функций &lt;code&gt;getattr()&lt;/code&gt;, &lt;code&gt;setattr()&lt;/code&gt; и &lt;code&gt;delattr()&lt;/code&gt;, и также для прямой ссылки на &lt;code&gt;__dict__&lt;/code&gt;.

=== Всякая всячина ===

Иногда бывает полезен тип данных, похожий на &lt;code&gt;record&lt;/code&gt; из языка Pascal или &lt;code&gt;struct&lt;/code&gt; из языка C, например, для хранения нескольких поименованных элементов данных. Для этой цели подойдет даже пустое определение класса&lt;ref&gt;''(Прим. перев.)'':&lt;syntaxhighlight lang=&quot;python&quot;&gt;class Рабочий:
    pass

джон = Рабочий() # Создать пустую запись о рабочем

# Заполнить поля записи
джон.имя = 'Джон До'
джон.отдел = 'компьютерная лаборатория'
джон.зарплата = 1000&lt;/syntaxhighlight&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class Employee:
    pass

john = Employee() # Создать пустую запись о рабочем

# Заполнить поля записи
john.name = 'John Doe'
john.dept = 'computer lab'
john.salary = 1000&lt;/syntaxhighlight&gt;

Фрагменту кода на Python, требующему на входе некоторого абстрактного типа данных, можно дать экземпляр, эмулирующий методы этого типа данных. Например, если имеется функция, умеющая форматировать данные из файлового объекта, то можно определить класс с методами &lt;code&gt;read()&lt;/code&gt; и &lt;code&gt;readline()&lt;/code&gt; (работающие с данными, скажем, из строкового буфера) и передать ей экземпляр этого класса в качестве аргумента.

Объекты-методы экземпляров также имеют атрибуты: &lt;code&gt;m.__self__&lt;/code&gt; — исходный объект-экземпляр с методом &lt;code&gt;m()&lt;/code&gt;, а &lt;code&gt;m.__func__&lt;/code&gt; — объект-функция, соответствующий методу.

=== Исключения — тоже классы ===

Исключения, определённые пользователем, могут быть также отождествлены с классами. При использовании этого механизма становится возможным создавать расширяемые иерархии исключений.

Оператор &lt;code&gt;raise&lt;/code&gt; имеет следующие (синтаксически) правильные формы:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;raise Класс

raise Экземпляр&lt;/syntaxhighlight&gt;

В первой форме, ''&lt;code&gt;Класс&lt;/code&gt;'' должен быть экземпляром типа или класса, производного от него. Первая форма является краткой записью следующего кода:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;raise Class()&lt;/syntaxhighlight&gt;

Класс в блоке &lt;code&gt;except&lt;/code&gt; является сопоставимым с исключением, если является этим же классом или самим по себе базовым классом (никаких других способов обхода — описанный в блоке &lt;code&gt;except&lt;/code&gt; производный класс не сопоставим с базовым). Например, следующий код выведет B, C, D в этом порядке:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class B(Exception):
    pass
class C(B):
    pass
class D(C):
    pass

for c in [B, C, D]:
    try:
        raise c()
    except D:
        print(&quot;D&quot;)
    except C:
        print(&quot;C&quot;)
    except B:
        print(&quot;B&quot;)&lt;/syntaxhighlight&gt;

Обратите внимание, что если бы блоки &lt;code&gt;except&lt;/code&gt; шли в обратном порядке (начиная с «&lt;code&gt;except B&lt;/code&gt;»), код вывел бы B, B, B — сработал бы первый совпадающий блок &lt;code&gt;except&lt;/code&gt;.

При выводе сообщения об ошибке о необработанном исключении, выводится класс исключения, затем двоеточие и пробел, и наконец экземпляр, приведённый к строке за счёт встроенной функции &lt;code&gt;str()&lt;/code&gt;.

=== Итераторы ===

К этому моменту вы, возможно, заметили, что используя оператор &lt;code&gt;for&lt;/code&gt; можно организовать цикл по большинству объектов-контейнеров:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;for element in [1, 2, 3]:
    print(element)
for element in (1, 2, 3):
    print(element)
for key in {'один':1, 'два':2}:
    print(key)
for char in &quot;123&quot;:
    print(char)
for line in open(&quot;myfile.txt&quot;):
    print(line)&lt;/syntaxhighlight&gt;

Такой стиль доступа к элементам прост, лаконичен и удобен. Использованием ''итераторов'' (&lt;tt&gt;iterators&lt;/tt&gt;) пропитан язык Python, и это его выделяет среди других. Негласно, оператор &lt;code&gt;for&lt;/code&gt; вызывает метод &lt;code&gt;iter()&lt;/code&gt; объекта-контейнера. Функция возвращает объект итератора, который определяет метод &lt;code&gt;__next__()&lt;/code&gt;, который по очереди получает доступ к элементам в контейнере, по одному за раз. Если больше не остаётся элементов, метод &lt;code&gt;__next__()&lt;/code&gt; порождает исключение &lt;code&gt;StopIteration&lt;/code&gt;, которое сообщает оператору &lt;code&gt;for&lt;/code&gt; о необходимости завершения прохода. Вы можете вызывать метод &lt;code&gt;__next__()&lt;/code&gt; посредством встроенной функции &lt;code&gt;next()&lt;/code&gt;; следующий пример показывает, как это работает:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; s = 'абв'
&gt;&gt;&gt; it = iter(s)
&gt;&gt;&gt; it
&lt;iterator object at 0x00A1DB50&gt;
&gt;&gt;&gt; next(it)
'а'
&gt;&gt;&gt; next(it)
'б'
&gt;&gt;&gt; next(it)
'в'
&gt;&gt;&gt; next(it)

Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in ?
    next(it)
StopIteration&lt;/syntaxhighlight&gt;

Ознакомившись с механизмами, скрытыми за протоколом итераторов, легко добавить возможность итерирования к вашим классам. Определите метод &lt;code&gt;__iter__()&lt;/code&gt;, который возвращает объект с методом &lt;code&gt;next()&lt;/code&gt;. Если класс определяет и метод &lt;code&gt;next()&lt;/code&gt;, тогда &lt;code&gt;__iter__()&lt;/code&gt; может просто возвращать &lt;code&gt;self&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;class Reverse:
    &quot;Итератор по последовательности в обратном направлении&quot;
    def __init__(self, data):
        self.data = data
        self.index = len(data)
    def __iter__(self):
        return self
    def __next__(self):
        if self.index == 0:
            raise StopIteration
        self.index = self.index - 1
        return self.data[self.index]

&gt;&gt;&gt; for char in Reverse('спам'):
...     print(char)
...
м
а
п
с&lt;/syntaxhighlight&gt;

=== Генераторы ===

''Генераторы'' (&lt;tt&gt;generators&lt;/tt&gt;) — простой и мощный инструмент для создания итераторов. Они записываются как обычная функция, но где бы им ни было необходимо вернуть данные, используется оператор &lt;code&gt;yield&lt;/code&gt;. Каждый раз, когда над ним вызывается &lt;code&gt;__next__()&lt;/code&gt;, генератор возвращается к месту, где он был оставлен (он запоминает все значения данных, а также какой оператор был выполнен последним). Пример показывает, что создание генераторов может быть тривиально простым:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;def reverse(data):
    for index in range(len(data)-1, -1, -1):
        yield data[index]
	
&gt;&gt;&gt; for char in reverse('гольф'):
...     print(char)
...
ф
ь
л
о
г&lt;/syntaxhighlight&gt;

Всё, что можно сделать с использованием генераторов, может быть сделано с использованием основанных на итераторах классов, как описано в предыдущем разделе. Благодаря автоматическому созданию методов &lt;code&gt;__iter__()&lt;/code&gt; и &lt;code&gt;next()&lt;/code&gt; генераторы так компактны.

Другая важная особенность состоит в том, что между вызовами сохраняются локальные переменные и ''состояние выполнения'' (&lt;tt&gt;execution state&lt;/tt&gt;). Это позволяет конструкциям функций быть проще, а получению переменных экземпляров быть намного легче, нежели с использованием &lt;code&gt;self.index&lt;/code&gt; и &lt;code&gt;self.data&lt;/code&gt;.

В дополнение к автоматическому созданию методов и сохранению состояния, когда генераторы заканчивают своё действие, они автоматически порождают исключение &lt;code&gt;StopIteration&lt;/code&gt;. В комбинации, эти особенности позволяют легко создавать итераторы не прилагая усилий больших, чем нужно для написания обычной функции.

=== Выражения-генераторы ===

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

Примеры&lt;ref&gt;''(Прим. перев.)'':&lt;br /&gt;
&lt;br /&gt;
&lt;code&gt;&gt;&gt;&gt; ''сумма''(i*i '''для''' i '''в''' ''диапазон''(10))                 # сумма квадратов&lt;br/&gt;
285&lt;br/&gt;
&lt;br/&gt;
&gt;&gt;&gt; вектор_а = [10, 20, 30]&lt;br/&gt;
&gt;&gt;&gt; вектор_б = [7, 5, 3]&lt;br/&gt;
&gt;&gt;&gt; ''сумма''(x*y '''для''' x,y '''в''' ''зип''(вектор_а, вектор_б))         # скалярное произведение&lt;br/&gt;
260&lt;br/&gt;
&lt;br/&gt;
&gt;&gt;&gt; '''из''' матем '''импорт''' пи, ''синус''&lt;br/&gt;
&gt;&gt;&gt; таблица_синусов = {x:  ''синус''(x*пи/180)) '''для''' x '''в''' ''диапазон''(0, 91)}&lt;br/&gt;
&lt;br/&gt;
&gt;&gt;&gt; уникальные_слова = ''набор''(слово&amp;nbsp;&amp;nbsp;'''для''' строка '''в''' страница&amp;nbsp;&amp;nbsp;'''для''' слово '''в''' строка.''разбить''())&lt;br/&gt;
&lt;br/&gt;
&gt;&gt;&gt; выпускники = ''макс''((студент.ср_балл, студент.имя) '''для''' студент '''в''' окончившие)&lt;br/&gt;
&lt;br/&gt;
&gt;&gt;&gt; данные = 'гольф'&lt;br/&gt;
&gt;&gt;&gt; ''список''(данные[i] '''для''' i '''в''' ''диапазон''(''длина''(данные)-1, -1, -1))&lt;br/&gt;
['ф', 'ь', 'л', 'о', 'г']&lt;/code&gt;&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; sum(i*i for i in range(10))                 # сумма квадратов
285

&gt;&gt;&gt; xvec = [10, 20, 30]
&gt;&gt;&gt; yvec = [7, 5, 3]
&gt;&gt;&gt; sum(x*y for x,y in zip(xvec, yvec))         # скалярное произведение
260

&gt;&gt;&gt; from math import sin, radians
&gt;&gt;&gt; sine_table = {x: sin(radians(x)) for x in range(0, 91)}

&gt;&gt;&gt; unique_words = set(word  for line in page  for word in line.split())

&gt;&gt;&gt; valedictorian = max((student.gpa, student.name) for student in graduates)

&gt;&gt;&gt; data = 'golf'
&gt;&gt;&gt; list(data[i] for i in range(len(data)-1, -1, -1))
['f', 'l', 'o', 'g']&lt;/syntaxhighlight&gt;

== Краткий обзор стандартной библиотеки ==

=== Взаимодействие с операционной системой ===

Модуль &lt;tt&gt;os&lt;/tt&gt; предоставляет десятки функций для взаимодействия с операционной системой.
&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import os
&gt;&gt;&gt; os.getcwd()                     # возвращает путь к текущему каталогу
'C:\\Python31'
&gt;&gt;&gt; os.system('dir *.txt')          # выполнить указанную команду ОС
...список текстовых файлов, выведенных командой...
0
&gt;&gt;&gt; os.chdir('/server/accesslogs')  # сменить текущий каталог
&lt;/syntaxhighlight&gt;

Лучше всего применять &lt;code&gt;import os&lt;/code&gt; вместо &lt;code&gt;from os import *&lt;/code&gt;. Это предохранит встроенную функцию &lt;code&gt;open()&lt;/code&gt; от замещения функцией &lt;code&gt;os.open()&lt;/code&gt;, имеющей несколько иное назначение.

В интерактивном режиме встроенные функции &lt;code&gt;dir()&lt;/code&gt; и &lt;code&gt;help()&lt;/code&gt; помогут разобраться с большими модулями вроде &lt;tt&gt;os&lt;/tt&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import os
&gt;&gt;&gt; dir(os)
...список всех атрибутов модуля...
&gt;&gt;&gt; help(os)
...страница руководства по модулю на основе строк документации...
&lt;/syntaxhighlight&gt;

Для управления файлами и каталогами удобный высокоуровневый интерфейс предоставляет модуль &lt;tt&gt;shutil&lt;/tt&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import shutil
&gt;&gt;&gt; shutil.copyfile('data.db', 'archive.db')         # копировать файл
&gt;&gt;&gt; shutil.move('/build/executables', 'installdir')  # переместить каталог
&lt;/syntaxhighlight&gt;

=== Wildcard-шаблоны для имён файлов ===

Модуль &lt;tt&gt;glob&lt;/tt&gt; предоставляет функцию для получения списка файлов на основе заданного шаблона:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import glob
&gt;&gt;&gt; glob.glob('*.py')
['primes.py', 'random.py', 'quote.py']
&lt;/syntaxhighlight&gt;

=== Аргументы командной строки ===

Сценарии общего назначения часто нуждаются в аргументах командной строки. Эти аргументы хранятся в атрибуте &lt;tt&gt;argv&lt;/tt&gt; модуля &lt;tt&gt;sys&lt;/tt&gt; в виде списка. Например, при запуске &lt;code&gt;python demo.py one two three&lt;/code&gt; в командной строке шелла для сценария &lt;tt&gt;demo.py&lt;/tt&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import sys
print(sys.argv)
&lt;/syntaxhighlight&gt;

будет выведено &lt;code&gt;['demo.py', 'one', 'two', 'three']&lt;/code&gt;.

Модуль &lt;tt&gt;getopt&lt;/tt&gt; обрабатывает &lt;code&gt;sys.argv&lt;/code&gt;, используя соглашения функции &lt;code&gt;getopt()&lt;/code&gt; системы Unix.
Более мощную и гибкую обработку аргументов командной строки осуществляет модуль &lt;tt&gt;optparse&lt;/tt&gt;.

=== Стандартный вывод. Завершение сценария ===

Модуль &lt;tt&gt;sys&lt;/tt&gt; имеет атрибуты &lt;code&gt;stdin&lt;/code&gt;, &lt;code&gt;stdout&lt;/code&gt; и &lt;code&gt;stderr&lt;/code&gt; (для стандартного ввода, вывода и вывода ошибок соответственно). Последний может быть полезен для вывода предупреждений и сообщений об ошибках когда стандартный вывод перенаправлен&lt;ref&gt;''(Прим. перев.)'' разумеется, если стандартный вывод ошибок перенаправлен не был&lt;/ref&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; sys.stderr.write('Внимание! Файл журнала не найден.\n')
Внимание! Файл журнала не найден.
34
&lt;/syntaxhighlight&gt;

Для завершения сценария можно использовать &lt;code&gt;sys.exit()&lt;/code&gt;.

=== Сравнение строк по шаблонам ===

Модуль &lt;tt&gt;re&lt;/tt&gt; предоставляет инструментарий для работы с регулярными выражениями для нетривиальной обработки текста. С помощью регулярных выражений можно создавать выразительные и оптимизированные решения для поиска и обработки строк.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import re
&gt;&gt;&gt; re.findall(r'\bf[a-z]*', 'which foot or hand fell fastest')
['foot', 'fell', 'fastest']
&gt;&gt;&gt; re.sub(r'(\b[a-z]+) \1', r'\1', 'cat in the the hat')
'cat in the hat'
&lt;/syntaxhighlight&gt;

Когда требуются более простые возможности, методы строковых объектов предпочтительнее, так как их легче читать и отлаживать:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; 'чай для двоих'.replace('для', 'на')
'чай на двоих'
&lt;/syntaxhighlight&gt;

=== Математические функции ===

Модуль &lt;tt&gt;math&lt;/tt&gt; предоставляет доступ к библиотеке языка C для функций над числами с плавающей запятой:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import math
&gt;&gt;&gt; math.cos(math.pi / 4)
0.70710678118654757
&gt;&gt;&gt; math.log(1024, 2)
10.0
&lt;/syntaxhighlight&gt;

С помощью модуля &lt;tt&gt;random&lt;/tt&gt; можно делать случайный выбор:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import random
&gt;&gt;&gt; random.choice(['яблоко', 'груша', 'банан'])
'яблоко'
&gt;&gt;&gt; random.sample(range(100), 10)   # выборка без повторений
[30, 83, 16, 4, 8, 81, 41, 50, 18, 33]
&gt;&gt;&gt; random.random()        # случайное число с плавающей запятой
0.17970987693706186
&gt;&gt;&gt; random.randrange(6)    # случайное целое из диапазона range(6)
4
&gt;&gt;&gt; random.sample([1, 2, 3, 4, 5],  3)  # случайные три элемента из списка
[4, 1, 5]

&lt;/syntaxhighlight&gt;
Проект SciPy &lt;http://scipy.org&gt; имеет много других модулей для численных расчётов.

=== Протоколы интернет ===

В стандартной библиотеке имеется целый набор модулей для различных сервисов и протоколов интернет. Наиболее употребимыми можно считать &lt;code&gt;urllib.request&lt;/code&gt; для получения данных по заданному адресу (URL) и &lt;code&gt;smtplib&lt;/code&gt; для отправки сообщений электронной почты:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from urllib.request import urlopen
&gt;&gt;&gt; for line in urlopen('http://tycho.usno.navy.mil/cgi-bin/timer.pl'):
...     if 'EST' in line or 'EDT' in line:  # временные зоны
...         print(line)

&lt;BR&gt;Nov. 25, 09:43:32 PM EST

&gt;&gt;&gt; import smtplib
&gt;&gt;&gt; server = smtplib.SMTP('localhost')
&gt;&gt;&gt; server.sendmail('soothsayer@example.org', 'jcaesar@example.org',
... &quot;&quot;&quot;To: jcaesar@example.org
... From: soothsayer@example.org
...
... Beware the Ides of March.
... &quot;&quot;&quot;)
&gt;&gt;&gt; server.quit()
&lt;/syntaxhighlight&gt;

Заметьте, что второй пример требует почтового сервера на той же машине.

=== Дата и время ===

Модуль &lt;code&gt;datetime&lt;/code&gt; предлагает классы для работы с датами и временем как в простых, так и сложных случаях. Кроме поддержки календарной арифметики, реализация обращает особенное внимание на эффективность вычисления составных частей для вывода и дальнейших манипуляций. Модуль также предлагает объекты с поддержкой временных зон.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;# даты можно легко составлять и выводить в требуемом формате
&gt;&gt;&gt; from datetime import date
&gt;&gt;&gt; now = date.today()
&gt;&gt;&gt; now
datetime.date(2009, 2, 3)
&gt;&gt;&gt; now.strftime(&quot;%d.%m.%Y&quot;)
'03.02.2009'

# даты поддерживают календарную арифметику
&gt;&gt;&gt; birthday = date(1964, 7, 31)
&gt;&gt;&gt; age = now - birthday
&gt;&gt;&gt; age.days
16258
&lt;/syntaxhighlight&gt;

=== Сжатие данных и архивы ===

Наиболее распространённые форматы сжатия и архивации напрямую поддерживаются модулями стандартной библиотеки: &lt;tt&gt;zlib&lt;/tt&gt;, &lt;tt&gt;gzip&lt;/tt&gt;, &lt;tt&gt;bz2&lt;/tt&gt;, &lt;tt&gt;zipfile&lt;/tt&gt; и &lt;tt&gt;tarfile&lt;/tt&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import zlib
&gt;&gt;&gt; s = &quot;Закрой замок на замок, чтобы замок не замок&quot;
&gt;&gt;&gt; len(bytes(s, &quot;utf-8&quot;))
78
&gt;&gt;&gt; t = zlib.compress(s)
&gt;&gt;&gt; len(t)
54
&gt;&gt;&gt; print(str(zlib.decompress(t), &quot;utf-8&quot;))
Закрой замок на замок, чтобы замок не замок
&gt;&gt;&gt; zlib.crc32(s)
2392363341
&lt;/syntaxhighlight&gt;

=== Измерение производительности ===

Некоторым пользователям Python интересно знать относительную производительность различных подходов к решению одной и той же проблемы. Python предлагает инструмент для немедленного ответа на эти вопросы.

Например, очень заманчиво использовать присваивание кортежей вместо традиционного подхода к замене значений переменных местами. Модуль &lt;code&gt;timeit&lt;/code&gt; быстро продемонстрирует незначительное превосходство кортежей:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from timeit import Timer
&gt;&gt;&gt; Timer('a, b = b, a', 'a=1; b=2').timeit()
0.15707302093505859
&gt;&gt;&gt; Timer('t=a; a=b; b=t', 'a=1; b=2').timeit()
0.19421601295471191
&lt;/syntaxhighlight&gt;

В отличие от высокого разрешения модуля &lt;code&gt;timeit&lt;/code&gt;, модули &lt;code&gt;profile&lt;/code&gt; и &lt;code&gt;pstats&lt;/code&gt; предлагают возможность обнаружить критические по времени участки в больших фрагментах кода.

=== Контроль качества ===

Один из подходов к разработке высококачественного программного обеспечения заключается в написании тестов для каждой функции при её разработке и регулярном запуске этих тестов во время всего процесса разработки.

Модуль &lt;code&gt;doctest&lt;/code&gt; имеет средства для просмотра модуля и проверки результатов тестов, заложенных в строках документации. Написание теста для функции заключается в копировании и вставке типичного вызова функции и ее результатов в строку документации. Это улучшает документацию, предоставляя пользователю реальный пример, а модуль &lt;code&gt;doctest&lt;/code&gt; проверяет, что код соответствует документации.


&lt;syntaxhighlight lang=&quot;python&quot;&gt;def average(values):
    &quot;&quot;&quot;Вычисляет среднее арифметическое списка чисел.

    &gt;&gt;&gt; print(average([20, 30, 70]))
    40.0
    &quot;&quot;&quot;
    return sum(values) / len(values)

import doctest
doctest.testmod()   # автоматически проверяет тесты в документации
&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;unittest&lt;/code&gt; не менее прост в использовании чем &lt;code&gt;doctest&lt;/code&gt;, но позволяет создавать более полный набор тестов, располагающийся в отдельном файле:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import unittest

class TestStatisticalFunctions(unittest.TestCase):

    def test_average(self):
        self.assertEqual(average([20, 30, 70]), 40.0)
        self.assertEqual(round(average([1, 5, 7]), 1), 4.3)
        self.assertRaises(ZeroDivisionError, average, [])
        self.assertRaises(TypeError, average, 20, 30, 70)

unittest.main() # Вызов из командной строки выполняет проверку всех тестов этого модуля

&lt;/syntaxhighlight&gt;

=== «Батарейки в комплекте» ===

Python руководствуется философией «батарейки в комплекте». Это можно проследить по сложным и устойчивым к ошибкам возможностям его пакетов побольше. Примеры:

* Модули &lt;code&gt;xmlrpc.client&lt;/code&gt; и &lt;code&gt;xmlrpc.server&lt;/code&gt; делают реализацию удалённых вызовов почти тривиальной задачей. Несмотря на названия, знания об обработке XML не требуются.

* Пакет &lt;code&gt;email&lt;/code&gt; — это библиотека для работы с сообщениями электронной почты, включая MIME и другие основанные на {{RFC|2822}} документы-сообщения. В отличие от &lt;code&gt;smtplib&lt;/code&gt; и &lt;code&gt;poplib&lt;/code&gt;, которые занимаются непосредственно отправкой и приёмом сообщений, пакет &lt;code&gt;email&lt;/code&gt; является полным набором инструментов для построения и декодирования сообщений сложной структуры (включая вложения) и для реализации интернетного кодирования и протокола заголовков.

* Пакеты &lt;code&gt;xml.dom&lt;/code&gt; и &lt;code&gt;xml.sax&lt;/code&gt; предоставляют ошибко-устойчивую поддержку парсинга XML — этого популярного формата для обмена данными. Аналогично, модуль &lt;code&gt;csv&lt;/code&gt; поддерживает чтение и запись в распространённом формате баз данных. Вместе эти модули серьёзно облегчают обмен данными между приложениями на Python и другими приложениями.

* Интернационализация поддерживается благодаря ряду модулей, включая &lt;code&gt;gettext&lt;/code&gt;, &lt;code&gt;locale&lt;/code&gt; и пакет &lt;code&gt;codecs&lt;/code&gt;.

== Второй краткий обзор стандартной библиотеки ==

=== Форматирование вывода ===

Модуль &lt;code&gt;reprlib&lt;/code&gt; предоставляет версию функции &lt;code&gt;repr()&lt;/code&gt;, настроенную на сокращённый вывод больших и многократно вложенных контейнеров:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import reprlib
&gt;&gt;&gt; reprlib.repr(set('supercalifragilisticexpialidocious'))
&quot;set(['a', 'c', 'd', 'e', 'f', 'g', ...])&quot;
&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;pprint&lt;/code&gt; предлагает более утончённый контроль над выводом встроенных и определённых пользователем объектов способом, подходящим для интерпретатора. Когда результат не умещается на строке, умный &lt;code&gt;pprint&lt;/code&gt; добавляет по необходимости разбивку на строки и отступы, помогающие выделить структуру данных:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import pprint
&gt;&gt;&gt; t = [[[['чёрный', 'бирюзовый'], 'белый', ['зелёный', 'красный']], [['пурпурный', 'жёлтый'], 'голубой']]]
&gt;&gt;&gt; pprint.pprint(t, width=30)
[[[['чёрный', 'бирюзовый'],
   'белый',
   ['зелёный', 'красный']],
  [['пурпурный', 'жёлтый'],
   'голубой']]]
&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;textwrap&lt;/code&gt; форматирует абзацы текста под определённую ширину:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import textwrap
&gt;&gt;&gt; doc = &quot;&quot;&quot;Метод wrap() аналогичен fill(), но он возвращает список строк, а не одну большую строку с признаками концов строк.&quot;&quot;&quot;
&gt;&gt;&gt; print(textwrap.fill(doc, width=40))
Метод wrap() аналогичен fill(), но он
возвращает список строк, а не одну
большую строку с признаками концов
строк.
&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;locale&lt;/code&gt; дает доступ к базе данных форматов различных культурных сред. Например, параметр &lt;code&gt;grouping&lt;/code&gt; функции &lt;code&gt;format&lt;/code&gt; этого модуля позволяет использовать группировку цифр принятыми в данной культурной среде разделителями:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import locale
&gt;&gt;&gt; locale.setlocale(locale.LC_ALL, 'en_US.UTF8')
'en_US.UTF8'
&gt;&gt;&gt; conv = locale.localeconv()          # получить отображение соглашений
&gt;&gt;&gt; x = 1234567.8
&gt;&gt;&gt; locale.format(&quot;%d&quot;, x, grouping=True)
'1,234,567'
&gt;&gt;&gt; locale.format(&quot;%s%.*f&quot;, (conv['currency_symbol'], conv['frac_digits'], x), grouping=True)
'$1,234,567.80'
&lt;/syntaxhighlight&gt;

=== Работа с шаблонами ===

Модуль &lt;code&gt;string&lt;/code&gt; включает в себя гибкий класс &lt;code&gt;Template&lt;/code&gt;, реализующий шаблоны с простым синтаксисом, доступным для редактирования конечными пользователями. Использование этого класса позволит пользователям настраивать приложения без изменений в них самих.

Формат использует имена полей для подстановки, записываемых как знак доллара (&lt;code&gt;$&lt;/code&gt;) с последующим идентификатором, состоящим, как и имена в программах на Python, из букв, цифр и подчёркиваний&lt;ref&gt;(''Прим. перев.'') вопреки ожиданиям, имена полей нельзя писать кириллицей.&lt;/ref&gt;. Фигурные скобки вокруг идентификатора позволяют использовать алфавитно-цифровые символы сразу после поля подстановки, без дополнительных пробелов. Собственно знак доллара необходимо записывать сдвоенно: &lt;code&gt;$$&lt;/code&gt;.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from string import Template
&gt;&gt;&gt; t = Template('${village}folk send $$10 to $cause.')
&gt;&gt;&gt; t.substitute(village='Nottingham', cause='the ditch fund')
'Nottinghamfolk send $10 to the ditch fund.'
&lt;/syntaxhighlight&gt;

Метод &lt;code&gt;substitute()&lt;/code&gt; возбуждает &lt;code&gt;KeyError&lt;/code&gt; в случае, когда значение для поля отсутствует в переданных параметрах. Для приложений вроде массовой персонализированной рассылки, часть данных может отсутствовать. В таком случае лучше использовать метод &lt;code&gt;safe_substitute()&lt;/code&gt;: он оставит разметку полей подстановки в случае отсутствия данных.&lt;ref&gt;(''Прим. перев.'') разумеется, ещё лучше позаботиться, чтобы у полей были удачные значения по умолчанию.&lt;/ref&gt;

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; t = Template('Return the $item to $owner.')
&gt;&gt;&gt; d = dict(item='unladen swallow')
&gt;&gt;&gt; t.substitute(d)
Traceback (most recent call last):
  . . .
KeyError: 'owner'
&gt;&gt;&gt; t.safe_substitute(d)
'Return the unladen swallow to $owner.'&lt;/syntaxhighlight&gt;

Производные от &lt;code&gt;Template&lt;/code&gt; классы могут переопределить разделитель. Например, утилита переименования файлов просмотрщика фотографий может использовать знаки процента в разметке полей подстановки: текущая дата, номер изображения по порядку, формат файла:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import time, os.path
&gt;&gt;&gt; photofiles = ['img_1074.jpg', 'img_1076.jpg', 'img_1077.jpg']
&gt;&gt;&gt; class BatchRename(Template):
...     delimiter = '%'
&gt;&gt;&gt; fmt = input('Введите стиль переименования (%d - дата, %n - номер п/п, %f - формат):  ')
Введите стиль переименования (%d - дата, %n - номер п/п, %f - формат):  Ashley_%n%f

&gt;&gt;&gt; t = BatchRename(fmt)
&gt;&gt;&gt; date = time.strftime('%d%b%y')
&gt;&gt;&gt; for i, filename in enumerate(photofiles):
...     base, ext = os.path.splitext(filename)
...     newname = t.substitute(d=date, n=i, f=ext)
...     print('{0} --&gt; {1}'.format(filename, newname))

img_1074.jpg --&gt; Ashley_0.jpg
img_1076.jpg --&gt; Ashley_1.jpg
img_1077.jpg --&gt; Ashley_2.jpg&lt;/syntaxhighlight&gt;

Другое приложение для использования шаблонов — отделение логики от деталей реализации различных выходных форматов. Это даёт возможность строить шаблоны для XML-файлов, текстовых отчётов и веб-отчётов на HTML.

=== Работа с записями двоичных данных ===

Модуль &lt;code&gt;struct&lt;/code&gt; предлагает функции &lt;code&gt;pack()&lt;/code&gt; и &lt;code&gt;unpack()&lt;/code&gt; для работы с форматами двоичных записей переменной длины. Следующий пример показывает как можно получить заголовочную информацию из ZIP-файла без использования модуля &lt;code&gt;zipfile&lt;/code&gt;. Коды &lt;code&gt;&quot;H&quot;&lt;/code&gt; и &lt;code&gt;&quot;I&quot;&lt;/code&gt; представляют двух- и четырехбайтовых беззнаковых числа соответственно. Код &lt;code&gt;&quot;&lt;&quot;&lt;/code&gt; обозначает, что числа стандартного размера и байты записаны в порядке «сначала младший» (little-endian):

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import struct

data = open('myfile.zip', 'rb').read()
start = 0
for i in range(3):                      # показать первые три заголовка
    start += 14
    fields = struct.unpack('&lt;IIIHH', data[start:start+16])
    crc32, comp_size, uncomp_size, filenamesize, extra_size = fields

    start += 16
    filename = data[start:start+filenamesize]
    start += filenamesize
    extra = data[start:start+extra_size]
    print(filename, hex(crc32), comp_size, uncomp_size)

    start += extra_size + comp_size     # пропустить до следующего заголовка
&lt;/syntaxhighlight&gt;

=== Многопоточность ===

Потоки (threads) могут использоваться для разделения задач, которые могут выполняться по времени независимо друг от друга. Разделение на потоки может применяться для улучшения времени отклика приложений, ведущих диалог с пользователем пока другие задачи выполняются в фоновом режиме. Похожая ситуация с произведением ввода-вывода одновременно с вычислениями в другом потоке.

Следующий пример показывает, как высокоуровневый модуль &lt;code&gt;threading&lt;/code&gt; может выполнять фоновые задачи, продолжая выполнение основной программы:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import threading, zipfile

class AsyncZip(threading.Thread):
    def __init__(self, infile, outfile):
        threading.Thread.__init__(self)
        self.infile = infile
        self.outfile = outfile
    def run(self):
        f = zipfile.ZipFile(self.outfile, 'w', zipfile.ZIP_DEFLATED)
        f.write(self.infile)
        f.close()
        print('Завершён фоновый zip для:', self.infile)

background = AsyncZip('mydata.txt', 'myarchive.zip')
background.start()
print('Главная программа на переднем плане.')

background.join()    # Ждём завершения фоновой задачи
print('Главная программа дождалась завершения фоновой задачи.')
&lt;/syntaxhighlight&gt;

Основной трудностью многопоточных приложений является координирование потоков, разделяющих общие данные или другие ресурсы. В помощь этому модуль &lt;code&gt;threading&lt;/code&gt; предлагает целый ряд простых средств: замки́, события, переменные условий, семафоры и другие.

Несмотря на достаточную мощь представленных средств, даже небольшие погрешности в дизайне многопоточного приложения могут вызвать трудноповторимые проблемы. Таким образом, рекомендуемым подходом к координированию задач является централизация доступа к некоторому ресурсу в одном потоке и использование модуля &lt;code&gt;queue&lt;/code&gt; для направления запросов из других потоков. Приложения, использующие Queue-объекты для межпотоковой связи и координирования, легче проектировать, сопровождать исходный код, они более надёжны.

=== Запись в журнал ===

Модуль &lt;code&gt;logging&lt;/code&gt; предлагает богатую возможностями и гибкую систему ведения журнала. В простейшем случае сообщения отправляются на стандартный вывод ошибок — &lt;code&gt;sys.stderr&lt;/code&gt;:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;import logging
logging.debug('Отладочная информация')
logging.info('Для информации')
logging.warning('Предупреждение: файл %s не найден', 'server.conf')
logging.error('Произошла ошибка!')
logging.critical('Критическая ошибка - выход')&lt;/syntaxhighlight&gt;

Результат выполнения этого примера:

&lt;syntaxhighlight lang=&quot;text&quot;&gt;WARNING:root:Предупреждение: файл server.conf не найден
ERROR:root:Произошла ошибка!
CRITICAL:root:Критическая ошибка - выход
&lt;/syntaxhighlight&gt;

Без дополнительной настройки информационные и отладочные сообщения подавляются, а вывод направляется в &lt;code&gt;sys.stderr&lt;/code&gt;. Другие варианты вывода: отправка сообщений по электронной почте, дейтаграммами, сокеты, на HTTP сервер. Другие фильтры могут выбирать различные варианты доставки в зависимости от приоритета: &lt;tt&gt;DEBUG&lt;/tt&gt;, &lt;tt&gt;INFO&lt;/tt&gt;, &lt;tt&gt;WARNING&lt;/tt&gt;, &lt;tt&gt;ERROR&lt;/tt&gt; или &lt;tt&gt;CRITICAL&lt;/tt&gt;.

Система записи в журнал может быть сконфигурирована напрямую из Python. Конфигурация также может быть загружена из конфигурационного файла и не требовать изменений в коде приложения.

=== Слабые ссылки ===

Python имеет автоматическое управление памятью: подсчёт ссылок для большинства объектов и сборка мусора для удаления циклов. Память освобождается сразу после того, как была удалена последняя ссылка на объект.

Этот подход отлично работает для большинства приложений, но иногда возникает необходимость вести учёт объектов только когда они используются где-нибудь ещё. К сожалению, само слежение за объектами уже создает ссылку и тем самым объекты остаются в памяти. Модуль &lt;code&gt;weakref&lt;/code&gt; (от англ. weak reference — слабая ссылка) даёт средство для учёта объектов без создания ссылок на них. Когда объект больше не нужен, он автоматически удаляется из таблицы слабых ссылок и производится обратный вызов &lt;code&gt;weakref&lt;/code&gt;-объектов. Типичное применение модуля — кэширование объектов, которые затратно воспроизвести снова.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import weakref, gc
&gt;&gt;&gt; class A:
...     def __init__(self, value):
...             self.value = value
...     def __repr__(self):
...             return str(self.value)
...
&gt;&gt;&gt; a = A(10)                   # создаёт ссылку
&gt;&gt;&gt; d = weakref.WeakValueDictionary()  # словарь, использующий слабые ссылки
&gt;&gt;&gt; d['primary'] = a            # не создаёт ссылки
&gt;&gt;&gt; d['primary']                # достать объект, если он все ещё &quot;жив&quot;
10
&gt;&gt;&gt; del a                       # удалить одну ссылку
&gt;&gt;&gt; gc.collect()                # произвести сборку мусора
0
&gt;&gt;&gt; d['primary']                # запись была автоматически удалена
Traceback (most recent call last):
  File &quot;&lt;stdin&gt;&quot;, line 1, in &lt;module&gt;
    d['primary']
  File &quot;C:/python31/lib/weakref.py&quot;, line 46, in __getitem__
    o = self.data[key]()
KeyError: 'primary'
&lt;/syntaxhighlight&gt;

=== Работа со списками ===

В Python список может заменить многие структуры данных. Однако иногда необходимы альтернативные реализации, которые имеют другое компромиссное решение в отношении производительности.

Модуль &lt;code&gt;array&lt;/code&gt; (массив) предоставляет объект &lt;code&gt;array&lt;/code&gt;, отличающийся от списка лишь возможностью более компактно хранить однородные данные. Следующий пример показывает массив чисел, хранимый в виде двухбайтных беззнаковых чисел (типокод «&lt;code&gt;H&lt;/code&gt;»), а не в обычном списке, где каждый элемент типа &lt;code&gt;int&lt;/code&gt; обычно занимает 16 байт:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from array import array
&gt;&gt;&gt; a = array('H', [4000, 10, 700, 22222])
&gt;&gt;&gt; sum(a)
26932
&gt;&gt;&gt; a[1:3]
array('H', [10, 700])&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;collections&lt;/code&gt; (коллекции) среди прочего предоставляет объект &lt;code&gt;deque&lt;/code&gt; (дек, двухсторонняя очередь). Объекты этого типа имеют более быстрые операции вставки (append) и извлечения (pop) слева, но более медленный поиск внутренних элементов. Эти объекты хорошо подходят для реализации очередей и деревьев поиска в ширину:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from collections import deque
&gt;&gt;&gt; d = deque([&quot;задача1&quot;, &quot;задача2&quot;, &quot;задача3&quot;])
&gt;&gt;&gt; d.append(&quot;task4&quot;)
&gt;&gt;&gt; print(&quot;Обрабатывается&quot;, d.popleft())
Обрабатывается задача1

unsearched = deque([starting_node])
def breadth_first_search(unsearched):
    node = unsearched.popleft()
    for m in gen_moves(node):
        if is_goal(m):
            return m
        unsearched.append(m)
&lt;/syntaxhighlight&gt;

В дополнение к альтернативным реализациям списков библиотека также предлагает средства вроде модуля &lt;code&gt;bisect&lt;/code&gt; с функциями для манипуляции отсортированными списками:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; import bisect
&gt;&gt;&gt; scores = [(100, 'perl'), (200, 'tcl'), (400, 'lua'), (500, 'python')]
&gt;&gt;&gt; bisect.insort(scores, (300, 'ruby'))  # вставка значения в отсортированный список
&gt;&gt;&gt; scores
[(100, 'perl'), (200, 'tcl'), (300, 'ruby'), (400, 'lua'), (500, 'python')]
&lt;/syntaxhighlight&gt;

Модуль &lt;code&gt;heapq&lt;/code&gt; имеет функции для реализации кучи, основанной на обычных списках. Элемент с наименьшим значением всегда находится в позиции с индексом 0. Это свойство может с успехом быть задействовано в приложениях, где особенно частый доступ необходим к наименьшему элементу, но полную сортировку проводить накладно.

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from heapq import heapify, heappop, heappush
&gt;&gt;&gt; data = [1, 3, 5, 7, 9, 2, 4, 6, 8, 0]
&gt;&gt;&gt; heapify(data)                      # сделать из списка кучу
&gt;&gt;&gt; heappush(data, -5)                 # добавить новый элемент
&gt;&gt;&gt; [heappop(data) for i in range(3)]  # извлечь три наименьших значения
[-5, 0, 1]
&lt;/syntaxhighlight&gt;

=== Десятичная арифметика чисел с плавающей запятой ===

Модуль &lt;code&gt;decimal&lt;/code&gt; предоставляет тип данных &lt;code&gt;Decimal&lt;/code&gt; для десятичной арифметики с плавающей запятой. В сравнении со встроенной двоичной арифметикой, новый класс особенно полезен в финансовых приложениях и других случаях, требующих точного десятичного представления, управления точностью, округлением c соблюдением законодательных и нормативных требований, отслеживания количества значащих цифр или для приложений, от которых ожидается совпадение с результатами, проделанными «вручную».

Например, вычисление 5%-ного налога на 70 копеечный телефонный счет даёт различные результаты при использовании десятичной и двоичной арифметик. Разница становится значащей при округлении до ближайшей копейки:

&lt;syntaxhighlight lang=&quot;python&quot;&gt;&gt;&gt;&gt; from decimal import *
&gt;&gt;&gt; Decimal('0.70') * Decimal('1.05')
Decimal(&quot;0.7350&quot;)
&gt;&gt;&gt; .70 * 1.05
0.73499999999999999
&lt;/syntaxhighlight&gt;


== Что дальше? ==

Чтение этого учебника, возможно, усилило ваш интерес к применению Python, и вы жаждете использовать этот язык для решения конкретных задач. Где можно пополнить знания о Python?

Этот учебник является частью набора документации Python. В этом наборе есть и другие документы.

----

'''Сноски:'''

&lt;references /&gt;</text>
      <sha1>271qn6cc1zofvsrbfjb9tpuic6smdv0</sha1>
    </revision>
  </page>
  <page>
    <title>Рецепт:Азъяшыд</title>
    <ns>104</ns>
    <id>30101</id>
    <revision>
      <id>270415</id>
      <parentid>253131</parentid>
      <timestamp>2026-10-27T06:58:50Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270415</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="3440" sha1="k1f0pfethbgc6dgcyx9bge50zo0hc8x" xml:space="preserve">''Основная статья с рецептами категории:'' [https://ru.wikibooks.org/wiki/Категория:Борщи Борщи]
{{Рецепт
 |Категория   = Борщи
 |Кухня = Финно-угорская кухня, русская кухня
 |Порций      = 4
 |Время       = 
 |Сложность   = 2
 |Энергетическая ценность = 
 |Изображение = Лапеня.jpg
 }}
'''Азъяшыд''' (''щи борщевые'', ''«древнерусский» борщ'' Новгородской Руси) как национальное фино-угорское блюдо (сохранившееся со времён Древней Руси особенно у коми и коми-пермяков) готовят из борщевика сибирского или обыкновенного (европейского), специально обработанного для этой цели.

= Ингредиенты =
&lt;div class=&quot;mw-collapsible&quot;&gt;
[[Файл:HeracleumSphondylium1.jpg|thumb|left|Борщевик обыкновенный]]
Пропорции произвольны:
* 1 л рубленого подготовленного борщевика
* 1 стакан рубленой зелени (крапивы, лебеды)
* 0,5 кг мяса
* 2-3 луковицы или 1-1,5 стакана рубленой колбы (черемши)
* 30-40 г ячневой крупы (2 ст. ложки)
&lt;/div&gt;

= Приготовление =
&lt;div class=&quot;mw-collapsible&quot;&gt;
Борщевик рубят, как капусту, а затем бланшируют или запаривают кипятком (иногда 2-3 мин. отваривают) и, слив воду, слегка солят и сохраняют в кадках, где он приобретает характерный грибной вкус.&lt;br&gt;
Летом в азъяшыд добавляют немного свежей крапивы, лебеды и чертополоха, придающих блюду «наваристость» и нежность.&lt;br&gt;
Обязательным компонентом азъяшыд служит ячневая крупа, чтобы придать им национальный колорит. Далее готовят как [[Рецепт:Щи|щи]].&lt;br&gt;
Заправляют азъяшыд луком, а на Урале и в Зауралье – колбой (черемшой). Забеливают, как и щи, сметаной.&lt;br&gt;
Вычегодские и сысольские коми в прошлом традиционно использовали в азъяшыд солонину, ижемские коми – оленину, коми-пермяки и колвинские вогулы (манси) – лесную дичь (рябчиков, куропаток), зауральские манси – рыбу (таймень).
&lt;/div&gt;

== Литература ==
&lt;div class=&quot;mw-collapsible&quot;&gt;
* {{книга |автор= |часть= |заглавие= &lt;b&gt;''Большая энциклопедия кулинарного искусства.''&lt;/b&gt; Все рецепты В.В. Похлёбкина |ответственный= |место= М. |издательство= Центрполиграф |год= 2001, 2010. — {{ISBN|5-227-01135-4}}, {{ISBN|978-5-9524-4897-1}}}}
&lt;/div&gt;

== Ссылки ==</text>
      <sha1>k1f0pfethbgc6dgcyx9bge50zo0hc8x</sha1>
    </revision>
  </page>
  <page>
    <title>Как исправить неправильную кодировку</title>
    <ns>0</ns>
    <id>31229</id>
    <revision>
      <id>270430</id>
      <parentid>254946</parentid>
      <timestamp>2026-10-27T07:12:15Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270430</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="18036" sha1="pgkjwqs95apsuou29ld8h0gca2unuh8" xml:space="preserve">В современном мире с проблемой неправильной кодировки встречаются достаточно редко. Кодировкой «по умолчанию» считается UTF-8, которая поддерживает почти все известные системы письма. Если кто-то использует другие кодировки, принято явно указывать, какая кодировка используется. Также многие современные программы, такие как почтовые клиенты, имеют средства для распознания используемой кодировки. Однако есть ещё ситуации, когда можно увидеть появление кракозябр вместо осмысленного текста:
* Использование устаревшего ПО, не поддерживающего Юникод;
* ID3v1-теги у MP3-файлов;
* Работа с приложениями для командной строки Windows и PowerShell в других эмуляторах терминала, например MinGW — в первых по историческим причинам используются кодировки времён DOS — в частности CP866 для русского языка, а последние как правило собираются с поддержкой UTF-8.
* Есть возможность получить неадекватные символы при использовании неправильных шрифтов при печати на принтере или фотонаборном автомате, неверно настроенной локали программы (когда вместо кодовой страницы CP1251 используется CP1252).
* При использовании UTF-8 всё равно остаётся риск получить кракозябры при выводе текста по HTTP: если кодировка нигде не указана, {{RFC|2616}} даёт значение по умолчанию — ISO-8859-1&lt;ref&gt;{{RFC|2616}} — Hypertext Transfer Protocol — HTTP/1.1&lt;!-- Заголовок добавлен ботом --&gt;&lt;/ref&gt;.
Нередко бывает, что перекодировка осуществляется в правильном направлении, но сам перекодировщик работает не совсем корректно. Например, некоторые программы-перекодировщики преобразуют только базовые русские буквы, а все остальные символы оставляют на месте. В итоге при перекодировке KOI8-R&amp;nbsp;→&amp;nbsp;Windows-1251 буква '''ё''' превращается в '''Ј''' (сербская буква), значок градуса (°) превращается в '''њ''' и т.&amp;nbsp;д. (такие тексты в изобилии встречаются в Интернете, достаточно поискать слова «всЈ» или «њС»).

Другой вариант искажений связан с тем, что в целевой кодировке могут отсутствовать символы, имеющиеся в исходной кодировке. В этом случае отсутствующие символы могут просто выбрасываться, заменяться на символ-заменитель (часто знак вопроса — ?, иногда �) или же заменяться на похожие символы из ASCII (например, знак минуса (&lt;code&gt;U+2212&lt;/code&gt;, −) может заменяться на простой дефис (&lt;code&gt;U+002D&lt;/code&gt;, -), буква '''š''' может заменяться на '''s''' и т.&amp;nbsp;д. В&amp;nbsp;случае простого текста такие потери информации неизбежны, однако, если преобразованию подвергается файл HTML или XML, то корректным преобразованием будет замена отсутствующих в целевой кодировке символов на соответствующие мнемоники HTML: например, знак минуса должен заменяться на &lt;code&gt;&amp;amp;minus;&lt;/code&gt; или &lt;code&gt;&amp;amp;#8722;&lt;/code&gt; буква '''š''' должна заменяться на &lt;code&gt;&amp;amp;scaron;&lt;/code&gt; или &lt;code&gt;&amp;amp;#353;&lt;/code&gt; и т.&amp;nbsp;д.
== История ==

В 1980-е и 1990-е пользователи компьютеров и с 1990 г. — пользователи русскоязычной части интернета вынуждены были мириться с существованием нескольких конкурирующих кодировок кириллицы: основная — ГОСТ, альтернативная — DOS 866 (Unix KOI8-R, Windows CP-1251, ISO 8859-5), MacCyrillic. В результате неправильной конфигурации серверов и недостаточной совместимости тексты очень часто было невозможно прочесть. Получая сообщения по электронной почте или зайдя на веб-сайт, неопытные пользователи могли наткнуться на странные необычные символы вместо букв кириллицы.
== Как распознать ==
По этому списку можно приблизительно определить, из какой кодировки в какую произошло преобразование. Для примера использована панграмма (без кавычек): «Широкая электрификация южных губерний даст мощный толчок подъёму сельского хозяйства».

{| class=&quot;wikitable&quot;
!Исходная кодировка!!При декодировании воспринято как!!Результат
|-
|colspan=&quot;2&quot; style=&quot;text-align:center;&quot; | При воспроизведении применяется та же кодировка, что и при создании текста. || Широкая электрификация южных губерний даст мощный толчок подъёму сельского хозяйства.
|-
|rowspan=&quot;4&quot;| [[:w:Windows-1251|Windows-1251]] || [[:w:Windows-1252|Windows-1252]] или &lt;br /&gt;[[:w:ISO 8859-1|ISO 8859-1]]&lt;ref name=&quot;w1252&quot;&gt;Кодовая таблица ISO 8859-1 отличается лишь отсутствием ряда изображённых символов. В системе Microsoft Windows вместо кодовой страницы ISO 8859-1 применяется её расширение Windows-1252.&lt;/ref&gt; || &lt;nowiki&gt;Øèðîêàÿ ýëåêòðèôèêàöèÿ þæíûõ ãóáåðíèé äàñò ìîùíûé òîë÷îê ïîäú¸ìó ñåëüñêîãî õîçÿéñòâà.&lt;/nowiki&gt;
|-
| [[:w:КОИ-8|KOI8-R]] || &lt;nowiki&gt;ьХПНЙЮЪ ЩКЕЙРПХТХЙЮЖХЪ ЧФМШУ ЦСАЕПМХИ ДЮЯР ЛНЫМШИ РНКВНЙ ОНДЗ╦ЛС ЯЕКЭЯЙНЦН УНГЪИЯРБЮ.&lt;/nowiki&gt;
|-
| [[:w:ISO 8859-5|ISO 8859-5]] || &lt;nowiki&gt;иш№юърџ §ыхъђ№шєшърішџ ўцэћѕ уѓсх№эшщ фрёђ ьюљэћщ ђюыїюъ яюфњИьѓ ёхыќёъюую ѕючџщёђтр.&lt;/nowiki&gt;
|-
| [[:w:Альтернативная кодировка|CP 866]] || &lt;nowiki&gt;╪шЁюър  ¤ыхъЄЁшЇшърЎш  ■цэ√ї уєсхЁэшщ фрёЄ ью∙э√щ Єюыўюъ яюф·╕ьє ёхы№ёъюую їюч щёЄтр.&lt;/nowiki&gt;
|-
|rowspan=&quot;5&quot;| [[:w:КОИ-8|KOI8-R]] || [[:w:Windows-1252|Windows-1252]] или &lt;br /&gt;[[:w:ISO 8859-1|ISO 8859-1]]&lt;ref name=&quot;w1252&quot;/&gt; || &lt;nowiki&gt;ûÉÒÏËÁÑ ÜÌÅËÔÒÉÆÉËÁÃÉÑ ÀÖÎÙÈ ÇÕÂÅÒÎÉÊ ÄÁÓÔ ÍÏÝÎÙÊ ÔÏÌÞÏË ÐÏÄß£ÍÕ ÓÅÌØÓËÏÇÏ ÈÏÚÑÊÓÔ×Á.&lt;/nowiki&gt;
|-
| [[:w:Windows-1251|Windows-1251]] || &lt;nowiki&gt;ыЙТПЛБС ЬМЕЛФТЙЖЙЛБГЙС АЦОЩИ ЗХВЕТОЙК ДБУФ НПЭОЩК ФПМЮПЛ РПДЯЈНХ УЕМШУЛПЗП ИПЪСКУФЧБ.&lt;/nowiki&gt;
|-
| [[:w:ISO 8859-5|ISO 8859-5]] || &lt;nowiki&gt;ћЩвЯЫСб мЬХЫдвЩЦЩЫСУЩб РжЮйШ ЧеТХвЮЩЪ ФСгд ЭЯнЮйЪ дЯЬоЯЫ аЯФпЃЭе гХЬигЫЯЧЯ ШЯкбЪгдзС.&lt;/nowiki&gt;
|-
| [[:w:Альтернативная кодировка|CP 866]] || &lt;nowiki&gt;√╔╥╧╦┴╤ ▄╠┼╦╘╥╔╞╔╦┴├╔╤ └╓╬┘╚ ╟╒┬┼╥╬╔╩ ─┴╙╘ ═╧▌╬┘╩ ╘╧╠▐╧╦ ╨╧─▀г═╒ ╙┼╠╪╙╦╧╟╧ ╚╧┌╤╩╙╘╫┴.&lt;/nowiki&gt;
|-
| [[:w:КОИ-7|КОИ-7]] || &lt;nowiki&gt;{IROKAQ \LEKTRIFIKACIQ @VNYH GUBERNIJ DAST MO]NYJ TOL^OK POD_#MU SELXSKOGO HOZQJSTWA.&lt;/nowiki&gt;
|-
|rowspan=&quot;4&quot;| [[:w:ISO 8859-5|ISO 8859-5]] || [[:w:Windows-1252|Windows-1252]] или &lt;br /&gt;[[:w:ISO 8859-1|ISO 8859-1]]&lt;ref name=&quot;w1252&quot;/&gt; || &lt;nowiki&gt;ÈØàÞÚÐï íÛÕÚâàØäØÚÐæØï îÖÝëå ÓãÑÕàÝØÙ ÔÐáâ ÜÞéÝëÙ âÞÛçÞÚ ßÞÔêñÜã áÕÛìáÚÞÓÞ åÞ×ïÙáâÒÐ.&lt;/nowiki&gt;
|-
| [[:w:Windows-1251|Windows-1251]] || &lt;nowiki&gt;ИШаЮЪРп нЫХЪваШдШЪРжШп оЦЭле УгСХаЭШЩ ФРбв ЬЮйЭлЩ вЮЫзЮЪ ЯЮФксЬг бХЫмбЪЮУЮ еЮЧпЩбвТР.&lt;/nowiki&gt;
|-
| [[:w:КОИ-8|KOI8-R]] || &lt;nowiki&gt;хьЮчзпО МшузБЮьДьзпФьО НжщКЕ сЦяуЮщьы тпАБ эчИщКы БчшГчз ъчтЙЯэЦ АушЛАзчсч ЕчвОыАБрп.&lt;/nowiki&gt;
|-
| [[:w:Альтернативная кодировка|CP 866]] || &lt;nowiki&gt;╚╪р▐┌╨я э█╒┌тр╪ф╪┌╨ц╪я ю╓▌ых ╙у╤╒р▌╪┘ ╘╨ст ▄▐щ▌ы┘ т▐█ч▐┌ ▀▐╘ъё▄у с╒█ьс┌▐╙▐ х▐╫я┘ст╥╨.&lt;/nowiki&gt;
|-
|rowspan=&quot;5&quot;| [[:w:Альтернативная кодировка|CP 866]] || [[:w:Windows-1252|Windows-1252]]&lt;ref name=&quot;w1252&quot;/&gt; || &lt;nowiki&gt;˜¨à®ª ï í«¥ªâà¨ä¨ª æ¨ï î¦­ëå £ã¡¥à­¨© ¤ áâ ¬®é­ë© â®«ç®ª ¯®¤êñ¬ã á¥«ìáª®£® å®§ï©áâ¢&amp;nbsp;.&lt;/nowiki&gt;
|-
| [[:w:Windows-1251|Windows-1251]] || &lt;nowiki&gt;�Ёа®Є п н«ҐЄваЁдЁЄ жЁп о¦­ле ЈгЎҐа­Ё© ¤ бв ¬®й­л© в®«з®Є Ї®¤кс¬г бҐ«мбЄ®Ј® е®§п©бвў&amp;nbsp;.&lt;/nowiki&gt;
|-
| [[:w:КОИ-8|KOI8-R]] || &lt;nowiki&gt;≤╗Ю╝╙═О М╚╔╙БЮ╗Д╗╙═Ф╗О Н╕╜КЕ ёЦ║╔Ю╜╗╘ ╓═АБ ╛╝И╜К╘ Б╝╚Г╝╙ ╞╝╓ЙЯ╛Ц А╔╚ЛА╙╝ё╝ Е╝╖О╘АБ╒═.&lt;/nowiki&gt;
|-
| [[:w:ISO 8859-5|ISO 8859-5]] || &lt;nowiki&gt;�ЈрЎЊ я эЋЅЊтрЈфЈЊ цЈя юІ­ых ЃуЁЅр­ЈЉ Є ст ЌЎщ­ыЉ тЎЋчЎЊ ЏЎЄъёЌу сЅЋьсЊЎЃЎ хЎЇяЉстЂ&amp;nbsp;.&lt;/nowiki&gt;
|-
| [[:w:CP437|CP 437]] || &lt;nowiki&gt;ÿ¿α«¬á∩ φ½Ñ¬Γα¿Σ¿¬áµ¿∩ εª¡δσ úπíÑα¡¿⌐ ñáßΓ ¼«Θ¡δ⌐ Γ«½τ«¬ »«ñΩ±¼π ßÑ½∞ß¬«ú« σ«º∩⌐ßΓóá.&lt;/nowiki&gt;
|-
|rowspan=&quot;5&quot;| [[:w:UTF-8|UTF-8]]&lt;ref&gt;
Варианты ''декодирования'' в UTF-8 не приводятся, так как бо́льшая часть русского текста, записанного в 8-битной кодовой странице, будет сочтена ошибочной (не имеющей представления).&lt;/ref&gt;
| [[:w:Windows-1252|Windows-1252]]&lt;ref name=&quot;w1252&quot;/&gt; || &lt;nowiki&gt;Ð¨Ð¸Ñ€Ð¾ÐºÐ°Ñ ÑÐ»ÐµÐºÑ‚Ñ€Ð¸Ñ„Ð¸ÐºÐ°Ñ†Ð¸Ñ ÑŽÐ¶Ð½Ñ‹Ñ… Ð³ÑƒÐ±ÐµÑ€Ð½Ð¸Ð¹ Ð´Ð°ÑÑ‚ Ð¼Ð¾Ñ‰Ð½Ñ‹Ð¹ Ñ‚Ð¾Ð»Ñ‡Ð¾Ðº Ð¿Ð¾Ð´ÑŠÑ‘Ð¼Ñƒ ÑÐµÐ»ÑŒÑÐºÐ¾Ð³Ð¾ Ñ…Ð¾Ð·ÑÐ¹ÑÑ‚Ð²Ð°.&lt;/nowiki&gt;
|-
| [[:w:Windows-1251|Windows-1251]] || &lt;nowiki&gt;РЁРёСЂРѕРєР°СЏ СЌР»РµРєС‚СЂРёС„РёРєР°С†РёСЏ СЋР¶РЅС‹С… РіСѓР±РµСЂРЅРёР№ РґР°СЃС‚ РјРѕС‰РЅС‹Р№ С‚РѕР»С‡РѕРє РїРѕРґСЉС‘РјСѓ СЃРµР»СЊСЃРєРѕРіРѕ С…РѕР·СЏР№СЃС‚РІР°.&lt;/nowiki&gt;
|-
| [[:w:КОИ-8|KOI8-R]] || &lt;nowiki&gt;п╗п╦я─п╬п╨п╟я▐ я█п╩п╣п╨я┌я─п╦я└п╦п╨п╟я├п╦я▐ я▌п╤п╫я▀я┘ пЁя┐п╠п╣я─п╫п╦п╧ п╢п╟я│я┌ п╪п╬я┴п╫я▀п╧ я┌п╬п╩я┤п╬п╨ п©п╬п╢я┼я▒п╪я┐ я│п╣п╩я▄я│п╨п╬пЁп╬ я┘п╬п╥я▐п╧я│я┌п╡п╟.&lt;/nowiki&gt;
|-
| [[:w:ISO 8859-5|ISO 8859-5]] || &lt;nowiki&gt;аЈаИб�аОаКаАб� б�аЛаЕаКб�б�аИб�аИаКаАб�аИб� б�аЖаНб�б� аГб�аБаЕб�аНаИаЙ аДаАб�б� аМаОб�аНб�аЙ б�аОаЛб�аОаК аПаОаДб�б�аМб� б�аЕаЛб�б�аКаОаГаО б�аОаЗб�аЙб�б�аВаА.&lt;/nowiki&gt;
|-
| [[:w:Альтернативная кодировка|CP 866]] || &lt;nowiki&gt;╨и╨╕╤А╨╛╨║╨░╤П ╤Н╨╗╨╡╨║╤В╤А╨╕╤Д╨╕╨║╨░╤Ж╨╕╤П ╤О╨╢╨╜╤Л╤Е ╨│╤Г╨▒╨╡╤А╨╜╨╕╨╣ ╨┤╨░╤Б╤В ╨╝╨╛╤Й╨╜╤Л╨╣ ╤В╨╛╨╗╤З╨╛╨║ ╨┐╨╛╨┤╤К╤С╨╝╤Г ╤Б╨╡╨╗╤М╤Б╨║╨╛╨│╨╛ ╤Е╨╛╨╖╤П╨╣╤Б╤В╨▓╨░.&lt;/nowiki&gt;
|-
|rowspan=&quot;1&quot;| [[:w:UTF-16|UTF-16]]
| [[:w:Альтернативная кодировка|CP 866]] || &lt;nowiki&gt;(♦8♦@♦&gt;♦:♦0♦O♦  M♦;♦5♦:♦B♦@♦8♦D♦8♦:♦0♦F♦8♦O♦  N♦6♦=♦K♦E♦  3♦C♦1♦5♦@♦=♦8♦9♦  4♦0♦A♦B♦  &lt;♦&gt;♦I♦=♦K♦9♦  B♦&gt;♦;♦G♦&gt;♦:♦  ?♦&gt;♦4♦J♦Q♦&lt;♦C♦  A♦5♦;♦L♦A♦:♦&gt;♦3♦&gt;♦  E♦&gt;♦7♦O♦9♦A♦B♦2♦0♦. 
&lt;/nowiki&gt;
|}

== Перекодировка текстовых файлов ==
Перекодировка с целью восстановления исходного текста не всегда возможна. Например, уже при двукратной перекодировке, произошедшей, к примеру, при передаче сообщения через несколько неверно настроенных почтовых серверов, может произойти необратимая потеря информации, так как определённые различные символы исходного текста при определённых условиях могут замениться на другие, но одинаковые неправильные символы, и восстановить такое сообщение невозможно, даже если знать, какие перекодировки и в каком порядке были произведены.
=== Через командную строку===
Для восстановления текста (и для перекодировки) в POSIX-совместимых системах можно использовать утилиту iconv, например:
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
iconv -c -f cp1251 -t cp1252 source.txt &gt; target.txt
&lt;/syntaxhighlight&gt;
Утилита iconv также полезна при запуске в эмуляторах терминала, работающих под UTF-8 (например, mingw), программ, рассчитанных на работу в командной строке WINDOWS, если они выводят сообщения на русском. 
&lt;syntaxhighlight lang=&quot;bash&quot;&gt;
ping example.com | iconv -f cp1251
&lt;/syntaxhighlight&gt;
=== С помощью браузера ===
Можно открыть текстовый файл с неизвестной кодировкой с помощью любого популярного браузера, в котором доступно ручное указание кодировки (обычно: ''Вид — кодировка — …'' в верхнем меню, либо в контекстном меню). Позже, когда методом перебора удастся получить читаемый текст, его можно скопировать в текстовой редактор и сохранить в нужной кодировке. 
=== Специализированные утилиты ===
Существует множество утилит, позволяющих ручное (с выбором пары кодировок) или автоматическое (вплоть до нескольких уровней глубины) перекодирование текста, например, для Windows: TotalRecode или «Штирлиц».
=== Онлайн-сервисы ===
Среди онлайн-сервисов можно выделить декодер Артемия Лебедева, который пытается распознавать текст даже после многократной перекодировки.

== См. также ==
* [[Vim#Как открыть файл в нужной кодировке]]
== Примечания ==
{{примечания}}
[[Категория:Информационные технологии]]
[[Категория:Учебники без шаблона]]</text>
      <sha1>pgkjwqs95apsuou29ld8h0gca2unuh8</sha1>
    </revision>
  </page>
  <page>
    <title>Средства индивидуальной защиты (обзорная лекция)/Общая информация</title>
    <ns>0</ns>
    <id>35569</id>
    <revision>
      <id>270421</id>
      <parentid>269342</parentid>
      <timestamp>2026-10-27T07:04:55Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270421</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="31674" sha1="a9m154dxz8d4w2atith9nldad8mp0k1" xml:space="preserve">== Международная организация труда ==
По мнению специалистов [[:w:Международная организация труда |МОТ]] эффект от использования СИЗ зависит и от их качества, '''''и от того, насколько правильно они выбираются и применяются на практике'''''&lt;ref name=&quot;МОТ-4&quot; /&gt;&lt;ref name=&quot;ILO-4&quot; /&gt;. 

Поэтому во многих развитых странах разработаны не только минимальные требования к техническим характеристикам СИЗ, которые должны выполняться изготовителями и поставщиками, а выполнение должно проверяться при сертификации, но и требования к работодателю, чётко определяющие его действия при использовании индивидуальной защиты; выполнение таких требований (программ индивидуальной защиты&lt;ref name=&quot;МОТ-4&quot; /&gt;, например при [[:w:Программа защиты от шума|защите от шума]] и от [[:w:Законодательное регулирование выбора и организации применения респираторов|воздушных загрязнений]]) должно проверяется государственными и [[:w:ru:Профессиональный союз|профсоюзными]] инспекторами.

В развитых странах требования к СИЗ, и к их выбору и использованию, могут разрабатываться (в большей или меньшей степени) на основе результатов [[:w:Научное исследование|научных исследований]]. В разработке участвуют квалифицированные специалисты. Часть из них тесно связана и/или непосредственно работает в коммерческих организациях, торгующих СИЗ, что может приводить к потенциальному [[:w:Конфликт интересов |конфликту интересов]]. В других странах, не имеющих возможности проводить исследования, часто берут за основу стандарты США, ЕС и [[:w:ru:Международная организация по стандартизации |ИСО]], иногда другие иностранные стандарты. Если оригинал устарел, не соответствует современному уровню науки, или содержит ошибки - недостатки могут остаться не замеченными, и могут попадасть в национальный стандарт.

Для [[:w:СИЗОД|СИЗ органов дыхания]], часть которых может использоваться в опасной для жизни атмосфере, и [[:w:Средства индивидуальной защиты органа слуха |средств защиты от шума]], который очень часто достигает опасного уровня, и вызывает [[:w:Нейросенсорная тугоухость |необратимую и неизлечимую утрату слуха]], требования к техническим свойствам средств защиты и к их выбору и использованию разработаны в наиболее полной степени, и имеются во многих странах.

Также СИЗ могут оказывать вредное воздействие на работника&lt;ref name=&quot;МОТ-инструкция&quot; /&gt;, могут мешать работать и могут сами создавать опасность для жизни и здоровья&lt;ref name=&quot;Suruda-2003&quot; /&gt;&lt;ref name=&quot;Громов-1961&quot; /&gt;&lt;ref name=&quot;Денисов--2013&quot; /&gt;. Использование СИЗ может создавать ошибочное ощущение безопасности&lt;ref name=&quot;ILO-2001&quot; /&gt;.

== Международная организация по стандартизации и Европейский Союз ==
[[:w:Международная организация по стандартизации |ИСО]] провела большую работу по разработке стандартов, охвативших разные стороны индивидуальной защиты от воздушных загрязнений&lt;ref name=&quot;БТП-2021&quot; /&gt;, [[:w:Промышленный шум|шум]]а и другие. Многие из них приняты в Европейском Союзе и в РФ. Большая часть стандартов ИСО относится к техническим требованиям к СИЗ, и значительно меньшая - к их выбору и использованию; для некоторых видов СИЗ стандарты последнего типа отсутствуют.

В ЕС&lt;ref name=&quot;ЕС-директива-товар&quot; /&gt; с 2018 года установлены общие требования к стандартам, определяющим минимальные требования к техническим характеристикам СИЗ, к методам их испытаний, маркировке и др. ([[:w:Директива 89/686/ЕЭС|предыдущая версия]] действовала с 1989 года) Все стандарты, разработанные согласно Директиве, обязательны для выполнения, а работодатели обязаны выдавать работникам только сертифицированные СИЗ. Также принята Директива об обеспечении работников СИЗ&lt;ref name=&quot;ЕС-директива-рабочие&quot; /&gt;.

По требованиям к проверке СИЗ, все они делятся на три категории - простой, сложной и &quot;промежуточной&quot; конструкции. В зависимости от сложности установлена разная степень тщательности их испытаний.

== СССР и РФ ==
В СССР изготавливалось множество СИЗ&lt;ref name=&quot;СИЗОД-1977-1&quot; /&gt;. Ассортимент моделей был невелик, иностранные практически не применялись, что приводило к разным последствиям. Например, отсутствие разнообразия моделей противогазных фильтров позволяло экспериментально определить [[:w:Способы замены противогазных фильтров респираторов|срок службы]] и [[:w:b:ru:Замена_противогазных_фильтров_СИЗОД_(лекция)# расписание-СССР| указать его в каталоге для &lt;u&gt;'''всех'''&lt;/u&gt; моделей фильтров]], для разных концентраций десятков распространённых газов. Потребитель мог заменять фильтры без использования ненадёжной реакции органов чувств работника на появление вредного газа в маске, во многих случаях. С другой стороны, при несоответствии резиновой полумаски респиратора лицу не по размеру, а по форме - подобрать другую модель было невозможно вообще, т.к. практически все советские респираторы-полумаски использовали полумаску ПР-7. Качество изделий проверялось на государственных заводах-изготовителях, где были соответствующие подразделения. Отдельных органов по сертификации и отдельных лабораторий не было.

После 1991 года, до первой попытки вступить во [[:w:Всемирная торговая организация|Всемирную торговую организацию]], и до принятия закона &quot;О техническом регулировании&quot;&lt;ref name=&quot;184-ФЗ&quot; /&gt; в РФ следовали тенденции, сложившейся в СССР, и использовали ранее разработанные стандарты, требования которых были обязательными для выполнения.

{{anchor|СИЗ-РФ}}Приход на [[:w:ru:рынок|рынок]] иностранных компаний породил ряд проблем из-за отличий самого характера требований к СИЗ в СССР и в других странах. Например, в СССР был разработан респиратор-полумаска РПГ-67, а значительно &lt;u&gt;'''позднее'''&lt;/u&gt; к конструкции этой именно '''модели''' были разработаны требования в виде государственного стандарта на отдельную модель респиратора-полумаски&lt;ref name=&quot;РПГ-67&quot; /&gt;. А в развитых странах, для учёта того, что множество производителей изготавливает СИЗ разных моделей одного типа, были требования не к отдельным моделям, а к типу СИЗ, то есть были &quot;требования общего характера&quot;. В результате в РФ невозможно было испытать, сертифицировать, и соответственно - легально использовать для защиты работников иностранные СИЗ. Поэтому стали разрабатывать новые ГОСТы, &quot;гармонизированные&quot; с иностранными, с требованиями не к моделям СИЗ, а более общего характера, к определённым типам СИЗ, например - респираторам-полумаскам&lt;ref name=&quot;ГОСТ-190-99&quot; /&gt;. При разработке новых ГОСТов учли пожелания потребителей и разработчиков СИЗ&lt;ref name=&quot;Сорокин-2007-3&quot; /&gt;. За основу решили почему-то взять стандарты Европейского Союза, а не США или другой страны. Декларировалось, что российские поставщики смогут выйти на европейский [[:w:ru:рынок|рынок]], но это не произошло. При разработке новых стандартов, гармонизированных с европейскими, в них вносили изменения и допускали ошибки, что вызывало нарекания.

После принятия закона &quot;О техническом регулировании&quot;&lt;ref name=&quot;184-ФЗ&quot; /&gt; все стандарты, и новые, и советские, стали не обязательными для применения. Вместо этого был разработан и принят один документ по всем СИЗ - [https://miningwiki.ru/wiki/Технический_регламент_&quot;О_безопасности_СИЗ&quot;#Критика Технический регламент &quot;О безопасности средств индивидуальной защиты&quot;]. Множество недостатков документа вызвало шквал критики&lt;ref name=&quot;ПВ-2007-СИЗ&quot; /&gt;: в нем собрали требования к всем видам СИЗ, &quot;надёргав&quot; их из соответствующих ГОСТов, а требований к тому, как именно проверять, соответствует ли изделие требованиям - не было вообще. К некоторым СИЗ и требований не было, разработка Регламента велась с нарушением Закона &quot;О техническом регулировании&quot;&lt;ref name=&quot;ТР-2009&quot; /&gt;. Из-за огромного объёма документа его заполняли требованиями экономно: например, к СИЗ органа слуха от шума требований ослаблять шум - не было, требований к способности противогазных фильтров очищать воздух не было вообще, и т.п&lt;ref name=&quot;ТР-ТС&quot; /&gt;. Уже сам процесс разработки вызывал серьёзные критические замечания, т.к., потенциально, авторы могли учитывать коммерческие интересы отдельных поставщиков&lt;ref name=&quot;ТР-2009&quot; /&gt;.

Отчасти отреагировав на критику, спустя примерно 8 лет (2018 г.) [[:w:Евразийская экономическая комиссия |Евразийская экономическая коллегия]] опубликовала список стандартов, выполнение которых (на добровольной основе) обеспечивает выполнение Технического регламента (который уже обязателен для выполнения). Из-за крайне широкого охвата СИЗ в [https://miningwiki.ru/wiki/%D0%A2%D0%B5%D1%85%D0%BD%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B9_%D1%80%D0%B5%D0%B3%D0%BB%D0%B0%D0%BC%D0%B5%D0%BD%D1%82_%22%D0%9E_%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D0%B8_%D0%A1%D0%98%D0%97%22 Техническом регламенте], этот список получился очень объёмным - 158 страниц&lt;ref name=&quot;ТР-ТС+&quot; /&gt;. Для сравнения, в Европейском Союзе сами стандарты по СИЗ являются обязательными для выполнения.

В 2016 г. в РФ работало около 40 аккредитованных органов по сертификации и 50 лабораторий&lt;ref name=&quot;Преображенский-2016&quot; /&gt;. Но выдача &quot;липовых сертификатов&quot; продолжает оставаться обычным делом.

== Источники ==
{{примечания|refs=
&lt;ref name=&quot;МОТ-4&quot;&gt;{{Книга|ссылка=http://base.safework.ru/iloenc|ответственный =[https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры Ю.Г. Сорокин] &lt;small&gt;(''руководитель Департамента условий и охраны труда, Минтруд РФ'')&lt;/small&gt;; Жан-Виктор Груа &lt;small&gt;(''Директор Московского бюро МОТ'')&lt;/small&gt;|заглавие=Энциклопедия по безопасности и охране труда|год=2001|часть=[http://base.safework.ru/iloenc?d&amp;nd=857400340&amp;prevDoc=857400340&amp;spack=010LogLength%3D0%26LogNumDoc%3D857400038%26listid%3D010000000100%26listpos%3D0%26lsz%3D7%26nd%3D857400038%26nh%3D1%26 Современное состояние индивидуальных средств защиты]. В: Том 1; Раздел [http://base.safework.ru/iloenc?d&amp;nd=857400005&amp;prevDoc=857000002 IV], Глава [http://base.safework.ru/iloenc?d&amp;nd=857400038&amp;prevDoc=857400346 31. Средства индивидуальной защиты] |автор=Роберт Ф. Херрик (автор и редактор раздела СИЗ) |ссылка часть=|издание=4-е изд|место=Москва|издательство=Международная организация труда; Министерство труда и социального развития РФ|страницы= |страниц=1278|isbn=|серия= Охрана труда}}&lt;/ref&gt;
&lt;ref name=&quot;ILO-4&quot;&gt;''Robert F. Herrick''. [https://iloencyclopaedia.org/part-iv-66769/personal-protection-59388/item/686-overview-and-philosophy-of-personal-protection Overview and Philosophy of Personal Protection]. In: Vol. 1; [https://iloencyclopaedia.org/part-iv-66769/personal-protection-59388 Chapter 31. Personal Protection] // [https://iloencyclopaedia.org/ Encyclopedia of Occupational Health and Safety] / Michel Hansenne ed. — 4th ed. — Geneva: International Labour Office, 1998.&lt;/ref&gt;
 	
&lt;ref name=&quot;МОТ-инструкция&quot;&gt;{{Книга|ссылка=https://www.ilo.org/ru/publications/факторы-окружающей-среды-на-рабочем-месте-инструкция-международной|автор=Бюро Международной Организации Труда|заглавие=Факторы окружающей среды на рабочем месте. Инструкция МОТ|ответственный=ILO Publications, International Labour Office|год=2001|часть=3.3. Предотвращение и контроль|место=Женева|издательство=Международная Организация Труда|страницы=22—23|страниц=73|серия=Программа по безопасности труда, охране здоровья и окружающей среды - Безопасная Работа|isbn=92-2-111628-X}} [https://coht.ru/files/26_pr.pdf копия]&lt;/ref&gt;
&lt;ref name=&quot;Suruda-2003&quot;&gt;{{статья|автор= Anthony Suruda, William Milliken, Dale Stephenson &amp; Richard Sesek|заглавие=Fatal Injuries in the United States Involving Respirators, 1984-1995|ссылка= https://www.researchgate.net/publication/10856558_Fatal_Injuries_in_the_United_States_Involving_Respirators_1984-1995 |язык=en |издание=Applied Occupational and Environmental Hygiene |издательство=Taylor &amp; Francis |год=2003| volume=18|выпуск=4|pages=289-292| |doi= 10.1080/10473220301405}} ISSN 1521-0898, {{PMID|12637239}}. CDC [https://stacks.cdc.gov/view/cdc/186373/cdc_186373_DS1.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;Громов-1961&quot;&gt;{{статья|заглавие=Из практики расследования причин скоропостижной смерти шахтёров|ссылка=https://cyberleninka.ru/article/n/iz-praktiki-rassledovaniy-prichin-skoropostizhnoy-smerti-shahterov|автор=Громов А.П.|издание=Гигиена и санитария|место=Москва|издательство=Медицина|год=1961|номер=1| страницы=109—112|}} ISSN 0016-9900&lt;/ref&gt;

&lt;ref name=&quot;Денисов--2013&quot;&gt;{{статья|автор=Денисов Э.И., Морозова Т.В.|заглавие=Средства индивидуальной защиты от вредных производственных факторов|ссылка=http://ohrana-bgd.narod.ru/vvv/vvv3.html|издание=Жизнь без опасностей. Здоровье, профилактика, долголетие|издательство=Велт|год=2013|номер=1|страницы=40—45}} ISSN 1995-5317&lt;/ref&gt;
&lt;ref name=&quot;ЕС-директива-товар&quot;&gt;{{Статья|ссылка=https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=celex%3A32016R0425|автор=The European Parliament and the Council of the European Union|заглавие=Regulation (EU) 2016/425 of the European Parliament and of the Council of 9 March 2016 on personal protective equipment and repealing|год=2016| серия=Council Directive 89/686/EEC (OJ L 81, 31.3.2016, pp. 51–98)|язык=en|издание=Official Journal of the European Union|тип=журнал|месяц=3|число=31|выпуск=L 81 (series L – Legislation)|автор издания= European Union |pages=L 81/51 - L 81/98| |volume=59}} ISSN 1977-0677. С 1989 по 2018 гг. действовала [[:w:ru:Директива 89/686/ЕЭС|предыдущая версия Директивы]].&lt;/ref&gt;
&lt;ref name=&quot;ЕС-директива-рабочие&quot;&gt;{{Статья |ссылка=https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A01989L0656-20191120 |автор=The Council of the European Communities |заглавие=Council Directive of 30 November 1989 on the minimum health and safety requirements for the use by workers of personal protective equipment at the workplace (third individual directive within the meaning of Article 16 (1) of Directive 89/391/EEC) (89/656/EEC) |год=1989 (amend. 2007) |язык=en |автор издания=European Union |место=EU |издание=Official Journal of the European Union |тип=журнал |месяц=12 |число=30 |выпуск=L 393 (series L – Legislation) |pages=L 393 / 18 - L 393 / 28 |volume=32 }} ISSN 0378-6978. old [https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=OJ:L:1989:183:FULL PDF] [https://meganorm.ru/mega_doc/dop_norm/52/gost_r_70231-2022_natsionalnyy_standart_rossiyskoy/0/direktiva_N_89_656_ees_soveta_evropeyskikh_soobshchestv_o.html?ysclid=moec7pwxxz657959550 перевод]&lt;/ref&gt;


&lt;ref name=&quot;СИЗОД-1977-1&quot;&gt;{{Книга|автор= И.Н. Никифоров|заглавие=Проблемы разработки и испытания средств индивидуальной защиты органов дыхания|ответственный=И.Н. Никифоров, С.Л. Каминский (ред.)|год=1977|часть= Средства индивидуальной защиты органов дыхания и задачи их совершенствования. В: Раздел 1. Перспективы создания и использования средств индивидуальной защиты органов дыхания|место=Москва|издательство=Всесоюзный центральный научно-исследовательский институт охраны труда ВЦСПС|страницы= 7-12|страниц=72|тираж=1000|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1731316690&amp;archive=&amp;start_from=&amp;ucat=&amp;}}&lt;/ref&gt;
&lt;ref name=&quot;184-ФЗ&quot;&gt;{{Книга|ссылка=http://cntr-nrs.gosnadzor.ru/about/AKTS/О%20техническом%20регулировании%20(с%20изменениями%20на%202%20июля%202021%20года)%20(редакция,%20действующая%20с%2023%20декабря..._Текст.pdf|заглавие=Федеральный закон &quot;О техническом регулировании&quot; № 184-ФЗ от 27 декабря 2002 года|ответственный=В.Путин|год=2002|место=Москва|страниц=52|серия=редакция, действующая с 23 декабря 2021 года}}&lt;/ref&gt;
&lt;ref name=&quot;РПГ-67&quot;&gt;{{Книга|ссылка=https://ohranatruda.ru/upload/iblock/bc7/4294839027.pdf|автор=Группа Л07|заглавие=ГОСТ 12.4.004-74 Респираторы фильтрующие противогазовые РПГ-67|год=1974|место=Москва|страниц=7|серия=Межгосударственный стандарт}}&lt;/ref&gt;

&lt;ref name=&quot;ГОСТ-190-99&quot;&gt;{{Книга|ссылка=https://meganorm.ru/Index2/1/4294820/4294820432.htm|автор=Рабочая группа ПК 2 «Средства индивидуальной защиты органов дыхания» (в ТК 320 СИЗ)|заглавие=ГОСТ Р 12.4.190-99. ССБТ. СИЗОД. Полумаски и четвертьмаски из изолирующих материалов. Общие технические условия|ответственный=(аналог EN 140-89)|год=2000|место=Москва|издательство=Госстандарт России|страниц=24|тираж=585}} [https://meganorm.ru/Data2/1/4294820/4294820432.pdf PDF]&lt;/ref&gt;

&lt;ref name=&quot;ILO-2001&quot;&gt;{{Книга|ссылка=https://www.ilo.org/resource/ambient-factors-workplace|автор=Ivone Baumecker et al.|заглавие=Ambient factors in the workplace|год=2001  |часть=3.3. Prevention and control|язык=en|место=Geneva|издательство=International Labour Organization|pages=14-15|allpages=80|серия=ILO codes of practice|isbn=92-2-111628-X}} [https://www.ilo.org/fr/resource/les-facteurs-ambiants-sur-le-lieu-de-travail Les facteurs ambiants sur le lieu de travail. Recueil de directives pratiques du BIT [https://www.ilo.org/es/resource/factores-ambientales-en-el-lugar-de-trabajo Factores ambientales en el lugar de trabajo. Repertorio de recomendaciones practicas de la OIT]&lt;/ref&gt;
&lt;ref name=&quot;БТП-2021&quot;&gt;{{Статья|автор=[[:w:ru:Капцов, Валерий Александрович|В.А. Капцов]], В.Б. Панкова, А.В. Чиркин|заглавие=Международные стандарты по индивидуальной защите органов дыхания (обзор)|ссылка=https://elibrary.ru/item.asp?id=49432018 |год=2021|издание=Безопасность труда в промышленности|месяц=3|номер=3|страницы=70-75|автор издания=Федеральная служба по экологическому, технологическому и атомному надзору (РОСТЕХНАДЗОР); Закрытое акционерное общество «Научно-технический центр исследований проблем промышленной безопасности» (ЗАО НТЦ ПБ)|место=Москва|издательство=ЗАО &quot;Алмаз-Пресс&quot;}} ISSN 0409-2961&lt;/ref&gt;


&lt;ref name=&quot;Сорокин-2007-3&quot;&gt;{{Книга|автор=Пашнин Н.П., Сорокина Т.Ю.|заглавие=Средства индивидуальной защиты. Учебное пособие|ответственный=Президент АСИЗ [https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры Ю.Г. Сорокин], А.Л. Сафонов|год=2007|часть=4. Подтверждение соответствия, стандартизация и сертификация СИЗ. В: I. Общие положения по вопросам обеспечения работающих средствами индивидуальной защиты|издание=3 изд|место=Москва|издательство=&quot;Золотой телёнок&quot;, Минздравсоцразвития РФ|страницы=24, 31|страниц=288|серия=Охрана труда|isbn=978-5-88257-099-5|тираж=10 000}} ''&quot;... Федеральной инспекцией труда проведено более 1,5 тыс. проверок соблюдения требований ст. 221 Трудового кодекса РФ по вопросам обеспечения работников средствами индивидуальной защиты, в ходе которых выявлено свыше 31,2 тыс. нарушений. ... Наиболее характерными  ... нарушениями в этой сфере явилось приобретение организациями несертифицированных СИЗ.&quot;''&lt;/ref&gt;
&lt;ref name=&quot;ТР-ТС&quot;&gt;{{Книга|ссылка=https://www.novotest.ru/tr-ts/019-2011/tr-ts-019-2011.pdf|автор=Российская Федерация (Министерство здравоохранения и социального развития)|заглавие=Технический Регламент Таможенного Союза ТР ТС 019/2011 О безопасности средств индивидуальной защиты|ответственный=утв. Решением Комиссии Таможенного Cоюза от 9 декабря 2011 г. N 878|год=2011|место=Москва|страниц=167}}&lt;/ref&gt;
&lt;ref name=&quot;ПВ-2007-СИЗ&quot;&gt;{{Статья |ссылка= https://web.archive.org/web/20241104211022/https://promved.ru/articles/article.phtml?id=1248&amp;nomer=45 |автор=Тимофеева Н.Т., Богданов С.А. |заглавие= Промышленные средства индивидуальной защиты. Нормировать необходимо их качество, а не только безопасность для человека |год=2007 |ответственный=редактор Моисей Гельман |автор издания=Экспертное некоммерческое партнерство |место=Москва |издание=Промышленные ведомости: экспертная общероссийская газета |месяц=8-9 |номер=8-9}}&lt;/ref&gt;
&lt;ref name=&quot;ТР-2009&quot;&gt;{{Статья|автор=А. Лянг|заглавие=Требуются публичные обсуждения|год=2009|автор издания=Общество с ограниченной ответственностью ТехНадзор|место=Екатеринбург|издание=[https://www.elibrary.ru/contents.asp?titleid=51310 Технадзор]|месяц=7|номер=7 (32)|страницы=84-85}}&lt;/ref&gt;
&lt;ref name=&quot;ТР-ТС+&quot;&gt;''Евразийская экономическая комиссия, председатель Т. Саркисян.'' [https://docs.eaeunion.org/ru-ru/Pages/DisplayDocument.aspx?s=e1f13d1d-5914-465c-835f-2aa3762eddda&amp;w=9260b414-defe-45cc-88a3-eb5c73238076&amp;l=8a412e96-924f-4b3c-8321-0d5e767e5f91&amp;EntityID=17116 Решение № 37 Евразийской экономической комиссии &quot;О внесении изменений в Решение Комиссии Таможенного союза от 9 декабря 2011 г. № 878&quot;]. ''www.eurasiancommission.org''. Москва: Евразийская экономическая комиссия (6 марта 2018).&lt;/ref&gt;
&lt;ref name=&quot;Преображенский-2016&quot;&gt;{{статья|автор=Преображенский В.Б. (АСИЗ)|заглавие=Особенности российского рынка СИЗ |издание=Справочник специалиста по охране труда|место=Москва|издательство=МЦФР|год=2016|номер=3|страницы=68-75|}} ISSN 1727-6608&lt;/ref&gt;
}}</text>
      <sha1>a9m154dxz8d4w2atith9nldad8mp0k1</sha1>
    </revision>
  </page>
  <page>
    <title>Средства индивидуальной защиты (обзорная лекция)/Важнейшие свойства СИЗ</title>
    <ns>0</ns>
    <id>35570</id>
    <revision>
      <id>270418</id>
      <parentid>270021</parentid>
      <timestamp>2026-10-27T07:02:53Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270418</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="55944" sha1="37z541zgky2yc4x4asjec6svapjvibt" xml:space="preserve">По сравнению со всеми другими средствами защиты, у СИЗ есть важные особенности:
# '''Исключительная, уникальная универсальность'''. Например, для защиты от шума и пыли одни и те же респираторы и наушники могут использоваться и шахтёром, добывающим уголь на глубине более километра, и медицинским работником при лечении его коллег, больных силикотуберкулёзом.
# '''Низкая стоимость и простота применения''' (по сравнению со [[:w:средства коллективной защиты |средствами коллективной защиты]]). Например, расходы на закупку [[:w:Респираторы ШБ Лепесток#Эффективность респиратора ШБ-1 «Лепесток»|респираторов Лепесток-200]] с высокой декларируемой эффективностью для всех работников цеха могут быть многократно меньше стоимости одной лишь электроэнергии, израсходованной двигателями обеспыливающей [[:w:Вентиляция |вентиляционной системы]] того же цеха за одну смену&lt;ref name=&quot;ОТиСС-2016&quot; /&gt;. Проектирование, изготовление, установка, пусконаладочные работы, и техническое обслуживание [[:w:Вентиляция |обеспыливающего вентиляционного оборудования]] требует не только затрат средств, но и достаточно высокой [[:w:Компетентность|компетентности]] исполнителей. Закупка и раздача работникам ([[:s:Требования к выбору эффективных респираторов и к организации их применения#1910.134(k)|без их обучения]]) [[:w:Респираторы ШБ Лепесток#Декларируемая эффективность |высокоэффективных респираторов]] может выполняться кем угодно, и без какой-то [[:s:Требования к выбору эффективных респираторов и к организации их применения#1910.134(k)|подготовки]] и опыта в отношении индивидуальной защиты органов дыхания (по каталогу поставщика). В РФ, в отличие от развитых стран, специалистов по охране труда обычно не учат выбору и организации применения СИЗ.
# [[File:NIOSH наушники ru.jpg|thumb|right|240px|Стандартные чашки [[:w:Защитные наушники| наушников]] 65×41 мм, и уши разных размеров&lt;ref name=&quot;Уши-1968&quot; /&gt; ]]'''Учёт индивидуальных особенностей рабочих'''. [[:w:Спецодежда |Спецодежду]] и [[:w:спецобувь |спецобувь]] подбирают по размеру и форме тела. В отличие от спецодежды для многих СИЗ это не очевидно. Начальники и снабженцы по личному опыту знают про подбор одежды и обуви, но вряд ли они (и даже рабочие) хорошо знают это о СИЗ. Респиратор-полумаска, соответствующая лицу по размеру, может не соответствовать ему по форме; но и при полном соответствии может неплотно прилегать к &quot;гладкому&quot; лицу, например, из-за отсутствия части зубов (прижимающих изнутри щеку к обтюратору маски), и [[Применение респираторов в промышленности#D. Особенности лица |по другим причинам]]. В результате между маской и лицом могут образовываться зазоры, через которые в органы дыхания будет поступать загрязнённый окружающий воздух. На выбор СИЗ органов слуха, вкладышей, влияют размер и форма слуховых каналов (Ø 3÷14 мм, поперечное сечение от эллиптического до щелевидного&lt;ref name=Sataloff-1993&gt;{{Книга|ссылка=https://archive.org/details/occupationalhear0000sata|автор=Joseph Sataloff, Paul L. Michael, Lawrence A. Vassalio|заглавие=Occupational Hearing Loss|год=1993|часть=Protector Types (Ear Canals and Earplugs)|язык=en|издание=2nd., rev. and expanded|место=New York, Basel, Hong Kong|издательство=Marcel Dekker, Inc|pages=418|allpages=839|серия=Occupational Safety and Health|isbn=0-8247-8814-1}}&lt;/ref&gt;), у [[:w:Защитные наушники |наушников]] - размер ушей (см. рис.). В развитых странах [[:w:Проверка изолирующих свойств респираторов |закон требует проверять маски]] приборами, у каждого работника, а [[:w:Производственный контроль эффективности СИЗОС |аналогичные проверки противошумов]] пока выполняются ответственными [[:w:ru:Работодатель|работодателями]] добровольно&lt;ref name=&quot;AIHA-2018&quot; /&gt;.
# [[File:Сорокин-2.jpg|thumb|220px|Чиновник [[:w:ru:Министерство труда и социальной защиты Российской Федерации|Минтруда]] и одновременно [https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры глава АСИЗ]&lt;ref name=&quot;СИЗ-2005&quot; /&gt;.]] '''Государственная поддержка'''. В РФ всё связанное с регулированием, разработкой, выпуском, импортом, сертификацией, продажей и использованием СИЗ находятся [[:w:ru:Лоббизм в России |под сильным влиянием]] созданной в 2001 году при поддержке [[:w:Министерство труда и социальной защиты Российской Федерации |Минтруда РФ]] &quot;[[:w:Лоббизм_в_России#АСИЗ|Ассоциации разработчиков, изготовителей и поставщиков средств индивидуальной защиты]]&quot;. Много лет её возглавлял [https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры |Ю.Г. Сорокин]], руководитель Департамента условий и охраны труда ([[:w:ru:Министерство труда и социальной защиты Российской Федерации|Минтруда]]), и сначала он руководил [https://miningwiki.ru/wiki/Ассоциация_СИЗ АСИЗ] и Департаментом одновременно&lt;ref name=&quot;СИЗ-2005&quot; /&gt;. Потом к нему присоединился начальник отдела политики охраны труда Департамента В. Б. Преображенский. При проверках инспектора [[:w:Роструд|Роструд]]а (Минтруд) уделяют больше внимания выдаче СИЗ, а не улучшению условий труда&lt;ref name=&quot;Роструд-доклад-14&quot; /&gt;&lt;ref name=&quot;Роструд-доклад-17&quot; /&gt;.
# '''Слишком частое использование.''' Существуют [[:w:Ранжирование методов защиты от вредных производственных факторов |разные способы защиты]] от опасных и [[:w:ru:Вредный производственный фактор |вредных производственных факторов]], но в пост-советский период сформировался сильный &quot;перекос&quot;: в условиях крайне низкой ответственности за сбережение жизни и здоровья рабочих&lt;ref name=&quot;ОТС-2016&quot; /&gt;&lt;ref name=&quot;волк&quot; /&gt; (для сравнения см.&lt;ref name=&quot;Басов-1974&quot; /&gt;) [[:w:ru:Работодатель|работодатели]] предпочитают использовать дешёвые и простые СИЗ&lt;ref name=&quot;Беляков-06-2015&quot; /&gt;. Например, [[:w:Социальный фонд России |Фонд социального страхования (ФСС), Социальный фонд]] разрешает [[:w:ru:работодатель|работодателям]] использовать часть страховых отчислений в фонд для профилактики страховых случаев (утраты [[:w:трудоспособность|трудоспособности]]). Обычно стоимость СИЗ гораздо меньше, чем [[:w:средства коллективной защиты |средств коллективной защиты]]. В 2021 году работодатели потратили (из средств фонда) на закупку СИЗ примерно в 240 раз больше денег, чем на улучшение условий труда&lt;ref name=&quot;ФСС-2022&quot; /&gt;.
# '''Неопределённость, нестабильность и неизвестность фактической степени защиты рабочих'''. При использовании [[:w:средства коллективной защиты |средств коллективной защиты]] можно определить условия труда на [[:w:ru:Рабочее место|рабочем месте]], измерить воздействие [[:w:ru:Вредный производственный фактор |вредных производственных факторов]] и оценить степень их опасности. А при использовании некоторых СИЗ невозможно сказать, насколько хорошо или плохо защищён '''конкретный работник'''. Например, при проведении трудоёмких и дорогостоящих научных исследований [[:w:Производственные испытания респираторов |для определения коэффициентов защиты СИЗОД]] велика погрешность измерений т. н. &quot;средней&quot; концентрации вредных веществ во вдыхаемом воздухе&lt;ref name=&quot;Капцов-2016&quot; /&gt;. Но большинство работодателей и эти замеры провести не сможет. При использовании СИЗ органов слуха, вкладышей из пористых сжимаемых материалов, по мнению специалиста Р. Хоуи&lt;ref name=&quot;Howie-2&quot; /&gt;: &quot;... Следует считать, что работник не защищён &lt;small&gt;''(от шума)''&lt;/small&gt; вообще, пока [[:w:Производственный контроль эффективности СИЗОС |замеры на рабочем месте]] не покажут иное&quot;&lt;ref name=&quot;Howie-1&quot; /&gt;. Большинство разнообразных методов сертификационного тестирования одежды, защищающей от химических веществ, не даёт никакого представления о степени и длительности защиты в производственных условиях на практике&lt;ref name=&quot;ХимЗащОдежда-2017&quot; /&gt;. Использование реакции работника на [[:w:Обоняние|появление запаха]] ядовитого газа в маске противогаза для [[:w:Способы замены противогазных фильтров респираторов |замены фильтров]] - ненадёжно, и потому запрещено во всех развитых странах. В РФ поставщики СИЗОД никаких других способов потребителям не дают. Неопределённость в отношении того, произойдёт ли десорбция токсичных газов при повторном использовании фильтров побудила ограничивать их использование&lt;ref name=&quot;Капцов-2022&quot; /&gt;, в РФ наличие проблемы замалчивается. Низкая / высокая температура (интенсивное тепловое излучение), коррозионно-активная атмосфера могут ухудшить защиту и даже разрушить СИЗ&lt;ref name=&quot;Сорокин-2007-5&quot; /&gt;. СИЗОД могут вызвать воспламенение во [[:w:Взрывозащита|взрывоопасной атмосфере]].
# '''Возможная ложная иллюзия защиты.''' Работодатели выдают работникам сертифицированные СИЗ, показавшие своё соответствовие действующим требованиям при сертификации и испытаниях по разработанным специалистами методам (стандартам) в [[:w:Аккредитация|аккредитованных]] лабораториях. Соответственно, недостаточно компетентные работодатели, рабочие и даже специалисты по гигиене и охране труда могут ошибочно полагать, что использование таких СИЗ обеспечивает защиту рабочих. Но эффективность СИЗ на практике может быть совершенно иной, и недостаточная информированность работающих на производстве (плюс замалчивание поставщиками наличия серьёзных проблем) ''может даже увеличивать опасность''&lt;ref name=&quot;Денисов-2013&quot; /&gt;&lt;ref name=&quot;CCOHS-2025&quot; /&gt;. Например, в&lt;ref name=&quot;Suruda-2003&quot; /&gt; упомянуты случаи, когда три работника использовали противогазы, а маски [[:w:Способы проверки изолирующих свойств респираторов|неплотно прилегали к лицам]], а ещё двое полагались на фильтрующие СИЗОД при работе в [[:w:Концентрация вредных веществ, мгновенно-опасная для жизни или здоровья|опасной атмосфере с недостатком кислорода]]. При высококачественных подготовке, обучении и тренировке работников, ''а также при отсутствии СИЗ'' они бы остались живы.
# '''Негативное влияние на работника и его работоспособность'''. Применение разных СИЗ, а также более чем одного средства защиты, может привести к воздействию на работника разных неблагоприятных факторов: повышение сопротивления дыханию; уменьшение подвижности; давление на голову; ухудшение газообмена при дыхании; уменьшение [[:w:Поле зрения|поля зрения]]; ухудшение восприятия акустической информации; перегрев из-за ухудшения теплоотдачи метаболического тепла в окружающую среду и другие&lt;ref name=&quot;Буянов-1974&quot; /&gt;&lt;ref name=&quot;Полоний-1980&quot; /&gt;. СИЗ органов дыхания и слуха могут мешать общению, что снижает [[:w:производительность труда]] и увеличивает количество ошибок&lt;ref name=&quot;ГОЧС-7-2006&quot; /&gt;. В условиях [[:w:Сдельная система оплаты труда|сдельной оплаты труда]] (и других часто используемых схожих способов стимулирования) это мотивирует рабочих не использовать СИЗ своевременно. В зависимости от температуры окружающего воздуха, применение СИЗ ухудшает работоспособность, для оценки которой могут использоваться разные показатели (мышечная сила, статическая выносливость, способность к динамической работе, способность к тонкой координации движений, биоэлектрическая активность мышц (показатель утомления), потребление кислорода)&lt;ref name=&quot;Буянов-2001-&quot; /&gt;. На основе изучения негативного влияния СИЗ рекомендовали относить работу, требующую применения респиратора, к более тяжёлой категории&lt;ref name=&quot;Буянов-1974&quot; /&gt;. Ухудшение физиологического состояния организма могло приводить к тому, что люди срывали с себя противогаз. Даже лёгкие фильтрующие полумаски (10-15 грамм) задерживают у лица непригодный для дыхания воздух при выдохе, заставляя вдыхать его повторно. Из-за этого концентрация вредного вещества, [[:w:Диоксид углерода |углекислого газа]], может превышать 4%&lt;ref name=&quot;Sinkule-2013&quot; /&gt; при [[:w:ПДКр.з.|максимально разовой ПДК]] 1,4% (27 г/м&lt;sup&gt;3&lt;/sup&gt;&lt;ref name=&quot;ГН-2-2-5-3532-18&quot; /&gt;).
# '''Низкая профилактическая эффективность'''. Опыт показал, что выдача СИЗ - наихудший и самый неэффективный способ сберечь жизнь и предотвратить ухудшение здоровье рабочих по сравнению с [[:w:Ранжирование методов защиты от вредных производственных факторов |любым другим способом]]. СИЗ должны использоваться лишь когда [[:w:средства коллективной защиты |средства коллективной защиты]] оказались недостаточно эффективны&lt;ref name=&quot;ACGIH-28&quot; /&gt;. В Конвенции 148&lt;ref name=&quot;Конвенция148&quot; /&gt; [[:w:Международная организация труда |Международной организации труда]], ратифицированной РФ, статьи 9 и 10 прямо и однозначно требуют в первую очередь улучшать [[:w:Гигиенические нормирование#Классы (подклассы) труда|условия труда]], и использовать СИЗ лишь при невозможности снизить вредное воздействие до допустимого. Из-за неэффективной политики [[:w:ru:Министерство труда и социальной защиты Российской Федерации|Минтруда]] доля [[:w:ru:Рабочее место|рабочих мест]] с вредными и опасными условиями труда за 1996-2014 гг. выросла с 17 до 39,7% ([[:w:Федеральная служба государственной статистики |Росстат]]&lt;ref name=&quot;Росстат-2016&quot; /&gt;). Рост доли рабочих мест с опасными для здоровья условиями труда привёл к тому, что, по данным [[:w:Измеров, Николай Федотович |академика Н. Ф. Измерова]]&lt;ref name=&quot;Измеров-2008&quot;&gt;{{Книга|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1771522810&amp;archive=&amp;start_from=&amp;ucat=&amp; |автор=Измеров Н.Ф.|часть= Перспективные пути реализации охраны здоровья работающего населения в ближайшее десятилетие|заглавие= Материалы III Всероссийского съезда врачей-профпатологов |издание= 24-26 сентября 2008 |ответственный= [[:w:Измеров, Николай Федотович|Измеров Н.Ф.]] и др. отв. ред.|год=2008|место= Новосибирск |издательство= Югус-Принт|isbn=5-87545-113-1 |страницы= 8-21 |страниц=596|тираж=1000}} [https://ohranatruda.ru/fond/fail_obmen/106/617058/ копия]&lt;/ref&gt; и [[:w:Медведев, Дмитрий Анатольевич |Д. Медведева]]&lt;ref name=&quot;ПЗ-2007&quot; /&gt; уже в 2007 году ежегодно умирало около 190 тыс. человек - хотя продажа СИЗ в 2001-2017 гг. выросла в 7 раз&lt;ref name=&quot;Сорокин-2018&quot; /&gt;.

При использовании СИЗ для защиты от токсичных химических и/или [[:w:Радиоактивный распад|радиоактивных веществ]], в газообразном состоянии и/или в виде аэрозолей, и от опасных микроорганизмов, недостаточное внимание к [[:w:ru:Дегазация (оружие)|дегазации]], обеспыливанию, [[:w:ru:Дезинфекция|дезинфекции]], [[:w:ru:Дезактивация|дезактивации]], может сделать СИЗ переносчиком загрязнений в чистые места, вторичным источником опасного загрязнения воздуха и помещений&lt;ref name=&quot;Щербаков-1976&quot; /&gt;.
{| class=&quot;wikitable collapsible collapsed&quot; style=&quot;text-align:center&quot;
! colspan=&quot;9&quot; | Эргономическая характеристика СИЗ&lt;ref name=&quot;Каминский2020&quot;&gt;{{Книга |автор=Каминский С.Л. |заглавие=Средства индивидуальной защиты в охране труда |ответственный=рецензенты проф. Русак О.Н., Гендлер С.Г. |год=2020 |часть=Глава 2. Эргономическая характеристика СИЗ |издание=2-е изд. |место =Санкт-Петербург |издательство=Проспект Науки |страницы=29 |всего страниц=304 |isbn=978-5-903090-48-8 |тираж=300}}&lt;/ref&gt;
|-
! Воздействие СИЗ на !! изолирующие костюмы !! СИЗОД !! спецодежда !! спецобувь !! СИЗ рук !! СИЗ головы !! СИЗ лица и глаз !! противошумы
|-
| дыхание || сопротивление дыханию, подача воздуха, концентрация СО&lt;sub&gt;2&lt;/sub&gt; || сопротивление дыханию, концентрация СО&lt;sub&gt;2&lt;/sub&gt; || — || — || — || — || — || —
|-
| терморегуляцию || colspan=&quot;3&quot; | температура тела, кожи; теплосодержание; частота сердечных сокращений; потоотделение || температура кожи ступней || температура кожи рук || водопоглощение || — || —
|-
| работу мышц || масса, ограничение подвижности, работоспособность || масса, ограничение подвижности, давление на лицо, работоспособность || масса, ограничение подвижности, работоспособность || масса || масса ||   colspan=&quot;3&quot; | масса, давление
|-
| восприятие и общение || поле и острота зрения, заглушение звуков || поле и острота зрения, заглушение звуков || — || — || чувствительность рук || поле зрения || поле и острота зрения || заглушение звуков
|}
== Источники ==
{{примечания|refs=
&lt;ref name=&quot;ОТиСС-2016&quot;&gt;{{статья|автор=[[:w:ru:Капцов, Валерий Александрович|В. Капцов]], А. Филин|заглавие=СИЗ - не панацея|ссылка= http://www.otiss.ru/links/arhiv_otiss_2016.html|автор издания=Группа изданий «Охрана труда и социальное страхование»|издание=Охрана труда и социальное страхование|место=Москва|год=2016|номер=8|страницы=74—79}} ISSN 0131-2618&lt;/ref&gt;
&lt;ref name=&quot;Уши-1968&quot;&gt;{{Книга|ссылка= https://archive.org/details/DTIC_AD0670869 |автор=Milton Alexander, Lloyd L. Laubach|заглавие=Anthropometry of the human ear. A photogrammetric study of USAF flight personnel|год=1968|язык=en|место=Wright-Patterson Air Forse Base, Ohio|издательство=Aerospace Medical Research Laboratories|allpages=38|серия=AMRL-TR-67-203}}&lt;/ref&gt;
&lt;ref name=&quot;AIHA-2018&quot;&gt;{{Книга|ссылка=https://www.aiha.org/education/marketplace/noise-manual-6th-edition|автор=Elliott H. Berger &amp; Jérémie Voix|часть=Chapter 11. Hearing Protection Devices|заглавие=The Noise Manual|издание=6th ed|ответственный=D.K. Meinke, E.H. Berger, R. Neitzel, D.P. Driscoll &amp; K. Bright eds|год=2020|язык=en|место=Falls Church|издательство=American Industrial Hygiene Association|ссылка часть=https://online-ams.aiha.org/amsssa/ecssashop.show_product_detail?p_mode=detail&amp;p_product_serno=2719|страницы=257|страниц=621}}&lt;/ref&gt;
&lt;ref name=&quot;ОТС-2016&quot;&gt;{{Статья|автор=Елена Медынцева|заглавие=За смерть строителя никто не платит и никто не отвечает|ссылка=http://ancb.ru/publication/read/2247|издание=Охрана труда и техника безопасности в строительстве|год=2016|месяц=4|номер=4|страницы=32—34|автор издания=ИД &quot;Панорама&quot;|место=Москва|издательство=Стройиздат|archivedate=2019-08-30|archiveurl=https://web.archive.org/web/20190830104233/http://ancb.ru/publication/read/2247}} ISSN 2074-8795 (первая публикация в: «Агентство Новостей „Строительный Бизнес“») Цитата: &quot;... иногда инспекторы договариваются со следователями – и несчастный случай просто исчезает ... судьи в принципе не понимают, как нужно разбирать эти дела в условиях  изменившегося законодательства ... есть уже 9 случаев, когда пострадавшие отказывались судиться с застройщиком  - боялись потерять работу ...  истцы очень часто просят выплатить компенсацию, но не просят выплатить ущерб от утраты работоспособности  - зачастую просто не знают об этом ...&quot;  &lt;/ref&gt;
&lt;ref name=&quot;волк&quot;&gt;{{Статья|автор=Рябов А.А.|заглавие=Юлия Волк: &quot;Под контролем женщины порядка больше&quot;|ссылка=https://www.btpnadzor.ru/archive/yuliya-volk-pod-kontrolem-zhenshchiny-poryadka-bolshe|язык=ru|издание=Безопасность труда в промышленности|год=2010|месяц=март|число=1|номер=3|страницы=12-15|автор издания=Федеральная служба по экологическому, технологическому и атомному надзору (РОСТЕХНАДЗОР); Закрытое акционерное общество «Научно-технический центр исследований проблем промышленной безопасности» (ЗАО НТЦ ПБ)|место=Москва|издательство=ЗАО &quot;Алмаз-Пресс&quot;}} ISSN 0409-2961 [https://www.elibrary.ru/item.asp?id=13081135 PDF] Цитата: &quot;... Что это за наказание? На предприятии иной нарушитель смеётся над нашим наказанием. Говорит: дайте мне десять квитанций, а сразу же весь штраф вперёд оплачу, и буду делать по-своему! Тут даже суд бессилен. ... В каком случае возможна дисквалификация? Она отвечает: &quot;Ну, для этого надо похоронить не меньше пяти-семи человек!&quot; ... &quot;  &lt;/ref&gt;
&lt;ref name=&quot;Басов-1974&quot;&gt;{{статья|автор=|заглавие= Всё зависит от нас самих|автор издания=Государственный Комитет по надзору за безопасным ведением работ в промышленности и горному надзору при Совете Министров СССР|издание=Безопасность труда в промышленности|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1753284441&amp;archive=&amp;start_from=&amp;ucat=&amp; |место=Москва|издательство=|год=1974|номер=9|страницы=7-11}} ISSN 0409-2961&lt;/ref&gt;
&lt;ref name=&quot;Беляков-06-2015&quot;&gt;{{статья|автор=Беляков Г.И., Юлкин Е.С.|заглавие=Специальную оценку условий труда пора корректировать|ссылка=https://www.elibrary.ru/item.asp?id=23636794 |язык=ru|автор издания=Федеральная служба по экологическому, технологическому и атомному надзору (РОСТЕХНАДЗОР); Закрытое акционерное общество «Научно-технический центр исследований проблем промышленной безопасности» (ЗАО НТЦ ПБ)|издание=Безопасность труда в промышленности|место=Москва|издательство=ЗАО &quot;Алмаз-Пресс&quot;|год=2015|номер=6|страницы=55—59}} ISSN 0409-2961&lt;/ref&gt;
&lt;ref name=&quot;ФСС-2022&quot;&gt;{{Книга|ссылка=https://sfr.gov.ru/files/id/press_center/godovoi_otchet/fss/FSS_annual_report_2021.pdf|автор=ФСС|заглавие=Отчёт Фонда Социального Страхования Российской Федерации за 2021 год|год=2022|часть=Структура предупредительных мер по сокращению производственного травматизма и профзаболеваний (по статьям расходов) за 2021 год (в млн. руб.)|место=Москва|издательство=ФСС|страницы=13|страниц=31|серия=Социальное страхование: практика и ориентиры развития}}&lt;/ref&gt;
&lt;ref name=&quot;Росстат-2016&quot;&gt;''Росстат.'' Социально-экономические показатели Российской Федерации в 1991-2016 гг. (1,2 Мб). ''www.gks.ru'' (2017). Дата обращения: 16 сентября 2018. [https://web.archive.org/web/20180916201927/http://www.gks.ru/wps/wcm/connect/rosstat_main/rosstat/ru/statistics/publications/catalog/doc_1270707126016 копия] , [https://web.archive.org/web/20180916201927/http://www.gks.ru/free_doc/doc_2017/year/pril_year17-rus.xls таблица xls]&lt;/ref&gt;
&lt;ref name=&quot;Капцов-2016&quot;&gt;{{Статья|ссылка=https://naukaru.ru/ru/nauka/article/10152/view |автор=Капцов В.А., Чиркин А.В|заглавие= Об оценке эффективности средств индивидуальной защиты органов дыхания |год=2015|место=Москва|издание=Безопасность в техносфере |издательство=ИНФРА-М |том=4 |номер=5 |страницы=7-14|doi=10.12737/16958}} ISSN 1998-071X [https://www.researchgate.net/publication/290476070_On_Evaluation_of_Effectiveness_of_Respiratory_Protective_Devices PDF]&lt;/ref&gt;
&lt;ref name=&quot;Howie-1&quot;&gt; ''Robin Howie.'' Recommendation 1 (слайд № 82). In: [https://www.arbeidshygiene.nl/symposium/vorige-symposia/symposium-2012/ Reality of PPE performance]. Het 21ste NVvA symposium: &quot;Beheersmaatregelen onder de loep&quot; (28 - 29 maart 2012, Zeist) &lt;small&gt;(англ.).&lt;/small&gt; ''Nederlandse Vereniging voor Arbeidshygiëne www.arbeidshygiene.nl'' p. 82. Eindhoven, Nederland: Nederlandse Vereniging voor Arbeidshygiëne (2012). Дата обращения: 5 ноября 2024. [https://www.arbeidshygiene.nl/-uploads/files/insite/1-presentation-reality-of-ppe-performance-nvva-march-2012.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;Howie-2&quot;&gt;{{Статья|ссылка=https://academic.oup.com/annweh/issue/42/2|заглавие=Robin Howie President of the BOHS 1997–1998|год=1998|язык=en|автор издания=British Occupational Hygiene Society|издание=The Annals of Occupational Hygiene|издательство=Oxford University Press|месяц=2|выпуск=2|pages=71-72|volume=42|doi=10.1093/annhyg/42.2.71}} ISSN 2398-7308&lt;/ref&gt;
&lt;ref name=&quot;ХимЗащОдежда-2017&quot;&gt;{{Книга |автор=CEN/TC 162/WG 3 - Protective clothing against chemicals, infective agents and radioactive contamination |заглавие=PD CEN/TR 15419:2017 Protective clothing - Guidelines for selection, use, care and maintenance of chemical protective clothing |ответственный=European Committee for Standardization (CEN) |год=2017 |часть=4.6 Garment material selection criteria (definition of CPC material criteria) |язык=en |издание=2nd ed |место=Brussels, Belgium |издательство=British Standards Institution |pages=13-17 |allpages=49 |серия=ICS 13.340.10 Protective clothing |isbn=978 0 580 98705 2}}&lt;/ref&gt;
&lt;ref name=&quot;Капцов-2022&quot;&gt;{{Статья|ссылка=https://www.rjhas.ru/jour/article/view/2011/1419|автор=Капцов В.А., Панкова В.Б., Чиркин А.В.|заглавие=Риск многократного применения противогазных фильтров респираторов (обзор литературы)|год=2022|автор издания=Роспотребнадзор|издание=Гигиена и санитария|том=101  |номер=2|страницы=174-179 |doi=10.47470/0016-9900-2022-101-2-174-179|archivedate=2023-05-19 |archiveurl= https://web.archive.org/web/20230519150148/https://www.rjhas.ru/jour/article/view/2011/1419}} ISSN 0016-9900 [https://www.researchgate.net/publication/359302765_The_risk_of_multiple_uses_of_respirator_gas_filters_literature_review копия] &lt;/ref&gt;
&lt;ref name=&quot;Сорокин-2007-5&quot;&gt;{{Книга|автор=Карнаух Н.Н., Пашнин Н.П., Сорокина Т.Ю., Шувалов Е.С., Файнбург Г.З.|заглавие=Средства индивидуальной защиты. Учебное пособие|ответственный=Президент АСИЗ [https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры Ю.Г. Сорокин], А.Л. Сафонов|год=2007|часть=3. Средства индивидуальной защиты органов дыхания. В: II. Средства индивидуальной защиты; |издание=3 изд|место=Москва|издательство=&quot;Золотой телёнок&quot;, Минздравсоцразвития РФ|страницы=72-76|страниц=288|серия=Охрана труда|isbn=978-5-88257-099-5|тираж=10 000}}&lt;/ref&gt;
&lt;ref name=&quot;Денисов-2013&quot;&gt;{{Статья|ссылка=https://cyberleninka.ru/article/n/problema-realnoy-effektivnosti-individualnoy-zaschity-i-privnosimyy-risk-dlya-zdorovya-rabotnikov-obzor-literatury/viewer|автор=Денисов Э.И., Морозова Т.В., Аденинская Е.Е., Курьеров Н.Н.|заглавие=Проблема реальной эффективности индивидуальной защиты и привносимый риск для здоровья работников (обзор литературы)|год=2013|автор издания=НИИ медицины труда РАН|издание=Медицина труда и промышленная экология|месяц=8|номер=8|страницы=18-25|}} ISSN 1026-9428, {{PMID|24006620}}&lt;/ref&gt;
&lt;ref name=&quot;CCOHS-2025&quot;&gt;''Canadian Centre for Occupational Health and Safety.'' [https://www.ccohs.ca/oshanswers/prevention/ppe/designin.html Personal Protective Equipment]. OSH Answers Fact Sheets -- Prevention and Control of Hazards &lt;small&gt;''(англ.).''&lt;/small&gt; ''www.ccohs.ca.'' Hamilton (Ontario, Canada): CCOHS (21 января 2025). Дата обращения: 9 сентября 2025.&lt;/ref&gt;
&lt;ref name=&quot;Suruda-2003&quot;&gt;{{статья|автор= Anthony Suruda, William Milliken, Dale Stephenson &amp; Richard Sesek|заглавие=Fatal Injuries in the United States Involving Respirators, 1984-1995|ссылка= https://www.researchgate.net/publication/10856558_Fatal_Injuries_in_the_United_States_Involving_Respirators_1984-1995 |язык=en |издание=Applied Occupational and Environmental Hygiene |издательство=Taylor &amp; Francis |год=2003| volume=18|выпуск=4|pages=289-292 |doi= 10.1080/10473220301405}}, ISSN 1521-0898, {{PMID|12637239}}. CDC [https://stacks.cdc.gov/view/cdc/186373/cdc_186373_DS1.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;Буянов-1974&quot;&gt;{{Книга|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1731671688&amp;archive=&amp;start_from=&amp;ucat=&amp;|автор=Буянов В.В.|заглавие=Проблемы индивидуальной защиты человека. Часть 1|ответственный=[[:w:ru:Городинский, Семён Михайлович|С.М. Городинский]] (ред.)|год=1974|часть=Исследования физической работоспособности при воздействии на человека неблагоприятных факторов, обусловленных средствами индивидуальной защиты|место=Москва|издательство=ВНИИ медицинской и медико-технической информации|страницы=14-15|страниц=86|серия=научный обзор|тираж=1500}}&lt;/ref&gt;
&lt;ref name=&quot;Полоний-1980&quot;&gt;{{Книга|автор=Н.Б. Борисов, [[:w:ru:Ильин, Леонид Андреевич|Л.А. Ильин]], У.Я. Маргулис, Г.М. Пархоменко, В.Т. Хрущ.|заглавие=Радиационная безопасность при работе с полонием-210|ответственный=И.В. Петрянов ред|год=1980|часть=7. Средства индивидуальной защиты, в: Глава 6. Гигиена труда при работе с полонием|место=Москва|издательство=Атомиздат|страницы=172-180|страниц=262|тираж=1300}}&lt;/ref&gt;
&lt;ref name=&quot;ГОЧС-7-2006&quot;&gt;{{Книга|ссылка=https://xn--b1ae4ad.xn--p1ai/library/86|автор=Галушкин Б.А., Азаров С.Г., Багаев Н.С., Грачев М.И., Клочков В.Н., Коростин А.С, Кунцевич А.А., Петросян Л.Н., Семенов В.В., Харичев Н.И.|заглавие=Справочник спасателя: Книга 7: Спасательные работы по ликвидации последствий радиоактивных загрязнений|ответственный=ВНИИ ГОЧС|год=2006|часть=Пункт 5.2.5. в|место=Москва|издательство=Рекламно-издательский комплекс “Галерия”|страницы=51|страниц=152|тираж=1500}} &quot;... следует учитывать, что наряду с защитным эффектом некоторые виды СИЗ оказывают нежелательное воздействие на функциональные системы организма человека, затрудняя его теплообмен с окружающей средой или создавая трудности, проявляющиеся в сопротивлении дыханию, давлении лицевых частей СИЗ на мягкие ткани головы, ограничении поля зрения и слуха, либо ухудшении разборчивости речи и т.п.&quot; &lt;/ref&gt;
&lt;ref name=&quot;Буянов-2001-&quot;&gt;{{Книга|автор=Буянов В.В., Супрун И.П.|заглавие=Средства индивидуальной защиты для работ в микробиологических и вирусологических лабораториях|ответственный=научн. консульт. Т.Н. Калинин|год=2001|часть=Глава 7. Работоспособность человека в средствах индивидуальной защиты|место=Черноголовка|издательство=Институт проблем химической физики|страницы=166-237|страниц=324|серия=Государственный научно-исследовательский институт биологического приборостроения|isbn=5-201-10416-7|isbn2=5-201-10416-9}}&lt;/ref&gt;
&lt;ref name=&quot;Sinkule-2013&quot;&gt;{{Статья|ссылка=https://academic.oup.com/annweh/article/57/3/384/230992|автор=E.J. Sinkule, J.B. Powell, F.L. Goss|заглавие=Evaluation of N95 respirator use with a surgical mask cover: effects on breathing resistance and inhaled carbon dioxide|год=2013|язык=en|автор издания=British Occupational Hygiene Society|издание=The Annals of Occupational Hygiene|издательство=Oxford University Press|выпуск=3|pages=384—398|volume=57|doi=10.1093/annhyg/mes068}} ISSN 0003-4878, {{PMID|23108786}}&lt;/ref&gt;
&lt;ref name=&quot;ГН-2-2-5-3532-18&quot;&gt;{{Книга|автор=''(Роспотребнадзор)''|заглавие=ГН 2.2.5.3532-18 «Предельно допустимые концентрации (ПДК) вредных веществ в воздухе рабочей зоны»|ответственный=утверждены [[:w:ru:Попова, Анна Юрьевна|А. Ю. Поповой]]|место=Москва|год=2018|страниц=170|ссылка=https://www.rospotrebnadzor.ru/documents/details.php?ELEMENT_ID=9967|серия=Санитарные правила}}; новая редакция {{книга|автор=|часть=II. Химические и биологические факторы производственной среды. Таблица 2.1 Предельно допустимые концентрации (ПДК) загрязняющих веществ в воздухе рабочей зоны | ссылка= http://publication.pravo.gov.ru/Document/View/0001202102030022 |ответственный=Попова А.Ю. |заглавие= СанПиН 1.2.3685-21 &quot;Гигиенические нормативы и требования к обеспечению безопасности и (или) безвредности для человека факторов среды обитания&quot;|место=Москва|издательство= Роспотребнадзор |год=2021 |страницы= |страниц= 516|серия=Санитарные правила и нормы}}&lt;/ref&gt;
&lt;ref name=&quot;СИЗ-2005&quot;&gt;{{книга|автор=Файнбург Г.З., Овсянкин А.Д. |часть= 7.4 Инфраструктура обеспечения работников средствами индивидуальной защиты |заглавие=Использование средств индивидуальной защиты от неблагоприятного воздействия производственной среды |издание=7 изд., исправленное и дополненное |место= Пермь |издательство= Отдел публикаций Пермского областного центра охраны труда на базе [[:w:Пермский государственный университет| ПГТУ]]|год=2005 |страницы= 187 |всего страниц= 212|isbn= 5-88151-360-6 |серия=  Рекомендовано Департаментом условий и охраны труда Минтруда России в качестве учебного пособия для обучения и проверки знаний работников по охране труда, включая обучение отдельных категорий застрахованных |ответственный=Рецензенты Радостев М.А. ''&lt;small&gt;(ЗАО «Пермь-Восток-Сервис»)&lt;/small&gt;'', ктн Коротаев В.Ф. ''&lt;small&gt;(Пермский государственный технический университет)&lt;/small&gt;''|тираж=1900|}}&lt;/ref&gt;
&lt;ref name=&quot;ACGIH-28&quot;&gt;{{книга|автор=[[:w:Американская ассоциация государственных промышленных гигиенистов|ACGIH]] Industrial Ventilation Committee members |заглавие=Industrial Ventilation. A Manual of Recommended Practice for Design|издание=28 ed|место=Cincinnati, Ohio|издательство=[[:w:Американская ассоциация государственных промышленных гигиенистов|American Conference of Governmental Industrial Hygienists]]|год=2013|страницы=Глава 1, стр. 9|allpages=370|isbn=978-1-607260-57-8}}&lt;/ref&gt;
&lt;ref name=&quot;Конвенция148&quot;&gt;Конвенция [[:w:Международная организация труда |Международной организации труда]] № 148 {{Cite web |url=http://www.ilo.org/wcmsp5/groups/public/---ed_norm/---normes/documents/normativeinstrument/wcms_c148_ru.htm |title= «О защите трудящихся от профессионального риска, вызываемого загрязнением воздуха, шумом и вибрацией на рабочих местах» (1977) }} (16 октября 2024). [https://docs.cntd.ru/document/1900829 Официальный перевод]&lt;/ref&gt;
&lt;ref name=&quot;Росстат-2016&quot;&gt;''Росстат.'' Социально-экономические показатели Российской Федерации в 1991-2016 гг. (1,2 Мб). ''www.gks.ru'' (2017). Дата обращения: 16 сентября 2018. [https://web.archive.org/web/20180916201927/http://www.gks.ru/wps/wcm/connect/rosstat_main/rosstat/ru/statistics/publications/catalog/doc_1270707126016 копия] , [https://web.archive.org/web/20180916201927/http://www.gks.ru/free_doc/doc_2017/year/pril_year17-rus.xls таблица xls]&lt;/ref&gt;
&lt;ref name=&quot;ПЗ-2007&quot;&gt;{{Статья|ссылка=https://rg.ru/2007/03/01/medvedev.html|автор=Павел Дульман|заглавие=Компании обещали заняться здоровьем работников (Дмитрий Медведев призвал крупный бизнес активнее заниматься здоровьем работников)|год=2013|автор издания=ФГБУ «Редакция «Российской газеты»|место=Москва|издание=Российская газета|издательство=АО &quot;Издательство &quot;Российская газета&quot;|тип=газета|месяц=3|число=1|номер=42|archive-date=2023-10-28|archive-url=https://web.archive.org/web/20231028112659/https://rg.ru/2007/03/01/medvedev.html|url-status=live}} ISSN 1606-5484&lt;/ref&gt;
&lt;ref name=&quot;Сорокин-2018&quot;&gt;{{Статья|ссылка=https://getsiz.ru/asiz-2018-ne-vse-eshche-skazano.html|автор=[https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры Сорокин Ю.Г.]|заглавие=АСИЗ-2018: не все еще сказано!|год=2018|автор издания=Общество с ограниченной ответственностью «Информационно-аналитическое агентство «Полдень»|место=Томск|издание=Гетсиз.ру|тип=сайт|месяц=12|число=10}}&lt;/ref&gt;
&lt;ref name=&quot;Щербаков-1976&quot;&gt;{{Книга |ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1751551910&amp;archive=&amp;start_from=&amp;ucat=&amp; |автор=Щербаков В.Л., Еськова-Сосковец Л.С., Коростин А.С.|заглавие=Всесоюзная конференция &quot;Пути повышения качества и эффективности средств индивидуальной защиты и совершенствования методов их оценки&quot; |ответственный=Семёнов А.П., Городинский С.М., Романова И.Г., Цуцков М.Е., Гуда В.А., Леоничева В.Д. (редколлегия) |год=1976 |часть= Методика оценки средств индивидуальной защиты как вторичного источника загрязнения окружающей среды радиоактивными веществами  |издание=Всесоюзный центральный совет профсоюзов (ВЦСПС) |место=Москва |издательство=Государственный Комитет Совета Министров СССР по науке и технике |страницы=84-86 |страниц=179 |серия=Тезисы докладов, г. Тбилиси, 13-15 октября 1976 г. |тираж=700}}&lt;/ref&gt;
&lt;ref name=&quot;Роструд-доклад-14&quot;&gt;{{Книга |ссылка= https://rostrud.gov.ru/control/soblyudenie-zakonodatelstva-o-trude/?CAT_ID  |автор=Роструд |заглавие=Доклад об осуществлении и эффективности в 2014 году государственного надзора и контроля в сфере труда и социальной защиты населения |год=2015 |часть= 1.6. Анализ и оценка эффективности федерального государственного надзора за соблюдением трудового законодательства и иных нормативных правовых актов, содержащих нормы трудового права. В: I. Осуществление и эффективность в 2014 году федерального государственного надзора за соблюдением трудового законодательства и иных нормативных правовых актов, содержащих нормы трудового права |место=Москва |издательство=Федеральная служба по труду и занятости |страницы=75 |страниц=147}} [https://rostrud.gov.ru/upload/iblock/5ad/nadzor_2014.pdf   PDF]&lt;/ref&gt;
	
&lt;ref name=&quot;Роструд-доклад-17&quot;&gt;{{Книга |ссылка= https://rostrud.gov.ru/control/soblyudenie-zakonodatelstva-o-trude/?CAT_ID  |автор=Роструд |заглавие= Доклад об осуществлении государственного надзора за соблюдением трудового законодательства и иных нормативных правовых актов, содержащих нормы трудового права, и надзора в сфере социальной защиты населения за 2017 год |год=2018 |часть= 4.1.2. Сведения о результатах проведения специальной оценки условий труда в хозяйствующих субъектах Россйской Федерации. В: 4. Проведение государственного контроля (надзора), муниципального контроля |место=Москва |издательство=Федеральная служба по труду и занятости |страницы=38 |страниц=101}} [https://rostrud.gov.ru/upload/iblock/b40/nadzor-2017.docx dokx]&lt;/ref&gt;
}}</text>
      <sha1>37z541zgky2yc4x4asjec6svapjvibt</sha1>
    </revision>
  </page>
  <page>
    <title>Средства индивидуальной защиты (обзорная лекция)/Введение</title>
    <ns>0</ns>
    <id>35623</id>
    <revision>
      <id>270419</id>
      <parentid>267373</parentid>
      <timestamp>2026-10-27T07:04:14Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270419</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="29166" sha1="mex1w0o0oxrysuyi0o3ebx025zd2mg5" xml:space="preserve">'''Средства индивидуальной защиты''' (СИЗ) — один из элементов системы [[:w:ru:Профилактическая медицина |профилактических мероприятий]], используемый тогда, когда не удаётся снизить воздействие [[:w:ru:Вредный производственный фактор |вредных и опасных производственных факторов]] на работников до [[:w:ru:Гигиеническое нормирование|допустимых уровней]], и для защиты от загрязнений. Применение СИЗ - самый [[:w:ru:Ранжирование методов защиты от вредных производственных факторов|последний и самый ненадежный]] способ защиты [[:w:ru:жизнь|жизни]] и [[:w:ru:здоровье|здоровья]]&lt;ref name=&quot;Кириллов-2010-26&quot; /&gt;. Это средства, носимые [[:w:работник|работником]], и используемые для предотвращения или уменьшения воздействия вредных и опасных производственных факторов, а также для защиты от загрязнения. Из-за сравнительно низкой эффективности (пример&lt;ref name=&quot;Groenewold-2014&quot; /&gt;) '''''должны''''' применяться лишь тогда, когда защиту рабочих не удалось обеспечить [[:w:ru:Ранжирование методов защиты от вредных производственных факторов|более надёжными способами]]&lt;ref name=&quot;OSHA-2023&quot; /&gt; - безопасной конструкцией оборудования, изменением [[:w:ru:Развитие техники и технологии горного дела|технологии]] и организации [[:w:ru:Производство|производственных]] процессов, [[:w:ru:Архитектурное решение|архитектурно-планировочными решениями]] и [[:w:ru:средства коллективной защиты |средствами коллективной защиты]].

СИЗ сочетают в себе разные свойства. Это одновременно и [[:w:ru:Товар|товар]]&lt;ref name=&quot;ЕС-директива-товар&quot; /&gt;, [[:w:ru:Продажа|продаваемый]] на [[:w:ru:рынок|рынке]]&lt;ref name=&quot;Berger-2009&quot; /&gt; [[:w:ru:Поставщик|поставщиками]] и изготовителями с извлечением [[:w:ru:Прибыль|прибыли]]; и предмет (или материал)&lt;ref name=&quot;ЕС-директива-товар&quot; /&gt;, разрабатываемый и изготавливаемый производителями так, чтобы он мог снижать или устранять воздействие вредных и/или опасных производственных факторов; и носимое или удерживаемое работником устройство (или наносимое на кожу вещество)&lt;ref name=&quot;ЕС-директива-рабочие&quot; /&gt;, предназначенное для сбережения его жизни и здоровья, и защиты от загрязнений&lt;ref name=&quot;МОТ-4+&quot; /&gt;&lt;ref name=&quot;ILO-4+&quot; /&gt;.

Эффективность СИЗ зависит от многих факторов, включая правильные выбор и использование&lt;ref name=&quot;МР-1975&quot; /&gt;&lt;ref name=&quot;Крутиков-2002&quot; /&gt;&lt;ref name=&quot;МОТ-4&quot; /&gt;&lt;ref name=&quot;ILO-4&quot; /&gt;. Поэтому в развитых странах разработаны не только минимальные технические требования к качеству самих СИЗ, но и подробные требования к их выбору и организации применения, которые [[:w:ru:Работодатель|работодатели]] обязаны выполнять. В РФ для большинства СИЗ такие требования не разработаны.

Использование СИЗ может значительно уменьшить [[:w:ru:Производительность труда|работоспособность]] человека&lt;ref name=&quot;Буянов-2001++&quot; /&gt;. Если воздействие вредных производственных факторов опасно, но превышает предельно допустимое не очень сильно, [[:w:ru:сдельная оплата труда|сдельная оплата труда]] может эффективно стимулировать рабочих отказываться от использования СИЗ&lt;ref name=&quot;Шафранова-1937-1&quot; /&gt;&lt;ref name=&quot;Бачанац-1997&quot; /&gt;.

После [[:w:ru:Распад СССР|распада СССР]] произошло значительное увеличение доли [[:w:ru:Рабочее место|рабочих мест]] с вредными и опасными условиями труда&lt;ref name=&quot;Росстат-2016&quot; /&gt;. В результате использование СИЗ стало не только последним, но и единственным способом защиты жизни и здоровья для миллионов работников в РФ, доминирующей составляющей в области [[Охрана труда |охраны]] и [[:w:ru:Гигиена труда |гигиены труда]]. В условиях [[:w:ru:Демографический кризис в Российской Федерации|демографического кризиса]] и высокого уровня [[:w:ru:Смертность|смертности]] населения трудоспособного возраста, по данным [[:w:ru:Федеральная служба государственной статистики|Росстата]] за 2023 г., доля затрат на СИЗ достигла 49% от всех затрат на охрану труда&lt;ref name=&quot;Росстат-2024&quot; /&gt;, что многократно превышает аналогичные показатели в других странах - несмотря на несравненно больший [[:w:ru:Основные средства|износ зданий, машин и оборудования]] на [[:w:ru:Предприятие|предприятиях]] в РФ. В то же время, по данным Росстата&lt;ref name=&quot;Росстат-2024&quot; /&gt;, затраты российских работодателей на улучшение условий труда, на [[:w:ru:средства коллективной защиты|средства коллективной защиты]] исключительно низкие, и в годовом статистическом отчёте&lt;ref name=&quot;форма1Т&quot; /&gt; не учитываются вообще (нет соответствующей графы). 

По данным [[:w:ru:Социальный фонд России|Социального фонда]], из его средств, выделяемых работодателям на [[:w:ru:Профилактическая медицина|профилактику]] [[:w:ru:Страховой случай|страховых случаев]], в 2021 году расходы на улучшение условий труда и [[:w:ru:Средства коллективной защиты|СКЗ]] были в 240 раз меньше, чем на СИЗ&lt;ref name=&quot;ФСС-2022&quot; /&gt;. (В 2002 г. закупка СИЗ за счёт средств Фонда социального страхования не предусматривалась вообще&lt;ref name=&quot;Барановский-2003&quot; /&gt;, в 2012 г. расходы на СИЗ превышали расходы на улучшение условий труда лишь в 32,5 раза&lt;ref name=&quot;Барановский-2012&quot; /&gt;). При государственной поддержке поставщиков товара продажи СИЗ в РФ интенсивно растут, за 2001-2024 гг. средние затраты на 1 работника возросли с 1,2&lt;ref name=&quot;Сорокин-2018&quot; /&gt; до 17,9&lt;ref name=&quot;Росстат-2024&quot; /&gt; тыс. рублей.

== Источники ==
{{примечания|refs=
&lt;ref name=&quot;Кириллов-2010-26&quot;&gt;{{книга|автор=[https://www.journal-irioh.ru/jour/article/view/385/375 Кириллов В.Ф]. |заглавие=Гигиена труда|издание=1 изд|ответственный=[[:w:ru:Измеров, Николай Федотович|Измеров Н.Ф]]., [https://www.journal-irioh.ru/jour/article/view/385/375 Кириллов В.Ф]. ред |часть=Глава 26. [http://vmede.org/sait/?page=28&amp;id=Gigiena_truda_izmerov_2010&amp;menu=Gigiena_truda_izmerov_2010 Средства индивидуальной защиты] |место=Москва|издательство= Издательская группа «ГЭОТАР-Медиа» |год=2008 |страницы=440—454|страниц=592|isbn=978-5-9704-3691-2|тираж=1000|серия=Учебник}} 2 изд., перераб. и доп. [https://e-library.sammu.uz/uploads/books/Rus%20tilidagi%20adabiyotlar/Гигиена/%2B%2BГигиена%20труда.pdf 2016]&lt;/ref&gt;
&lt;ref name=&quot;Groenewold-2014&quot;&gt;{{Статья|ссылка=https://stacks.cdc.gov/view/cdc/36768|автор=Groenewold M.R., Masterson E.A., Themann C.L., Davis R.R|заглавие=Do hearing protectors protect hearing?|год=2014|язык=en|издание=American Journal of Industrial Medicine|издательство=Wiley Periodicals|месяц=4|число= 3|выпуск=9|pages=1001—1010|volume=57 |doi=10.1002/ajim.22323}} ISSN 1097-0274. {{PMID|24700499}}. Есть [https://ru.wikipedia.org/wiki/Файл:СИЗ_органа_слуха,_и_профилактика_ухудшения_слуха.pdf '''перевод 1'''] [https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1668507313&amp;archive=&amp;start_from=&amp;ucat=&amp;#i2701 '''перевод 2''']&lt;/ref&gt;
&lt;ref name=&quot;OSHA-2023&quot;&gt;{{Книга|ссылка=https://www.osha.gov/sites/default/files/publications/osha3151.pdf|автор=Occupational Safety and Health Administration|заглавие=Personal Protective Equipment|ответственный=U.S. Department of Labor|год=2023|часть=Introduction|язык=en|pages=3|allpages=46|серия=OSHA 3151-02R 2023}}&lt;/ref&gt;
&lt;ref name=&quot;ЕС-директива-товар&quot;&gt;{{Статья|ссылка=https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=celex%3A32016R0425|автор=The European Parliament and the Council of the European Union|заглавие=Regulation (EU) 2016/425 of the European Parliament and of the Council of 9 March 2016 on personal protective equipment and repealing|год=2016| серия=Council Directive 89/686/EEC (OJ L 81, 31.3.2016, pp. 51–98)|язык=en|издание=Official Journal of the European Union|тип=журнал|месяц=3|число=31|выпуск=L 81 (series L – Legislation)|автор издания= European Union |pages=L 81/51 - L 81/98| |volume=59}} ISSN 1977-0677. С 1989 по 2018 гг. действовала [[:w:ru:Директива 89/686/ЕЭС|предыдущая версия Директивы]].&lt;/ref&gt;
&lt;ref name=&quot;ЕС-директива-рабочие&quot;&gt;{{Статья |ссылка=https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A01989L0656-20191120 |автор=The Council of the European Communities |заглавие=Council Directive of 30 November 1989 on the minimum health and safety requirements for the use by workers of personal protective equipment at the workplace (third individual directive within the meaning of Article 16 (1) of Directive 89/391/EEC) (89/656/EEC) |год=1989 (amend. 2007) |язык=en |автор издания=European Union |место=EU |издание=Official Journal of the European Union |тип=журнал |месяц=12 |число=30 |выпуск=L 393 (series L – Legislation) |pages=L 393 / 18 - L 393 / 28 |volume=32 }} ISSN 0378-6978. old [https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=OJ:L:1989:183:FULL PDF] [https://meganorm.ru/mega_doc/dop_norm/52/gost_r_70231-2022_natsionalnyy_standart_rossiyskoy/0/direktiva_N_89_656_ees_soveta_evropeyskikh_soobshchestv_o.html?ysclid=moec7pwxxz657959550 перевод]&lt;/ref&gt;
&lt;ref name=&quot;Berger-2009&quot;&gt;{{Статья|ссылка=https://www.tandfonline.com/doi/abs/10.1080/10803548.2009.11076803|автор=Canetto P., Voix J., Berger E.H., Jacques J., &amp; Liedtke M.|заглавие=Hearing Protectors “Real-World” Performance and the European Directive 2003/10/EC|год=2009|язык=en|автор издания=Central Institute for Labour Protection|место=Abingdon, UK|издание=International Journal of Occupational Safety and Ergonomics|издательство=Taylor &amp; Francis|выпуск=2|pages=221—226|volume=15|doi=10.1080/10803548.2009.11076803}} ISSN 1080-3548. {{PMID|19572468}}. [https://www.researchgate.net/publication/321775663_Hearing_protectors_real_world_performance_and_the_European_Directive_200310EC копия]&lt;/ref&gt;
&lt;ref name=&quot;МОТ-4+&quot;&gt;{{Книга|ссылка=http://base.safework.ru/iloenc|ответственный =[https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры Ю.Г. Сорокин] (''руководитель Департамента условий и охраны труда, Минтруд РФ''); Жан-Виктор Груа (''Директор Московского бюро МОТ'')|заглавие=Энциклопедия по безопасности и охране труда|год=2001|часть=[https://base.safework.ru/iloenc?d&amp;nd=857400283&amp;prevDoc=857400283&amp;spack=110LogLength%3D0%26LogNumDoc%3D857400034%26listid%3D010000000100%26listpos%3D3%26lsz%3D6%26nd%3D857400034%26nh%3D1%26 Гигиена труда: Вмешательство как метод контроля вредного воздействия]. В: Том 1; Раздел [https://base.safework.ru/iloenc?d&amp;nd=857400005&amp;prevDoc=857400283 Раздел IV. Методология и практика], Глава [https://base.safework.ru/iloenc?d&amp;nd=857400034&amp;prevDoc=857400034&amp;spack=110LogLength%3D0%26LogNumDoc%3D857400005%26listid%3D010000000300%26listpos%3D3%26lsz%3D7%26nd%3D857400005%26nh%3D0%26 30. Гигиена труда] |автор=Джеймс Стюарт |ссылка часть=|издание=4-е изд|место=Москва|издательство=Международная организация труда; Министерство труда и социального развития РФ|страницы= |страниц=1278|isbn=|серия= Охрана труда}}&lt;/ref&gt;
&lt;ref name=&quot;ILO-4+&quot;&gt;''James Stewart''. [https://iloencyclopaedia.org/part-iv-66769/occupational-hygiene-47504/item/573-occupational-hygiene-control-of-exposures-through-intervention Occupational Hygiene: Control of Exposures Through Intervention]. In: Vol. 1; [https://iloencyclopaedia.org/part-iv-66769/occupational-hygiene-47504 Occupational Hygiene] // [https://iloencyclopaedia.org/ Encyclopedia of Occupational Health and Safety] / Michel Hansenne ed. — 4th ed. — Geneva: International Labour Office, 1998.&lt;/ref&gt;
&lt;ref name=&quot;МР-1975&quot;&gt;{{Книга|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1731668649&amp;archive=&amp;start_from=&amp;ucat=&amp;|автор=Гольдштейн Д.С., Шатский С.Н., Щербаков В.Л., Фаустова Д.Г., Буянов В.В., Купчин А.П.|заглавие=Методические рекомендации по организации контроля за применением и содержанием средств индивидуальной защиты|год=1975|часть=1. Общие положения по организации контроля за  применением и содержанием средств индивидуальной защиты|место=Москва|издательство=Институт биофизики|страницы=3—5|страниц=19|тираж=5300}}&lt;/ref&gt;
&lt;ref name=&quot;Крутиков-2002&quot;&gt;{{Книга|заглавие=Коллективные и индивидуальные средства защиты. Контроль защитных свойств|ответственный=Крутиков В.Н., Фалеев М.И. (науч. ред.)|год=2002|часть=Введение|место=Москва|издательство=ФИД &quot;Деловой экспресс&quot;|страницы=10|страниц=408|серия=Энциклопедия &quot;Экометрия&quot; из серии справочных изданий по экологическим и медицинским измерениям|isbn=5-89644-076-6}}&lt;/ref&gt;
&lt;ref name=&quot;МОТ-4&quot;&gt;{{Книга|ссылка=http://base.safework.ru/iloenc|ответственный =[https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры Ю.Г. Сорокин] &lt;small&gt;(''руководитель Департамента условий и охраны труда, Минтруд РФ'')&lt;/small&gt;; Жан-Виктор Груа &lt;small&gt;(''Директор Московского бюро МОТ'')&lt;/small&gt;|заглавие=Энциклопедия по безопасности и охране труда|год=2001|часть=[http://base.safework.ru/iloenc?d&amp;nd=857400340&amp;prevDoc=857400340&amp;spack=010LogLength%3D0%26LogNumDoc%3D857400038%26listid%3D010000000100%26listpos%3D0%26lsz%3D7%26nd%3D857400038%26nh%3D1%26 Современное состояние индивидуальных средств защиты]. В: Том 1; Раздел [http://base.safework.ru/iloenc?d&amp;nd=857400005&amp;prevDoc=857000002 IV], Глава [http://base.safework.ru/iloenc?d&amp;nd=857400038&amp;prevDoc=857400346 31. Средства индивидуальной защиты] |автор=Роберт Ф. Херрик (автор и редактор раздела СИЗ) |ссылка часть=|издание=4-е изд|место=Москва|издательство=Международная организация труда; Министерство труда и социального развития РФ|страницы= |страниц=1278|isbn=|серия= Охрана труда}}&lt;/ref&gt;&lt;ref name=&quot;ILO-4&quot;&gt;''Robert F. Herrick''. [https://iloencyclopaedia.org/part-iv-66769/personal-protection-59388/item/686-overview-and-philosophy-of-personal-protection Overview and Philosophy of Personal Protection]. In: Vol. 1; [https://iloencyclopaedia.org/part-iv-66769/personal-protection-59388 Chapter 31. Personal Protection] // [https://iloencyclopaedia.org/ Encyclopedia of Occupational Health and Safety] / Michel Hansenne ed. — 4th ed. — Geneva: International Labour Office, 1998.&lt;/ref&gt;
&lt;ref name=&quot;Буянов-2001++&quot;&gt;{{Книга |автор=Буянов В.В., Супрун И.П. |заглавие=Работоспособность человека в средствах индивидуальной защиты |ответственный=дтн. проф. Ю.Т. Калинин |год=2001 |часть=3.3 Влияние термических воздействий на работоспособность человека при использовании хлопчатобумажной спецодежды и фильтрующего противогаза |место=Черноголовка |издательство=Государственный научный центр &quot;Государственный НИИ биологического приборостроения&quot; |страницы=53 |страниц=113 |isbn=5-201-10416-9 |тираж=100}} Цитата: &quot;При температуре воздуха в камере 18-20° ... Способность к тонкой координации движений уже после первого часа работы снизилась на 46,3% от исходной величины.&quot;&lt;/ref&gt;
&lt;ref name=&quot;Шафранова-1937-1&quot;&gt;{{Книга|автор=Шафранова А.С.|заглавие=Индивидуальная защита глаз рабочего на производстве|ответственный=ВЦСПС, Московский научно-исследовательский институт охраны труда|год=1937|часть=Предисловие; 1. Защита глаз на производстве|место=Москва|издательство=Профиздат|страницы=4; 7-8|страниц=48|тираж=15300|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1738063241&amp;archive=&amp;start_from=&amp;ucat=&amp;}} [https://files.library.by/dl/files/СИЗ%20глаз%201937%20%2048%20с.pdf PDF]  '''Цитаты''': &quot;&lt;small&gt;ФЗМК и общественные инспектора по охране труда должны взять под особый контроль всю систему выписки и назначения рабочим очков и других приспособлений.&lt;/small&gt; Очень часто эти назначения производятся формально-бюрократически, неправильно, не по глазам рабочего, что вместо пользы даёт только вред. &lt;small&gt;В этих случаях рабочие отказываются носить выданные очки и по существу работают без защитных приспособлений.&lt;/small&gt; Защитные приспособления должны помогать рабочим, а не стеснять их, не мешать работе.&quot; с. 4; &quot;'''Почему же рабочие так часто отказываются от ношения защитных очков?''' Всякий предмет, надеваемый на лицо человека, так или иначе стесняет его; и обычно, чем лучшую защиту дают те или иные очки, тем больше неудобств они причиняют. Понятно, что рабочий, уже привыкший работать без очков, возражает против них, так как ему приходится приспосабливаться к новым условиям и '''он боится снижения уже достигнутой производительности труда.''' &quot; с. 7-8.&lt;/ref&gt;
&lt;ref name=&quot;Бачанац-1997&quot;&gt;{{Статья|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1748444042&amp;archive=&amp;start_from=&amp;ucat=&amp;|автор=Бачанац М.|заглавие=Профилактика офтальмокониоза у рабочих ФВК Кралево|год=1997|место=Москва|издание=Медицина труда и промышленная экология|издательство=НИИ медицины труда РАМН|месяц=4|номер=4|страницы=37—38}} ISSN 1026-9428.&lt;/ref&gt;
&lt;ref name=&quot;Росстат-2016&quot;&gt;''Росстат.'' Социально-экономические показатели Российской Федерации в 1991-2016 гг. (1,2 Мб). ''www.gks.ru'' (2017). Дата обращения: 16 сентября 2018. [https://web.archive.org/web/20180916201927/http://www.gks.ru/wps/wcm/connect/rosstat_main/rosstat/ru/statistics/publications/catalog/doc_1270707126016 копия] , [https://web.archive.org/web/20180916201927/http://www.gks.ru/free_doc/doc_2017/year/pril_year17-rus.xls таблица xls]&lt;/ref&gt;
&lt;ref name=&quot;Росстат-2024&quot;&gt;{{Книга|ссылка=https://rosstat.gov.ru/folder/11110/document/13264|автор=Главный межрегиональный центр (ГМЦ)|заглавие=Состояние условий труда работников организаций Российской Федерации по отдельным видам экономической деятельности|ответственный=Федеральная служба государственной статистики (РОССТАТ)|год=2024-04-25|часть=Том IV. Фактические расходы на компенсации и средства индивидуальной защиты в организациях по субъектам Российской Федерации по отдельным видам экономической деятельности по форме собственности (без субъектов малого предпринимательства; в 2023 году)|место=Москва}}  [https://rosstat.gov.ru/storage/mediabank/usltr2023.rar RAR]&lt;/ref&gt;
&lt;ref name=&quot;Барановский-2003&quot;&gt;{{статья|автор=Барановский И.Г., Измайлова О.В., Субботин В.В., Ткачёв В.В. |заглавие= Анализ основных показателей работы отечественной системы обязательного социального страхования профессиональных рисков|автор издания=НИИ медицины труда РАН|издание=Медицина труда и промышленная экология|ссылка= https://www.journal-irioh.ru/jour/ |место=Москва|издательство=|год=2003|номер=9|страницы=1—8|}} ISSN 1026-9428.&lt;/ref&gt;
&lt;ref name=&quot;Барановский-2012&quot;&gt;''Барановский И.Г. (ФСС).'' Слайд № 20 в презентации: [http://www.oaontc.ru/media/filebrowser/prezentacii/22.pdf Роль Фонда социального страхования Российской Федерации в обязательном социальном страховании от несчастных случаев на производстве и профессиональных заболеваний]. XI Всероссийский Форум Единой системы оценки соответствия в области промышленной, экологической безопасности, безопасности в энергетике и строительстве (ЕСОС). г. Сочи, 30 сентября - 4 октября 2013 года.&lt;/ref&gt;
&lt;ref name=&quot;Сорокин-2018&quot;&gt;{{Статья|ссылка=https://getsiz.ru/asiz-2018-ne-vse-eshche-skazano.html|автор=[https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры Сорокин Ю.Г.]|заглавие=АСИЗ-2018: не все еще сказано!|год=2018|автор издания=Общество с ограниченной ответственностью «Информационно-аналитическое агентство «Полдень»|место=Томск|издание=Гетсиз.ру|тип=сайт|месяц=12|число=10}}&lt;/ref&gt;
&lt;ref name=&quot;форма1Т&quot;&gt;''ООО &quot;Группа Актион&quot;''. [https://www.zarplata-online.ru/art/164033-otchet-1-t-usloviya-truda-kak-zapolnit-i-sdat Отчет 1-Т (условия труда): как заполнить и сдать]. Статистическая отчетность. ''www.zarplata-online.ru.'' Журнал «Зарплата» (8 ноября 2024) [https://www.rogwu.ru/content/bl_files_pg/%D0%A4%D0%BE%D1%80%D0%BC%D1%8B%20%E2%84%96%201-%D0%A2%20%28%D1%83%D1%81%D0%BB%D0%BE%D0%B2%D0%B8%D1%8F%20%D1%82%D1%80%D1%83%D0%B4%D0%B0%29.doc ссылка]&lt;/ref&gt;
&lt;ref name=&quot;ФСС-2022&quot;&gt;{{Книга|ссылка=https://sfr.gov.ru/files/id/press_center/godovoi_otchet/fss/FSS_annual_report_2021.pdf|автор=ФСС|заглавие=Отчёт Фонда Социального Страхования Российской Федерации за 2021 год|год=2022|часть=Структура предупредительных мер по сокращению производственного травматизма и профзаболеваний (по статьям расходов) за 2021 год (в млн. руб.)|место=Москва|издательство=ФСС|страницы=13|страниц=31|серия=Социальное страхование: практика и ориентиры развития}}&lt;/ref&gt;
}}</text>
      <sha1>mex1w0o0oxrysuyi0o3ebx025zd2mg5</sha1>
    </revision>
  </page>
  <page>
    <title>Средства индивидуальной защиты (обзорная лекция)/Изолирующие костюмы</title>
    <ns>0</ns>
    <id>35624</id>
    <revision>
      <id>270420</id>
      <parentid>269625</parentid>
      <timestamp>2026-10-27T07:04:42Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270420</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="31249" sha1="pcx01be07744oxld8gy4x7ixoos63iw" xml:space="preserve">[[Файл:Пневмокостюм.jpg|thumb|250px|Схема пневмокостюма]]
Изолирующие костюмы могут использоваться для защиты от радиоактивных загрязнений, химических веществ, вредных биологических факторов, при повышенной или пониженной температуре воздуха. Могут быть вентилируемые и не вентилируемые. Вентилируемые костюмы могут обеспечиваться воздухом по шлангу (например ЛГ-4&lt;ref name=&quot;РГ-1962-пк&quot; /&gt;); подача воздуха позволяет защищать рабочих от высокой температуры окружающего воздуха&lt;ref name=&quot;СИЗ-1973-3&quot; /&gt;&lt;ref name=&quot;Миронов-4-2009&quot; /&gt;. При подаче сжатого воздуха его температура может регулироваться [[:w:ru:Вихревой эффект |вихревым кондиционером]].

Одно из первых упоминаний изолирующих полностью закрытых непроницаемых костюмов, в который принудительно нагнетался воздух по шлангу, относится к периоду начала массового производства [[:w:ru:Боевые отравляющие вещества |отравляющих веществ]], обладавших [[:w:ru:Иприт|кожно-нарывным]] действием&lt;ref name=&quot;ХВ-2024&quot; /&gt;.

== Научные исследования ==
Ожидалось, что уровень защиты таких СИЗ будет высоким, и их широко использовали при [[:w:ru:Пескоструйная обработка |пескоструйных работах]]. Но [[:w:Производственные испытания респираторов |измерения коэффициентов защиты]] показывали, что по ряду причин фактическая защищённость рабочих бывает очень низкой&lt;ref name=&quot;Скляров-1937&quot; /&gt;. Этот результат объяснял причину развития [[:w:силикоз|силикоз]]а у &quot;защищённых&quot; работников. Снижение эффективности могло происходить из-за: недостаточного количества подаваемого воздуха, его плохой очистки, наличия зазоров в &quot;скафандре&quot; (в том числе из-за повреждения летящими абразивными частицами)&lt;ref name=&quot;Nelson-1975&quot; /&gt;. 

Многие исследования показали, что быстрое движение окружающего воздуха нередко приводит к &quot;поддуванию&quot; загрязнений под неплотно прилегающую лицевую часть СИЗОД, а при пескоструйных работах это происходило постоянно. В результате такую работу стали выполнять в закрытых камерах, а оператор находился снаружи, т.е. заменили ненадёжные СИЗ эффективными средствами коллективной защиты ([[:w:Средства коллективной защиты |СКЗ]]).

Позднее пневмокостюмы широко использовались в [[:w:ru:Атомная промышленность |атомной промышленности]], проводилось их изучение&lt;ref name=&quot;Городинский-1979&quot; /&gt;&lt;ref name=&quot;БМЭ-17&quot; /&gt;. Практически полное отсутствие просачивания неочищенного воздуха через зазоры обеспечило высокий уровень защиты. Испытания пневмокостюмов на предприятиях [[:w:ru:Химическая промышленность |химической промышленности]] также подтвердили хорошую защищённость работников. При работе в условиях нагревающего микроклимата подача воздуха улучшала микроклимат внутри СИЗ и увеличивала время непрерывной работы (температура воздуха 40-59°С, окружающих поверхностей 50-76°С, непрерывная работа 30-90 минут)&lt;ref name=&quot;Ильин-2016+-&quot; /&gt;.

При удачной конструкции и небольшом избыточном давлении, появление небольших отверстий не приводит к значительному прониканию загрязнений внутрь&lt;ref name=&quot;ПК-2012&quot; /&gt;&lt;ref name=&quot;ПК-2019&quot; /&gt;. Поэтому такие СИЗ используют и для работы с опасными микроорганизмами.

Использование пневмокостюмов, разработанных для атомной промышленности, обеспечило высокий уровень защиты от [[:w:ru:дихлорметан|дихлорметана]], способного попадать в организм и через кожу&lt;ref name=&quot;Хохлов-1979&quot; /&gt;. Однако исследования пневмокостюмов разных конструкций показало, что при их использовании современных (в том числе импортных, включая СИЗ, разработанный для атомной промышленности) попадание загрязнений в органы дыхания и на кожу может оказаться гораздо выше ожидаемого (декларируемого). Авторы объяснили это возможным прониканием загрязнений через отверстия для выхода воздуха наружу, и предложили устранить недостаток с помощью последовательного пропускания выходящего воздуха через два клапана, удалённых друг от друга на 30 см. По данным авторов, только такое изменение позволило повысить надёжность защиты при перемещении работника - когда он отключен от линии подачи воздуха, и внутри СИЗ нет избыточного давления&lt;ref name=&quot;Буянов-2001&quot; /&gt;.
{| class=&quot;wikitable collapsible collapsed&quot; style=&quot;text-align:center&quot;
! colspan=&quot;14&quot; | Сравнение защитных свойств разных пневмокостюмов (табл. 4.1 и 4.2&lt;ref name=&quot;Буянов-2001&quot; /&gt;)
|-
| rowspan=&quot;2&quot; | Конструктивные особенности, 

коэффициент защиты 
| colspan=&quot;13&quot; | Модель пневмокостюма
|-
| ЛГ-4 || ЛГ-5 || ''(ЛГ-5)'' || Английский ([[:w:en:Atomic Energy Research Establishment|Харвелл]]) || C-4 Япония || ЛГ-У || Шведский ([[:w:en:Trelleborg (company)|Треллеборг]]) || ПКБ-1 || ПКБ-4 || Антибелок-5 || Антибелок-5У || Антибелок-6 || Антибелок-7
|-
| Клапаны выпуска воздуха;

расстояние между ними, см 
| — || — || ''(—)'' ||  — || — || 1 || 1 || 2; 2-3 || 2; 5 || 2; 10 || 2; 15-17 || 2; 30 || 2; 30
|-
| КЗ органов дыхания || ~ 100 || ~ 100 ||  ''(~ 10&lt;sup&gt;'''5'''&lt;/sup&gt;)'' || ~ 1000-10000 || ~ 10 || ~ 1000-10000 || ~ 10000 || ~ 10000 || ~ 10&lt;sup&gt;'''5'''&lt;/sup&gt; || ~ 10&lt;sup&gt;'''6'''&lt;/sup&gt; || ~ 10&lt;sup&gt;'''7'''&lt;/sup&gt; || colspan=&quot;2&quot; | загрязнения не обнаружены
|-
| КЗ кожи || ~ 10 || ~ 10 || ''(~ 90-200)'' || ~ 100 || ~ 1-5 || ~ 1-100 || ~ 100 || ~ 100 || ~ 1000 || ~ 10000 || ~ 10&lt;sup&gt;'''5'''&lt;/sup&gt; || ~ 10&lt;sup&gt;'''7'''&lt;/sup&gt; || ~ 10&lt;sup&gt;'''6'''&lt;/sup&gt;
|- style=&quot;text-align:left&quot;
| colspan=&quot;14&quot; | Испытания проводили в аэрозольной камере на испытателях, отбор проб воздуха, загрязнённого малоопасными микроорганизмами, проводился из шлема и из подкостюмного пространства. Температура воздуха в камере 18-23°С, оптимальная подача воздуха в СИЗ 5 л/с. 

Показатели для (''ЛГ-5''), для сравнения, добавлены по данным из&lt;ref name=&quot;Городинский-1979&quot; /&gt;, см. ниже&lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;цитата&lt;div class=&quot;mw-collapsible-content&quot;&gt;&quot;«Испытания пневмокостюмов ЛГ-5 показали, что их конструкция надёжно защищает тело человека от радиоактивных аэрозолей, за исключением области клапанов, где при резких движениях (выпрямление после приседания) происходит небольшой подсос наружного воздуха в подкостюмное пространство, в результате чего отмечена загрязнённость ног до 2,4·10&lt;sup&gt;5&lt;/sup&gt; β-частиц (с площади 150 см&lt;sup&gt;2&lt;/sup&gt; в 1 мин).

Небольшое усовершенствование пневмокостюмов ЛГ-5 в виде включения в конструкцию лепесткового клапана улучшило его защитную эффективность в 25 раз: загрязнённость ног снизилась до 7×10&lt;sup&gt;3&lt;/sup&gt; β-част. /(150 см&lt;sup&gt;2&lt;/sup&gt; · 1 мин).&lt;/div&gt;
|}

Из-за того, что шланг ограничивает перемещение рабочего, для химической промышленности разработали автономный вариант&lt;ref name=&quot;СИЗ-1986-1&quot; /&gt;. А у пневмокостюма ЛГ-У была предусмотрена возможность дышать через загубник и фильтр окружающим воздухом при отключенном шланге подачи воздуха, при отказах и при переходе с одного места на другое&lt;ref name=&quot;Полоний-1980&quot; /&gt;.
[[File:Isolated protective suit.jpg|thumb|310px|right|Изолирующий костюм для использования вместе с дыхательным аппаратом]]
== Требования к СИЗ ==
В США [[:w:Национальный институт охраны труда#Институт и респираторная защита |главный орган по сертификации СИЗ органов дыхания]] не разработал никаких требований к таким средствам защиты, и не сертифицирует их вообще. 

В Европейском Союзе разработаны требования к таким СИЗ и методам их испытаний, в РФ приняты гармонизированные ГОСТы (примеры&lt;ref name=&quot;ПК-евро-2016&quot; /&gt;&lt;ref name=&quot;ПК-РФ-1&quot; /&gt;).

== Выбор и применение ==
Из-за специфичных условий использования, и сравнительно небольшого числа случаев применения (наиболее загрязнённые [[:w:ru:Рабочее место|рабочие места]] на предприятиях атомной и химической отраслей, некоторые [[:w:ru:Атомный ледокол |ледоколы]] и т.п.) общегосударственные требования к их выбору и применению в СССР не разрабатывали. Порядок выбора и использования сложился на основе накопленного опыта, и был отражён в локальных и/или отраслевых документах, примеры&lt;ref name=&quot;ПК-А-1983&quot; /&gt;&lt;ref name=&quot;ПК-А-1986&quot; /&gt;.
[[File:773rd CST suits up to support U S Navy (6389203).jpg|thumb|right|310px|Изолирующие СИЗ, костюмы и дыхательные аппараты]]

== Эффективность ==
Проводились замеры загрязнённости воздуха внутри пневмокостюмов при их использовании работниками во время трудовой деятельности. Например, по данным&lt;ref name=&quot;Гущина-10-2-3&quot; /&gt; эти СИЗ позволили надёжно защитить органы дыхания и кожу при работе с пестицидами. Так, при протравливании зерна в пневмокостюме ПШ-1 концентрация [[:w:1,2-Дибром-3-хлорпропан|немагона]] снизилась более чем в 1100 раз. Это значительно больше, чем у противогазов с маской с панорамным стеклом (коэффициенты защиты: от 11, 17, 17, 21 ... до 3498 - всего 35 замеров&lt;ref name=&quot;Tannahill-1990&quot; /&gt;), но значительно меньше, чем ожидалось по результатам  испытаний в лабораториях.

Исправные и правильно применяемые пневмокостюмы, при удачной конструкции и подаче чистого воздуха, могут защищать работника от воздушных загрязнений - но и у них на практике уровни защиты бывают значительно ниже декларируемых разработчиками и поставщиками, и получаемых в контролируемых лабораторных условиях.

== Источники ==
{{примечания|refs=
&lt;ref name=&quot;ХВ-2024&quot;&gt;{{Книга|ссылка=https://library.by/portalus/modules/warcraft/readme.php?subaction=showfull&amp;id=1623926831&amp;archive=&amp;start_from=&amp;ucat=&amp;|автор=Фрайс А. Амос, Клапенс Д. Вест|заглавие=Химическая война|ответственный=М.Н. Соболев (перевод)|год=1924|оригинал= [https://archive.org/details/chemicwar00frierich/page/272/mode/2up Chemical warfare]|часть=Глава XV. Прочие меры защиты|ссылка часть=https://www.rulit.me/books/himicheskaya-vojna-read-541582-66.html|издание=2 изд|место=Москва|издательство=Государственное военное издательство|страницы=307|страниц=518}}&lt;/ref&gt;
&lt;ref name=&quot;РГ-1962-пк&quot;&gt;{{Книга|заглавие=Радиационная гигиена|автор=Городинский С.М., Панфилова З.Е., Промптова Н.А., Саулевич Н.М., Филимонов Б.В., Фишевская Э.А., Шатский С.Н., Щербаков В.Л.|ответственный=[[:w:ru:Городинский, Семён Михайлович|Городинский С.М.]], Пархоменко Г.М., Тарасенко Н.Ю. ред|год=1962|место=Москва|издательство=Медгиз|том=1. Гигиена труда|часть= Изолирующие средства защиты работающего. В: Раздел 3. Средства индивидуальной защиты, личная гигиена, и вопросы дезактивации - Глава I. Средства индивидуальной защиты|страницы=104-107|страниц=231| серия=сборник статей|ссылка= https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1756652867&amp;archive=&amp;start_from=&amp;ucat=&amp; |тираж=6000}}&lt;/ref&gt;
&lt;ref name=&quot;Городинский-1979&quot;&gt;{{книга|автор=Городинский С.М. |заглавие= Средства индивидуальной защиты для работ с радиоактивными веществами |часть=Исследование защитной эффективности изолирующих костюмов |издание=3 изд |место=Москва |издательство=Атомиздат |год=1979|страницы=162-166|страниц=296 |тираж=5700}}&lt;/ref&gt;
&lt;ref name=&quot;БМЭ-17&quot;&gt;{{книга|автор= [[:w:ru:Городинский, Семён Михайлович|С.М. Городинский]], В.П. Михайлов. |часть= [http://бмэ.орг/index.php/ОДЕЖДА_СПЕЦИАЛЬНАЯ Одежда специальная] |часть ссылка=  |ответственный=гл. ред. Б.В. Петровский|заглавие=Большая медицинская энциклопедия |издание=3 изд |место=Москва| издательство=Советская энциклопедия |год=1981 |том=17. [http://бмэ.орг/index.php/Категория:Том_17 Ниландера проба - Остеопатии] |томов=30 |страницы=  |страниц=512 |тираж=150 800}}&lt;/ref&gt;
&lt;ref name=&quot;Скляров-1937&quot;&gt;{{Статья|автор=Скляров Ф.И.|заглавие=Новая конструкция шлема для пескоструйщиков|год=1937|издание=Гигиена труда и техника безопасности|номер=2|страницы=74-76}}&lt;/ref&gt;
&lt;ref name=&quot;Nelson-1975&quot;&gt;{{Статья|автор=Samimi B., Nelson A., Weill H. &amp; Ziskind M.|заглавие=The Efficiency of Protective Hoods Used by Sandblasters to Reduce Silica Dust Exposure|год=1975|язык=en|издание=American Industrial Hygiene Association Journal|выпуск=2|pages=140–148|volume= 36|doi=10.1080/0002889758507222}} ISSN 0002-8894, {{PMID|167570}}. [https://stacks.cdc.gov/view/cdc/245967 copy]&lt;/ref&gt;
&lt;ref name=&quot;Ильин-2016+-&quot;&gt;{{Книга|автор=[[:w:ru:Городинский, Семён Михайлович|С.М. Городинский]], Т.М. Ефремова, В.Л. Щербаков, Ю.Ф. Малахов.|заглавие=Избранные материалы &quot;Бюллетеня радиационной медицины&quot;|ответственный=[[:w:Ильин, Леонид Андреевич|Л.А. Ильин]], С.А. Самойлов ред|год=2016|часть=Опыт использования средств индивидуальной защиты в период швартовых испытаний атомного ледокола &quot;Ленин&quot;|место=Москва|издательство=ФГБУ ГНЦ ФМБЦ им. А.И. Бурназяна ФМБА России|том=1|страницы=59-70|страниц=912|isbn=978-5-905926-14-3|тираж=500}}&lt;/ref&gt;
&lt;ref name=&quot;Хохлов-1979&quot;&gt;{{Статья|автор=Хохлов Е.Н., Смородин Э.А., Миронов Л.А., Синицына И.Д.|заглавие=Опыт использования средств индивидуальной защиты от хлористого метилена|год=1979|автор издания=ЦНИИ &quot;РУМБ&quot;|место=Ленинград|издание=Технология судостроения|издательство=Центральный научно-исследовательский институт &quot;РУМБ&quot;|номер=выпуск 7|страницы=92–94}}&lt;/ref&gt;
&lt;ref name=&quot;СИЗ-1973-3&quot;&gt;{{Книга|автор=Диденко Н.С., Карпекин В.В., Ильинский Э.Г., Рыбалко А.П.|заглавие=Пути совершенствования средств индивидуальной защиты работающих на производстве|ответственный=Цуцков М.Е., Городинский С.М., Смирнов В.Ф|год=1973|часть=Разработка средств индивидуальной противопылевой защиты в промышленности|место=Москва|издательство=ВЦНИИОТ ВЦСПС|страницы=254-258|страниц=286|серия=материалы всесоюзного совещания|тираж=3000 |ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1731670742&amp;archive=&amp;start_from=&amp;ucat=&amp;}}&lt;/ref&gt;
&lt;ref name=&quot;Миронов-4-2009&quot;&gt;{{Книга|автор=Миронов Л.А. (Нижегородский НИИ гигиены и профессиональной патологии)|заглавие=Применение средств индивидуальной защиты. Методическое пособие|год=2009|часть=Изолирующие СИЗОД |место=Нижний Новгород|издательство=БИОТА-ПЛЮС|страницы=45-51 |страниц=123|isbn=978-5-902095-19-4|тираж=1000}}&lt;/ref&gt;
&lt;ref name=&quot;ПК-2012&quot;&gt;{{Статья|ссылка=https://pmc.ncbi.nlm.nih.gov/articles/PMC3446757/ |автор=Jackie A. Steward, Mark S. Lever.|заглавие=Evaluation of the Operator Protection Factors Offered by Positive Pressure Air Suits against Airborne Microbiological Challenge|год=2012|язык=en|издание=Viruses|издательство=MDPI|месяц=8|число=4|выпуск=8|pages=1202–1211|volume=4|doi=10.3390/v4081202}} ISSN 1999-4915, {{PMID|23012620}}, PMC [https://pmc.ncbi.nlm.nih.gov/articles/PMC3446757/ PMC3446757]. [https://www.researchgate.net/publication/231212347_Evaluation_of_the_Operator_Protection_Factors_Offered_by_Positive_Pressure_Air_Suits_against_Airborne_Microbiological_Challenge copy]&lt;/ref&gt;
&lt;ref name=&quot;ПК-2019&quot;&gt;{{Статья|ссылка=https://www.sciencedirect.com/science/article/pii/S2590053619300229?via%3Dihub |автор=Limei Hao, Jian-cheng Qi, Runze Wang, Ying Yi, Jinhui Wu.|заглавие=Protective performance test and safety risk evaluation of a powered air-purifying suit|год=2019|ответственный=Chinese Medical Association Publishing House|язык=en|автор издания=National Institute for Viral Disease Control and Prevention, Chinese Center for Disease Control and Prevention|издание=Biosafety and Health|издательство=Elsevier B.V.|месяц=9|выпуск=2|pages=91-97|volume=1|doi=10.1016/j.bsheal.2019.08.002}} ISSN 2590-0536. [https://www.researchgate.net/publication/335643553_Protective_performance_test_and_safety_risk_evaluation_of_a_powered_air-purifying_suit copy]&lt;/ref&gt;
&lt;ref name=&quot;Буянов-2001&quot;&gt;{{Книга|автор=Буянов В.В., Супрун И.П.|заглавие=Средства индивидуальной защиты для работ в микробиологических и вирусологических лабораториях|ответственный=научн. консульт. Т.Н. Калинин|год=2001|часть=4.1. Сравнительные исследования отечественных и зарубежных шланговых изолирующих СИЗ ; 4.2. Разработка шланговых изолирующих СИЗ с высокими защитными свойствами|место=Черноголовка|издательство=Институт проблем химической физики|страницы=86, 92|страниц=324|серия=Государственный научно-исследовательский институт биологического приборостроения|isbn=5-201-10416-7|isbn2=5-201-10416-9}}&lt;/ref&gt;
&lt;ref name=&quot;Полоний-1980&quot;&gt;{{Книга|автор=Н.Б. Борисов, [https://ru.wikipedia.org/wiki/Ильин,_Леонид_Андреевич Л.А. Ильин], У.Я. Маргулис, Г.М. Пархоменко, В.Т. Хрущ.|заглавие=Радиационная безопасность при работе с полонием-210|ответственный=И.В. Петрянов ред|год=1980|часть=7. Средства индивидуальной защиты, в: Глава 6. Гигиена труда при работе с полонием|место=Москва|издательство=Атомиздат|страницы=172-180|страниц=262|тираж=1300}}&lt;/ref&gt;

&lt;ref name=&quot;СИЗ-1986-1&quot;&gt;{{Книга|автор=Шарнин Г.П., Жиляев Г.Г., Жуков В.И., Козлов И.Л., Иванова Р.С., Булюхина М.М.|заглавие=Разработка средств индивидуальной защиты для работников химической промышленности и методов их оценки |ответственный=Бутова Т.Н. отв. ред|год=1986|часть=Пути совершенствования автономных комплектов|место=Черкассы|издательство=ВНИИТЭХИМ |страницы=12-13|страниц=105|серия=Тезисы докладов Всесоюзной конференции, Северодвинск, октябрь 1986 г.|тираж=300 |ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1731670742&amp;archive=&amp;start_from=&amp;ucat=&amp;}}&lt;/ref&gt;
&lt;ref name=&quot;ПК-евро-2016&quot;&gt;{{Книга|автор=CEN / Technical Committee 162 - Protective clothing including hand and arm protection and lifejackets: WG 3 - Protective clothing against chemicals, infective agents and radioactive contamination.|ссылка=https://knowledge.bsigroup.com/products/protective-clothing-against-solid-airborne-particles-including-radioactive-contamination-requirements-and-test-methods-for-compressed-air-line-ventilated-protective-clothing-protecting-the-body-and-the-respiratory-tract?version=standard|заглавие=BS EN 1073-1:2016+A1:2018 Protective clothing against solid airborne particles including radioactive contamination - Requirements and test methods for compressed air line ventilated protective clothing, protecting the body and the respiratory tract|ответственный=European Committee for Standardization|год=2016|язык=en|место=Brussels|издательство=British Standards Institution|allpages=13|серия=ICS 13.280; 13.340.10|isbn=978 0 580 98704 5}}&lt;/ref&gt;
&lt;ref name=&quot;ПК-РФ-1&quot;&gt;{{Книга|автор=Институт биофизики Минздрава Российской Федерации|заглавие=ГОСТ Р 12.4.196-99. ССБТ. Костюмы изолирующие. Общие технические требования и методы испытаний|ответственный=ТК-320 СИЗ|год=1999|место=Москва|издательство=ИПК Издательство стандартов|страниц=16|серия=ОКС 13.340.01|тираж=402|ссылка=https://meganorm.ru/Index2/1/4294814/4294814109.htm}} [https://meganorm.ru/Data2/1/4294814/4294814109.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;ПК-А-1983&quot;&gt;{{Книга|автор=Гольдштей Д.С., Кощеев В.С.|заглавие=Организация индивидуальной защиты в атомной промышленности|ответственный=Синьковский В.В рецензент|год=1983|часть=3.3. Применение изолирующих костюмов. В: Глава 3. Особенности применения отдельных видов СИЗ|место=Москва|издательство=Энергоатомиздат|страницы=42-45|страниц=96|тираж=2200}}&lt;/ref&gt;
&lt;ref name=&quot;ПК-А-1986&quot;&gt;{{Книга|автор=В.Н. Бескрестнов составитель.|заглавие=Методическое руководство по индивидуальной защите персонала атомных станций и физиолого-гигиенические требования к изолирующим средствам индивидуальной защиты|год=1986|часть=3.3. Применение изолирующих костюмов|издание=Выпуск 10|место=Москва|издательство=Энергоатомиздат|страницы=15-17|страниц=48|серия=Библиотека эксплуатационщика АЭС|тираж=6300}}&lt;/ref&gt;
&lt;ref name=&quot;Гущина-10-2-3&quot;&gt;{{Книга |автор=Гущина Татьяна Викторовна |заглавие=Методология разработки и испытаний средств индивидуальной защиты |ответственный=рецензенты Киричек А.В., Шарупич Т.С. |год=2007 |часть=10.2.3 Средства защиты от токсичных веществ (Пневматические средства защиты). В: 10 Производственная апробация средств индивидуальной защиты в условиях АПК, разработка рекомендаций. 10.2 Проведение производственных испытаний |место=Орёл |издательство=Издательство ОрёлГАУ |страницы=274-278 |всего страниц=330 |серия=Монография |тираж=100}}&lt;/ref&gt;
&lt;ref name=&quot;Tannahill-1990&quot;&gt;{{статья|автор=Tannahill S.N., R.J. Willey and M.H. Jackson|заглавие=Workplace Protection Factors of HSE Approved Negative Pressure Full-Facepiece Dust Respirators During Asbestos Stripping: Preliminary Findings|ссылка=http://annhyg.oxfordjournals.org/content/34/6/ |язык=en |автор издания=The British Occupational Hygiene Society|издание=The Annals of Occupational Hygiene |место=Oxford, UK|издательство=Oxford University Press|год=1990|том=34 |номер=6|страницы=541—552|issn= |doi= 10.1093/annhyg/34.6.547}} ISSN 1475-3162&lt;/ref&gt;

}}
[[Категория:Средства индивидуальной защиты (обзорная лекция)]]</text>
      <sha1>pcx01be07744oxld8gy4x7ixoos63iw</sha1>
    </revision>
  </page>
  <page>
    <title>Средства индивидуальной защиты (обзорная лекция)/СИЗ органов дыхания</title>
    <ns>0</ns>
    <id>35625</id>
    <revision>
      <id>270425</id>
      <parentid>269049</parentid>
      <timestamp>2026-10-27T07:08:09Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270425</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="118097" sha1="ca1jcapemq5d7zm1a79x3j3lgcgryli" xml:space="preserve">[[File:Надевание самоспасателя шахтёром.jpg|thumb|right|300px|СИЗ органов дыхания (самоспасатели) используют '''лишь тогда''', когда применение других средств защиты невозможно]]
'''Средства индивидуальной защиты органов дыхания''' - вид [[:w:Средства индивидуальной защиты|средств индивидуальной защиты]], предназначенный для обеспечения работника пригодным для дыхания воздухом в загрязнённой атмосфере и/или при недостатке кислорода. 

В зависимости от лицевой части (полумаска, маска, шлем или капюшон) могут также использоваться для защиты органов зрения, лица и головы.

Обзор научных публикаций на русском языке (наибольший охват по времени с 1936 по 2016 гг.)&lt;ref name=&quot;Кириллов-2018&quot; /&gt; показал:
* Высококачественные [[:w:автономный дыхательный аппарат| дыхательные аппараты]], нечасто используемые обученными и тренированными специалистами, сильно снижают риск острых отравлений, и могут устранить его полностью.
* Повседневно применяемые при сравнительно небольшой загрязнённости воздуха фильтрующие СИЗОД, часто неправильно выбираемые, могут заметно снизить профзаболеваемость &lt;u&gt;исключительно редко&lt;/u&gt;. 
* Редко используемые не всегда хорошо обученными рабочими [[:w:самоспасатель|самоспасатели]], и при высоком качестве могут оказаться бесполезны. Условия труда, и большая масса, могут мешать держать рядом постоянно. При аварии их может быть трудно найти; в условиях стресса люди могут допустить опасные ошибки при их надевании и включении.
* При обосновании высокой эффективности и профилактической ценности СИЗОД часть авторов использовала некорректные методы: искажали содержание источников информации, при наличии разной информации выбирали &quot;удобную&quot;, игнорируя другую и т.п. В других публикациях эффективность доказывалась ссылками на упомянутые выше работы&lt;ref name=&quot;Кириллов-2018&quot; /&gt;. 

В целом, СИЗОД нельзя считать альтернативой [[:w:средства коллективной защиты|средствам коллективной защиты]]&lt;ref name=&quot;Конвенция148&quot; /&gt;.

== Научные исследования ==
=== Значительное отличие защитных свойств в лабораторных и реальных условиях ===
[[File:Workplace Protection Factors Measurements.jpg||thumb|300px|Замер эффективности респиратора (на рабочем месте). Обозначения: (1) [[:w:Персональный пробоотборник воздуха|Персональный пробоотборный насос]], (2) Кассета и фильтр для определения концентрации (в зоне дыхания), (3) Кассета и фильтр для определения концентрации (под маской), (4) Линия отбора проб (из зоны дыхания), (5) Линия отбора проб (из маски). Одновременное измерение концентрации вредных веществ во вдыхаемом воздухе (под маской) и в зоне дыхания позволяет оценить вклад респиратора в уменьшение воздействия воздушных загрязнений]]
Начиная с 1970-х в развитых странах начали [[:w:Производственные испытания респираторов |проводить исследования]] для определения коэффициента защиты СИЗ органов дыхания, не только в лабораторных условиях, но и непосредственно на рабочих местах. Обычно одновременно отбирали две пробы воздуха, из маски и снаружи, определяли отношение концентраций воздушных загрязнений во вдыхаемом воздухе и в окружающем, а отношение второй к первой считали коэффициентом защиты. При проведении исследований именно для определения эффективности СИЗОД все работники были обучены, маски [[:w:Проверка изолирующих свойств респираторов|индивидуально подобраны]], респираторы исправны, при защите от газов [[:w:Способы замены противогазных фильтров респираторов|фильтры меняли вовремя]], во время замера за каждым работников непрерывно наблюдали (если маска снималась или поправлялась - результат измерений не учитывали). Все исследования, проводившиеся компанией 3М, показывали высокий уровень защиты (её продукции). А несколько исследований, проведённых специалистами по профзаболеваниям, выявили настолько плохую защиту рабочих, что [[:w:Ожидаемые коэффициенты защиты респираторов |области допустимого применения]] некоторых СИЗОД уменьшили в десятки раз&lt;ref name=&quot;КЗ-2019&quot; /&gt;.

Такие исследования проводили и в СССР, начав их гораздо раньше, чем на западе. Но их проводили не систематично, а главное - результаты не использовали для установления границ допустимого применения респираторов, так, чтобы рабочим не выдавали заведомо ненадёжные средства защиты. Многие исследования выявляли недостаточную эффективность СИЗОД даже при своевременном применении (что не всегда возможно).

Поскольку у самых распространённых СИЗОД (фильтрующих, без принудительной подачи воздуха в маску) защитные свойства сильно зависят от способности маски плотно, без зазоров прилегать к лицу, и не сползать во время работы, были изучены разные способы [[:w:Проверка изолирующих свойств респираторов|обнаружения зазоров между маской и лицом]]&lt;ref name=&quot;Crutchfield-2000&quot; /&gt;. В США (приложение А&lt;ref name=&quot;СИЗОД-США+&quot; /&gt;) с 1980-х годов, и в других развитых странах позднее, эти индивидуальные проверки стали обязательными для всех случаев использования СИЗОД работниками в опасной атмосфере.

=== Замена противогазных фильтров ===
[[File:Respirator canister with ESLI for asid gases -10.JPG|right|thumb|250px|Фильтр, заранее предупреждающий об окончании срока службы. Внизу: сорбент, меняющий цвет при насыщении; вверху: активированный уголь даёт запас времени при насыщении 1 слоя.]]В начале 20-го века считалось, что работник может обнаружить момент окончания срока службы фильтра по появлению запаха вредного газа в маске, и сможет поменять фильтр вовремя. Кроме того, никаких других способов замены фильтров в то время не было.

Затем применение этого способа ограничили защитой от газов, у которых есть &quot;хорошие предупреждающие свойства&quot; (запах, раздражение органов дыхания и/или глаз и т.п.). Однако оказалось, что из-за привыкания, отвлечения внимания на выполнение работы, пониженной индивидуальной чувствительности, хотя бы часть рабочих меняет фильтры запоздало, и портит здоровье. Поэтому с 1990-х [[:w:b:ru:Замена_противогазных_фильтров_СИЗОД_(лекция)#ZAPAH|использование ненадёжной реакции органов чувств запретили полностью]].

В результате длительных исследований, и использования результатов испытаний фильтров их производителями, в [[:w:Лос-Аламосская национальная лаборатория#СИЗОД|научном атомном центре США]] был разработан алгоритм и написана универсальная программа для установки на компьютер, [[:w:b:ru:Замена_противогазных_фильтров_СИЗОД_(лекция)#современные-методы|позволяющие вычислять срок службы фильтра с известными свойствами в известных условиях]]. Алгоритм был использован ведущими производителями СИЗОД для создания собственных программ&lt;ref name=&quot;Лекция&quot; /&gt;. При расчёте срока службы в условиях высокой относительной влажности воздуха алгоритм может дать ошибочный результат, недооценивая снижение срока службы из-за полного заполнения пор сорбента водой.

[[File:Миграция токсичных газов в фильтре респиратора при хранении.jpg|left|thumb|250px|[[:w:Компьютерная томография|Томография]] показывает концентрации газов и их перемещение в сорбенте при хранении фильтра&lt;ref name=&quot;Berezovska-2015&quot; /&gt;&lt;ref name=&quot;Капцов-2022&quot; /&gt;&lt;ref&gt;На графиках по горизонтальной оси - расстояние в слое сорбента, по вертикальной оси - относительная концентрация одного или двух газов (суммарно), получившаяся при использовании компьютерной томографии&lt;/ref&gt;]]
При повторном использовании фильтров работник может отравиться из-за десорбции накопившегося при первом применении токсичного вещества, в развитых странах стараются запретить неоднократное использование (кроме случаев, когда доказано, что это безопасно), см. графики слева&lt;ref name=&quot;Капцов-2022&quot; /&gt;.

Из-за сочетания субъективных, а также объективных причин, выпуск устройств, заблаговременно предупреждающих работника о необходимости заменять фильтр, практически прекращён ([[:w:b:ru:Замена_противогазных_фильтров_СИЗОД_(лекция)#ESLI|End of Service Life Indicator, ESLI]]).

Использование современных высококачественных фильтрующих СИЗ органов дыхания, с 2014 года полумасок 3М серии 6000, а с 2018 года СИЗОД с принудительной подачей отфильтрованного воздуха - не позволило устранить или даже сильно, заметно снизить профессиональную заболеваемость органов дыхания при электролизном получении никеля ([[:w:Кольская горно-металлургическая компания|Кольская ГМК]]), за 2004-19 гг. 190 случаев у 130 рабочих&lt;ref name=&quot;Сюрин-ГиС-2025&quot; /&gt;.

=== Ограничения применения из-за негативного влияния СИЗОД на работников ===
Применение [[:w:Средства индивидуальной защиты|СИЗ]] органов дыхания оказывает неблагоприятное воздействие на работника. Нагрузка, создаваемая тяжёлыми [[:w:Автономный дыхательный аппарат|автономными дыхательными аппаратами]], повышенная температура вдыхаемого воздуха (у дыхательных аппаратов с закрытым контуром); сопротивление вдоху и выдоху; высокое содержание углекислого газа и пониженное содержание кислорода в воздухе, вдыхаемом из маски, и другие факторы оказывают негативное влияние на работника. В результате, если при планировании работы не учли влияние СИЗОД, с большой вероятностью может оказаться, что хотя бы часть людей не сможет использовать их непрерывно и своевременно при выполнении работы в загрязнённой атмосфере. Соответственно, защитный эффект может сильно снизиться.

В четвёртом издании английского учебника по выбору и использованию СИЗОД рекомендуется организовать работу так, чтобы при использовании (самых распространённых и недорогих) фильтрующих СИЗОД без принудительной подачи воздуха в лицевую часть работники использовали их непрерывно не более 1 часа. При необходимости непрерывно работать в загрязнённой атмосфере больше часа следует использовать СИЗОД с принудительной подачей отфильтрованного воздуха в лицевую часть вентилятором&lt;ref name=&quot;Великобритания-2013&quot; /&gt;. Это улучшает газовый состав вдыхаемого воздуха (&quot;выдувая&quot; из маски насыщенный углекислым газом выдохнутый воздух), и снижает сопротивление дыханию.

В немецкую версию первого издания стандарта Европейского Союза включили выдержку из &quot;Технических правил по опасным веществам, TRgA 415&quot;, раздел &quot;Ограничение длительности использования средств защиты органов дыхания и изолирующих защитных костюмов без теплообменника&quot;. Для фильтрующих СИЗОД без принудительной подачи воздуха длительность непрерывного применения ограничена двумя часами, затем перерыв для восстановления, до 30 минут&lt;ref name=&quot;EN-529-1993&quot;&gt;{{Книга |автор=Technisches Komitee (TC) 79 „Atemchutzgerate“. |заглавие=ÖNORM  CR 529:1993. Anleitung zur Auswahl und Anwendung von Atemschutzgeräten |ответственный=European Committee for Standardization |год=1993 |часть=Приложение 4. Ограничения по времени применения средств индивидуальной защиты органов дыхания ''(Anhang 4: Tragezeitbegrenzungen von Atemschutzgeräten)'' |язык=de |издание=1 Auflage |место=Brüssel |издательство=Deutsches Institut für Normung |seite=115-116 |alleseiten=120 |серия=Deutsche Fassung}}&lt;/ref&gt;, фрагмент ниже. 
{| class=&quot;wikitable collapsible collapsed&quot; style=&quot;text-align:center&quot;
! colspan=4 | Таблица 15
|-
! Средство индивидуальной защиты !! Продолжительность использования !! Длительность отдыха (восстановления) !! Задания за 8-часовую смену
|-
| Костюмы изолирующие без теплообмена, с дыхательным аппаратом со сжатым воздухом, или с фильтрующим СИЗОД || Максимум 30 минут || Не менее 90 минут, включая время на одевание и раздевание. Никакой физической работы. || Если легкая работа, то 2 задания; 
если каждое задание выполняется менее 15 минут, то 3 задания
|-
| rowspan=3 | Автономный дыхательный аппарат со сжатым воздухом || Время работы ограничен запасом воздуха и нагрузкой на работника
 ||  ||  
|-
| Лёгкая работа и работа средней тяжести – более 30 минут || 30 минут || 4 задания
|-
| Тяжёлая работа – до 30 минут || 60 минут || 4 задания
|-
| Изолирующий дыхательный аппарат с закрытым контуром и массой '''более''' 5 кг || В зависимости от сложности работы её максимальная длительность должна быть не более 120 минут. || 120 минут || 2 задания
|-
| Изолирующий дыхательный аппарат с закрытым контуром и массой '''менее''' 5 кг || Время работы ограничивается и запасом кислорода, и нагрузкой на работника. || Время отдыха должно быть не меньше длительности выполнения задания. || 4 задания
|-
| Шланговые СИЗОД с клапанами вдоха и выдоха (шланговые противогазы, шланговые СИЗОД с подачей сжатого воздуха) || Зависит от сложности работы. Из-за меньшей массы нагрузка на работника меньше, чем у автономных дыхательных аппаратов; до 120 минут || до 30 минут || Нет ограничений  
|-
| Фильтрующие СИЗОД || Зависит от затруднения дыхания и от тяжести выполняемой работы. Написанное ниже не учитывает срок службы противогазного фильтра: не более 120 минут. || до 30 минут || Нет ограничений
|}
Также указано, что длительность работы зависит и от многих других факторов, например от температуры воздуха.

Специалисты НИИ охраны труда провели исследование влияния фильтрующих СИЗОД на молодых людей (возраст 21-23 года). Выполнялась физическая и операторская работа, 15 и 6 минут, затем всё повторялось. Два из шести здоровых участников, с плохой физической подготовкой, оказались не способны длительное время использовать противогаз, и прекратили эксперимент (у одного обнаружилась кровь в моче). Были сделаны выводы: людей с плохой физической подготовки (т.е. без проверки) не следует привлекать к выполнению физической работы, требующей использования СИЗОД, и общая длительность использования СИЗ не должна превышать 3 часа за смену&lt;ref name=&quot;Фаустов-2003&quot;&gt;{{статья|автор=Фаустов С.А., Андреев К.А|заглавие=Разработка режима труда и отдыха при использовании тяжелых средств индивидуальной защиты органов дыхания|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1762615589&amp;archive=&amp;start_from=&amp;ucat=&amp;|автор издания=ФГБНУ «НИИ медицины труда» и Роспотребнадзор|издание=Медицина труда и промышленная экология|место=Москва|издательство=|год=2003|номер=2|страницы=25-31|issn=}} ISSN 0016-9919&lt;/ref&gt;.

== Требования к респираторам и сертификация ==
[[Файл:Fire Test (6648737493).jpg|thumb|right|350px|После воздействия открытого огня]]Для предотвращения продажи некачественных СИЗ разрабатывают требования к их техническим характеристикам, минимальные, которые должны выполнять изготовители и поставщики. Требования могут включать в себя описание способов испытаний, тестирующего оборудования, обработку результатов измерений и указания по маркировке. Строгое выполнение всех этих требований не гарантирует безопасность работника, так как они не могут исключать ошибки при выборе и использовании СИЗ (рассмотрено ниже). 

Проверка соответствия СИЗ минимальным техническим требованиям может проводиться в одной ответственной и компетентной организации (''например, в Северной Америке СИЗОД испытывает [[:w:Национальный институт охраны труда|Национальный институт охраны труда]] в составе Министерства здравоохранения''), или в аккредитованных лабораториях, в разных странах по-разному. Требования к СИЗ обычно разрабатывают с участием компетентных специалистов по СИЗ. Поскольку многие из них тесно связаны и/или непосредственно работают в компаниях, изготавливающих и торгующих СИЗ, то потенциально возможен [[:w:Конфликт интересов |конфликт интересов]].

* '''&lt;big&gt;Международная организация по стандартизации (ИСО) &lt;/big&gt;'''
[[:w:Международная организация по стандартизации |ИСО]] разработала более 30 стандартов по СИЗОД. Предполагается, что эти документы станут основой для разработки гармонизированных национальных стандартов в разных странах.

Часть стандартов имеет существенные недостатки, и по некоторым положениям не соответствует ни современному уровню науки, ни современным требованиям к СИЗОД в ведущих развитых странах&lt;ref name=&quot;БТП-2021&quot; /&gt;. В отношении противогазных фильтров, ни в одной из стран нет требований к устройствам, которые заранее предупреждают рабочих о необходимости их заменять. [[:w:Способы замены противогазных фильтров респираторов#ESLI|''End of Service Life Indicators, ESLI'']] должны срабатывать до того, как будет использовано 90 % срока службы — чтобы рабочий успел уйти из загрязнённой атмосферы&lt;ref name=&quot;NIOSH-ESLI-1&quot; /&gt;. У пассивных индикаторов чувствительный элемент должен располагаться так, чтобы рабочий видел его при одетом респираторе&lt;ref name=&quot;NIOSH-ESLI-2&quot; /&gt;. Все индикаторы должны сохранять работоспособность при падении на твёрдый пол с высоты 1,8 м&lt;ref name=&quot;NIOSH-ESLI-3&quot; /&gt;. 

* '''&lt;big&gt; США &lt;/big&gt;'''
[[File:Сертификация СИЗОД для ЧС.jpg|thumb|right|350px|Замер защитных свойств при сертификации ([[:w:Национальный институт охраны труда#Институт и респираторная защита |''NIOSH'']])]]Сертификация [[:w:СИЗОД|СИЗ органов дыхания]] проводится с 1920 г. После создания [[:w:Национальный институт охраны труда |Национального института охраны труда]] ''(NIOSH)'' в 1970-х разработку требований и сертификационные испытания выполняет лаборатория СИЗ Института.

Требования к всем типам СИЗОД установлены в одном документе&lt;ref name=&quot;СИЗОД-СШАc&quot; /&gt; (в разных разделах требования к разным типам). Для испытаний заявитель обязан представить план контроля качества при производстве СИЗОД, Институт может проверить выполнение плана в любой момент, и при нарушении - аннулировать уже выданный сертификат. 

Сертификация [[:w:Самоспасатель#Самоспасатели_для_шахтёров |шахтёрских изолирующих самоспасателей]] предусматривает [[:w:s:ru:Требования к респираторам при их сертификации (США)#84.310|послесертификационные проверки качества]]: часть купленных потребителями изделий забирается у них (взамен им дают новые, те же модели), и испытывается.

Разработаны требования и проводится сертификация противогазных фильтров с устройствами, заранее предупреждающими работников о необходимости менять фильтр, т.к. далеко [[:w:b:ru:Замена_противогазных_фильтров_СИЗОД_(лекция)#ZAPAH|не всегда можно вовремя обнаружить окончание срока службы по появлению запаха в маске]] и т.п. Ни в одной из других стран нет требований к устройствам, предупреждающих рабочих о необходимости заменять фильтры. [[:w:Способы замены противогазных фильтров респираторов#ESLI|''End of Service Life Indicators, ESLI'']] должны срабатывать до того, как будет использовано 90 % срока службы — чтобы рабочий успел уйти из загрязнённой атмосферы&lt;ref name=&quot;NIOSH-ESLI-1&quot; /&gt;. У пассивных индикаторов чувствительный элемент, меняющий цвет, должен располагаться так, чтобы рабочий видел его при одетом респираторе&lt;ref name=&quot;NIOSH-ESLI-2&quot; /&gt;. Все индикаторы должны сохранять работоспособность при падении на твёрдый пол с высоты 1,8 м&lt;ref name=&quot;NIOSH-ESLI-3&quot; /&gt;. 

Сертификация фильтрующих самоспасателей (для защиты при пожарах) не предусмотрена.

* '''&lt;big&gt; Канада &lt;/big&gt;'''
В соответствии с&lt;ref name=&quot;CSA-2018&quot; /&gt; работодатели обязаны использовать только сертифицированные СИЗОД. Учтя наличие рядом квалифицированных специалистов и мощную испытательную лабораторию, стандарт Канады требует от работодателей, чтобы СИЗ испытывались в [[:w:Национальный институт охраны труда |Институте охраны труда]] (''NIOSH'', США), а в Канаде испытания СИЗОД не проводят. Поэтому канадские требования совпадают с американскими&lt;ref name=&quot;СИЗОД-СШАc&quot; /&gt;.

Из-за перегрузки NIOSH во время &quot;пандемии&quot; в Канаде начали сертифицировать фильтрующие противоаэрозольные СИЗОД самостоятельно, разработав свой стандарт&lt;ref name=&quot;CSA-2021&quot; /&gt; с требованиями к ним.

* '''&lt;big&gt; Европейский Союз '''&lt;/big&gt;
Требования к СИЗ, разных конструкций, установлены в множестве отдельных стандартов, которые часто пересматриваются, постепенно увеличиваясь и усложняясь. 

У самых распространённых СИЗОД, без принудительной подачи воздуха, при выдохе маска заполняется вредным веществом, [[:w:Диоксид_углерода#Физиологическое_действие|углекислым газом]], при концентрации на порядок превышающей предельно допустимую среднесменную. Затем СО&lt;sub&gt;2&lt;/sub&gt; вдыхается снова. В требованиях к свойствам респираторов установлен критерий: средняя концентрация этого газа при вдохе не должна превышать 1% по объёму, что вдвое выше предельно допустимой. А в методе измерений требуется отрегулировать объём вдоха имитатора дыхания 2 литра, что соответствует очень тяжёлой физической работе, выполнение которой длительное время сейчас нетипично для большинства работ. При аномально большом объёме вдоха СО&lt;sub&gt;2&lt;/sub&gt; из маски сильно разбавляется, и его концентрация обычно соответствует критерию&lt;ref name=&quot;Капцов-2021&quot; /&gt;. Результат: СИЗ успешно сертифицируют, о возможной опасности потребителей не предупреждают, и при длительном применении часть рабочих не выдерживает, и снимает маски - или страдает от головных болей&lt;ref name=&quot;AN-2006&quot; /&gt; и др. последствий [[:w:Диоксид_углерода#Физиологическое_действие|отравления углекислым газом]]. По сути, недостаток, способный помешать работникам своевременно использовать СИЗОД - замалчивается. В РФ приняты такие же гармонизированные стандарты.

* '''&lt;big&gt; Австралия и Новая Зеландия &lt;/big&gt;'''
Для сертификационных испытаний используют один стандарт, где в разных разделах есть требования к СИЗОД разных типов&lt;ref name=&quot;ANZ-СИЗОД-тест&quot; /&gt;.

Так как было установлено, что СИЗОД с полнолицевой маской с панорамным стеклом, у которых во время вдоха нет избыточного давления в маске, плохо защищают [[:w:Горноспасательное дело|работающих при опасной для жизни загрязнённости воздуха]], сертификация таких [[:w:автономный дыхательный аппарат |автономных дыхательных аппаратов]] прекращена. Для сравнения, в РФ даже нет требований к дыхательным аппаратам с химически связанным кислородом, поддерживающим избыточное давление в маске во время вдоха, и их могут использовать [[:w:горноспасатель |горноспасатели]] в особо опасной атмосфере.

Стандарт допускает сертификацию противогазных фильтров с очень маленьким количеством [[:w:сорбенты|сорбента]]. Они могут защищать от некоторых вредных веществ при их низкой концентрации, при этом совершенно не соответствуя европейским требованиям к противогазным фильтрам: проскок токсичных веществ может происходить почти сразу&lt;ref name=&quot;Haupt-2006&quot; /&gt;.

* '''&lt;big&gt; Япония &lt;/big&gt;'''
Разработаны стандарты с минимальными требованиями к СИЗОД разных типов (например к фильтрующим: противогазным&lt;ref name=&quot;Japan-gas&quot; /&gt; и противоаэрозольным&lt;ref name=&quot;Japan-dust&quot; /&gt;).

* '''&lt;big&gt; Индия &lt;/big&gt;'''
Есть стандарты с требованиями к техническим характеристикам и с методами испытаний СИЗОД и комплектующих (примеры: маски&lt;ref name=&quot;Индия-полумаска&quot; /&gt;, фильтры&lt;ref name=&quot;Индия-фильтр&quot; /&gt;). В целом, стандарты разрабатываются на основе иностранных, преимущественно европейских, но не являются точной копией.

* '''&lt;big&gt; Китай &lt;/big&gt;'''
Требования к СИЗОД разных типов, их испытаниям и др. сформулированы в разных стандартах (пример: фильтрующие полумаски промышленные&lt;ref name=&quot;КНР-СИЗОД-ФПМ&quot; /&gt;, автономные дыхательные аппараты&lt;ref name=&quot;КНР-SCBA&quot; /&gt;), как в Европейском Союзе. При разработке стандартов широко используются стандарты ЕС и подходы, принятые в США.

* '''&lt;big&gt; РФ &lt;/big&gt;'''
[[Средства индивидуальной защиты (обзорная лекция)/Общая информация#СССР и РФ|Разрабатываются государственные стандарты]], гармонизированные со стандартами ЕС. Их добровольное выполнение необходимо для соответствия требованиям [https://miningwiki.ru/wiki/%D0%A2%D0%B5%D1%85%D0%BD%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B9_%D1%80%D0%B5%D0%B3%D0%BB%D0%B0%D0%BC%D0%B5%D0%BD%D1%82_%22%D0%9E_%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D0%B8_%D0%A1%D0%98%D0%97%22 Технического Регламента]&lt;ref name=&quot;ТР-2009&quot; /&gt;. 

[[File:Сертификат на респиратор Лепесток.JPG|thumb|right|300px|Сертификат абсурдного содержания]]Для проверки соответствия изделия испытываются в [[:w:Аккредитация|аккредитованных]] лабораториях, и затем орган по сертификации выдаёт сертификат. На практике, эта система работает так, что даже содержание сертификатов может быть абсурдным&lt;ref name=&quot;Кириллов-2013&quot; /&gt;).. Например, при испытании фильтрующей полумаски &quot;Лепесток&quot; был выдан сертификат, в котором указали, что изделие одновременно соответствует требованиям к: фильтрующим полумаскам, полнолицевым маскам с панорамным стеклом, эластомерным полумаскам, и полумаскам с несъёмными противогазными фильтрами (показан на иллюстрации справа). 

Наличие разных органов, проводящих сертификацию, позволяет, в случае неудачи, обратиться в другой орган - не улучшая изделие. Возможно изготовление небольшой партии повышенного качества для обеспечения успешной сертификации&lt;ref name=&quot;Сорокин-2011&quot; /&gt;.

== Выбор и использование ==
Индивидуальная защита органов дыхания в разных странах, включая требования к их выбору, рассмотрена в обзоре&lt;ref name=&quot;Капцов-2020&quot; /&gt;. 

Во многих странах нет достаточно полноценного учёта значительных [[:w:Производственные испытания респираторов|отличий защитных свойств в лабораторных и реальных условиях]], и эффективных требований к [[:w:Проверка изолирующих свойств респираторов|проверке соответствия маски лицу и умения работников правильно её надевать]].

Но и при наличии адекватных представлений об [[:w:Ожидаемые коэффициенты защиты респираторов|фактической степени защиты СИЗОД разных типов в производственных условиях]], необходима точная информация о загрязнённости воздуха, о степени превышения концентрации загрязнений по отношению к предельно допустимой. Из-за того, что концентрация загрязнений редко бывает постоянной во времени и в пространстве, уже в 1970-х годах было показано, что замеры около головы работника в течение всей смены дадут самый точный результат&lt;ref name=&quot;Руководство 1976г&quot; /&gt;. Это соответствует результатам проведённых в РФ исследований: по данным&lt;ref name=&quot;Федорук-2025&quot; /&gt;, сравнение результатов измерений персональными пробоотборниками с результатами измерений, выполненными при проведении специальной оценке условий труда, обнаружило занижение воздействия на работников вредных веществ, свинца до 143 раз, и мышьяка до 60 раз.

Недостаточно качественная оценка риска в РФ&lt;ref name=&quot;Кириллов-2016в&quot; /&gt;, измерение загрязнённости воздуха стационарными приборами, и/или отбор проб не около лица рабочего, также может привести к не выдаче рабочим СИЗОД когда они необходимы, и к неправильному выбору типа СИЗОД по защитным свойствам.
[[File:Испытания СИЗОД для ЧС сертификационные.jpg|thumb|right|310px|Даже высококачественные сертификационные испытания (в лаборатории) - не гарантируют надёжную защиту людей (на рабочих местах)]]
* '''&lt;big&gt; США &lt;/big&gt;''' 
[[:w:Управление по охране труда (OSHA)|Департамент условий и охраны труда]] разработал требования к выбору и использованию СИЗ органов дыхания. [[:w:OSHA|Государственная инспекция]] проверяет их выполнение, используя инструкцию&lt;ref name=&quot;CPL-СИЗОД&quot; /&gt;.

Требования к выбору и использованию респираторов&lt;ref name=&quot;СИЗОД-США+&quot; /&gt; обязывают работодателей:
# Выбирать тип СИЗОД так, чтобы учесть [[:w:Ожидаемые коэффициенты защиты респираторов|научно обоснованные ограничения]], разработанные при проведении [[:w:Производственные испытания респираторов|десятков исследований фактической защиты рабочих на заводах]].
# Давать каждому рабочему возможность выбрать подходящую и удобную маску из нескольких, и затем обязательно [[:w:Проверка изолирующих свойств респираторов|проверять, насколько плотно, без зазоров она прилегает к лицу]], отделяя органы дыхания от окружающей атмосферы.
# Не допускать [[:w:b:ru:Замена противогазных фильтров СИЗОД (лекция)|замены противогазных фильтров]] на основе субъективной и ненадёжной реакции органов чувств на появление запаха в маске, раздражения и т.п.

* '''&lt;big&gt; Канада  &lt;/big&gt;''' 
Стандарт&lt;ref name=&quot;CSA-2018&quot; /&gt; содержит требования к выбору и организации использования СИЗОД всех типов. Области применения установлены такие же, как и в США, т.е. с учётом отличий защитных свойств в лабораторных условиях и на практике. Этот стандарт - единственный, где есть конкретные указания по выбору типа СИЗОД для защиты от биологических аэрозолей с учётом их опасности.

Замена противогазных фильтров по появлению запаха в маске - запрещена, их меняют по расписанию, или по показаниям [[:w:Способы_замены_противогазных_фильтров_респираторов# Замена_по_показаниям_Индикаторов_Окончания_Срока_Службы_(End_of_Service_Life_Indicators,_ESLI)| индикатора окончания срока службы (''ESLI'')]].

* '''&lt;big&gt; Европейский Союз &lt;/big&gt;''' 
Разработан стандарт с требованиями к выбору и организации применения СИЗОД. Особенности документа&lt;ref name=&quot;EN-529&quot; /&gt; по сравнению с требованиями в США и Канаде:

- Области допустимого применения ([[:w:ожидаемые коэффициенты защиты респираторов|ожидаемые коэффициенты защиты]]) для разных стран указаны разные. Отличие настолько велико, и во многих случаях так сильно превышает научно обоснованные американские ограничения, что видно, что во многих странах, где не измеряли защитные свойства респираторов у работников на заводах, не учли отличие лабораторной и реальной эффективности (или учли частично). В результате новые члены ЕС, и страны, использующие стандарты ЕС как образец, принимая свои национальные стандарты, и не ознакомившись с современным уровнем науки в этой области, просто скопировали соответствующие места текста. В результате стандарты Болгарии БДС EN 529 и Украины ДСТУ EN 529 не дают никакой информации читателям - в каких случаях какие типы СИЗОД следует использовать.

- Замена противогазных фильтров по запаху запрещена как &quot;ненадёжная&quot;. Должны использоваться или индикаторы срока службы, или замена по расписанию. При этом требований к индикаторам (''ESLI'') в ЕС (в отличие от США) нет вообще, т.е. потребителям предлагается использовать не сертифицированные изделия. У фильтра 3М для защиты от органических соединений есть индикатор, который предупреждает работников, но для разных токсичных газов - при разной концентрации. При оценке его работы и российских предельно допустимых концентрациях получилось, что при защите от уайт-спирита он сработает при концентрации 1/60 от среднесменной ПДК, а при защите от изопропилового спирта – при превышении максимально разовой ПДК в 32 раза&lt;ref name=&quot;НН-2023&quot; /&gt;. 

* '''&lt;big&gt; Япония &lt;/big&gt;''' 
Разработан и регулярно пересматривается национальный стандарт, устанавливающий требования к работодателю, регулирующие выбор и организацию использования СИЗ органов дыхания всех типов. Области допустимого применения (2006 г.) очень схожи с научно обоснованными ограничениями в США. Последнее издание&lt;ref name=&quot;Japan-СИЗОД&quot; /&gt; разработано с учётом стандартов ISO/TS 16975-1 и -3.

Для замены противогазных фильтров работодатель обязан определить срок службы, обратившись к изготовителю.

Также для выбора противопылевых респираторов выпущено предписание&lt;ref name=&quot;Japan-dust-&quot; /&gt;.

* '''&lt;big&gt; Индия &lt;/big&gt;''' 
Для правильного выбора и применения СИЗОД в Индии разработан стандарт&lt;ref name=&quot;Индия-СИЗОД&quot; /&gt;. При разработке за основу взяли стандарты США, Великобритании и Австралии (ANSI Z 88-2-1969, BS 4275:1968, AS CZ 11-1968). Авторы указали, что для оценки защитных свойств СИЗОД разных типов следует использовать результаты [[:w:Производственные испытания респираторов|измерений на рабочих местах]], у работников. Но в Индии такие дорогостоящие и трудоёмкие замеры не проводились, а результаты западных исследований не были полноценно использованы разработчиками стандарта - они ориентировались, в первую очередь, на западные стандарты 1960-х годов. А замеры коэффициентов защиты СИЗОД разных типов начались в 1970-х, и не учитывались в документах, взятых за основу при разработке стандарта Индии.

В результате стандарт, фактически, не различает значительное (на порядки) отличие защитных свойств СИЗОД в лабораториях при сертификации и на предприятиях&lt;ref name=&quot;Обзор-2014&quot; /&gt;&lt;ref name=&quot;Обзор-2019&quot; /&gt;, и допускает применение разных видов СИЗОД при слишком большой загрязнённости воздуха, когда они не могут надёжно защищать работников.

* '''&lt;big&gt; Китай &lt;/big&gt;''' 
Для выбора и правильного использования СИЗ органов дыхания разработан национальный стандарт. При разработке использованы результаты научных исследований и аналогичные требования в США, Великобритании и Австралии, в результате получились схожие ограничения областей допустимого применения СИЗОД разных типов&lt;ref name=&quot;КНР-СИЗОД+&quot; /&gt;. Но требования не являются юридически обязательными, а могут выполняться работодателями на добровольной основе. При защите от токсичных газов рекомендуется использовать фильтры с индикаторами окончания срока службы, или изолирующие СИЗОД - если у газов &quot;плохие предупреждающие свойства&quot; (запах, раздражение и т.п.). В разработке проекта документа участвовала компания 3М.

* '''&lt;big&gt; РФ &lt;/big&gt;''' 
Конкретные требования к выбору и организации использования СИЗ органов дыхания, юридически обязательные для выполнения работодателем - отсутствуют. Для выбора СИЗОД работодатель должен использовать результаты специальной оценки условий труда, и данные о защитных свойствах СИЗОД - предоставляемые изготовителем. Поскольку те стабильно завышают эффективность, порой на порядки, часть работников получает средства защиты, совершенно не соответствующие условиям труда&lt;ref name=&quot;КЗ-2019&quot; /&gt;.

== Обучение ==
Опубликовано много учебных пособий на разных языках, список и ссылки на них даны [[:w:Респиратор#Обучение|в свёрнутой таблице]]. Учебные пособия [[:w:Национальный институт охраны труда#Институт и респираторная защита|Национального института охраны труда]] (''NIOSH'') доступны в переводе на русский язык&lt;ref name=&quot;Учебник 2004&quot; /&gt;&lt;ref name=&quot;Учебник 1987&quot; /&gt;&lt;ref name=&quot;Учебник 1999&quot; /&gt;. В них области допустимого применения СИЗОД разных типов ограничена с  учётом современного уровня науки, т.е. учтено значительное отличие&lt;ref name=&quot;Обзор-2014&quot; /&gt;&lt;ref name=&quot;Обзор-2019&quot; /&gt; [[:w:Производственные испытания респираторов|защитных свойств на предприятиях]] и в лабораториях при сертификации&lt;ref name=&quot;Кириллов-2013&quot; /&gt;. Также есть перевод учебника по замене противогазных фильтров [[:w:Управление по охране труда (OSHA)|Департамента условий и охраны труда]]&lt;ref name=&quot;eTool&quot; /&gt;.

Для защиты органов дыхания чаще всего используют простые и дешёвые фильтрующие СИЗОД без принудительной подачи воздуха в лицевую часть. В английском учебнике, в отличие от многих других, на основании большого накопленного опыта, работодателям и специалистам по охране труда рекомендуется организовать использование этих средств защиты так, чтобы работник не применял их без перерыва более 1 часа&lt;ref name=&quot;Учебник-2013&quot; /&gt;. Это связано с тем, что если требовать от обычных работников регулярно использовать такие СИЗОД более часа, то &quot;это будет трудно добиться на практике&quot;. Точная причина не указана, при необходимости длительной носки СИЗОД советуют применять модели с принудительной подачей воздуха в лицевую часть. Возможно, отчасти это объясняется тем, что без подачи воздуха в лицевую часть она заполняется углекислым газом при выдохе, при концентрации, на порядок больше чем среднесменная предельно допустимая - и затем непригодный для дыхания воздух вдыхается повторно&lt;ref name=&quot;Капцов-2021&quot; /&gt;. По крайней мере часть работников не сможет переносить вдыхание вредного вещества (углекислого газа&lt;ref name=&quot;Лазарев-3&quot; /&gt;&lt;ref name=&quot;NIOSH-CO2&quot; /&gt;) долго, и добиться своевременного использования СИЗОД всеми работниками не удастся. При принудительной подаче воздуха углекислый газ удаляется из лицевой части, и вдыхаемый воздух пригоден для дыхания.
[[Файл:Рисунок к учебнику по применению респираторов.jpg|thumb|left|350px|Максимальная загрязнённость воздуха, при которой можно использовать полумаски (OY). Маркеры - рекомендации советских и российских авторов разных лет&lt;ref name=&quot;Кириллов-2013&quot; /&gt;.]]В СССР и РФ опубликовано много книг по СИЗОД. К сожалению, во многих значительно завышается способность полумасок и полнолицевых масок, лицевых частей самых распространённых СИЗОД, отделять органы дыхания от окружающей загрязнённой атмосферы. Соответственно, выполнение рекомендаций авторов (например - использовать респираторы-полумаски при большом превышении предельно допустимой концентрации) приведёт к тому, что хотя бы часть рабочих получит заведомо недостаточно эффективные СИЗ, и не будет защищена при своевременном и правильном их использовании. На диаграмме показано как соотносятся эти рекомендации по полумаскам с научно обоснованными ограничениями, действующими и в США, и в большинстве развитых стран.

Участие [https://miningwiki.ru/wiki/Ассоциация_СИЗ Ассоциации СИЗ] в разработке документов, влияющих на выбор, применение (и закупку) СИЗ, выразилось (в том числе) подписанием соглашения с Всероссийским НИИ сертификации в 2015 г.&lt;ref name=&quot;ВНИИС&quot; /&gt; Документ предусматривает совместное участие в работе Технического комитета ТК-320, которые разрабатывает ГОСТы РФ по СИЗ.

Позднее корпорация АО «Корпорация Росхимзащита» разработала ГОСТ, который (должен был) регулировать выбор и применение СИЗОД в РФ&lt;ref name=&quot;ГОСТ-РХЗ&quot; /&gt;. Как декларировалось, документ разрабатывался на основе стандарта ЕС того же назначения. Через год был принят идентичный стандарт&lt;ref name=&quot;ГОСТ-РХЗ-2&quot; /&gt;. Но по [[:w:Законодательное регулирование выбора и организации применения респираторов#таблица|'''всем''' ключевым моментам]], определяющим эффективность защиты работников, этот документ не соответствовал стандарту ЕС&lt;ref name=&quot;EN-529&quot; /&gt;, а в некоторых случаях имел [[:w:Законодательное регулирование выбора и организации применения респираторов#таблица|прямо противоположное содержание]].

В то же время обе версии ГОСТа «Росхимзащиты» - при их добровольном выполнении работодателем - нисколько не нарушали уже сложившуюся в РФ (к моменту разработки) практику выбора и применения СИЗОД. По мнению компетентного специалиста с большим опытом работы&lt;ref name=&quot;Кириллов&quot; /&gt;, из-за значительного числа недостатков и отличий от оригинала&lt;ref name=&quot;Кириллов-2016&quot; /&gt;, можно сказать, что : &lt;blockquote&gt;... гармонизация рассмотренного документа по отношению к стандарту ЕС (и аналогичного [8] в США) - не состоялась. &lt;/blockquote&gt;.

[https://miningwiki.ru/wiki/Ассоциация_СИЗ Ассоциация СИЗ] опубликовала рекомендации по выбору и применению СИЗОД. В документе предлагается заменять противогазные фильтры по появлению запаха в маске&lt;ref name=&quot;Сорокин-2006&quot; /&gt;, завышается эффективность полумасок.
[[File:КОНТРАФАКТ+.jpg|thumb|400px|right|Способ борьбы с контрафактом, неиспользуемый поставщиками СИЗ в РФ]]
В целом, использование российских рекомендаций и даже ГОСТов может создать повышенную опасность отравлений и развития хронических профессиональных заболеваний и при своевременном использовании высококачественных, исправных и сертифицированных СИЗОД. Значительное отличие рекомендаций, публикующихся на русском языке не первое десятилетие, от современного уровня науки, не позволяет объяснять негативные последствия применения СИЗОД в загрязнённой атмосфере исключительно &quot;контрафактом&quot; и недисциплинированностью самих работников. Для снижения риска покупки ответственными потребителями контрафакта есть много средств, но при упаковке СИЗОД и противогазных фильтров российскими производителями они не используются. Плохо обученные специалисты по охране труда не информируются поставщиками о том, что во многих случаях использования самых распространённых СИЗОД (фильтрующих, без принудительной подачи воздуха) концентрация углекислого газа во вдыхаемом воздухе обычно превышает среднесменную предельно допустимую, и может иногда превышать максимально разовую (среднюю за полчаса). Соответственно, работа сотрудников организуется так, что часть из них не выдерживает дыхания непригодным для этого воздухом. За десятилетия, выдача работникам средств защиты заведомо недостаточной эффективности стала, по сути, традицией. Часть работников, экспериментально убедившаяся в недостаточной степени защиты, перестаёт её использовать своевременно.

Особо следует отметить книгу&lt;ref name=&quot;Кошелев-Тарасов&quot; /&gt;, более трети которой посвящено тому, как определить срок службы противогазных фильтров без использования субъективной реакции органов чувств. Несмотря на ряд недостатков, именно в части замены фильтров подход к проблеме уникален, и разительно отличается от подавляющего большинства публикаций на русском языке.

Описанные выше недостатки показывают, что в настоящее время в РФ имеется пока не используемая возможность значительного улучшения защиты работающих в загрязнённой атмосфере.

== Эффективность ==
В США провели широкомасштабный опрос (более 30,2 тыс. компаний) о использовании респираторов. Результаты показали, что во многих компаниях нарушают [[:w:Законодательное регулирование выбора и организации применения респираторов|требования к выбору и организации использования СИЗОД]], так, что это создаёт опасность для работников. Чаще всего нарушения допускались в маленьких компаниях, из-за отсутствия компетентных специалистов и недостатка ресурсов&lt;ref name=&quot;Обзор-2001&quot; /&gt;.

Английские специалисты проверили то, как выбирают и используют СИЗОД на разных предприятиях&lt;ref name=&quot;UK-2011&quot; /&gt;&lt;ref name=&quot;UK-2012&quot; /&gt;. Суммарно, два исследования охватили результаты проверок на 51 предприятии. На многих выявлены недостаточная компетентность и ошибки, плохое обучение работников и т.п. Но из-за небольшого числа предприятий сложно сказать, насколько эти результаты типичны.

Условия выбор и использования СИЗОД в РФ отличаются от западных: нет конкретных и подробных требований законодательства, и контроля за их выполнением, специалистов по охране труда не обучают - как организовать индивидуальную защиту, и потому работников учить просто некому. Для оценки влияния выдачи СИЗ органов дыхания на сбережение здоровья работников был проведён поиск информации в научных публикациях. Но найти работы, где бы сравнивалась заболеваемость в одинаковых условиях, до и после начала использования СИЗОД не удалось. Обзор сотен статей из более 30 журналов и более 360 сборников научных работ (максимальный охват по времени с 1936 по 2016 гг.) показал, что предотвратить профзаболевания с помощью СИЗОД удавалось исключительно редко. Также выяснилось, что для обоснования высокой профилактической ценности СИЗОД в ряде публикаций использовались некорректные способы (искажение первоисточников информации при цитировании и т.п.); или ссылались на эти публикации&lt;ref name=&quot;Кириллов-2018&quot; /&gt;.

Материалы, собранные при подготовке обзора, и позднее позволяют сделать выводы:
* Высококачественные, исправные [[:w:автономный дыхательный аппарат| дыхательные аппараты]], с избыточным давлением в маске при вдохе (исключающем попадание загрязнений через зазоры в месте касания маски и лица), используемые, обученными, тренированными специалистами, и применяемые не повседневно - сильно снижают риск острых отравлений, а порой и полностью устраняют его.
* Фильтрующие СИЗОД, часто неправильно выбираемые, и повседневно применяемые, при сравнительно небольшой загрязнённости воздуха, могут заметно снизить профзаболеваемость &lt;u&gt;исключительно редко&lt;/u&gt;. В части публикаций, декларировавших обратное, использовали некорректные методы: искажали содержание источников информации, при наличии разной информации выбирали &quot;удобную&quot;, игнорируя другую и т.п.&lt;ref name=&quot;Кириллов-2018&quot; /&gt;. 
* Редко используемые не всегда хорошо обученными рабочими [[:w:самоспасатель|самоспасатели]], и при высоком качестве могут оказаться бесполезны. Условия труда, и большая масса, могут мешать держать рядом постоянно. При аварии их может быть трудно найти; в условиях стресса люди могут допустить опасные ошибки при их надевании и включении.

СИЗОД нельзя считать альтернативой [[:w:средства коллективной защиты|средствам коллективной защиты]].

== Примечания ==
{{примечания|refs=
&lt;ref name=&quot;Конвенция148&quot;&gt;Конвенция [[:w:Международная организация труда |Международной организации труда]] № 148 {{Cite web |url=http://www.ilo.org/wcmsp5/groups/public/---ed_norm/---normes/documents/normativeinstrument/wcms_c148_ru.htm |title= «О защите трудящихся от профессионального риска, вызываемого загрязнением воздуха, шумом и вибрацией на рабочих местах» (1977) }} (16 октября 2024). [https://docs.cntd.ru/document/1900829 Официальный перевод]&lt;/ref&gt;
&lt;ref name=&quot;КЗ-2019&quot;&gt;{{Статья|ссылка=https://www.rjhas.ru/jour/article/view/383/362?locale=ru_RU|автор=Капцов В.А., Чиркин А.В.|заглавие=Выбор работодателем средств индивидуальной защиты органов дыхания в зависимости от результатов их испытаний на рабочих местах (обзор)|год=2019|ответственный=ФБУН &quot;Федеральный научный центр гигиены им. Ф.Ф. Эрисмана&quot; Роспотребнадзора|место=Москва|издание=Гигиена и санитария|издательство=ГЭОТАР-Медиа|месяц=9|том=98|номер=8|страницы=845-850|doi=10.18821/0016-9900-2019-98-8-845-850}} ISSN 0016-9900.&lt;/ref&gt;
&lt;ref name=&quot;Капцов-2022&quot;&gt;{{Статья|ссылка=https://www.rjhas.ru/jour/article/view/2011/1419|автор=Капцов В.А., Панкова В.Б., Чиркин А.В.|заглавие=Риск многократного применения противогазных фильтров респираторов (обзор литературы)|год=2022|автор издания=Роспотребнадзор|издание=Гигиена и санитария|том=101  |номер=2|страницы=174-179 |doi=10.47470/0016-9900-2022-101-2-174-179|archivedate=2023-05-19 |archiveurl= https://web.archive.org/web/20230519150148/https://www.rjhas.ru/jour/article/view/2011/1419}} ISSN 0016-9900. [https://www.researchgate.net/publication/359302765_The_risk_of_multiple_uses_of_respirator_gas_filters_literature_review копия]&lt;/ref&gt;
&lt;ref name=&quot;Crutchfield-2000&quot;&gt;{{Статья|ссылка= https://www.researchgate.net/publication/12680414_Effect_of_Test_Exercises_and_Mask_Donning_on_Measured_Respirator_Fit|автор= C.D. Crutchfield, E.O. Fairbank, S.L. Greenstein|заглавие= Effect of Test Exercises and Mask Donning on Measured Respirator Fit |год=2000|язык=en|автор издания=AIHA &amp; ACGIH |издание=Applied Occupational and Environmental Hygiene|издательство=Taylor &amp; Francis|год=1999|volume=14|выпуск=12|pages=827-837|issn=|doi=10.1080/104732299302062}} ISSN 1521-0898&lt;/ref&gt;

&lt;ref name=&quot;СИЗОД-СШАc&quot;&gt;[https://www.ecfr.gov/current/title-42/chapter-I/subchapter-G/part-84 42 Code of Federal Register Part 84 &quot;Approval of Respiratory Protective Devices&quot;] [https://www.law.cornell.edu/cfr/text/42/part-84 копия]. Есть перевод [http://commons.wikimedia.org/wiki/File:42_CFR_84_28.pdf PDF] [[:w:s:Требования к респираторам при их сертификации (США)|Wiki]]&lt;/ref&gt;
&lt;ref name=&quot;CSA-2018&quot;&gt;{{Книга|заглавие=CSA Standard Z94.4-18 (R2023) Selection, Use and Care of Respirators|год=2018|язык=en|издание=5th ed|место=Toronto, Ontario, Canada|издательство=Canadian Standards Association|allpages=112|isbn=978-1-4883-1583-1}}&lt;/ref&gt;
&lt;ref name=&quot;CSA-2021&quot;&gt;{{Книга |автор=CSA |заглавие=CSA Z94.4.1:21 Performance of filtering respirators |год=2021 |язык=en |место=Toronto, Ontario, Canada |издательство=Canadian Standards Association |allpages=83 |серия=ICS 13.340.30 |isbn=978-1-4883-3813-7}}&lt;/ref&gt; 

&lt;ref name=&quot;БТП-2021&quot;&gt;{{Статья|автор=В.А. Капцов, В.Б. Панкова, А.В. Чиркин|заглавие=Международные стандарты по индивидуальной защите органов дыхания (обзор)|ссылка=https://elibrary.ru/item.asp?id=49432018 |год=2021|издание=Безопасность труда в промышленности|месяц=3|номер=3|страницы=70-75|автор издания=Федеральная служба по экологическому, технологическому и атомному надзору (РОСТЕХНАДЗОР); Закрытое акционерное общество «Научно-технический центр исследований проблем промышленной безопасности» (ЗАО НТЦ ПБ)|место=Москва|издательство=ЗАО &quot;Алмаз-Пресс&quot;}} ISSN 0409-2961.&lt;/ref&gt;


&lt;ref name=&quot;Лекция&quot;&gt;''Капцов В.А. и др.'' [https://ru.wikibooks.org/wiki/Замена_противогазных_фильтров_СИЗОД_(лекция) Замена противогазных фильтров СИЗОД (лекция)] [https://web.archive.org/web/20210415085113/https://ru.wikibooks.org/wiki/Замена_противогазных_фильтров_СИЗОД_(лекция) Архивировано] 15 апреля 2021 года.&lt;/ref&gt;
&lt;ref name=&quot;Berezovska-2015&quot;&gt;{{Статья |автор=Berezovska I., Fettaka H., Salmon T., Toye D., Lodewyck P. |заглавие=Redistribution of a mixture of organic vapours inside an activated carbon filter |год=2015 |язык=en |издание=Chemical Engineering Journal |издательство=Elsevier B.V. |месяц=11 |число=15 |pages=677–681 |volume=280  |doi=10.1016/j.cej.2015.05.129}} ISSN 1385-8947.&lt;/ref&gt;
&lt;ref name=&quot;Капцов-2021&quot;&gt;{{Статья|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1641162202&amp;archive=&amp;start_from=&amp;ucat=&amp;|автор=[[:w:Капцов, Валерий Александрович|Капцов В.А.]], Чиркин А.В.|заглавие=Воздействие углекислого газа на работников, использующих респираторы (обзор|год=2021|место=Владивосток|издание=Доклад на 16 Российском национальном конгрессе с международным участием &quot;Профессия и здоровье&quot;|месяц=сентября|число=23|archivedate=2022-01-03 |archiveurl= https://web.archive.org/web/20220103221803/https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1641162202&amp;archive=&amp;start_from=&amp;ucat=&amp;}}&lt;/ref&gt;
&lt;ref name=&quot;NIOSH-ESLI-1&quot;&gt;{{Книга|ссылка=https://www.cdc.gov/niosh/npptl/stps/pdfs/RCT-APR-0066-508.pdf|автор=National Personal Protective Technology Laboratory (NPPTL) in NIOSH|заглавие=Determination of end of service life indicator (ESLI) test. &lt;small&gt;Procedure No. RCT-APR-0066&lt;/small&gt;|год=2005|язык=en|место=Pittsburgh, Pennsylvania|издательство=National Institute for Occupational Safety and Health (NIOSN)|серия=[https://www.cdc.gov/niosh/npptl/stps/respirator_testing.html Standard testing procedure, STP]. Air-purifying respirators|access-date=2024-02-01|archive-date=2023-05-21|archive-url=https://web.archive.org/web/20230521165006/https://www.cdc.gov/niosh/npptl/stps/pdfs/RCT-APR-0066-508.pdf|url-status=live}} [[:w:s:ru:Сертификация СИЗОД (NIOSH) - Индикаторы срока службы противогазных фильтров. Проверка момента срабатывания.|'''перевод''']]&lt;/ref&gt; 
&lt;ref name=&quot;NIOSH-ESLI-2&quot;&gt;{{Книга|ссылка=https://www.cdc.gov/niosh/npptl/stps/pdfs/RCT-APR-0061-508.pdf|автор=National Personal Protective Technology Laboratory (NPPTL) in NIOSH|заглавие=Determination of End-of-Service-Life Indicator Visibility. &lt;small&gt;Procedure No. RCT-APR-0061&lt;/small&gt;|год=2005|язык=en|место=Pittsburgh, Pennsylvania|издательство=National Institute for Occupational Safety and Health (NIOSN)|серия=[https://www.cdc.gov/niosh/npptl/stps/respirator_testing.html Standard testing procedure, STP]. Air-purifying respirators|access-date=2024-02-01|archive-date=2023-05-21|archive-url=https://web.archive.org/web/20230521165006/https://www.cdc.gov/niosh/npptl/stps/pdfs/RCT-APR-0061-508.pdf|url-status=live}} [[:w:s:ru:Сертификация СИЗОД (NIOSH) - Индикаторы срока службы противогазных фильтров. Проверка визуальной заметности |'''перевод''']]&lt;/ref&gt; 
&lt;ref name=&quot;NIOSH-ESLI-3&quot;&gt;{{Книга|ссылка=https://www.cdc.gov/niosh/npptl/stps/pdfs/RCT-APR-0060-508.pdf|автор=National Personal Protective Technology Laboratory (NPPTL) in NIOSH|заглавие=Determination of end of service life indicator (ESLI) drop test. &lt;small&gt;Procedure No. RCT-APR-0060&lt;/small&gt;|год=2005|язык=en|место=Pittsburgh, Pennsylvania|издательство=National Institute for Occupational Safety and Health (NIOSN)|серия=[https://www.cdc.gov/niosh/npptl/stps/respirator_testing.html Standard testing procedure, STP]. Air-purifying respirators|access-date=2024-02-01|archive-date=2023-05-21|archive-url=https://web.archive.org/web/20230521165006/https://www.cdc.gov/niosh/npptl/stps/pdfs/RCT-APR-0060-508.pdf|url-status=live}} [[:w:s:ru:Сертификация СИЗОД (NIOSH) - Индикаторы срока службы противогазных фильтров. Проверка при падении |'''перевод''']]&lt;/ref&gt; 
&lt;ref name=&quot;Сюрин-ГиС-2025&quot;&gt;{{Статья|ссылка= https://www.rjhas.ru/jour/article/view/5099?locale=ru_RU |автор= Сергей Алексеевич Сюрин, Александр Александрович Ковшов, Марина Николаевна Кирьянова, Алена Владимировна Шильниковская|заглавие= Профессиональные болезни органов дыхания работников, занятых в производстве никеля|год=2022|автор издания=ФБУН «Федеральный научный центр гигиены им. Ф.Ф. Эрисмана» Роспотребнадзора|издание=Гигиена и санитария|том=104 |номер=8|страницы= 1035-1042 |doi= 10.47470/0016-9900-2025-104-8-1035-1042 }} ISSN 0016-9900.&lt;/ref&gt;

&lt;ref name=&quot;EN-529&quot;&gt;{{Книга|автор=Technical Committee CEN/TC 79 &quot;Respiratory protective devices&quot;,|заглавие=EN 529:2005. Respiratory protective devices. Recommendations for selection, use, care and maintenance. Guidance document|ответственный=CEN|год=2005|язык=en|место=Brussels|издательство=European Committee for Standardization|allpages=50|серия=13.340.30}}&lt;/ref&gt;
&lt;ref name=&quot;AN-2006&quot;&gt;{{Статья|ссылка=https://onlinelibrary.wiley.com/doi/full/10.1111/j.1600-0404.2005.00560.x|автор=E.C.H. Lim, R.C.S. Seet, K.‐H. Lee, E.P.V. Wilder‐Smith, B.Y.S. Chuah, B.K.C. Ong|заглавие=Headaches and the N95 face-mask amongst healthcare providers|год=2006|язык=en|издание=Acta Neurologica Scandinavica|издательство=John Wiley &amp; Sons|выпуск=3|pages=199—202|volume=113|doi=10.1111/j.1600-0404.2005.00560.x }} ISSN 0001-6314, {{PMID|16441251}}, есть [https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1606578563&amp;archive=&amp;start_from=&amp;ucat=&amp; перевод] &lt;/ref&gt;
&lt;ref name=&quot;ANZ-СИЗОД-тест&quot;&gt;{{Книга|ссылка=https://www.standards.govt.nz/shop/ASNZS-17162012|автор=Joint Technical Committee SF-010, Occupational Respiratory Protection |заглавие= AS/NZS 1716:2012. Respiratory protective devices |год=2012|язык=en|издание=5th ed|место=Sydney, New South Wales|издательство=Standards Australia|allpages=128|isbn=978-1-74342-024-9}}&lt;/ref&gt;
&lt;ref name=&quot;Haupt-2006&quot;&gt;{{Статья|автор=Nadine Haupt &amp; Peter Paszkiewicz|заглавие=Breakthrough Measurements for Small-Capacity Cartridges at Elevated Flow Rates in Different Flow Modes|год=2006|язык=en|автор издания=International Society for Respiratory Protection|место=Pittsburgh, PA|издание=[https://www.isrp.com/the-isrp-journal Journal of the International Society for Respiratory Protection]|издательство=Navigator Printing|выпуск=3-4|pages=77-88|volume=23 }} ISSN 0892-6298.&lt;/ref&gt;
&lt;ref name=&quot;Japan-gas&quot;&gt;{{Книга|ссылка= https://webdesk.jsa.or.jp/books/W11M0090/index/?bunsyo_id=JIS+T+8152%3A2012 |автор=Japanese Safety Appliances Association|заглавие=JIS T 8152:2012 Gas respirators |ответственный=Technical Committee on Protective Equipment for Occupational Safety|год=2012 |оригинал=JIS T 8152:2012 防毒マスク |язык=jp en|место=Minato-ku, Tokio|издательство=Japanese Standards Association|allpages= 32 }} [https://www.jisha.or.jp/international/jicosh/english/law/GasMask/index.html html en]&lt;/ref&gt;
&lt;ref name=&quot;Japan-dust&quot;&gt;{{Книга|ссылка= https://webdesk.jsa.or.jp/books/W11M0090/index/?bunsyo_id=JIS+T+8151%3A2018 |автор=Japanese Safety Appliances Association|заглавие=JIS T 8151:2018 Particulate respirators |ответственный=Technical Committee on Protective Equipment for Occupational Safety|год=2018 |оригинал=JIS T 8151:2018 防じんマスク |язык=jp en|место=Minato-ku, Tokio|издательство=Japanese Standards Association|allpages= 39 }} [https://www.jisha.or.jp/international/jicosh/english/law/DustMask/index.html html en]&lt;/ref&gt;

&lt;ref name=&quot;Индия-полумаска&quot;&gt;{{Книга|автор=Industrial Safety and Chemical Hazards Sectional Committee, CHD 8|заглавие=Indian Standard IS 14746:1999. Respiratory protective devices — Half masks and quarter masks — Specification|ссылка= https://www.iitr.ac.in/safety/PPE/14746_RESPIRATORY_PROTECTIVE_DEVICES-HALF_FACE_MASKS__QUATER_MASKS-SPECIFICATION.pdf |год=2004|язык=en|место=New Deli|издательство=Bureau of Indian Standards|allpages=23|серия=ICS 13.340.30}}&lt;/ref&gt;
&lt;ref name=&quot;Индия-фильтр&quot;&gt;{{Книга|автор=Industrial Safety and Chemical Hazards Sectional Committee, CHD 8|заглавие=Indian Standard IS 15323:2003. Gas filters and combined filters used in respiratory protective equipment — Specification|ссылка= https://law.resource.org/pub/in/bis/S02/is.15323.2003.pdf |год=2003|язык=en|место=New Deli|издательство=Bureau of Indian Standards|allpages=15|серия=ICS 13.340.30}}&lt;/ref&gt;

&lt;ref name=&quot;КНР-СИЗОД-ФПМ&quot;&gt;{{Книга|ссылка=https://www.chinesestandard.net/PDF.aspx/GB2626-2019|заглавие=GB 2626-2019. Respiratory protection - Non-powered air-purifying particle respirator|год=2019|оригинал=GB 2626-2019 呼吸防护 自吸过滤式防颗粒物呼吸器|язык=en|издательство=China National Standards|ответственный=Standardization Administration of PRC|allpages=57|серия=ICS 13.340.30}}&lt;/ref&gt;
&lt;ref name=&quot;КНР-SCBA&quot;&gt;{{Книга|ссылка=|автор=Institute of Chemical Defense|заглавие=GB/T 16556-2007. Respiratory protection - Self-contained open-circuit compressed air breathing apparatus (EN 137:2002) |год=2007|оригинал= GB/T 16556-2007 自给开路式压缩空气呼吸器|язык=en|ответственный=Standardization Administration of PRC |издательство=State Administration for Market Regulation|allpages=57|серия=ICS 13.340.30}}&lt;/ref&gt;

&lt;ref name=&quot;Сорокин-2011&quot;&gt;{{статья|автор=Сорокин ЮГ (АСИЗ)|заглавие=Роль средств индивидуальной защиты в охране труда|издание=Справочник специалиста по охране труда|место=Москва|издательство=МЦФР|год=2011|номер=7|страницы=43-48}} ISSN 1727-6608. Цитата: ''&quot;Не секрет, что проблемы с качеством СИЗ существуют. К сожалению, ситуация в данной сфере такова, что достаточно выпустить 5-7 доброкачественных изделий, провести испытания и получить сертификат, а потом можно выпускать изделия более низкого качества. Особенно эта проблема актуальна для лёгких респираторов и некоторых других технически несложных СИЗ''&quot;&lt;/ref&gt;
&lt;!-- Комментарий --&gt; СИЗОД выбор
&lt;ref name=&quot;СИЗОД-США+&quot;&gt;Стандарт США ('''''действующий''''') [http://www.osha.gov/pls/oshaweb/owadisp.show_document?p_table=STANDARDS&amp;p_id=12716 US Standard 29 CFR 1910.134 «Respiratory protection»] - OSHA. Перевод: [http://commons.wikimedia.org/wiki/File:Стандарт респиратор.pdf PDF] [[:w:s:ru:Требования_к_выбору_эффективных_респираторов_и_к_организации_их_применения| Wiki]]&lt;/ref&gt;

&lt;ref name=&quot;Руководство 1976г&quot;&gt;{{книга|автор=Nelson Leidel, Kenneth Bush &amp; Jeremiah Lich|заглавие=NIOSH Occupational Exposure Sampling Strategy Manual|ссылка=https://www.cdc.gov/niosh/docs/77-173/|место=Cincinnati, Ohio|издательство=National Institute for Occupational Safety and Health|год=1977|серия=DHHS (NIOSH) Publication Number 77-173|allpages=150}} Есть перевод: [[:w:File:Руководство NIOSH по измерению загрязнённости воздуха 25.04.2014.pdf|PDF]] [https://ru.wikibooks.org/wiki/Измерение_загрязнённости_воздуха Wiki] Документ однозначно показывает, что измерение загрязнённости воздуха &quot;рабочей зоны&quot; (1.5 м от пола) может сильно занизить реальную загрязнённость вдыхаемого воздуха в зоне дыхания (25 см от лица) - см. [https://ru.wikibooks.org/wiki/Измерение_загрязнённости_воздуха#PriligenieC приложение '''С''' ''стр. 77-79'']&lt;/ref&gt;
&lt;ref name=&quot;Федорук-2025&quot;&gt;{{Книга |ссылка=https://irioh.ru/publish-books-2025-18ohrnc-materials/ |автор= Федорук А.А., Иващенко М.А., Мартин С.В. |заглавие=Материалы 18‐го Российского Национального Конгресса с международным учас­тием «Профессия и здоровье» и 5‐го Международного Молодежного Форума «Профессия и здоровье», 21‐26 сентября 2025 г., Красноярск. |ответственный=[[:w:Бухтияров, Игорь Валентинович|И.В. Бухтияров]] науч. ред. |год=2025 |часть=Подходы к контролю и оценке экспозиции промышленного аэрозоля |ссылка часть=https://doi.org/10.31089/978-5-6042929-8-3-2025-1-447-450 |место=Москва |издательство=ФГБНУ &quot;НИИ медицины труда им. акад. [[:w:Измеров, Николай Федотович|Н.Ф. Измерова]]&quot; |страницы=447-450 |всего страниц=492 |серия=Редколегия Кузьмина Л.П., Рубцова Н.Б., Прокопенко Л.В., Шиган Е.Е., Лысухин В.Н. |isbn=978-5-6042929-8-3 |doi=10.31089/978-5-6042929-8-3-2025-1-447-450}}&lt;/ref&gt;
&lt;ref name=&quot;Кириллов-2016в&quot;&gt;{{статья|автор=Кириллов В.Ф., Филин А.С.|заглавие=Измерение концентрации вредных веществ в воздухе (обзор)|подзаголовок=|ссылка=http://novtex.ru/bjd/archiv2016.html|язык=ru|автор издания=|издание=Безопасность жизнедеятельности|место=Москва|издательство=&quot;Новые технологии&quot;|год=2016|номер=11|страницы=9 – 14|issn=|archivedate=2017-02-26|archiveurl=https://web.archive.org/web/20170226130824/http://novtex.ru/bjd/archiv2016.html}} ISSN 1684-6435&lt;/ref&gt;


&lt;ref name=&quot;CPL-СИЗОД&quot;&gt;''Charles Jeffress'' [http://www.osha.gov/pls/oshaweb/owadisp.show_document?p_table=DIRECTIVES&amp;p_id=2275 «Instruction CPL 2-0.120»]. — OSHA, 1998. Есть перевод: [http://commons.wikimedia.org/wiki/File:Проверка_инспектором.pdf «Инструкция для инспекторов по охране труда с указаниями - как проводить проверку выполнения требований стандарта по респираторной защите (США)»] [[:w:s:Инструкция для инспектора по охране труда, проверяющего выполнение требований стандарта Респираторная защита| Wiki]]&lt;/ref&gt;
&lt;ref name=&quot;НН-2023&quot;&gt;{{Книга|ссылка=https://medialnn.ru/?id=58984 |автор=Капцов В.Н., Панкова В.Б.|заглавие=Проблемы гигиенической безопасности и профилактики нарушений трудоспособности у работающих|ответственный=И.А. Умнягина (ред.)|год=2023|часть= Определение периодичности замены противогазных фильтров респираторов |издание=ФБУН «Нижегородский научно-исследовательский институт гигиены и профпатологии» Роспотребнадзора|место=Нижний Новгород|издательство= «Медиаль»|страницы=153-161|страниц=298|серия=Материалы Всероссийской научно-практической интернет-конференции с международным участием, г. Нижний Новгород, 29–30 ноября 2023 г.|isbn=978-5-6051016-3-5|doi=10.21145/978−5-6051016−3-5_2023}} [https://elibrary.ru/item.asp?id=56122087 PDF]&lt;/ref&gt;

&lt;ref name=&quot;Japan-СИЗОД&quot;&gt;{{Книга|ссылка=https://webdesk.jsa.or.jp/books/W11M0090/index/?bunsyo_id=JIS+T+8150%3A2021|автор=Japanese Safety Appliances Association|заглавие=JIS T 8150:2021. Guidance for selection, use and maintenance of respiratory protective devices|ответственный=Technical Committee on Protective Equipment for Occupational Safety|год=2021|оригинал=JIS T 8150:2021 呼吸用保護具の選択，使用及び保守管理方法|язык=jp en|место=Minato-ku, Tokio|издательство=Japanese Standards Association|allpages=120}} [https://kikakurui.com/t8/T8150-2006-01.html текст 2006 г., на японском]&lt;/ref&gt;

&lt;ref name=&quot;Japan-dust-&quot;&gt;{{Книга|ссылка=https://www.mhlw.go.jp/web/t_doc?dataId=00tc2747&amp;dataType=1&amp;pageNo=1|автор=Labour Standards Bureau|заглавие=Selection, and use of respiratory protection equipment|ответственный=Ministry of Health Labour and Welfare|год=2005-02-07|язык=jp|место=Japan|серия=Labor Standards Bureau Notification No. 0207006}}&lt;/ref&gt;

&lt;ref name=&quot;Индия-СИЗОД&quot;&gt;{{Книга|ссылка=https://upload.wikimedia.org/wikipedia/commons/3/38/ГОСТ_Индии_Выбор_и_организация_применения_СИЗОД_is.9623.2008.pdf|автор=Occupational Safety and Health and Chemical Hazards Sectional Committee, CHD 8|заглавие=Indian Standard IS 9623 (2008): Selection, use and maintenance of respiratory protective devices|год=2008 (2023)|язык=en|издание=1st ed|место=New Deli|издательство=Bureau of Indian Standards|allpages=35|серия=Code of practice}} [https://law.resource.org/pub/in/bis/S02/is.9623.2008.html копия] [https://standardsbis.bsbedge.com/BIS_SearchStandard.aspx?Standard_Number=IS%209623&amp;id=21 копия] [https://www.iitr.ac.in/safety/PPE/9623_RECOMENDATION_FOR_SELECTION__USE_OF_RESPIRATORY_DEVICE.pdf (1981)]&lt;/ref&gt;

&lt;ref name=&quot;Обзор-2014&quot;&gt;{{статья|автор=Кириллов В.Ф. и др.|заглавие=Обзор результатов производственных испытаний средств индивидуальной защиты органов дыхания (СИЗОД)|ссылка=https://cyberleninka.ru/article/n/obzor-rezultatov-proizvodstvennyh-ispytaniy-sredstv-individualnoy-zaschity-organov-dyhaniya-sizod |автор издания=ФБУЗ &quot;Российский регистр потенциально опасных химических и биологических веществ&quot; Роспотребнадзора|издание=Токсикологический вестник|место=Москва|год=2014|номер=6 (129)|страницы=44—49 }} ISSN 0869-7922. [https://ru.wikisource.org/wiki/Обзор_результатов_производственных_испытаний_средств_индивидуальной_защиты_органов_дыхания_(СИЗОД) Wiki] &lt;/ref&gt; 
&lt;ref name=&quot;Обзор-2019&quot;&gt;{{Статья|ссылка=https://www.rjhas.ru/jour/article/view/383|автор=[[:w:Капцов, Валерий Александрович|Капцов В.А.]], Чиркин А.В.|заглавие=Выбор работодателем средств индивидуальной защиты органов дыхания в зависимости от результатов их испытаний на рабочих местах (обзор)|год=2019|автор издания=Издатель ФБУН «Федеральный научный центр гигиены им. Ф.Ф. Эрисмана» Роспотребнадзора|место=Москва|издание=Гигиена и санитария|тип=журнал|том=98|номер=8|страницы=845-850|doi=10.47470/0016-9900-2019-98-8-845-850}} ISSN 0016-9900.&lt;/ref&gt;

&lt;ref name=&quot;КНР-СИЗОД+&quot;&gt;{{Книга|ссылка= https://www.chinesestandard.net/PDF.aspx/GBT18664-2002 |автор=State Administration of Work Safety|заглавие=GB/T 18664-2002 Selection, use and maintenance of respiratory protective equipment|год=2002|оригинал=GB/T 18664-2002 呼吸防护用品的选择、使用与维护|язык=en|allpages=62|серия=ICS 13.340.30}}&lt;/ref&gt;

&lt;ref name=&quot;Капцов-2020&quot;&gt;{{Статья|ссылка=https://journal.fcrisk.ru/2020/4/21|автор=Капцов В.А., Чиркин А.В.|заглавие=Требования к организации респираторной защиты работающих (обзор мировой практики)|год=2020|язык=ru|автор издания=ФБУН и «Федеральный научный центр медико-профилактических технологий управления рисками здоровью населения» Роспотребнадзора|место=Пермь|издание=Анализ риска здоровью|месяц=12|номер=4|страницы=188-195|doi=10.21668/health.risk/2020.4.21}} ISSN 2308-1155. [https://cyberleninka.ru/article/n/trebovaniya-k-organizatsii-respiratornoy-zaschity-rabotayuschih-obzor-mirovoy-praktiki копия]&lt;/ref&gt;
&lt;ref name=&quot;ТР-2009&quot;&gt;{{Статья|автор=А. Лянг|заглавие=Требуются публичные обсуждения|год=2009|автор издания=Общество с ограниченной ответственностью ТехНадзор|место=Екатеринбург|издание=[https://www.elibrary.ru/contents.asp?titleid=51310 Технадзор]|месяц=7|номер=7 (32)|страницы=84-85}}&lt;/ref&gt;
&lt;ref name=&quot;ГОСТ-РХЗ&quot;&gt;{{Книга|автор=ОАО &quot;Росхимзащита&quot;|заглавие=ГОСТ Р 12.4.279-2012. ССБТ. Средства индивидуальной защиты органов дыхания. Рекомендации по выбору, применению и техническому обслуживанию|место=Москва|издательство=ФГУП &quot;Стандартинформ&quot;|год=2014|страниц=41|серия=EN 529:2005 Respiratory protective devices - Recommendations for selection, use, care and maintenance - Guidance document|ссылка= https://meganorm.ru/Index2/1/4293776/4293776889.htm|ответственный=ТК 320 «СИЗ»|тираж=66}} [https://meganorm.ru/Data2/1/4293776/4293776889.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;ГОСТ-РХЗ-2&quot;&gt;{{Книга|автор=ОАО &quot;Росхимзащита&quot;|заглавие=ГОСТ Р 12.4.299-2015. ССБТ. Средства индивидуальной защиты органов дыхания. Рекомендации по выбору, применению и техническому обслуживанию|место=Москва|издательство=ФГУП &quot;Стандартинформ&quot;|год=2016|страниц=28|серия=EN 529:2005 Respiratory protective devices - Recommendations for selection, use, care and maintenance - Guidance document|ссылка=https://meganorm.ru/Index/60/60298.htm |ответственный=ТК 320 «СИЗ»|тираж=1}} [https://meganorm.ru/Data2/1/4293762/4293762732.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;Кириллов-2016&quot;&gt;{{статья|автор=Кириллов В.Ф. и др.|заглавие=О респираторной защите работников |автор издания=НИИ медицины труда РАН|издание=Медицина труда и промышленная экология|ссылка= https://www.journal-irioh.ru/jour/article/view/513|Медицина труда и промышленная экология|место=Москва|издательство=|год=2016|номер=9|страницы=39-42}} ISSN 1026-9428.&lt;/ref&gt;

&lt;ref name=&quot;Учебник 2004&quot;&gt;{{книга|автор=Nancy Bollinger|заглавие=NIOSH Respirator Selection Logic|ссылка=https://www.cdc.gov/niosh/docs/2005-100/|издание=NIOSH|место=Cincinnati, OH|издательство=National Institute for Occupational Safety and Health|год=2004|серия=DHHS (NIOSH) Publication No 2005-100|allpages=32}} Есть перевод: Руководство по выбору респираторов [https://commons.wikimedia.org/wiki/File:NIOSH_Respirator_Selection_Logic_---_Руководство_по_выбору_респираторов_NIOSH_2004г.pdf PDF] [[w:b:ru:Выбор респираторов (NIOSH, США)| Wiki]]&lt;/ref&gt;
&lt;ref name=&quot;Учебник 1987&quot;&gt;{{книга|автор=Nancy J. Bollinger, Robert H. Schutz et al|заглавие=NIOSH Guide to Industrial Respiratory Protection|ссылка=https://www.cdc.gov/niosh/docs/87-116/|издание=NIOSH|место=Cincinnati, Ohio|издательство=National Institute for Occupational Safety and Health|год=1987|серия=DHHS (NIOSH) Publication No 87-116|allpages=305}} Есть перевод (2014): [https://commons.wikimedia.org/wiki/File:NIOSH_Руководство_по_применению_респираторов_в_промышленности_1987.pdf PDF] [[w:b:ru:Применение респираторов в промышленности|Wiki]]&lt;/ref&gt;
&lt;ref name=&quot;Учебник 1999&quot;&gt;{{книга|автор=Linda Rosenstock et al|заглавие=TB Respiratory Protection Program In Health Care Facilities - Administrator's Guide|ссылка=https://www.cdc.gov/niosh/docs/99-143/|место=Cincinnati, Ohio|издательство=National Institute for Occupational Safety and Health|год=1999|серия=DHHS (NIOSH) Publication No. 99-143|страниц=120}} Есть перевод: Руководство по применению респираторов в медучреждениях для профилактики туберкулёза [https://commons.wikimedia.org/wiki/File:TБ_Руководство_NIOSH.pdf PDF] [[w:b:ru:Профилактика туберкулёза в медучреждениях |Wiki]]&lt;/ref&gt;
&lt;ref name=&quot;Учебник-2013&quot;&gt;{{книга|автор=Great Britain Health and Safety Executive|заглавие=Respiratory protective equipment at work. A practical guide|ссылка=http://www.hse.gov.uk/pubns/books/hsg53.htm |издание=4 ed|издательство=HSE Books |год=2013|серия=Health and safety guidance HSG53 | allpages=59|isbn=978-0-71766-454-2}}&lt;/ref&gt;
&lt;ref name=&quot;eTool&quot;&gt;[[:w:b:ru:Замена противогазных фильтров СИЗОД|Замена противогазных фильтров по расписанию]]. Требования и рекомендации Управления по охране труда — OSHA. www.osha.gov (2019). ; Occupational Safety and Health Administration. [https://www.osha.gov/SLTC/etools/respiratory/change_schedule.html Respirator Change Schedules]. Respiratory Protection eTool (англ.). www.osha.gov (2019). Дата обращения 8 декабря 2019.&lt;/ref&gt;

&lt;ref name=&quot;Лазарев-3&quot;&gt;{{Книга|ссылка=https://eco-profi.info/index.php/othod/liter/article/dokum-klop/24-ld-lc/651-lazarev3.html |автор=Абрамова Ж.И., Гадаскина И.Д. и др|заглавие=Вредные вещества в промышленности. Справочник для химиков, инженеров и врачей|ответственный=Н.В. Лазарев, И.Д. Гадаскина ред|год=1977|часть=Углекислый газ|издание=7-е изд|место=Ленинград|издательство=Издательство &quot;Химия&quot;|том=III|страницы=23|страниц=608|тираж=52 000}} копия [https://makston-engineering.ru/library-no8-7 1] [https://vk.com/doc6787360_437497730?hash=JPOOsh21mKIia3XIBWnAGZN9FlA2R6hnWl2Q8mnvrZz 2] [http://www.vixri.ru/?p=4632 3]&lt;/ref&gt;
&lt;ref name=&quot;NIOSH-CO2&quot;&gt;[https://www.cdc.gov/niosh/npg/npgd0103.html Carbon dioxide] . {{книга|заглавие=NIOSH Pocket guide to chemical hazards|ссылка= https://www.cdc.gov/niosh/npg/ |ответственный=Michael E. Barsan (technical Editor)|издание=NIOSH|место=Cincinnati, Ohio|год=2007|серия=DHHS (NIOSH) Publication No. 2005-149|pages=53|allpages=454|}}&lt;/ref&gt;
&lt;ref name=&quot;ВНИИС&quot;&gt;''Сорокин Ю.Г. &lt;small&gt;(АСИЗ)&lt;/small&gt;, Версан В.Г. &lt;small&gt;(ВНИИС)&lt;/small&gt;''. Соглашение о сотрудничестве. ''www.asiz.ru''. АСИЗ (27 февраля 2015).&lt;/ref&gt;
&lt;!-- Комментарий --&gt;{{Cite web|url=http://asiz.ru/tk320/sotrud_tk_siz.pdf|title=Соглашение о сотрудничестве|author=Сорокин Ю.Г. (АСИЗ), Версан В.Г. (ВНИИС)|website=www.asiz.ru|date=27-02-2015|publisher=АСИЗ}}

&lt;ref name=&quot;Обзор-2001&quot;&gt;{{книга|автор=U.S. Department of Labor, Bureau of Labor Statistics|заглавие=Respirator Usage in Private Sector Firms, 2001|ссылка=https://www.regulations.gov/document/EPA-HQ-OPPT-2016-0231-0120 |издание=U.S. Department of Health and Human Services, Centers for Disease Control and Prevention, National Institute for Occupational Safety and Health|место=Morgantown, WV|год=2003|allpages=273}} [http://www.cdc.gov/niosh/docs/respsurv/pdfs/respsurv2001.pdf PDF]&lt;/ref&gt;

&lt;ref name=&quot;UK-2011&quot;&gt;{{Статья|автор=R. Graveling, A. Sánchez-Jiménez, C. Lewis, S. Groat|заглавие=Protecting Respiratory Health: What Should be the Constituents of an Effective RPE Programme? |язык=en|язык издания=en|автор издания=British Occupational Hygiene Society|издание=The Annals of Occupational Hygiene|издательство=Oxford University Press|год=2011|месяц=3|выпуск=3|pages= 230–238 |volume=55|doi=10.1093/annhyg/meq098}} ISSN 2398-7308, {{PMID|21257742}}.&lt;/ref&gt;
&lt;ref name=&quot;UK-2012&quot;&gt;{{Статья|автор=N. Bell, N.P. Vaughan, L. Morris, P. Griffin|заглавие=An Assessment of Workplace Programmes Designed to Control Inhalation Risks Using Respiratory Protective Equipment|язык=en|язык издания=en|автор издания=British Occupational Hygiene Society|издание=The Annals of Occupational Hygiene|издательство=Oxford University Press|год=2012|месяц=3|выпуск=3|pages=350-361|volume=56|doi=10.1093/annhyg/mer109}} ISSN 2398-7308, {{PMID|22156569}}.&lt;/ref&gt;

&lt;ref name=&quot;Кириллов-2018&quot;&gt;{{статья|автор=Капцов В.А., Чиркин А.В.|заглавие=[[:w:s:Об эффективности средств индивидуальной защиты органов дыхания как средства профилактики заболеваний (обзор)|Об эффективности средств индивидуальной защиты органов дыхания как средства профилактики заболеваний (обзор)]]|автор издания=ФБУЗ &quot;Российский регистр потенциально опасных химических и биологических веществ&quot; Роспотребнадзора|издание=[http://toxreview.ru/ Токсикологический вестник]|место=Москва|год=2018|номер=2 (149)|страницы=2-6 |doi=10.36946/0869-7922-2018-2}} ISSN 0869-7922. [https://cyberleninka.ru/article/n/ob-effektivnosti-sredstv-individualnoy-zaschity-organov-dyhaniya-kak-sredstva-profilaktiki-zabolevaniy-obzor копия]&lt;/ref&gt;
&lt;ref name=&quot;Кириллов&quot;&gt;{{статья|автор=Редакция|заглавие=Некролог. Памяти Владимира Федоровича Кириллова |язык=ru|автор издания=НИИ медицины труда РАМН|ссылка= https://www.journal-irioh.ru/jour/article/view/385 |издание=Медицина труда и промышленная экология|место=Москва|год=2015|номер=10|страницы=46}} ISSN 1026-9428.&lt;/ref&gt;

&lt;ref name=&quot;Сорокин-2006&quot;&gt;{{Книга|автор=под ред. Сорокина Ю.Г., Преображенского В.Б. и др|заглавие=Методические рекомендации по выбору и применению средств индивидуальной защиты органов дыхания|ответственный=|издание=|место=Москва|издательство=Издательство &quot;КОЛОС&quot;|год=2006|страницы=22-35|страниц=56|isbn=5-10-003932-9|часть=3.3 Выбор фильтрующих СИЗОД|язык=ru|тираж=2000}} [https://web.archive.org/web/20150725140959/http://gochs.info/p0898.htm аналог]&lt;/ref&gt;
&lt;ref name=&quot;Кошелев-Тарасов&quot;&gt;{{Книга|автор=Тарасов В.И., Кошелев В.E.|заглавие=Просто о непростом в применении средств защиты дыхания|год=2007|часть=8. Приложения|место=Пермь|издательство=Агентство &quot;Стиль-МГ&quot;|страницы=179-273|страниц=280|isbn=978-5-8131-0081-9|ссылка=https://vk.com/wall-108649797_8150?ysclid=m30i2dz4em910619809|серия=для отделов охраны труда промышленных предприятий}}&lt;/ref&gt;
&lt;ref name=&quot;Кириллов-2013&quot;&gt;{{Статья|ссылка=https://cyberleninka.ru/article/n/o-sredstvah-individualnoy-zaschity-organov-dyhaniya-rabotayuschih-obzor-literatury/viewer|автор=Кириллов В.Ф., Бучнев А.А., Чиркин А.В.|заглавие=О средствах индивидуальной защиты органов дыхания работающих (обзор литературы) |год=2013|автор издания=НИИ медицины труда РАН и Роспотребнадзор|место=Москва|издание=[https://www.journal-irioh.ru/jour/about Медицина труда и промышленная экология]|месяц=4|номер=4|страницы=25-31}} ISSN 1026-9428. [https://ru.wikipedia.org/wiki/Файл:Медицина_труда_и_промышленная_экология_2013_04_25-31.jpg JPG] [https://ru.wikisource.org/wiki/О_средствах_индивидуальной_защиты_органов_дыхания_работающих_(обзор_литературы) Wiki] &lt;/ref&gt;
&lt;ref name=&quot;Великобритания-2013&quot;&gt;{{книга|автор=The Health and Safety Executive|заглавие=Respiratory protective equipment at work. A practical guide|ссылка=http://www.hse.gov.uk/pubns/books/hsg53.htm|издание=4 edition|издательство=Crown|год=2013|серия=HSG53|allpages=59|isbn=978-0-71766-454-2|archive-date=2015-08-09|archive-url=https://web.archive.org/web/20150809032140/http://www.hse.gov.uk/pubns/books/hsg53.htm}}&lt;/ref&gt;
}}
[[Категория:Средства индивидуальной защиты (обзорная лекция)]]</text>
      <sha1>ca1jcapemq5d7zm1a79x3j3lgcgryli</sha1>
    </revision>
  </page>
  <page>
    <title>Средства индивидуальной защиты (обзорная лекция)/СИЗ органов слуха</title>
    <ns>0</ns>
    <id>35688</id>
    <revision>
      <id>270426</id>
      <parentid>269660</parentid>
      <timestamp>2026-10-27T07:08:36Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270426</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="95099" sha1="g90lf83hdvcj08vff0ayzht99d0sijm" xml:space="preserve">Средства индивидуальной защиты органов слуха - вид [[:w:ru:Средства индивидуальной защиты|средств индивидуальной защиты]], предназначенный для уменьшения опасного воздействия [[:w:ru:Производственный шум|шума]] на органы слуха.
[[File:Ослабление-шума-СИЗОС.jpg|thumb|right|410px|Средние ослабления звуков разных частот у 121 (1975) и 241 модели СИЗОС (1994)&lt;ref name=&quot;Рязань-2023&quot; /&gt;]]
[[File:Алиса-2003-0002+++.jpg|thumb|right|410px|Ослабление шума одними и теми же моделями [[:w:ru:СИЗОС|СИЗ]], на &lt;span style=&quot;color:Green&quot;&gt;'''рабочих местах'''&lt;/span&gt; и &lt;span style=&quot;color:Red&quot;&gt;'''в лабораториях'''&lt;/span&gt;&lt;ref name=&quot;Алиса-2003&quot; /&gt;]]
Поиск публикаций на русском языке&lt;ref&gt;''[[:w:ru:Капцов,_Валерий_Александрович |Капцов В.А.]], Панкова В.Б., Чиркин А.В.'' [https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1653059572&amp;archive=&amp;start_from=&amp;ucat=&amp; Повышение эффективности средств индивидуальной защиты органа слуха]. &lt;small&gt;(Доклад на Втором Всероссийском конгрессе с международным участием &quot;Лечебно-реабилитационные перспективы при слухоречевых и голосовых расстройствах&quot;)&lt;/small&gt; 17 мая 2022 г. ''www.library.by'' (22 мая 2022). Дата обращения: 28 ноября 2020. [https://www.researchgate.net/publication/360777777_Povysenie_effektivnosti_sredstv_individualnoj_zasity_organa_sluha_Improving_the_effectiveness_of_hearing_protective_devices копия]  &lt;/ref&gt; не выявил исследований, в которых бы сравнивалась заболеваемость работников использовавших и не использовавших СИЗ органа слуха в схожих условиях. 

По данным&lt;ref name=&quot;AIHA-2018&quot; /&gt; на западе провели три исследования влияния СИЗ органа слуха на риск развития [[:w:ru:нейросенсорная тугоухость|нейросенсорной тугоухости]]. Ни одно не выявило значимого отличия в заболеваемости — при том, что в США выбор и применение СИЗ органа слуха организовано более тщательно, чем в СССР и в РФ. Так например, группа специалистов из [[:w:ru:Национальный институт охраны труда|Национального института охраны труда]] (NIOSH, в Министерстве здравоохранения США), используя уникальную базу данных, подобрала сведения о более чем 19 тыс. рабочих разных отраслей экономики, у которых [[:w:ru:Аудиометрия|проверяли состояние органа слуха]] в течение 5 лет. Оказалось, что частота значительного ухудшения слуха у тех, кто использовал СИЗ органа слуха, немного ниже, чем у тех, кто их совсем не использовал. А анализ этого отличия показал, что оно [[:w:ru:Статистическая значимость|статистически незначительно]]&lt;ref name=&quot;Groenewold-2014&quot; /&gt;. Причём ситуацию в РФ усугубляет то, что работникам просто выдают СИЗ органа слуха — без индивидуального подбора и [[:w:ru:Производственный контроль эффективности средств индивидуальной защиты органа слуха|проверки фактической эффективности]]&lt;ref name=&quot;AIHA-2018-12&quot;&gt;{{Книга|ссылка=https://www.aiha.org/education/marketplace/noise-manual-6th-edition|автор=Jérémie Voix, Pegeen Smith, Elliott Berger|часть=Chapter 12. Field Fit-Testing and Attenuation-Estimation Procedures|заглавие=The Noise Manual|издание=6th ed|ответственный=D.K. Meinke, E.H. Berger, R. Neitzel, D.P. Driscoll &amp; K. Bright eds|год=2020|язык=en|место=Falls Church|издательство=American Industrial Hygiene Association|ссылка часть=https://online-ams.aiha.org/amsssa/ecssashop.show_product_detail?p_mode=detail&amp;p_product_serno=2720|страниц=621|archive-date=2022-03-09|archive-url=https://web.archive.org/web/20220309002640/https://www.aiha.org/education/marketplace/noise-manual-6th-edition}}&lt;/ref&gt;. В результате часть работников получает такие средства защиты, которые могут вызывать непереносимые болевые ощущения, и при этом не обеспечивать снижение уровня шума до безопасного уровня. 

Но даже при своевременном использовали, как показали первые исследования в 1970-х гг., ослабление шума у работников очень разное, и в среднем значительно меньше, чем при сертификационных испытаниях в лабораторных условиях&lt;ref name=&quot;NIOSH-1979&quot; /&gt;&lt;ref name=&quot;Алиса-2003&quot; /&gt;; и у значительной доли работников оно может быть близким к нулю&lt;ref name=&quot;Lee-2022&quot; /&gt;.

=== Научные исследования ===
До второй половины 1970-х изучение ослабления шума при использовании СИЗОС велось лишь в лабораторных условиях, т.к. ожидалось, что у рабочих оно будет таким же, или немножко меньше. Кроме того, возможность проводить измерения у работников часто отсутствовала. Результаты лабораторных исследований показали, что ослабление звуков зависит от их частоты, низкочастотные звуки ослабляются значительно хуже, чем высокочастотные. Также оказалось, что у участников исследований при использовании одних и тех же моделей противошумов получаются схожие ослабления шума. На основе это информации в США был разработан Закон &quot;О защите от шума&quot;, с разделом по СИЗОС. Требовалось испытывать их в лабораторных условиях, и затем наносить маркировку, показывающую степень ослабления шума со &quot;стандартным&quot; частотным спектром&lt;ref name=&quot;Алиса-2003&quot; /&gt; (т.н. [[:w:ru:Фликкер-шум|&quot;розового&quot;]], у него распределение акустической энергии по диапазонам частот ([[:w:ru:октава|октавам]]) схоже с &quot;средним&quot; промышленным шумом). За нарушение требований предусматривались большие штрафы, т.к. предполагалось, что правильная маркировка станет эффективным помощником работодателю при выборе подходящих средств защиты работников при известном воздействии шума.

Замеры ослабления шума у рабочих на заводах показали, что оно очень нестабильное, и в среднем гораздо меньше, чем при испытаниях, примеры&lt;ref name=&quot;NIOSH-1979&quot; /&gt;&lt;ref name=&quot;Lee-2022&quot; /&gt;. Например, в группе работников, использующих одинаковые модели в схожих условиях, разнообразие ±20 дБ - не редкость&lt;ref name=&quot;CSA-2014&quot; /&gt;. Чтобы снизить отличие между средними лабораторными и реальными результатами, разработан новый способ тестирования&lt;ref name=&quot;ISO-5&quot; /&gt;: оказалось, что если к сертификации привлекают совершенно неопытных людей, и те надевают СИЗОС самостоятельно, по инструкции от изготовителя, результаты более похожи на получаемые у рабочих на заводах (см. диаграмму справа).

Из-за организационных и бюрократических проблем скорректировать требования законодательства, приведя их в соответствие с современным уровнем науки, в США не удалось (описано ниже).

Получив результаты измерений у рабочих, специалисты не имели никакой возможности учесть сильное разнообразие ослабления шума у разных людей. Они сначала попытались учесть хотя бы то, что среднее ослабление шума у группы рабочих заметно ниже, чем у испытателей при сертификации. Для этого в разных странах разные организации предложили корректировать результаты сертификационных испытаний, как показано в таблице (p. 289&lt;ref name=&quot;AIHA-2018&quot; /&gt; и&lt;ref name=&quot;Капцов-2023&quot; /&gt;):
[[Файл:Usage_NIOSH_Well-Fit_for_HPD_Field-Testing_(earplug_fit_test,_2015).jpg|thumb|right|410px| [[:w:ru:Производственный контроль эффективности СИЗОС|Замер фактического ослабления]] шума [[:w:ru:Беруши|вкладышами]] у 2 работников&lt;ref name=&quot;NIOSH-2015&quot; /&gt; с помощью специального оборудования.]]
{| class=&quot;wikitable&quot; style=&quot;text-align:center&quot;
|+ Попытки снизить значительное отличие между ослаблением шума в лабораториях и на заводах
! rowspan=&quot;2&quot; | Страна, 

организация 
! colspan=&quot;2&quot; | Вкладыши 
! rowspan=&quot;2&quot; | Наушники
|- 
! Из пористого эластичного материала, 
сжимаемые перед установкой в ухо 
! Из эластомерного 

материала
|-
| США, OSHA || Снижение '''в 2 раза''' || Снижение в '''2 раза''' || Снижение '''в 2 раза'''
|-
| США, NIOSH || Снижение '''в 2 раза''' || Снижение '''в 3,3 раза''' || Снижение '''в 1,33 раза'''
|-
| Италия || Снижение '''в 2 раза''' || Снижение '''в 3,3 раза''' || Снижение '''в 1,33 раза'''
|-
| Великобритания || ''Снижение на 4 дБ'' || ''Снижение на 4 дБ'' || ''Снижение на 4 дБ''
|-
| Франция || ''Снижение на 10 дБ'' || ''Снижение на 10 дБ'' || ''Снижение на 5-7 дБ''
|-
| ФРГ || ''Снижение на 9 дБ'' || ''Снижение на 5 дБ'' || ''Снижение на 5 дБ''
|-
| Китай || colspan=&quot;3&quot; | Уменьшали показатель ослабления шума (в виде одного числа) на 60% - в прошлом&lt;ref name=&quot;КНР-шум-практика&quot; /&gt;
|-
| Австралия

Новая Зеландия

Бразилия
| colspan=&quot;3&quot; | При сертификации испытывают СИЗ на совершено неопытных участниках, 
полученный результат используют без уменьшения&lt;ref name=&quot;КНР-шум-практика&quot; /&gt;
|}
Видно, что эта &quot;половинчатая&quot; попытка снизить отличие реальной степени защиты от сертификационной оказалась не очень удачной: в разных странах, и даже в одной стране, предлагались очень разные способы коррекции. И все они не учитывали значительное разнообразие уровней защиты у отдельных, конкретных работников, то есть - не позволяли выявить тех, кто плохо защищён. Всё же, использование &quot;дерейтинга&quot; снижает дезинформированность потребителей и риск выдачи работникам совершенно неэффективных СИЗ; поэтому российские специалисты по профзаболеваниям предложили использовать такой подход и в РФ (2 издание&lt;ref name=&quot;Кириллов-2010&quot; /&gt;, статья&lt;ref name=&quot;Денисов-2013&quot; /&gt;) - за отсутствием лучших способов индивидуальной защиты.

В 1990-х в NIOSH была проведена большая работа по созданию такого средства, которое позволит проверять ослабление шума у конкретного работника, при проведении измерений прямо на предприятии. Т.к. в США чаще используют вкладыши, и у них ослабление шума менее стабильно, чем у наушников, для проверки был разработан сильно упрощённый аналог [[:w:ru:Аудиометр|аудиометра]]: наушники + программное обеспечение для компьютера (работодателя). У работника измеряли пороги восприятия звуков разных частот, а потом повторяли замеры при установленных вкладышах. Позднее другие средства измерений начали изготавливаться разными компаниями, и на западном рынке есть в продаже более десятка измерительных систем. Во всех развитых странах специалисты настоятельно рекомендуют работодателям [[:w:ru:Производственный контроль эффективности СИЗОС|проводить проверки индивидуально]], и при первоначальном выборе СИЗОС, и потом периодически&lt;ref name=&quot;AIHA-2018&quot; /&gt;. В нескольких странах намерены изменить законодательство, и сделать такие проверки обязательными, но пока это произошло лишь в одной провинции Канады&lt;ref name=&quot;Альберта-2022&quot; /&gt;. Проверка качества работы разных измерительных систем показала, что они могут давать значительно отличающиеся друг от друга результаты. Поэтому в США разработали требования к показателям качества таких средств измерений&lt;ref name=&quot;ANSI-2018&quot; /&gt;.

=== Требования к противошумам и их сертификация ===
* '''&lt;big&gt; США &lt;/big&gt;'''
В 1970-х началась работа по сертификации СИЗ органа слуха, этим занималось [[:w:Агентство по охране окружающей среды США|Агентство по охране окружающей среды]] ''(EPA)''&lt;ref name=&quot;Alice-2012&quot; /&gt;, т.к. они вели работу и по коммунальному, и по [[:w:ru:Промышленный шум|производственному шуму]], и всем средствам защиты от него, включая коллективные&lt;ref name=&quot;Алиса-2003&quot; /&gt;. Для испытаний был выбран новый (на то время) стандарт [[:w:Американский национальный институт стандартов|Института стандартов]]&lt;ref name=&quot;ANSI-1974&quot; /&gt;. 

Работа продвигалась, но в начале 1980-х [[:w:Рейган, Рональд|Рейган]] полностью [[:w:ru:Управление по охране труда (OSHA)#noise|прекратил её (для &quot;уменьшения государственного регулирования экономики&quot;)]]&lt;ref name=&quot;Alice-2012&quot; /&gt;. Требование испытывать СИЗОС по стандарту 1974 г. осталось в тексте закона, и по сей день производители в США испытывают СИЗ по методике совершенно устаревшего стандарта полувековой давности&lt;ref name=&quot;ANSI-1974&quot; /&gt;, который даже не предусматривает возможность испытаний [[:w:Средства индивидуальной защиты органа слуха от шума с электронно-акустическими компонентами|СИЗОС с электронно-акустическими компонентами]]&lt;ref name=&quot;AIHA-2018&quot; /&gt;; а вкладыши в слуховые каналы участников испытаний устанавливает специалист, а не они сами.

После изменений ослабления звуков разных частот определяется показатель ослабления шума в виде одного числа ''NRR'', который, как надеялись в 1970-х, позволит спрогнозировать ослабление шума у рабочих, применяющих эту модель СИЗОС. Но проведённые позже многочисленные исследования показали, что ослабление шума у работников на предприятиях очень нестабильное, и в среднем значительно ниже чем получаемое в лабораториях (пример&lt;ref name=&quot;Lee-2022&quot; /&gt;). Т.к. ''EPA'' прекратило работу по защите от шума, пересмотреть требования не удаётся, и в продажу поступают СИЗ с маркировкой, дезинформирующей потребителя (фактически - недобросовестная реклама). Многие склонны покупать СИЗ с наибольшим значением показателя ослабления шума, и в результате часть рабочих очень плохо защищена, а часть получает эффективные, но такие неудобные СИЗ, что не всегда их применяет. Некоторые крупные производители СИЗ оборудовали свои испытательные лаборатории, и сами проверяют свои изделия, получая при этом очень-очень хорошие показатели ослабления шума&lt;ref name=&quot;Алиса-2003&quot; /&gt;.

Для снижения вероятности ошибок неправильно выбора СИЗ разработаны новые требования к испытаниям и маркировке, вместо показателя ослабления шума в виде одного числа результат испытаний сообщается потребителю в виде 2 графиков или таблицы, которые показывают возможное ослабление шума при более и при менее аккуратном надевании СИЗОС, и с учётом свойств шума (низкочастотные звуки ослабляются хуже высокочастотных).
[[File:NRR new.jpg|thumb|350px|right|(1) старая маркировка СИЗОС (США), 1 число; (2) новая маркировка, графики, показывает, что низкочастотный шум (OX, правые концы графиков) ослабляется хуже высокочастотного, и что ослабление шума у разных людей разное.]]
* '''&lt;big&gt; Канада &lt;/big&gt;'''  
Требования к выбору и использованию СИЗ органа слуха установлены в стандарте&lt;ref name=&quot;CSA-2014&quot; /&gt;. По результатам испытаний определяется ослабление звуков разных частот, и по этим данным определяется, к какому из трёх классов СИЗ органа слуха (''A, B'' или ''C'') принадлежит данная модель. Замеры ослабления звуков проводят согласно требованиям стандарта США&lt;ref name=&quot;ANSI-1974&quot; /&gt;. Поскольку большинство СИЗ плохо защищает от низкочастотных звуков, введены ещё два &quot;подкласса&quot; СИЗОС (''AL ''и'' BL''). К ним относят СИЗ классов ''А'' (наибольшее ослабление  шума) и ''В'' (умеренное ослабление шума), если они в лабораторных условиях при сертификационных испытаниях ослабляли звуки с частотой 125 Гц не меньше чем на 20 дБ.

* '''&lt;big&gt; Европейский Союз &lt;/big&gt;'''
Разработана серия стандартов с требованиями к разным СИЗОС, в значительной степени на основе стандартов ИСО. 

Позднее её дополнили стандарты с требованиями к [[:w:Средства индивидуальной защиты органа слуха от шума с электронно-акустическими компонентами|средствам защиты с электронно-акустическими компонентами]]. Новые стандарты предполагают, что ослабление шума у работников будет таким же, как и у испытателей в лабораториях при сертификации, и получаемые с их помощью результаты могут завышать эффективность СИЗ по сравнению с реальной.

* '''&lt;big&gt; Австралия и Новая Зеландия &lt;/big&gt;'''
Требования к всем СИЗ органа слуха содержатся в стандарте&lt;ref name=&quot;ANZ-СИЗОС&quot; /&gt;. Они, в целом, схожи с европейскими, но при определении ослабления шума обработка результатов (ослабление звуков разных частот) происходит по-другому. В Австралии все СИЗОС по ослаблению шума делят на 5 классов, для каждого установлен диапазон ослаблений шума (отчасти схоже с Канадой). Определяется, к какому классу принадлежит СИЗОС, и номер класса наносится на упаковку.

* '''&lt;big&gt; Япония &lt;/big&gt;'''
На основе стандартов ИСО и ЕС разработаны требования к измерению ослабления шума&lt;ref name=&quot;Япония-СИЗОС-тест&quot; /&gt; и оценке результата&lt;ref name=&quot;Япония-СИЗОС-обраб&quot; /&gt;.

* '''&lt;big&gt; Индия &lt;/big&gt;''' 
Разработаны стандарты с требованиями к СИЗ от шума&lt;ref name=&quot;Индия-СИЗОС&quot; /&gt; и их испытаниям&lt;ref name=&quot;Индия-СИЗОС-тест&quot; /&gt;.

* '''&lt;big&gt; Китай &lt;/big&gt;'''
В КНР разработаны требования к СИЗОС&lt;ref name=&quot;CH-СИЗОС-вкладыш&quot; /&gt;, их испытаниям&lt;ref name=&quot;CH-СИЗОС-тест&quot; /&gt;, обработке результатов испытаний&lt;ref name=&quot;КНР-шум-прогноз&quot; /&gt;. Часть стандартов гармонизирована со стандартами ИСО и ЕС.

* '''&lt;big&gt; РФ &lt;/big&gt;'''
Как упоминалось выше, ведётся разработка государственных стандартов, гармонизированных с европейскими, с минимальными требованиями к противошумам и способам их испытаний. Качество документов разное. Например, в стандарте ISO 1994 г. описаны разные методы вычисления ослабления шума у работников на основании результатов лабораторных измерений&lt;ref name=&quot;ИСО-1994&quot; /&gt;. В документе не учтено отличие лабораторной эффективности от реальной, и разнообразие ослабления шума у работников; но читателя предупреждают, что ослабление шума у работников может отличаться от вычисленного &quot;если работники наденут противошумы не так аккуратно, как испытатели ... и при разных индивидуальных анатомических особенностях&quot;. Это предупреждение в ГОСТе отсутствует, но есть фраза: &quot;3. Настоящий стандарт представляет собой аутентичный текст международного стандарта ИСО 4869-2-94 ... и содержит дополнительные требования, отражающие потребности экономики страны&quot;&lt;ref name=&quot;ГОСТ-212&quot; /&gt;.

=== Выбор противошумов ===
Для правильного выбора СИЗОС необходимо учесть множество разных факторов. Специалисты&lt;ref name=&quot;AIHA-2018&quot; /&gt; отмечают, что многие обращают внимание на ослабление шума. Однако на практике в большинстве случаев доза воздействия шума обычно превышает предельно допустимую на небольшую величину, гораздо меньшую, чем ослабление шума, обеспечиваемое протившумами при своевременном применении. И проблема обычно в том, что работники не применяют их вовремя. Причины этого могут быть достаточно серьёзны: помехи общению, и недостаток акустической информации, мешающие выполнению трудовых обязанностей; дискомфорт и даже трудно переносимая боль (при длительном использовании вкладышей, сдавливающих ткани в слуховом канале); не соответствие выбранной модели индивидуальным особенностям работника, условиям труда, характеру выполняемой работы и свойствам шума, и по другим причинам. Нередко модель с меньшим показателем ослабления шума, но удобная и подходящая, и потому своевременно и правильно применяемая, защищает людей лучше, чем СИЗОС с очень высокими показателями защитных свойств - но неудобное и/или неподходящее.

Для оценки риска необходима информация о воздействии шума на работников. Важно учесть, что при не постоянном воздействии шума можно допустить грубые ошибки при оценке воздействия. С учётом результатов исследования [[:w:Национальный институт охраны труда|NIOSH]]&lt;ref name=&quot;Руководство 1976г&quot; /&gt; работодателям рекомендуется не вычислять воздействие непостоянного шума, а измерять его непосредственно, используя носимые рабочими дозиметры. А трудовая инспекция проводит замеры исключительно дозиметрами. Для примера: сравнение результатов измерений дозиметрами с результатами специальной оценки условий труда выявило превышение первых над вторыми во многих случаях&lt;ref name=&quot;Мартин-2021&quot; /&gt;, на величину, достигшую 19,7 дБ&lt;ref name=&quot;Мартин-2023&quot; /&gt;. Редкое использование шумовых дозиметров в РФ создаёт предпосылки для ошибочной и значительной недооценке опасности.

Вредное действие шума на орган слуха может заметно усилиться, если работник одновременно подвергается воздействию [[:w:ru:Ототоксичность|некоторых вредных химических веществ]] (растворители, [[:w:монооксид углерода|монооксид углерода]], [[:w:стирол|стирол]] и другие) и некоторых лекарств&lt;ref name=&quot;Campo-2009&quot; /&gt;&lt;ref name=&quot;AIHA-2018-7&quot; /&gt;. Западных работодателей уже давно предупреждают о повышенной опасности в таких случаях, но это пока никак не отражено в требованиях и рекомендациях по выбору и использованию противошумов.


* '''&lt;big&gt; США &lt;/big&gt;'''
Департамент условий и охраны труда разработал требования защите рабочих от шума, включая требования к выбору и использованию противошумов, государственная инспекция проверяет выполнение требований&lt;ref name=&quot;инспектор-2022&quot; /&gt;. При превышении предельно допустимого уровня шума работодатели обязаны периодически измерять его воздействие на работников, проводить у них первоначальные и затем ежегодные проверки слуха, дать возможность выбрать подходящие, удобные противошумы из нескольких предложенных (минимум 4 модели, из них минимум 2 - вкладыши), и обучить их правильному использованию&lt;ref name=&quot;OSHA-noise&quot; /&gt;.

Ответственным работодателям, которые хотят надёжно защитить работников от шума, и не смогли добиться этого без СИЗ, специалисты предлагают использовать [[:w:ru:Производственный контроль эффективности СИЗОС|устройства для измерения ослабления шума]], и проверять работников индивидуально. Это помогает выбрать для каждого подходящую модель, проверять качество обучения правильному надеванию наушников и установки вкладышей, и контролировать эффективность защиты при повседневном применении СИЗ. Для обеспечения качества работы средств измерений разработан стандарт с требованиями к ним&lt;ref name=&quot;ANSI-2018&quot; /&gt;.

Но, к сожалению, по данным&lt;ref name=&quot;МОТ-шум&quot; /&gt;&lt;ref name=&quot;ILO-шум&quot; /&gt;&lt;ref name=&quot;Alice-2012&quot; /&gt; многие работодатели выполняют эти [[:w:Программа защиты от шума|программы защиты от шума]] формально и поверхностно, без какого-то эффекта: лишь выдаёт работникам СИЗОС, и периодически оплачивает проверки слуха. А часть работодателей с небольшим числом сотрудников и это не делает.

* '''&lt;big&gt; Канада &lt;/big&gt;''' 
Общенациональный стандарт&lt;ref name=&quot;CSA-2014&quot; /&gt; определяет, как работодатель должен выбирать и организовать использование противошумов. В частности, рекомендуется измерять ослабление шума у каждого работника индивидуально. 

В канадской провинции [[:w:Альберта|Альберта]] законодатели изменили местные требования к защите от шума (2022): уменьшили предельно допустимый уровень, и потребовали, чтобы все работодатели, у которых рабочие должны использовать СИЗОС, проводили [[:w:ru:Производственный контроль эффективности СИЗОС|проверку для оценки фактического ослабления шума конкретной моделью противошумов у каждого работника]]&lt;ref name=&quot;Альберта-2022&quot; /&gt;.

* '''&lt;big&gt; Европейский Союз &lt;/big&gt;'''
Ситуация в странах ЕС противоречивая. С одной стороны, в ЕС стабильно принимают стандарты, гармонизированные со стандартами ИСО по противошумам, их испытаниям, и прогнозированию ослабления шума у рабочих на основе результатов лабораторных замеров. На основе последних разработан чисто европейский стандарт с указаниями по выбору и организации использования СИЗОС работодателями. Все его три редакции, начиная с 1990-х, игнорируют отличие реальной и лабораторной эффективности. Чтобы хоть как-то снизить резкий контраст, в последней редакции упомянули, что &quot;все описанные способы вычислений не позволяют определить ослабление шума у конкретного работника, из-за вариабельности&quot;.

С другой стороны, Директива ЕС по защите работников от шума&lt;ref name=&quot;Директива-шум&quot; /&gt; однозначно обязывает работодателей:
* При эквивалентном уровне шума от 80 до 85 дБА выдавать работникам противошумы (и не требует их обязательного применения, т.к. считается, что риск утраты слуха небольшой);
* При шума от 85 до 87 дБА работодатели обязаны выдавать СИЗОС, а работники обязаны непрерывно их использовать;
* При шуме выше 87 дБА работа запрещена вообще, при любом ослаблении шума СИЗОС.
Последнее требование, фактически, показывает низкую реальную эффективность противошумов, и очень хорошо согласуется с результатами проведённого через 11 лет исследования&lt;ref name=&quot;Groenewold-2014&quot; /&gt;.

Поскольку с 1970-х известно, что ослабление шума у работника будет, скорее всего, совершенно не таким, как указывается на упаковке СИЗ (по результатам сертификации), в ЕС разработали стандарт, помогающий работодателям проводить индивидуальные измерения ослабления шума у каждого конкретного сочетания (работник — модель СИЗОС)&lt;ref name=&quot;EN-2021&quot; /&gt;. Но и этот метод не позволяет полноценно определять защитные свойства [[:w:ru:Средства индивидуальной защиты органа слуха от шума с электронно-акустическими компонентами|новых типов СИЗ органа слуха - с электронными компонентами]]&lt;ref name=&quot;Капцов-2024-1&quot; /&gt;&lt;ref name=&quot;Капцов-2024-2&quot; /&gt;.


* '''&lt;big&gt; Австралия и Новая Зеландия &lt;/big&gt;'''
Для выбора СИЗОС в зависимости от уровня шума в Австралии используют деление на классы&lt;ref name=&quot;ANZ-выборСИЗОС&quot; /&gt;:
{| class=&quot;wikitable collapsible collapsed&quot; style=&quot;text-align:center&quot;
! Класс !! Диапазон воздействий шума на рабочего, дБА
|-
| 1 || до 90
|-
| 2 || 90 - 95
|-
| 3 || 95 - 100
|-
| 4 || 100 - 105
|-
| 5 || 105 - 110
|-
| colspan=&quot;2&quot; | При дозе воздействия, превышающей эквивалентный среднесменный уровень шума 110 дБА, следует обратиться за советом к специалисту 
|}
Использование классов служит средством, стимулирующим работодателей выбирать адекватные СИЗОС, а не просто покупать ту модель, у которой наибольший показатель ослабления шума (''Sound Level Conversion, SLC&lt;sub&gt;80&lt;/sub&gt;''). Слишком часто бывает, что модель с очень высоким показателем не подходит работнику, и он не использует её вовремя; в то время как другая модель, с несколько меньшим показателем (вполне достаточным) обеспечит адекватную защиту из-за её правильного, своевременного использования. Выбирая какую-нибудь модель их группы моделей определённого класса, потребитель будет обращать больше внимания на удобность и другие важные свойства.

* '''&lt;big&gt; Япония &lt;/big&gt;'''
Закон&lt;ref name=&quot;Japan-закон&quot; /&gt; требует работодателей обеспечивать работников СИЗ при опасном воздействии&lt;ref name=&quot;Japan-ПДУ&quot; /&gt;. Разработаны рекомендации специалистов по защите от шума, в которых упомянуто применение СИЗОС, и обучение работников&lt;ref name=&quot;Japan-рекоменд&quot; /&gt;, но сколько-нибудь подробных рекомендаций нет. Работодатель обязан обеспечивать работников противошумами при превышении 85 дБА.
* '''&lt;big&gt; Китай &lt;/big&gt;'''
Для оценки ослабления шума при использовании СИЗОС сначала приняли стандарт для прогнозирования ослабления шума у рабочих по результатам лабораторных измерений (''аналог ISO 4869-2:1994'')&lt;ref name=&quot;КНР-шум-прогноз&quot; /&gt;. Позже был принят стандарт с указаниями по выбору и организации использования СИЗ от шума&lt;ref name=&quot;КНР-шум-выбор&quot; /&gt;. По данным&lt;ref name=&quot;КНР-шум-практика&quot; /&gt; ранее, при оценке ослабления шума у работников, старались учесть отличие средних ослаблений в лабораториях и на практике, уменьшая показатель ослабления шума (в виде одного числа) на 60%. А с 2021 года все СИЗОС и все условия труда по шуму делят на 2 вида: более эффективные / более опасные; и менее эффективные / менее опасные. При дозе воздействия шума до 95 дБА необходимо использовать СИЗОС с показателем ослабления шума от 17 до 34 дБ, а при дозе 95 дБА и более - с показателем больше 34 дБ. Фактически, все модели разделили на 2 класса, как в Канаде и Австралии.

=== Обучение и эффективность ===
Наиболее подробные требования к обучению работников даны в австралийском стандарте. &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;
Рекомендации по обучению (общего характера, которые следует приспособить к особенностям конкретного предприятия)&lt;ref name=&quot;ANZ-выборСИЗОС&quot; /&gt; 
&lt;div class=&quot;mw-collapsible-content&quot;&gt;&lt;small&gt;Как учить. Результат гораздо лучше, если обучаемые не просто слушают, а участвуют в процессе. Предложите рабочим задавать вопросы, если они хоть что-то не поняли; делиться своим и чужим опытом; при наличии дополнительной информации и/или вопросов – сказать об этом.

Чтобы обратить внимание на самые важные моменты, желательно дополнительно использовать визуальные средства (презентация и т.п.).

Используйте при обучении: примеры по теме из своего и чужого опыта; инструкции Вашего предприятия (правила выполнения работ, правила эксплуатации оборудования); образцы противошумов – те модели, которые у Вас применяют.

Вы обязаны дать информацию по темам: орган слуха и его работа (+ проверки слуха, как он ухудшается); шум и его свойства (постоянный / не постоянный, низко- и высокочастотный, импульсный); измерение шума (логарифмическая шкала, децибелы + примеры громкости, доза воздействия – эквивалентный уровень); в каких местах и при каких видах работ на Вашем предприятии есть опасное воздействие шума (можно использовать план/схему предприятия/цеха); что законы требуют от работодателя по защите рабочих от шума; что они требуют от начальников; и что обязаны делать работники.

Расскажите о: предельно допустимых уровнях шума; важности сбережения здоровья (не пугая, расскажите о проблемах в повседневной жизни при разной степени ухудшения слуха); [[средства коллективной защиты|средствах коллективной защиты]] (кожухи для оборудования, перегородки, экраны, шумопоглощающие покрытия, изолированные кабины), какие СКЗ используются на Вашем предприятии; какие недостатки СКЗ мешают обойтись без противошумов; СИЗ органов слуха (виды, достоинства и недостатки; границы допустимого применения; какие используют на Вашем предприятии; причины выбора используемых у Вас моделей).

Проинструктируйте, когда какие СИЗОС следует применять; как их проверять (покажите, как это делать), очищать (дайте практические советы), (ремонтировать) и хранить (покажите, где и как хранить), что делать при обнаружении дефектов или других проблем. Расскажите, почему важно, чтобы ослабление шума снизило его воздействие до безопасного уровня, но не слишком маленького (риск не услышать предупреждения об опасности, помехи при получении акустической информации, необходимой для работы, при общении).

'''Научите &lt;u&gt;каждого работника индивидуально&lt;/u&gt; правильному надеванию СИЗОС''': как надеть и отрегулировать наушники, как установить вкладыши.

Обсудите проблемы при использовании противошумов: дискомфорт (боль), работа при высокой и низкой температуре воздуха, выделение пота, работа в загрязнённых местах (стимулируйте мыть руки перед установкой вкладышей), совместимость с респираторами, касками, очками и т.п.; о медосмотрах перед применением СИЗОС и выборе противошумов для рабочих с ухудшившимся слухом.&lt;/small&gt;&lt;/div&gt;&lt;/div&gt;
В руководстве по шуму американской ассоциации специалистов по гигиене труда даны очень разносторонние и подробные рекомендации и по выбору СИЗОС, и по обучению работников. Например, настоятельно рекомендуется использовать СИЗОС по нескольку часов в день тем сотрудникам, которые занимаются их выбором и закупкой, чтобы они лучше представляли себе достоинства и недостатки этих средств защиты&lt;ref name=&quot;AIHA-2018&quot; /&gt;. Указано, что хотя индивидуальное обучение каждого работника надеванию требует больше времени и ресурсов, но эффект от него настолько больше, что необходимо учить именно индивидуально (если это вообще возможно). При обучении рекомендуют проверять [[:w:ru:Производственный контроль эффективности СИЗОС|фактическое ослабление шума]], если нет такой возможности - использовать контролируемый источник шума (в малошумном месте), производственный шум для &quot;суррогатной&quot; проверки.

[https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры Ассоциация СИЗ] опубликовала рекомендации, которые фактически стали единственным документом с советами специалистов по выбору СИЗ от шума на русском языке&lt;ref name=&quot;АСИЗ-шум&quot; /&gt;. Вопреки современному уровню науки авторы (из ''3М Russia'') предлагают определять степень уменьшения воздействия шума на рабочих на основании результатов измерений в лабораторных условиях, т.е. без учёта индивидуальных особенностей работников, анатомических (диаметр слуховых каналов у людей от 3 до 14 мм), и в отношении совершенства навыков правильного надевания СИЗОС. Для сравнения, та же компания (''3М Russia'') предлагает западным потребителям оборудование для индивидуального измерения фактического ослабления шума у каждого работника, т.к. без этого у многих из них оно будет близким к нулю.

Определить влияние выдачи противошумов на сбережение здоровья работников непросто. Для получения полноценного и качественного результата следует сравнить состояние здоровья у двух схожих групп работников, при схожих условиях труда, так, чтобы одна группа использовала средства защиты, а другая не применяла. Но уже много десятилетий закон обязывает работодателей обеспечивать всех работников СИЗ при опасном воздействии вредных факторов. И найти предприятие, где не только массово нарушают закон, но и согласятся участвовать в исследовании, результат которого будет опубликован - вряд ли возможно.

Специалисты [[:w:ru:Национальный институт охраны труда|Национального института охраны труда]] сумели решить проблему: используя уникальную базу данных с результатами проверки слуха работников, они выбрали аудиограммы для более чем 19 тыс. работников разных отраслей, за период 5 лет, и достаточно высокого качества. При отборе они выбирали лишь тех работников, которые при медосмотре проходили опрос, и отвечали на вопрос &quot;Используете ли Вы противошумы?&quot;. Выбранных работников разделили на 3 подгруппы: всегда отвечавших, что используют, всегда отвечавших, что не используют, и остальных. Сравнение частоты значительного ухудшения слуха в первых двух подгруппах показало, что у применявших СИЗОС частота утраты слуха была немножко ниже. Затем углублённый статистический анализ показал, что отличие - [[:w:ru:Статистическая значимость|статистически незначительно]] (т.е. может быть случайным)&lt;ref name=&quot;Groenewold-2014&quot; /&gt;.

По данным обзорной работы&lt;ref name=&quot;AIHA-2018&quot; /&gt; не опубликовано ни одного исследования, которое бы показало, что выдача работникам СИЗОС позволяет сколько-нибудь заметно помочь сохранить здоровье.

Так как при обеспечении работников противошумами в РФ не требуется давать им возможность выбрать наиболее удобный из нескольких разных (как в США и ряде других стран), можно ожидать, что эффект от их выдачи будет (в среднем) не лучше, чем полученный в исследовании&lt;ref name=&quot;Groenewold-2014&quot; /&gt;.

Часть специалистов по СИЗОС считает что эффект от их использования этих СИЗ можно повысить при проверках [[:w:ru:Производственный контроль эффективности СИЗОС|фактического ослабления шума у выбираемых моделей]], и периодическом повторении проверок&lt;ref name=&quot;AIHA-2018&quot; /&gt;. В СССР на крупных предприятиях иногда измеряли фактическое ослабление шума у вкладышей (при наличии в медико-санитарных частях предприятий [[:w:ru:Аудиометр|аудиометров]] и специалистов)&lt;ref name=&quot;Барский-1971&quot; /&gt;. Но сейчас большая часть  медико-санитарных частей (МСЧ) ликвидирована, а специальное оборудование для проверок не разрабатывается, (дорогое) импортное купить стало сложно.

== Примечания ==
{{примечания|refs=
&lt;ref name=&quot;Алиса-2003&quot;&gt;{{Книга|ссылка=https://nonoise.org/epa/hearingpro.pdf|автор=Alice H. Suter et al.|заглавие=Workshop on Hearing Protector Devices, March 27-28, 2003|год=2003|язык=en|место=Washington, DC|издательство=United States Environmental Protection Agency|allpages=212|access-date=2024-08-13|archive-date=2024-07-16|archive-url=https://web.archive.org/web/20240716183701/https://www.nonoise.org/epa/hearingpro.pdf|url-status=live}} перевод {{Книга|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1723229272&amp;archive=&amp;start_from=&amp;ucat=&amp;|автор=Алиса Сатер (редактор)|заглавие=Материалы конференции по индивидуальной защите от шума|год=2003|место=Вашингтон|издательство=Агентство по охране окружающей среды (EPA)}} [https://ru.wikipedia.org/wiki/Файл:Алиса-2003++.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;NIOSH-1979&quot;&gt;{{Книга|ссылка=https://ntrl.ntis.gov/NTRL/dashboard/searchResults/titleDetail/PB299319.xhtml|автор=Edwards R.G., Hauser W.P., Moiseev N.A., Broderson A.B., Green W.W., Lempert B.L.|заглавие=A field investigation of noise reduction afforded by insert-type hearing protectors|год=1979|язык=en|издание=NIOSH Report No. 79-115|место=Cincinnati, Ohio|издательство=National Institute for Occupational Safety and Health|страниц=54|серия=Technical Report}} '''Доступен перевод документа [https://ru.wikipedia.org/wiki/Файл:NIOSH_Шум_перевод_1979%2B%2B.pdf PDF] [[:w:s:ru:Измерения эффективности берушей у рабочих|Wiki]] [https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1670696418&amp;archive=&amp;start_from=&amp;ucat=&amp; копия]'''&lt;/ref&gt;

&lt;ref name=&quot;NIOSH-2015&quot;&gt;{{Книга |ссылка=https://www.cdc.gov/niosh/pubs/surveyreports/ |автор=William J. Murphy, Christa L. Themann, M.A., Taichi K. Murata (NIOSH in US HHS) and Roey Holliday, Rose Capers-Webb (US Department of the Interior) |заглавие=Field-Testing NIOSH HPD Well-Fit: Off-Shore Oil Rig Inspectors in Texas &amp; Louisiana |ответственный=United States Centers for Disease Control and Prevention |год=2015 |язык=en |место=Louisiana &amp; Texas |издательство=National Institute for Occupational Safety and Health |allpages=38 |серия=In-Depth Survey Report  -  EPHB Report No. 360-11a |doi=10.1080/14992027.2016.1204470}} [https://www.cdc.gov/niosh/surveyreports/pdfs/360-11a.pdf PDF] &lt;/ref&gt;

&lt;ref name=&quot;Lee-2022&quot;&gt;{{Статья|ссылка=https://www.researchsquare.com/article/rs-807643/v1|автор=Kah Heng Lee, Geza Benke, Dean Mckenzie|заглавие=The efficacy of earplugs at a major hazard facility|год=2022|язык=en|издание=Physical and Engineering Sciences in Medicine|издательство=Springler|выпуск=1|pages=107-114|volume=45||doi=10.1007/s13246-021-01087-y|archivedate=2021-09-01|archiveurl=https://web.archive.org/web/20210901112639/https://www.researchsquare.com/article/rs-807643/v1}} ISSN 2662-4729. Доступен [https://commons.wikimedia.org/wiki/File:Австралия_Шум.pdf перевод]&lt;/ref&gt;
&lt;ref name=&quot;Капцов-2023&quot;&gt;{{Статья|ссылка=https://www.elibrary.ru/item.asp?edn=iqmpkz&amp;ysclid=m2w84hrfq9457558565|автор=Капцов В.А., Панкова В.Б., Чиркин А.В|заглавие=Современные подходы к выбору и применению противошумов|год=2023|ответственный=Ломовцева С.Д., Храпко Н.Н., Васильева В.К., Иванов Н.И. (ред.)|автор издания=Балтийский государственный технический университет «ВОЕНМЕХ» им. Д.Ф. Устинова|место=Санкт-Петербург|издание=Защита от повышенного шума и вибрации|издательство=Институт акустических конструкций|тип=Сборник трудов конференции IX Всероссийской научно-практической конференции с международным участием|месяц=4|число=26–28|страницы=113-120}} [https://upload.wikimedia.org/wikipedia/commons/8/88/Шум_Капцов_СПб_2023+ru.pdf PDF]&lt;/ref&gt;

&lt;ref name=&quot;Alice-2012&quot;&gt;{{Статья|ссылка=http://www.sandv.com/downloads/1201sute.pdf|автор=Alice H. Suter|заглавие=Engineering Controls for Occupational Noise Exposure - The Best Way to Save Hearing|год=2012|язык=en|место=Henderson, Nevada|издание=Sound &amp; Vibration|издательство=Tech Science Press|выпуск=1|pages=24-31|volume=48|archivedate=2022-01-26|archiveurl=https://web.archive.org/web/20220126123850/http://www.sandv.com/downloads/1201sute.pdf}} ISSN 1541-0161. Есть перевод [https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1690379818&amp;archive=&amp;start_from=&amp;ucat=&amp; онлайн] , [https://files.library.by/dl/files/-Сатер-2012.zip ZIP]&lt;/ref&gt;
&lt;ref name=&quot;ISO-5&quot;&gt;{{Книга|ссылка= https://www.iso.org/ru/standard/32305.html|автор=TC ISO/TC 43/SC 1 Noise|заглавие=ISO/TS 4869-5:2006. Acoustics — Hearing protectors. Part 5: Method for estimation of noise reduction using fitting by '''inexperienced test subjects'''|год=2006|язык=en|место=Geneva, Switzerland|издательство=International Organization for Standardization |allpages=28}}&lt;/ref&gt;
&lt;ref name=&quot;ANSI-1974&quot;&gt;{{Книга|автор=Accredited Standards Committee S12, Noise|заглавие=ANSI S3.19-1974. Method for the Measurement of Real-Ear Protection of Hearing Protectors and Physical Attenuation of Earmuffs|ответственный=Acoustical Society of America|год=1974|язык=en|место=Melville, New York|издательство=American National Standards Institute|allpages=19}} [https://www.iitr.ac.in/safety/PPE/6229_METHOD_FOR_MEASERMENT_OF_REAL-EAR_PROTECTION_OF_HEARING_PROTECTORS__PHYSICAL_ATTENUATION_OF.pdf аналог]&lt;/ref&gt;

&lt;ref name=&quot;AIHA-2018&quot;&gt;{{Книга|ссылка=https://www.aiha.org/education/marketplace/noise-manual-6th-edition|автор=Elliott H. Berger &amp; Jérémie Voix|часть=Chapter 11. Hearing Protection Devices|заглавие=The Noise Manual|издание=6th ed|ответственный=D.K. Meinke, E.H. Berger, R. Neitzel, D.P. Driscoll &amp; K. Bright eds|год=2020|язык=en|место=Falls Church|издательство=American Industrial Hygiene Association|ссылка часть=https://online-ams.aiha.org/amsssa/ecssashop.show_product_detail?p_mode=detail&amp;p_product_serno=2719|страницы=257|страниц=621}}&lt;/ref&gt;

&lt;ref name=&quot;ИСО-1994&quot;&gt;{{Книга|автор=ISO/TC 43/SC 1|заглавие=ISO 4869-2:1994. Acoustics - Hearing protectors - Part 2: Estimation of effective A-weighted sound pressure levels when hearing protectors are worn|год=1994|язык=en|издательство=International Organization for Standardization|allpages=12|серия=ICS 13.340.20 Head protective equipment}}&lt;/ref&gt;
&lt;ref name=&quot;ГОСТ-212&quot;&gt;{{Книга|ссылка=https://meganorm.ru/Index2/1/4294820/4294820410.htm |автор=Научный центр социально-производственных проблем охраны труда|заглавие=ГОСТ Р 12.4.212-99 (ИСО 4869-2-94). ССБТ. СИЗОС. Оценка результирующего значения А-корректированных уровней звукового давления при использовании средств индивидуальной защиты от шума|ответственный=ТК 320 &quot;СИЗ&quot;|год=2000|часть=Предисловие|место=Москва|издательство=ИПК Издательство стандартов,|страницы=II|страниц=14|серия=ICS 13.340.20 Head protective equipment|тираж=301}} [https://meganorm.ru/Data2/1/4294820/4294820410.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;Рязань-2023&quot;&gt;{{Книга|ссылка=https://sgm.rzgmu.ru/binder|автор=Капцов В.А., Панкова В.Б., Чиркин А.В.|заглавие=Социально-гигиенический мониторинг здоровья населения|ответственный=В.А. Кирюшин (ред.)|год=2023|часть=Эффект ослабления антифонами воздействия шума на работника|место=Рязань|издательство=ФГБОУ ВО Рязанский государственный медицинский университет им. акад. И.П. Павлова Минздрава России|том=Выпуск 27|страницы=74-81|страниц=253|серия=Материалы к 27-й Международной научно - практической конференции|isbn=978-5-8423-0245-1}}&lt;/ref&gt;

&lt;ref name=&quot;Руководство 1976г&quot;&gt;{{книга|автор=Nelson Leidel, Kenneth Bush &amp; Jeremiah Lich|заглавие=NIOSH Occupational Exposure Sampling Strategy Manual|ссылка=https://www.cdc.gov/niosh/docs/77-173/|место=Cincinnati, Ohio|издательство=National Institute for Occupational Safety and Health|год=1977|серия=DHHS (NIOSH) Publication Number 77-173|allpages=150}} Есть перевод: [[:Файл:Руководство NIOSH по измерению загрязнённости воздуха 25.04.2014.pdf|PDF]] [https://ru.wikibooks.org/wiki/Измерение_загрязнённости_воздуха Wiki] &lt;/ref&gt;

&lt;ref name=&quot;Мартин-2021&quot;&gt;{{Книга|ссылка=https://irioh.ru/publish-books-2021-16ohrnc-materials/|автор=Мартин С.В., Кудряшов И.Н., Иващенко М.А.|заглавие=Материалы 16-го Российского Национального Конгресса с международным учас­тием «ПРОФЕССИЯ и ЗДОРОВЬЕ», 21‐24 сентября 2021 г., Владивосток|ответственный=науч. ред. [[:w:Бухтияров, Игорь Валентинович|Бухтияров И.В.]] и др.|год=2021|часть=Оценка акустического воздействия на работников промышленных предприятий|ссылка часть=https://doi.org/10.31089/978-5-6042929-2-1-2021-1-345-349|место=Москва|издательство=НКО Ассоциация врачей и специалистов медицины труда|страницы=345-349|страниц=624|isbn=978-5-6042929-2-1|doi=10.31089/978-5-6042929-2-1|access-date=2024-06-21|archive-date=2023-10-28|archive-url=https://web.archive.org/web/20231028115915/https://irioh.ru/publish-books-2021-16ohrnc-materials/|url-status=live}}&lt;/ref&gt;
&lt;ref name=&quot;Мартин-2023&quot;&gt;{{Книга|ссылка=https://irioh.ru/publish-books-2023-17ohrnc-materials/|автор=Мартин С.В., Федорук А.А., Иващенко М.А|заглавие=Материалы 17-го Российского Национального Конгресса с международным участием «Профессия и здоровье», 26‑29 сентября 2023 года, г. Нижний Новгород|ответственный=[[:w:Бухтияров, Игорь Валентинович|Бухтияров И.В.]] и др|год=2023|часть=Уровни шума на рабочих местах работников промышленных предприятий|ссылка часть=https://doi.org/10.31089/978-5-6042929-1-4-2023-1-301-306|место=Москва|издательство=ФГБНУ Научно-исследовательский институт медицины труда имени академика [[:w:Измеров, Николай Федотович|Н.Ф. Измерова]]|страницы=301-306|страниц=548|isbn=978-5-6042929-1-4|archive-date=2023-10-15|archive-url=https://web.archive.org/web/20231015001912/https://irioh.ru/publish-books-2023-17ohrnc-materials/}}&lt;/ref&gt;

&lt;ref name=&quot;Campo-2009&quot;&gt;{{Книга|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1702135988&amp;archive=&amp;start_from=&amp;ucat=&amp;|автор=Пьер Кампо, Кэти Маген, Стефан Габриэль, Анжела Мёллер, Эберхард Нис, Мария Долорес Соле Гомес и Эско Топпила|заглавие=Ухудшение слуха при воздействии промышленного шума и химикатов. Обзор|ответственный=Эусебио Риал Гонсалес и Джоанна Коск-Биенко (ред)|год=2009|оригинал=Combined exposure to Noise and Ototoxic Substance|язык=en|место=Люксембург|издательство=Европейское агентство по безопасности и гигиене труда|страниц=63|isbn=978-92-9191-276-612|doi=10.2802/16028|access-date=2023-12-09|archive-date=2023-12-09|archive-url=https://web.archive.org/web/20231209181723/https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1702135988&amp;archive=&amp;start_from=&amp;ucat=&amp;|url-status=live}} &lt;small&gt;{{Книга|ссылка=https://osha.europa.eu/en/publications/combined-exposure-noise-and-ototoxic-substances|автор=P. Campo, K. Maguin, S. Gabriel, A. Möller, E. Nies, M. Dolores, S. Gómez, E. Toppila|заглавие=Combined Exposure to Noise and Ototoxic Substances|ответственный=E.R. González, J. Kosk-Bienko|год=2009|язык=en|место=Luxembourg|издательство=European Agency for Safety and Health|allpages=62|серия=Literature reviews|isbn=978-92-9191-276-6|doi=10.2802/16028|archive-date=2023-12-03|access-date=2023-05-11|archive-url=https://web.archive.org/web/20231203151419/https://osha.europa.eu/en/publications/combined-exposure-noise-and-ototoxic-substances|url-status=live}}&lt;/small&gt;&lt;/ref&gt;
&lt;ref name=&quot;AIHA-2018-7&quot;&gt;{{Книга|ссылка=https://www.aiha.org/education/marketplace/noise-manual-6th-edition|автор=Thais C. Morata, Colleen G. Le Prell, Chris Spankovich, and Adrian Fuente|часть=Chapter 7. Ototoxicity and Otoprotection: Complex Interactions Between Noise and Chemicals |заглавие=The Noise Manual|издание=6th ed|ответственный=D.K. Meinke, E.H. Berger, R. Neitzel, D.P. Driscoll &amp; K. Bright eds|год=2020|язык=en|место=Falls Church|издательство=American Industrial Hygiene Association|ссылка часть=https://online-ams.aiha.org/amsssa/ecssashop.show_product_detail?p_mode=detail&amp;p_product_serno=2715|страницы=123-151|страниц=621}}&lt;/ref&gt;

&lt;ref name=&quot;OSHA-noise&quot;&gt;Пункт [[:s:ru:Стандарт по охране труда при работе в условиях шума (США)#выбор|1910.95(i)(3)]] в: [[:w:ru:Управление по охране труда (OSHA)|Occupational Safety and Health Administration]] Standard 29 CFR 1910.95 [https://www.law.cornell.edu/cfr/text/29/1910.95 Occupational noise exposure]. Есть [[:s:ru:Стандарт по охране труда при работе в условиях шума (США)| перевод]]&lt;/ref&gt;
&lt;ref name=&quot;CSA-2014&quot;&gt;{{Книга|ссылка=https://www.csagroup.org/store/product/2701515/|автор=A. Behar et al|заглавие=Z94.2-14. Hearing protection devices — Performance, selection, care and use|год=2014|часть=|язык=en|издание=7th ed|место=Toronto, Ontario, Canada|издательство=Canadian Standards Association (CSA Group)|pages=|allpages=54|isbn=978-1-77139-417-8|серия=Protective equipment - Head protective equipment|access-date=2023-11-07|}}&lt;/ref&gt;
&lt;ref name=&quot;Альберта-2022&quot;&gt;''Government of Alberta.'' [https://ohs-pubstore.labour.alberta.ca/lh003 Change highlights: Noise exposure – Part 16 in the OHS Code.] &lt;small&gt;OHS information for work site parties and service providers (англ.).&lt;/small&gt; ''ohs-pubstore.labour.alberta.ca'' (декабрь 2022). — «... Добавлено новое требование, согласно которому работодатели должны обеспечить проверку соответствия противошумов работникам и их умения правильно применять СИЗОС. ... Изменение введено для снижения риска развития нейросенсорной тугоухости, вызванной шумом. Эффективность противошумов сильно снижается, если они неправильно выбраны, неправильно вставлены или неправильно надеты. ...». Дата обращения: 11 февраля 2023. [https://miningwiki.ru/wiki/Файл:СИЗОС_Альберта_перевод-2.jpg перевод]&lt;/ref&gt;

&lt;ref name=&quot;ANZ-СИЗОС&quot;&gt;{{Книга|ссылка=https://www.standards.govt.nz/shop/asnzs-12702002|автор=Committee AV-003|заглавие=AS/NZS 1270:2002. Hearing protectors|год=2002|язык=en|издание=4th ed|место=Sydney, New South Wales|издательство=Standards Australia|allpages=30|серия=Acoustics|isbn=0-7337-4261-0}}&lt;/ref&gt;

&lt;ref name=&quot;Япония-СИЗОС-тест&quot;&gt;{{Книга|ссылка=https://webdesk.jsa.or.jp/preview/pre_jis_t_08161_001_000_2020_e_ed10_ch.pdf|автор=Technical Committee on Safety|заглавие=JSA JIS T 8161-1-2020 Acoustics - Hearing protectors - Part 1: Subjective method for the measurement of sound attenuation|ответственный=Japanese Industrial Standards Committee|год=2020|оригинал=JSA JIS T 8161-1-2020 聴覚保護具（防音保護具）―第１部：遮音値の主観的測定方法|язык=en|место=Tokyo|издательство=Japanese Standards Association|allpages=22|серия=ISO 4869-1:2018}}&lt;/ref&gt;
&lt;ref name=&quot;Япония-СИЗОС-обраб&quot;&gt;{{Книга|ссылка=https://webdesk.jsa.or.jp/preview/pre_jis_t_08161_002_000_2020_e_ed10_ch.pdf|автор=Technical Committee on Safety|заглавие=JSA JSA JIS T 8161-2-2020  Acoustics - Hearing protectors - Part 2: Estimation of effective A-weighted sound pressure levels when hearing protectors are worn|ответственный=Japanese Industrial Standards Committee|год=2020|оригинал=JSA JIS T 8161-2-2020 [https://kikakurui.com/t8/T8161-2-2020-01.html 聴覚保護具（防音保護具）―第２部：着用時の実効Ａ特性重み付け音圧レベルの推定]|язык=en|место=Tokyo|издательство=Japanese Standards Association|allpages=20|серия=ISO 4869-2:2018}}&lt;/ref&gt;

&lt;ref name=&quot;Индия-СИЗОС&quot;&gt;{{Книга|автор=Acoustics Sectional Committee, LTDC 5|заглавие=Indian Standard IS 9167-1979. Specification for ear protectors |ссылка= https://www.iitr.ac.in/safety/PPE/9167_SPECIFICATION_FOR_EAR_PROTECTORS.pdf |год= 2004|язык=en|место=New Deli|издательство= Bureau of Indian Standards|allpages=18|UDC=614.892:616.28-072.7}}&lt;/ref&gt;
&lt;ref name=&quot;Индия-СИЗОС-тест&quot;&gt;{{Книга|автор=AcousticalSectional Committee, LTDC 5|заглавие=Indian Standard IS 6229:1980. Method for measurement of real-ear protection of hearing protectors and physical attenuation of earmmuffs|ссылка= https://law.resource.org/pub/in/bis/S04/is.6229.1980.pdf |год=2001|язык=en|место=New Deli|издательство= Indian Standards Institution|allpages=22|серия=UDC 614:892 : 616:28-072.7}}&lt;/ref&gt;


&lt;ref name=&quot;CH-СИЗОС-вкладыш&quot;&gt;{{Книга|ссылка=https://www.gbstandards.org/China_standard_english.asp?code=GB/T%207584.1-2004&amp;id=7885|автор=The Standardization Administration of the People's Republic of China|заглавие= GB/T 31422-2015. Personal protective equipment - General technical requirements for hearing protectors|год=2015|оригинал=GB/T 31422-2015 个体防护装备 护听器的通用技术条件 |язык=en|издательство=China National Standards|allpages=40|серия=13.340.99}} [http://down.foodmate.net/standard/yulan.php?itemid=55144 ch]&lt;/ref&gt;
&lt;ref name=&quot;CH-СИЗОС-тест&quot;&gt;{{Книга|ссылка=https://www.gbstandards.org/China_standard_english.asp?code=GB/T%207584.1-2004&amp;id=7885|автор=The Standardization Administration of the People's Republic of China|заглавие=GB/T 7584.1-2004. Acoustics - Hearing protectors - Part 1: Subjective method for the measurement of sound attenuation|год=2004|оригинал=GB/T 7584.1-2004 声学 护听器 第1部分:声衰减测量的主观方法 |язык=en|издательство=China National Standards|allpages=12|серия=ISO 4869-1:1990}}&lt;/ref&gt;

&lt;!-- Комментарий --&gt; противошумы выбор


&lt;ref name=&quot;Кириллов-2010&quot;&gt;{{книга|автор=Кириллов В.Ф.|часть=Глава 25. Средства индивидуальной защиты |заглавие=Гигиена труда|издание=|ответственный=[[w:ru:Измеров, Николай Федотович|Измеров Н.Ф.]], Кириллов В.Ф. ред. | место=Москва|издательство= Издательская группа «ГЭОТАР-Медиа» |год=2008 |страницы=303-304|страниц=480|isbn=978-5-9704-3691-2|тираж=1000|серия=Учебник}} 2 изд., перераб. и доп. [https://e-library.sammu.uz/uploads/books/Rus%20tilidagi%20adabiyotlar/Гигиена/%2B%2BГигиена%20труда.pdf  2016]&lt;/ref&gt;

&lt;ref name=&quot;инспектор-2022&quot;&gt;Инструкция для инспектора по охране труда. [[:w:s:ru:Шум. Инструкция для инспектора по охране труда 2022 г.|Часть 5. Шум. ]] ''(США)'' US OSHA. [https://www.osha.gov/otm/section-3-health-hazards/chapter-5#noisecontroloverview NOISE]. OSHA Technical Manual (OTM) Section III: Chapter 5 ''(англ.).'' www.osha.gov. Occupational Safety and Health Administration (6 июля 2022)&lt;/ref&gt;
&lt;ref name=&quot;ANSI-2018&quot;&gt;{{Книга|ссылка=https://webstore.ansi.org/standards/asa/ansiasas12712018|автор=E.H. Berger et al (eds)|заглавие=ANSI/ASA S12.71-2018. Performance Criteria for Systems that Estimate the Attenuation of Passive Hearing Protectors for Individual Users|год=2018|язык=en|место=Melville, New York|издательство=American National Standard Institute|allpages=54|archive-date=2023-03-15|archive-url=https://web.archive.org/web/20230315103402/https://webstore.ansi.org/standards/asa/ansiasas12712018}} Цитата: Стандарт относится к системам для измерения ослабления шума, воздействующего на индивидуального работника, на предприятиях. В документе приводится классификация этих измерительных систем, и установлены критерии для оценки их эффективности. Также описано, как оценивать и вычислять погрешность измерения при использовании этих систем, и вычислять показатель ослабления шума у конкретного работника.&lt;/ref&gt;

&lt;ref name=&quot;EN-2021&quot;&gt;{{Книга|автор=British Standards Institution|заглавие=BS EN 17479:2021. Hearing protectors. Guidance on selection of individual fit testing methods|год=2021|издательство=BSI|allpages=46|isbn=978 0 539 04746 2}}&lt;/ref&gt;
&lt;ref name=&quot;Директива-шум&quot;&gt;{{Книга|автор=Publications Office of the European Union|заглавие=Directive 2003/10/EC of the European Parliament and of the Council of 6 February 2003 on the minimum health and safety requirements regarding the exposure of workers to the risks arising from physical agents (noise)|ссылка=https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:02003L0010-20190726|ответственный= P. Cox &lt;small&gt;''(European Parliament, President)''&lt;/small&gt;, G. Efthymiou &lt;small&gt;''(Council, President)''&lt;/small&gt;|год=2003 (2021)|часть=Article 6. Personal protection|язык=en|издание=Official Journal of the European Union, L|место=Brussels|pages=L 42/38 - L 42/44|серия=Document 02003L0010-20190726.  Seventeenth individual Directive within the meaning of Article 16(1) of Directive 89/391/EEC}} [https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:02003L0010-20190726 html] [https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:02003L0010-20190726 PDF]&lt;/ref&gt;

&lt;ref name=&quot;Japan-закон&quot;&gt;{{Книга|ссылка=https://www.japaneselawtranslation.go.jp/en/laws/view/3440|автор=Ministry of Health, Labour and Welfare|заглавие=Industrial Safety and Health Law|год=2006-08-02|часть=Article 22 in: Chapter IV. Measures for Preventing the Dangers or Health Impairment of Workers|язык=en|серия=[Law No. 57 of 1972] (Ordinance No. 257 of August 2, 2006)}}&lt;/ref&gt;
&lt;ref name=&quot;Japan-ПДУ&quot;&gt;{{Книга|ссылка=https://www.mhlw.go.jp/content/001089239.pdf|автор=厚生労働省労働基準局長 (Occupational health and safety standards department - Ministry of Health, Labour and Welfare)|заглавие=Пересмотр требований к защите от производственного шума|год=2020-04-20|часть=表 等価騒音レベル（Ａ特性音圧レベル）による許容基準 等価騒音レベ ル（dB) (Таблица. Предельно допустимое воздействие шума, дБА, для разных продолжительностей воздействия). В документе: |оригинал=騒音障害防止のためのガイドラインの改訂について|язык=jp|место=Japan|pages=4|allpages=27}}&lt;/ref&gt;
&lt;ref name=&quot;Japan-рекоменд&quot;&gt;''The Japan International Center for Occupational Safety and Health (JICOSH)''. [https://www.jisha.or.jp/international/jicosh/english/guideline/Guide-1.html Guidelines for the Prevention of Noise-Induced Impairments (1992)] &lt;small&gt;(англ.).&lt;/small&gt; www.jisha.or.jp. Japan: JICOSH (1999). Дата обращения: 19 октября 2024.&lt;/ref&gt;

&lt;ref name=&quot;ANZ-выборСИЗОС&quot;&gt;{{Книга|ссылка=https://www.standards.govt.nz/shop/ASNZS-1269-32005|автор=Joint Technical Committee AV-003, Acoustics, Human Effects|заглавие=AS/NZS 1269.3:2005. Occupational noise management. Part 3: Hearing protector program|год=2005 (2016-06-10)|язык=en|издание=3th ed|место=Sydney, New South Wales|издательство=Standards Australia|allpages=36|серия=Occupational noise management|isbn=0-7337-6550-5}}&lt;/ref&gt;

&lt;ref name=&quot;Капцов-2024-1&quot;&gt;{{Книга|ссылка=https://www.elibrary.ru/item.asp?id=75486593&amp;pff=1|автор=Капцов В.А., Панкова В.Б., Чиркин А.В.|заглавие=Социально-гигиенический мониторинг здоровья населения|часть=Сертификация и выбор противошумов с активным подавлением шума |ответственный=Кирюшин В.А. отв. ред.|год=2024|место=Рязань|издательство=Рязанский государственный медицинский университет им. акад. И.П. Павлова|страницы=71-76|страниц=219|серия=Материалы к Двадцать восьмой Международной научно-практической конференции, посвященной 175-летию со дня рождения академика И.П. Павлова, 10–11 октября 2024 года|isbn=978-5-8423-0322-9}} [https://rzgmu.ru/images/upload/users/sc/SGM_sbornik_ITOG_merged.pdf Сборник PDF]&lt;/ref&gt;
&lt;ref name=&quot;Капцов-2024-2&quot;&gt;{{Книга|ссылка=https://www.elibrary.ru/item.asp?id=75486627&amp;pff=1|автор=Капцов В.А., Панкова В.Б., Чиркин А.В.|заглавие=Социально-гигиенический мониторинг здоровья населения|часть= Сертификация и выбор противошумов с электронно-акустическими компонентами|ответственный=Кирюшин В.А. отв. ред.|год=2024|место=Рязань|издательство=Рязанский государственный медицинский университет им. акад. И.П. Павлова|страницы=76-81|страниц=219|серия=Материалы к Двадцать восьмой Международной научно-практической конференции, посвященной 175-летию со дня рождения академика И.П. Павлова, 10–11 октября 2024 года|isbn=978-5-8423-0322-9}} [https://rzgmu.ru/images/upload/users/sc/SGM_sbornik_ITOG_merged.pdf Сборник PDF]&lt;/ref&gt;


&lt;ref name=&quot;КНР-шум-прогноз&quot;&gt;{{Книга|ссылка=https://www.gbstandards.org/GB_standard_english2.asp?code=GB/T%207584.2-1999|автор=The Standardization Administration of the People's Republic of China|заглавие=GB/T 7584.2-1999. Acoustics - Hearing protectors - Part 2: Estimation of effective A-weighted sound pressure levels when hearing protectors are worn|год=1999|оригинал=GB/T 7584.2-1999 声学 护听器 第2部分：戴护听器时有效的A计权声压级估算|язык=en|издательство=China National Standards|allpages=16|серия=ISO 4869-2:1994}}&lt;/ref&gt;
&lt;ref name=&quot;КНР-шум-выбор&quot;&gt;{{Книга|ссылка=https://www.gbstandards.org/GB_standard_english2.asp?code=GB/T%2023466-2009|заглавие=GB/T 23466-2009. Guideline for selection of hearing protectors|год=2009|оригинал=GB/T 23466-2009. 护听器的选择指南|язык=en|издательство=China National Standards|allpages=16}}&lt;/ref&gt;
&lt;ref name=&quot;КНР-шум-практика&quot;&gt;{{Статья|ссылка=https://pubs.aip.org/asa/jasa/article/152/2/1074/2838503/Personal-attenuation-ratings-versus-derated-noise|автор=William J. Murphy, Wei Gong, Stephanie J. Karch, Jeremy Federman, Theresa Y. Schulz|заглавие=Personal attenuation ratings versus derated noise reduction ratings for hearing protection devices|год=2022|язык=en|автор издания=Acoustical Society of America|место=Melville, New York|издание=The Journal of the Acoustical Society of America|издательство=American Institute of Physics|месяц=8|число=22|выпуск=2|pages=1074–1089|volume=152|doi=10.1121/10.0013418}} ISSN 0001-4966, {{PMID|36050158}}.&lt;/ref&gt;

&lt;ref name=&quot;Groenewold-2014&quot;&gt;{{Статья|ссылка=https://stacks.cdc.gov/view/cdc/36768|автор=Groenewold M.R., Masterson E.A., Themann C.L., Davis R.R|заглавие=Do hearing protectors protect hearing?|год=2014|язык=en|издание=American Journal of Industrial Medicine|издательство=Wiley Periodicals|месяц=4|число= 3|выпуск=9|pages=1001-1010|volume=57 |doi=10.1002/ajim.22323}} ISSN 1097-0274, {{PMID|24700499}}. Есть [https://ru.wikipedia.org/wiki/Файл:СИЗ_органа_слуха,_и_профилактика_ухудшения_слуха.pdf '''перевод 1'''] [https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1668507313&amp;archive=&amp;start_from=&amp;ucat=&amp;#i2701 '''перевод 2''']&lt;/ref&gt;
&lt;ref name=&quot;Барский-1971&quot;&gt;{{Статья|ссылка=https://cyberleninka.ru/article/n/opyt-organizatsii-raboty-po-borbe-s-shumom-na-himicheskom-predpriyatii|автор=Барский И.П., Мазаев А.А., Маламут И.Е., Гутникова Е.Г., Килин В.Ф|заглавие=Опыт организации работы по борьбе с шумом на химическом предприятии|год=1971|язык=ru|издание=Гигиена и санитария|месяц=12|номер=12|страницы=89-92|archivedate=2022-12-14|archiveurl=https://web.archive.org/web/20221214175410/https://cyberleninka.ru/article/n/opyt-organizatsii-raboty-po-borbe-s-shumom-na-himicheskom-predpriyatii}} ISSN 0016-9900.&lt;/ref&gt;

&lt;ref name=&quot;МОТ-шум&quot;&gt;{{Книга|ссылка=http://base.safework.ru/iloenc|ответственный =Ю.Г. Сорокин &lt;small&gt;(''руководитель Департамента условий и охраны труда, Минтруд РФ'')&lt;/small&gt;; Жан-Виктор Груа &lt;small&gt;(''Директор Московского бюро МОТ'')&lt;/small&gt;|заглавие=Энциклопедия по безопасности и охране труда|год=2001|часть=[http://base.safework.ru/iloenc?d&amp;nd=857100159&amp;prevDoc=857100159&amp;spack=110LogLength%3D0%26LogNumDoc%3D857000269%26listid%3D010000000100%26listpos%3D3%26lsz%3D5%26nd%3D857000269%26nh%3D1%26 Программы защиты слуха]. В: Том 2; Раздел [http://base.safework.ru/iloenc?d&amp;nd=857400005&amp;prevDoc=857000002 IV. Вредные факторы общего характера], Глава [http://base.safework.ru/iloenc?d&amp;nd=857000269&amp;prevDoc=857000002 47. Шум] |автор=Ларри Х. Ройстер, Джулия Досвелл Ройстер |ссылка часть=|издание=4-е изд|место=Москва|издательство=Международная организация труда; Министерство труда и социального развития РФ|страницы= |страниц=1278|isbn=|серия= Охрана труда}} &lt;/ref&gt;
&lt;ref name=&quot;ILO-шум&quot;&gt;''Larry H. Royster &amp; Julia D. Royster''. [https://iloencyclopaedia.org/part-vi-16255/noise/item/754-hearing-conservation-programmes Hearing Conservation Programmes]. In: Vol. 2; [https://iloencyclopaedia.org/part-vi-16255/noise Chapter 47. Noise] // [https://iloencyclopaedia.org/ Encyclopedia of Occupational Health and Safety] / Michel Hansenne ed. — 4th ed. — Geneva: International Labour Office, 1998.&lt;/ref&gt;
&lt;ref name=&quot;Денисов-2013&quot;&gt;{{Статья|ссылка=https://cyberleninka.ru/article/n/problema-realnoy-effektivnosti-individualnoy-zaschity-i-privnosimyy-risk-dlya-zdorovya-rabotnikov-obzor-literatury/viewer|автор=Денисов Э.И., Морозова Т.В., Аденинская Е.Е., Курьеров Н.Н.|заглавие=Проблема реальной эффективности индивидуальной защиты и привносимый риск для здоровья работников (обзор литературы)|год=2013|автор издания=НИИ медицины труда РАН|издание=Медицина труда и промышленная экология|месяц=8|номер=8|страницы=18-25}} ISSN 1026-9428, {{PMID|24006620}}.&lt;/ref&gt;
&lt;ref name=&quot;АСИЗ-шум&quot;&gt;{{Книга|ссылка=https://asiz.ru/wp-content/uploads/2023/04/siz_metodishka_a5.pdf|автор=Спельникова М.И, Булгакова М. В., Жукова В.А., Ларионов А.Н., Хохлов А.И|заглавие=Методические рекомендации по подбору и применению средств индивидуальной защиты органа слуха|ответственный=В.И. Котов|год=2018|место=Москва|издательство=Ассоциация СИЗ|страниц=24}}&lt;/ref&gt; 
}}
[[Категория:Средства индивидуальной защиты (обзорная лекция)]]</text>
      <sha1>g90lf83hdvcj08vff0ayzht99d0sijm</sha1>
    </revision>
  </page>
  <page>
    <title>Средства индивидуальной защиты (обзорная лекция)/СИЗ лица и глаз</title>
    <ns>0</ns>
    <id>35736</id>
    <revision>
      <id>270424</id>
      <parentid>269050</parentid>
      <timestamp>2026-10-27T07:07:37Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270424</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="103937" sha1="mtan40h3om3yynfxfq919ca9oh82bvf" xml:space="preserve">[[File:230308-N-DE439-1051 - Engineering Drills.jpg|thumb|200px|Использование защитных очков]]'''Средства индивидуальной защиты лица и глаз''' - вид [https://miningwiki.ru/wiki/Средства_индивидуальной_защиты средств индивидуальной защиты], предназначенный для защиты лица и [[:w:глаз|глаз]] от: механических повреждений, воздействия химических веществ, [[:w:Пыль (вредный производственный фактор)|аэрозольных загрязнений воздуха]] и биоаэрозолей, раскалённых частиц, [[:w:лазер|лазерного]] и других [[:w:Электромагнитное излучение|электромагнитных излучений]] видимого и невидимых диапазонов разной интенсивности, неблагоприятного [[:w:Микроклимат|микроклимата]], [[:w:Поражение электрическим током|поражения электрическим током]], [[:w:Ионизирующее излучение|радиации]].

При работе с раскалённым металлом, стеклом и др., сварке на глаза и лицо действует интенсивное излучение инфракрасной, видимой и ультрафиолетовой частей спектра. [[:w:Инфракрасное излучение|Инфракрасное излучение]] может значительно повысить риск развития [[:w:Катаракта|катаракты]]&lt;ref name=&quot;БМЭ-3изд-ТОМ-10&quot; /&gt; хрусталика глаза&lt;ref name=&quot;Lydahl-1984&quot; /&gt;. Действие [[:w:Ультрафиолетовое излучение|ультрафиолетового облучения]] проявляется гораздо быстрее, уже через 2-6 часов появляется [[:w:Эпифора (медицина)|слезотечение]], [[:w:светобоязнь|светобоязнь]], боли, [[:w:Головная боль|головная боль]]&lt;ref name=&quot;Шафранова-1937-6&quot; /&gt;. 

=== СИЗ сварщиков ===
[[File:СИЗОД-с-принудительной-подачей-воздуха-под-шлем-сварщика-2.jpg|thumb|120px|left|Комбинированное СИЗ сварщиков]]При сварке работники подвергаются воздействию нескольких вредных производственных факторов: интенсивного светового и теплового излучения; [[:w:Пыль (вредный производственный фактор)|пыли]] токсичных веществ; вредных газов ([[:w:Монооксид углерода|окись углерода]], [[:w:Оксиды азота|оксидов азота]], углеводороды) и других&lt;ref name=&quot;БМЭ-Воронцова&quot; /&gt;&lt;ref name=&quot;МОТ-сварка&quot; /&gt;. Соответственно, лучше всего использовать для защиты комбинированные СИЗ, защищающие глаза, лицо, голову и органы дыхания&lt;ref name=&quot;СИЗ-1986-2&quot; /&gt;, пример слева (защита глаз, лица, органов дыхания), особенно при отсутствии хорошего местного отсоса и общеобменной [[:w:вентиляция |вентиляции]].

[[:w:Электроофтальмия|Электроофтальмия]]&lt;ref name=&quot;Электроофтальмия-2010&quot; /&gt; наблюдалась у вспомогательных рабочих ([[:w:Слесарь|слесарей]] и др.) даже чаще, чем у сварщиков&lt;ref name=&quot;Найман-1961-&quot; /&gt;. Для их защиты (например, при удерживании свариваемых деталей в требуемом положении при их креплении) рекомендованы СИЗ с полностью непроницаемой для света боковой поверхностью и умеренно затемнённым передним стеклом&lt;ref name=&quot;Шафранова-1937-6&quot; /&gt;.

==== Научные исследования ====
Неудобства, связанные с необходимостью поднимать и отпускать защитный щиток электросварщика, побуждали использовать разные приспособления, например - электропривод. Для профилактики электроофтальмии поднимание откидной части щитка со светофильтром блокировало зажигание сварочной дуги&lt;ref name=&quot;Найман-1961&quot; /&gt;. 

Для создания удобных в работе [[:w:Светофильтр|светофильтров]], прозрачных до зажигания [[:w:Электрическая дуга|сварочной дуги]], и быстро уменьшающих прозрачность при увеличении [[:w:Световой поток|светового потока]], проводились [[:w:Научно-исследовательские и опытно-конструкторские работы|научные исследования и опытно-конструкторские работы]]. Изучалось влияние [[:w:Поляризация волн|поляризованного света]] на животных и сварщиков&lt;ref name=&quot;Автозатемнение-1988&quot; /&gt;.

==== Требования к СИЗ ====
[[File:БИОТ-2019 Маска сварщика с подачей воздуха.jpg|thumb|right|310px|Комбинированное СИЗ сварщика, предусматривающее принудительную подачу отфильтрованного воздуха]]
Для защиты лица и глаз широко используют сварочные щитки разной конструкции со [[:w:светофильтр|светофильтрами]], уменьшающие воздействие теплового и ультрафиолетового излучения на лицо и глаза, и защищающие их от раскалённых частиц металлов. СИЗ глаз также используют при очистке [[:w:Окалина|окалины]] (например очки). Существуют международные и национальные стандарты с требованиями к таким СИЗ, и к светофильтрам (в том числе с автоматическим затемнением)&lt;ref name=&quot;СИЗ-сварка-2014&quot; /&gt;.

==== Выбор и применение ====
[[File:Great Bridge Lock Replacement 2014 (12680435433).jpg|thumb|right|300px|Защита лица и глаз при сварке]]
В довоенный период в СССР выпускались несколько видов защитных стёкол по затемнению (светофильтры &quot;ТИС&quot;, класс 1: ток свыше 350 А; 2: 100-350 А и 3: до 100 А; классы 3, 4 и 5 для сильной, средней и слабой ацетиленовой сварки). Для оценки соответствия их прозрачности выполняемой работе советовали: &quot;самое лучшее передать сомнительное стекло электросварщику, который и выяснит на работе, является ли стекло подходящим при соответствующем ампераже&quot;&lt;ref name=&quot;Шафранова-1937-6&quot; /&gt;.

Разработаны требования к выбору и применению СИЗ, закрепляемые на уровне национального законодательства, пример&lt;ref name=&quot;очки-США&quot; /&gt;.

==== Результат ====
В канадской провинции ([[:w:Альберта|Альберта]]) случаи травмирования глаз на рабочих местах чаще всего происходили у [[:w:Сварщик|сварщиков]], 21%. В основном это приводило к временной утрате трудоспособности (несколько дней), причина - попадание в глаза холодных частиц, обычно металлических 49%, неметаллических 14%; мусор 5%, раскалённых частиц 7%. 23% пострадало из-за интенсивного излучения. Каждый десятый не заметил случившееся сразу. Работники выполняли: обработку холодного металла 43%, сварка, резка или выдалбливали отверстие 24%, помогали другим работникам или смотрели, как они работают 16%. Чаще всего пострадавшие работали на &quot;металлообрабатывающих&quot; предприятиях или занимались сваркой листового металла. СИЗ глаз не использовали 77%&lt;ref name=&quot;Reed-1989&quot; /&gt;.

Причины травмирования глаз сварщиков и работников других профессий, выполнявших сварочные работы в США, оказались схожи: 77,5% попадание в глаз частиц, и 27,8% воздействие [[:w:Ультрафиолетовое излучение|ультрафиолетового излучения]] (в этом исследовании на сварщиков реже, чем на не сварщиков, 20% и 41%). В большинстве случаев использовалось исправное оборудование. Результат был получен путём анализа базы данных страховой организации (среди более 530 тыс. случаев в 2000 г. травмы глаз у сварщиков составили 1353, у других работников, выполнявших сварку 822). В 57% случаев в момент травмирования велись сварочные работы, [[:w:Шлифование|шлифование]] или очистка (в 22% информация о выполнявшейся работе отсутствовала). Информация о применении СИЗ часто отсутствовала (86%), а из тех случаев, когда имелась, в момент травмирования СИЗ не использовали 7%, снимали или надевали 20%&lt;ref name=&quot;Lombardi-2005&quot; /&gt;.

Среди 382 африканских сварщиков, занятых в &quot;неформальном&quot; секторе экономики, 3/4 имели личные СИЗ глаз (14% лицевые щитки, остальные - защитные очки; преимущественно нестандартные, &quot;местного&quot; производства, отчасти неэффективные). Но использовала их на практике лишь треть работников. При опросе они объяснили это тем, что СИЗ снижают [[:w:Производительность труда|производительность труда]] (большинство работает более 12 часов в день, среднемесячная зарплата порядка 100 долларов США), и неудобность СИЗ, и тем, что их использование увеличивает перегрев организма. Также указывали на кратковременность сварочной работы, низкую оценку уровня риска, нехватку времени и забывчивость. Результат: более 95% сварщиков сообщили, что за последний год у них был хотя бы один случай травмирования глаз. Риск травмирования глаз был ниже при использовании [[:w:Газовая сварка|газовой сварки]], обучении работника выполнению работы и применению СИЗ, и возрастал с ростом зарплаты&lt;ref name=&quot;Гана-2020&quot; /&gt;.

В статье&lt;ref name=&quot;Анисимова-2014&quot; /&gt;, без ссылки на первоисточник, приведены некоторые статистические данные о заболеваниях глаз. В целом, все профзаболевания глаз составили 6,4% от профзаболеваний в РФ; а из них 85% были профессиональные заболевания органа зрения сварщиков: лучевая катаракта, буллезная керопатопатия, и другие. Сюда не входит травмирование глаз инородными предметами. По данным&lt;ref name=&quot;Алексеева-1984&quot; /&gt; доля профзаболеваний глаз сварщиков меньше, в разных источниках 40-44%: снижение остроты зрения, рези, [[:w:ru:Электроофтальмия|покраснение глаз]], [[:w:ru:Катаракта|катаракту]], отёк и другие. Авторы отмечают, что при использовании мощных [[:w:Электрическая дуговая сварка|сварочных аппаратов]] ([[:w:судостроение|судостроение]]) эффективный отсос увеличивает оптическое воздействие на работника.

Большая доля профзаболеваний глаз именно у [[:w:Сварщик|сварщиков]], составляющих небольшую часть всех работников, может объясняться несовершенством используемых средств защиты, в том числе индивидуальных.

=== СИЗ лица и глаз ===
[[File:Researcher wearing face shield.jpg|thumb|right|240px|Лицевой щиток]]
Для защиты от летящих частиц; химических веществ, загрязняющих воздух в газообразном состоянии и в виде аэрозоля; лазерного и другого излучения используют очки, лицевые щитки и шлемы&lt;ref name=&quot;МОТ-глаза&quot; /&gt;. 

К причинам травмирования глаз относили&lt;ref name=&quot;МЗ-1987&quot; /&gt;:
# '''Организационные''': неправильная организация труда, отсутствие правил безопасности или надзора за их выполнением, недостаточная трудовая дисциплина, некачественный инструктаж и плохое обучение безопасным приёмам работы, неудовлетворительное содержание рабочих мест.
# '''Технические''': конструктивные недостатки оборудования, несоответствие технологии требованиям безопасности, недостаточная [[:w:автоматизация|автоматизация]], неисправности оборудования, инструментов, несовершенство [[:w:Средства коллективной защиты |средств коллективной защиты]].
# '''Санитарно-гигиенические''': не соответствие нормам температуры и влажности воздуха, плохое освещение (порядка четверти травм), повышенная запылённость и/или загазованность, загромождённость и теснота, повышенные [[:w:Производственный шум|шум]] и [[:w:Вибрационная болезнь|вибрация]], и другие факторы.
# '''Индивидуальные''': несоответствие работника [[:w:Профессиональная ориентация|профессиональному отбору]], нарушение им дисциплины, [[:w:Алкогольное опьянение|употребление алкоголя]], наличие общих заболеваний, включая заболевания глаз (травмы у рабочих с дефектами зрения наблюдались примерно вдвое чаще), недостаток опыта/квалификации (40% у необученных и 1% у квалифицированных рабочих).

==== Научные исследования ====
Защитные очки могут уменьшать [[:w:поле зрения|поле зрения]], что может затруднять ориентирование в пространстве, выполнение производственных операций, способствовать развитию утомления и ухудшению самочувствия&lt;ref name=&quot;Полоний-1980&quot; /&gt;. Отличие от параллельности лучей, идущих от объекта к глазу, вызывают его напряжение и [[:w:Утомление|утомление]]&lt;ref name=&quot;Голубева-1975&quot; /&gt;. Искажения оптических СИЗ влияют на работников: могут снижаться пороги [[:w:Зрение_человека#Контрастная_чувствительность|контрастной]] и [[:w:Зрение_человека#Световая_чувствительность_человеческого_глаза|световой чувствительности]], уменьшаться показатели [[:w:остроты зрения|остроты зрения]], изменяться пространственное восприятие&lt;ref name=&quot;МТПИЗЧ-21-1980&quot; /&gt;.

Испытания герметичных очков для защиты от газов проводят на манекене&lt;ref name=&quot;ГОСТ-очки-309&quot; /&gt;. У конкретного рабочего могут быть анатомические особенности, которые могут мешать добиться плотного прилегания обтюратора - что лабораторные сертификационные испытания не учитывают. Для сравнения, маски СИЗ органов дыхания проверяют на группе испытателей. В США и позднее в КНР провели широкомасштабные исследования для определения [[:w:ru:Антропометрия|антропометрических]] показателей работников, включавшие не только измерения размеров лиц и голов, но и трёхмерное сканирование - чтобы подобрать участников испытаний, соответствующих большинству работников&lt;ref name=&quot;Антропометрия&quot; /&gt;.

Согласно&lt;ref name=&quot;ГОСТ-очки-253&quot; /&gt; незапотевающие стёкла для защитных очков обозначаются &quot;N&quot; в конце маркировки. В условиях испытаний (водяная баня 50°С) они должны оставаться не запотевшими 8 секунд&lt;ref name=&quot;ГОСТ-очки-253&quot; /&gt;. В [https://miningwiki.ru/wiki/Технический_регламент_&quot;О_безопасности_СИЗ&quot;  Техническом Регламенте] требования иные: за полчаса светопропускание должно снижаться не более чем на 10% при влажности 80%, метод измерения не указан (раздел 4.3, пункт 17&lt;ref name=&quot;ТР-ТС&quot; /&gt;). Но, по данным (стр. 24&lt;ref name=&quot;Шафранова-1937&quot; /&gt;) все виды закрытых очков имеют тенденцию к запотеванию. А при тяжёлой физической работе, присутствии раскалённого металла, искр, тепловом излучении &quot;.. при специфических условиях этой группы работ '''стёкла всяких очков запотевают очень быстро'''; смазка против запотевания здесь мало помогает, так как стёкла покрываются потом, стекающим со лба рабочего. &quot;.

Попытка использовать 9 разных моделей очков в угольной шахте показала, что все закрытые очки запотевают за считанные минуты так, что их невозможно использовать; открытые могут запотевать за 10-20 минут. Единственная модель, в которой можно было работать 1-2 часа (С-15) не имели стёкол вообще, а состояли из мелкой металлической сетки (которую надо было периодически продувать из-за загрязнения пылью). Использование незапотевающих плёнок при большой запылённости в [[:w:Забой#Очистной_забой|очистных забоях]] привело к быстрому налипанию пыли на плёнку, и практически никакого положительного влияния они не давали. Часть рабочих начала использовать очки - кратковременно, при наибольшей опасности для глаз&lt;ref name=&quot;шахты-1969&quot; /&gt;.

==== Затруднения при использовании ====
Все защитные очки сужают нормальное [[:w:поле зрения|поле зрения]]. Из более чем полусотни моделей очков, предназначенных для защиты учащихся и подростков, и рабочих для работы у доменных, стекловаренных и нагревательных печей (при температурах до 1200, 1200-1500 и 1500-1800°С), [[:w:Прокатный стан|прокатных станов]], в кузнечных цехах, газо- и электросварке, газовой резке (средней и мощной), в строительстве, для персонала радиолокационных станций и лабораторий [[:w:ru:СВЧ_(значения)|СВЧ]], при работе с лазерами и люминесцентной дефектоскопии - лишь одна модель (ЗН16-90) могла использоваться вместе с корректирующими очками&lt;ref name=&quot;Гаевая-1972&quot; /&gt;. Оптические дефекты (царапины, сколы, неровности), ухудшение видимости - повышают утомляемость, вызывают головные боли, ухудшают самочувствие и остроту зрения, что снижает [[:w:Производительность труда|производительность труда]] и повышает риск травмирования.

У закрытых герметичных (противодымных) очков может происходить очень быстрое запотевание стёкол, не позволяющее выполнять работу&lt;ref name=&quot;Противогаз-глаза&quot; /&gt;. В результате при работе с агрессивными веществами на Щёлковском химическом завода глаза рабочих в большинстве случаев были не защищены, и в 1964-1966 гг. до 75% повреждения глаз произошло из-за не применения этих СИЗ&lt;ref name=&quot;очки-1970&quot; /&gt;. При использовании закрытых защитных очков отмечались случаи запотевания стёкол, и другие недостатки, и что часть работников их не использовала&lt;ref name=&quot;очки-1988&quot; /&gt;. Для защиты глаз от [[:w:ru:Сантиметровые волны |радиоволн сверхвысоких частот]] разработали закрытые очки со стеклянными линзами с очень тонким, прозрачным металлическим покрытием. И у них при практическом применении отмечалось запотевание стёкол, мешавшее использованию&lt;ref name=&quot;Денисенко-1981&quot; /&gt;. Для сравнения, у защитных очков схожего назначения, для боковой защиты предусматривалась металлическая сетка, и они не предназначались для длительного использования - главным средством были экраны, изолировавшие источники излучения&lt;ref name=&quot;СИЗ-1973-11&quot; /&gt;. При высокой влажности воздуха и небольшой скорости его движения, запотевание очков (без не запотевающих плёнок) в подготовительных выработках через 1-2 минуты могло быть таким, что шахтёры не могли продолжать работать. Также их использованию мешали слабая [[:w:Освещённость|освещённость]] и загрязнение стёкол&lt;ref name=&quot;Чистик-1969&quot; /&gt;. Невозможность использовать закрытые очки привела к тому, что вместо них для защиты глаз от токсичных веществ использовали [[:w:противогаз|противогазы]]&lt;ref name=&quot;Противогаз-глаза&quot; /&gt;.

Для того, чтобы не утомлять глаза использованием защитных очков, но, при необходимости, всегда иметь под рукой защиту для глаз от летящих частиц, шахтёры сами сделали каску с выдвигавшимся из-под неё щитком из органического стекла. В выдвинутом положении щиток находился на расстоянии 20 мм от лица, и потому не запотевал&lt;ref name=&quot;БТП-09-1971&quot; /&gt;. 

Поставщик СИЗ сообщила о возможности ошибок при выборе этих СИЗ; упомянула возможность запотевания стёкол закрытых очков, и наличии у некоторых моделей покрытия для уменьшения запотевания (причём в стандартизованной маркировке это не отражается); а также (для рабочих с ухудшившимся зрением) специальные защитные очки для ношения поверх корригирующих [[:w:Очки|очков]], которые могут быть неудобны&lt;ref name=&quot;Луговая-2014&quot; /&gt;. Также она упомянула, что все защитные очки, в большей или меньшей степени, дают искажение, которое может повлиять на работника (у очков 1 оптического класса оно меньше).

Отмечались различные недостатки, мешающие использованию защитных очков: открытые очки защищают от ударов частиц только спереди; использование закрытых очков вместе с корректирующими невозможно, у части рабочих возникает неприятное ощущение из-за их давления на лицо, при непрямой вентиляции - не защищают от пыли (при работе с едкими веществами - недопустимы), но и непрямая вентиляция не гарантирует отсутствие запотевания; очки с прочными стёклами - тяжёлые, неудобные, могут сползать во время работы&lt;ref name=&quot;Шафранова-1937&quot; /&gt;. 

==== Требования к СИЗ ====
Разработаны минимальные технические требования к таким СИЗ, национальные и международные, пример&lt;ref name=&quot;очки-ANSI&quot;/&gt;&lt;ref name=&quot;очки-ISO-&quot; /&gt;. Они выполняются изготовителями, и сертифицированные СИЗ поступают в продажу. 

При сертификации может проводиться проверка противозапотевающих покрытий. Но она проводится в строго определённых стандартизованных лабораторных условиях, в последних редакциях стандартов по СИЗ глаз предусмотрено тестирование не СИЗ в сборе, а изолированных стёкол. Такие проверки не дают никакой информации о риске запотевания при применении СИЗ на практике.

Из-за полной бесполезности лабораторной проверки запотеваемости стёкол (изолированных) для оценки риска утраты оптических свойств в условиях реального применения, в Канаде при сертификации &quot;антизапотевающие&quot; покрытия не проверяют вообще&lt;ref name=&quot;очки-Канада&quot;/&gt;.

==== Требования и рекомендации по выбору и применению ====
В США есть государственные требования к защите глаз и лиц работников&lt;ref name=&quot;очки-США&quot; /&gt;. В самих требованиях описаны лишь СИЗ при сварке, но указано, что для защиты от других [[:w:Вредный производственный фактор|производственных факторов]] следует выбирать СИЗ на основе стандарта, который сам по себе не обязателен для выполнения&lt;ref name=&quot;очки-ANSI&quot; /&gt;. Несмотря на то, что документ новый, и разработан с учётом выпуска широкого ассортимента защитных очков с покрытиями против запотевания, в нём часто рекомендуется защищать глаза так, как в СССР в 1942 году&lt;ref name=&quot;Противогаз-глаза&quot; /&gt; - с помощью СИЗОД с полнолицевой маской. У таких масок вдыхаемый воздух сначала обдувает смотровое стекло, а потом входит в подмасочник и органы дыхания. Обдув значительно уменьшает запотевание панорамных стёкол даже зимой. Аналогичная рекомендация давалась и в довоенный период, для случаев защиты не только глаз, но и лица от большого числа быстролетящих частиц (&quot;Случай V&quot; стр. 23-24&lt;ref name=&quot;Шафранова-1937&quot; /&gt;).

Требования (общего характера) есть в [[:w:ru:Северо-Западные территории |канадской провинции]]&lt;ref name=&quot;Канада-глаза+&quot; /&gt;, но юридически они менее &quot;обязательны&quot;, чем требования законодательства.

В Великобритании&lt;ref name=&quot;очки-BS&quot; /&gt;, Канаде&lt;ref name=&quot;Канада-глаза&quot; /&gt; и Австралии&lt;ref name=&quot;очки-AS&quot; /&gt; несколько десятилетий имеются рекомендации по выбору и использованию СИЗ глаз и лица, которые работодатели могут добровольно выполнять. Недавно появился и международный стандарт&lt;ref name=&quot;очки-ISO&quot; /&gt;.

В таких требованиях, например&lt;ref name=&quot;очки-США&quot; /&gt;, указывается на необходимость подбора и тщательной подгонки СИЗ у каждого работника, особенно при использовании закрытых очков для защиты от химических веществ. Это схоже с тем, что при использовании СИЗ органов дыхания маска должно прилегать к лицу плотно, без зазоров. Но при использовании респираторов во всех развитых странах требуется подбирать маски индивидуально и затем [[:w:Проверка изолирующих свойств респираторов |приборами проверять]] - соответствуют ли они лицу не только по размеру, но и по форме, и проверять, насколько правильно и аккуратно умеет их одевать каждый работник. Разработаны и изучены средства для проведения таких замеров. А в требованиях к выбору и применению защитных очков нет ничего подобного. И неизвестно, как они будут защищать конкретного работника - с учётом разнообразия лиц людей, особенно в области носа.

Из-за недопустимости подбора СИЗ глаз &quot;по профессии&quot; и даже по виду работ&lt;ref name=&quot;Шафранова-1937-1&quot; /&gt;, без учёта конкретных их особенностей, и индивидуальных особенностей работника, даны подробные рекомендации по выбору подходящих типов и моделей СИЗ. Отмечалось, что &quot;работать в таких ''(закрытых - прим.)'' очках дольше 10-15 минут подряд очень тяжело&quot;, и при защите глаз от газов и особо вредной пыли рекомендовалось использовать фильтрующие СИЗ органов дыхания с маской, закрывающей глаза; шланговые и другие изолирующие СИЗОД&lt;ref name=&quot;Шафранова-1937-4&quot; /&gt;.

Рекомендовалось&lt;ref name=&quot;Шафранова-1937-7&quot; /&gt;: 
# Перед выбором очень тщательно изучить все условия труда и характер работы, привлекая к этому [[:w:инженер|инженеров]], мастеров, представителей санинспекции, охраны труда и здравоохранения;
# Выполнять контроль качества поступающих на предприятие СИЗ;
# Выдавать СИЗ работникам только индивидуально;
# Выяснять степень их удобности, что необходимо сделать для её повышения (подобрать другую модель, заменить другим типом с равной степенью защиты, внести изменения в конструкцию);
# При запотевании, которое происходит у '''всех''' видов очков, особенно при работе на холоде, и когда рабочий потеет, рекомендовалось смазывать их обезвоженным натронным мылом, которое &quot;стекло остаётся незапотевшим более или менее долгое время. ... в обычных условиях ... для очков типа шофёрских ... смазка отдаляет момент запотевания стёкол не 40-50 минут&quot;. А &quot;герметичные закрытые без применения смазки запотевают через несколько секунд, а со смазкой выдерживают 10-15 мин.&quot;.
# Мастер обязан обучить рабочих и следить за правильным и своевременным использованием СИЗ;
# Рабочий должен следить за качеством и исправностью СИЗ, хранить их в футляре или завёрнутым в ткань/бумагу, перед работой протирать стёкла, после работы тщательно очищать, и своевременно использовать подходящие средства защиты.

==== Эффективность на практике ====
[[File:U.S. Air Force soldier uses a grinder to shape a metal part.jpg|thumb|right|300px|Защита лица и глаз при абразивной обработке металла]]
По данным Диспансера условий труда [[:w:ru:Кралево (город)|г. Кралево]] основными причинами 5883 травм глаз были недостаточная [[:w:Внимание|внимательность]] рабочих (из-за [[:w:Утомление|усталости]]), неопытность молодых рабочих, и повышенная самоуверенность опытных. Всех бесплатно обеспечивали разнообразными защитными очками, с и без боковой защиты глаз, часть получала защитные щитки и электросварочные шлемы. И большинство рабочих &quot;избегает их применения ''везде, где это возможно'', так как они ограничивают подвижность, в них неудобно работать, они вызывают усталость&quot;&lt;ref name=&quot;Бачанац-1997&quot; /&gt;. 

Это согласуется с результатами исследований защитных очков и их практического применения, проведённых ВНИИ охраны труда ВЦСПС и Государственным [[:w:Национальный медицинский исследовательский центр глазных болезней имени Гельмгольца|НИИ глазных болезней им. Гельмгольца]]: очки могут использоваться только если они удобные; своевременное применение прямо зависит от сохранения остроты зрения и поля зрения. Также отмечалось, что длительное применение защитных очков вызывает головную боль и утомление зрения, вынуждающие отказываться от их использования&lt;ref name=&quot;Очки-ГОСТ&quot; /&gt;.

Изучение обстоятельств травмирования глаз у 426 китайских больных показало, что в 21% случаев СИЗ работодателем не выдавались. Причин травм работников, которым выдавали СИЗ: недостатки СИЗ (60%) и отсутствие знаний и навыков по охране труда (40%). Поскольку большинство пострадавших не применяло СИЗ, авторы сделали вывод о необходимости их использования - в сочетании с правильным выбором достаточно надёжных изделий&lt;ref name=&quot;глаза-стат-Ch&quot; /&gt;.

В 2016-2018 гг. была собрана информация о 1424 пациентах из 4 госпиталей в [[:w:ru:Тэгу|Тэгу]] (Южная Корея). Тяжёлые травмы глаз несколько чаще происходили у тех работников, которые не применяли СИЗ; но отличие не было [[:w:Статистическая значимость|статистически значимым]]. Авторы предположили, что СИЗ могли не соответствовать выполняемой работе и/или индивидуальным особенностям сотрудника. По виду работы, пострадавшие часто шлифовали или резали металл, сваривали его, работали с химикатами (29, 14 и 7%). СИЗ использовали 61 из 1341 пострадавших&lt;ref name=&quot;Корея-2020&quot; /&gt;.

Из 500 участников исследования, проведённого в ОАЭ, и работавших на 95 небольших предприятиях, подавляющее большинство знало об опасности и о наличии доступных (в большинстве случаев) СИЗ. Но большинство рабочих не использовало их своевременно, или вовсе не применяло: снижение производительности труда, ухудшение остроты зрения, трудности с использованием в нагревающем микроклимате, неудобность СИЗ&lt;ref name=&quot;глаза-стат-&quot; /&gt;.

По австралийским данным, полученным из отделений скорой помощи, больниц, и при выплате компенсаций рабочим&lt;ref name=&quot;глаза-стат-AU&quot; /&gt;, в сообщениях о травмировании глаз часто отсутствуют сведения об использовании или не применении СИЗ. Авторы были уверены, что СИЗ позволяют эффективно предотвращать травмы. Но, при наличии данных о применении СИЗ, оказалось: в [[:w:Виктория (штат)| Виктория]] отношение между использовавшими и не применявшими СИЗ в момент травы около 7:5; при сварочных работах, отношение между использовавшими и не применявшими СИЗ (или применявшими, но неправильно): 23:15; а в штатах [[:w:Квинсленд|Квинсленд]] и [[:w:Южная Австралия|Южная Австралия]] СИЗ применяли в 5 раз чаще, чем не использовали. Исходные данные были достоверны, и авторы оказались сильно удивлены этим результатом. Они отметили, что сообщения о травмировании глаз при использовании СИЗ публиковались и ранее. Чаще всего несчастные случаи происходили при [[:w:Абразивные материалы и абразивная обработка|абразивной обработке]], и сварке. В трёх провинциях, охваченных исследованием, проживало более половины населения страны.

Из 1069 пациентов офтальмологической клиники в Калгари (Канада) треть использовала СИЗ&lt;ref name=&quot;глаза-стат-Ca&quot; /&gt;.

В СССР ежегодно изготавливалось 13 млн. пар различных защитных очков, а в РСФСР около 10% случаев травм глаза происходило при использовании этих СИЗ&lt;ref name=&quot;МЗ-1987&quot; /&gt;. 9 из 10 травм происходили у работников-мужчин, по виду работы - при обработке металла (71,6%), в том числе 36% при ручной обработке, немеханизированных операциях. 55% - молодые рабочие (до 40 лет), 2/3 первично выходивших на инвалидность - жители деревни.

Со ссылкой на Бюро трудовой статистики (''BLS''), [[:w:Управление по охране труда (OSHA)|Департамент условий труда]] (Минтруд США) сообщил, что из каждых 5 пострадавших двое использовали СИЗ глаз. При этом в 94% случаев химикат или летящий предмет попадал в глаз сбоку или снизу, что совпадает с наблюдением за результатами использования открытых очков (1937 г. с. 14&lt;ref name=&quot;Шафранова-1937&quot; /&gt;): &quot;... очки открытого типа защищают глаза только спереди и лишь отчасти сбоку, а потому полной гарантии безопасности они не дают&quot;. Разрушение СИЗ случалось редко. Около 40% работников не имели представления о том, какие СИЗ должны применяться. В целом, в США регистрируют порядка тысячи травм глаз ежедневно&lt;ref name=&quot;глаза-стат-US&quot; /&gt;, в 2020 г. зарегистрировано 18 510 случаев временной утраты трудоспособности из-за травм глаз; в 2024 г. более 2 тысяч штрафов за нарушения требований к защите органов зрения работников&lt;ref name=&quot;Очки-штрафы&quot; /&gt;.

=== Первая помощь при травмах глаз и их профилактика ===
Во-первых, при подозрении на попадание в глаз осколка или другой травме следует незамедлительно обратиться к специалисту. При повреждении крупным предметом нельзя его извлекать самостоятельно.

Для удаления мелких инородных частиц из [[:w:ru:Ферромагнетики|ферромагнитных]] металлов может использоваться [[:w:магнит|магнит]], для остальных может быть полезна промывка (есть специальные фонтанчики), при попадании химических веществ - промыть проточной водой&lt;ref name=&quot;Гаевая-1972&quot; /&gt;.

При ожоге кислотами следует промывать глаз слабым раствором 1-2% раствором соды.

При попадании щёлочи необходимо промывать слабым раствором [[:w:Борная кислота|борной кислоты]] (1 чайная ложка на стакан воды). Химические повреждения могут происходить и при попадании в глаза стройматериалов (штукатурка, цемент и [[:w:Известь (материал)|известь]] относятся к щелочной группе).

При повреждении глаз [[:w:Ультрафиолетовое излучение|ультрафиолетовым излучением]], прямым или отражённым, может быть полезен холодный водяной компресс, закапывание в глаза рыбьего жира, вазелинового масла (жидкого жира).

Главным средством профилактики травмирования глаз должно снова стать использование [[:w:средства коллективной защиты|средств коллективной защиты]] (улучшение технологии, автоматизация и механизация работ, [[:w:дистанционное управление|дистанционное управление]], защитные экраны из прозрачных материалов и сеток, и другие приспособления, [[:w:вентиляция|вентиляция]] и т.п.).

Если избежать использования СИЗ не удалось, то &quot;Необходимо учитывать, что эффективность применяемых средств защиты зависит не только от их выбора, но и от индивидуальной подгонки, а также правильного хранения. ... Выбор защитных очков, щитков, масок зависит в первую очередь от конкретных условий производственного процесса и его особенностей, характера повреждающих агентов, возможной опасности для глаз, длительности выполняемой операции ...&lt;ref name=&quot;Гаевая-1972&quot; /&gt;.&quot;.


В числе мер, предупреждающих ранения глаз работников, главным является соблюдение требований техники безопасности&lt;ref name=&quot;Профилактика-глаза-2018&quot; /&gt;:
# техническая грамотность сотрудников;
# адекватная техническая оснащённость рабочих мест, отбраковка устаревших инструментов и оборудования;
# наличие и правильное, своевременное применение эффективных [[:w:Средства коллективной защиты|средств коллективной защиты]], а также СИЗ;
# нетерпимость к личной [[:w:Дисциплинированность|недисциплинированности]] (иногда она свойственна молодым работникам).

=== СИЗ глаз от лазерного излучения ===
[[File:Flickr - Official U.S. Navy Imagery - An electronics engineer at Naval Surface Warfare Center, Corona Division, prepares alignment of various optical components using eye-safe visible lasers..jpg|thumb|right|310px|Использование СИЗ глаз от лазерного излучения видимого диапазона]]
==== Требования к СИЗ ====
При [[:w:Безопасность лазеров|защите глаз от опасного лазерного излучения]] возникает ряд проблем. СИЗ должны достаточно хорошо пропускать электромагнитное излучение видимого диапазона, так, чтобы в них можно было работать; и одновременно они должны очень сильно ослаблять излучение на [[:w:Длина волны#Случай электромагнитной волны|длине волны]] лазерного оборудования. По данным руководства для инспекторов по охране труда ([[:w:OSHA|OSHA]]) в промышленности США используют порядка 17 разных ''основных'' типов [[:w:лазер|лазеров]] с разными длинами волн&lt;ref name=&quot;инспектор-2022-l&quot; /&gt;. А по данным&lt;ref name=&quot;Пальцев-1976&quot; /&gt; уже в 1969 году в СССР было разработано 65 типов лазерного оборудования, использовавшего суммарно излучение с 357 разными длинами волн.

В результате для многих видов лазеров СИЗ не были разработаны вообще&lt;ref name=&quot;СИЗОС-1973-лазер&quot; /&gt;.

==== Выбор СИЗ глаз от лазерного излучения ====
Рекомендации по выбору СИЗ глаз от лазерного излучения, и при настройке лазеров, есть в приложениях в стандартах&lt;ref name=&quot;Лазеры-рекоменд&quot; /&gt;&lt;ref name=&quot;Лазеры-настройка-рекоменд&quot; /&gt;.

== Примечания ==
{{примечания|refs=
&lt;ref name=&quot;БМЭ-3изд-ТОМ-10&quot;&gt;{{книга|автор= Шмелева В. М. Абдуллаева В.М, |часть= [http://бмэ.орг/index.php/КАТАРАКТА Катаракта] |часть ссылка=  |ответственный=гл. ред. Б.В. Петровский|заглавие=Большая медицинская энциклопедия |издание=3 изд |место=Москва|издательство=Советская энциклопедия |год=1979 |том=10. [http://бмэ.орг/index.php/Категория:Том_10 Кабаков - Коалесценция] |томов=30 |страницы=  |страниц=528 |тираж=150300}}&lt;/ref&gt;
&lt;ref name=&quot;Lydahl-1984&quot;&gt;{{Статья|автор=E. Lydah, B. Philipson.|заглавие=Infrared radiation and cataract. I. Epidemiologic investigation of iron- and steel-workers|год=1984|язык=en|издание=Acta Ophthalmologica|издательство=John Wiley &amp; Sons, Inc|месяц=12|выпуск=6|pages=849-1024|volume=62||doi=10.1111/j.1755-3768.1984.tb08449.x|pmid=}} ISSN 1755-375X, {{PMID|6524321}}&lt;/ref&gt;
&lt;ref name=&quot;МОТ-глаза&quot;&gt;{{Книга|ссылка=http://base.safework.ru/iloenc|ответственный =Ю.Г. Сорокин &lt;small&gt;(''руководитель Департамента условий и охраны труда, Минтруд РФ'')&lt;/small&gt;; Жан-Виктор Груа &lt;small&gt;(''Директор Московского бюро МОТ'')&lt;/small&gt;.|заглавие=Энциклопедия по безопасности и охране труда|год=2001|часть=[http://base.safework.ru/iloenc?d&amp;nd=857400341&amp;prevDoc=857400341&amp;spack=110LogLength%3D0%26LogNumDoc%3D857400038%26listid%3D010000000100%26listpos%3D1%26lsz%3D7%26nd%3D857400038%26nh%3D1%26 Средства защиты глаз и лица]. В: Том 1; Раздел [http://base.safework.ru/iloenc?d&amp;nd=857400005&amp;prevDoc=857000002 IV], Глава [http://base.safework.ru/iloenc?d&amp;nd=857400038&amp;prevDoc=857400346 31. Средства индивидуальной защиты] |автор=Кикузи Кимура |ссылка часть=|издание=4-е изд|место=Москва|издательство=Международная организация труда; Министерство труда и социального развития РФ|страницы= |страниц=1278|isbn=|серия= Охрана труда}} [https://www.iloencyclopaedia.org/part-iv-66769/personal-protection-59388 ''Eye and Face Protectors'']&lt;/ref&gt;

&lt;ref name=&quot;БМЭ-Воронцова&quot;&gt;{{книга|автор= Воронцова Е.И.|часть= [http://бмэ.орг/index.php/СВАРКА Сварка, гигиена труда] |часть ссылка=  |ответственный=гл. ред. Б.В. Петровский|заглавие=Большая медицинская энциклопедия |издание=3 изд |место=Москва| издательство=Советская энциклопедия |год=1984 |том=23. [http://бмэ.орг/index.php/Категория:Том_23 Сахароза - Сосудистый тонус] |томов=30 |страницы=  |страниц=544 |тираж=150 800}}&lt;/ref&gt;

&lt;ref name=&quot;МОТ-сварка&quot;&gt;{{Книга|ссылка=http://base.safework.ru/iloenc|ответственный =Ю.Г. Сорокин &lt;small&gt;(''руководитель Департамента условий и охраны труда, Минтруд РФ'')&lt;/small&gt;; Жан-Виктор Груа &lt;small&gt;(''Директор Московского бюро МОТ'')&lt;/small&gt;.|заглавие=Энциклопедия по безопасности и охране труда|год=2001|часть=[http://base.safework.ru/iloenc?d&amp;nd=857200685&amp;prevDoc=857200685&amp;spack=110LogLength%3D0%26LogNumDoc%3D857200672%26listid%3D010000000100%26listpos%3D2%26lsz%3D9%26nd%3D857200672%26nh%3D1%26 Сварка и огневая резка]. В: Том 3; Раздел [http://base.safework.ru/iloenc?d&amp;nd=857200805&amp;prevDoc=857000002 XIII], Глава [http://base.safework.ru/iloenc?d&amp;nd=857200648&amp;prevDoc=857200685 82. Технология металлов и металлообрабатывающая промышленность] |автор=Филип А. Платкоу, Г.С. Линдон |ссылка часть=|издание=4-е изд|место=Москва|издательство=Международная организация труда; Министерство труда и социального развития РФ|страницы= |страниц=1278|isbn=|серия= Охрана труда}}&lt;/ref&gt;


&lt;ref name=&quot;СИЗ-1986-2&quot;&gt;{{Книга|автор=Сосенков Ю.Н., Клавдиенко А.С., Каминский С.Л.|заглавие=Испытание автономного пневмошлема в комплекте с переносным источником воздухоснабжения при выполнении электросварочных работ |ответственный=Бутова Т.Н. отв. ред|год=1986|часть=Пути совершенствования автономных комплектов|место=Черкассы|издательство=ВНИИТЭХИМ |страницы=12-13|страниц=105|серия=Тезисы докладов Всесоюзной конференции, Северодвинск, октябрь 1986 г.|тираж=300 |ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1731670742&amp;archive=&amp;start_from=&amp;ucat=&amp;}}&lt;/ref&gt;
&lt;ref name=&quot;Найман-1961-&quot;&gt;{{Книга|автор=Найман И.М.|заглавие=Защита глаз на производстве|год=1961|часть=Защита глаз вспомогательных рабочих. В: Глава III. Защита глаз от лучистой энергии, раздел : Средства защиты лица и глаз при электросварочных работах|издание=2-ое изд., перераб. и дополн|место=Москва|издательство=Профиздат|страницы=181-183|страниц=288|тираж=7000}}&lt;/ref&gt;
&lt;ref name=&quot;Электроофтальмия-2010&quot;&gt;{{Книга|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1742903361&amp;archive=&amp;start_from=&amp;ucat=&amp;|автор=С. Х. Чурмантаева, Д.М. Вагопова, М.П. Обухова, Л.Р. Каримова, Л.В. Гирфанова, С.Р. Кадырова, Д.Р. Исхакова|заглавие=Профессиональные заболевания электросварщиков: пособие для врачей|ответственный=Министерство здравоохранения Республики Башкортостан|год=2010|часть=5. Заболевания органа зрения у электросварщиков|место=Уфа|издательство=Федеральное государственное учреждение науки &quot;Уфимский научно-исследовательский институт медицины труда и экологии человека&quot; Роспотребнадзора|страницы=19-26|страниц=30|isbn=978-5-9613-0158-8|тираж=100}}&lt;/ref&gt;
&lt;ref name=&quot;Найман-1961&quot;&gt;{{Книга|автор=Найман И.М.|заглавие=Защита глаз на производстве|год=1961|часть=Щитки и маски с автоматическими приспособлениями. В: Глава III. Защита глаз от лучистой энергии, раздел : Средства защиты лица и глаз при электросварочных работах|издание=2-ое изд., перераб. и дополн|место=Москва|издательство=Профиздат|страницы=175-179|страниц=288|тираж=7000}}&lt;/ref&gt;
&lt;ref name=&quot;Автозатемнение-1988&quot;&gt;{{Книга|автор=Гаврилова Л.М.|заглавие=Научно-технический прогресс и проблемы гигиены труда|ответственный=[https://ru.wikipedia.org/wiki/Кундиев,_Юрий_Ильич Кундиев Ю.И.] отв. ред|год=1988|часть=Результаты экспериментальных и производственных исследований по сравнительной оценке средств индивидуальной защиты органа зрения сварщика|издание=Министерство здравоохранения УССР|место=Киев|издательство=Киевский НИИ гигиены труда и профзаболеваний|страницы=52-54|страниц=184|серия=Тезисы докладов республиканской научно-практической конференции|тираж=750}}&lt;/ref&gt;


&lt;ref name=&quot;Reed-1989&quot;&gt;{{Статья|автор=Michael R. Reed, Ronald M. Dufresne, Donna Suggent, Brian C. Alleyne|заглавие=Welder Eye Injuries|год=1989|язык=en|автор издания=American Occupational Medical Association|место=Baltimore, Maryland|издание=Journal of Occupational Medicine|издательство=Wolters Kluwer Health, Inc.|месяц=12|выпуск=12|pages=1003-1006|volume=31|issn=|doi=10.1097/00043764-198912000-00014|pmid= }} ISSN 1076-2752, {{PMID|2533251}}&lt;/ref&gt;
&lt;ref name=&quot;Lombardi-2005&quot;&gt;{{Статья|ссылка=https://www.researchgate.net/publication/7809599_Welding_related_occupational_eye_injuries_A_narrative_analysis|автор=Lombardi D.A., Pannala R., Sorock G.S., Wellman H., Courtney T.K., Verma S., Smith G.S.|заглавие=Welding related occupational eye injuries: a narrative analysis|год=2005|язык=en|автор издания=International Society for Child and Adolescent Injury Prevention|место=London|издание=Injury prevention|издательство=MJ Pub. Group|месяц=3|выпуск=3|pages=174–179|volume=11|issn=|doi=10.1136/ip.2004.007088|pmid=|pmc=}} ISSN 1353-8047, PMC PMC1730216, {{PMID|15933411}}&lt;/ref&gt;
&lt;ref name=&quot;Гана-2020&quot;&gt;{{Статья|ссылка=https://www.researchgate.net/publication/344284840_Prevalence_and_Factors_Influencing_Eye_Injuries_among_Welders_in_Accra_Ghana|автор=Karl Kafui Kwaku Tetteh, Richard Owusu, Wisdom Kudzo Axame|заглавие=Prevalence and Factors Influencing Eye Injuries among Welders in Accra, Ghana|год=2020|язык=en|автор издания=Cairo : Hindawi Pub. Corp.|место=Egypt|издание=Advances in preventive medicine|издательство=John Wiley &amp; Sons, Inc.|месяц=9|число=16|выпуск=3|pages=2170247|issn=|doi=10.1155/2020/2170247|pmid=|pmc=}} ISSN 2090-3499, PMC PMC7516735, {{PMID|33014472}}&lt;/ref&gt;

&lt;ref name=&quot;Корея-2020&quot;&gt;{{Статья|автор=Jae Yun Ahn, Hyun Wook Ryoo, Jung Bae Park, Sungbae Moon, Jae Wan Cho, Dong Ho Park, Won Kee Lee, Jung Ho Kim, Sang Chan Jin, Kyung Woo Lee &amp; Jong-Yeon Kim|заглавие=Epidemiologic Characteristics of Work-related Eye Injuries and Risk Factors Associated with Severe Eye Injuries: A Registry-based Multicentre Study|год=2020|язык=en|автор издания=International Society of Geographical and Epidemiological Ophthalmology|место=London|издание=phthalmic Epidemiology|издательство=Taylor &amp; Francis|месяц=4|выпуск=2|pages=105-114|volume=27|issn=|doi=10.1080/09286586.2019.1683868|pmid=}} ISSN 0928-6586, {{PMID|31672074}}&lt;/ref&gt;


&lt;ref name=&quot;Шафранова-1937-6&quot;&gt;{{Книга|автор=Шафранова А.С.|заглавие=Индивидуальная защита глаз рабочего на производстве|ответственный=ВЦСПС, Московский научно-исследовательский институт охраны труда|год=1937|часть=6. Защита глаз от действия лучистой энергии|место=Москва|издательство=Профиздат|страницы=33-35, 40|страниц=48|тираж=15300|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1738063241&amp;archive=&amp;start_from=&amp;ucat=&amp;}} [https://files.library.by/dl/files/СИЗ%20глаз%201937%20%2048%20с.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;СИЗ-сварка-2014&quot;&gt;{{Книга|ссылка=https://meganorm.ru/Index2/1/4293774/4293774117.htm |автор=ОАО &quot;ВНИИ сертификации&quot;|заглавие=ГОСТ 12.4.254-2013 ССБТ Средства индивидуальной защиты глаз и лица при сварке и аналогичных процессах. Общие технические условия|год=2014|место=Москва|издательство=Стандартинформ|страниц=31|серия=МКС 13.340.20; EN 175:1997 Equipment for eye and face protection during welding and allied processes + EN 379:2003 Automatic welding filter|тираж=91}} [https://meganorm.ru/Data2/1/4293774/4293774117.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;Анисимова-2014&quot;&gt;{{Статья|ссылка=https://cyberleninka.ru/article/n/klinicheskie-effekty-regulyatora-energeticheskogo-obmena-pri-korrektsii-narusheniy-slezoproduktsii-professionalnogo-geneza/viewer |автор=Анисимова С. Г., Мазина Н. К., Абрамова Т.|заглавие=Клинические эффекты регулятора энергетического обмена при коррекции нарушений слезопродукции профессионального генеза|год=2014|автор издания=ФГУН &quot;Уфимский НИИ медицины труда и экологии человека&quot; Роспотребнадзора|издание=Медицинский вестник Башкортостана|издательство=Издательство &quot;ГБОУ ВПО БГМУ&quot;,|месяц=2|том=9|номер=2|страницы=163-169|issn=}} ISSN 1999-6209, [https://www.mvb-bsmu.ru/files/journals/2_2014.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;Алексеева-1984&quot;&gt;{{Книга|автор=Алексеева И.С.|заглавие=Гигиена и безопасность труда при электросварочных и плазменных работах в судостроении|ответственный=Алексеева И.С., Норкин Ю.И.|год=1984|часть=Глава 2. Условия труда и мероприятия по их улучшению при основных сварочных процессах|место=Ленинград|издательство=Судостроение|страницы=39|страниц=112|тираж=6100}}&lt;/ref&gt;


&lt;ref name=&quot;МЗ-1987&quot;&gt;{{Книга|автор=Гундорова Р.А., Гришина В.С., Южаков А.М., Травкин А.Г., Валева Р.Г., Киселёва О.А., Денисенко О.Н., Леванов В.Я.|заглавие=Профилактика травм органа зрения. Применение средств индивидуальной защиты|ответственный=Лукьянчикова Л.С. , Панов В.Г. (Министерство здравоохранения РСФСР)|год=1987|место=Москва|страниц=21|серия=Методические рекомендации|тираж=500}}&lt;/ref&gt;
&lt;ref name=&quot;очки-1970&quot;&gt;{{Статья|автор=Гаевая Л.А., Фомина Н.И.|заглавие=Новый тип очков - моноблок|год=1970|ответственный=Всесоюзный центральный научно-исследовательский институт охраны труда|место=Москва|издание=Научные работы институтов охраны труда ВЦСПС|издательство=Профиздат|том=65|страницы=95-96}}&lt;/ref&gt;
&lt;ref name=&quot;очки-1988&quot;&gt;{{Книга|автор=Денисенко О.Н., Рогальский Л.М., Коротева А.Н.|заглавие=Совершенствование охраны труда в народном хозяйстве Средней Азии. Всесоюзная научно-практическая конференция, 29-31 марта 1988 г.|ответственный=Бульда Б.В., Искандеров Т.И. (ред.), Алиев М.А. (отв. за выпуск)|год=1988|часть=Новые очки для защиты глаз работающих с пестицидами в сельском хозяйстве|место=Ташкент|издательство=ВЦСПС|том=1|страницы=178-179|страниц=238|серия=тезисы докладов|тираж=500}}&lt;/ref&gt;
&lt;ref name=&quot;СИЗ-1973-11&quot;&gt;{{Книга|автор=Белявских К.С., Марченко Б.С.|заглавие=Пути совершенствования средств индивидуальной защиты работающих на производстве|ответственный=Цуцков М.Е., Городинский С.М., Смирнов В.Ф|год=1973|часть=Разработка и внедрение радиозащитных открытых очков |место=Москва|издательство=ВЦНИИОТ ВЦСПС|страницы=185-189|страниц=286|серия=материалы всесоюзного совещания|тираж=3000 |ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1731670742&amp;archive=&amp;start_from=&amp;ucat=&amp;}}&lt;/ref&gt;
&lt;ref name=&quot;ТР-ТС&quot;&gt;{{Книга|ссылка=https://www.novotest.ru/tr-ts/019-2011/tr-ts-019-2011.pdf|автор=Российская Федерация (Министерство здравоохранения и социального развития).|заглавие=Технический Регламент Таможенного Союза ТР ТС 019/2011 О безопасности средств индивидуальной защиты|ответственный=утв. Решением Комиссии Таможенного Cоюза от 9 декабря 2011 г. N 878|год=2011|место=Москва|страниц=167}}&lt;/ref&gt;


&lt;ref name=&quot;Денисенко-1981&quot;&gt;{{Книга|автор=Денисенко О.Н., Плиско Т.А., Безрукова А.А., Фомина Н.И.|заглавие=Технический прогресс и охрана труда|ответственный=Цуцков М.Е. (ред.)|год=1981|часть=К разработке индивидуальной защиты глаз от излучения СВЧ|место=Москва|издательство=Профиздат|страницы=42-43|страниц=148|серия=сборник научных работ институтов охраны труда ВЦСПС|тираж=5000}}&lt;/ref&gt;
&lt;ref name=&quot;Чистик-1969&quot;&gt;{{статья|автор=Чистик И.Я.|заглавие= Защитные очки для подземных рабочих угольных шахт|автор издания=Государственный Комитет по надзору за безопасным ведением работ в промышленности и горному надзору при Совете Министров СССР|издание=Безопасность труда в промышленности|ссылка=https://btpnadzor.ru/vypuski/1969/6 |место=Москва|издательство=|год=1969|номер=6|страницы=10-11|issn=}} ISSN 0409-2961&lt;/ref&gt;
&lt;ref name=&quot;Луговая-2014&quot;&gt;{{Статья|ссылка= http://lib.rgotups.ru/JournalsContent2014/SpravochnikSpecialistapoOhraneTruda_05.pdf|автор=Луговая Е.П.|заглавие=Правильный подбор защитных очков для предотвращения травм органов зрения|год=2014|место=Москва|издание=Справочник специалиста по охране труда|издательство=ЗАО &quot;МЦФЭР&quot;|месяц=5|номер=5|страницы=42-50|issn=}} ISSN 1727-6608&lt;/ref&gt;
&lt;ref name=&quot;Противогаз-глаза&quot;&gt;{{Статья|ссылка=https://cyberleninka.ru/article/n/himicheskie-porazheniya-glaz-ih-profilaktika-i-lechenie-obzor |автор=Каплан Ю.Д. |заглавие=Химические поражения глаз, их профилактика и лечение (обзор)|год=1942|издание=Гигиена и санитария|месяц=2|номер=1-2|страницы=40-46|issn=|}} ISSN 0016-9900&lt;/ref&gt;
&lt;ref name=&quot;Шафранова-1937-1&quot;&gt;{{Книга|автор=Шафранова А.С.|заглавие=Индивидуальная защита глаз рабочего на производстве|ответственный=ВЦСПС, Московский научно-исследовательский институт охраны труда|год=1937|часть=Предисловие; 1. Защита глаз на производстве|место=Москва|издательство=Профиздат|страницы=4; 7-8|страниц=48|тираж=15300|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1738063241&amp;archive=&amp;start_from=&amp;ucat=&amp;}} [https://files.library.by/dl/files/СИЗ%20глаз%201937%20%2048%20с.pdf PDF] Цитаты: &quot;ФЗМК и общественные инспектора по охране труда должны взять под особый контроль всю систему выписки и назначения рабочим очков и других приспособлений. Очень часто эти назначения производятся формально-бюрократически, неправильно, не по глазам рабочего, что вместо пользы даёт только вред. В этих случаях рабочие отказываются носить выданные очки и по существу работают без защитных приспособлений. Защитные приспособления должны помогать рабочим, а не стеснять их, не мешать работе.&quot; с. 4; &quot;'''Почему же рабочие так часто отказываются от ношения защитных очков?''' Всякий предмет, надеваемый на лицо человека, так или иначе стесняет его; и обычно, чем лучшую защиту дают те или иные очки, тем больше неудобств они причиняют. Понятно, что рабочий, уже привыкший работать без очков, возражает против них, так как ему приходится приспосабливаться к новым условиям и '''он боится снижения уже достигнутой производительности труда.''' &quot; с. 7-8.&lt;/ref&gt;
&lt;ref name=&quot;Шафранова-1937-4&quot;&gt;{{Книга|автор=Шафранова А.С.|заглавие=Индивидуальная защита глаз рабочего на производстве|ответственный=ВЦСПС, Московский научно-исследовательский институт охраны труда|год=1937|часть=4. Защита глаз от пыли|место=Москва|издательство=Профиздат|страницы=14; 23-20|страниц=48|тираж=15300|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1738063241&amp;archive=&amp;start_from=&amp;ucat=&amp;}} [https://files.library.by/dl/files/СИЗ%20глаз%201937%20%2048%20с.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;Шафранова-1937-7&quot;&gt;{{Книга|автор=Шафранова А.С.|заглавие=Индивидуальная защита глаз рабочего на производстве|ответственный=ВЦСПС, Московский научно-исследовательский институт охраны труда|год=1937|часть=7. Свабжение очками, правила применения и хранения их|место=Москва|издательство=Профиздат|страницы=44-48|страниц=48|тираж=15300|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1738063241&amp;archive=&amp;start_from=&amp;ucat=&amp;}} [https://files.library.by/dl/files/СИЗ%20глаз%201937%20%2048%20с.pdf PDF]&lt;/ref&gt;

&lt;ref name=&quot;Бачанац-1997&quot;&gt;{{Статья|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1748444042&amp;archive=&amp;start_from=&amp;ucat=&amp;|автор=Бачанац М.|заглавие=Профилактика офтальмокониоза у рабочих ФВК Кралево|год=1997|место=Москва|издание=Медицина труда и промышленная экология|издательство=НИИ медицины труда РАМН|месяц=4|номер=4|страницы=37-38|issn=}} ISSN 1026-9428&lt;/ref&gt;
&lt;ref name=&quot;Очки-ГОСТ&quot;&gt;{{статья|автор=И.М. Найман, А.В. Рославцев.|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1751206333&amp;archive=&amp;start_from=&amp;ucat=&amp;  |заглавие= О государственном стандарте на средства индивидуальной защиты глаз |издание=Гигиена труда и профессиональные заболевания |издательство=НИИ медицины труда РАМН |год=1960 |номер=5|месяц=5 |issn=|страницы=56-58 }} ISSN 0016-9919&lt;/ref&gt;
&lt;ref name=&quot;ГОСТ-очки-253&quot;&gt;{{Книга|автор=ОАО «Всероссийский научно-исследовательский институт сертификации».|заглавие=ГОСТ 12.4.253-2013. Средства индивидуальном защиты глаз. Общие технические требования|год=2019|место=Москва|издательство=Стандартинформ|страниц=39|серия=ЕН 166-2002|тираж=1}} [https://meganorm.ru/Data2/1/4293774/4293774119.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;ГОСТ-очки-309&quot;&gt;{{Книга|ссылка=https://meganorm.ru/Index2/1/4293748/4293748660.htm |автор=ОАО «Всероссийский научно-исследовательский институт сертификации»|заглавие=ГОСТ 12.4.309.2-2016. Средства индивидуальной защиты глаз. Методы испытаний оптических и неоптических параметров|год=2017|место=Москва|издательство=Стандартинформ|страниц=51|серия=EN 167:2002, EN 168:2002|тираж=30}} [https://meganorm.ru/Data2/1/4293748/4293748660.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;шахты-1969&quot;&gt;{{Книга|автор=Чистик Иван Яковлевич.|заглавие=Защитные очки в профилактике повреждений глаз у подземных рабочих угольных шахт. Диссертация на соискание учёной степени кандидата медицинских наук|ответственный=Р.А. Гундорова, А.В. Рославцев (науч. руковод.)|год=1969|часть=2. Индивидуальные средства защиты глаз у подземных рабочих, в: Комплексные мероприятия, направленные на снижение повреждений глаз у подземных рабочих.|место=Москва|издательство=Московский НИИ глазных болезней им. Гельмгольца|страницы=119-138|страниц=211}}&lt;/ref&gt;
&lt;ref name=&quot;Полоний-1980&quot;&gt;{{Книга|автор=Н.Б. Борисов, [[:w:ru:Ильин, Леонид Андреевич|Л.А. Ильин]], У.Я. Маргулис, Г.М. Пархоменко, В.Т. Хрущ.|заглавие=Радиационная безопасность при работе с полонием-210|ответственный=И.В. Петрянов ред|год=1980|часть=7. Средства индивидуальной защиты, в: Глава 6. Гигиена труда при работе с полонием|место=Москва|издательство=Атомиздат|страницы=172-180|страниц=262|тираж=1300}}&lt;/ref&gt;
&lt;ref name=&quot;МТПИЗЧ-21-1980&quot;&gt;{{Книга|автор=Л.С. Урмахер, Л.И. Лурье, А.Н. Карцев.|заглавие=Медико-технические проблемы индивидуальной защиты человека|ответственный=В.С. Кощеев ред|год=1980|часть=К разработке нового государственного стандарта на метод определения остроты зрения при использовании средств индивидуальной защиты|издание=Выпуск 21|место=Москва|издательство=Институт биофизики|страницы=97-104|страниц=180|серия=сборник научных трудов}}&lt;/ref&gt;
&lt;ref name=&quot;Голубева-1975&quot;&gt;{{Книга|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1731671835&amp;archive=&amp;start_from=&amp;ucat=&amp; |автор=Голубева И.А.|заглавие=Проблемы индивидуальной защиты человека. Часть 2|ответственный=[[:w:ru:Городинский, Семён Михайлович|С.М. Городинский]] (ред.)|год=1975|часть= Вопросы физиолого-гигиенического нормирования оптико-технических характеристик средств индивидуальной защиты |место=Москва|издательство=ВНИИ медицинской и медико-технической информации|страницы=38-58|страниц=104|серия=научный обзор|тираж=1500}}&lt;/ref&gt;

&lt;ref name=&quot;очки-США&quot;&gt;{{Книга|ссылка=https://www.govinfo.gov/content/pkg/CFR-2009-title29-vol5/pdf/CFR-2009-title29-vol5-sec1910-133.pdf|автор=US OSHA|заглавие=OSHA Standard 29 CFR 1910.133 Eye and face protection|год=2009|язык=en|место=Washington, DC|издательство=Occupational Safety and Health Administration}}&lt;/ref&gt;
&lt;ref name=&quot;очки-ANSI&quot;&gt;{{Книга|ссылка=https://safetyequipment.org/wp-content/uploads/2022/12/Eye-and-Face-Selection-Guide-tool.pdf|автор=Z87 Committee on Safety Standards for Eye Protection, International Safety Equipment Association.|заглавие=ANSI/ISEA Z87.1-2020. Occupational and Educational Personal Eye and Face Protection Devices|ответственный=American National Standards Institute|год=2020|часть=Annex J. Eye and Face Selection Guide (informative)|язык=en|место=Arlington, Virginia|allpages=60}}&lt;/ref&gt;

&lt;ref name=&quot;Антропометрия&quot;&gt;{{Статья|автор=Zhuang Z., Bradtmiller B., &amp; Shaffer R.E.|заглавие=New respirator fit test panels representing the current U.S. civilian work force|год=2007|язык=en|автор издания=American Industrial Hygiene Association and ACGIH|издание=Occupational and Environmental Hygiene|издательство=Taylor &amp; Francis|месяц=9|выпуск=9|pages=647–659|volume=4|issn=|doi=10.1080/15459620701497538|pmid=}} ISSN 1545-9624, {{PMID|17613722}}, публикации по теме [https://www.cdc.gov/niosh/docket/archive/pdfs/niosh-036/0036-062607-zhuang_pres.pdf 1] [https://nap.nationalacademies.org/read/11815/chapter/1#xii 2]&lt;/ref&gt;
&lt;ref name=&quot;Канада-глаза+&quot;&gt;{{Книга|ссылка=https://www.wscc.nt.ca/documents/personal-protective-equipment-eye-and-face-protection |автор=Workers’ Safety &amp; Compensation Commission|заглавие=Eye and face protection|ответственный=Canadian Centre for Occupational Health and Safety (CCOHS)|год=2015|язык=en|место=Yellowknife|издательство=WSCC|allpages=20|серия=Code of Practice - Personal Protective Equipment}} [https://www.wscc.nt.ca/sites/default/files/documents/PPE%20Eye%20and%20Face%20Protection%20Code%20of%20Practice%2C%20May%2031%2C%202016%20-%20%20EN%20-%20NT.pdf ''PDF'']&lt;/ref&gt;
&lt;ref name=&quot;Шафранова-1937&quot;&gt;{{Книга|автор=Шафранова А.С.|заглавие=Индивидуальная защита глаз рабочего на производстве|ответственный=ВЦСПС, Московский научно-исследовательский институт охраны труда|год=1937|часть=3. Защита глаз от отлетающих твёрдых частиц|место=Москва|издательство=Профиздат|страницы=14; 23-24|страниц=48|тираж=15300|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1738063241&amp;archive=&amp;start_from=&amp;ucat=&amp;}} [https://files.library.by/dl/files/СИЗ%20глаз%201937%20%2048%20с.pdf PDF]&lt;/ref&gt;

&lt;ref name=&quot;очки-BS&quot;&gt;{{Книга|ссылка=https://middleware.accord.bsigroup.com/pdf-preview?path=Preview%2F000000000019994460.pdf&amp;inline=true&amp;_gl=1*2nj6h*_gcl_au*MTIyOTAwODgyNS4xNzMwOTk0NTc4*_ga*NTMwMTEwNjUxLjE3MzA5OTQ1Nzg.*_ga_RWDQ3VY9NQ*MTczMDk5NDU3Ny4xLjEuMTczMDk5NjQ3My4wLjAuMA..|автор=Technical Committee PH/2 Eye protection|заглавие=BS 7028:1999. Eye protection for industrial and other uses. Guidance on selection, use and maintenance|год=1999|язык=en|издание=2nd ed|место=London|издательство=British Standards Institution|allpages=28|серия=13.340.20 Head protective equipment|isbn=0 580 33047 8}}&lt;/ref&gt;
&lt;ref name=&quot;Канада-глаза&quot;&gt;{{Книга|автор=Canadian Standards Association.|заглавие=CSA Z94.3.1, Guideline for selection, use, and care of eye and face protectors|год=2016|язык=en|издание=2nd ed|место=Toronto, Ontario|издательство=CSA Group|allpages=31}} '''Копия''' рекомендаций стандарта по выбору СИЗ глаз и лица есть в Правилах по охране труда {{Книга|ссылка= https://www.wscc.nt.ca/sites/default/files/documents/PPE%20Eye%20and%20Face%20Protection%20Code%20of%20Practice%2C%20May%2031%2C%202016%20-%20%20EN%20-%20NT.pdf|автор=Chief Safety Officer, Workers’ Safety and Compensation Commission|заглавие=Eye and Face Protection|год=2015|часть=5.5 Classes of protectors|язык=en|место=Yellowknife - Inuvik; Northwest Territories &amp; Nunavut|издательство=WSCC|pages=12-13|allpages=20|серия=Personal Protective Equipment  -  Codes of Practice}}&lt;/ref&gt;
&lt;ref name=&quot;очки-AS&quot;&gt;{{Книга|автор=Committee SF-006.|заглавие=AS/NZS 1336:2014. Eye and face protection - Guidelines|год=2014|язык=en|издание=5th ed|место=Sydney, New South Wales|издательство=Standards Australia|allpages=35|серия=13.340.20 Head protective equipment|isbn=978 1 74342 770 5}}&lt;/ref&gt;
&lt;ref name=&quot;очки-ISO&quot;&gt;{{Книга|ссылка=https://cdn.standards.iteh.ai/samples/74267/d4ab512a32124c7d8a7bf37274537fcf/ISO-19734-2021.pdf|автор=Technical Committee ISO/TC 94/SC 6|заглавие=ISO 19734:2021. Eye and face protection — Guidance on selection, use and maintenance|год=2021|язык=en|место=Geneva, Switzerland|издательство=International Organization for Standardization|allpages=50|серия=13.340.20 Head protective equipment}}&lt;/ref&gt;
&lt;ref name=&quot;очки-ISO-&quot;&gt;{{Книга|ссылка=https://www.iso.org/standard/84835.html|автор=Technical Committee TC 94/SC 6|заглавие=ISO 16321-1:2021/Amd.1:2024. Eye and face protection for occupational use Part 1: General requirements|место=Geneva, Switzerland|издательство=International Organization for Standardization|allpages=14|серия=ICS 13.340.20}}&lt;/ref&gt;
&lt;ref name=&quot;очки-Канада&quot;&gt;{{Книга |автор=Chou B.R. et al (Technical Committee on Eye and Face Protection) |заглавие=CSA standard Z94.3-15. Eye and face protectors |ответственный=Canadian Standards Association |год=2015 |язык=en |издание=8th edition |место=Toronto (Ontario, Canada) |издательство=CSA Group |allpages=91 |isbn=978-1-77139-938-8}}&lt;/ref&gt;
&lt;ref name=&quot;глаза-стат-AU&quot;&gt;{{Книга|автор=Tim Driscoll, Louise Flood and James Harrison.|заглавие=Work-related eye injuries in Australia|ответственный=Australian Safety and Compensation Council|год=2008|часть=3.10. Personal protective equipment|язык=en|издательство=Australian Government|pages=18-19|allpages=39|isbn=978-0-642-32756-7|ссылка=https://www.safeworkaustralia.gov.au/system/files/documents/1702/workrelatedeyeinjuriesaustralia_2008_pdf.pdf}}&lt;/ref&gt;
&lt;ref name=&quot;БТП-09-1971&quot;&gt;{{статья|автор=Г. Терещенко, А. Захаров, Глушаков.|заглавие= Каска с щитком для защиты глаз |ссылка= |автор издания=Государственный Комитет по надзору за безопасным ведением работ в промышленности и горному надзору при Совете Министров СССР|издание=Безопасность труда в промышленности|место=Москва|издательство=ЗАО &quot;Алмаз-Пресс&quot;|год=1971|номер=9|страницы=51|issn=}} ISSN 0409-2961&lt;/ref&gt;
&lt;ref name=&quot;глаза-стат-Ch&quot;&gt;{{Статья|ссылка=https://injuryprevention.bmj.com/content/27/6/521|автор=Fei Sun, Yongdong Zhou, Liqun Dong, Haofang Qin.|заглавие=Relationship between the use and type of eye protection and work-related corneal and conjunctival foreign body injuries|год=2021|язык=en|автор издания=Society for Advancement of Violence and Injury Research (SAVIR)|издание=Injury Prevention|издательство=BMJ Publishing Group Ltd|выпуск=6|pages=521-526|volume=27|issn=|doi=10.1136/injuryprev-2020-043958|pmid=}} ISSN 1353-8047, {{PMID|33443032}}&lt;/ref&gt;
&lt;ref name=&quot;глаза-стат-&quot;&gt;{{Статья|ссылка=https://injepijournal.biomedcentral.com/articles/10.1186/s40621-020-00280-z|автор=T. AlMahmoud, I. Elkonaisi, M. Grivna, F. Abu-Zidan.|заглавие=Personal protective eyewear usage among industrial workers in small-scale enterprises|год=2020|язык=en|издание=Injury Epidemiology|издательство=BioMed Central Ltd (Springer Nature)|pages=54|volume=7|issn=|doi=10.1186/s40621-020-00280-z|pmid=|pmc=}} ISSN 2197-1714, PMC PMC7507252, {{PMID|32958044}}&lt;/ref&gt;
&lt;ref name=&quot;глаза-стат-Ca&quot;&gt;{{Статья|автор=Helena Zakrzewski, Helen Chung, Emi Sanders, Christopher Hanson, Bryce Ford.|заглавие=Evaluation of occupational ocular trauma: are we doing enough to promote eye safety in the workplace?|год=2017|язык=en|автор издания=Canadian Ophthalmological Society|издание=Canadian Journal of Ophthalmology|месяц=8|выпуск=4|pages=338-342|volume=52|issn=|doi=10.1016/j.jcjo.2016.11.034}} ISSN 0008-4182&lt;/ref&gt;
&lt;ref name=&quot;глаза-стат-US&quot;&gt;{{Книга|ссылка=https://www.elcosh.org/document/1616/d000152/Eye+Protection+in+the+Workplace.html |автор=California Occupational Safety and Health Administration|заглавие=Eye protection in the workplace|ответственный=U.S. Department of Labor|год=1993|язык=en|место=California|allpages=2}} [https://www.elcosh.org/record/document/1616/d000152.pdf ''PDF'']&lt;/ref&gt;

&lt;ref name=&quot;Очки-штрафы&quot;&gt;{{Статья|ссылка=https://ohsonline.com/Articles/2024/11/19/Beyond-the-Goggles-Navigating-Eye-and-Face-Protection.aspx?admgarea=ht.PPE|автор=Cindy Pauley.|заглавие=Beyond the Goggles: Navigating Eye and Face Protection|год=2024|язык=en|место=Los Angeles, California|издание=Occupational Health and Safety|издательство=1105 Media Inc.|тип=журнал|месяц=11|число=19|}} ISSN 0362-4064&lt;/ref&gt;
&lt;ref name=&quot;Гаевая-1972&quot;&gt;{{Книга|автор=Гаевая Л.А.|заглавие=Средства индивидуальной защиты глаз и лица на производстве|год=1972|издание=Всесоюзный центральный научно-исследовательский институт охраны труда (ВЦНИИОТ)|место=Москва|издательство=ВЦНИИОТ ВЦСПС|страниц=124|серия=Справочник|тираж=5000}}&lt;/ref&gt;

&lt;ref name=&quot;Профилактика-глаза-2018&quot;&gt;{{Книга|ссылка=https://www.geotar.ru/lots/NF0008024.html|автор=Л.К. Мошетова, С.А. Кочергин, И.Б. Максимов, А.В. Степанов|заглавие=Офтальмология|ответственный=под ред. С.Э. Аветисова, Е.А. Егорова, Л.К. Мошетовой, В.В. Нероева, Х.П. Тахчиди|год=2018|часть=Профилактика (в:  Раздел III. Клинические рекомендации по заболеваниям и состояниям; Глава 36. Травмы глаза и его придаточного аппарата)|издание=2-е изд|место=Москва|издательство=ГЭОТАР-Медиа|страницы=866, 874|страниц=904|серия=Национальные руководства|isbn=978-5-9704-4449-8|тираж=3000}}&lt;/ref&gt;
&lt;ref name=&quot;Лазеры-рекоменд&quot;&gt;{{Книга|ссылка=https://meganorm.ru/mega_doc/norm/gost_gosudarstvennyj-standart/13/gost_EN_207-2021_mezhgosudarstvennyy_standart_sistema.html|автор=ООО &quot;МОНИТОРИНГ&quot;|заглавие=ГОСТ EN 207-2021. ССБТ Средства индивидуальной защиты глаз. очки для защиты от лазерного излучения. Общие технические требования. Методы испытаний|год=2022|часть=Приложение B. Рекомендации по применению очков для защиты от лазерного излучения|место=Москва|издательство=ФГУП &quot;Стандартинформ&quot;|страниц=29}}&lt;/ref&gt;
&lt;ref name=&quot;Лазеры-настройка-рекоменд&quot;&gt;{{Книга|ссылка=https://files.stroyinf.ru/Data2/1/4293767/4293767899.pdf?ysclid=m8lj9hx7fh388979709|автор=ФГУП «ВНИИМ им. Д.И. Менделеева»|заглавие=ГOCT EN 208-2014. ССБТ Средства защиты глаз при работе по настройке лазеров и лазерных систем. Общие технические требования, методы испытаний, маркировка|год=2015|часть=Приложение В (справочное). Рекомендации по применению очков для защиты от лазерного излучения при юстировке лазеров и лазерных устройств|место=Москва|издательство=ФГУП &quot;Стандартинформ&quot;|страницы=12-14|страниц=19}}&lt;/ref&gt;
&lt;ref name=&quot;Пальцев-1976&quot;&gt;{{Книга |ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1751551910&amp;archive=&amp;start_from=&amp;ucat=&amp; |автор=Пальцев Ю.Н., Кацуба В.А., Максимова Л.И., Солонников А.Н, Каюмов Х.М. |заглавие=Всесоюзная конференция &quot;Пути повышения качества и эффективности средств индивидуальной защиты и совершенствования методов их оценки&quot; |ответственный=Семёнов А.П., Городинский С.М., Романова И.Г., Цуцков М.Е., Гуда В.А., Леоничева В.Д. (редколлегия) |год=1976 |часть=Гигиенические требования к средствам индивидуальной защиты от лазерных излучений |издание=Всесоюзный центральный совет профсоюзов (ВЦСПС) |место=Москва |издательство=Государственный Комитет Совета Министров СССР по науке и технике |страницы=126-128 |страниц=179 |серия=Тезисы докладов, г. Тбилиси, 13-15 октября 1976 г. |тираж=700}}&lt;/ref&gt;
&lt;ref name=&quot;инспектор-2022-l&quot;&gt;Table III:6-1. Wavelengths of '''most common''' lasers. In: US OSHA. [https://www.osha.gov/otm/section-3-health-hazards/chapter-6 Laser Hazards]. OSHA Technical Manual (OTM) Section III: Chapter 6 ''(англ.).'' www.osha.gov. Occupational Safety and Health Administration (6 июля 2022)&lt;/ref&gt;
&lt;ref name=&quot;СИЗОС-1973-лазер&quot;&gt;{{Книга|автор=Азатьян А.Д.|заглавие=Пути совершенствования средств индивидуальной защиты работающих на производстве|ответственный=Цуцков М.Е., Городинский С.М., Смирнов В.Ф|год=1973|часть=Очки для защиты от лазерного излучения. Требования, перспективы развития и производства |место=Москва|издательство=ВЦНИИОТ ВЦСПС |страницы=165—170 |страниц=286|серия=материалы всесоюзного совещания|тираж=3000 |ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1731670155&amp;archive=&amp;start_from=&amp;ucat=&amp; }}&lt;/ref&gt;
}}
[[Категория:Средства индивидуальной защиты (обзорная лекция)]]</text>
      <sha1>mtan40h3om3yynfxfq919ca9oh82bvf</sha1>
    </revision>
  </page>
  <page>
    <title>Средства индивидуальной защиты (обзорная лекция)/СИЗ головы</title>
    <ns>0</ns>
    <id>35744</id>
    <revision>
      <id>270422</id>
      <parentid>268994</parentid>
      <timestamp>2026-10-27T07:05:52Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270422</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="53557" sha1="mdhivru39hzdgloz3vgchfes9f44kdt" xml:space="preserve">[[File:Mijnwerker 1947 02-00-1947 18935.jpg|thumb|right|300px|Шахтёр в каске]]
'''Средства индивидуальной защиты головы''' могут использоваться при опасности её механического травмирования, при повышенной или пониженной температуре воздуха, риске воздействия кислот, щелочей, расплавленного металла, поражения электрическим током, и опасном воздействии других производственных факторов&lt;ref name=&quot;МОТ-каски&quot; /&gt;.

В отношении защиты от ударов, существуют 4 вида СИЗ головы:
# Защитные каскетки, для защиты от ударов головой о неподвижные предметы.
# Каски защитные, предназначены для защиты от ударов только сверху.
# Высокоэффективные защитные каски, для защиты от ударов сверху, сбоку, сзади и спереди.
# Новые каски, уменьшающие самое опасное (угловое) ускорение головы при ударах. 

=== Научные исследования ===
Экспериментальное изучение последствий ударов по голове позволило сформулировать требования к способности касок ослаблять вертикальные удары падающих на голову предметов&lt;ref name=&quot;Громов-1976&quot; /&gt;.

Исследования [[:w:ru:Государственный Макеевский научно-исследовательский институт по безопасности работ в горной промышленности|МакНИИ]] показали, что при боковом ударе каски не обеспечивают требуемую защиту, и что для поглощения энергии сильных и боковых ударов желательно использовать дополнительную демпфирующую прокладку - помимо обычной подвески&lt;ref name=&quot;СИЗ-1973-5&quot; /&gt;. Для этого может использоваться, например, прокладка из наполненных воздухом &quot;пузырьков&quot;&lt;ref name=&quot;Каски+&quot; /&gt;, или пластиковых сотовых ячеек&lt;ref name=&quot;Каски++&quot; /&gt;.

В Южной Корее сравнивали смертность и тяжесть черепно-мозговых травм у рабочих, пострадавших при падениях в 2010—2012 гг., всего 1298 пациентов. Каски использовали 45 % (584 рабочих). Среди упавших без каски доля черепно-мозговых травм была заметно выше (8,7 % и 4,6 %). При учёте высоты падения, и высоте 4 м и выше, каски никакого эффекта не давали. Доля смертельных исходов существенно не отличалась (2,9 % без каски, 3,1 % в каске) при любой высоте падения. Среди не применявших каски доля прошедших обучение охране труда была вдвое меньше (35,2 и 73,5 %)&lt;ref name=&quot;Коррея-каски-2016&quot; /&gt;.
 
По данным&lt;ref name=&quot;новые-каски&quot; /&gt; риск сильного сотрясения мозга заметно возрастает в тех случаях, когда удар по каске не центральный (вызывающий лишь линейные ускорение), а такой, который вызывает одновременно и поворот. При ударах, вызывающих чисто линейное ускорение, травмирование часто происходит лишь тогда, когда удар настолько сильный, что происходит разрушение костей. Мозг, как вода, практически несжимаем, и при линейных ускорениях взаимного перемещения его частей друг относительно друга не происходит. В результате такое воздействие часто не приводит к серьёзным травмам. 

Если возникает и [[:w:ru:|угловое ускорение]], то ситуация резко изменяется. Вращательное движение головы стремиться увлечь за собой периферийные части головного мозга, а они, и центральная часть мозга, по инерции стремится остаться неподвижными. Части мозга стремятся сместиться и относительно неровной внутренней поверхности черепа, и друг относительно друга, что значительно увеличивает опасность. Стремление сместиться  создаёт касательные напряжения, которые создают риск разрывов тканей, нервов и сосудов, и соответственно опасность диффузного [[:w:ru:Аксон|аксонального]] повреждения центральной нервной системы&lt;ref name=&quot;Коновалов-2&quot; /&gt;. Обычная подвеска касок не уменьшает передачу вращательного движения на голову, что увеличивает риск&lt;ref name=&quot;вращ-гол-24&quot; /&gt;. Разработаны новые СИЗ головы: если удар стремиться вращать каску, подвеска позволяет ей повернутся относительно головы (в некоторой степени), что ослабляет передаваемые голове «вращающие» силы (подобно тому, как линейное смещение оболочки каски относительно подвески ослабляет прямой удар).

На всех [[:w:ru:Рабочее место|рабочих местах]] случаи травмирования падающими сверху предметами составляют не самую большую долю, чаще удары по голове происходят при падениях и спотыканиях, ударах головы о предметы, а также из-за дорожно-транспортных происшествий. В [[:w:ru:Имперский колледж Лондона|Имперском колледже]] смоделировали удары головы при спотыканиях, падениях вперёд и назад, более 1600 возможных случаев&lt;ref name=&quot;Каски-моделирование&quot; /&gt;. Результаты показали, что обычные каски (без защиты от боковых ударов) нередко неспособны не только смягчить удар, но даже не закрывают место удара на поверхности головы.

Последнее согласуется с результатами, полученными в Европейском Союзе: в строительной отрасли за период 2014-2018 гг. большинство травм головы было связано с падением работников, в том числе и при отсутствии перепада высоты (спотыкание о лежащие на полу кабели и т.п.). 49,1% случаев черепно-мозговых травм в Швеции (из 249) и 61,4% в ФРГ (из 11428) приводили к поверхностным ранам, т.е. удар приходился на не защищённую каской часть головы&lt;ref name=&quot;ЕС-стат-21&quot; /&gt;. 

Исследования показали, что летом, в солнечные дни, температура воздуха под каской может быть значительно выше температуры окружающего воздуха. Это ухудшает самочувствие работников, снижает производительность&lt;ref name=&quot;Каски-перегрев&quot; /&gt; и качество труда, повышает риск [[:w:ru:Тепловой удар|теплового удара]]. Систематичное использование касок может стать причиной головной боли у части работников&lt;ref name=&quot;Каски-Канада-боль&quot; /&gt;.
[[File:Mine helmet 2.jpg|thumb|right|300px|Такой амортизатор смягчает лишь удары сверху]]
=== Требования к СИЗ ===
Для использования работниками в США каски должны соответствовать требованиям&lt;ref name=&quot;Каски-США-&quot; /&gt;. Они включают в себя СИЗ с защитой от удара только сверху, и с защитой от ударов сверху и сбоку. По электроизолирующим свойствам различают не изолирующие СИЗ и два вида изолирующих, предназначенных для работы с электроустановками с низким и высоким напряжением. В Канаде в одном стандарте собраны и требования к СИЗ головы, и рекомендации по их выбору и применению&lt;ref name=&quot;Каски-Канада&quot; /&gt;, документ схож с американским&lt;ref name=&quot;Каски-США-&quot; /&gt;.

Последнее издание стандарта Австралии дополнено требованиями к шлемам &quot;тип 4&quot;, которые должны защищать и от ударов сбоку и сзади&lt;ref name=&quot;Каски-Австралия&quot; /&gt;.

Стандарт Европейского Союза 2012 г., и гармонизированный с ним ГОСТ РФ&lt;ref name=&quot;Каски-ЕС+РФ&quot; /&gt; предусматривает только защиту от ударов сверху. В ЕС также есть стандарты предусматривающие защиту от ударов сбоку (для работы на высоте&lt;ref name=&quot;Каски-ЕС-2&quot; /&gt;, и с улучшенной защитой&lt;ref name=&quot;Каски-ЕС-1&quot; /&gt;&lt;ref name=&quot;Каски-ГОСТ-2&quot; /&gt;). Но в последнем издании стандарта ЕС появился &quot;тип 2&quot;: каски, защищающие от слабых ударов спереди, сбоку и сзади&lt;ref name=&quot;Каски-ЕС-5&quot; /&gt;. Также опубликовано второе издание стандарта&lt;ref name=&quot;Каски-ЕС-э&quot; /&gt; с требованиями к каскам для электриков. Он предусматривает 4 вида касок, которые испытывают при разных напряжениях (от 2,5 до 40 кВ) и они могут использоваться при работе с оборудованием при напряжении, соответственно, от 0,5 до 17 кВ.

Поскольку не центральные удары, сопровождающиеся как линейным, так и вращательным движением, могут быть более опасны, в ЕС разработан стандарт для испытаний касок для оценки опасности при таких ударах&lt;ref name=&quot;Каски-ЕС-3&quot; /&gt;, исключительно схожий со стандартом&lt;ref name=&quot;Каски-US&quot; /&gt;.

ГОСТ&lt;ref name=&quot;Каски-ЕС+РФ&quot; /&gt; включает требование: каска должна ослаблять чисто вертикальный, центральный удар груза 5 кг, падающего с высоты 1 метр, до 5 000 ньютон (в США 3,6 кг; 1,52 м, 4450 Н&lt;ref name=&quot;Каски-США-&quot; /&gt;).

Таким образом ни в одной из стран до 2022 г. не было никаких требований к СИЗ головы, учитывающие их способность уменьшать передачу вращательного движения - хотя давно известно, что именно оно представляет значительную опасность во многих случаях. Требования к работодателю по выбору именно таких касок - отсутствуют. Поэтому, и из-за большей стоимости, новые модели используются нечасто.

В части требований к защите от ударов необходимо учесть, что у касок обычной конструкции (внешняя прочная оболочка и амортизатор внутри) есть ограничения. При ограниченном максимальном допустимом усилии, передаваемом голове во время удара, поглощаемая амортизатором энергия зависит от того, насколько он может деформироваться, то есть от расстояния от прочного корпуса до головы. Для поглощения сильных ударов его дистанцию необходимо увеличить. А при сильном возрастании каска становится такой громоздкой и неудобной, что ей не будут пользоваться вообще. Поэтому и изготовители, и разработчики требований к СИЗ идут на компромисс - но не предупреждают об этом потребителя в полной мере. Так, новые требования к каскам для мотоциклистов&lt;ref name=&quot;Каски-ООН&quot; /&gt; предусматривают увеличение скорости удара при испытании до 8,5 м/с. В то же время в городских условиях допускается движение со скоростью 60 км/ч (16,7 м/с). При такой скорости энергия удара будет в 3,8 раз больше, чем при сертификации - но покупателям заявляют, что лишь сертифицированные СИЗ &quot;обеспечивают адекватную защиту&quot;. Положительным свойством последней редакции стандарта стало испытание при ударах, приводящих голову во вращение.
[[File:Blue Grass Chemical Agent-Destruction Pilot Plant Control and Support Building (9969535664).jpg|thumb|right|300px|Каска с полями - на химическом предприятии]]
=== Требования и рекомендации по выбору и использованию ===
В Канаде в одном стандарте собраны и требования к СИЗ головы, и рекомендации по их выбору и применению&lt;ref name=&quot;Каски-Канада&quot; /&gt;. В случае, если риски разных ударов не оценивались совсем, при работе на стройках, и во всех остальных случаях (кроме тех, когда работодатель показал, что опасность боковых ударов незначительна) необходимо использовать каски с защитой от боковых ударов. СИЗ Опубликованы советы специалистов&lt;ref name=&quot;Каски-Канада-уч&quot; /&gt;.

В соответствии с Директивой ЕС&lt;ref name=&quot;Директива-ЕС-СИЗ&quot; /&gt;&lt;ref name=&quot;Каски-EU&quot; /&gt; все проблемы, связанные с оценкой риска, выбором соответствующего риску средства защиты головы, а также обеспечение совместимости с другими СИЗ (органов дыхания, слуха и т.п.) целиком возлагаются на работодателя. Каски должны приобретаться им за свой счёт и бесплатно выдаваться работникам. В Директиве в конце приведён перечень видов работ и областей деятельности, где могут требоваться разные СИЗ, включая СИЗ головы.

В США требования по охране труда в разных отраслях включают в себя использование СИЗ головы&lt;ref name=&quot;Каски-США&quot; /&gt;. Работодатели должны использовать лишь сертифицированные СИЗ. Также указано, что они должны выполнять требования стандарта [[:w:ru:Американский национальный институт стандартов|''ANSI'']], где есть некоторые советы по использованию этих СИЗ&lt;ref name=&quot;Каски-США-&quot; /&gt;.

Учтя статистические данные за 2020 г. Департамент условий и охраны труда (''[[:w:OSHA|OSHA]]'', 6% несчастных случаев без смертельного исхода из-за травм головы при ударах, падениях, спотыканиях и т.п.) пришёл к выводу о необходимости перехода от касок к шлемам во многих отраслях. Решение пока не воплотилось в требования закона, а является рекомендацией - вместе с программой действий по: оценке риска травм головы, выбора, применения и ухода за СИЗ головы. Новые шлемы изготавливают не из пластика, а [[:w:ru:Композитный материал#Полимерные композиционные материалы (ПКМ)|композиционных материалов]], они легче и лучше защищают от ударов, особенно боковых&lt;ref name=&quot;шлемы-2023&quot; /&gt;. С другой стороны, среди работающих в строительстве шлемы многим не нравятся, особенно опытным рабочим (внешний вид, неудобность)&lt;ref name=&quot;шлемы-2021&quot; /&gt;.

Правительство Гонконга требует, чтобы работодатели учитывали возможность боковых ударов при выборе касок, и чтобы на стройках использовали именно шлемы, обеспечивающие защиту и от таких ударов&lt;ref name=&quot;Каски-Гонк&quot; /&gt;.
 	
Значительное внимание к сбережению здоровья молодёжи школьного возраста побудило американских специалистов внести изменения в требования к СИЗ головы. Несмотря на отсутствие чётких и однозначных критериев опасности вращательного движения, отсутствие общего мнения специалистов о границе опасности углового ускорения - в стандарте&lt;ref name=&quot;Каски-2025&quot; /&gt;, как и в&lt;ref name=&quot;Каски-ООН&quot; /&gt; впервые в мире предусмотрено измерение углового ускорения при ударе, вызывающем вращение макета головы, и установлены требования к его ослаблению. 

=== Результаты применения ===
Со ссылкой на Бюро трудовой статистики (''BLS'') сообщали, что при использовании 6 млн. касок в 2019 г. зарегистрировано 18 тыс. черепно-мозговых травм&lt;ref name=&quot;новые-каски&quot; /&gt;, что по данным [[:w:OSHA|OSHA]] от ударов падающих предметов погибает порядка тысячи рабочих (и 6 из 7 погибших не использовали каски)&lt;ref name=&quot;Каски-не-используют&quot; /&gt;. Разработаны рекомендации для выбора касок для строителей&lt;ref name=&quot;Каски-выбор&quot; /&gt;.

В Великобритании менее чем за год зарегистрировано более 348 тыс. случаев оказания медицинской помощи работникам с черепно-мозговыми травмами; но опросы показывают, что примерно в половине случаев рабочие не сообщают о ударах по голове руководителям, и возможно, проблема гораздо серьёзнее, чем это показывает статистика&lt;ref name=&quot;Каски-моделирование&quot; /&gt;.

[[File:F1 fireman helmet.jpg|thumb|right|300px|СИЗ головы пожарника, с выдвижным экраном для защиты глаз]]
=== Канадский опыт ===
Значительный рост регистрируемого травматизма головы работников&lt;ref name=&quot;Каски-Канада-травмы-2&quot; /&gt; (порядка 3,7-8 раз)&lt;ref name=&quot;Каски-Канада-травмы&quot; /&gt; побудил ассоциацию крупных строительных компаний добровольно и по собственной инициативе начать переход от касок к шлемам (защищающим и от боковых ударов). Аналогично, последняя редакция 2024 г. стандарта с требованиями к выбору СИЗ головы&lt;ref name=&quot;Каски-Канада&quot; /&gt; обязывает использовать каски с защитой от боковых ударов (кроме случаев, когда работодатель покажет незначительность этой опасности). Однако канадские законодатели, в тех же самых условиях, изменили требования иначе - разрешив вообще не применять СИЗ головы в условиях, когда риск низкий&lt;ref name=&quot;Каски-Канада-поправки&quot; /&gt;. Причины такого парадоксального изменения две: работники из Индии, сикхи, не хотят отказываться от религиозного головного убора (тюрбана), что мешает их найму на стройки и т.п.; а специалистом известно, что каски - самый ненадёжный вид защиты головы от травм. В рекомендациях по профилактике травм головы отмечается, что значительная их доля происходит из-за падений споткнувшихся работников при отсутствии перепада высоты. Соответственно, рекомендуется обратить внимание на используемую обувь, на лежащие на полу провода и т.п., и лишь после этого (пункт № 7&lt;ref name=&quot;Каски-Канада-советы&quot; /&gt;) советуют использовать каски.

Т.е. для снижения риска травм стараются в первую очередь уменьшить саму опасность, и лишь когда это сложно сделать - используют хотя и ненадёжные, но улучшенные СИЗ головы.

== Примечания ==
{{примечания|refs=

&lt;ref name=&quot;МОТ-каски&quot;&gt;{{Книга|ссылка=http://base.safework.ru/iloenc|ответственный =[https://miningwiki.ru/wiki/Ассоциация_СИЗ#Кадры Ю.Г. Сорокин] &lt;small&gt;(''руководитель Департамента условий и охраны труда, Минтруд РФ'')&lt;/small&gt;; Жан-Виктор Груа &lt;small&gt;(''Директор Московского бюро МОТ'')&lt;/small&gt;|заглавие=Энциклопедия по безопасности и охране труда|год=2001|часть=[http://base.safework.ru/iloenc?d&amp;nd=857400343&amp;prevDoc=857400343&amp;spack=110LogLength%3D0%26LogNumDoc%3D857400038%26listid%3D010000000100%26listpos%3D3%26lsz%3D7%26nd%3D857400038%26nh%3D1%26 Средства защиты головы]. В: Том 1; Раздел [http://base.safework.ru/iloenc?d&amp;nd=857400005&amp;prevDoc=857000002 IV], Глава [http://base.safework.ru/iloenc?d&amp;nd=857400038&amp;prevDoc=857400346 31. Средства индивидуальной защиты] |автор=Изабель Балти и Ален Майер |ссылка часть=|издание=4-е изд|место=Москва|издательство=Международная организация труда; Министерство труда и социального развития РФ|страницы= |страниц=1278|серия= Охрана труда}}&lt;/ref&gt;
&lt;ref name=&quot;Громов-1976&quot;&gt;{{Книга |ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1751551910&amp;archive=&amp;start_from=&amp;ucat=&amp; |автор=Громов А.П., Пырлина Н.П., Потапов В.И., Карцев А.Н., Салтыкова О.Ф., Корсаков С.А., Живодеров Н.Н., Дербоглав В.В., Проценков М.Г., Ковалевская Р.А. |заглавие=Всесоюзная конференция &quot;Пути повышения качества и эффективности средств индивидуальной защиты и совершенствования методов их оценки&quot; |ответственный=Семёнов А.П., Городинский С.М., Романова И.Г., Цуцков М.Е., Гуда В.А., Леоничева В.Д. (редколлегия) |год=1976 |часть=Биомеханическое обоснование требований к защитной каске |издание=Всесоюзный центральный совет профсоюзов (ВЦСПС) |место=Москва |издательство=Государственный Комитет Совета Министров СССР по науке и технике |страницы=116-119 |страниц=179 |серия=Тезисы докладов, г. Тбилиси, 13-15 октября 1976 г. |тираж=700}}&lt;/ref&gt;
&lt;ref name=&quot;СИЗ-1973-5&quot;&gt;{{Книга|автор=Трубников Е.Г. |заглавие=Пути совершенствования средств индивидуальной защиты работающих на производстве |ответственный=Цуцков М.Е., Городинский С.М., Смирнов В.Ф|год=1973|часть=Разработка и совершенствование средств защиты головы (каски)|место=Москва|издательство=ВЦНИИОТ ВЦСПС |страницы=56-59|страниц=286|серия=материалы всесоюзного совещания|тираж=3000 |ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1731670742&amp;archive=&amp;start_from=&amp;ucat=&amp;}}&lt;/ref&gt;
&lt;ref name=&quot;Коррея-каски-2016&quot;&gt;{{Статья|ссылка=https://www.researchgate.net/publication/309601350_Preventive_Effects_of_Safety_Helmets_on_Traumatic_Brain_Injury_after_Work-Related_Falls|автор=Sang Chul Kim, Young Sun Ro, Sang Do Shin, Joo Yeong Kim|заглавие=Preventive Effects of Safety Helmets on Traumatic Brain Injury after Work-Related Falls|год=2016|язык=en|место=Basel, Switzerland|издание=International Journal of Environmental Research and Public Health|издательство=MDPI (Multidisciplinary Digital Publishing Institute)|выпуск=12|pages=1063|volume=13|issn=|doi=10.3390/ijerph13111063|pmid=|pmc=}} ISSN 1661-7827, {{PMID|27801877}}, PMC PMC5129273.&lt;/ref&gt;
&lt;ref name=&quot;новые-каски&quot;&gt;''EHS Daily Advisor''. [https://ehsdailyadvisor.blr.com/resource/is-your-safety-helmet-protecting-against-dangerous-rotational-forces-2/ Is Your Safety Helmet Protecting Against Dangerous Rotational Forces?] &lt;small&gt;(англ.)&lt;/small&gt;. ''ehsdailyadvisor.blr.com.'' Brentwood, TN: Business &amp; Legal Resources (BLR) LLC. Дата обращения: 15 ноября 2024.&lt;/ref&gt;

&lt;ref name=&quot;Коновалов-2&quot;&gt;{{Книга|ссылка=https://vk.com/doc37102412_430448681?hash=9Z3yOg0sU44IJP6oGLfGFYblGy2rix0D9Un25z6diks&amp;api=1&amp;no_preview=1|автор=Потапов А.А., Лихтерман Л.Б., Касумова С.Ю., Чабулов А., Гайтур Э.И.|заглавие=Клиническое руководство по черепно-мозговой травме.|ответственный=Коновалов А.Н., Лихтерман Л.Б., Потапов А.А. ред.|год=2001|часть=Глава 20. Диффузные аксональные повреждения головного мозга|место=Москва|издательство=ИД «Энциклопедия интернешнл», «Антидор»|том=II. Острый период черепно-мозговой травмы: хирургия, анестезия, интенсивная терапия, клинические формы|страницы=426-428|страниц=675|isbn=5-900833-13-5}}&lt;/ref&gt;
	

&lt;!-- Комментарий --&gt; {{Cite web|url=https://ehsdailyadvisor.blr.com/resource/is-your-safety-helmet-protecting-against-dangerous-rotational-forces-2/|title=Is Your Safety Helmet Protecting Against Dangerous Rotational Forces?|lang=en|author=EHS Daily Advisor|website=ehsdailyadvisor.blr.com|location=Brentwood, TN|publisher=Business &amp; Legal Resources (BLR) LLC|access-date=2024-11-15}}
&lt;ref name=&quot;шлемы-2023&quot;&gt;{{Книга|ссылка=https://www.osha.gov/sites/default/files/publications/safety_helmet_shib.pdf|автор=US Occupational Safety and Health Administration|заглавие=Head Protection: Safety Helmets in the Workplace|год=2023|язык=en|издательство=U.S. Department of Labor|allpages=5|серия=Safety and Health Information Bulletin  SHIB 3-6-2024}}&lt;/ref&gt;
&lt;ref name=&quot;шлемы-2021&quot;&gt;{{Статья|ссылка=https://digitalcommons.calpoly.edu/cgi/viewcontent.cgi?article=1542&amp;context=cmsp|автор=Matthew R. Langbehn|заглавие=Workers Head Protection Preferences in Construction|год=2021|язык=en|автор издания=DigitalCommons@CalPoly|место=California, US|издание=Construction Management|издательство=California Polytechnic State University|pages=11}}&lt;/ref&gt;
&lt;ref name=&quot;вращ-гол-24&quot;&gt;{{Статья|ссылка=https://www.researchgate.net/publication/263935897_Why_Most_Traumatic_Brain_Injuries_are_Not_Caused_by_Linear_Acceleration_but_Skull_Fractures_are|автор=Svein Kleiven|заглавие=Why Most Traumatic Brain Injuries are Not Caused by Linear Acceleration but Skull Fractures are|год=2013|язык=en|издание=Frontiers in Bioengineering and Biotechnology|месяц=11|число=7|выпуск=15|pages=1-5|volume=1|issn=|doi=10.3389/fbioe.2013.00015|pmid=|pmc=}} ISSN 2296-4185, {{PMID|25022321}}, PMC PMC4090913.&lt;/ref&gt;
&lt;ref name=&quot;Каски+&quot;&gt;{{Статья|ссылка=https://pmc.ncbi.nlm.nih.gov/articles/PMC8006905/|автор=John Z. Wu, Christopher S. Pan, Mahmood Ronaghi, Bryan M. Wimer, Uwe Reischl|заглавие=Application of polyethylene air-bubble cushions to improve the shock absorption performance of Type I construction helmets for repeated impacts|год=2021|язык=en|место=New York|издание=Bio-medical materials and engineering|издательство=Pergamon Press|месяц=1|выпуск=1|pages=1-14|volume=32|issn=|doi=10.3233/BME-201132|pmid=|pmc=}} ISSN 0959-2989, {{PMID|33252060}}, PMC PMC8006905.&lt;/ref&gt;
&lt;ref name=&quot;Каски-не-используют&quot;&gt;{{Статья|ссылка=https://ohsonline.com/Articles/2021/06/01/Watch-for-Falling-Objects-PPE-to-Protect-You-on-the-Job-Site.aspx?Page=2|автор=David Ivey|заглавие=Watch for Falling Objects: PPE to Protect You on the Jobsite|год=2021|язык=en|место=Los Angeles, California|издание=Occupational Health and Safety|издательство=1105 Media Inc.|тип=журнал|месяц=6|число=1|issn=}} ISSN 0362-4064&lt;/ref&gt;
&lt;ref name=&quot;Каски-выбор&quot;&gt;{{Книга|ссылка=https://www.cpwr.com/wp-content/uploads/FS-Selecting_Head_Protection.pdf|автор=The Center for Construction Research and Training|заглавие=Selecting Head Protection for Construction Work|год=2024|язык=en|издание=2nd ed|allpages=10}}&lt;/ref&gt;
&lt;!-- Комментарий --&gt;  &quot;Каски++&quot;&gt;{{Cite web|url=https://www.wbur.org/npr/1121903266/how-a-new-hard-hat-technology-can-protect-workers-better-from-concussion|title=How a new hard hat technology can protect workers better from concussion|lang=en|author=Jon Hamilton|website=WBUR  wbur.org|subtitle=NPR News|date=2022-09-09|location=Boston, MA}}
&lt;ref name=&quot;Каски++&quot;&gt;''Jon Hamilton.'' [https://www.wbur.org/npr/1121903266/how-a-new-hard-hat-technology-can-protect-workers-better-from-concussion How a new hard hat technology can protect workers better from concussion]. NPR News &lt;small&gt;(англ.)&lt;/small&gt;. ''WBUR wbur.org'' Boston, MA. (9 сентября 2022). &lt;/ref&gt;

&lt;ref name=&quot;Каски-моделирование&quot;&gt;{{Статья|ссылка=https://www.researchgate.net/publication/368306335_Head_Impact_Location_Speed_and_Angle_from_Falls_and_Trips_in_the_Workplace|автор=Xiancheng Yu, Claire E. Baker &amp; Mazdak Ghajari.|заглавие=Head Impact Location, Speed and Angle from Falls and Trips in the Workplace|год=2024|язык=en|автор издания=Biomedical Engineering Society.|издание=Annals of Biomedical Engineering|издательство=Springer Nature|месяц=10|выпуск=6|pages=687–2702|volume=52|issn=|doi=10.1007/s10439-023-03146-9|pmid=|pmc=}} ISSN 0090-6964, {{PMID|36745294}}, PMC PMC11402836.&lt;/ref&gt;
&lt;ref name=&quot;Каски-Канада&quot;&gt;{{Книга|автор=CSA.|заглавие=CSA Z94.1-15 (R2024) Industrial protective headwear - Performance, selection, care, and use|часть=5. Selection, care, and use of headwear|pages=13-19|год=2015|язык=en|издание=6th ed|место=Toronto, Ontario, Canada|издательство=Canadian Standards Association|allpages=56|серия=ICS Codes 13.340.20 Head protective equipment}}&lt;/ref&gt;
&lt;ref name=&quot;Каски-ЕС+РФ&quot;&gt;{{Книга|ссылка=https://meganorm.ru/Index/80/80718.htm |автор=Частное учреждение Федерации независимых профсоюзов &quot;НИИОТ&quot;|заглавие=ГОСТ EN 397-2020 ССБТ. Средства индивидуальной защиты головы. Каски защитные. Общие технические требования. Методы испытаний|год=2020|место=Москва|издательство=Стандартингформ|страниц=25|серия=[http://db.csstgc.com.cn/userfiles/4b146a65dc7d43558bc74a1d018e8d5d/files/teckSolution/2024/08/BS%20EN%20397-2012%206_6%206_7.pdf EN 397:2012+A1:2012]|тираж=1}} [https://meganorm.ru/Data/807/80718.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;Каски-ЕС-5&quot;&gt;{{Книга |ссылка=https://standards.iteh.ai/catalog/standards/cen/c02ba288-d5ac-4324-a8dc-8d977de65b0c/en-397-2025-ac-2025 |автор=Technical Committee CEN/TC 158 “Head protection’ |заглавие=EN 397:2025 Industrial protective helmets |год=2025 |язык=en |издание=5th ed |место=Brussels |издательство=European Committee for Standardization |allpages=55 |серия=ICS 13.340.20}}&lt;/ref&gt;

&lt;ref name=&quot;Каски-ЕС-э&quot;&gt;{{Книга |ссылка=https://standards.iteh.ai/catalog/standards/clc/0b050787-38c5-4d96-a2de-5132f2868f09/en-50365-2023?srsltid=AfmBOoqb_B9-iF0mV4rD8HFua5PVFvy5etMwwJxMJmtCk9B7GzQ_7U5E |автор=CLC/TC 78 “Equipment and tools for live working“ |заглавие=EN 50365:2023 Live Working - Electrically insulating helmets for use on low and medium voltage installations |год=2023 |язык=en |издание=2nd ed |место=Brussels |издательство=European Committee for Standardization |allpages=24 |серия=ICS 13.260 Protection against electric shock. Live working, 13.340.20 Head protective equipment}}&lt;/ref&gt;
&lt;ref name=&quot;Каски-ООН&quot;&gt;{{Книга |ссылка=https://unece.org/transport/documents/2021/08/standards/un-regulation-no-22-rev5-06-series |автор=The United Nations Economic Commission for Europe (UNECE) |заглавие=Правила No 22 ООН. Единообразные предписания, касающиеся официального утверждения защитных шлемов и их смотровых козырьков для водителей и пассажиров мотоциклов и мопедов |ответственный=Организация Объединённых Наций |год=2021 |издание=6 изд |издательство=OON |страницы=https://unece.org/sites/default/files/2025-05/R022r5r.pdf |всего страниц=135 |серия=E/ECE/324/Rev.1/Add.21/Rev.5, E/ECE/TRANS/505/Rev.1/Add.21/Rev.5}}&lt;/ref&gt;

&lt;ref name=&quot;Каски-ЕС-1&quot;&gt;{{Книга|ссылка=https://standards.iteh.ai/catalog/standards/cen/f78a2d6e-3c4a-420d-9581-bfbafe948f48/en-14052-2012a1-2012 |автор= WG 1 &quot;Industrial safety helmets&quot; in: Technical Committee CEN/TC 158 &quot;Head protection&quot;|заглавие=EN 14052:2012 High performance industrial helmets|год=2012|язык=en|место=Brussels|издательство=European Committee for Standardization|серия=ICS 13.340.20 Head protective equipment|allpages=25}} &lt;/ref&gt;
&lt;ref name=&quot;Каски-ЕС-2&quot;&gt;{{Книга|ссылка=https://standards.iteh.ai/catalog/standards/cen/1d77e417-72d1-4c8a-9735-c579e710f673/en-12492-2012?srsltid=AfmBOopiZWfeCyWaHS3qEsjjZ9Pt47GXnxc4Pxz5O6x7RLqkiXGF2BVV|автор=Technical Committee CEN/TC 158 &quot;Head protection&quot;|заглавие=EN 12492:2012 Mountaineering equipment - Helmets for mountaineers - Safety requirements and test methods|год=2012|язык=en|место=Brussels|издательство=European Committee for Standardization|серия=ICS 13.340.20 ; 97.220.4|allpages=25}} &lt;/ref&gt;
&lt;ref name=&quot;Каски-ЕС-3&quot;&gt;{{Книга|ссылка= https://standards.iteh.ai/catalog/standards/cen/0fceba9b-d0eb-4001-a71e-af8ef63cc4f7/en-17950-2024 |автор= WG 11 &quot;Headforms and test methods&quot; in: Technical Committee CEN/TC 158 &quot;Head protection&quot;|заглавие=EN 17950:2024 Protective helmets - Test methods - Shock absorption including measuring rotational kinematics|год=2024|язык=en|место=Brussels|издательство=European Committee for Standardization|серия=ICS 13.340.20 Head protective equipment|allpages=17}} &lt;/ref&gt;
&lt;ref name=&quot;Каски-US&quot;&gt;{{Книга |автор=[[:w:ASTM International|Subcommittee F08.53 in ASTM International]] |заглавие=ASTM F3555-22. Standard Test Method for Measuring Impact Attenuation Characteristics of Helmets Under Induced Rotational Loading Using an Inclined Anvil |год=2022 |язык=en |место=West Conshohocken, Pennsylvania |издательство=American Society for Testing and Materials |allpages=7 |серия=ICS Code: 13.340.20 |doi=10.1520/F3555-22}}&lt;/ref&gt;
&lt;ref name=&quot;Каски-ГОСТ-2&quot;&gt;{{Книга|ссылка=https://meganorm.ru/Index2/1/4293762/4293762915.htm |автор=Рабочая группа подкомитета ПК 7|заглавие=ГОСТ EN 14052-2015 ССБТ. Высокоэффективные защитные каски. Общие технические требования. Методы испытаний|ответственный=Технический комитет ТК 320 СИЗ|год=2016|место=Москва|издательство=Стандартинформ|страниц=20|тираж=37}} [https://meganorm.ru/Data2/1/4293762/4293762915.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;Каски-Австралия&quot;&gt;{{Книга|ссылка=https://www.standards.govt.nz/shop/asnzs-18012024|автор=Joint Technical Committee SF-018 &quot;Occupational Protective Helmets&quot;|заглавие=AS/NZS 1801:2024 Occupational Protective Helmets|год=2024|язык=en|издание=4th ed|место=Sydney|издательство=Standards Australia Limited &amp; Standards New Zealand|allpages=42|серия=ICS 13.340.20 Head protective equipment|isbn=978-1-77972-549-3}}&lt;/ref&gt;
&lt;ref name=&quot;Директива-ЕС-СИЗ&quot;&gt;{{Статья|ссылка=https://eur-lex.europa.eu/legal-content/en/TXT/?uri=CELEX:31989L0656|автор=The Council President J. P. Soisson|заглавие=COUNCIL DIRECTIVE of 30 November 1989 on the minimum health and safety requirements for the use by workers of personal protective equipment at the workplace (third individual directive within the meaning of Article 16 ( 1 ) of Directive 89/ 391 /EEC)|год=1989|ответственный=The Council of the European Communities|язык=en|автор издания=European Union|издание=Official Journal of the European Communities  -  Legislation|тип=official journal|месяц=12|число=12|выпуск=No L 393|pages=18-28}}&lt;/ref&gt;
&lt;ref name=&quot;Каски-EU&quot;&gt;{{Cite web|url=https://oshwiki.osha.europa.eu/en/themes/protective-helmets-requirements-and-selection|title=Protective helmets – requirements and selection|lang=en|last=Marcin Jachowicz, Karla Van den Broek.|website=oshwiki.osha.europa.eu|publisher=European Agency for Safety and Health at Work}} (Prevention and control strategies - Personal Protective Equipment). (26 августа 2020). Дата обращения: 6 декабря 2024&lt;/ref&gt;
&lt;ref name=&quot;Каски-Канада-уч&quot;&gt;{{Книга|ссылка=https://www.lu530.com/wp-content/uploads/2015/05/M029_S4.pdf |автор=IHSA|заглавие=Construction Health and Safety Manual|год=2010|часть=Chapter 12. [https://www.ihsa.ca/rtf/health_safety_manual/pdfs/equipment/Head_Protection.pdf Head protection]|язык=en|издание=2nd ed|место=Mississauga, Ontario|издательство=Infrastructure Health &amp; Safety Association|pages=12-1 - 12-2|isbn=978-0-919465-54-1}} [https://www.ihsa.ca/Resources/Health_Safety_Manual.aspx Head protection]&lt;/ref&gt;
&lt;ref name=&quot;Каски-2025&quot;&gt;{{Книга |автор=[[:w:en:National Operating Committee on Standards for Athletic Equipment|National Operating Committee on Standards for Athletic Equipment]] |ссылка= https://nocsae.org/nd006-standard-performance-specification-for-newly-manufactured-youth-football-helmets/ |заглавие=NOCSAE DOC (ND) 006 – 23m25a. Standard Performance Specification for Newly Manufactured Youth Football Helmets |год=2025 |часть=7. Test Requirements |язык=en |место=Overland Park, Kansas |издательство=NOCSAE |pages=6 |allpages=12}}&lt;/ref&gt;
&lt;ref name=&quot;ЕС-стат-21&quot;&gt;{{Статья|ссылка=https://www.researchgate.net/publication/348617629_Work-related_traumatic_brain_injury_in_the_construction_industry_in_Sweden_and_Germany?_tp=eyJjb250ZXh0Ijp7ImZpcnN0UGFnZSI6InB1YmxpY2F0aW9uIiwicGFnZSI6InNlYXJjaCIsInBvc2l0aW9uIjoicGFnZUhlYWRlciJ9fQ|автор=Karin Brolin, Daniel Lanner, Peter Halldin|заглавие=Work-related traumatic brain injury in the construction industry in Sweden and Germany|год=2021|язык=en|издание=Safety Science|издательство=Elsevier B.V.|месяц=4|выпуск=4|pages=105147|volume=136|issn=|doi=10.1016/j.ssci.2020.105147}} ISSN 0925-7535&lt;/ref&gt;
&lt;ref name=&quot;Каски-США&quot;&gt;{{Книга|ссылка=https://www.ecfr.gov/current/title-29/subtitle-B/chapter-XVII/part-1910|заглавие=Occupational Safety and Health Standards|год=2012|часть=[https://www.osha.gov/laws-regs/regulations/standardnumber/1910/1910.135 1910.135 - Head protection]|язык=en|место=Washington, DC|издательство=Occupational Safety and Health Administration|volume=1910 Subpart I - Personal Protective Equipment}}&lt;/ref&gt;
&lt;ref name=&quot;Каски-США-&quot;&gt; ''Brad Kelechava''. [https://blog.ansi.org/ansi-isea-z89-1-industrial-head-protection/ ANSI Z89.1 – Industrial Head Protection] &lt;small&gt;(англ.)&lt;/small&gt;. ''blog.ansi.org.'' American National Standards Institute (29 июня 2016). Дата обращения: 3 декабря 2024.&lt;/ref&gt;
&lt;ref name=&quot;Каски-Гонк&quot;&gt;{{Книга|ссылка=https://www.labour.gov.hk/eng/public/content2_8c.htm|автор=The Government of the Hong Kong Special Administrative Region of the PRC - Occupational Safety and Health Branch|заглавие=Guidance Notes on the Selection, Use and Maintenance of Safety Helmets|год=2018|часть=6.1 Factors in Selection. In: 6. Selection of Safety Helmets  -|язык=en|место=Hong Kong|издательство=Occupational Safety and Health Branch, Labour Department|pages=11|allpages=29|серия=Occupational Safety &gt; Part C : Guidance Notes}} [https://www.labour.gov.hk/eng/public/os/C/GN_on_helmet_eng.pdf PDF]&lt;/ref&gt;

&lt;!-- Комментарий --&gt;  {{Cite web|url=https://blog.ansi.org/ansi-isea-z89-1-industrial-head-protection/|title=ANSI Z89.1 – Industrial Head Protection|lang=en|author=Brad Kelechava|website=blog.ansi.org|date=2016-06-29|publisher=American National Standards Institute|access-date=2024-12-03}}
&lt;!-- Комментарий --&gt;   -Канада-травмы&quot;&gt; {{Cite web|url=https://www.thesafetymag.com/ca/topics/safety-and-ppe/3-things-to-know-about-head-protection/405677|title=3 Things to know about head protection|lang=en|author=Maia Foulis|website=Canadian Occupational Safety  thesafetymag.com|description=Topics -  Safety and PPE|date=2022-05-01|location=Toronto, Ontario|publisher=KM Business Information Canada Ltd.|access-date=2024-12-17}}&lt;/ref&gt;
&lt;ref name=&quot;Каски-Канада-травмы&quot;&gt;{{Cite web|url=https://www.thesafetymag.com/ca/topics/safety-and-ppe/3-things-to-know-about-head-protection/405677|title=3 Things to know about head protection|lang=en|last=Maia Foulis|website=Canadian Occupational Safety  thesafetymag.com|description=Topics -  Safety and PPE|year=2022-05-01|location=Toronto, Ontario|publisher=KM Business Information Canada Ltd.|access-date=2024-12-17}}&lt;/ref&gt;
&lt;ref name=&quot;Каски-Канада-травмы-2&quot;&gt;{{Статья|ссылка=https://injuryprevention.bmj.com/content/24/Suppl_2/A182.2|автор=Fahra Rajabali, Belinda Gabbe, Shelina Babul, Ian Pike.|заглавие=PW 1803 The costs of head injury in british columbia, canada|год=2018|язык=en|автор издания=Society for Advancement of Violence and Injury Research (SAVIR)|издание=Injury Prevention|издательство=BMJ Publishing Group Ltd.|месяц=11|выпуск=Suppl 2|pages=A182|volume=24|issn=}} ISSN 1353-8047&lt;/ref&gt;
&lt;ref name=&quot;Каски-перегрев&quot;&gt;{{Книга|автор=Дементьева Л. Н., Брунштейн И. П., Малошенко А. Л., Мужипов Р. Н.|заглавие=Гигиена труда в промышленном строительстве|ссылка=https://library.by/portalus/modules/medecine/readme.php?subaction=showfull&amp;id=1752142867&amp;archive=&amp;start_from=&amp;ucat=&amp;|ответственный=Каспаров А.А. и Серебряный Л.А. ред|год=1987|часть=Гигиеническая оценка защитной каски строителя в условиях жаркого климата|издание=выпуск 32|место=Москва|издательство=НИИ гигиены труда и профессиональных заболеваний АМН СССР|страницы=125-133|страниц=143|серия=Сборник научных трудов}}&lt;/ref&gt;
&lt;!-- Комментарий --&gt;   -Канада-боль&quot;&gt; {{Cite web|url=https://www.thesafetymag.com/ca/topics/safety-and-ppe/hard-hats-and-headaches-a-real-pain/183809|title=Hard hats and headaches: A real pain?|lang=en|author=Stefan Dubowski|website=Canadian Occupational Safety  thesafetymag.com|description=Topics -  Safety and PPE|date=2015-01-07|location=Toronto, Ontario|publisher=KM Business Information Canada Ltd.|access-date=2024-12-17}}&lt;/ref&gt;
&lt;ref name=&quot;Каски-Канада-боль&quot;&gt; {{Cite web|url=https://www.thesafetymag.com/ca/topics/safety-and-ppe/hard-hats-and-headaches-a-real-pain/183809|title=Hard hats and headaches: A real pain?|lang=en|last=Stefan Dubowski|website=Canadian Occupational Safety  thesafetymag.com|description=Topics -  Safety and PPE|year=2015-01-07|location=Toronto, Ontario|publisher=KM Business Information Canada Ltd.|access-date=2024-12-17}}&lt;/ref&gt;
&lt;!-- Комментарий --&gt;  &quot;Каски-Канада-поправки&quot;&gt;{{Cite web|url=https://www.worksafebc.com/en/resources/law-policy/discussion-papers/bod-approves-2020-amendments-ohsr-apr21/part-8-safety-headgear|title=Board of Directors approves the 2020 amendments to the Occupational Health and Safety Regulation|lang=en|website=WorkSafeBC worksafebc.com|subtitle=Part 8 – Safety headgear|date=2021|location=Vancouver, British Columbia|access-date=2024-12-17}}&lt;/ref&gt;
&lt;ref name=&quot;Каски-Канада-поправки&quot;&gt;{{Cite web|url=https://www.worksafebc.com/en/resources/law-policy/discussion-papers/bod-approves-2020-amendments-ohsr-apr21/part-8-safety-headgear|title=Board of Directors approves the 2020 amendments to the Occupational Health and Safety Regulation|lang=en|website=WorkSafeBC worksafebc.com|subtitle=Part 8 – Safety headgear|year=2021|location=Vancouver, British Columbia|access-date=2024-12-17}}&lt;/ref&gt;
&lt;ref name=&quot;Каски-Канада-советы&quot;&gt;{{Cite web|url=https://www.canadianmetalworking.com/canadianmetalworking/blog/healthsafety/get-a-head-start-on-preventing-workplace-concussions|title=Get a head start on preventing workplace concussions|lang=en|last=Canadian Centre for Occupational Health and Safety.|website=Canadian Metalworking (блог журнала) canadianmetalworking.com|subtitle=Start by identifying and removing hazards that can lead to a head injury|location=Canada|publisher=FMA Communications Canada, Inc}} (29 мая 2024). Дата обращения: 18 декабря 2024.&lt;/ref&gt;
&lt;!-- Комментарий --&gt; name=&quot;Каски-Канада-советы&quot;&gt;{{Cite web|url= https://www.canadianmetalworking.com/canadianmetalworking/blog/healthsafety/get-a-head-start-on-preventing-workplace-concussions |title=Get a head start on preventing workplace concussions|lang=en|author=Canadian Centre for Occupational Health and Safety|website=Canadian Metalworking (блог журнала) canadianmetalworking.com|subtitle=Start by identifying and removing hazards that can lead to a head injury|location=Canada|publisher=FMA Communications Canada, Inc.|access-date=2024-12-18|year=2024}}&lt;/ref&gt;
}}

[[Категория:Средства индивидуальной защиты (обзорная лекция)]]
{{Stub}}</text>
      <sha1>mdhivru39hzdgloz3vgchfes9f44kdt</sha1>
    </revision>
  </page>
  <page>
    <title>Средства индивидуальной защиты (обзорная лекция)/СИЗ кожи от химических веществ</title>
    <ns>0</ns>
    <id>35745</id>
    <revision>
      <id>270423</id>
      <parentid>269661</parentid>
      <timestamp>2026-10-27T07:06:12Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270423</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="31909" sha1="80q7tqleyk0kbr0j9bogvg0ghxcl716" xml:space="preserve">[[File:СИЗ-кожи-2.jpg|thumb|right|310px|Примеры СИЗ кожи]]
Для защиты организма от воздействия токсичных веществ через кожу используют защитную одежду, перчатки и специальную обувь, к которым предъявляются определённые требования, и их выполнение проверяется при сертификационных испытаниях. 

В целом, СИЗ кожи могут изготавливаться для одноразового или многократного применения.

== Научные исследования ==
=== Степень и продолжительность защиты ===
Отличие условий, в которых проводятся испытания перчаток для защиты от химикатов, от условий их реального применения, может привести к недооценке опасности, и переоценке защитных свойств этих СИЗ&lt;ref name=&quot;КЗ-кожи-&quot; /&gt;. По данным&lt;ref name=&quot;КЗ-кожи&quot; /&gt; использование результатов европейских сертификационных испытаний для прогнозирования защиты работников даёт чрезмерно оптимистичный результат, не соответствующий реальности даже при своевременном применении СИЗ. Например, определение проникания токсичных веществ через материал проводится в статических условиях, а на [[:w:ru:Рабочее место|рабочих местах]] люди двигаются, материал СИЗ изгибается, и его защитные свойства ухудшаются — что не учитывает методика тестирования. Температура перчаток близка к температуре тела, а испытания проводят при комнатной температуре, из-за отличия проницаемость может отличаться вдвое. Испытания проводят при воздействии токсичных веществ однократно, а на [[:w:ru:Рабочее место|рабочих местах]] эти СИЗ часто используют много раз. Поэтому может происходить постепенная «миграция» молекул химикатов, проникших при первом применении в наружный слой полимеров. В статье показано, что степень проникания вредного вещества через материал СИЗ и доза воздействия этого вещества на организм могут значительно отличаться. В целом, авторы предложили оценивать эффект от использования СИЗ на основе замеров у работников; и с учётом качества программ их использования (включающих выбор, организацию применения, обучение работников и т. п.). При отсутствии задокументированных программ предложено считать уровень защиты нулевым, при наличии — наименьшие коэффициенты защиты (например, для перчаток КЗ = 6).

=== Возможный перегрев организма ===
При повышенной температуре воздуха на рабочем месте, интенсивном тепловом излучении, выполнении тяжёлой физической физической работы (или сочетании этих и других факторов) ухудшение теплоотдачи может привести к перегреву организма работника, опасному для его жизни и здоровья. При носке обычной повседневной одежды в атмосфере с невысокой относительной влажностью эффективным способом [[:w:терморегуляция |терморегуляции]] является испарение пота&lt;ref name=&quot;NIOSH-2016&quot; /&gt;. Например, по данным&lt;ref name=&quot;Величковский-1958&quot; /&gt; рабочий, обслуживающий электропечи, при температуре летом 45-50 °С, мог терять за смену 8 часов от 3,8 до 11,2 кг. Соответственно, использование газонепроницаемых материалов может создать опасность перегрева, мешая естественному способу терморегулирования. 

Для профилактики и смягчения этой проблемы предлагались и изучались разные способы&lt;ref name=&quot;NIOSH-2016&quot; /&gt;. Например, испытания подачи охлаждённого воздуха в надетое под одежду воздухораспределительное устройство показали, что за 12 часов не произошло существенного снижения работоспособности и ухудшения самочувствия. Достоинством устройства является очень небольшая масса (0,45 кг), а недостатком - необходимость подключения его к источнику-кондиционеру с помощью шланга (изделие предназначалось для танкистов). При использовании изолирующих костюмов в [[:w:Министерство среднего машиностроения СССР|атомной промышленности СССР]] мог использоваться другой способ - вблизи рабочего места оборудовали водопровод, а работник надевал поверх изолирующего СИЗ одноразовую тканевую одежду, которая периодически смачивалась. Испарение воды с мокрой ткани снаружи газонепроницаемого СИЗ &quot;имитировало&quot; испарение пота, нормализовало температуру тела, а снижение эффекта при использовании разновидности этой защитной одежды, закрывавшей меньшую часть тела, могло отчасти компенсироваться за счёт применения ткани, удерживающей больше воды&lt;ref name=&quot;Саливон-1970&quot; /&gt;. 

Но защите жизни и здоровья очень небольших групп исключительно высококвалифицированных специалистов, космонавтов, лётчиков, подводников, работников атомной промышленности и т.п., уделяется гораздо больше внимания, чем профилактике профзаболеваний у более многочисленных работников других отраслей народного хозяйства; и для последних СИЗ от перегрева могут не разрабатываться совсем.

== Проблемы выбора СИЗ кожи и обеспечения их своевременной замены ==
В отношении уровня и продолжительности защиты СИЗ одной из важнейших проблем может стать отсутствие или значительная [[:w:Неопределённость|неопределённость]] исходной информации для выбора подходящего изделия.

В американском руководстве для государственных инспекторов по охране труда дана классификация СИЗ кожи по степеням защиты, и рекомендации по их выбору. Вместе с тем, на основании большого накопленного практического опыта, авторы отмечают наличие значительной неопределённости в отношении оценки способности этих СИЗ защищать работника. Конкретно, многие компании производят разные СИЗ, используя разные материалы и [[:w:ru:Технология|технологии]], а затем успешно их сертифицируют, т.к. изделия соответствуют требованиям. Однако испытания проводятся по очень небольшому количеству вредных веществ, и в строго определённых, конкретных и стабильных лабораторных условиях. А условия на [[:w:ru:Рабочее место|рабочих местах]] иные, и очень разнообразные; как поведут себя СИЗ при воздействии множества вредных веществ, не использовавшихся при тестировании, заранее предсказать сложно. Хуже того, из-за использования разными производителями разных материалов и технологий, даже результаты экспериментов, проведённых на одной модели, нельзя использовать для оценки защитных свойств другой модели (т.к. при её изготовлении могли использоваться не точно такие же материалы / технологии)&lt;ref name=&quot;OSHA-2022+s&quot; /&gt;. Некоторые примеры такого разнообразия приводятся в таблице ниже.
{| class=&quot;wikitable collapsible &quot; style=&quot;text-align:center&quot;
! colspan=7 | Период времени (часы), за который некоторые вещества могут проникать сквозь некоторые изолирующие материалы, используемые для изготовления перчаток. Источник: таблица 4&lt;ref name=&quot;IS-2002&quot; /&gt;
|-
! rowspan=2 | Вещество !! colspan=6 | Изолирующий материал СИЗ
|-
| [[:w:Резина|Натуральная резина]] 
| [[:w:Хлоропреновый каучук|Неопрен]] 
| [[:w:Хлоропреновый каучук| Неопрен]] + [[:w:Резина|натуральная резина]] 
| [[:w:Нитрилы| Нитрил]] 
| [[:w:Поливинилхлорид| Поливинилхлорид]] 
| [[:w:Поливиниловый спирт| Поливиниловый спирт]] 
|-
| [[:w:Хлороформ | Хлороформ]] || от 0,01 до 0,05 || от 0,01 до 0,36 || от 0,05 до 0,11 || от 0,07 до 0,3 || около 0,01 || более 6
|-
| [[:w:Метанол |Метанол ]] || от 0,02 до 6 || от 0,25 до более 8 || от 0,1 до 1,1 || от 0,18 до 3,2 || от 0,02 до 6 || от 0,02 до 0,04
|-
| [[:w:Ацетон |Ацетон ]] || от 0,02 до более 3 || от 0,04 до более 1 || от 0,05 до 0,43 || от 0,07 до 0,3 || от менее 0,02 до 0,3 || от 0,07 до более 4
|-
| [[:w:Бензол |Бензол ]] || от 0,01 до 0,18 || от 0,02 до 3,1 || около 0,05 || от 0,07 до 1 || от менее 0,01 до 0,5 || от 0,05 до более 33
|}
[[File:Шланговый респиратор с полнолицевой маской.JPG|thumb|right|310px|Защита кожи при распылении краски сжатым воздухом]]
В ЕС разработан стандарт с общими указаниями по выбору СИЗ — защитной одежды&lt;ref name=&quot;ХимЗащОдежда-2017&quot; /&gt;. В разделе, относящемся к сертификационному тестированию, для большинства методов указано, что они не дают никакого представления о степени и длительности защиты на практике. Возможно, из-за этого в общих указаниях лишь упоминают, что при выборе СИЗ кожи следует учитывать их срок службы при воздействии конкретного вещества - без каких-то подробностей&lt;ref name=&quot;HAZWOPER&quot; /&gt;. Но определение этого срока может быть очень сложной задачей.

В справочных изданиях, например&lt;ref name=&quot;Forsberg-2020&quot; /&gt; приводятся минимальные ожидаемые сроки сохранения защитных свойств разных материалов при воздействии разных химических веществ, и предлагается выбирать подходящую химзащитную одежду на основе этой информации. Значительная неопределённость защитных свойств кожи, их зависимость от условий применения и выполняемой работы, может помешать их правильному выбору и использованию. Специалисты советуют как можно тщательнее искать исходные данные для оценки защитных свойств СИЗ кожи, и максимально критично оценивать информацию, предоставляемую поставщиками. Последние часто сообщают лишь то, сколько времени сохранялась непроницаемость при воздействии определённого вещества. С точки зрения эффективной защиты работников будет правильно не ограничиваться лишь этой информацией, а выяснить у поставщика/изготовителя температуру и способ испытаний, и др., пример ниже. 
{| class=&quot;wikitable collapsible collapsed&quot; style=&quot;text-align:left&quot;
! Специалисты советуют узнать у поставщика СИЗ&lt;ref name=&quot;Perkins-1989&quot; /&gt; :
|-
| 1. Какое химическое вещество использовалось для испытания непроницаемого материала, в какой форме и при какой концентрации.
|-
| 2. Способ испытаний материала.
|-
| 3. Температура, при которой проводилось испытание (с ростом температуры проницаемость обычно увеличивается).
|-
| 4. Концентрация, при которой метод испытаний и оборудование позволяли обнаружить проникание вредного вещества.
|-
| 5. Источник информации, например, название химической лаборатории, проводившей тестирование; или что данные получены изготовителем при проведении испытаний самостоятельно.
|-
| 6. Период времени, через который обнаруживалось проникание вредного вещества; или длительность эксперимента - если к его окончанию проникание не обнаруживалось.
|-
| 7. [[:w:Массообмен|Массоперенос]], установившаяся (постоянная) скорость проникания вредного вещества через изолирующий материал - если при проведении измерений будет достигнуто состояние стабильной скорости проникания. Если такое состояние не будет достигнуто - максимальная скорость проникания.
|-
| 8. Используется ли при обнаружении вредного вещества, проникшего через изолирующий материал, среда-носитель, перемещающаяся от материала к детектору непрерывно (т.е. заменяемая новыми, свежими и не загрязнёнными порциями), или рециркулирующая (движущаяся от детектора к материалу и от материала к детектору по кругу).
|-
| 9. При применении первого способа, указанного в п. 8 выше, какая минимальная скорость проникания могла быть измерена при использовавшемся оборудовании и методе замеров.
|-
| 10. При применении второго способа, указанного в п. 8 выше, и не обнаружении проникания вредного вещества за период измерений, минимальная скорость проникания, выраженная как отношение: (порог чувствительности, т.е. минимальная обнаруживаемая концентрация) × (площадь образца материала) / (объём среды-носителя на момент окончания измерений)
|-
| 11. Если время проникания является средним значением (при многократных измерениях), какое было стандартное отклонение от среднего значения. [[:w:Национальная ассоциация противопожарной защиты|NFPA]] требует от поставщиков сообщать минимальное и максимальное время проникания. 
|-
| 12. Как часто измерялась концентрация вредного вещества, проникшего через материал. Например, если замеры проводились каждые полчаса, и было получено время проникания 32 минуты, то точность такой информации может быть низкой. Специалисты советуют сообщать такое время проникания, когда проводился последний замер, ещё не обнаруживший проникание - непосредственно перед обнаружением.
|}
Однако во многих случаях необходимая информация может быть недоступна, например из-за того, что испытания для конкретного сочетания ''( изолирующий материал - вредное вещество - условия воздействия )'' не проводились; проводились, но неизвестны поставщику; информация может быть коммерческой или служебной тайной&lt;ref name=&quot;ACGIH-1987&quot; /&gt;.

Таким образом, определение срока службы может быть непростой задачей, а использование лишь небольшого количества (вполне точной и достоверной) информации, часто предоставляемой поставщиками, может привести к грубым ошибкам и сильной недооценке риска.

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

Специалисты по [[:w:профессиональные заболевания|профессиональным заболеваниям]] из [[:w:Американская ассоциация государственных промышленных гигиенистов |ACGIH]] рекомендуют шире использовать биологический мониторинг для оценки фактического воздействия химических веществ на организм. В США это юридически обязательно при работе со [[:w:Отравления свинцом|свинцом]], [[:w:Кадмий|кадмием]] и [[:w:Бензол|бензолом]]. Разработаны методы измерений и &quot;[[:w:ПДКр.з.#Биологические ПДК|биологические ПДК]]&quot; для примерно 59 вредных веществ и их групп&lt;ref name=&quot;TLV+BEI-2025&quot; /&gt;.

В РФ конкретных требований и рекомендаций специалистов по выбору СИЗ кожи от химических веществ нет, стандарт&lt;ref name=&quot;ХимЗащОдежда-2017&quot; /&gt; не переведён, разработка и внедрение биомониторинга ведётся крайне медленно&lt;ref name=&quot;Орлова-2010&quot; /&gt;.

== Примечания ==
{{примечания|refs=
&lt;ref name=&quot;КЗ-кожи-&quot;&gt;{{Статья|автор=J.W. Cherrie, S. Semple, D. Brouwer|заглавие=Gloves and Dermal Exposure to Chemicals: Proposals for Evaluating Workplace Effectiveness|год=2004|язык=en|издание=The Annals of Occupational Hygiene|издательство=Oxford University Press|месяц=10|выпуск=7|pages=607–615|volume=48|doi=10.1093/annhyg/meh060}} ISSN 2398-7308, {{PMID|15388512}}.&lt;/ref&gt;
&lt;ref name=&quot;КЗ-кожи&quot;&gt;{{Статья|автор=Derk H. Brouwer, Hans Marquart, Joop J. van Hemmen|заглавие=Proposal for an Approach with Default Values for the Protection Offered by PPE, Under European New or Existing Substance Regulations|год=2001|язык=en|автор издания=British Occupational Hygiene Society|издание=Annals of Occupational Hygiene|издательство=Oxford University Press|месяц=10|выпуск=7|pages=543-553|volume=45|issn=|doi=10.1016/S0003-4878(01)00021-7|pmid=}} ISSN 2398-7308, {{PMID|11583656}}.&lt;/ref&gt; 
&lt;ref name=&quot;OSHA-2022+s&quot;&gt;{{Cite web|url=https://www.osha.gov/otm/section-8-ppe/chapter-1|title=Chapter 1. Chemical Protective Clothing |last= US OSHA|website=www.osha.gov|subtitle=OSHA [https://www.osha.gov/otm/ Technical Manual] (OTM). Section VIII |publisher=Occupational Safety and Health Administration|lang=en}} (6 июля 2022). Дата обращения: 24 октября 2024.&lt;/ref&gt;
&lt;ref name=&quot;NIOSH-2016&quot;&gt;{{Книга|автор=Бренда Джеклич; Джон Уильямс; Кристин Мусолин; Айто Кока; Юнг-Хюн Ким; Нина Тёрнер и др|заглавие=NIOSH criteria for a recommended standard: occupational exposure to heat and hot environments|ссылка=https://www.cdc.gov/niosh/docs/2016-106/|ответственный=John Howard, MD|издание=3 ed|место=Cincinnati, Ohio|издательство=U.S. Department of Health and Human Services, Centers for Disease Control and Prevention, National Institute for Occupational Safety and Health|год=2016|allpages=192|серия=DHHS (NIOSH) Publication No. 2016-106|archive-date=2021-12-30|archive-url=https://web.archive.org/web/20211230163015/https://www.cdc.gov/niosh/docs/2016-106/}} Есть перевод: [[:Файл:NIOSH Жара перевод 05.07.2018 wiki+++.pdf|PDF]] [[b:ru:Защита работников от нагревающего микроклимата|Wiki]]&lt;/ref&gt;
&lt;ref name=&quot;Величковский-1958&quot;&gt;{{Книга |автор=[[:w:Величковский, Борис Тихонович| Величковский Б.Т.]], Власова В.Н. |заглавие=Вопросы гигиены труда, профпатологии и промышленной токсикологии |ответственный=Редакционная коллегия: Михайлов В.А. и другие |год=1958 |часть=Силикоз и его профилактика у рабочих, занятых на электроплавке кремния. В: II Вопросы пылевой патологии |место=Свердловск |издательство=Свердловский научно-исследовательский институт гигиены труда и профпатологии |том=3, часть 1 |страницы=155-166 |всего страниц=201 |серия=Министерство здравоохранения РСФСР |тираж=1100}}&lt;/ref&gt;
&lt;ref name=&quot;Саливон-1970&quot;&gt;''Саливов С.Г.'' [https://cyberleninka.ru/article/n/o-zavisimosti-ohlazhdayuschego-effekta-ot-vlagoemkosti-i-konstruktsii-ekrana/viewer О зависимости охлаждающего эффекта от влагоёмкости и конструкции экрана] // Гигиена и санитария. — Москва, 1970. — № 6. — С. 22-26. — ISSN 0016-9900&lt;/ref&gt;


&lt;ref name=&quot;ХимЗащОдежда-2017&quot;&gt;{{Книга |автор=CEN/TC 162/WG 3 - Protective clothing against chemicals, infective agents and radioactive contamination |заглавие=PD CEN/TR 15419:2017 Protective clothing - Guidelines for selection, use, care and maintenance of chemical protective clothing |ответственный=European Committee for Standardization (CEN) |год=2017 |часть=4.6 Garment material selection criteria (definition of CPC material criteria) |язык=en |издание=2nd ed |место=Brussels, Belgium |издательство=British Standards Institution |pages=13-17 |allpages=49 |серия=ICS 13.340.10 Protective clothing |isbn=978 0 580 98705 2}}&lt;/ref&gt;
&lt;ref name=&quot;HAZWOPER&quot;&gt;{{Книга |ссылка=https://www.local49training.org/wp-content/uploads/40-Hour-HAZWOPER-Student-Manual.pdf |автор=Barbara A. McCabe et al |заглавие=40-Hour HAZWOPER Student Manual |ответственный=International Union of Operating Engineers’ (IUOE) ’ National Training Fund (NTF) |год=2017 |место=Beaver, WV |allpages=543 |серия=National HAZMAT Program.}}&lt;/ref&gt;
&lt;ref name=&quot;Forsberg-2020&quot;&gt;{{Книга |автор=Krister Forsberg, Ann Van den Borre, James P. Zeigler |заглавие=Quick Selection Guide to Chemical Protective Clothing |год=2020 |язык=en |издание= 7th ed |место=Hoboken, NJ |издательство=John Wiley &amp; Sons, Inc. |allpages=308 |isbn=978-1119650553}}&lt;/ref&gt;

&lt;ref name=&quot;IS-2002&quot;&gt;{{Книга |ссылка= https://dn760001.eu.archive.org/0/items/gov.in.is.15071.2002/is.15071.2002.pdf |автор=Shri K.C. Gupta et al |заглавие=Indian Standard IS 15071:2002. Chemical Protective Clothing Specification  |ответственный=lndustrial Safety Sectional Committee, CHD 08 |год=2002 |оригинал=British Standard BS 7184:1989 ‘Recommendations for selection, use and maintenance of chemical protective clothing’ |язык=en |место=New Delhi |издательство=Bureau of Indian Standards |allpages=23 |серия=ICS 13.340.10}}&lt;/ref&gt;
&lt;ref name=&quot;ACGIH-1987&quot;&gt;{{Книга |автор=A.D. Schwope et al |заглавие=Guidelines for the Selection of Chemical Protective Clothing |ответственный=Arthur D. Little, Inc |год=1987 |язык=en |издание=3rd ed |место=Cincinnati, Ohio |издательство=American Conference of Governmental Industrial Hygienists |allpages=587 |volume=I Field Guide; and Vol. II Technical and Reference Manual |серия=ACGIH Signature Publication}}&lt;/ref&gt;

&lt;ref name=&quot;Perkins-1989&quot;&gt;{{Книга |ссылка= https://dl.astm.org/stps/book/472/Chemical-Protective-Clothing-Performance-in |автор=R.A. Janke |заглавие=Chemical Protective Clothing Performance in Chemical Emergency Response |часть= Understanding and using chemical permeation data in the selection of chemical protective clothing |ответственный=J.O. Stull, J.L. Perkins eds |издание= American Society for Testing and Materials |год=1989 |язык=en |место=Baltimore, MD |издательство=ASTM International |allpages=279 |isbn=978-0-8031-1297-1 |серия= ASTM Selected Technical Papers STP1037-EB |doi= 10.1520/STP1037-EB}}&lt;/ref&gt;
&lt;ref name=&quot;TLV+BEI-2025&quot;&gt;{{Книга |автор=Nancy B. Hopf et al |заглавие=2025 TLV and BEI Based on the Documentation of the Threshold Limit Values for Chemical Substances and Physical Agents |год=2025 |часть=2025 Biological Exposure Indices Adopted by ACGIH with Intended Changes |язык=en |место=Cincinnati, Ohio |издательство=American Conference of Governmental Industrial Hygienists |pages=103-124 |allpages=302 |серия=ACGIH Signature Publication |isbn=978-1-60726-173-5}}&lt;/ref&gt;
&lt;ref name=&quot;Орлова-2010&quot;&gt;{{Статья |автор=Орлова О.И., Савельева Е.И., Радилов А.С., Бабаков В.Н., Войтенко Н.Г |заглавие=Применение биомониторинга для оценки характера и тяжести воздействия химического фактора |год=2010 |месяц=12 |автор издания=НИИ медицины труда РАН |место=Москва |издание=Медицина труда и промышленная экология |номер=12 |страницы=28-32 |ссылка=https://cyberleninka.ru/article/n/primenenie-biomonitoringa-dlya-otsenki-haraktera-i-tyazhesti-vozdeystviya-himicheskogo-faktora|issn=}} ISSN 1026-9428&lt;/ref&gt;
}}

[[Категория:Средства индивидуальной защиты (обзорная лекция)]]
{{Stub}}</text>
      <sha1>80q7tqleyk0kbr0j9bogvg0ghxcl716</sha1>
    </revision>
  </page>
  <page>
    <title>Средства индивидуальной защиты (обзорная лекция)/СИЗ рук</title>
    <ns>0</ns>
    <id>35746</id>
    <revision>
      <id>270427</id>
      <parentid>269662</parentid>
      <timestamp>2026-10-27T07:09:06Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <origin>270427</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="21211" sha1="0q1lsm42zvmyfykbzdzbg92n87kep1g" xml:space="preserve">[[File:Kevlar gloves.jpg|thumb|right|300px|Перчатки из прочного [[:w:Кевлар|кевлара]].]]
Разрабатываются и используются средства индивидуальной защиты рук от разных вредных и опасных производственных факторов (порезов, вибрации, повышенной и/или пониженной температуры, электрического тока, кислот, щелочей и др.). К СИЗ рук относят не только рукавицы, перчатки, наладонники, вачаги, но и [[дерматологические средства защиты]] (мази, пасты, кремы)&lt;ref name=&quot;СИЗ-2005-104&quot; /&gt;.
[[File:Condenser Water Supply is Welded by Monaco (8268314628).jpg|thumb|right|300px|Перчатки для [[:w:Сварка|сварочных работ]], устойчивы к прожиганию искрами]]
== СИЗ рук от вибраций ==
Результаты измерений с помощью [[:w:ru:Виброметр|портативного акселерометра]] показали, что эластичное покрытие рукояток вибрирующего инструмента и использование виброзащитных перчаток (2 модели) заметно уменьшили вибрационные ускорения, передаваемые на руку. Авторы посоветовали шире использовать портативное измерительное оборудование для оценки риска у рабочих, использующих вибрирующие ручные инструменты&lt;ref name=&quot;виб+&quot; /&gt;. Выполнение такого предложения позволит, в том числе, учесть возможное значительное изменение вибрационной скорости инструмента, происходящее при его систематичном использовании. Например, у пневматической шлифовальной машины ПШТ виброскорости ручки и шейки в начале эксплуатации и через полгода составляли 0,09 и 0,69 см/с на частоте 2 кГц&lt;ref name=&quot;виб-инстр&quot; /&gt;.

[[:w:Управление по охране труда Великобритании (HSE)|Британское управление по охране труда]] считает&lt;ref name=&quot;виб-HSE&quot; /&gt;, что виброзащитные перчатки эффективны лишь при защите от высокочастотных колебаний, а при средне- и низкочастотных они неэффективны. Работодателям рекомендуют:
* Исходить из того, что виброзащитные перчатки неэффективны, кроме случаев, когда есть результаты измерений в конкретных условиях, доказывающие обратное;
* Искать пути снижения воздействия вибрации на работника (безопасный инструмент и т.п.);
* При работе в холодную погоду для предотвращения ухудшения кровообращения следует держать руки сухими и в тепле, для чего могут пригодиться подходящие перчатки.

Отдел охраны труда правительства штата Вашингтон&lt;ref name=&quot;виб-US&quot; /&gt; также предупреждает о том, что виброозащитные перчатки могут быть эффективны лишь при высокочастотной вибрации, при том, что средне- и низкочастотные вибрации - опаснее. Кроме того, читателей предупреждают, что использование &quot;толстых&quot; виброзащитных перчаток (как показала практика) может увеличить риск травмирования работников, которым может быть сложнее работать в таких средствах защиты.

== СИЗ рук от перегрева ==
Результаты исследования перчаток у 135 работниц, работавших в контакте с оборудованием и изделиями при температуре 30-80°С показали недостаточную эффективность. Перед обеденным перерывом температура кожи в подперчаточном пространстве возросла на 4,4°С, от 27 до 63% работниц жаловались на недостаточную эффективность СИЗ и неприятные ощущения&lt;ref name=&quot;Денисов-2013&quot; /&gt;.
[[File:Butyl rubber gloves.JPG|thumb|right|300px|Перчатки из [[:w:Бутилкаучук|бутилкаучука]] газо- и влагонепроницаемы, обладают хорошими электроизолирующими свойствами, но не очень эластичны]]

== СИЗ рук от химических веществ ==
Защитные свойства перчаток, высококачественных и сертифицированных, могут очень сильно зависеть от конкретного исполнения и условий применения. Сколько-нибудь точное прогнозирование степени и длительности защиты работника на основании результатов сертификационных испытаний при воздействии небольшого числа вредных веществ в строго определённых контролируемых лабораторных условиях невозможно. Из-за использования разными производителями разных технологий для изготовления перчаток из одного и того же материала, фактические защитные свойства у таких (сертифицированных) СИЗ разных моделей могут значительно отличаться. См. подробное описание в: [[Средства индивидуальной защиты (обзорная лекция)/СИЗ кожи от химических веществ|средства защиты кожи от химических веществ]].

== СИЗ рук от механических повреждений ==
Для защиты от порезов могут использоваться перчатки из прочных волокон, а при опасности сильных ударов - перчатки из маленьких металлических колец. Такие СИЗ могут надёжно защищать руки от ударов острыми предметами.

Однако испытания разных моделей этих СИЗ на предприятиях показало, что их применение не всегда даёт лишь положительный эффект. Некоторые модели оказалось трудно очищать и дезинфицировать после загрязнения кровью и другими органическими материалами&lt;ref name=&quot;Гущина-10-2-4&quot; /&gt;.

== Намокание, запотевание, снижение прочности и очистка ==
Рукавицы и перчатки из ткани могут быстро намокать, а в резиновых руки потеют&lt;ref name=&quot;Гущина-2-4&quot; /&gt;. Кожаные перчатки в этом отношении лучше, а использование резиновых не всегда может быть оправдано. При работе с кислотами, щелочами, растворителями и спиртами резина может набухать и терять прочность. СИЗ из синтетических материалов значительно лучше и прочнее, служат дольше - но руки в них потеют. В некоторых случаях может быть полезно надевать под них трикотажные перчатки.&lt;ref name=&quot;СИЗ-2005-104&quot; /&gt;.

По данным&lt;ref name=&quot;Гущина-7-1&quot; /&gt; после использования кислотозащитных перчаток в течение 10 смен их прочность снизилась на треть, произошло набухание полимера на 16%, и возросла кислотопроницаемость с 0 до 0,65 ед. pH. Воздействие ксилола на материал СКС-30НРКП привело к снижению прочности в 6,9 раз за 72 часа.

Т.е. непроницаемые для токсичного вещества СИЗ могут разрушаться из-за механического воздействия при снижении прочности материала. Полноценная очистка СИЗ может оказаться невыполнимой из-за проникания молекул токсичного вещества вглубь материала СИЗ&lt;ref name=&quot;Гущина-7-1&quot; /&gt;. Если очистка будет выполняться при повышенной температуре, проникание может ускориться и усилиться.

== Выбор СИЗ рук и длительность их применения ==
Разработаны международные рекомендации по выбору СИЗ рук при защите от различных вредных и опасных производственных факторов&lt;ref name=&quot;ИСО-руки-выбор&quot; /&gt;.

В РФ допустимая максимальная продолжительность использования СИЗ рук не установлена; рекомендуемые специалистами&lt;ref&gt;{{Книга |автор=Файнбург Г.З., Порываев А.А. |заглавие=Процедуры обеспечения средствами индивидуальной защиты и ухода за ними. Учебное пособие |год=2025 |часть=Глава 7. Типичные вопросы и ответы по обеспечению средствами индивидуальной защиты |издание=2-е издание |место=Пермь |издательство=Издательство Пермского национального политехнического университета |страницы=91 |всего страниц=176 |серия=За достойный и безопасный труд. Выпуск 4 |isbn=978-5-398-03317-5 |тираж=50}}&lt;/ref&gt; ограничения приводятся ниже.
{| class=&quot;wikitable collapsible &quot; style=&quot;text-align:center&quot;
! Вид работы || Рекомендуемая продолжительность непрерывного применения
|-
| Медицинские процедуры || Один раз
|-
| Санитарная обработка || до 1 часа
|-
| Уборка и дезинфекция || до 2 часов
|-
| Работа с опасными веществами || до 4 часов
|-
| Кулинарные работы || до 2 часов
|}

== Примечания ==
{{примечания|refs=
&lt;ref name=&quot;СИЗ-2005-104&quot;&gt;{{книга|автор=Файнбург Г.З., Овсянкин А.Д. |часть= 4.5 Средства защиты рук |заглавие=Использование средств индивидуальной защиты от неблагоприятного воздействия производственной среды |издание=7 изд., исправленное и дополненное |место= Пермь |издательство= Отдел публикаций Пермского областного центра охраны труда на базе [[:w:Пермский государственный университет| ПГТУ]]|год=2005 |страницы= 104-109 |всего страниц= 212|isbn= 5-88151-360-6 |серия=  Рекомендовано Департаментом условий и охраны труда Минтруда России в качестве учебного пособия для обучения и проверки знаний работников по охране труда, включая обучение отдельных категорий застрахованных |ответственный=Рецензенты Радостев М.А. ''&lt;small&gt;(ЗАО «Пермь-Восток-Сервис»)&lt;/small&gt;'', ктн Коротаев В.Ф. ''&lt;small&gt;(Пермский государственный технический университет)&lt;/small&gt;''|тираж=1900|}}&lt;/ref&gt;

&lt;ref name=&quot;виб+&quot;&gt;{{Статья|ссылка=https://academic.oup.com/joh/article/54/3/250/7270356?login=false |автор=Matija Milosevic, Kristiina M Valter McConville|заглавие=Evaluation of protective gloves and working techniques for reducing hand-arm vibration exposure in the workplace|год=2012|язык=en|автор издания=Japan Society for Occupational Health|издание=Journal of Occupational Health|издательство=Oxford University Press|месяц=4|число=19|выпуск=3|pages=250-253|volume=54|issn=|doi=10.1539/joh.11-0176-br|pmid=}} ISSN 1348-9585, {{PMID|22790528}}. [https://academic.oup.com/joh/article-pdf/54/3/250/51956136/joh2054003011.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;виб-инстр&quot;&gt;{{Книга|автор=Садчикова И.П., Смирнов В.Г.|заглавие=Безопасность труда|ответственный=Цуцков М.Е.|год=1978|часть=Динамика изменения вибрационных характеристик ручного инструмента в процессе эксплуатации|место=Москва|издательство=Профиздат|страницы=77-78|страниц=120|серия=Сборник научных работ институтов охраны труда ВЦСПС|тираж=5000}}&lt;/ref&gt;
&lt;ref name=&quot;виб-HSE&quot;&gt;{{Книга|ссылка=https://www.hse.gov.uk/pubns/books/hsg170.htm |автор=Health and Safety Executive|заглавие=Vibration solutions: Practical ways to reduce the risk of hand-arm vibration injury|ответственный=HSE|год=1997|часть=Gloves|язык=en|место=Richmond, Surrey|издательство=Crown|pages=11|allpages=107|серия=HSG170|isbn=978 0 7176 0954 3}} [https://www.hse.gov.uk/pubns/priced/hsg170.pdf PDF]&lt;/ref&gt;
&lt;ref name=&quot;виб-US&quot;&gt;''Division of Occupational Safety and Health''. [https://lni.wa.gov/safety-health/_docs/DoAntiVibrationGlovesPreventVibrationRelatedInjuries.pdf Do anti-vibration gloves prevent vibration-related injuries?] &lt;small&gt;(англ.)&lt;/small&gt;. ''lni.wa.gov''. Washington, District of Columbia: Washington State Department of Labor &amp; Industries. Дата обращения: 2 ноября 2024.&lt;/ref&gt;
&lt;!-- Комментарий --&gt;{{Cite web|url=https://lni.wa.gov/safety-health/_docs/DoAntiVibrationGlovesPreventVibrationRelatedInjuries.pdf|title=Do anti-vibration gloves prevent vibration-related injuries?|lang=en|author=Division of Occupational Safety and Health|website=lni.wa.gov|location=Washington, District of Columbia|publisher=Washington State Department of Labor &amp; Industries|access-date=2024-11-02}}
&lt;ref name=&quot;Денисов-2013&quot;&gt;{{Статья|ссылка=https://cyberleninka.ru/article/n/problema-realnoy-effektivnosti-individualnoy-zaschity-i-privnosimyy-risk-dlya-zdorovya-rabotnikov-obzor-literatury/viewer|автор=Денисов Э.И., Морозова Т.В., Аденинская Е.Е., Курьеров Н.Н.|заглавие=Проблема реальной эффективности индивидуальной защиты и привносимый риск для здоровья работников (обзор литературы)|год=2013|автор издания=НИИ медицины труда РАН|издание=Медицина труда и промышленная экология|месяц=8|номер=8|страницы=18-25|issn=|pmid=}} ISSN 1026-9428, {{PMID|24006620}}.&lt;/ref&gt;
&lt;ref name=&quot;ИСО-руки-выбор&quot;&gt;{{Книга|ссылка= https://standards.iteh.ai/catalog/standards/iso/595b9063-b055-4b86-95d3-424cb3eb4337/iso-tr-8546-2022 |автор=Technical Committee ISO/TC 94/SC 13 Protective clothing.|заглавие=ISO/TR 8546:2022 Hand protection — Guidance for selection and use|год=2022|язык=en|место=Geneva, Switzerland|издательство=International Organization for Standardization|allpages=31|серия=ISC 13.340.40 Hand and arm protection }}&lt;/ref&gt;
&lt;ref name=&quot;Гущина-10-2-4&quot;&gt;{{Книга |автор=Гущина Татьяна Викторовна |заглавие=Методология разработки и испытаний средств индивидуальной защиты |ответственный=рецензенты Киричек А.В., Шарупич Т.С. |год=2007 |часть=10.2.4 Эксплуатационные испытания защитных перчаток. В: 10 Производственная апробация средств индивидуальной защиты в условиях АПК, разработка рекомендаций. 10.2 Проведение производственных испытаний |место=Орёл |издательство=Издательство ОрёлГАУ |страницы=279 |всего страниц=330 |серия=Монография |тираж=100}} цитата:''&quot;При эксплуатации армированных перчаток на Донецком мясокомбинате были выявлены негативные последствия: через полгода их применения у работников начались кожаные заболевания рук. ... Результаты исследований показали, что применяемый режим дезинфекции не пригоден для обработки данного вида изделий.&quot;''.&lt;/ref&gt;
&lt;ref name=&quot;Гущина-2-4&quot;&gt;{{Книга |автор=Гущина Татьяна Викторовна |заглавие=Методология разработки и испытаний средств индивидуальной защиты |ответственный=рецензенты Киричек А.В., Шарупич Т.С. |год=2007 |часть=2.4 Выращивание птицы промышленным способом. В: 2 Условия эксплуатации средств индивидуальной защиты и состояние производственного травматизма на агропромышленных предприятиях |место=Орёл |издательство=Издательство ОрёлГАУ |страницы=31 |всего страниц=330 |серия=Монография |тираж=100}}&lt;/ref&gt;
&lt;ref name=&quot;Гущина-7-1&quot;&gt;{{Книга |автор=Гущина Татьяна Викторовна |заглавие=Методология разработки и испытаний средств индивидуальной защиты |ответственный=рецензенты Киричек А.В., Шарупич Т.С. |год=2007 |часть=7.1 Условия безопасного применения агрохимикатов в сельском хозяйстве. В: 7 Обеспечение безопасности при применении средств защиты растений |место=Орёл |издательство=Издательство ОрёлГАУ |страницы=31 |всего страниц=330 |серия=Монография |тираж=100}}&lt;/ref&gt;
}}

[[Категория:Средства индивидуальной защиты (обзорная лекция)]]
{{Stub}}</text>
      <sha1>0q1lsm42zvmyfykbzdzbg92n87kep1g</sha1>
    </revision>
  </page>
  <page>
    <title>Шаблон:ISBN</title>
    <ns>10</ns>
    <id>35914</id>
    <revision>
      <id>270414</id>
      <timestamp>2026-10-27T06:55:53Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <comment>Новая страница: «&lt;includeonly&gt;[[Speciale:RicercaISBN/{{{1}}}|ISBN {{{1}}}]]&lt;/includeonly&gt;&lt;noinclude&gt;»</comment>
      <origin>270414</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="83" sha1="25b0siugrti6gb042pe5sx10npo9yjf" xml:space="preserve">&lt;includeonly&gt;[[Speciale:RicercaISBN/{{{1}}}|ISBN {{{1}}}]]&lt;/includeonly&gt;&lt;noinclude&gt;</text>
      <sha1>25b0siugrti6gb042pe5sx10npo9yjf</sha1>
    </revision>
  </page>
  <page>
    <title>Шаблон:PMID</title>
    <ns>10</ns>
    <id>35915</id>
    <revision>
      <id>270416</id>
      <timestamp>2026-10-27T07:01:11Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <comment>Новая страница: «&lt;includeonly&gt;[https://www.ncbi.nlm.nih.gov/pubmed/{{{1}}} PMID {{{1}}}]&lt;/includeonly&gt;&lt;noinclude&gt;Use ''&lt;nowiki&gt;{{PMID|9733676}}&lt;/nowiki&gt;'' instead of ''&lt;nowiki&gt;PMID 9733676&lt;/nowiki&gt;'', to replace the deprecated magic links for sustainable code.&lt;/noinclude&gt;»</comment>
      <origin>270416</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="255" sha1="qxsv9inyk6exmdmx98zw1y0c8gi67n2" xml:space="preserve">&lt;includeonly&gt;[https://www.ncbi.nlm.nih.gov/pubmed/{{{1}}} PMID {{{1}}}]&lt;/includeonly&gt;&lt;noinclude&gt;Use ''&lt;nowiki&gt;{{PMID|9733676}}&lt;/nowiki&gt;'' instead of ''&lt;nowiki&gt;PMID 9733676&lt;/nowiki&gt;'', to replace the deprecated magic links for sustainable code.&lt;/noinclude&gt;</text>
      <sha1>qxsv9inyk6exmdmx98zw1y0c8gi67n2</sha1>
    </revision>
  </page>
  <page>
    <title>Шаблон:RFC</title>
    <ns>10</ns>
    <id>35916</id>
    <revision>
      <id>270428</id>
      <timestamp>2026-10-27T07:10:31Z</timestamp>
      <contributor>
        <username>Jcb</username>
        <id>79968</id>
      </contributor>
      <comment>Новая страница: «&lt;includeonly&gt;[https://datatracker.ietf.org/doc/html/rfc{{{1}}} RFC&amp;nbsp;{{{1}}}]&lt;/includeonly&gt;»</comment>
      <origin>270428</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="94" sha1="ljegpqixl8x3qu5u73cf4ism6vgfnkd" xml:space="preserve">&lt;includeonly&gt;[https://datatracker.ietf.org/doc/html/rfc{{{1}}} RFC&amp;nbsp;{{{1}}}]&lt;/includeonly&gt;</text>
      <sha1>ljegpqixl8x3qu5u73cf4ism6vgfnkd</sha1>
    </revision>
  </page>
</mediawiki>