..and the reverse operation
[nikiroo-utils.git] / src / be / nikiroo / utils / StringUtils.java
index ef3d84b921aea488f5ce17e5b8b52334cf24a375..9acf3a1fd2a72d400168ba74ce515915a7e7fae7 100644 (file)
@@ -795,6 +795,115 @@ public class StringUtils {
                return new String(unbase64(data, offset, count, zip), "UTF-8");
        }
 
+       /**
+        * Return a display {@link String} for the given value, which can be
+        * suffixed with "k" or "M" depending upon the number, if it is big enough.
+        * <p>
+        * Example:
+        * <ul>
+        * <li><tt>8765</tt> becomes "8k"</li>
+        * <li><tt>998765</tt> becomes "998k"</li>
+        * <li><tt>12987364</tt> becomes "12M"</li>
+        * </ul>
+        * 
+        * @param value
+        *            the value to convert
+        * 
+        * @return the display value
+        */
+       public static String formatNumber(long value) {
+               return formatNumber(value, true);
+       }
+
+       /**
+        * Return a display {@link String} for the given value, which can be
+        * suffixed with "k" or "M" depending upon the number, if it is big enough.
+        * <p>
+        * Example:
+        * <ul>
+        * <li><tt>8765</tt> becomes "8k"</li>
+        * <li><tt>998765</tt> becomes "998k"</li>
+        * <li><tt>12987364</tt> becomes "12M"</li>
+        * </ul>
+        * 
+        * @param value
+        *            the value to convert
+        * @param strict
+        *            TRUE if you want any value equals or greater than 1000 to use
+        *            the "k" suffix; FALSE if you want to go a bit higher and only
+        *            use "k" for values equal or greater than 4000
+        * 
+        * @return the display value
+        */
+       public static String formatNumber(long value, boolean strict) {
+               if (value >= 1000000l) {
+                       return Long.toString(value / 1000000l) + "M";
+               }
+
+               if ((strict && value >= 1000l) || (!strict && value >= 4000l)) {
+                       return Long.toString(value / 1000l) + "k";
+               }
+
+               return Long.toString(value);
+       }
+
+       /**
+        * The reverse operation to {@link StringUtils#formatNumber(long)}: it will
+        * read a "display" number that can contain a "M" or "k" suffix and return
+        * the full value.
+        * <p>
+        * Of course, the conversion to and from display form is lossy (example:
+        * <tt>6870</tt> to "6k" to <tt>6000</tt>).
+        * 
+        * @param value
+        *            the value in display form with possible "M" and "k" suffixes,
+        *            can be NULL
+        * 
+        * @return the value as a number, or 0 if not possible to convert
+        */
+       public static long toNumber(String value) {
+               return toNumber(value, 0l);
+       }
+
+       /**
+        * The reverse operation to {@link StringUtils#formatNumber(long)}: it will
+        * read a "display" number that can contain a "M" or "k" suffix and return
+        * the full value.
+        * <p>
+        * Of course, the conversion to and from display form is lossy (example:
+        * <tt>6870</tt> to "6k" to <tt>6000</tt>).
+        * 
+        * @param value
+        *            the value in display form with possible "M" and "k" suffixes,
+        *            can be NULL
+        * @param def
+        *            the default value if it is not possible to convert the given
+        *            value to a number
+        * 
+        * @return the value as a number, or 0 if not possible to convert
+        */
+       public static long toNumber(String value, long def) {
+               long count = def;
+               if (value != null) {
+                       try {
+                               if (value.toLowerCase().endsWith("m")) {
+                                       count = Long.parseLong(value.substring(0,
+                                                       value.length() - 1).trim());
+                                       count *= 1000000;
+                               } else if (value.toLowerCase().endsWith("k")) {
+                                       count = Long.parseLong(value.substring(0,
+                                                       value.length() - 1).trim());
+                                       count *= 1000;
+                               } else {
+                                       count = Long.parseLong(value);
+                               }
+                       } catch (NumberFormatException pe) {
+                       }
+               }
+
+               return count;
+       }
+
        /**
         * The "remove accents" pattern.
         *