estilos_programacion

Estilos de programación

Cada programador tiene su propio estilo para escribir. Un buen estilo para programar deberá tener una estructura de código fácil de entender, no solo para otra gente sino también para si mismo. Aquí hay varios criterios para un buen estilo:
1. Nombres significativos para variables, controles, y procedimientos.
2. Identación (sangrías) y espacios apropiados en elcódigo.
3. documentar el código (poner comentarios para aclarar).
4. Módulos adaptables.
5. Minimizar el acoplamiento.
6. Minimizar alcance de los datos hasta donde sea posible.
 
Identación y espacio apropiado en el código.
La identación es usada para tener una mejor visibilidad en el diseño de un programa. La identación muestra las líneas que están subordinadas a otras líneas. Por ejemplo,todas las líneas que forman el cuerpo de un ciclo deberán estar identadas con la instrucción principal del ciclo. En el siguiente ejemplo se muestra una estructura anidada (una dentro de otra). Cualquier cosa dentro de este primer ciclo FOR (num_semana) es identada y de la misma manera cualquier cosa dentro del segundo ciclo (num_dia) es identado también. Otra vez cada comando CASE es identado entreel contenido Select Case y End Select.
For num_semana = 1 To 52
Print "Semana #"; num_semana
For num_dia = 1 To 7
Select Case num_dia
Case 1
Print "Domingo"
Case 2
Print "Lunes"
Case 3
Print "Martes"Case 4
Print "Miércoles"
Case 5
Print "Jueves"
Case 6
Print "Viernes"
Case 7
Print "Sábado"

End Select
Next num_dia
Next num_semana
Las líneas en blanco pueden también ser identadas entre las líneas decódigo para romper un procedimiento y hacerlo en pequeños bloques de código.
 
Documentando el Código
Las complicadas e inusuales secciones de código deberán ser documentadas. Idealmente cada variable y arreglo deberá tener comentarios donde se definan tal que su función pueda ser entendida después. Hay dos formas de documentar código en VB, la declaración REM que puede ser usado en líneasseparadas y el ‘ (apostrofe) seguido por el texto de comentario. El ‘ le dice a VB que ignore todas la palabras que están enseguida hasta el fin de la línea.
Ejemplo:
Dim obejas As Integer ‘ Almacena el número de obejas de cara negra
Ejemplo:
Rem Centra la forma.

frmCurrent.Left = (Screen.Width / 2) - (frmCurrent.Width / 2)
frmCurrent.Top = (Screen.Height / 2) - (frmCurrent.Height /2)
 
Procedimientos Coherentes
Cada procedimiento deberá ser diseñado para una tarea simple. Si un procedimiento maneja muchas tareas, es lógico que pueda ser difícil de entender y pueda ocurrir fácilmente un error.
Minimizar el acoplamiento
Pasar un parámetro es una buena práctica de programación, pero muchos parámetros y el código pueden llegar a ser muy difíciles de manejar. Losprocedimientos con muchos parámetros son altamente acoplables, ellos tienen muchas ligas o otros procedimientos. Hasta donde sea posible se deben minimizar éstas ligas. ¡Sin embargo las variables globales no deberán ser usadas en lugar de ellas!.
Minimizar alcance de los datos hasta donde sea posible.
Las variables y los arreglos pueden se accedidos por código en diferentes partes de un programa, desdecualquier lugar si son Globales. Esto es lo ideal, pero si no hay cuidado algunos efectos extraños pueden ocurrir en otras partes del programa, como colocando un valor en una variable por error. Restringiendo el rango de acceso, o el alcance de una variable o un arreglo se puede evitar este problema. Un alcance intermedio es el acceso necesario para una variable durante todo el simple módulo....