La Sentencia :keyword:`if`

La Sentencia :keyword:`if`
===============

Tal vez el tipo más conocido de sentencias sea la sentencia :keyword:`if`. Por ejemplo:

>>> x = int(raw_input("Ingresá un entero, por favor: "))
>>> if x < 0:
...      x = 0
...      print 'Negativo cambiado a cero'
... elif x == 0:
...      print 'Cero'
... elif x == 1:
...      print 'Simple'
... else:
...      print 'Mas'
...

Puede haber cero o más bloques :keyword:`elif`, y el bloque :keyword:`else` es opcional. La palabra reservada ':keyword:`elif`' es una abreviación de 'else if', y es útil para evitar identación excesiva. Una secuencia :keyword:`if` ... :keyword:`elif` ... :keyword:`elif` ... sustituye las sentencias switch o case encontradas en otros lenguajes.

La Sentencia :keyword:`for`

La Sentencia :keyword:`for`
================

.. index::
   statement: for
   statement: for

La sentencia :keyword:`for` en Python difiere un poco de lo que uno puede estar acostumbrado en lenguajes como C o Pascal. En lugar de siempre iterar sobre una progresión aritmética de números (como en Pascal) o darle al usuario la posibilidad de definir tanto el paso de la iteración y condición de fin (como en C), la sentencia :keyword:`for` de Python itera sobre los items de cualquier secuencia (una lista o una cadena de texto), en el orden que aparecen en la secuencia. Por ejemplo (no pun intended):

>>> # Midiendo cadenas de texto
... a = ['cat', 'window', 'defenestrate']
>>> for x in a:
...     print x, len(x)
...
cat 3
window 6
defenestrate 12

No es seguro modificar la secuencia sobre la que se está iterando en el loop (esto solo es posible para tipos de secuencias mutables, como las listas). Si se necesita modificar la lista sobre la que se está iterando (por ejemplo, para duplicar items seleccionados) se debe iterar sobre una copia. La notación de rebanada es conveniente para esto:

>>> for x in a[:]: # hacer una copia por rebanada de toda la lista
...    if len(x) > 6: a.insert(0, x)
...
>>> a
['defenestrate', 'cat', 'window', 'defenestrate']

La Función :func:`range`

La Función :func:`range`
==============

Si se necesita iterar sobre una secuencia de números, es apropiado utilizar la función incorporada :func:`range`. Genera una lista conteniendo progresiones aritméticas:

>>> range(10)
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]

El valor final dado nunca esparte de la lista; range(10) genera una lista de 10 valores, los índices correspondientes para los items de una secuencia de longitud 10. Es posible hacer que el rango empiece con otro número, o especificar un incremento diferente (incluso negativos; algunas veces se lo llama 'paso'):

>>> range(5, 10)
[5, 6, 7, 8, 9]
>>> range(0, 10, 3)
[0, 3, 6, 9]
>>> range(-10, -100, -30)
[-10, -40, -70]

Para iterar sobre los índices de una secuencia, se combina :func:`range` y :func:`len` así:

>>> a = ['Mary', 'had', 'a', 'little', 'lamb']
>>> for i in range(len(a)):
...     print i, a[i]
...
0 Mary
1 had
2 a
3 little
4 lamb

Las Sentencias :keyword:`break` y :keyword:`continue`, y la Cláusula :keyword:`else` en Loops

Las Sentencias :keyword:`break` y :keyword:`continue`, y la Cláusula :keyword:`else` en Loops
=========================================================================================

La sentencia :keyword:`break`, como en C, termina el loop :keyword:`for` o :keyword:`while` más anidado.

La sentencia :keyword:`continue`, también tomada prestada de C, continua con la próxima iteración del loop.

Las sentencias de loop pueden tener una cláusula else; es ejecutada cuando el loop termina luego de agotar la lista (con :keyword:`for`) o cuando la condición se hace falsa (con :keyword:`while`), pero no cuando el loop es terminado con la sentencia :keyword:`break`. Se ejemplifica en el siguiente loop, que busca números primos:

>>> for n in range(2, 10):
...     for x in range(2, n):
...         if n % x == 0:
...             print n, 'es igual a ', x, '*', n/x
...             break
...     else:
...         # sigue el bucle sin encontrar un factor
...         print n, 'es un numero primo'
...
2 es un numero primo
3 es un numero primo
4 es igual a 2 * 2
5 es un numero primo
6 es igual a 2 * 3
7 es un numero primo
8 es igual a 2 * 4
9 es igual a 3 * 3

La Sentencia :keyword:`pass`

La Sentencia :keyword:`pass`
==================

La sentencia :keyword:`pass` no hace nada. Se puede usar cuando una sentencia es requerida por la sintáxis pero el programa no requiere ninguna acción. Por ejemplo:

>>> while True:
...       pass # Espera ocupada hasta iterrupción de teclado
...

Definiendo funciones

