Notas de Java

Quieres una nota en el archivo para ti, y quieres que la pantalla siga igual. La pantalla sigue siendo mint. La nota es para una persona que lee Mint.java. No es una palabra para la pantalla. Esta página pone esa nota en dos formas, muestra que mint sigue siendo la única línea y después muestra el único sitio que borra mint de la pantalla. No estás instalando Java otra vez. No estás buscando qué línea escribe la pantalla. Ya sabes que esa línea es System.out.println("mint"). El trabajo nuevo es la nota junto a ella.

Una nota no es una orden

Una orden es una línea que Java ejecuta. System.out.println("mint") es una orden. Escribe mint y termina la línea. Una nota es texto que dejas en el archivo para que tú, o quien lea después, recuerde algo. Java se salta una nota. Saltársela significa que la nota no se ejecuta y que no se escribe en la pantalla. Las letras de la nota siguen en el archivo después de la ejecución. Puedes abrir Mint.java y leerlas. En la pantalla no las encuentras. La pantalla sigue teniendo una línea, y esa línea es mint, siempre que la orden que escribe no sea ella misma la nota.

Hay dos formas. Una nota de línea empieza con dos barras: //. Java se salta desde esas dos barras hasta el final de esa misma línea. La línea siguiente vuelve a ser una línea normal. La otra forma empieza con / y acaba en el primer /. Java se salta todo lo que hay entre esas dos marcas, incluido el paso a la línea siguiente. Esta nota puede ocupar una línea o varias. Las dos formas son notas. Ninguna escribe la pantalla. Las barras no se imprimen. Las estrellas no se imprimen. Las palabras que pones entre ellas no se imprimen.

El archivo que conservas

Guarda esto como Mint.java. Es el archivo que esta página conserva. Tiene una nota de línea encima de la orden que escribe, otra nota de línea en la propia línea de esa orden, y una nota de línea encima de main. La orden que escribe sigue ahí, y no está detrás de una barra.

Léelo desde arriba y decide, para cada línea, si la pantalla la recibe. La primera línea sigue siendo public class Mint. Ya sabes que esa línea nombra el archivo y no escribe la pantalla. La línea siguiente es // the file is named Mint.java. Las dos barras empiezan una nota, así que las palabras the file is named Mint.java son para ti. La pantalla no las muestra. Tampoco muestra las barras. La línea public static void main(String[] args) es donde Java empieza, y ninguna de esas palabras está en la pantalla. Eso no ha cambiado.

Dentro de main, la línea // a note for the reader es solo una nota. Java llega a ella, se la salta y pasa a la línea siguiente. La línea siguiente es la que importa: System.out.println("mint"); // the screen is this word. Lee esa línea como dos partes separadas por las barras. Antes de las barras, la orden es System.out.println("mint");. Esa orden escribe mint y termina la línea. Después de las barras, las palabras the screen is this word son una nota. Están en la misma línea que la orden y aun así se saltan. Una nota no tiene que ocupar una línea ella sola. Si escribes // después de una orden ya terminada, la orden se ejecuta y el resto de la línea no. El punto y coma es lo que termina la orden. Las barras después del punto y coma empiezan la nota. Deja ese punto y coma donde está. La pantalla muestra mint. No muestra the screen is this word. No muestra una segunda línea.

Ejecútalo igual que antes. En la carpeta que contiene este Mint.java, escribe javac Mint.java. Cuando el archivo está bien, esa orden no escribe ninguna línea. Las notas no hacen que javac escriba una línea, ni hacen que falle. Después escribe java Mint. No escribas .java después de java. La pantalla muestra mint. Una línea. Sin comillas. Sin barras. Sin segunda línea. La palabra mint sigue siendo la palabra que está entre las comillas. No es una palabra que hayas tecleado en la orden, ni una palabra que hayas tecleado en una nota.

Una nota entre / y /

Esta es la otra forma. La usas cuando la nota es más larga que una línea, o cuando quieres que el final de la nota sea una marca que eliges tú, no el final de la línea. La marca de apertura es /. La marca de cierre es /. Java se salta desde la apertura hasta el cierre, y el primer / es el final. Un / posterior no forma parte de esta nota, porque la nota ya terminó. Esta página usa una nota de esta forma, así que ves una apertura y un cierre.

