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:

 

php

 

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:

 

php

 

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.

¿Te gustó? Pues comparte ;-)
Este sitio usa cookies para personalizar el contenido y los anuncios, ofrecer funciones de redes sociales y analizar el tráfico. Ninguna cookie será instalada a menos que se desplace exprésamente más de 600px. Leer nuestra Política de Privacidad y Política de Cookies. Las acepto | No quiero aprender cursos gratis. Sácame