Definiendo funciones
=============

Podemos crear una función que escriba la serie de Fibonacci hasta una límite determinado:

>>> def fib(n):    # escribe la serie de Fibonacci hasta n
...     """Escribe la serie de Fibonacci hasta n."""
...     a, b = 0, 1
...     while b < n:
...         print b,
...         a, b = b, a+b
...
>>> # Ahora llamamos a la funcion que acabamos de definir:
... fib(2000)
1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597

.. index::
   single: documentation strings
   single: docstrings
   single: strings, documentation

La palabra reservada :keyword:`def` de una para definir funciones. Debe seguirle el nombre de la función y la lista de parámetros formales entre paréntesis. Las sentencias que forman el cuerpo de la función empiezan en la línea siguiente, y deben estar identadas. La primer sentencia del cuerpo de la función puede ser opcionalmente una cadena de texto literal; esta es la cadena de texto de documentación de la función, o :dfn:`docstring`.

Hay herramientas que usan las docstrings para producir automáticamente documentación en línea o imprimible, o para permitirle al usuario que navegue el código en forma interactiva; es una buena práctica incluir docstrings en el código que uno escriba, así que se debe intentar hacer un hábito de esto.

La ejecución de una función introduce una nueva tabla de símbolos usada para las variables locales de la función. Más precisamente, todas las asignaciones de variables en la función almacenan el valor en la tabla de símbolos local; así mismo la referencia a variables primero mira la tabla de símbolos local, luego en la tabla de símbolos local de las funciones externas, luego la tabla de símbolos global, y finalmente la tabla de nombres predefinidos. Así, no se les puede asignar directamente un valor a las variables globales dentro de una función (a menos se las nombre en la sentencia :keyword:`global`), aunque si pueden ser referenciadas.

Los parámetros reales (argumentos) de una función se introducen en la tabla de símbolos local de la función llamada cuando esta es llamada; así, los argumentos son pasados por valor (dónde el valor es siempre una referencia a un objeto, no el valor del objeto). [1] Cuando una función llama a otra función, una nueva tabla de símbolos local es creada para esa llamada.

La definición de una función introduce el nombre de la función en la tabla de símbolos actual. El valor del nombre de la función tiene un tipo que es reconocido por el interprete como una función definida por el usuario. Este valor puede ser asignado a otro nombre que luego puede ser usado como una función. Esto sirve como un mecanismo general para renombrar:

>>> fib
<function fib at 10042ed0>
>>> f = fib
>>> f(100)
1 1 2 3 5 8 13 21 34 55 89

Se puede objetar que fib no es una función, sino un procedimiento. En Python, como en C, los procedimientos son solo funciones que no retornan un valor. De hecho, técnicamente hablando, los procedimientos si retornan un valor, aunque uno aburrido. Este valor es llamada None (es un nombre predefinido). El intérprete por lo general no escribe el valor None si va a ser el único valor escrito. Si realmente se quiere, se puede verlo usando :keyword:`print`:

>>> fib(0)
>>> print fib(0)
None

Es simple escribir una función que retorne una lista con los números de la serie de Fibonacci en lugar de imprimirlos:

>>> def fib2(n): # retorna la seri de Fibonacci hasta n
...     """Retorna una lista conteniendo la serie de Fibonacci hasta n."""
...     result = []
...     a, b = 0, 1
...     while b < n:
...         result.append(b)    # ver abajo
...         a, b = b, a+b
...     return result
...
>>> f100 = fib2(100)    # llamarla
>>> f100                # escribir el resultado
[1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]

Este ejemplo, como es usual, demuestra algunas características más de Python:

• La sentencia :keyword:`return` devuelve un valor en una función. :keyword:`return` sin una expresión como argumento retorna None. Si se alcanza el final de un procedimiento, también se retorna None.

  System Message: ERROR/3 (<string>, line 262); backlink

  Unknown interpreted text role "keyword".

  System Message: ERROR/3 (<string>, line 262); backlink

  Unknown interpreted text role "keyword".

• La sentencia result.append(b) llama al método del objeto lista result. Un método es una función que 'pertenece' a un objeto y se nombra obj.methodname, dónde obj es algún objeto (puede ser una expresión), y methodname es el nombre del método que está definido por el tipo del objeto. Distintos tipos definen distintos métodos. Métodos de diferentes tipos pueden tener el mismo nombre sin causar ambigüedad. (Es posible definir tipos de objetos propios, y métodos, usando clases, como se discutirá más adelante en el tutorial). El método :meth:`append` mostrado en el ejemplo está definido para objetos lista; añade un nuevo elemento al final de la lista. En este ejemplo es equivalente a result = result + [b], pero más eficiente.

  System Message: ERROR/3 (<string>, line 266); backlink

  Unknown interpreted text role "meth".

Más sobre Definición de Funciones

Más sobre Definición de Funciones
==========================

