Cómo escribir pseudocódigo

Coescrito por Jack Lloyd

Este wikiHow te enseñará a crear un documento de pseudocódigo para un programa de computadora. El pseudocódigo consiste básicamente en crear un bosquejo para documentar el propósito de un código, utilizando un léxico que no pertenece a un verdadero lenguaje de programación.

Parte 1

Parte 1 de 3:
Comprender los aspectos esenciales del pseudocódigo

1
Comprende qué es el pseudocódigo. El pseudocódigo es un bosquejo de código escrito paso a paso que, gradualmente, se puede transcribir en un lenguaje de programación. Muchos programadores lo usan para planificar la función de un algoritmo antes de darse a la tarea más técnica de codificar.

El pseudocódigo sirve como una guía informal, una herramienta para pensar detenidamente en los problemas del programa y también como una opción de comunicación que sirve para explicarles las ideas a otras personas.
2
Comprende por qué es útil el pseudocódigo. El pseudocódigo se utiliza para mostrar cómo debe funcionar un algoritmo de computación. Los desarrolladores a menudo utilizan el pseudocódigo como un paso de programación intermedio entre la etapa de planificación inicial y la etapa de creación del verdadero código ejecutable. Entre los usos adicionales que tiene el pseudocódigo, se destacan los siguientes:
- Describir cómo debe funcionar un algoritmo. El pseudocódigo sirve para ilustrar en qué parte del programa puede o debe aparecer una construcción, mecanismo o técnica en particular.
- Explicar un proceso de computación a usuarios con menos conocimientos técnicos. Las computadoras necesitan una sintaxis de entrada muy estricta para ejecutar un programa, pero los humanos (especialmente aquellos que no programan) seguramente entenderán mejor el lenguaje si este es más fluido, subjetivo y explica con claridad cuál es el propósito de cada línea de código.
- Diseñar código en un entorno grupal. Los arquitectos de software de alto nivel a menudo incluyen pseudocódigo en sus diseños para ayudar a los programadores a resolver los problemas complejos con los que se encuentran. Si vas a desarrollar un programa junto con otros programadores, notarás que el pseudocódigo es muy útil para aclarar las intenciones de cada uno.
3
Recuerda que el pseudocódigo es subjetivo y no estandarizado. Tu pseudocódigo no debe seguir ninguna sintaxis preestablecida. Sin embargo, por cortesía profesional, sería bueno que uses estructuras estándares de pseudocódigo para que otros programadores puedan entenderla fácilmente.^{[1]
X
Fuente de investigación} Si vas a desarrollar un proyecto tú solo, entonces lo más importante es que tu pseudocódigo te ayude a estructurar tus pensamientos y representar tus planes.
- Si vas a trabajar con otras personas en un proyecto (ya sean pares, programadores con poca experiencia o colaboradores técnicos), es importante que uses al menos algunas estructuras estándar para que todos puedan entender fácilmente tus propósitos.
- Si te has inscrito en un curso de programación en una universidad, en un programa de entrenamiento estilo bootcamp o en una empresa, es probable que te enseñen a través de un pseudocódigo "estándar". Sin embargo, estos modelos pueden variar según la institución y el profesor.
La claridad es el objetivo principal del pseudocódigo, y podría ser de utilidad que trabajes siguiendo las convenciones de programación aceptadas. A medida que desarrolles tu pseudocódigo en un código verdadero, tendrás que transcribirlo en un lenguaje de programación, por lo que puede ser de utilidad que estructures tu bosquejo con esto en mente.
4
Concéntrate en el propósito principal del pseudocódigo. Es fácil volver a escribir código una vez que has dado el gran paso. Es importante que recuerdes el propósito de tu pseudocódigo (explicando lo que hace cada línea del programa) para no perder el rumbo al crear el documento de pseudocódigo.

Anuncio

Parte 2

Parte 2 de 3:
Escribir un buen pseudocódigo

1
Utiliza un editor de texto simple. Usar un procesador de texto (por ejemplo, Microsoft Word) o un programa similar que te permita crear un documento de texto enriquecido puede ser tentador, pero el pseudocódigo debe tener las menores opciones de formato posible para mantener la simpleza.

