LOS COMENTARIOS
Continuando con el estilo y la estandarización,
debemos hablar sobre una de las armas de entendimiento más
fabulosas que los lenguajes de programación (incluyendo PHP,
claro está) tienen: LOS COMENTARIOS.
La razón de la existencia de los comentarios
estriba en la importancia de mantener el flujo de nuestro programa
bien documentado, de tal manera que, si otro programador llega y pretende
continuar o añadir algo a nuestro programa, pueda, gracias
a los comentarios, enterarse de los procesos, variables y estructuras
de control que existen en nuestro programa, a la par de saber para
qué sirve cada una de éstas.
Los comentarios en PHP pueden hacerse de dos formas,
ambas al estilo C/C++, es decir: los comentarios de línea,
que se hacen añadiendo al final de cada línea de código
los caracteres // más el respectivo comentario y los comentarios
multilínea, es decir que abarcan más de una línea
de nuestro programa, que inician con /* y terminan */, este comentario
puede abarcar más de una línea.
Imaginemos el siguiente programa:
<?php
$a = 15.55;
function calculo($a){
$m = 0.13;
return $f = ($a * $m) + $a;
}
echo "El precio final del producto
es: ".calculo($a);
echo "Gracias por su compra<BR>";
echo "Vuelva Pronto!";
?>
El programa anterior produce una salida del siguiente tipo:
El programa obviamente cumple con su función, pero comparemos
la siguiente adición:
$a = 15.55; //variable que representa
el precio original del producto sin impuesto
function calculo($a){ //función
que calcula el precio final del producto, con todo e impuesto
$m = 0.13; //variable que guarda
el porcentaje del impuesto que se aplicará
return $f = ($a * $m) + $a; //cálculo
del impuesto al producto y retorno del valor al cuerpo del programa
}
echo "El precio final del producto
es: ".calculo($a)."<BR>"; //Impresión
en pantalla del precio final del producto
echo "Gracias por su compra<BR>";
//Despedida
echo "Vuelva Pronto!";
//Despedida
?>
La salida es exactamente la misma, es decir:
Lo cual nos da a entender que los comentarios no cambian
en lo absoluto los resultados del programa, pero nos dan una idea clara
de lo que cada una de las líneas de código de nuestro
programa hacen.
En nuestro siguiente encuentro hablaremos de lo que
significa la estandarización en nuestro programas, por el momento,
por favor recuerden que la vida es bella y que los programas son hermosos,
es decir, ¡A vivir y a Programar!, hasta pronto.
