Identificadores mnemotécnicos, específicos y precisos

5/26
Recursos
Transcripción

Los identificadores son variables, funciones, clases, módulos, componentes, etc. Elementos a los que nosotros debamos crearles un nombre propio.

Ejemplo sin un identificador mnemotécnico una función se vería así:

function f( int $b, int $a ) : float {
        return ( $b * $a ) / 2;
}

Al leer este código no sabemos para qué funciona y hasta podríamos borrarlo por equivocación.

Ahora utilizando un identificador mnemotécnico se vería así:

function areaRectangulo( int $base, int $altura ) : float {
        return ( $base * $altura ) / 2;
}

Ahora gracias a que el código es más legible sabemos para qué funciona esta función.

Atención a los identificadores que estableces.

Aportes 53

Preguntas 2

Ordenar por:

¿Quieres ver más aportes, preguntas y respuestas de la comunidad? Crea una cuenta o inicia sesión.

1 hora para poner el nombre a la variable o función.
5 minutos para crear la funcionalidad requerida.
😃

En el primer ejemplo dice que es la sucesión de fibonacci pero en realidad lo que hace es calcular el factorial de un número, led dejo las funciones para calcular el factorial y la serie de fibonacci.

def fac(num):
	if (num==0 or num==1):
		return 1
	else:
		return num*fac(num-1)

def fibonacci(num):
	if (num==1 or num==2):
		return 1
	else:
		return fibonacci(num -1) + fibonacci(num-2)
	
print(fac(5))
print(fibonacci(10))```

La Sucesión de Fibonacci 😃

int fibonacci(int number){
	if(number < 2){
		return number;
	}else{
		return fibonacci(number - 1) + fibonacci(number - 2)
	}
}

100% de acuerdo, me puse a ver mis scripts anteriores 2008-2013 de bash y de redes, para nada entendibles, pero ahora que estoy en esto de la programacion full, entiendo mas que nunca la necesidad de usar un estandar.

Pasar 10 minutos haciendo el procedimiento de tu función, pero pasar una hora pensando en el nombre de la misma.
Suele pasar 😅

Poner mal los nombres es un problema, porque luego te pasa que te encuentras esa función y dices: “¿Por qué estoy calculando el área de un rectángulo? Si necesito la de un triángulo, como sea ,por algo será” y la dejas ahí por miedo a modificarlo y romper el código xD

Igual nombrar algo es difícil, yo lo que hago es preguntarme: “¿Qué es lo que esta función hace?” y con base en esa pregunta tratar de llegar a un nombre

Los identificadores deben ser legibles y entendibles rapidamente.

 var area = await context.Areas.FindAsync(id);
 var datoExiste = area == null;

Veo que no hablo mucho de los comentarios y documentación del código. Pero creo que eso también hacer parte de la legibilidad del código.

Como pequeño dato las variables que son llamadas de la forma como se muestran (areaRectangulo) se le conoce notación de camello(CamelCase).

String Nombredelamesaquesevaavender = " ";

jajajaja

Identificadores mnemotécnicos, específicos y precisos


💡 Recuerda: Atención a los identificadores que creas, es importante que estos sean explicativos y podamos entender que es lo que hacen o contiene.

areaTriangulo = areaRectangulo

maldaaaaaaad!

😂 Lo dejaré por aquí…

Es buena práctica escribir nombres de las funciones en español? o siempre debe ser ingles preferentemente?

Buena practiva pedir a un compañero que te lea el codigo y explique, para saber si realmente estamos haciendo un codigo entendible.

Notas: Problemas difíciles en la programación son es invalidar chaces y Nombrar cosas. Nos enfocaremos en el segundo en el curso.
Identificador: puede ser una variable, clases, funciones, módulos, componentes, etc. son cualquier cosa que creamos en el código. Tenemos que realizar bien los nombres de lo que declaramos. Los nombres tienen que ver con lo que va ser la función o para que se van a utilizar los nombres de las cosas.
Recuerda que debes tener en cuenta los identificadores en la evolución del código pues estos también deben de evolucionar.

El code review en estos casos en muy útil

Siempre siempre hay que tener en cuenta el estandar de programación del equipo o empresa en el que estemos trabajando y si no existe proponerlo. En una ocasión me topé con variables aabaa o ccdcc para referirse a contadores que podrían ser facilmente reemplazados por variables correctamente nombradas.

Un truco para eso es no tener miedo de los nombres largos de las variables, dado que estas tienen que mostrarse lo más cercanas a la realidad.

Como buena práctica los nombres de las variables deben de ser representativos.

Se convierte en el provicional permanente

Recomendación: Que el código este escrito en un único lenguaje y no en Espanglish como en los ejemplos

// funciona bien si quita los paréntesis
return $base * altura / 2

Si es buena técnica, por que sino toda revisar de punta a punta haber que realiza la función, pero adicionalmente, creo que es recomendable describir encima del metodo y de la clase que hace, qué parámetros recibe, entre otras cosas.

Totalmente cierto, me pasa a menudo

mnemotécnico=Que sirve para ayudar a la memoria a retener una cosa.

Excelente ejemplos y muy claros para entender la importancia de nombrar correctamente metodos y variables

Me gusta ver los ejemplos con código

Sorry pero en Ruby manejar chache es un amor xD

function fibonacci(int $elemento): int
    {
        if ($elemento==0 || $elemento==1){
            return $elemento;
        } 
        elseif ($elemento==2) {
            return 1;
        }
        else {
            return 2*fibonacci($elemento-2)+fibonacci($elemento-3);
        }
    }```

