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

Предполагается, что на вашем компьютере установлен 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__)

Примечание.

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