feat(lang-enh): 🎸 String Objects, translated

Refers: #4

Author: rcmoutinho

book/02-language-enhancement/sections/01-string-in-switch-and-literals.asc

@@ -1,88 +1,86 @@
 :java-package: src/org/j6toj8/languageenhancements
 :section-java-package: ../../../{java-package}
 
-=== Objetos Strings
+=== String objects
 
-.Objetivo
+.Objective
 ----
 Develop code that uses String objects in the switch statement, binary literals, and numeric literals, including underscores in literals.
--
-Desenvolver código que utilize objetos String em instruções Switch, binários literais, e numéricos literais, incluindo underscore (_) em literais.
 ----
 
-==== String em instruções Switch
+==== String in the switch statement
 
-É esperado que o candidato saiba compreender e analisar o uso de Strings em instruções `switch`, como no seguinte exemplo.
+The candidate is expected to understand and analyze the use of Strings in `switch` statements, as in the following example.
 
 [source,java,indent=0]
 .{java-package}/stringinswitch/StringInSwitch_Complete.java
 ----
 include::{section-java-package}/stringinswitch/StringInSwitch_Complete.java[tag=code]
 ----
 
-Apesar da certificação ter foco nas atualizações trazidas pelo Java 7 e 8, é esperado que o candidato entenda também conceitos de versões anteriores do Java. Por isso, serão apresentadas algumas regras que talvez você já conheça sobre `switch`, mas utilizando `String` no `switch`.
+Although certification focuses on updates brought by Java 7 and 8, the candidate is expected to understand concepts from previous versions of Java as well. Therefore, some rules you may already know about `switch` will be presented but using `String` on the `switch`.
 
-. Todo `case` deve ser único, não pode se repetir.
+. Every `case` must be unique, cannot be repeated.
 
-. O `default` pode aparecer em qualquer posição no `switch`.
+. The `default` can appear anywhere on the `switch`.
 +
 .{java-package}/stringinswitch/StringInSwitch_Default.java
 [source,java,indent=0]
 ----
 include::{section-java-package}/stringinswitch/StringInSwitch_Default.java[tag=code]
 ----
 
-. Tipos suportados em `switch`.
-* int e Integer
-* byte e Byte
-* short e Short
-* char e Character
+. Supported types in `switch`.
+* int and Integer
+* byte and Byte
+* short and Short
+* char and Character
 * String
-* valores de Enums
+* Enums values
 
-. Tipos não suportados em `switch`.
+. Types not supported in `switch`.
 +
 .{java-package}/stringinswitch/StringInSwitch_Type.java
 [source,java,indent=0]
 ----
 include::{section-java-package}/stringinswitch/StringInSwitch_Type.java[tag=code]
 ----
 
-. A execução se inicia em um `case` e somente para ao encontrar um `break`.
+. Execution starts in a `case` and only stops when it encounters a `break`.
 +
 .{java-package}/stringinswitch/StringInSwitch_Break.java
 [source,java,indent=0]
 ----
 include::{section-java-package}/stringinswitch/StringInSwitch_Break.java[tag=code]
 ----
 +
-.saída no console
+.console output
 [source,console]
 ----
-Janeiro
-Não é um mês
-Fevereiro
+January
+Not a month
+February
 ----
 +
-Nesse caso a execução inicia no `case "jan"`, passar pelo `default` e pelo `case "fev"` até parar no `break`, por isso as 3 strings aparecem no console.
+In this case, execution starts in `case "jan "`, goes through `default` and `case "Feb"` until it stops at `break`. So the 3 strings will appear in the console.
 
-. Um `switch` vazio é válido, mesmo que não tenha utilidade.
+. An empty `switch` is valid even if it has no use.
 +
 .{java-package}/stringinswitch/StringInSwitch_Empty.java
 [source,java,indent=0]
 ----
 include::{section-java-package}/stringinswitch/StringInSwitch_Empty.java[tag=code]
 ----
 
-. Todos os valores de `case` precisam ser constantes, ou seja, variáveis finais em tempo de compilação. Se o valor do `case` puder mudar em tempo de execução, o código não compila.
+. All `case` values must be constant, i.e., final variables at compile time. If the value of `case` can change at runtime, the code does not compile.
 +
 .{java-package}/stringinswitch/StringInSwitch_ConstantOnly.java
 [source,java,indent=0]
 ----
 include::{section-java-package}/stringinswitch/StringInSwitch_ConstantOnly.java[tag=code]
 ----
 
-Pronto, essas são as regras de `switch`. Você provavelmente já conheçe algumas referentes à versões anteriores do Java, mas agora você as viu em `switch` que utilizam Strings. Isso não era possível antes do Java 7.
+These are the switch rules. You probably already know some about previous versions of Java, but now you have seen them in `switch` that use Strings. This was not possible before Java 7.
 
 ==== Literais Binários e Numéricos, incluindo underscore( _ )
 

src/org/j6toj8/languageenhancements/stringinswitch/StringInSwitch_Break.java