Excelente recomendación para una buena legibilidad del código

Esto pasa mucho con el apuro de entregar una tarea, siempre decimos: solo para ejecutar el código, después le cambio el nombre. Y se queda en un MientrasPaSiempe.

Los identificadores son variables, funciones, clases, modulos, componenes, etc.

Cada variable debe tener un significado y debe ser claro para que a la hora de leerlo no tenga problemas

  1. Identificadores
    Son los nombres que damos a objetos, variables y funciones

Modificar los identificadores segun vas cambiando tu codigo, para no dejar nombres sin sentido en sitios que hacen diferentes funciones

Identificador: nombre que le pones a los componentes, funciones, variables, etc. que creas en el código.

Las variables deben significar algo para el desarrollador

Todo muy claro. Gracias

nota de la clase cuando el código vaya evolucionando los identificadores tienen que ir evolucionando con el…

pasa que cambiamos todo el codigo pero mantenemos nombre que no hacen referencia a lo que actualmente hacemos

Aprendiendo nuevos términos, me encanta.

Buena la sugerencia de poner a otro a leer el código de uno y si explica lo que uno quiere hacer con este, estuvo bien escrito. Si expresa algo diferente es que no fuimos claro escribiendo nuestra rutina

Importante

  • Codigo auto-descriptivo
  • Atencion con los identificadores(Nombres de variables, funciones, modulos, etc)
<h3>Tip</h3>

Pidele a un amigo que lea tu codigo y te lo explique para saber si quizas hay algo que no este claro.

mnemotécnica
Una regla mnemotécnica es una oración corta y fácil de recordar que ayuda de manera artificiosa a relacionar palabras, con el objetivo de memorizar conceptos con más facilidad.

En Ishikawa, Japón, un equipo de supervisión de radiación falló a medianoche, pero los funcionarios dijeron que no había ningún riesgo para el público.

En Onagawa, Japón, una alarma sonó en una planta de energía atómica dos minutos después de la medianoche.

En Japón, dos minutos después de la medianoche, Osaka Media Port, una compañía de telecomunicaciones, encontró errores en el manejo de las fechas en parte de la red de la compañía. El problema fue arreglado a las 2:43 a.m. y no se interrumpió ningún servicio.

cuando el código va evolucionando, los identificadores también tienen que ir evolucionando

Buen tip el de pedirle a alguien que nos explique el código debería ser fácil de entender

LINTER, is a static code analysis tool used to flag programming errors, bugs, stylistic errors, and suspicious constructs

Identificadores:
Un nombre que no existe en el lenguaje que estás usando, y que lo estás creando en tu código.

_Ejemplo: _
variable, función, clase, módulo, componente.

ATENCIÓN : A los identificadores que creas…
Cuando el código evoluciona, los identificadores tienen que evolucionar también.

Técnica: Pedir a un compañero de código que lea el código y te diga si puede leerlo sin dificultades o no, si te dice que no, ya sabes que tienes cosas para mejorar.

Identificadores: Un nombre que no existe en el lenguage de programacion y que vamos creando. (variables, funciones, clases,
modulo, componente o cualquier cosa que tengamos que crear nosotros mismos en el codigo)

Tener Identificadores descriptivos.

Identificador: nombre que no existe, pero que lo irás identificando, como :

  • Variables
    Funciones
    Clases
    Módulos
    Componente.

Cualquier cosa que tenga que crear en un código.

De lo poco que recuerdo al programar, siempre tenía esto presente. Sin duda es importante y esta clase lo deja más que claro.

CamelCase es un estilo de escritura que se aplica a frases o palabras compuestas. El nombre se debe a que las mayúsculas a lo largo de una palabra en CamelCase se asemejan a las jorobas de un camello. El nombre CamelCase se podría traducir como Mayúsculas/Minúsculas Camello.

Puede usare el estilo CamelCase para nombrar de mejor manera tus funciones y variables