Qt Coding Style/es
Jump to navigation
Jump to search
Guia de estilo de código Qt
Este es un resumen de las practicas de codificación que usamos al escribir el código de Qt.
Los datos han sido recogidos de diferentes fuentes relacionas con Qt, foros de discusión, discusiones de correo electrónico y mediante la colaboración de los desarrolladores.
Sangrado (Indentación)
- Usar 4 espacios para sangrar
- Espacios, no tabulaciones!
Declarando variables
- Declarar cada variable en una linea separada
- Evitar nombres cortos siempre que sea posible (ej. “a”, “rbarr”, “nughdeget”)
- Se recomiendan nombres de variables de un solo caracter solamente para usar en contadores y dónde el propósito de la variable es obvio.
- Esperar hasta que sea necesario para declarar una variable
- El nombre de las variables y las funciones comienza con una letra minúsculas. Las siguientes palabras en el nombre de la variable empiezan con una letra mayúscula.
- Evitar la abreviaturas
- Los nombres de las Clases siempre comienzan con una letra mayuscular. Clases publicas comienzan con una ‘Q’ (QRgb). Las funciones publicas a menudo comienzan con una ‘q’ (qRgb).
Espacios en blanco
- Usar lineas en blanco para agrupar declaraciones
- Siempre usar una linea en blanco
- Siempre usar un espacio en blanco despues de un carácter, y antes de un corchete
- Para punteros o referencias, siempre usar un espacio en blanco entre el ‘\*’ o ‘&’, pero no usarlos entre ‘\*’ o ‘&’ y el nombre de la variable
- Envuelva los operadores binarios con espacios
- Ningún espacio después de un “cast”
- Evitar los “cast” como en C, en la medida de lo posible
Llaves
- Como regla básica, el corchete izquierdo debe estar en la misma linea de inicio de la declaración:
- Las implementaciones de funciones y las declaraciones de clase siempre tendrán el corchete izquierdo en una nueva línea:
- Usar llaves cuando el cuerpo de una declaración condicional contenga mas de una linea, y también si una declaración de una simple linea es algo compleja.
- Excepción 1: Use llaves a si la declaración padre abarca muchas lineas
- Excepción 2: Use llaves también en bloques if-then-else, donde el código ‘if’ o el código ‘else’ ocupen varias lineas.
- Use llaves cuando el cuerpo de una sentencia condicional este vacía
Paréntesis
- Use paréntesis para agrupar expresiones:
Declaraciones Switch
- El case debe estar en la misma columna que el switch
- Cada declaración case debe tener un break (o return) al final o un comentario que indique porque intencionalmente no hay un break
Saltos de linea
- Limite el largo de las lineas a 100 caracteres, inserte saltos de linea si son necesarios
- Las comas van al final de una línea quebrada, los operadores deben empezar al principio de la nueva línea. Un operador al final de la línea no es fácil de ver si el editor es demasiado estrecho.
Herencia y la keyword `virtual`
- Cuando reimplemente un método virtual, no ponga la keyword `virtual` en el archivo header.
Excepción general
- Siéntase libre de romper una regla si esta hace que su código se vea mal.