Техника, которую мы можем применить прямо здесь, состоит в том, чтобы делать много реалистичных примеров. Это много кода.
Предполагается, что на вашем компьютере установлен Python. Если нет, нажмите здесь.
Примечание.все, что указано в сером поле, — это то, что вы запускаете в надежном файле текстового редактора.
Итак, давайте начнем.
Комментарии
- Комментарии в основном используются для того, чтобы веб-разработчики или программисты могли понять ваш код.
- Описание кода с помощью комментариев поможет вам легко понять код и без труда отладить свой код. Это также позволяет вам понять концепцию вашего приложения, когда вы вернетесь к нему в любой момент (дни, недели, годы).
- Он игнорируется интерпретатором.
- Комментарии также можно использовать, чтобы избежать запуска одной или некоторых частей кода.
- Комментарии создаются с помощью символа octothorpe (решетка, число, решётка) (#).
- Комментарии, созданные со знаком решетки (#), называются встроенными комментариями. Еготакже называют однострочным комментарием, поскольку он работает только в одной строке.
- Хорошей практикой является использование встроенных комментариев в нижнем регистре и в настоящем времени. в любом случае не надо
# this is an inline comment # print('Hello World')
- Большинство редакторов используют сочетание клавиш для создания встроенного комментария с помощью Ctrl + / (наведите указатель мыши на любое место в текстовом редакторе, которое вы хотите прокомментировать, и используйте сочетание клавиш )
- Также есть комментарий, который называется многострочный комментарий. Это многострочный комментарий, поскольку он может занимать несколько строк (более одной строки).
- Многострочный комментарий создается тремя кавычками
- Он создается тройными одинарными или тройными двойными кавычками в обоих концах текста.
- Тройные одинарные или тройные двойные кавычки, открывающие и закрывающие кавычки должны быть одинаковыми.
''' This is multi-line comments It can span multiple lines It is used for documentation of your code (docstring) '''
- Большинство редакторов используют сочетание клавиш для создания многострочного комментария с помощью Ctrl + Shift + / (наведите указатель мыши на любое место в текстовом редакторе, которое вы хотите прокомментировать, и используйте сочетание клавиш )
Примечание: раскомментируйте что-либо или код (ы), используя сочетание клавиш, используемое для комментирования
Раскомментируйте код ниже и запустите их
# print('Python is lovely') ''' def myname(name): return f'My name is {name}' print(myname('Osagie')) '''
Не беспокойтесь о приведенном выше коде, мы скоро поговорим о нем подробнее.
- Многострочные комментарии в основном используются внутри функции, класса — как минимум в первом коде внутри функции, заголовка класса — после двоеточия (:)
def myname(name): '''Return my name.''' return f'My name is {name}' print(myname('Osagie')) # print(myname.__doc__)
Примечание.
- Строка документации должна начинаться с заглавной буквы и заканчиваться точкой.
- Первая строка должна быть кратким описанием.
- Если в строке документации больше строк, вторая строка должна быть пустой, визуально отделяя сводку от остального описания.
- Следующие строки должны быть одним или несколькими абзацами, описывающими соглашения о вызовах объекта, его побочные эффекты и т. д.