¿Son mis nombres de métodos o variables demasiado largos? [cerrado]

14

Así que actualmente estaba en el medio de la codificación, desafortunadamente para mí, estaba en "La Zona" y luego pensé: ¿son mis nombres de variables / métodos demasiado largos?

POP fuera de la Zona a la que voy!

Entonces vine aquí para preguntar, ¿son mis nombres de método / variable demasiado largos? ¡Tú eres el juez! Los puntos de bonificación a cualquiera que pueda descubrir lo que estoy escribiendo, ¡aunque estoy seguro de que un gurú lo resolverá rápidamente!

De todos modos, aquí están algunos de mis nombres de métodos y variables.

Métodos: searchBlockedListForBlockedSquares (),           isCurrentSquareNextToAtLeastOneBlockedSquare (),           searchBlockedListForBlockedSquares ()

Variables: isNextToBlockedSquares;

Supongo que solo había una variable que parecía demasiado larga.

    
pregunta Bryan Harrington 20.11.2010 - 06:23

3 respuestas

28

Sus nombres me parecen bien en términos de longitud. Sin embargo, la forma en que se denominan sugiere que tal vez algunas nuevas clases están en orden?

Por ejemplo, en lugar de searchBlockedListForBlockedSquares() podría tener blockedList.getBlockedSquares() . De forma similar, isCurrentSquareNextToAtLeastOneBlockedSquare() se convierte en currentSquare.isAdjacentToABlockedSquare() .

    
respondido por el Adam Lear 20.11.2010 - 07:02
9

Creo en nombres de variables descriptivos, incluso si eso significa nombres de variables largos. Y con la inteligencia cada vez más popular, no creo que afecte mucho en términos de productividad.

Odio las abreviaturas porque son casi imposibles de usar constantemente. Además, pueden ser ambiguos y hacen las cosas más difíciles de leer. Incluso cuando son parte de un estándar, no me gustan. Además, cuando se trata de eso, no eliminan tantas letras a menos que abrevies mucho. Y abreviar mucho mata la legibilidad.

El problema más grande que introducen los nombres largos es el tiempo que pueden llegar a ser las líneas de código. Llamar a una función con un nombre largo y pasarle dos o tres nombres de variables largos puede formar una larga línea de código. Por eso, trato de mantener mis nombres lo más cortos posible, aunque de nuevo, prefiero tener nombres descriptivos, incluso si eso significa ajustar líneas o desplazarse.

Sin embargo, mirando los nombres de ejemplo, el hecho de que todos terminen con BlockedSquares me hace pensar que parte del nombre puede ser redundante. De hecho, también podría significar que estos elementos se pueden encapsular en su propia clase, probablemente llamada BlockedSquares. Ese cambio hace que los nombres sean un poco más cortos.

    
respondido por el Jeff Siver 20.11.2010 - 07:01
5

Un nombre de variable es la longitud incorrecta cuando no describe claramente su propósito. Eso se aplica a ser demasiado corto o demasiado largo.

Los nombres de variable cortos y concisos pueden ser ambiguos o, lo que es peor, no tienen relación con lo que es la variable. En los días de BASIC interpretado, estábamos limitados por el intérprete a dos nombres de caracteres. Fue muy difícil encontrar nombres significativos en un programa grande. Los nombres de las variables de una sola letra se usan a menudo para for-loops y contadores, pero creo que deberían evitarse de otra manera. for (i = 0; i < 10; i++) {...} usa i y eso es bastante común. j es un nombre de variable secundaria.

Los nombres de variables largos son demasiado largos cuando se vuelven largos o están llenos de palabras vacías, haciéndolos más largos de lo necesario. Si tengo un montón de variables con nombres similares, trataré de eliminar las partes comunes que son prescindibles y mantendré las partes de los nombres que lo identifican de forma única.

Habría llamado " isCurrentSquareNextToAtLeastOneBlockedSquare " a currentSquareNextToBlockedSquare? , si lo estuviera haciendo en Ruby.

    
respondido por el the Tin Man 20.11.2010 - 07:02

Lea otras preguntas en las etiquetas