Entre los editores de texto simples tenemos al Bloc de notas (Windows) y TextEdit (Mac).
2
Comienza por escribir el propósito del proceso. Si dedicas una o dos líneas a explicar el propósito del código te resultará más fácil preparar el resto del documento y además te ahorrará la tarea de tener que explicarle la función del programa a cada una de las personas a quienes les muestres el pseudocódigo.
3
Anota solamente un enunciado por línea. Cada enunciado del pseudocódigo debe expresar solo una acción de la computadora. En la mayoría de los casos, si la lista de tareas está bien confeccionada, cada tarea corresponderá a una sola línea de pseudocódigo. Considera la posibilidad de escribir tu lista de tareas, luego traducir esa lista a pseudocódigo y después desarrollar gradualmente el pseudocódigo hasta transformarlo en código real que pueda ser leído por una computadora.^{[2]
X
Fuente de investigación}
4
Utiliza los espacios en blanco y las sangrías eficientemente. Si introduces espacios en blanco entre "bloques" de texto, te resultará más fácil aislar los distintos componentes del pseudocódigo. Además, agregando sangrías en las distintas partes de cada bloque puedes indicar que esas partes van debajo de una sección con menos sangría.
- Por ejemplo, si una sección de pseudocódigo indica que hay que ingresar un número, toda esa sección debe estar en el mismo "bloque", mientras que la sección siguiente (por ejemplo, la que determina cuál es la salida) debe estar en un bloque diferente.
5
Pon en mayúsculas los comandos clave, si es necesario. Dependiendo de los requerimientos del pseudocódigo o del entorno en el cual vayas a publicarlo, tal vez sea necesario poner en mayúsculas algunos comandos que van a permanecer en el código real.
- Por ejemplo, si decides hacer tu pseudocódigo en inglés y usas los comandos "if" y "then", tal vez sea mejor cambiarlos por "IF" y "THEN". Por ejemplo, "IF input number THEN output result" (en español, "SI número de entrada ENTONCES resultado de salida").
6
Escribe con terminología simple. Recuerda que vas a escribir sobre lo que hace tu proyecto, no a resumir el código. Esto es especialmente importante si vas a escribir pseudocódigo para hacerle una demostración a un cliente que no sabe de programación, o es un proyecto para un programador principiante.^{[3]
X
Fuente de investigación}

Tal vez sería bueno que te deshagas de todos los comandos de programación y definas simplemente los procesos de cada línea en lenguaje natural. Por ejemplo "si la entrada es impar, la salida es 'Y'" podría reemplazarse por "si el usuario ingresa un número impar, mostrar 'Y'".
7
Asegúrate de que tu pseudocódigo esté en el orden correcto. Si bien el lenguaje que se usa para modificar el pseudocódigo debe ser simple, igualmente debes mantener todas las partes del pseudocódigo en el orden en el que debe ser ejecutado.
8
No dejes nada a la imaginación. Debes describir por completo todo lo que suceda en el proceso. Los enunciados del pseudocódigo deben ser simples oraciones en español. El pseudocódigo normalmente no usa variables, sino que describe qué es lo que el programa debe hacer con objetos (casi) del mundo real, como números de cuenta, nombres o montos de transacciones.^{[4]
X
Fuente de investigación}
9
Utiliza estructuras estándar de programación. Incluso aunque no exista un pseudocódigo estándar, los demás programadores podrán entender con mayor facilidad tus pasos si usas estructuras de lenguajes de programación (secuenciales) ya existentes. ^{[5]
X
Fuente de investigación} Utiliza términos como "si", "entonces", "mientras", "si no" y "repetir" del mismo modo que lo harías en tu lenguaje de programación favorito. Observa las siguientes estructuras:
- si CONDICIÓN entonces INSTRUCCIÓN: esto significa que una instrucción dada solo se ejecutará si cierta condición es verdadera. En este caso, "instrucción" se refiere a un paso que el programa ejecutará, mientras que "condición" se refiere a un dato que debe cumplir ciertos criterios para que el programa entre en acción. ^{[6]
  X
  Fuente de investigación}
- mientras CONDICIÓN hacer INSTRUCCIÓN: esto significa que la instrucción se debe repetir indefinidamente hasta que la condición deje de ser verdadera. ^{[7]
  X
  Fuente de investigación}
