Instrucción Python, Sangría y Comentarios

Instrucción Python

Las instrucciones que un intérprete Python puede ejecutar se denominan instrucciones. Por ejemplo, a = 1 es una instrucción de asignación. if declaración, for declaración, while declaración, etc. son otros tipos de declaraciones que se discutirán más adelante.

Instrucción multilínea

En Python, el final de una instrucción está marcado por un carácter de nueva línea. Pero podemos hacer que una instrucción se extienda sobre varias líneas con el carácter de continuación de línea (\). Por ejemplo:

a = 1 + 2 + 3 + \ 4 + 5 + 6 + \ 7 + 8 + 9

Esta es una continuación de línea explícita. En Python, la continuación de línea está implícita dentro de paréntesis ( ), corchetes y llaves { }. Por ejemplo, podemos implementar la instrucción multilínea anterior como:

a = (1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9)

Aquí, los paréntesis circundantes () hacen la continuación de la línea implícitamente. Lo mismo ocurre con and { }. Por ejemplo:

colors = 

También podemos poner varias sentencias en una sola línea usando punto y coma, de la siguiente manera:

a = 1; b = 2; c = 3

Sangría de Python

La mayoría de los lenguajes de programación como C, C++ y Java usan llaves { } para definir un bloque de código. Python, sin embargo, usa sangría.

Un bloque de código (cuerpo de una función, bucle, etc.) comienza con sangría y termina con la primera línea sin sangría. La cantidad de sangría depende de usted, pero debe ser consistente a lo largo de ese bloque.

Generalmente, se utilizan cuatro espacios en blanco para la sangría y se prefieren a las pestañas. He aquí un ejemplo.

for i in range(1,11): print(i) if i == 5: break

La aplicación de sangría en Python hace que el código se vea limpio y ordenado. Esto da como resultado programas de Python que se ven similares y consistentes.

La sangría se puede ignorar en la continuación de línea, pero siempre es una buena idea sangrar. Hace que el código sea más legible. Por ejemplo:

if True: print('Hello') a = 5

y

if True: print('Hello'); a = 5

ambos son válidos y hacen lo mismo, pero el estilo anterior es más claro.

Incorrecto sangría resultará en un IndentationError.

Los comentarios son muy importantes al escribir un programa. Describen lo que está sucediendo dentro de un programa, para que una persona que mira el código fuente no tenga dificultades para averiguarlo.

Es posible que olvide los detalles clave del programa que acaba de escribir en un mes. Por lo tanto, tomarse el tiempo para explicar estos conceptos en forma de comentarios siempre es fructífero.

En Python, usamos el símbolo hash ( # ) para comenzar a escribir un comentario.

Se extiende hasta el carácter de nueva línea. Los comentarios son para que los programadores entiendan mejor un programa. El intérprete de Python ignora los comentarios.

#This is a comment#print out Helloprint('Hello')

Podemos tener comentarios que se extienden hasta varias líneas. Una forma es usar el símbolo hash (#) al principio de cada línea. Por ejemplo:

#This is a long comment#and it extends#to multiple lines

Otra forma de hacer esto es usar comillas triples, ya sea «‘ o «»».

Estas comillas triples se utilizan generalmente para cadenas de varias líneas. Pero también se pueden usar como comentario de varias líneas. A menos que no son docstrings, no generan ningún código adicional.

"""This is also aperfect example ofmulti-line comments"""

Para obtener más información sobre los comentarios, visite Comentarios de Python.

Docstrings en Python

Una docstring es la abreviatura de cadena de documentación.

Las cadenas de documentos de Python (cadenas de documentación) son los literales de cadena que aparecen justo después de la definición de una función, método, clase o módulo.

Las comillas triples se utilizan al escribir cadenas de documentos. Por ejemplo:

def double(num): """Function to double the value""" return 2*num

Docstrings aparecen justo después de la definición de una función, clase, o un módulo. Esto separa las cadenas de documentos de los comentarios multilínea usando comillas triples.

Las cadenas de documentos están asociadas con el objeto como atributo __doc__.

Así, podemos acceder a los docstrings de la función anterior con las siguientes líneas de código:

def double(num): """Function to double the value""" return 2*numprint(double.__doc__)

Salida

Function to double the value

Para saber más acerca de los docstrings en Python, visite Python Docstrings.