El Estilo. Comentario
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:
<?php
$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.
