Added convertToAscii method

Author: rijnb

src/main/java/com/mapcode/Mapcode.java

@@ -187,7 +187,7 @@ public enum MapcodeFormatType {
     public static MapcodeFormatType getMapcodeFormatType(@Nonnull final String mapcode) {
 
         // First, decode to ASCII.
-        final String decodedMapcode = Decoder.decodeUTF16(mapcode);
+        final String decodedMapcode = convertToAscii(mapcode);
 
         // Syntax needs to be OK.
         if (!PATTERN_MAPCODE_FORMAT.matcher(decodedMapcode).matches()) {
@@ -218,6 +218,17 @@ public static boolean isValidMapcodeFormat(@Nonnull final String mapcode) {
         return getMapcodeFormatType(mapcode) != MapcodeFormatType.MAPCODE_TYPE_INVALID;
     }
 
+    /**
+     * Convert a mapcode which potentially contains Unicode characters, to an ASCII veriant.
+     *
+     * @param mapcode Mapcode, with optional Unicode characters.
+     * @return ASCII, non-Unicode string.
+     */
+    @Nonnull
+    public static String convertToAscii(@Nonnull final String mapcode) {
+        return Decoder.decodeUTF16(mapcode);
+    }
+
     /**
      * Return the local mapcode string, potentially ambiguous.
      *

src/site/apt/ReleaseNotes.apt.vm

@@ -20,6 +20,9 @@ Release Notes (Version ${project.version})
     if the character 'Z' or equivalent Unicode character is contained in the high precision part according to
     the Mapcode documenation.
 
+    * Added method <<<convertToAscii>>> which produces the ASCII, non-Unicode variant of a mapcode which contains
+    Unicode characters§.
+
     []
 
 * 1.40.1

src/test/java/com/mapcode/MapcodeTest.java

@@ -90,4 +90,11 @@ public void checkMapcodeFormatType() {
         assertEquals(Mapcode.MapcodeFormatType.MAPCODE_TYPE_PRECISION_1, Mapcode.getMapcodeFormatType("AA.BB-1"));
         assertEquals(Mapcode.MapcodeFormatType.MAPCODE_TYPE_PRECISION_2, Mapcode.getMapcodeFormatType("AA.BB-12"));
     }
-}
+
+    @Test
+    public void checkConvertToAscii() {
+        LOG.info("checkConvertToAscii");
+        assertEquals("KM.8K", Mapcode.convertToAscii("\u30c1\u30ca.8\u30c1"));
+        assertEquals("HJ.Q2-Z", Mapcode.convertToAscii("\u0397\u03a0.\u03982-\u0411"));
+    }
+}