También es posible definir funciones with un número variable de argumentos. Hay tres formas que pueden ser combinadas.

def ask_ok(prompt, retries=4, complaint='Yes or no, please!'):
    while True:
        ok = raw_input(prompt)
        if ok in ('y', 'ye', 'yes'): return True
        if ok in ('n', 'no', 'nop', 'nope'): return False
        retries = retries - 1
        if retries < 0: raise IOError, 'refusenik user'
        print complaint

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

def f(a, L=[]):
    L.append(a)
    return L
print f(1)
print f(2)
print f(3)

[1]
[1, 2]
[1, 2, 3]

def f(a, L=None):
    if L is None:
        L = []
    L.append(a)
    return L

def parrot(voltage, state='a stiff', action='voom', type='Norwegian Blue'):
    print "-- This parrot wouldn't", action,
    print "if you put", voltage, "volts through it."
    print "-- Lovely plumage, the", type
    print "-- It's", state, "!"

parrot(1000)
parrot(action = 'VOOOOOM', voltage = 1000000)
parrot('a thousand', state = 'pushing up the daisies')
parrot('a million', 'bereft of life', 'jump')

parrot()                     # falta argumento obligatorio
parrot(voltage=5.0, 'dead')  # argumento no-de palabra clave seguido de uno que si
parrot(110, voltage=220)     # valor duplicado para argumento
parrot(actor='John Cleese')  # palabra clave desconocida

>>> def function(a):
...     pass
...
>>> function(0, a=0)
Traceback (most recent call last):
  File "<stdin>", line 1, in ?
TypeError: function() got multiple values for keyword argument 'a'

def cheeseshop(kind, *arguments, **keywords):
    print "-- Do you have any", kind, '?'
    print "-- I'm sorry, we're all out of", kind
    for arg in arguments: print arg
    print '-'*40
    keys = keywords.keys()
    keys.sort()
    for kw in keys: print kw, ':', keywords[kw]

cheeseshop('Limburger', "It's very runny, sir.",
           "It's really very, VERY runny, sir.",
           client='John Cleese',
           shopkeeper='Michael Palin',
           sketch='Cheese Shop Sketch')

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

.. index::
  statement: *

def fprintf(file, template, *args):
    file.write(template.format(args))

.. index::
  statement: **

>>> def make_incrementor(n):
...     return lambda x: x + n
...
>>> f = make_incrementor(42)
>>> f(0)
42
>>> f(1)
43

.. index::
   single: docstrings
   single: documentation strings
   single: strings, documentation

>>> def my_function():
...     """No hace mas que documentar la funcion.
...
...     No, de verdad. No hace nada.
...     """
...     pass
...
>>> print my_function.__doc__
No hace mas que documentar la funcion.
No, de verdad. No hace nada.

Intermezzo: Estilo de Codificación

Intermezzo: Estilo de Codificación
========================

.. sectionauthor:: Georg Brandl <georg@python.org>

.. index:: pair: coding; style

Ahora que estás a punto de escribir piezas de Python más largas y complejas, es un buen momento para hablar sobre estilo de codificación. La mayoría de los lenguajes pueden ser escritos (o mejor dicho, formateados) con diferentes estilos; algunos son mas fáciles de leer que otros. Hacer que tu código sea más fácil de leer por otros es siempre una buena idea, y adoptar un buen estilo de codificación ayuda tremendamente a lograrlo.

Para Python, PEP 8 se erigió como la guía de estilo a la que más proyectos adhirieron; promueve un estilo de codificación fácil de leer y amable con los ojos. Todos los desarrolladores Python deben leerlo en algún momento; aquí están extraídos los puntos más importantes:

• Usar identación de 4 espacios, no tabs.

  4 espacios son un buen compromiso entre identación pequeña (permite mayor nivel de identación) e identación grande (más fácil de leer). Los tabs introducen confusión y es mejor dejarlos de lado.

• Recortar las líneas para que no superen los 79 caracteres.

  Esto ayuda a los usuarios con pequeñas pantallas y hace posible tener varios archivos de código abiertos, uno al lado del otro, en pantallas grandes.

• Usar líneas en blanco para separar funciones y clases, y bloques grandes de código

  dentro de funciones.

• Cuando sea posible, poner comentarios en una sola línea.

• Usar docstrings.

• Usar espacios alrededor de operadores y luego de las comas, pero no directamente

  dentro de paréntesis: a = f(1, 2) + g(3, 4).

• Nombrar las clases y funciones consistentemente; la convención es usar

  NotacionCamello para clases y minusculas_con_guiones_bajos para funciones

  System Message: WARNING/2 (<string>, line 608)

  Definition list ends without a blank line; unexpected unindent.

  y métodos. Siempre usar self como el nombre para el primer argumento en los métodos.

• No usar codificaciones estrafalarias si se espera usar el código en entornos

  internacionales. ASCII plano funciona bien en la mayoría de los casos.

Footnotes