- * Note: null, "strange text", ""... will all be converted to NULL. - * - * @param str - * the input {@link String} - * @param item - * the item number to use for an array of values, or -1 for - * non-arrays - * - * @return the converted {@link Boolean} or NULL - */ - static public Boolean parseBoolean(String str, int item) { - str = getItem(str, item); - if (str == null) { - return null; - } - - if (str.equalsIgnoreCase("true") || str.equalsIgnoreCase("on") - || str.equalsIgnoreCase("yes")) - return true; - if (str.equalsIgnoreCase("false") || str.equalsIgnoreCase("off") - || str.equalsIgnoreCase("no")) - return false; - - return null; - } - - /** - * Return a {@link String} representation of the given {@link Boolean}. - * - * @param value - * the input value - * - * @return the raw {@link String} value that correspond to it - */ - static public String fromBoolean(boolean value) { - return Boolean.toString(value); - } - - /** - * Convert the given {@link String} into a {@link Integer} if it represents - * a {@link Integer}, or NULL if it doesn't. - *
- * Note: null, "strange text", ""... will all be converted to NULL. - * - * @param str - * the input {@link String} - * @param item - * the item number to use for an array of values, or -1 for - * non-arrays - * - * @return the converted {@link Integer} or NULL - */ - static public Integer parseInteger(String str, int item) { - str = getItem(str, item); - if (str == null) { - return null; - } - - try { - return Integer.parseInt(str); - } catch (Exception e) { - } - - return null; - } - - /** - * Return a {@link String} representation of the given {@link Integer}. - * - * @param value - * the input value - * - * @return the raw {@link String} value that correspond to it - */ - static public String fromInteger(int value) { - return Integer.toString(value); - } - - /** - * Convert the given {@link String} into a {@link Character} if it - * represents a {@link Character}, or NULL if it doesn't. - *
- * Note: null, "strange text", ""... will all be converted to NULL - * (remember: any {@link String} whose length is not 1 is not a - * {@link Character}). - * - * @param str - * the input {@link String} - * @param item - * the item number to use for an array of values, or -1 for - * non-arrays - * - * @return the converted {@link Character} or NULL - */ - static public Character parseCharacter(String str, int item) { - str = getItem(str, item); - if (str == null) { - return null; - } - - String s = str.trim(); - if (s.length() == 1) { - return s.charAt(0); - } - - return null; - } - - /** - * Return a {@link String} representation of the given {@link Boolean}. - * - * @param value - * the input value - * - * @return the raw {@link String} value that correspond to it - */ - static public String fromCharacter(char value) { - return Character.toString(value); - } - - /** - * Convert the given {@link String} into a colour (represented here as an - * {@link Integer}) if it represents a colour, or NULL if it doesn't. - *
- * The returned colour value is an ARGB value. - * - * @param str - * the input {@link String} - * @param item - * the item number to use for an array of values, or -1 for - * non-arrays - * - * @return the converted colour as an {@link Integer} value or NULL - */ - static Integer parseColor(String str, int item) { - str = getItem(str, item); - if (str == null) { - return null; - } - - Integer rep = null; - - str = str.trim(); - int r = 0, g = 0, b = 0, a = -1; - if (str.startsWith("#") && (str.length() == 7 || str.length() == 9)) { - try { - r = Integer.parseInt(str.substring(1, 3), 16); - g = Integer.parseInt(str.substring(3, 5), 16); - b = Integer.parseInt(str.substring(5, 7), 16); - if (str.length() == 9) { - a = Integer.parseInt(str.substring(7, 9), 16); - } else { - a = 255; - } - - } catch (NumberFormatException e) { - // no changes - } - } - - // Try by name if still not found - if (a == -1) { - if ("black".equalsIgnoreCase(str)) { - a = 255; - r = 0; - g = 0; - b = 0; - } else if ("white".equalsIgnoreCase(str)) { - a = 255; - r = 255; - g = 255; - b = 255; - } else if ("red".equalsIgnoreCase(str)) { - a = 255; - r = 255; - g = 0; - b = 0; - } else if ("green".equalsIgnoreCase(str)) { - a = 255; - r = 0; - g = 255; - b = 0; - } else if ("blue".equalsIgnoreCase(str)) { - a = 255; - r = 0; - g = 0; - b = 255; - } else if ("grey".equalsIgnoreCase(str) - || "gray".equalsIgnoreCase(str)) { - a = 255; - r = 128; - g = 128; - b = 128; - } else if ("cyan".equalsIgnoreCase(str)) { - a = 255; - r = 0; - g = 255; - b = 255; - } else if ("magenta".equalsIgnoreCase(str)) { - a = 255; - r = 255; - g = 0; - b = 255; - } else if ("yellow".equalsIgnoreCase(str)) { - a = 255; - r = 255; - g = 255; - b = 0; - } - } - - if (a != -1) { - rep = ((a & 0xFF) << 24) // - | ((r & 0xFF) << 16) // - | ((g & 0xFF) << 8) // - | ((b & 0xFF) << 0); - } - - return rep; - } - - /** - * Return a {@link String} representation of the given colour. - *
- * The colour value is interpreted as an ARGB value.
- *
- * @param color
- * the ARGB colour value
- * @return the raw {@link String} value that correspond to it
- */
- static public String fromColor(int color) {
- int a = (color >> 24) & 0xFF;
- int r = (color >> 16) & 0xFF;
- int g = (color >> 8) & 0xFF;
- int b = (color >> 0) & 0xFF;
-
- String rs = Integer.toString(r, 16);
- String gs = Integer.toString(g, 16);
- String bs = Integer.toString(b, 16);
- String as = "";
- if (a < 255) {
- as = Integer.toString(a, 16);
- }
-
- return "#" + rs + gs + bs + as;
- }
-
- /**
- * The size of this raw list (note than a NULL list is of size 0).
- *
- * @param raw
- * the raw list
- *
- * @return its size if it is a list (NULL is an empty list), -1 if it is not
- * a list
- */
- static public int getListSize(String raw) {
- if (raw == null) {
- return 0;
- }
-
- List
- * The list of values is comma-separated and each value is surrounded by
- * double-quotes; caret (^) and double-quotes (") are escaped by a caret.
- *
- * @param str
- * the input value
- * @param item
- * the item number to use for an array of values, or -1 for
- * non-arrays
- *
- * @return the raw {@link String} value that correspond to it
- */
- static public List
- * NULL will be assimilated to an empty {@link String} if later non-null
- * values exist, or just ignored if not.
- *
- * Example:
- *
- * NULL will be assimilated to an empty {@link String} if later non-null
- * values exist, or just ignored if not.
- *
- * Example:
- *
- * NULL will be assimilated to an empty {@link String} if later non-null
- * values exist, or just ignored if not.
- *
- * Example:
- *
- * You can unescape it with {@link BundleHelper#unescape(String)}
- *
- * @param value
- * the value to escape
- *
- * @return an escaped value that can unquoted by the reverse operation
- * {@link BundleHelper#unescape(String)}
- */
- static public String escape(String value) {
- return '"' + value//
- .replace("^", "^^") //
- .replace("\"", "^\"") //
- .replace("\n", "^\n") //
- .replace("\r", "^\r") //
- + '"';
- }
-
- /**
- * Unescape the given value for list formating (change ^n into NEWLINE and
- * so on).
- *
- * You can escape it with {@link BundleHelper#escape(String)}
- *
- * @param value
- * the value to escape
- *
- * @return an unescaped value that can reverted by the reverse operation
- * {@link BundleHelper#escape(String)}, or NULL if it was badly
- * formated
- */
- static public String unescape(String value) {
- if (value.length() < 2 || !value.startsWith("\"")
- || !value.endsWith("\"")) {
- // Bad format
- return null;
- }
-
- value = value.substring(1, value.length() - 1);
-
- boolean prevIsBackslash = false;
- StringBuilder builder = new StringBuilder();
- for (char car : value.toCharArray()) {
- if (prevIsBackslash) {
- switch (car) {
- case 'n':
- case 'N':
- builder.append('\n');
- break;
- case 'r':
- case 'R':
- builder.append('\r');
- break;
- default: // includes ^ and "
- builder.append(car);
- break;
- }
- prevIsBackslash = false;
- } else {
- if (car == '^') {
- prevIsBackslash = true;
- } else {
- builder.append(car);
- }
- }
- }
-
- if (prevIsBackslash) {
- // Bad format
- return null;
- }
-
- return builder.toString();
- }
-
- /**
- * Retrieve the specific item in the given value, assuming it is an array.
- *
- * @param value
- * the value to look into
- * @param item
- * the item number to get for an array of values, or -1 for
- * non-arrays (in that case, simply return the value as-is)
- *
- * @return the value as-is for non arrays, the item item if found,
- * NULL if not
- */
- static private String getItem(String value, int item) {
- if (item >= 0) {
- value = null;
- List
- *
- *
- * @param list
- * the input value
- *
- * @return the raw {@link String} value that correspond to it
- */
- static public String fromList(List
- *
- *
- * @param list
- * the input value
- * @param value
- * the value to insert
- * @param item
- * the position to insert it at
- *
- * @return the raw {@link String} value that correspond to it
- */
- static public String fromList(List
- *
- *
- * @param list
- * the input value
- * @param value
- * the value to insert
- * @param item
- * the position to insert it at
- *
- * @return the raw {@link String} value that correspond to it
- */
- static public String fromList(String list, String value, int item) {
- return fromList(parseList(list, -1), value, item);
- }
-
- /**
- * Escape the given value for list formating (no carets, no NEWLINES...).
- *