Formatted source
[jalview.git] / src / jalview / util / Format.java
index 798dc8f..4c47f65 100755 (executable)
  * @version 1.03 25 Oct 1997\r
  * @author Cay Horstmann\r
  */\r
-\r
-\r
 package jalview.util;\r
 \r
 import java.io.*;\r
 \r
+\r
 public class Format {\r
+    private int width;\r
+    private int precision;\r
+    private String pre;\r
+    private String post;\r
+    private boolean leading_zeroes;\r
+    private boolean show_plus;\r
+    private boolean alternate;\r
+    private boolean show_space;\r
+    private boolean left_align;\r
+    private char fmt; // one of cdeEfgGiosxXos\r
+\r
+    public Format(String s) {\r
+        width = 0;\r
+        precision = -1;\r
+        pre = "";\r
+        post = "";\r
+        leading_zeroes = false;\r
+        show_plus = false;\r
+        alternate = false;\r
+        show_space = false;\r
+        left_align = false;\r
+        fmt = ' ';\r
+\r
+        int state = 0;\r
+        int length = s.length();\r
+        int parse_state = 0;\r
+\r
+        // 0 = prefix, 1 = flags, 2 = width, 3 = precision,\r
+        // 4 = format, 5 = end\r
+        int i = 0;\r
+\r
+        while (parse_state == 0) {\r
+            if (i >= length) {\r
+                parse_state = 5;\r
+            } else if (s.charAt(i) == '%') {\r
+                if (i < (length - 1)) {\r
+                    if (s.charAt(i + 1) == '%') {\r
+                        pre = pre + '%';\r
+                        i++;\r
+                    } else {\r
+                        parse_state = 1;\r
+                    }\r
+                } else {\r
+                    throw new java.lang.IllegalArgumentException();\r
+                }\r
+            } else {\r
+                pre = pre + s.charAt(i);\r
+            }\r
+\r
+            i++;\r
+        }\r
+\r
+        while (parse_state == 1) {\r
+            if (i >= length) {\r
+                parse_state = 5;\r
+            } else if (s.charAt(i) == ' ') {\r
+                show_space = true;\r
+            } else if (s.charAt(i) == '-') {\r
+                left_align = true;\r
+            } else if (s.charAt(i) == '+') {\r
+                show_plus = true;\r
+            } else if (s.charAt(i) == '0') {\r
+                leading_zeroes = true;\r
+            } else if (s.charAt(i) == '#') {\r
+                alternate = true;\r
+            } else {\r
+                parse_state = 2;\r
+                i--;\r
+            }\r
+\r
+            i++;\r
+        }\r
+\r
+        while (parse_state == 2) {\r
+            if (i >= length) {\r
+                parse_state = 5;\r
+            } else if (('0' <= s.charAt(i)) && (s.charAt(i) <= '9')) {\r
+                width = ((width * 10) + s.charAt(i)) - '0';\r
+                i++;\r
+            } else if (s.charAt(i) == '.') {\r
+                parse_state = 3;\r
+                precision = 0;\r
+                i++;\r
+            } else {\r
+                parse_state = 4;\r
+            }\r
+        }\r
+\r
+        while (parse_state == 3) {\r
+            if (i >= length) {\r
+                parse_state = 5;\r
+            } else if (('0' <= s.charAt(i)) && (s.charAt(i) <= '9')) {\r
+                precision = ((precision * 10) + s.charAt(i)) - '0';\r
+                i++;\r
+            } else {\r
+                parse_state = 4;\r
+            }\r
+        }\r
+\r
+        if (parse_state == 4) {\r
+            if (i >= length) {\r
+                parse_state = 5;\r
+            } else {\r
+                fmt = s.charAt(i);\r
+            }\r
+\r
+            i++;\r
+        }\r
+\r
+        if (i < length) {\r
+            post = s.substring(i, length);\r
+        }\r
+    }\r
+\r
     /**\r
      * Formats the number following printf conventions.\r
      * Main limitation: Can only handle one format parameter at a time\r
@@ -68,565 +181,525 @@ public class Format {
      * @exception IllegalArgumentException if bad format\r
      *\r
      */\r
+    public static String getHexString(java.awt.Color color) {\r
+        String r;\r
+        String g;\r
+        String b;\r
+        r = Integer.toHexString(color.getRed());\r
+\r
+        if (r.length() < 2) {\r
+            r = "0" + r;\r
+        }\r
 \r
-  public static String getHexString(java.awt.Color color)\r
-  {\r
-    String r, g, b;\r
-    r = Integer.toHexString(color.getRed());\r
-    if (r.length() < 2)\r
-      r = "0" + r;\r
-    g = Integer.toHexString(color.getGreen());\r
-    if (g.length() < 2)\r
-      g = "0" + g;\r
-    b = Integer.toHexString(color.getBlue());\r
-    if (b.length() < 2)\r
-      b = "0" + b;\r
-\r
-    return r+g+b;\r
-  }\r
-\r
-\r
-  public Format(String s) {\r
-    width = 0;\r
-    precision = -1;\r
-    pre = "";\r
-    post = "";\r
-    leading_zeroes = false;\r
-    show_plus = false;\r
-    alternate = false;\r
-    show_space = false;\r
-    left_align = false;\r
-    fmt = ' ';\r
-\r
-    int state = 0;\r
-    int length = s.length();\r
-    int parse_state = 0;\r
-    // 0 = prefix, 1 = flags, 2 = width, 3 = precision,\r
-    // 4 = format, 5 = end\r
-    int i = 0;\r
-\r
-    while (parse_state == 0) {\r
-      if (i >= length)\r
-        parse_state = 5;\r
-      else if (s.charAt(i) == '%') {\r
-        if (i < length - 1) {\r
-          if (s.charAt(i + 1) == '%') {\r
-            pre = pre + '%';\r
-            i++;\r
-          } else\r
-            parse_state = 1;\r
-        } else\r
-          throw new java.lang.IllegalArgumentException();\r
-      } else\r
-        pre = pre + s.charAt(i);\r
-      i++;\r
+        g = Integer.toHexString(color.getGreen());\r
+\r
+        if (g.length() < 2) {\r
+            g = "0" + g;\r
+        }\r
+\r
+        b = Integer.toHexString(color.getBlue());\r
+\r
+        if (b.length() < 2) {\r
+            b = "0" + b;\r
+        }\r
+\r
+        return r + g + b;\r
     }\r
-    while (parse_state == 1) {\r
-      if (i >= length)\r
-        parse_state = 5;\r
-      else if (s.charAt(i) == ' ')\r
-        show_space = true;\r
-      else if (s.charAt(i) == '-')\r
-        left_align = true;\r
-      else if (s.charAt(i) == '+')\r
-        show_plus = true;\r
-      else if (s.charAt(i) == '0')\r
-        leading_zeroes = true;\r
-      else if (s.charAt(i) == '#')\r
-        alternate = true;\r
-      else {\r
-        parse_state = 2;\r
-        i--;\r
-      }\r
-      i++;\r
+\r
+    /**\r
+    * prints a formatted number following printf conventions\r
+    * @param s a PrintStream\r
+    * @param fmt the format string\r
+    * @param x the double to print\r
+    */\r
+    public static void print(java.io.PrintStream s, String fmt, double x) {\r
+        s.print(new Format(fmt).form(x));\r
     }\r
-    while (parse_state == 2) {\r
-      if (i >= length)\r
-        parse_state = 5;\r
-      else if ('0' <= s.charAt(i) && s.charAt(i) <= '9') {\r
-        width = width * 10 + s.charAt(i) - '0';\r
-        i++;\r
-      } else if (s.charAt(i) == '.') {\r
-        parse_state = 3;\r
-        precision = 0;\r
-        i++;\r
-      } else\r
-        parse_state = 4;\r
+\r
+    /**\r
+    * prints a formatted number following printf conventions\r
+    * @param s a PrintStream\r
+    * @param fmt the format string\r
+    * @param x the long to print\r
+    */\r
+    public static void print(java.io.PrintStream s, String fmt, long x) {\r
+        s.print(new Format(fmt).form(x));\r
     }\r
-    while (parse_state == 3) {\r
-      if (i >= length)\r
-        parse_state = 5;\r
-      else if ('0' <= s.charAt(i) && s.charAt(i) <= '9') {\r
-        precision = precision * 10 + s.charAt(i) - '0';\r
-        i++;\r
-      } else\r
-        parse_state = 4;\r
+\r
+    /**\r
+    * prints a formatted number following printf conventions\r
+    * @param s a PrintStream\r
+    * @param fmt the format string\r
+    * @param x the character to\r
+    */\r
+    public static void print(java.io.PrintStream s, String fmt, char x) {\r
+        s.print(new Format(fmt).form(x));\r
     }\r
-    if (parse_state == 4) {\r
-      if (i >= length)\r
-        parse_state = 5;\r
-      else\r
-        fmt = s.charAt(i);\r
-      i++;\r
+\r
+    /**\r
+    * prints a formatted number following printf conventions\r
+    * @param s a PrintStream, fmt the format string\r
+    * @param x a string that represents the digits to print\r
+    */\r
+    public static void print(java.io.PrintStream s, String fmt, String x) {\r
+        s.print(new Format(fmt).form(x));\r
     }\r
-    if (i < length)\r
-      post = s.substring(i, length);\r
-  }\r
-\r
-  /**\r
-  * prints a formatted number following printf conventions\r
-  * @param s a PrintStream\r
-  * @param fmt the format string\r
-  * @param x the double to print\r
-  */\r
-\r
-  public static void print(java.io.PrintStream s, String fmt, double x) {\r
-    s.print(new Format(fmt).form(x));\r
-  }\r
-\r
-  /**\r
-  * prints a formatted number following printf conventions\r
-  * @param s a PrintStream\r
-  * @param fmt the format string\r
-  * @param x the long to print\r
-  */\r
-  public static void print(java.io.PrintStream s, String fmt, long x) {\r
-    s.print(new Format(fmt).form(x));\r
-  }\r
-\r
-  /**\r
-  * prints a formatted number following printf conventions\r
-  * @param s a PrintStream\r
-  * @param fmt the format string\r
-  * @param x the character to\r
-  */\r
-\r
-  public static void print(java.io.PrintStream s, String fmt, char x) {\r
-    s.print(new Format(fmt).form(x));\r
-  }\r
-\r
-  /**\r
-  * prints a formatted number following printf conventions\r
-  * @param s a PrintStream, fmt the format string\r
-  * @param x a string that represents the digits to print\r
-  */\r
-\r
-  public static void print(java.io.PrintStream s, String fmt, String x) {\r
-    s.print(new Format(fmt).form(x));\r
-  }\r
-\r
-  /**\r
-  * Converts a string of digits (decimal, octal or hex) to an integer\r
-  * @param s a string\r
-  * @return the numeric value of the prefix of s representing a base 10 integer\r
-  */\r
-\r
-  public static int atoi(String s) {\r
-    return (int)atol(s);\r
-  }\r
-\r
-  /**\r
-  * Converts a string of digits (decimal, octal or hex) to a long integer\r
-  * @param s a string\r
-  * @return the numeric value of the prefix of s representing a base 10 integer\r
-  */\r
-\r
-  public static long atol(String s) {\r
-    int i = 0;\r
-\r
-    while (i < s.length() && Character.isWhitespace(s.charAt(i)))\r
-      i++;\r
-    if (i < s.length() && s.charAt(i) == '0') {\r
-      if (i + 1 < s.length() && (s.charAt(i + 1) == 'x' || s.charAt(i + 1) == 'X'))\r
-        return parseLong(s.substring(i + 2), 16);\r
-      else\r
-        return parseLong(s, 8);\r
-    } else\r
-      return parseLong(s, 10);\r
-  }\r
-\r
-  private static long parseLong(String s, int base) {\r
-    int i = 0;\r
-    int sign = 1;\r
-    long r = 0;\r
-\r
-    while (i < s.length() && Character.isWhitespace(s.charAt(i)))\r
-      i++;\r
-    if (i < s.length() && s.charAt(i) == '-') {\r
-      sign = -1;\r
-      i++;\r
-    } else if (i < s.length() && s.charAt(i) == '+') {\r
-      i++;\r
+\r
+    /**\r
+    * Converts a string of digits (decimal, octal or hex) to an integer\r
+    * @param s a string\r
+    * @return the numeric value of the prefix of s representing a base 10 integer\r
+    */\r
+    public static int atoi(String s) {\r
+        return (int) atol(s);\r
     }\r
-    while (i < s.length()) {\r
-      char ch = s.charAt(i);\r
-      if ('0' <= ch && ch < '0' + base)\r
-        r = r * base + ch - '0';\r
-      else if ('A' <= ch && ch < 'A' + base - 10)\r
-        r = r * base + ch - 'A' + 10 ;\r
-      else if ('a' <= ch && ch < 'a' + base - 10)\r
-        r = r * base + ch - 'a' + 10 ;\r
-      else\r
-        return r * sign;\r
-      i++;\r
+\r
+    /**\r
+    * Converts a string of digits (decimal, octal or hex) to a long integer\r
+    * @param s a string\r
+    * @return the numeric value of the prefix of s representing a base 10 integer\r
+    */\r
+    public static long atol(String s) {\r
+        int i = 0;\r
+\r
+        while ((i < s.length()) && Character.isWhitespace(s.charAt(i)))\r
+            i++;\r
+\r
+        if ((i < s.length()) && (s.charAt(i) == '0')) {\r
+            if (((i + 1) < s.length()) &&\r
+                    ((s.charAt(i + 1) == 'x') || (s.charAt(i + 1) == 'X'))) {\r
+                return parseLong(s.substring(i + 2), 16);\r
+            } else {\r
+                return parseLong(s, 8);\r
+            }\r
+        } else {\r
+            return parseLong(s, 10);\r
+        }\r
     }\r
-    return r * sign;\r
-  }\r
-\r
-  /**\r
-  * Converts a string of digits to an double\r
-  * @param s a string\r
-  */\r
-\r
-  public static double atof(String s) {\r
-    int i = 0;\r
-    int sign = 1;\r
-    double r = 0; // integer part\r
-    double f = 0; // fractional part\r
-    double p = 1; // exponent of fractional part\r
-    int state = 0; // 0 = int part, 1 = frac part\r
-\r
-    while (i < s.length() && Character.isWhitespace(s.charAt(i)))\r
-      i++;\r
-    if (i < s.length() && s.charAt(i) == '-') {\r
-      sign = -1;\r
-      i++;\r
-    } else if (i < s.length() && s.charAt(i) == '+') {\r
-      i++;\r
+\r
+    private static long parseLong(String s, int base) {\r
+        int i = 0;\r
+        int sign = 1;\r
+        long r = 0;\r
+\r
+        while ((i < s.length()) && Character.isWhitespace(s.charAt(i)))\r
+            i++;\r
+\r
+        if ((i < s.length()) && (s.charAt(i) == '-')) {\r
+            sign = -1;\r
+            i++;\r
+        } else if ((i < s.length()) && (s.charAt(i) == '+')) {\r
+            i++;\r
+        }\r
+\r
+        while (i < s.length()) {\r
+            char ch = s.charAt(i);\r
+\r
+            if (('0' <= ch) && (ch < ('0' + base))) {\r
+                r = ((r * base) + ch) - '0';\r
+            } else if (('A' <= ch) && (ch < (('A' + base) - 10))) {\r
+                r = ((r * base) + ch) - 'A' + 10;\r
+            } else if (('a' <= ch) && (ch < (('a' + base) - 10))) {\r
+                r = ((r * base) + ch) - 'a' + 10;\r
+            } else {\r
+                return r * sign;\r
+            }\r
+\r
+            i++;\r
+        }\r
+\r
+        return r * sign;\r
     }\r
-    while (i < s.length()) {\r
-      char ch = s.charAt(i);\r
-      if ('0' <= ch && ch <= '9') {\r
-        if (state == 0)\r
-          r = r * 10 + ch - '0';\r
-        else if (state == 1) {\r
-          p = p / 10;\r
-          r = r + p * (ch - '0');\r
-        }\r
-      } else if (ch == '.') {\r
-        if (state == 0)\r
-          state = 1;\r
-        else\r
-          return sign * r;\r
-      } else if (ch == 'e' || ch == 'E') {\r
-        long e = (int)parseLong(s.substring(i + 1), 10);\r
-        return sign * r * Math.pow(10, e);\r
-      } else\r
+\r
+    /**\r
+    * Converts a string of digits to an double\r
+    * @param s a string\r
+    */\r
+    public static double atof(String s) {\r
+        int i = 0;\r
+        int sign = 1;\r
+        double r = 0; // integer part\r
+        double f = 0; // fractional part\r
+        double p = 1; // exponent of fractional part\r
+        int state = 0; // 0 = int part, 1 = frac part\r
+\r
+        while ((i < s.length()) && Character.isWhitespace(s.charAt(i)))\r
+            i++;\r
+\r
+        if ((i < s.length()) && (s.charAt(i) == '-')) {\r
+            sign = -1;\r
+            i++;\r
+        } else if ((i < s.length()) && (s.charAt(i) == '+')) {\r
+            i++;\r
+        }\r
+\r
+        while (i < s.length()) {\r
+            char ch = s.charAt(i);\r
+\r
+            if (('0' <= ch) && (ch <= '9')) {\r
+                if (state == 0) {\r
+                    r = ((r * 10) + ch) - '0';\r
+                } else if (state == 1) {\r
+                    p = p / 10;\r
+                    r = r + (p * (ch - '0'));\r
+                }\r
+            } else if (ch == '.') {\r
+                if (state == 0) {\r
+                    state = 1;\r
+                } else {\r
+                    return sign * r;\r
+                }\r
+            } else if ((ch == 'e') || (ch == 'E')) {\r
+                long e = (int) parseLong(s.substring(i + 1), 10);\r
+\r
+                return sign * r * Math.pow(10, e);\r
+            } else {\r
+                return sign * r;\r
+            }\r
+\r
+            i++;\r
+        }\r
+\r
         return sign * r;\r
-      i++;\r
     }\r
-    return sign * r;\r
-  }\r
-\r
-  /**\r
-  * Formats a double into a string (like sprintf in C)\r
-  * @param x the number to format\r
-  * @return the formatted string\r
-  * @exception IllegalArgumentException if bad argument\r
-  */\r
-\r
-  public String form(double x) {\r
-    String r;\r
-    if (precision < 0)\r
-      precision = 6;\r
-    int s = 1;\r
-    if (x < 0) {\r
-      x = -x;\r
-      s = -1;\r
+\r
+    /**\r
+    * Formats a double into a string (like sprintf in C)\r
+    * @param x the number to format\r
+    * @return the formatted string\r
+    * @exception IllegalArgumentException if bad argument\r
+    */\r
+    public String form(double x) {\r
+        String r;\r
+\r
+        if (precision < 0) {\r
+            precision = 6;\r
+        }\r
+\r
+        int s = 1;\r
+\r
+        if (x < 0) {\r
+            x = -x;\r
+            s = -1;\r
+        }\r
+\r
+        if (fmt == 'f') {\r
+            r = fixed_format(x);\r
+        } else if ((fmt == 'e') || (fmt == 'E') || (fmt == 'g') ||\r
+                (fmt == 'G')) {\r
+            r = exp_format(x);\r
+        } else {\r
+            throw new java.lang.IllegalArgumentException();\r
+        }\r
+\r
+        return pad(sign(s, r));\r
     }\r
-    if (fmt == 'f')\r
-      r = fixed_format(x);\r
-    else if (fmt == 'e' || fmt == 'E' || fmt == 'g' || fmt == 'G')\r
-      r = exp_format(x);\r
-    else\r
-      throw new java.lang.IllegalArgumentException();\r
-\r
-    return pad(sign(s, r));\r
-  }\r
-\r
-  /**\r
-  * Formats a long integer into a string (like sprintf in C)\r
-  * @param x the number to format\r
-  * @return the formatted string\r
-  */\r
-\r
-  public String form(long x) {\r
-    String r;\r
-    int s = 0;\r
-    if (fmt == 'd' || fmt == 'i') {\r
-      if (x < 0) {\r
-        r = ("" + x).substring(1);\r
-        s = -1;\r
-      } else {\r
-        r = "" + x;\r
-        s = 1;\r
-      }\r
-    } else if (fmt == 'o')\r
-      r = convert(x, 3, 7, "01234567");\r
-    else if (fmt == 'x')\r
-      r = convert(x, 4, 15, "0123456789abcdef");\r
-    else if (fmt == 'X')\r
-      r = convert(x, 4, 15, "0123456789ABCDEF");\r
-    else\r
-      throw new java.lang.IllegalArgumentException();\r
-\r
-    return pad(sign(s, r));\r
-  }\r
-\r
-  /**\r
-  * Formats a character into a string (like sprintf in C)\r
-  * @param x the value to format\r
-  * @return the formatted string\r
-  */\r
-\r
-  public String form(char c) {\r
-    if (fmt != 'c')\r
-      throw new java.lang.IllegalArgumentException();\r
-\r
-    String r = "" + c;\r
-    return pad(r);\r
-  }\r
-\r
-  /**\r
-  * Formats a string into a larger string (like sprintf in C)\r
-  * @param x the value to format\r
-  * @return the formatted string\r
-  */\r
-\r
-  public String form(String s) {\r
-    if (fmt != 's')\r
-      throw new java.lang.IllegalArgumentException();\r
-    if (precision >= 0)\r
-      s = s.substring(0, precision);\r
-    return pad(s);\r
-  }\r
-\r
-\r
-  /**\r
-  * a test stub for the format class\r
-  */\r
-\r
-  public static void main(String[] a) {\r
-    double x = 1.23456789012;\r
-    double y = 123;\r
-    double z = 1.2345e30;\r
-    double w = 1.02;\r
-    double u = 1.234e-5;\r
-    int d = 0xCAFE;\r
-    Format.print(System.out, "x = |%f|\n", x);\r
-    Format.print(System.out, "u = |%20f|\n", u);\r
-    Format.print(System.out, "x = |% .5f|\n", x);\r
-    Format.print(System.out, "w = |%20.5f|\n", w);\r
-    Format.print(System.out, "x = |%020.5f|\n", x);\r
-    Format.print(System.out, "x = |%+20.5f|\n", x);\r
-    Format.print(System.out, "x = |%+020.5f|\n", x);\r
-    Format.print(System.out, "x = |% 020.5f|\n", x);\r
-    Format.print(System.out, "y = |%#+20.5f|\n", y);\r
-    Format.print(System.out, "y = |%-+20.5f|\n", y);\r
-    Format.print(System.out, "z = |%20.5f|\n", z);\r
-\r
-    Format.print(System.out, "x = |%e|\n", x);\r
-    Format.print(System.out, "u = |%20e|\n", u);\r
-    Format.print(System.out, "x = |% .5e|\n", x);\r
-    Format.print(System.out, "w = |%20.5e|\n", w);\r
-    Format.print(System.out, "x = |%020.5e|\n", x);\r
-    Format.print(System.out, "x = |%+20.5e|\n", x);\r
-    Format.print(System.out, "x = |%+020.5e|\n", x);\r
-    Format.print(System.out, "x = |% 020.5e|\n", x);\r
-    Format.print(System.out, "y = |%#+20.5e|\n", y);\r
-    Format.print(System.out, "y = |%-+20.5e|\n", y);\r
-\r
-    Format.print(System.out, "x = |%g|\n", x);\r
-    Format.print(System.out, "z = |%g|\n", z);\r
-    Format.print(System.out, "w = |%g|\n", w);\r
-    Format.print(System.out, "u = |%g|\n", u);\r
-    Format.print(System.out, "y = |%.2g|\n", y);\r
-    Format.print(System.out, "y = |%#.2g|\n", y);\r
-\r
-    Format.print(System.out, "d = |%d|\n", d);\r
-    Format.print(System.out, "d = |%20d|\n", d);\r
-    Format.print(System.out, "d = |%020d|\n", d);\r
-    Format.print(System.out, "d = |%+20d|\n", d);\r
-    Format.print(System.out, "d = |% 020d|\n", d);\r
-    Format.print(System.out, "d = |%-20d|\n", d);\r
-    Format.print(System.out, "d = |%20.8d|\n", d);\r
-    Format.print(System.out, "d = |%x|\n", d);\r
-    Format.print(System.out, "d = |%20X|\n", d);\r
-    Format.print(System.out, "d = |%#20x|\n", d);\r
-    Format.print(System.out, "d = |%020X|\n", d);\r
-    Format.print(System.out, "d = |%20.8x|\n", d);\r
-    Format.print(System.out, "d = |%o|\n", d);\r
-    Format.print(System.out, "d = |%020o|\n", d);\r
-    Format.print(System.out, "d = |%#20o|\n", d);\r
-    Format.print(System.out, "d = |%#020o|\n", d);\r
-    Format.print(System.out, "d = |%20.12o|\n", d);\r
-\r
-    Format.print(System.out, "s = |%-20s|\n", "Hello");\r
-    Format.print(System.out, "s = |%-20c|\n", '!');\r
-\r
-    // regression test to confirm fix of reported bugs\r
-\r
-    Format.print(System.out, "|%i|\n", Long.MIN_VALUE);\r
-\r
-    Format.print(System.out, "|%6.2e|\n", 0.0);\r
-    Format.print(System.out, "|%6.2g|\n", 0.0);\r
-\r
-    Format.print(System.out, "|%6.2f|\n", 9.99);\r
-    Format.print(System.out, "|%6.2f|\n", 9.999);\r
-\r
-    Format.print(System.out, "|%6.0f|\n", 9.999);\r
-  }\r
-\r
-  private static String repeat(char c, int n) {\r
-    if (n <= 0)\r
-      return "";\r
-    StringBuffer s = new StringBuffer(n);\r
-    for (int i = 0; i < n; i++)\r
-      s.append(c);\r
-    return s.toString();\r
-  }\r
-\r
-  private static String convert(long x, int n, int m, String d) {\r
-    if (x == 0)\r
-      return "0";\r
-    String r = "";\r
-    while (x != 0) {\r
-      r = d.charAt((int)(x & m)) + r;\r
-      x = x >>> n;\r
+\r
+    /**\r
+    * Formats a long integer into a string (like sprintf in C)\r
+    * @param x the number to format\r
+    * @return the formatted string\r
+    */\r
+    public String form(long x) {\r
+        String r;\r
+        int s = 0;\r
+\r
+        if ((fmt == 'd') || (fmt == 'i')) {\r
+            if (x < 0) {\r
+                r = ("" + x).substring(1);\r
+                s = -1;\r
+            } else {\r
+                r = "" + x;\r
+                s = 1;\r
+            }\r
+        } else if (fmt == 'o') {\r
+            r = convert(x, 3, 7, "01234567");\r
+        } else if (fmt == 'x') {\r
+            r = convert(x, 4, 15, "0123456789abcdef");\r
+        } else if (fmt == 'X') {\r
+            r = convert(x, 4, 15, "0123456789ABCDEF");\r
+        } else {\r
+            throw new java.lang.IllegalArgumentException();\r
+        }\r
+\r
+        return pad(sign(s, r));\r
     }\r
-    return r;\r
-  }\r
-\r
-  private String pad(String r) {\r
-    String p = repeat(' ', width - r.length());\r
-    if (left_align)\r
-      return pre + r + p + post;\r
-    else\r
-      return pre + p + r + post;\r
-  }\r
-\r
-  private String sign(int s, String r) {\r
-    String p = "";\r
-    if (s < 0)\r
-      p = "-";\r
-    else if (s > 0) {\r
-      if (show_plus)\r
-        p = "+";\r
-      else if (show_space)\r
-        p = " ";\r
-    } else {\r
-      if (fmt == 'o' && alternate && r.length() > 0 && r.charAt(0) != '0')\r
-        p = "0";\r
-      else if (fmt == 'x' && alternate)\r
-        p = "0x";\r
-      else if (fmt == 'X' && alternate)\r
-        p = "0X";\r
+\r
+    /**\r
+    * Formats a character into a string (like sprintf in C)\r
+    * @param x the value to format\r
+    * @return the formatted string\r
+    */\r
+    public String form(char c) {\r
+        if (fmt != 'c') {\r
+            throw new java.lang.IllegalArgumentException();\r
+        }\r
+\r
+        String r = "" + c;\r
+\r
+        return pad(r);\r
     }\r
-    int w = 0;\r
-    if (leading_zeroes)\r
-      w = width;\r
-    else if ((fmt == 'd' || fmt == 'i' || fmt == 'x' || fmt == 'X' || fmt == 'o')\r
-             && precision > 0)\r
-      w = precision;\r
-\r
-    return p + repeat('0', w - p.length() - r.length()) + r;\r
-  }\r
-\r
-  private String fixed_format(double d) {\r
-    boolean removeTrailing\r
-    = (fmt == 'G' || fmt == 'g') && !alternate;\r
-    // remove trailing zeroes and decimal point\r
-\r
-    if (d > 0x7FFFFFFFFFFFFFFFL)\r
-      return exp_format(d);\r
-    if (precision == 0)\r
-      return (long)(d + 0.5) + (removeTrailing ? "" : ".");\r
-\r
-    long whole = (long)d;\r
-    double fr = d - whole; // fractional part\r
-    if (fr >= 1 || fr < 0)\r
-      return exp_format(d);\r
-\r
-    double factor = 1;\r
-    String leading_zeroes = "";\r
-    for (int i = 1; i <= precision && factor <= 0x7FFFFFFFFFFFFFFFL; i++) {\r
-      factor *= 10;\r
-      leading_zeroes = leading_zeroes + "0";\r
+\r
+    /**\r
+    * Formats a string into a larger string (like sprintf in C)\r
+    * @param x the value to format\r
+    * @return the formatted string\r
+    */\r
+    public String form(String s) {\r
+        if (fmt != 's') {\r
+            throw new java.lang.IllegalArgumentException();\r
+        }\r
+\r
+        if (precision >= 0) {\r
+            s = s.substring(0, precision);\r
+        }\r
+\r
+        return pad(s);\r
     }\r
-    long l = (long) (factor * fr + 0.5);\r
-    if (l >= factor) {\r
-      l = 0;\r
-      whole++;\r
-    } // CSH 10-25-97\r
-\r
-    String z = leading_zeroes + l;\r
-    z = "." + z.substring(z.length() - precision, z.length());\r
-\r
-    if (removeTrailing) {\r
-      int t = z.length() - 1;\r
-      while (t >= 0 && z.charAt(t) == '0')\r
-        t--;\r
-      if (t >= 0 && z.charAt(t) == '.')\r
-        t--;\r
-      z = z.substring(0, t + 1);\r
+\r
+    /**\r
+    * a test stub for the format class\r
+    */\r
+    public static void main(String[] a) {\r
+        double x = 1.23456789012;\r
+        double y = 123;\r
+        double z = 1.2345e30;\r
+        double w = 1.02;\r
+        double u = 1.234e-5;\r
+        int d = 0xCAFE;\r
+        Format.print(System.out, "x = |%f|\n", x);\r
+        Format.print(System.out, "u = |%20f|\n", u);\r
+        Format.print(System.out, "x = |% .5f|\n", x);\r
+        Format.print(System.out, "w = |%20.5f|\n", w);\r
+        Format.print(System.out, "x = |%020.5f|\n", x);\r
+        Format.print(System.out, "x = |%+20.5f|\n", x);\r
+        Format.print(System.out, "x = |%+020.5f|\n", x);\r
+        Format.print(System.out, "x = |% 020.5f|\n", x);\r
+        Format.print(System.out, "y = |%#+20.5f|\n", y);\r
+        Format.print(System.out, "y = |%-+20.5f|\n", y);\r
+        Format.print(System.out, "z = |%20.5f|\n", z);\r
+\r
+        Format.print(System.out, "x = |%e|\n", x);\r
+        Format.print(System.out, "u = |%20e|\n", u);\r
+        Format.print(System.out, "x = |% .5e|\n", x);\r
+        Format.print(System.out, "w = |%20.5e|\n", w);\r
+        Format.print(System.out, "x = |%020.5e|\n", x);\r
+        Format.print(System.out, "x = |%+20.5e|\n", x);\r
+        Format.print(System.out, "x = |%+020.5e|\n", x);\r
+        Format.print(System.out, "x = |% 020.5e|\n", x);\r
+        Format.print(System.out, "y = |%#+20.5e|\n", y);\r
+        Format.print(System.out, "y = |%-+20.5e|\n", y);\r
+\r
+        Format.print(System.out, "x = |%g|\n", x);\r
+        Format.print(System.out, "z = |%g|\n", z);\r
+        Format.print(System.out, "w = |%g|\n", w);\r
+        Format.print(System.out, "u = |%g|\n", u);\r
+        Format.print(System.out, "y = |%.2g|\n", y);\r
+        Format.print(System.out, "y = |%#.2g|\n", y);\r
+\r
+        Format.print(System.out, "d = |%d|\n", d);\r
+        Format.print(System.out, "d = |%20d|\n", d);\r
+        Format.print(System.out, "d = |%020d|\n", d);\r
+        Format.print(System.out, "d = |%+20d|\n", d);\r
+        Format.print(System.out, "d = |% 020d|\n", d);\r
+        Format.print(System.out, "d = |%-20d|\n", d);\r
+        Format.print(System.out, "d = |%20.8d|\n", d);\r
+        Format.print(System.out, "d = |%x|\n", d);\r
+        Format.print(System.out, "d = |%20X|\n", d);\r
+        Format.print(System.out, "d = |%#20x|\n", d);\r
+        Format.print(System.out, "d = |%020X|\n", d);\r
+        Format.print(System.out, "d = |%20.8x|\n", d);\r
+        Format.print(System.out, "d = |%o|\n", d);\r
+        Format.print(System.out, "d = |%020o|\n", d);\r
+        Format.print(System.out, "d = |%#20o|\n", d);\r
+        Format.print(System.out, "d = |%#020o|\n", d);\r
+        Format.print(System.out, "d = |%20.12o|\n", d);\r
+\r
+        Format.print(System.out, "s = |%-20s|\n", "Hello");\r
+        Format.print(System.out, "s = |%-20c|\n", '!');\r
+\r
+        // regression test to confirm fix of reported bugs\r
+        Format.print(System.out, "|%i|\n", Long.MIN_VALUE);\r
+\r
+        Format.print(System.out, "|%6.2e|\n", 0.0);\r
+        Format.print(System.out, "|%6.2g|\n", 0.0);\r
+\r
+        Format.print(System.out, "|%6.2f|\n", 9.99);\r
+        Format.print(System.out, "|%6.2f|\n", 9.999);\r
+\r
+        Format.print(System.out, "|%6.0f|\n", 9.999);\r
     }\r
 \r
-    return whole + z;\r
-  }\r
-\r
-  private String exp_format(double d) {\r
-    String f = "";\r
-    int e = 0;\r
-    double dd = d;\r
-    double factor = 1;\r
-    if (d != 0) {\r
-      while (dd > 10) {\r
-        e++;\r
-        factor /= 10;\r
-        dd = dd / 10;\r
-      }\r
-      while (dd < 1) {\r
-        e--;\r
-        factor *= 10;\r
-        dd = dd * 10;\r
-      }\r
+    private static String repeat(char c, int n) {\r
+        if (n <= 0) {\r
+            return "";\r
+        }\r
+\r
+        StringBuffer s = new StringBuffer(n);\r
+\r
+        for (int i = 0; i < n; i++)\r
+            s.append(c);\r
+\r
+        return s.toString();\r
     }\r
-    if ((fmt == 'g' || fmt == 'G') && e >= -4 && e < precision)\r
-      return fixed_format(d);\r
-\r
-    d = d * factor;\r
-    f = f + fixed_format(d);\r
-\r
-    if (fmt == 'e' || fmt == 'g')\r
-      f = f + "e";\r
-    else\r
-      f = f + "E";\r
-\r
-    String p = "000";\r
-    if (e >= 0) {\r
-      f = f + "+";\r
-      p = p + e;\r
-    } else {\r
-      f = f + "-";\r
-      p = p + (-e);\r
+\r
+    private static String convert(long x, int n, int m, String d) {\r
+        if (x == 0) {\r
+            return "0";\r
+        }\r
+\r
+        String r = "";\r
+\r
+        while (x != 0) {\r
+            r = d.charAt((int) (x & m)) + r;\r
+            x = x >>> n;\r
+        }\r
+\r
+        return r;\r
     }\r
 \r
-    return f + p.substring(p.length() - 3, p.length());\r
-  }\r
-\r
-  private int width;\r
-  private int precision;\r
-  private String pre;\r
-  private String post;\r
-  private boolean leading_zeroes;\r
-  private boolean show_plus;\r
-  private boolean alternate;\r
-  private boolean show_space;\r
-  private boolean left_align;\r
-  private char fmt; // one of cdeEfgGiosxXos\r
-}\r
+    private String pad(String r) {\r
+        String p = repeat(' ', width - r.length());\r
+\r
+        if (left_align) {\r
+            return pre + r + p + post;\r
+        } else {\r
+            return pre + p + r + post;\r
+        }\r
+    }\r
 \r
+    private String sign(int s, String r) {\r
+        String p = "";\r
+\r
+        if (s < 0) {\r
+            p = "-";\r
+        } else if (s > 0) {\r
+            if (show_plus) {\r
+                p = "+";\r
+            } else if (show_space) {\r
+                p = " ";\r
+            }\r
+        } else {\r
+            if ((fmt == 'o') && alternate && (r.length() > 0) &&\r
+                    (r.charAt(0) != '0')) {\r
+                p = "0";\r
+            } else if ((fmt == 'x') && alternate) {\r
+                p = "0x";\r
+            } else if ((fmt == 'X') && alternate) {\r
+                p = "0X";\r
+            }\r
+        }\r
+\r
+        int w = 0;\r
+\r
+        if (leading_zeroes) {\r
+            w = width;\r
+        } else if (((fmt == 'd') || (fmt == 'i') || (fmt == 'x') ||\r
+                (fmt == 'X') || (fmt == 'o')) && (precision > 0)) {\r
+            w = precision;\r
+        }\r
+\r
+        return p + repeat('0', w - p.length() - r.length()) + r;\r
+    }\r
+\r
+    private String fixed_format(double d) {\r
+        boolean removeTrailing = ((fmt == 'G') || (fmt == 'g')) && !alternate;\r
 \r
+        // remove trailing zeroes and decimal point\r
+        if (d > 0x7FFFFFFFFFFFFFFFL) {\r
+            return exp_format(d);\r
+        }\r
+\r
+        if (precision == 0) {\r
+            return (long) (d + 0.5) + (removeTrailing ? "" : ".");\r
+        }\r
+\r
+        long whole = (long) d;\r
+        double fr = d - whole; // fractional part\r
+\r
+        if ((fr >= 1) || (fr < 0)) {\r
+            return exp_format(d);\r
+        }\r
+\r
+        double factor = 1;\r
+        String leading_zeroes = "";\r
+\r
+        for (int i = 1; (i <= precision) && (factor <= 0x7FFFFFFFFFFFFFFFL);\r
+                i++) {\r
+            factor *= 10;\r
+            leading_zeroes = leading_zeroes + "0";\r
+        }\r
+\r
+        long l = (long) ((factor * fr) + 0.5);\r
+\r
+        if (l >= factor) {\r
+            l = 0;\r
+            whole++;\r
+        }\r
+         // CSH 10-25-97\r
 \r
+        String z = leading_zeroes + l;\r
+        z = "." + z.substring(z.length() - precision, z.length());\r
 \r
+        if (removeTrailing) {\r
+            int t = z.length() - 1;\r
 \r
+            while ((t >= 0) && (z.charAt(t) == '0'))\r
+                t--;\r
+\r
+            if ((t >= 0) && (z.charAt(t) == '.')) {\r
+                t--;\r
+            }\r
+\r
+            z = z.substring(0, t + 1);\r
+        }\r
+\r
+        return whole + z;\r
+    }\r
+\r
+    private String exp_format(double d) {\r
+        String f = "";\r
+        int e = 0;\r
+        double dd = d;\r
+        double factor = 1;\r
+\r
+        if (d != 0) {\r
+            while (dd > 10) {\r
+                e++;\r
+                factor /= 10;\r
+                dd = dd / 10;\r
+            }\r
+\r
+            while (dd < 1) {\r
+                e--;\r
+                factor *= 10;\r
+                dd = dd * 10;\r
+            }\r
+        }\r
+\r
+        if (((fmt == 'g') || (fmt == 'G')) && (e >= -4) && (e < precision)) {\r
+            return fixed_format(d);\r
+        }\r
+\r
+        d = d * factor;\r
+        f = f + fixed_format(d);\r
+\r
+        if ((fmt == 'e') || (fmt == 'g')) {\r
+            f = f + "e";\r
+        } else {\r
+            f = f + "E";\r
+        }\r
+\r
+        String p = "000";\r
+\r
+        if (e >= 0) {\r
+            f = f + "+";\r
+            p = p + e;\r
+        } else {\r
+            f = f + "-";\r
+            p = p + (-e);\r
+        }\r
+\r
+        return f + p.substring(p.length() - 3, p.length());\r
+    }\r
+}\r