Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
ingenieria:estandard-de-codificacion [2014/05/20 18:50] |
ingenieria:estandard-de-codificacion [2016/01/05 23:15] (actual) |
||
---|---|---|---|
Línea 1: | Línea 1: | ||
- | |||
- | |||
- | ---- | ||
- | |||
- | ---- | ||
- | |||
====== Estandard de Codificación ====== | ====== Estandard de Codificación ====== | ||
Línea 71: | Línea 65: | ||
return true; | return true; | ||
} | } | ||
- | |||
</file> | </file> | ||
Línea 92: | Línea 85: | ||
* Entre una estructura de control o definición de método o función y la llave de apertura del bloque que define. [líneas 3 y 4] | * Entre una estructura de control o definición de método o función y la llave de apertura del bloque que define. [líneas 3 y 4] | ||
* Entre los parámetros de la definición o llamada a una función o método. [líneas 3, 5 y 16] | * Entre los parámetros de la definición o llamada a una función o método. [líneas 3, 5 y 16] | ||
- | * Entre los caracteres de slash "//" y los comentarios de una línea. [líneas 5, 6 y 8] ==== No se deja un espacio en blanco: ==== * Entre un operador unario y su operando. [línea 4] * Entre los operandos del operador flecha "→". [línea 16] * Entre el nombre de un método o función y los paréntesis de definición de parámetros. [línea 3] * La llamada a un constructor, método, o función y la lista de parámetros. [líneas 15 y 16] * Una variable de tipo array y los corchetes que especifican el índice a acceder. [línea 8] ==== Se deja una línea en blanco: ==== * Después del cierre de un bloque de código. [líneas 7, 10 y 14] * Entre agrupaciones de sentencias altamente cohesivas. [línea 7] ==== Ejemplo: ==== ''1. class MiClase 2. { 3. public function f1($p1, $p2, $p3) { 4. if (!$p2) { 5. $arr = array(1, 2, 3); '' //'' Definición de variable'' | + | * Entre los caracteres de slash "//" y los comentarios de una línea. [líneas 5, 6 y 8] |
- | ''6. $v1 = 10'; // Definición de variable 7. 8. $p += $v1 + $arr[0]; // Otro tipo de sentencias 9. } 10. 11. retrun $p; 12. } 13. } 14. 15. $obj = new MiClase(); 16. $obj→f1(5, 6, 7); '' | + | ==== No se deja un espacio en blanco: ==== |
- | ---- | + | * Entre un operador unario y su operando. [línea 4] |
+ | * Entre los operandos del operador flecha "->". [línea 16] | ||
+ | * Entre el nombre de un método o función y los paréntesis de definición de parámetros. [línea 3] | ||
+ | * La llamada a un constructor, método, o función y la lista de parámetros. [líneas 15 y 16] | ||
+ | * Una variable de tipo array y los corchetes que especifican el índice a acceder. [línea 8] | ||
- | ===== Alineamientos ===== | + | ==== Se deja una línea en blanco: ==== |
- | En el caso de un bloque de asignaciones relacionadas se pueden alinear los signos de igualdad (=) . | + | * Después del cierre de un bloque de código. [líneas 7, 10 y 14] |
+ | * Entre agrupaciones de sentencias altamente cohesivas. [línea 7] | ||
- | <code> | + | ==== Ejemplo: ==== |
- | $short = foo($bar); | + | |
- | $long_variable = foo($baz); | + | <code>1. class MiClase |
+ | 2. { | ||
+ | 3. public function f1($p1, $p2, $p3) { | ||
+ | 4. if (!$p2) { | ||
+ | 5. $arr = array(1, 2, 3); // Definición de variable | ||
+ | 6. $v1 = 10'; // Definición de variable | ||
+ | 7. | ||
+ | 8. $p += $v1 + $arr[0]; // Otro tipo de sentencias | ||
+ | 9. } | ||
+ | 10. | ||
+ | 11. retrun $p; | ||
+ | 12. } | ||
+ | 13. } | ||
+ | 14. | ||
+ | 15. $obj = new MiClase(); | ||
+ | 16. $obj->f1(5, 6, 7); | ||
</code> | </code> | ||
- | Lo mismo se aplica a las definiciones de arreglos. | + | ---- |
+ | |||
+ | ===== ''Alineamientos'' ===== | ||
+ | |||
+ | ''En el caso de un bloque de asignaciones relacionadas se pueden alinear los signos de igualdad (=) . '' | ||
+ | |||
+ | ''''$short = foo($bar); $long_variable = foo($baz); '' '' | ||
+ | |||
+ | ''Lo mismo se aplica a las definiciones de arreglos. '' | ||
+ | |||
+ | ''<code> $some_array = array( '' | ||
<code> | <code> | ||
- | $some_array = array( | + | '' 'a' => 'foobar', |
- | 'a' => 'foobar', | + | 'foo' => 'bar', |
- | 'foo' => 'bar', | + | 'spam' => 'ham', |
- | 'spam' => 'ham', | + | |
- | ); | + | '' |
</code> | </code> | ||
+ | |||
+ | '' '' | ||
+ | |||
+ | ''); '' | ||
Las llamadas a funciones se pueden dividir en varias líneas. Los parámetros se identan 1 nivel respecto a la línea de la función a la que pertenecen. | Las llamadas a funciones se pueden dividir en varias líneas. Los parámetros se identan 1 nivel respecto a la línea de la función a la que pertenecen. | ||
Línea 462: | Línea 489: | ||
} | } | ||
</code> | </code> | ||
- | |||