Reading code

Como programadores o programadoras nos enfrentamos a distintas maneras de escribir código fuente dependiendo el lenguaje de preferencia. Cada uno tiene sus particularidades y su propia sintaxis. Veamos todo lo relacionado con el código fuente en inglés.

Descripción del código

En el mundo de la programación existen muchos símbolos o caracteres especiales que se utilizan a la hora de escribir código fuente. Es muy importante conocer sus nombres en Inglés para leer el código correctamente.

Caracteres especiales

Cada carácter especial significa algo distinto en un lenguaje u otro. Aprender sus nombres en inglés.

• Spaces or Tabs: Indent/Indentation
• ( ) Parentheses
• { } Curly Brackets, curly braces
• [ ] Square Brackets
• ‘ ’ Single quotes
• “ ” Double quotes, typographic or curly quotes in text
• ` ` Backquotes, Backtick
• . Point (numbers, versions). Dot (domain names, object notation), Period (finishing paragraph)
• , Comma
• : Colon
• ; Semicolon
• + Plus
• - Minus
• * Asterisk, times
• / Division, slash
• \ Backslash
• = Equal
• == Doble equal
• | Pipe
• - Hyphen dash
• – N Dash
• — M Dash
• _ Underscore
• ~ Tilde
• ! Bang, exclamation sign
• @ At sign
• # Hash
• ^ Caret
• $ Dollar sign
• % Percent
• & Ampersand

Estilos de escritura

Existen diferentes formas de escribir el nombre de una variable o función. Cada lenguaje suele tener estandarizado cómo hacerlo.

• foobar, foo, bar, baz: Frecuentemente empleadas estas palabras cuando no se sabe qué nombre ponerle a una variable. Se utilizan como nombres genéricos.
• flatcase: myvariable
• camelCase: myVariable
• snake_case: my_variable
• kebab-case: my-variable

Lectura de código

Veamos dos maneras de leer código fuente:

if (a >= b) {
  console.log("A es mayor o igual que B");
} else {
  console.log("A es menor que B");
}

Comencemos por la lectura lógica del código fuente:

If A is greater than or equal to B then log inside will be “A es mayor o igual que B”. Otherwise, the log inside will be “A es menor que B”.

Puede ocurrir que tengas que ayudar a alguien a escribir el código, en ese caso deberás hacer una descripción de la sintaxis del mismo:

If, open parentheses, A greater equal B, close parentheses, open bracket, console dot log, open parentheses, open double quotes, text, close double quotes, close parentheses, semicolon, close bracket, else, open bracket, console dot log, open parentheses, open double quotes, text, close double quotes, close parentheses, semicolon, close bracket.

Se vuelve bastante exhaustiva la descripción del código. Puedes obviar el cierre de los paréntesis o brackets para simplificar la explicación. De ahí la importancia de conocer el nombre de los símbolos y caracteres especiales en inglés.

Practicar la lectura de código fuente va a ser muy importante para prepararte en el trabajo con equipos cuyo idioma principal sea el inglés.

---

Contribución creada por Kevin Fiorentino, con aportes de Leví Arista Sánchez.