c++ - code - google javascript style guide
Documentos estándar estándar y codificación estándar existentes (11)
Los siguientes han sido propuestos para un próximo proyecto de C ++.
- C ++ Coding Standards, por Sutter y Alexandrescu
- Normas de codificación JSF Air Vehicle C ++
- Los elementos del estilo C ++
- Effective C ++ 3rd Edition, por Scott Meyers
¿Hay otras opciones? ¿O es la lista por encima de lo que se debe utilizar en un proyecto de C ++?
Algunos enlaces relacionados
Escribí un estándar de codificación para una importante compañía británica y fui muy consciente de poner razones por las cuales seleccioné ciertas cosas en lugar de simplemente hacer un montón de declaraciones de "tú harás". (-:
Como una salida rápida, sugeriría ordenar:
- Edición 3ª edición eficaz de C ++ de Scott Meyers ( enlace de Amazon ): si puede encontrar una copia de la 1ª edición de este libro, cómprela para obtener una descripción general del diseño de OO que se eliminó de ediciones posteriores. ) -:
- El libro de Scott Meyer Effective STL ( enlace de Amazon ): debe usar STL para usar C ++ de manera eficiente.
- El libro de Steve McConnell Code Complete 2 ( enlace de Amazon ) - no es específico de C ++ sino que está lleno de grandes ideas.
Estoy de acuerdo con Harald Scheirich, es muy importante que el equipo acuerde cuáles deberían ser las reglas en lugar de simplemente elegir un conjunto que haya sido recomendado por personas externas.
Mi recomendación personal sería leer Code Complete, 2nd Edition, de Steve McConnell, que describe (entre muchas otras cosas útiles) varios estándares de codificación comunes y ofrece comentarios sobre cada uno. Esto podría ayudar a su equipo a establecer sus propios estándares.
Hmm, pregunta extraña. Simplemente elija el estándar con el que la mayoría de los miembros del equipo estén familiarizados. Haz algún tipo de encuesta para tu equipo. No estoy seguro de cómo SO puede ayudar aquí :)
Prueba este, es el que utiliza el centro de vuelos espaciales Goddard de la NASA.
Estándares de codificación de C ++: 101 Reglas, directrices y mejores prácticas (Series en profundidad C ++) de Herb Sutter y Andrei Alexandrescu.
Los estándares de codificación C ++ del vehículo aéreo JSF de Lockheed Martin son una lectura interesante, pero es un poco exagerado a menos que trabaje en campos donde un error puede matar personas. Sigue siendo un ejemplo muy importante para mirar desde un punto de vista ético de la computadora sobre un ejemplo de cómo programar con la máxima prioridad de la seguridad y la corrección.
Para la codificación de C ++ de uso general, yo recomendaría C ++ Coding Standards de Herb Sutter. Desde el comienzo, enfatiza lo que no se debe estandarizar (cosas relacionadas con el estilo o preferencia en lugar de prácticas que promueven la seguridad, la corrección, la eficiencia). También es una de las lecturas más sencillas de su lista que brinda argumentos muy breves pero concisos para cada estándar, por lo que es fácil mostrarlo a sus compañeros de trabajo.
Los estándares de codificación son solo significativos si te ayudan a escribir el código. Por lo tanto, solo necesitan mantener el código coherente (es decir, si alguien pone m_ para miembros variables y alguien no, puede tomar más tiempo obtener el código que si todos usaran el mismo estilo).
Eso es todo lo que (deberían) hacer, así que simplemente elija su código actual y asegúrese de que los códigos de su equipo tengan el mismo estilo.
Me gusta pensar en eso como caricaturas. Si te conviertes en caricaturista en los Simpson, debes dibujar los ojos de la manera oficial o todo se ve con los pantalones, pero si te diriges a Family Guy, tienes que dibujarlos de manera diferente. De ninguna manera está mal.
Demasiados estándares se refieren a restricciones sin sentido, escritas por personas que no se codifican a sí mismas (o que se consideran demasiado buenas para cumplirlas). Otros intentan enseñarte cómo codificar. Ninguno de los dos tiene su lugar en un buen estándar, solo hacen que sea más fácil para usted mirar algún código y comprender lo que está haciendo.
p.ej. mis estándares incluyen reglas para nombrar directorios: siempre tendrá su código en un directorio llamado el mismo nombre que el proyecto, y todos los binarios irán al subdirectorio bin, con todos los archivos de configuración en el mismo lugar, y un registro de cambios, etc. cosas simples, pero le garantizo que nunca encontraré un proyecto llamado algo diferente con sus binarios en el directorio raíz donde no sé qué cambios se le hicieron. Cosas sencillas y fáciles que hacen una gran diferencia.
Realmente creo que no importa cuál adoptes, siempre y cuando todos estén de acuerdo. A veces puede ser difícil ya que parece que algunos estilos no concuerdan con las personas. Es decir, se trata de discutir si el prefijo de todas las variables miembro con m_ es bonito o no.
He estado utilizando y modificando los estándares de Geosoft por un tiempo, estos son para C ++. Hay alguna otra en el hilo de la lista de verificación what-is-your-favorite-coding-guidelines-guidelines