Diferencia entre revisiones de «Plantilla:ManuelRomero/PHP/funcionesIntroduccion»

Declaración de funciones

// Declarar una función
function nombre_de_funcion([tipo_de_parametro] $parametro_formal[=valor_por_defecto], ...)[: tipo_retorno]
{
    ...
    [return ...];
}
 
// Llamar
nombre_de_funcion($parametro_real);

• Es importante diferenciar entre declarar una función e invocar una función.
• Aunque parece obvio, es un punto importante.
• En la declaración de una función, tenemos tres partes:

1.-Nombre o identificación de la función

• • El nombre de la función es un identificador que empieza por una letra o guion bajo, seguido de 0 o más letras, números o guiones bajos.

[a-zA-Z_f_][a-zA-Z0-9_]*

2.-Parámetros formales

• • Se especifican entre paréntesis. (Los paréntesis son necesarios, aunque no haya parámetros).
  • Se puede (debe) especificar el tipo de cada parámetro (a partir de la versión 7.2). (Type hiding)
  • Se puede incluso especificar diferentes tipos en cada parámetro (Union Type). En este caso se separa por comas

//Función que solo recibe datos de tipo int o string
//Me muestra el dato y su tipo
function mostrar_datos(int|string $dato): string
{
    $tipo = gettype($dato);
    return "<h1>El dato $dato es de tipo $tipo</h1>";
}

• • Se puede asignar un valor por defecto (si un parámetro tiene valor por defecto, no es obligatorio proporcionarle un valor en la invocación).

function saludar(string $nombre = "Invitado"): string
{
    return "<h1>Hola $nombre, bienvenido a nuestro sitio web</h1>";
}

• • El hecho de poder dar valores por defecto, nos permitirá sobrecargar una función, es decir, que según el número y tipo de los parámetros, pueda hacer una acción/es u otra/s.

3.-Tipo de retorno

• • Tambien se puede especificar que la función retorna diferentes valores

function sumar(int|float $a, int|float $b): int|float
{
    return $a + $b;
}

1. El cuerpo de la función. Dentro de él puede estar la instrucción `return`, la cual finaliza la ejecución de la función y devuelve el flujo al programa, a la instrucción que llamó a la función.
2. return puede (o debe) devolver el valor que queremos que la función retorne.

Identificador de función

Parámetros formales

• Son nombres de variables que usaremos al escribir el código o cuerpo de la función.
• El nombre debe ser significativo y se convertirán en variables locales a la función.
• Al finalizar la función, estas variables se eliminan de la memoria.

Parámetros formales

Los parámetros formales son variables locales a la función.

• Una posible solución

    <?php
       function a($a, $b){
           echo "Dentro de la función visualizando valores <hr />";
           echo "Valor de los parámetros \$a = $a \$b = $b <br />";
           $a += 5;
           $b += 5;
           echo "Valor de los parámetros \$a = $a \$b = $b <br />";
           echo "Salgo de la función";
       }
       //Programa principal
       $a = 100;
       $b = 200;
       echo "En el main antes de invocar la función visualizando variables<hr />";
       echo "Valor de variables \$a = $a \$b = $b <br />";
       a($a, $b);
       echo "En el main después de invocar la función visualizando variables<hr />";
       echo "Valor de variables \$a = $a \$b = $b <br />";
?>

Parámetros formales: Valores y referencias

• Como hemos visto, los parámetros formales reciben valores pasados en la invocación de la función.
• Si queremos que la función pueda modificar el valor de los parámetros, debemos pasarlos **por referencia**.
• Esto permite que se pase la dirección de memoria donde se guarda el valor, en lugar del valor en sí.
• En PHP no podemos visualizar ni operar con la dirección de memoria, ya que no existe la aritmética de punteros.

Parámetros formales

Valores y referencias

Para pasar el parámetro por referencia, simplemente coloca el símbolo & antes del nombre de la variable en la declaración de los parámetros:

function nombre_funcion(&$paramRef1, &$paramRef2, $paramVal1){
   ...
}

Invocando funciones

• Una vez creada una función, se puede invocar como si fuera una instrucción.
• No sin razón, en ciertos contextos se refiere a funciones como "instrucciones virtuales".
• En PHP, puedes invocar una función antes de declararla, siempre que esté en el mismo archivo.

Variables dentro de una función

• Dentro de una función, las variables que declaremos son **locales** a esa función.
• No se puede acceder a su valor fuera de la función.
• Esto también implica que dentro de una función no se puede acceder al valor de una variable definida fuera de la función.
• Observa el siguiente ejemplo:

<?php
 
function modifica_valor(){
    echo "Valor de <b>var1</b> dentro de la función: -$var1- <br />";
    $var1++;
    echo "Valor de <b>var1</b> dentro de la función, modificado: -$var1- <br />";
}
 
$var1 = 20;
 
echo "Valor de <b>var1</b> en el programa principal antes de invocar la función: -$var1- <br />";
modifica_valor();
echo "Valor de <b>var1</b> en el programa principal después de invocar la función: -$var1- <br />";
?>

• Genera la siguiente salida:

Valor de var1 en el programa principal antes de invocar la función: -20- 
Valor de var1 dentro de la función: -- 
Valor de var1 dentro de la función, modificado: -1- 
Valor de var1 en el programa principal después de invocar la función: -20-

• Si queremos acceder al valor de $var1 dentro de la función, podemos usar la palabra reservada global:

<?php
 
function modifica_valor(){
    global $var1; // Indicamos que esta variable se puede usar globalmente.
    echo "Valor de <b>var1</b> dentro de la función: -$var1- <br />";
    $var1++;
    echo "Valor de <b>var1</b> dentro de la función, modificado: -$var1- <br />";
}
 
$var1 = 20;
 
echo "Valor de <b>var1</b> en el programa principal antes de invocar la función: -$var1- <br />";
modifica_valor();
echo "Valor de <b>var1</b> en el programa principal después de invocar la función: -$var1- <br />";
?>

• Ahora, observamos que el valor dentro de la función se puede acceder y modificar.

Valor de var1 en el programa principal antes de invocar la función: -20- 
Valor de var1 dentro de la función: -20- 
Valor de var1 dentro de la función, modificado: -21- 
Valor de var1 en el programa principal después de invocar la función: -21-