Merge branch 'master' into bag_improve

Author: Hardvan

DIRECTORY.md

@@ -775,6 +775,7 @@
             * [OctalToHexadecimalTest](https://github.com/TheAlgorithms/Java/blob/master/src/test/java/com/thealgorithms/conversions/OctalToHexadecimalTest.java)
             * [PhoneticAlphabetConverterTest](https://github.com/TheAlgorithms/Java/blob/master/src/test/java/com/thealgorithms/conversions/PhoneticAlphabetConverterTest.java)
             * [RomanToIntegerTest](https://github.com/TheAlgorithms/Java/blob/master/src/test/java/com/thealgorithms/conversions/RomanToIntegerTest.java)
+            * [TurkishToLatinConversionTest](https://github.com/TheAlgorithms/Java/blob/master/src/test/java/com/thealgorithms/conversions/TurkishToLatinConversionTest.java)
             * [UnitConversionsTest](https://github.com/TheAlgorithms/Java/blob/master/src/test/java/com/thealgorithms/conversions/UnitConversionsTest.java)
             * [UnitsConverterTest](https://github.com/TheAlgorithms/Java/blob/master/src/test/java/com/thealgorithms/conversions/UnitsConverterTest.java)
           * datastructures

src/main/java/com/thealgorithms/conversions/OctalToBinary.java

@@ -1,14 +1,40 @@
 package com.thealgorithms.conversions;
 
 /**
- * Converts any Octal Number to a Binary Number
+ * A utility class to convert an octal (base-8) number into its binary (base-2) representation.
+ *
+ * <p>This class provides methods to:
+ * <ul>
+ *     <li>Convert an octal number to its binary equivalent</li>
+ *     <li>Convert individual octal digits to binary</li>
+ * </ul>
+ *
+ * <h2>Octal to Binary Conversion:</h2>
+ * <p>An octal number is converted to binary by converting each octal digit to its 3-bit binary equivalent.
+ * The result is a long representing the full binary equivalent of the octal number.</p>
+ *
+ * <h2>Example Usage</h2>
+ * <pre>
+ *   long binary = OctalToBinary.convertOctalToBinary(52); // Output: 101010 (52 in octal is 101010 in binary)
+ * </pre>
  *
  * @author Bama Charan Chhandogi
+ * @see <a href="https://en.wikipedia.org/wiki/Octal">Octal Number System</a>
+ * @see <a href="https://en.wikipedia.org/wiki/Binary_number">Binary Number System</a>
  */
-
 public final class OctalToBinary {
     private OctalToBinary() {
     }
+
+    /**
+     * Converts an octal number to its binary representation.
+     *
+     * <p>Each octal digit is individually converted to its 3-bit binary equivalent, and the binary
+     * digits are concatenated to form the final binary number.</p>
+     *
+     * @param octalNumber the octal number to convert (non-negative integer)
+     * @return the binary equivalent as a long
+     */
     public static long convertOctalToBinary(int octalNumber) {
         long binaryNumber = 0;
         int digitPosition = 1;
@@ -20,12 +46,25 @@ public static long convertOctalToBinary(int octalNumber) {
             binaryNumber += binaryDigit * digitPosition;
 
             octalNumber /= 10;
-            digitPosition *= 1000; // Move to the next group of 3 binary digits
+            digitPosition *= 1000;
         }
 
         return binaryNumber;
     }
 
+    /**
+     * Converts a single octal digit (0-7) to its binary equivalent.
+     *
+     * <p>For example:
+     * <ul>
+     *     <li>Octal digit 7 is converted to binary 111</li>
+     *     <li>Octal digit 3 is converted to binary 011</li>
+     * </ul>
+     * </p>
+     *
+     * @param octalDigit a single octal digit (0-7)
+     * @return the binary equivalent as a long
+     */
     public static long convertOctalDigitToBinary(int octalDigit) {
         long binaryDigit = 0;
         int binaryMultiplier = 1;

src/main/java/com/thealgorithms/conversions/PhoneticAlphabetConverter.java

@@ -58,9 +58,25 @@ private PhoneticAlphabetConverter() {
         PHONETIC_MAP.put('9', "Nine");
     }
 
+    /**
+     * Converts text to the NATO phonetic alphabet.
+     * Steps:
+     * 1. Convert the text to uppercase.
+     * 2. Iterate over each character in the text.
+     * 3. Get the phonetic equivalent of the character from the map.
+     * 4. Append the phonetic equivalent to the result.
+     * 5. Append a space to separate the phonetic equivalents.
+     * 6. Return the result.
+     *
+     * @param text the text to convert
+     * @return the NATO phonetic alphabet
+     */
     public static String textToPhonetic(String text) {
         StringBuilder phonetic = new StringBuilder();
         for (char c : text.toUpperCase().toCharArray()) {
+            if (Character.isWhitespace(c)) {
+                continue;
+            }
             phonetic.append(PHONETIC_MAP.getOrDefault(c, String.valueOf(c))).append(" ");
         }
         return phonetic.toString().trim();

src/main/java/com/thealgorithms/conversions/TurkishToLatinConversion.java

@@ -1,7 +1,5 @@
 package com.thealgorithms.conversions;
 
-import java.util.Scanner;
-
 /**
  * Converts turkish character to latin character
  *
@@ -11,21 +9,12 @@ public final class TurkishToLatinConversion {
     private TurkishToLatinConversion() {
     }
 
-    /**
-     * Main method
-     *
-     * @param args Command line arguments
-     */
-    public static void main(String[] args) {
-        Scanner sc = new Scanner(System.in);
-        System.out.println("Input the string: ");
-        String b = sc.next();
-        System.out.println("Converted: " + convertTurkishToLatin(b));
-        sc.close();
-    }
-
     /**
      * This method converts a turkish character to latin character.
+     * Steps:
+     * 1. Define turkish characters and their corresponding latin characters
+     * 2. Replace all turkish characters with their corresponding latin characters
+     * 3. Return the converted string
      *
      * @param param String paramter
      * @return String

src/test/java/com/thealgorithms/conversions/OctalToBinaryTest.java

@@ -12,4 +12,24 @@ public void testConvertOctalToBinary() {
         assertEquals(101010, OctalToBinary.convertOctalToBinary(52));
         assertEquals(110, OctalToBinary.convertOctalToBinary(6));
     }
+
+    @Test
+    public void testConvertOctalToBinarySingleDigit() {
+        assertEquals(0, OctalToBinary.convertOctalToBinary(0));
+        assertEquals(1, OctalToBinary.convertOctalToBinary(1));
+        assertEquals(111, OctalToBinary.convertOctalToBinary(7));
+    }
+
+    @Test
+    public void testConvertOctalToBinaryMultipleDigits() {
+        assertEquals(100110111, OctalToBinary.convertOctalToBinary(467));
+        assertEquals(111101, OctalToBinary.convertOctalToBinary(75));
+        assertEquals(111100101, OctalToBinary.convertOctalToBinary(745));
+    }
+
+    @Test
+    public void testConvertOctalToBinaryWithZeroPadding() {
+        assertEquals(100001010, OctalToBinary.convertOctalToBinary(412));
+        assertEquals(101101110, OctalToBinary.convertOctalToBinary(556));
+    }
 }

src/test/java/com/thealgorithms/conversions/PhoneticAlphabetConverterTest.java

@@ -2,20 +2,26 @@
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
-import org.junit.jupiter.api.Test;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.CsvSource;
 
 public class PhoneticAlphabetConverterTest {
 
-    @Test
-    public void testTextToPhonetic() {
-        assertEquals("Alpha Bravo", PhoneticAlphabetConverter.textToPhonetic("AB"));
-        assertEquals("Alpha Bravo Charlie", PhoneticAlphabetConverter.textToPhonetic("ABC"));
-        assertEquals("Alpha One Bravo Two Charlie Three", PhoneticAlphabetConverter.textToPhonetic("A1B2C3"));
-        assertEquals("Hotel Echo Lima Lima Oscar", PhoneticAlphabetConverter.textToPhonetic("Hello"));
-        assertEquals("One Two Three", PhoneticAlphabetConverter.textToPhonetic("123"));
-        assertEquals("Alpha Bravo Charlie Delta Echo Foxtrot Golf Hotel India Juliett Kilo Lima Mike November Oscar Papa Quebec Romeo Sierra Tango Uniform Victor Whiskey X-ray Yankee Zulu Zero One Two Three Four Five Six Seven Eight Nine",
-            PhoneticAlphabetConverter.textToPhonetic("ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"));
-        assertEquals("Alpha Bravo Charlie Delta Echo Foxtrot Golf Hotel India Juliett Kilo Lima Mike November Oscar Papa Quebec Romeo Sierra Tango Uniform Victor Whiskey X-ray Yankee Zulu Zero One Two Three Four Five Six Seven Eight Nine",
-            PhoneticAlphabetConverter.textToPhonetic("abcdefghijklmnopqrstuvwxyz0123456789"));
+    @ParameterizedTest
+    @CsvSource({
+        "'AB', 'Alpha Bravo'", "'ABC', 'Alpha Bravo Charlie'", "'A1B2C3', 'Alpha One Bravo Two Charlie Three'", "'Hello', 'Hotel Echo Lima Lima Oscar'", "'123', 'One Two Three'",
+        "'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789', 'Alpha Bravo Charlie Delta Echo Foxtrot Golf Hotel India Juliett Kilo Lima Mike November Oscar Papa Quebec Romeo Sierra Tango Uniform Victor Whiskey X-ray Yankee Zulu Zero One Two Three Four Five Six Seven Eight Nine'",
+        "'abcdefghijklmnopqrstuvwxyz0123456789', 'Alpha Bravo Charlie Delta Echo Foxtrot Golf Hotel India Juliett Kilo Lima Mike November Oscar Papa Quebec Romeo Sierra Tango Uniform Victor Whiskey X-ray Yankee Zulu Zero One Two Three Four Five Six Seven Eight Nine'",
+        "'', ''", // Empty string case
+        "'A B C', 'Alpha Bravo Charlie'", // String with spaces
+        "'A@B#C', 'Alpha @ Bravo # Charlie'", // Special characters
+        "'A B C 123', 'Alpha Bravo Charlie One Two Three'", // Mixed letters, digits, and spaces
+        "'a b c', 'Alpha Bravo Charlie'", // Lowercase letters with spaces
+        "'123!@#', 'One Two Three ! @ #'", // Numbers with special characters
+        "'HELLO WORLD', 'Hotel Echo Lima Lima Oscar Whiskey Oscar Romeo Lima Delta'" // Words with space
+    })
+    public void
+    testTextToPhonetic(String input, String expectedOutput) {
+        assertEquals(expectedOutput, PhoneticAlphabetConverter.textToPhonetic(input));
     }
 }

src/test/java/com/thealgorithms/conversions/TurkishToLatinConversionTest.java

@@ -0,0 +1,31 @@
+package com.thealgorithms.conversions;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.CsvSource;
+
+public class TurkishToLatinConversionTest {
+
+    @ParameterizedTest
+    @CsvSource({
+        "'çalışma', 'calisma'", // Turkish to Latin conversion for lowercase
+        "'ÇALIŞMA', 'CALISMA'", // Turkish to Latin conversion for uppercase
+        "'İSTANBUL', 'ISTANBUL'", // Special case of 'İ' to 'I'
+        "'istanbul', 'istanbul'", // Special case of 'ı' to 'i'
+        "'GÜL', 'GUL'", // Special case of 'Ü' to 'U'
+        "'gül', 'gul'", // Special case of 'ü' to 'u'
+        "'ÖĞRENME', 'OGRENME'", // Special case of 'Ö' to 'O' and 'Ğ' to 'G'
+        "'öğrenme', 'ogrenme'", // Special case of 'ö' to 'o' and 'ğ' to 'g'
+        "'ŞEHIR', 'SEHIR'", // Special case of 'Ş' to 'S'
+        "'şehir', 'sehir'", // Special case of 'ş' to 's'
+        "'HELLO', 'HELLO'", // String with no Turkish characters, should remain unchanged
+        "'Merhaba Dünya!', 'Merhaba Dunya!'", // Mixed Turkish and Latin characters with punctuation
+        "'Çift kişilik yataklı odalar', 'Cift kisilik yatakli odalar'", // Full sentence conversion
+        "'', ''" // Empty string case
+    })
+    public void
+    testConvertTurkishToLatin(String input, String expectedOutput) {
+        assertEquals(expectedOutput, TurkishToLatinConversion.convertTurkishToLatin(input));
+    }
+}