Sustituye las notas de línea dentro de main por una nota entre / y /, y deja la orden que escribe en su sitio. La pantalla no cambia. Este es el segundo archivo. Estás mirando qué aspecto tiene la nota. El archivo que conservabas usaba notas de línea. Este usa una nota entre / y /. Los dos escriben mint.

La nota empieza en la línea que comienza con /. Las palabras a note están dentro. La línea siguiente, across two lines, también está dentro, porque el / de cierre todavía no está escrito. El / al final de esa segunda línea termina la nota. Después Java ejecuta la orden System.out.println("mint"); porque esa orden está fuera de la nota, debajo de la marca de cierre. La pantalla muestra mint. Las palabras a note y across two lines no están en la pantalla. Las estrellas y las barras no están en la pantalla. Si subes el / para que quede en la primera línea, justo después de a note, la segunda línea ya no está dentro de la nota. Esa segunda línea tendría que ser una línea real de Java, y across two lines no es una orden. javac escribiría un error en lugar de quedarse callado. En esta página el */ se queda al final de la segunda línea, así que toda la nota se salta y javac se queda callado.

No intentes poner una nota de esta forma dentro de otra. El primer / termina la nota, aunque quisieras que ese / terminara una nota interior. Después de esa primera marca de cierre, Java vuelve a leer órdenes. Esta página no mete una nota dentro de otra. Una apertura, un cierre, y después la orden que escribe.

El error que borra mint

La nota y la orden que escribe son líneas distintas, o partes distintas de una línea, en los archivos de arriba. El error es poner las dos barras delante de la orden que escribe, de modo que la orden se convierte en la nota. Guarda este tercer archivo solo hasta ver la pantalla vacía, y luego vuelve a poner la orden que escribe. Este no es el archivo que conservas.

javac Mint.java sigue sin escribir ninguna línea, porque un archivo que solo se salta una nota sigue siendo un archivo válido. Java empieza en main, se salta la única línea de dentro y termina. java Mint no escribe nada. No hay mint. No hay una palabra vacía entre comillas. No hay una segunda línea. La pantalla está en blanco porque la orden que escribía mint quedó detrás de //. Las letras System.out.println("mint") siguen en el archivo, y puedes leerlas, pero ahora son una nota. Las comillas no las salvan. Las comillas marcan una palabra dentro de una orden. No vuelven a convertir una nota en una orden. Las dos barras de delante deciden, y deciden que el resto de la línea es para quien lee.

Vuelve a dejar el archivo en el que conservas. La línea que escribe tiene que ser System.out.println("mint"); y la nota, si la quieres, después del punto y coma. Entonces java Mint escribe mint otra vez. Si la pantalla está en blanco, busca // antes de System.out. Esa es toda la comprobación. No vuelves a instalar Java por una pantalla en blanco causada por una nota.

Una nota puede contener cualquier palabra, también Mint, main y mint. Esas palabras tampoco están en la pantalla. La pantalla usa la palabra que está entre las comillas de una orden que de verdad se ejecuta. En el archivo que conservas, esa palabra es mint, con la m minúscula. Una nota que dice Mint, con la M mayúscula, no hace que la pantalla muestre Mint. Una nota que repite mint no escribe una segunda línea. La ejecución no borra la nota del archivo. Abre el archivo después de java Mint y la nota sigue ahí.

Ya puedes poner una nota en Mint.java sin cambiar la pantalla. Una nota de línea empieza con //. Una nota entre / y / empieza con / y acaba en el primer /. La pantalla del archivo que conservas es mint, escrita por System.out.println("mint"). Si // queda delante de esa orden, la pantalla no tiene ninguna línea. La página siguiente cambia la palabra que está entre las comillas, así que la pantalla muestra una palabra distinta. Las notas de esta página siguen siendo notas.

La pantalla sigue siendo mint

El archivo que conservas escribe mint. Las notas que empiezan con // no están en la pantalla. Una nota entre / y / no está en la pantalla. El primer */ termina esa nota. La pantalla tiene una línea. No hay una segunda línea.