Convenciones de nomenclatura

Parte de la sección Fundamentos del Journey de C++ de Coddy — lección 12 de 74.

En programación, es importante seguir las convenciones de nomenclatura para que el código sea legible y fácil de mantener. Sin embargo, existen algunas reglas y convenciones que debes seguir al nombrar elementos en C++:

Los nombres pueden contener letras, dígitos y guiones bajos.
Los nombres deben comenzar con una letra o un guion bajo.

Los nombres distinguen entre mayúsculas y minúsculas (myVariable y myvariable son diferentes).
Los nombres no pueden ser palabras clave de C++ (como int, float, if, etc.).

Además de estas reglas, existen algunas convenciones de nomenclatura comunes que los desarrolladores utilizan para que su código sea más consistente y legible:

camelCase — las palabras se unen, y cada palabra después de la primera comienza con una letra mayúscula (p. ej., totalAmount, numberOfStudents). Comúnmente utilizado para nombres de variables y funciones en C++.
PascalCase — similar a camelCase, pero la primera palabra también comienza con una letra mayúscula (p. ej., TotalAmount, MyClass). Comúnmente utilizado para nombres de clases en C++.

snake_case — las palabras están todas en minúsculas y separadas por guiones bajos (p. ej., total_amount, number_of_students). A menudo se utiliza en C++ para nombres de archivos o en otros lenguajes como Python.
SCREAMING_SNAKE_CASE — como snake_case pero todo en mayúsculas (p. ej., MAX_SIZE, TOTAL_AMOUNT). Típicamente se utiliza para constantes y macros en C++.

Sé descriptivo y evita nombres excesivamente cortos (por ejemplo, numberOfStudents es mejor que n).
Evita el uso de nombres de variables de una sola letra, excepto para contadores simples (por ejemplo, i, j, k).

Aquí hay algunos ejemplos de nombres de variables buenos y malos:

// Bien
int age = 30;
double totalPrice = 150.99;      // camelCase
int numberOfStudents = 25;       // camelCase
const int MAX_STUDENTS = 100;    // SCREAMING_SNAKE_CASE para constantes

// Mal
int a = 30;  // Demasiado corto y poco claro
double TOTAL_PRICE = 150.99;  // Las mayúsculas no son para variables regulares
int n = 25;  // Demasiado corto y poco claro

Hoja de referencia

Reglas de nomenclatura de C++:

Los nombres pueden contener letras, dígitos y guiones bajos
Los nombres deben comenzar con una letra o un guion bajo
Los nombres distinguen entre mayúsculas y minúsculas (myVar ≠ myvar)
Los nombres no pueden ser palabras clave de C++ (por ejemplo, int, float)

Convenciones de nomenclatura comunes:

camelCase — variables y funciones: totalAmount
PascalCase — nombres de clases: MyClass
snake_case — nombres de archivos / otros lenguajes: total_amount
SCREAMING_SNAKE_CASE — constantes y macros: MAX_SIZE
Sea descriptivo; evite nombres cortos o poco claros (prefiera numberOfStudents en lugar de n)
Los nombres de una sola letra solo son aceptables para contadores simples (i, j, k)

int age = 30;                    // bien
double totalPrice = 150.99;      // camelCase
const int MAX_STUDENTS = 100;    // SCREAMING_SNAKE_CASE

int a = 30;                      // mal: poco claro
double TOTAL_PRICE = 150.99;     // mal: mayúsculas para no constantes

Pruébalo tú mismo

Esta lección no incluye un desafío de código.

Ponte a prueba

Esta lección incluye un breve cuestionario. Empieza la lección para responderlo y registrar tu progreso.

Convenciones de nomenclatura

Hoja de referencia

Todas las lecciones de Fundamentos