728 votos

¿Comentarios de varias líneas en Ruby?

¿Cómo puedo comentar varias líneas en Ruby?

1322voto

Konstantin Haase Puntos 12089
#!/usr/bin/env ruby

=begin
Todo el mundo mencionó esta forma
de tener comentarios multilínea.

El =begin y =end deben estar al principio de la línea o
será un error de sintaxis.
=end

puts "¡Hola mundo!"

<<-DOC
Además, podrías crear una cadena de documentos.
que...
DOC

puts "¡Hola mundo!"

".. es un poco feo y crea
una instancia de Cadena, pero conozco a alguien
con una base de Smalltalk, que
hace esto."

puts "¡Hola mundo!"

##
# la mayoría
# de la gente
# hace
# esto

__END__

Pero todos olvidaron que hay otra opción.
Solo al final de un archivo, por supuesto.
  • Así es como se ve (a través de una captura de pantalla) - de lo contrario es difícil interpretar cómo se verán los comentarios anteriores. Haz clic para hacer zoom:

Comentarios en un editor de texto

124voto

Anna Lear Puntos 13919
=begin
Mi
comentario
de varias líneas
aquí
=end

54voto

Rein Henrichs Puntos 3592

A pesar de la existencia de =begin y =end, la forma normal y más correcta de comentar es usar # en cada línea. Si lees el código fuente de alguna biblioteca de ruby, verás que esta es la forma en que se hacen los comentarios de varias líneas en casi todos los casos.

19voto

miku Puntos 63392
#!/usr/bin/env ruby

=begin
Entre =begin y =end, se puede escribir cualquier número
de líneas. Todas estas
líneas son ignoradas por el intérprete de Ruby.
=end

puts "¡Hola mundo!"

13voto

La-comadreja Puntos 3057
=begin
(algún código aquí)
=end

y

# Este código
# en múltiples líneas
# está comentado

son ambos correctos. La ventaja del primer tipo de comentario es la editabilidad; es más fácil descomentar porque se eliminan menos caracteres. La ventaja del segundo tipo de comentario es la legibilidad; al leer el código línea por línea, es mucho más fácil saber que una línea en particular ha sido comentada. Tú decides, pero piensa en quién viene después de ti y en lo fácil que le resultará leer y mantener el código.

Iteramos.com

Iteramos es una comunidad de desarrolladores que busca expandir el conocimiento de la programación mas allá del inglés.
Tenemos una gran cantidad de contenido, y también puedes hacer tus propias preguntas o resolver las de los demás.

Powered by:

X