Как комментировать?

@supmener · Регистрация: 26.06.2013

Студворк — интернет-сервис помощи студентам

Такие кавычки - это тоже комментарии в коде?

Python
1
2
'Привет, мир'
"Это комментарий?"

Заметил, что такие строки не вызывают ошибок. Думал до сих пор, что комментировать можно только так:
#
Или так:

Python
1
2
3
"""
Текст
"""

Рыжий Лис · 11.03.2023, 17:11

Сообщение от supmener

'Привет, мир'

Не комментарий.

Сообщение от supmener

"Это комментарий?"

Не комментарий.

Сообщение от supmener

"""
Текст
"""

Не комментарий.

Сообщение от supmener

Думал до сих пор, что комментировать можно только так:
#

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

Python
1
2 + 42

Code
1
Statement seems to have no effect

@supmener · 11.03.2023, 17:23 **[ТС]**

А почему VSC работает, не показывая ошибок? И такое поведение при изучении документации BeautifulSoup позволяет экономить время, так как там таким образом оформлены пояснения к коду и не надо переделывать в принты при запуске примеров и сохранении их в удобном виде.

Хм, читал, что с помощью """ оформляются многострочные комментарии и при использовании в ООП к ним можно получать доступ через doc (точный синтаксис записывал в конспект, если это именно про Пайтон было).

Рыжий Лис · 11.03.2023, 17:27

Сообщение от supmener

""" оформляются многострочные комментарии

Нет.

Сообщение от supmener

при использовании в ООП к ним можно получать доступ через doc

Это doc-strings и они не только в ООП (классах).

Добавлено через 1 минуту
При doc-strings происходит неявное присваивание. Это всё ещё не комментарий.

Python
1
2
3
4
5
6
7
8
9
10
11
12
13
>>> def f():
...     """doc-strings"""
...     pass
... 
>>> f.__doc__
'doc-strings'
>>> def f2():
...     pass
... 
>>> f2.__doc__
>>> f2.__doc__ = 'doc-strings2'
>>> f2.__doc__
'doc-strings2'

Добавлено через 32 секунды

Сообщение от supmener

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

Это doc-strings

@supmener · 11.03.2023, 17:27 **[ТС]**

Сообщение от supmener

оформлены пояснения к коду

Вернее показан вывод в консоль.

Рыжий Лис · 11.03.2023, 17:29

doc-strings удаляются при компиляции с оптимизацией, поэтому не предназначены для хранения какой-либо информации.

Добавлено через 1 минуту

Сообщение от supmener

Вернее показан вывод в консоль.

Это doctests https://docs.python.org/2/library/doctest.html

Всё ещё не комментарии.

Добавлено через 16 секунд
https://docs.python.org/3/library/doctest.html

@supmener · 11.03.2023, 17:45 **[ТС]**

https://pypi.org/project/docformatter/

— docformatter
pypi.org/project/docformatter

Строки документации (docstrings) регулируются набором соглашений, описанных в PEP 257. Главное правило звучит так: «Всегда используйте тройные двойные кавычки вокруг строк документации» ("""triple double quotes"""). docformatter поможет автоматически расставить громоздкие конструкции из кавычек, а также соблюсти другие рекомендации.
https://vk.com/wall-84793390_13797

Рыжий Лис · 11.03.2023, 17:56

Всё ещё не комментарии.

@Ципихович Эндрю · 11.03.2023, 18:54

не знаю как в чистом пайтоне а в пайчарме всё что серого цвета=после решётки то и есть комментарий
всё остальное это придумки

Новые блоги и статьи Все статьи Все блоги /
Загрузка PNG с альфа-каналом на SDL3 для Android: с помощью SDL_LoadPNG (без SDL3_image) 8Observer8 28.01.2026 Содержание блога SDL3 имеет собственные средства для загрузки и отображения PNG-файлов с альфа-каналом и базовой работы с ними. В этой инструкции используется функция SDL_LoadPNG(), которая. . .	Загрузка PNG с альфа-каналом на SDL3 для Android: с помощью SDL3_image 8Observer8 27.01.2026 Содержание блога SDL3_image - это библиотека для загрузки и работы с изображениями. Эта пошаговая инструкция покажет, как загрузить и вывести на экран смартфона картинку с альфа-каналом, то есть с. . .	влияние грибов на сукцессию anaschu 26.01.2026 Бифуркационные изменения массы гриба происходят тогда, когда мы уменьшаем массу компоста в 10 раз, а скорость прироста биомассы уменьшаем в три раза. Скорость прироста биомассы может уменьшаться за. . .	Воспроизведение звукового файла с помощью SDL3_mixer при касании экрана Android 8Observer8 26.01.2026 Содержание блога SDL3_mixer - это библиотека я для воспроизведения аудио. В отличие от инструкции по добавлению текста код по проигрыванию звука уже содержится в шаблоне примера. Нужно только. . .
Установка Android SDK, NDK, JDK, CMake и т.д. 8Observer8 25.01.2026 Содержание блога Перейдите по ссылке: https:/ / developer. android. com/ studio и в самом низу страницы кликните по архиву "commandlinetools-win-xxxxxx_latest. zip" Извлеките архив и вы увидите. . .	Вывод текста со шрифтом TTF на Android с помощью библиотеки SDL3_ttf 8Observer8 25.01.2026 Содержание блога Если у вас не установлены Android SDK, NDK, JDK, и т. д. то сделайте это по следующей инструкции: Установка Android SDK, NDK, JDK, CMake и т. д. Сборка примера Скачайте. . .	Использование SDL3-callbacks вместо функции main() на Android, Desktop и WebAssembly 8Observer8 24.01.2026 Содержание блога Если вы откроете примеры для начинающих на официальном репозитории SDL3 в папке: examples, то вы увидите, что все примеры используют следующие четыре обязательные функции, а. . .	моя боль iceja 24.01.2026 Выложила интерполяцию кубическими сплайнами www. iceja. net REST сервисы временно не работают, только через Web. Написала за 56 рабочих часов этот сайт с нуля. При помощи perplexity. ai PRO , при. . .

@supmener 87 / 95 / 15 Регистрация: 26.06.2013 Сообщений: 4,753
	11.03.2023, 17:23 [ТС]
	А почему VSC работает, не показывая ошибок? И такое поведение при изучении документации BeautifulSoup позволяет экономить время, так как там таким образом оформлены пояснения к коду и не надо переделывать в принты при запуске примеров и сохранении их в удобном виде. Хм, читал, что с помощью """ оформляются многострочные комментарии и при использовании в ООП к ним можно получать доступ через doc (точный синтаксис записывал в конспект, если это именно про Пайтон было). 0

Рыжий Лис Просто Лис 5973 / 3735 / 1099 Регистрация: 17.05.2012 Сообщений: 10,791 Записей в блоге: 9
	11.03.2023, 17:56
	Всё ещё не комментарии. 0

@Ципихович Эндрю 1711 / 578 / 76 Регистрация: 10.04.2009 Сообщений: 9,316
	11.03.2023, 18:54
	не знаю как в чистом пайтоне а в пайчарме всё что серого цвета=после решётки то и есть комментарий всё остальное это придумки 4