@@ -5,18 +5,18 @@ public class StringInSwitch_Break {
   // tag::code[]
   public static void main(String[] args) {
 
-    String mes = "jan";
+    String month = "jan";
 
-    switch (mes) {
+    switch (month) {
     case "jan":
-      System.out.println("Janeiro");
+      System.out.println("January");
     default:
-      System.out.println("Não é um mês");
-    case "fev":
-      System.out.println("Fevereiro");
+      System.out.println("Not a month");
+    case "feb":
+      System.out.println("February");
       break;
     case "mar":
-      System.out.println("Março");
+      System.out.println("March");
       break;
     }
   }

src/org/j6toj8/languageenhancements/stringinswitch/StringInSwitch_Complete.java

@@ -5,17 +5,17 @@ public class StringInSwitch_Complete {
   // tag::code[]
   public static void main(String[] args) {
 
-    String mes = "jan";
+    String month = "jan";
 
-    switch (mes) {
+    switch (month) {
     case "jan":
-      System.out.println("Janeiro");
+      System.out.println("January");
       break;
-    case "fev":
-      System.out.println("Fevereiro");
+    case "feb":
+      System.out.println("February");
       break;
     case "mar":
-      System.out.println("Março");
+      System.out.println("March");
       break;
     default:
       break;

src/org/j6toj8/languageenhancements/stringinswitch/StringInSwitch_ConstantOnly.java

@@ -3,31 +3,31 @@
 public class StringInSwitch_ConstantOnly {
 
   // tag::code[]
-  private static final String FEV = "fev";
+  private static final String FEB = "feb";
   private static String jan = "jan";
 
-  public static void getNomeMes(final String mai) {
+  public static void getMonthName(final String may) {
 
-    String mes = "jan";
+    String month = "jan";
 
     final String mar = "mar";
-    String abr = "abr";
+    String apr = "apr";
 
-    switch (mes) {
-    case jan: // NÃO COMPILA - jan é um atributo comum, pode mudar em tempo de execução
-      System.out.println("Janeiro");
+    switch (month) {
+    case jan: // WON'T COMPILE - jan is a common attribute, can change at runtime
+      System.out.println("January");
       break;
-    case FEV: // COMPILA - FEV é uma constante em tempo de compilação, seu valor nunca muda
-      System.out.println("Fevereiro");
+    case FEB: // COMPILES - FEB is a compilation time constant, its value never changes
+      System.out.println("February");
       break;
-    case mar: // COMPILA - mar é uma constante em tempo de compilação, seu valor nunca muda
-      System.out.println("Março");
+    case mar: // COMPILES - mar is a constant at compilation time, its value never changes
+      System.out.println("March");
       break;
-    case abr: // NÃO COMPILA - abr é uma variável comum, pode mudar em tempo de execução
-      System.out.println("Março");
+    case apr: // WON'T COMPILE - apr is a common variable, can change at runtime
+      System.out.println("April");
       break;
-    case mai: // NÃO COMPILA - mai é final, mas não é constante, pode mudar em tempo de execução
-      System.out.println("Março");
+    case may: // WON'T COMPILE - may is final but not constant, may change at runtime
+      System.out.println("May");
       break;
      }
   }

src/org/j6toj8/languageenhancements/stringinswitch/StringInSwitch_Default.java

@@ -4,20 +4,20 @@ public class StringInSwitch_Default {
 
   // tag::code[]
   public static void main(String[] args) {
-    
-    String mes = "jan";
-    
-    switch (mes) {
+
+    String month = "jan";
+
+    switch (month) {
     case "jan":
-      System.out.println("Janeiro");
+      System.out.println("January");
       break;
-    default: // COMPILA - O default pode estar em qualquer posição
+    default: // COMPILES - `Default` can be in any position
       break;
-    case "jan": // NÃO COMPILA - Já existe o case "jan"
-      System.out.println("Janeiro2");
+    case "jan": // WON'T COMPILE - There is already case "jan"
+      System.out.println("January2");
       break;
     case "mar":
-      System.out.println("Março");
+      System.out.println("March");
       break;
     }
   }

src/org/j6toj8/languageenhancements/stringinswitch/StringInSwitch_Empty.java

@@ -5,8 +5,8 @@ public class StringInSwitch_Empty {
   // tag::code[]
   public static void main(String[] args) {
 
-    String mes = "jan";
-    switch (mes) {} // COMPILA - switch pode estar vazio, mesmo que seja inútil
+    String month = "jan";
+    switch (month) {} // COMPILES - switch may be empty even if it's useless
   }
   // end::code[]
 }

src/org/j6toj8/languageenhancements/stringinswitch/StringInSwitch_Type.java

@@ -5,14 +5,14 @@ public class StringInSwitch_Type {
   // tag::code[]
   public static void main(String[] args) {
 
-    Long mes = 1L;
+    Long month = 1L;
 
-    switch (mes) { // NÃO COMPILA - Long não é um tipo suportado
+    switch (month) { // WON'T COMPILE - Long is not a supported type.
     case 1L:
-      System.out.println("Janeiro");
+      System.out.println("January");
       break;
     case 2L:
-      System.out.println("Fevereiro");
+      System.out.println("February");
       break;
     default:
       break;