- hacer INSTRUCCIÓN mientras CONDICIÓN: esto es muy similar a "mientras CONDICIÓN hacer INSTRUCCIÓN". En el primer caso, la condición se verifica antes de que se ejecute la instrucción. En el segundo caso, la instrucción se ejecuta primero. Por lo tanto, en este caso, la INSTRUCCIÓN se ejecutará al menos una vez.
- función NOMBRE (ARGUMENTOS): INSTRUCCIÓN: esto significa que cada vez que se use cierto nombre en el código, será una abreviatura de cierta instrucción. Los "argumentos" son listas de variables que puedes usar para clarificar la instrucción.
10
Organiza tus secciones de pseudocódigo. Si tienes grandes secciones de pseudocódigo que definen otras partes de pseudocódigo dentro de un mismo bloque, sería bueno que uses corchetes u otro tipo de identificador que funcione como contenedor.
- Corchetes: tanto los corchetes (por ejemplo, [código]) como las llaves (por ejemplo, {código}) pueden ayudarte a contener grandes segmentos de pseudocódigo.
- A la hora de programar, se suelen agregar comentarios escribiendo "//" en el lado izquierdo del comentario (por ejemplo, //Este es un paso temporal.). Utiliza este mismo método al escribir pseudocódigo para dejar notas que no deban ir en el texto del código.
11
Revisa bien tu pseudocódigo para asegurarte de que sea claro y legible. Al finalizar el documento, debes ser capaz de responder las siguientes preguntas:
- ¿Alguien que no esté familiarizado con el proceso sería capaz de entender el pseudocódigo?
- ¿El pseudocódigo está escrito de forma tal que se pueda traducir a un lenguaje de programación?
- ¿El pseudocódigo describe el proceso completo, sin dejar nada afuera?
- ¿La audiencia objetivo será capaz de entender claramente todos los nombres de los objetos utilizados en el pseudocódigo?
- Si descubres que una sección de pseudocódigo necesita más elaboración o no describe explícitamente un paso que alguien podría olvidar, entonces vuelve atrás y agrega la información necesaria.
Anuncio

Parte 3

Parte 3 de 3:
Crear un documento de pseudocódigo de ejemplo

1
Abre un editor de texto simple. En caso de que no quieras instalar un nuevo programa, puedes usar el Bloc de notas (Windows) o TextEdit (Mac), que son los editores predeterminados.
2
Define tu programa. Si bien no es estrictamente necesario hacerlo, sería bueno que escribas una línea de una o dos oraciones al principio del documento para aclarar desde un principio cuál es el propósito del programa:
```
Este programa le pedirá un saludo al usuario. Si el saludo coincide con una respuesta específica, se mostrará una respuesta. De lo contrario, se rechazará el saludo.
```
3
Escribe la secuencia de apertura. El primer comando; es decir, lo primero que debe hacer el programa al ejecutarse, debe ir en la primera línea:
```
mostrar saludo
	"¡Hola extraño!"
```
4
Agrega la siguiente línea. Coloca un espacio entre la última línea y la siguiente presionando ↵ Enter. Luego crea la siguiente línea de código. En este ejemplo, el usuario deberá interactuar con el programa para que aparezca la próxima línea de diálogo:
```
mostrar mensaje
	presiona "Enter" para continuar
<usuario presiona "Enter">
```
5
Agrega una llamada a la acción. En este ejemplo, se le pedirá un saludo al usuario:
```
mostrar llamada a la acción
	"¿Cómo estás?"
```
6
Muéstrale al usuario una lista de respuestas. Una vez más, después de presionar ↵ Enter en este ejemplo, el usuario verá una lista de posibles respuestas:
```
mostrar posibles respuestas
	"1. Bien."
	"2. ¡Estupendo!"
	"3. No muy bien."
```
7
Pídele al usuario que ingrese una respuesta. Aquí es donde el programa le pedirá al usuario que ingrese una respuesta:
```
mostrar pedido de respuesta
	"Escribe el número que mejor represente tu estado actual:"
```
8
Crea un comando "si" para la respuesta del usuario. Como el usuario tiene varias opciones de respuesta, deberás crear varios resultados posibles basándote en la respuesta seleccionada:
```
si "1"
	mostrar respuesta
		"¡Qué bien!"

si "2"
	mostrar respuesta
		"¡Fantástico!"

si "3"
	mostrar respuesta
		"¡Relájate, hermano!"
```
9
Agrega un mensaje de error. En el caso de que el usuario elija una respuesta incorrecta, puedes hacer que aparezca un mensaje de error:
```
si la respuesta no se reconoce como válida
	mostrar respuesta
		"No eres muy bueno siguiendo instrucciones, ¿verdad?"
```

10

Agrega los demás componentes del programa. Revisa el documento y agrega o mejora los detalles para asegurarte de que tanto tú como cualquiera que lea el documento pueda entender su significado. En cuanto al ejemplo desarrollado en este método, el documento final de pseudocódigo deberá quedar similar a este:

Este programa le pedirá un saludo al usuario. Si el saludo coincide con una respuesta específica, se mostrará una respuesta. De lo contrario, se rechazará el saludo.

mostrar saludo
	"¡Hola extraño!"

mostrar mensaje
	presiona "Enter" para continuar
<usuario presiona "Enter">

mostrar llamada a la acción
	"¿Cómo estás?"

mostrar posibles respuestas
	"1. Bien."
	"2. ¡Estupendo!"
	"3. No muy bien."

mostrar pedido de respuesta
	"Escribe el número que mejor represente tu estado actual:"

si "1"
	mostrar respuesta
		"¡Qué bien!"
si "2"
	mostrar respuesta
		"¡Fantástico!"
si "3"
	mostrar respuesta
		"¡Relájate, hermano!"

si la respuesta no se reconoce como válida
	mostrar respuesta
		"No eres muy bueno siguiendo instrucciones, ¿verdad?"

11
Guarda el documento. Para hacerlo, presiona Ctrl+G (Windows) o Comando+S (Mac), ingresa un nombre y haz clic en Guardar.

Anuncio

Consejos

El pseudocódigo es ideal para programas complejos de miles y miles de líneas de código.

Anuncio

Advertencias

El pseudocódigo no se puede sustituir por código real al crear un programa. El pseudocódigo solo se puede utilizar como una referencia de lo que hace el código real.

Anuncio