- experimental opensessions
[mir.git] / source / mir / util / StringRoutines.java
index 4c58d6a..579e921 100755 (executable)
-/*
- * Copyright (C) 2001, 2002  The Mir-coders group
- *
- * This file is part of Mir.
- *
- * Mir is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * Mir is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with Mir; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
- *
- * In addition, as a special exception, The Mir-coders gives permission to link
- * the code of this program with the com.oreilly.servlet library, any library
- * licensed under the Apache Software License, The Sun (tm) Java Advanced
- * Imaging library (JAI), The Sun JIMI library (or with modified versions of
- * the above that use the same license as the above), and distribute linked
- * combinations including the two.  You must obey the GNU General Public
- * License in all respects for all of the code used other than the above
- * mentioned libraries.  If you modify this file, you may extend this exception
- * to your version of the file, but you are not obligated to do so.  If you do
- * not wish to do so, delete this exception statement from your version.
- */
-
-package mir.util;
-
-import gnu.regexp.RE;
-import gnu.regexp.REException;
-
-import java.util.List;
-import java.util.Vector;
-
-public class StringRoutines {
-
-  private StringRoutines() {
-  }
-
-  static int indexOfCharacters(String aString, char[] aCharacters, int aFrom) {
-    int i;
-    int result=-1;
-    int position;
-
-    for (i=0; i<aCharacters.length ; i++) {
-      position = aString.indexOf(aCharacters[i], aFrom);
-
-      if (position != -1 && ( result == -1 || position < result )) {
-        result = position;
-      }
-    }
-
-    return result;
-  }
-
-  static String replaceStringCharacters(String aText, char[] aCharactersToReplace, String[] aStringsToSubstitute) {
-    if (aText==null)
-      return null;
-
-    int position, nextPosition;
-    int i;
-    StringBuffer result = new StringBuffer();
-
-    position=0;
-    do {
-      nextPosition = StringRoutines.indexOfCharacters(aText, aCharactersToReplace, position);
-
-      if (nextPosition<0)
-        nextPosition = aText.length();
-
-      result.append(aText.substring(position, nextPosition));
-
-      if (nextPosition<aText.length())
-        for (i=0; i<aCharactersToReplace.length; i++) {
-          if (aCharactersToReplace[i] == aText.charAt(nextPosition)) {
-            result.append(aStringsToSubstitute[i]);
-            break;
-          }
-        }
-      position=nextPosition+1;
-    }
-    while (nextPosition<aText.length()) ;
-
-    return result.toString();
-  }
-
-
-  public static String interpretAsString(Object aValue) throws Exception {
-    if (aValue instanceof String)
-      return (String) aValue;
-
-    if (aValue instanceof Integer)
-      return ((Integer) aValue).toString();
-
-    if (aValue == null)
-      return "";
-
-    throw new Exception("String expected, "+aValue+" found");
-  }
-
-  public static int interpretAsInteger(Object aValue) throws Exception {
-    if (aValue instanceof Integer)
-      return ((Integer) aValue).intValue();
-
-    if (aValue instanceof String)
-      try {
-        return Integer.parseInt((String) aValue);
-      }
-      catch (Throwable t) {
-        throw new Exception("Integer expected, "+aValue+" found");
-      }
-
-    throw new Exception("Integer expected, "+aValue+" found");
-  }
-
-  /**
-   *
-   * @param aSource
-   * @param aSearchExpression
-   * @param aReplacement
-   * @return
-   * @throws Exception
-   */
-  public static String performRegularExpressionReplacement(String aSource,
-      String aSearchExpression, String aReplacement) throws Exception {
-
-    RE regularExpression;
-
-    regularExpression = new RE(aSearchExpression);
-
-    return regularExpression.substituteAll(aSource, aReplacement);
-  }
-
-  /**
-   *
-   * @param aSource
-   * @param aSearchExpression
-   * @return
-   * @throws REException
-   */
-  public static boolean performRegularExpressionSearch(String aSource,
-      String aSearchExpression) throws REException {
-    RE regularExpression;
-
-    regularExpression = new RE(aSearchExpression);
-
-    return regularExpression.isMatch(aSource);
-  }
-
-  /**
-   * Separates a string based on a separator:
-   *     <code>seperateString("a:b:c", ":");</code> will lead to
-   *     a List with 3 Strings: <code>"a"</code>, <code>"b"</code> and <code>"c"</code>
-   *
-   * @param aString     The string to split
-   * @param aSeparator
-   * @return
-   */
-
-  public static List splitString(String aString, String aSeparator) {
-    List result= new Vector();
-    int previousPosition = 0;
-    int position;
-    int endOfNamePosition;
-
-    while ((position = aString.indexOf(aSeparator, previousPosition))>=0) {
-      result.add(aString.substring(previousPosition, position));
-      previousPosition = position + aSeparator.length();
-    }
-
-    result.add(aString.substring(previousPosition, aString.length()));
-
-    return result;
-  }
-
-  /**
-   * Separates a String into at most 2 parts based on a separator:
-   * <ul>
-   *   <li>
-   *     <code>seperateString("a:b:c", ":");</code> will lead to
-   *     a List with 2 Strings: <code>"a"</code> and <code>"b:c"</code>
-   *   <li>
-   *     <code>seperateString("abc", ":");</code> will lead to
-   *     a List with a single String: <code>"abc"</code>
-   * </ul>
-   *
-   *
-   * @param aString
-   * @param aSeparator
-   * @return
-   */
-  public static List separateString(String aString, String aSeparator) {
-    List result= new Vector();
-    int previousPosition = 0;
-    int position;
-    int endOfNamePosition;
-
-    if((position = aString.indexOf(aSeparator, previousPosition))>=0) {
-      result.add(aString.substring(previousPosition, position));
-      previousPosition = position + aSeparator.length();
-    }
-
-    result.add(aString.substring(previousPosition, aString.length()));
-
-    return result;
-  }
+/*\r
+ * Copyright (C) 2001, 2002  The Mir-coders group\r
+ *\r
+ * This file is part of Mir.\r
+ *\r
+ * Mir is free software; you can redistribute it and/or modify\r
+ * it under the terms of the GNU General Public License as published by\r
+ * the Free Software Foundation; either version 2 of the License, or\r
+ * (at your option) any later version.\r
+ *\r
+ * Mir is distributed in the hope that it will be useful,\r
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of\r
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\r
+ * GNU General Public License for more details.\r
+ *\r
+ * You should have received a copy of the GNU General Public License\r
+ * along with Mir; if not, write to the Free Software\r
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA\r
+ *\r
+ * In addition, as a special exception, The Mir-coders gives permission to link\r
+ * the code of this program with the com.oreilly.servlet library, any library\r
+ * licensed under the Apache Software License, The Sun (tm) Java Advanced\r
+ * Imaging library (JAI), The Sun JIMI library (or with modified versions of\r
+ * the above that use the same license as the above), and distribute linked\r
+ * combinations including the two.  You must obey the GNU General Public\r
+ * License in all respects for all of the code used other than the above\r
+ * mentioned libraries.  If you modify this file, you may extend this exception\r
+ * to your version of the file, but you are not obligated to do so.  If you do\r
+ * not wish to do so, delete this exception statement from your version.\r
+ */\r
+\r
+package mir.util;\r
+\r
+import gnu.regexp.RE;\r
+import gnu.regexp.REException;\r
+\r
+import java.util.List;\r
+import java.util.Vector;\r
+\r
+public class StringRoutines {\r
+\r
+  private StringRoutines() {\r
+  }\r
+\r
+  static int indexOfCharacters(String aString, char[] aCharacters, int aFrom) {\r
+    int i;\r
+    int result=-1;\r
+    int position;\r
+\r
+    for (i=0; i<aCharacters.length ; i++) {\r
+      position = aString.indexOf(aCharacters[i], aFrom);\r
+\r
+      if (position != -1 && ( result == -1 || position < result )) {\r
+        result = position;\r
+      }\r
+    }\r
+\r
+    return result;\r
+  }\r
+\r
+  static String replaceStringCharacters(String aText, char[] aCharactersToReplace, String[] aStringsToSubstitute) {\r
+    if (aText==null)\r
+      return null;\r
+\r
+    int position, nextPosition;\r
+    int i;\r
+    StringBuffer result = new StringBuffer();\r
+\r
+    position=0;\r
+    do {\r
+      nextPosition = StringRoutines.indexOfCharacters(aText, aCharactersToReplace, position);\r
+\r
+      if (nextPosition<0)\r
+        nextPosition = aText.length();\r
+\r
+      result.append(aText.substring(position, nextPosition));\r
+\r
+      if (nextPosition<aText.length())\r
+        for (i=0; i<aCharactersToReplace.length; i++) {\r
+          if (aCharactersToReplace[i] == aText.charAt(nextPosition)) {\r
+            result.append(aStringsToSubstitute[i]);\r
+            break;\r
+          }\r
+        }\r
+      position=nextPosition+1;\r
+    }\r
+    while (nextPosition<aText.length()) ;\r
+\r
+    return result.toString();\r
+  }\r
+\r
+\r
+  public static String interpretAsString(Object aValue) throws Exception {\r
+    if (aValue instanceof String)\r
+      return (String) aValue;\r
+\r
+    if (aValue instanceof Integer)\r
+      return ((Integer) aValue).toString();\r
+\r
+    if (aValue == null)\r
+      return "";\r
+\r
+    throw new Exception("String expected, "+aValue+" found");\r
+  }\r
+\r
+  public static int interpretAsInteger(Object aValue) throws Exception {\r
+    if (aValue instanceof Integer)\r
+      return ((Integer) aValue).intValue();\r
+\r
+    if (aValue instanceof String)\r
+      try {\r
+        return Integer.parseInt((String) aValue);\r
+      }\r
+      catch (Throwable t) {\r
+        throw new Exception("Integer expected, "+aValue+" found");\r
+      }\r
+\r
+    throw new Exception("Integer expected, "+aValue+" found");\r
+  }\r
+\r
+  /**\r
+   *\r
+   * @param aSource\r
+   * @param aSearchExpression\r
+   * @param aReplacement\r
+   * @return\r
+   * @throws Exception\r
+   */\r
+  public static String performRegularExpressionReplacement(String aSource,\r
+      String aSearchExpression, String aReplacement) throws Exception {\r
+\r
+    RE regularExpression;\r
+\r
+    regularExpression = new RE(aSearchExpression);\r
+\r
+    return regularExpression.substituteAll(aSource, aReplacement);\r
+  }\r
+\r
+  /**\r
+   *\r
+   * @param aSource\r
+   * @param aSearchExpression\r
+   * @return\r
+   * @throws REException\r
+   */\r
+  public static boolean performRegularExpressionSearch(String aSource,\r
+      String aSearchExpression) throws REException {\r
+    RE regularExpression;\r
+\r
+    regularExpression = new RE(aSearchExpression);\r
+\r
+    return regularExpression.isMatch(aSource);\r
+  }\r
+\r
+  /**\r
+   * Separates a string based on a separator:\r
+   *     <code>seperateString("a:b:c", ":");</code> will lead to\r
+   *     a List with 3 Strings: <code>"a"</code>, <code>"b"</code> and <code>"c"</code>\r
+   *\r
+   * @param aString     The string to split\r
+   * @param aSeparator\r
+   * @return\r
+   */\r
+\r
+  public static List splitString(String aString, String aSeparator) {\r
+    List result= new Vector();\r
+    int previousPosition = 0;\r
+    int position;\r
+    int endOfNamePosition;\r
+\r
+    if (aString!=null) {\r
+      while ( (position = aString.indexOf(aSeparator, previousPosition)) >= 0) {\r
+        result.add(aString.substring(previousPosition, position));\r
+        previousPosition = position + aSeparator.length();\r
+      }\r
+      result.add(aString.substring(previousPosition, aString.length()));\r
+    }\r
+\r
+    return result;\r
+  }\r
+\r
+  /**\r
+   * Separates a String into at most 2 parts based on a separator:\r
+   * <ul>\r
+   *   <li>\r
+   *     <code>seperateString("a:b:c", ":");</code> will lead to\r
+   *     a List with 2 Strings: <code>"a"</code> and <code>"b:c"</code>\r
+   *   <li>\r
+   *     <code>seperateString("abc", ":");</code> will lead to\r
+   *     a List with a single String: <code>"abc"</code>\r
+   * </ul>\r
+   *\r
+   *\r
+   * @param aString\r
+   * @param aSeparator\r
+   * @return\r
+   */\r
+  public static List separateString(String aString, String aSeparator) {\r
+    List result= new Vector();\r
+    int previousPosition = 0;\r
+    int position;\r
+    int endOfNamePosition;\r
+\r
+    if((position = aString.indexOf(aSeparator, previousPosition))>=0) {\r
+      result.add(aString.substring(previousPosition, position));\r
+      previousPosition = position + aSeparator.length();\r
+    }\r
+\r
+    result.add(aString.substring(previousPosition, aString.length()));\r
+\r
+    return result;\r
+  }\r
 }
\ No newline at end of file