merge from 2_4_Release branch
[jalview.git] / src / com / stevesoft / pat / StringLike.java
index 07bc441..be98ff3 100755 (executable)
@@ -1,44 +1,47 @@
-package //\r
-// This software is now distributed according to\r
-// the Lesser Gnu Public License.  Please see\r
-// http://www.gnu.org/copyleft/lesser.txt for\r
-// the details.\r
-//    -- Happy Computing!\r
-//\r
-    com.stevesoft.pat;\r
-\r
-/** Package pat can search anything that implements this\r
-    interface.  Package pat assumes the following:\r
-    <ul>\r
-    <li>The StringLike object will not change.  Calls to\r
-        charAt(int) will not vary with time.\r
-    <li>The length of the object being searched is known\r
-        before the search begins and does not vary with time.\r
-    </ul>\r
-    Note that searching String is probably faster than searching\r
-    other objects, so searching String is still preferred if\r
-    possible.\r
- */\r
-public interface StringLike\r
-{\r
-  public char charAt(int i);\r
-\r
-  public String toString();\r
-\r
-  public int length();\r
-\r
-  public String substring(int i1, int i2);\r
-\r
-  /** Obtain the underlying object, be it a String, char[],\r
-      RandomAccessFile, whatever. */\r
-  public Object unwrap();\r
-\r
-  /** By default, the result is put in a String or char[]\r
-      when a replace is done.  If you wish to save the result\r
-      in some other StringBufferLike then you can do this\r
-      by implementing this method, or over-riding it's behavior\r
-      from an existing class. */\r
-  public BasicStringBufferLike newStringBufferLike();\r
-\r
-  public int indexOf(char c);\r
-}\r
+package //
+// This software is now distributed according to
+// the Lesser Gnu Public License.  Please see
+// http://www.gnu.org/copyleft/lesser.txt for
+// the details.
+//    -- Happy Computing!
+//
+com.stevesoft.pat;
+
+/**
+ * Package pat can search anything that implements this interface. Package pat
+ * assumes the following:
+ * <ul>
+ * <li>The StringLike object will not change. Calls to charAt(int) will not
+ * vary with time.
+ * <li>The length of the object being searched is known before the search
+ * begins and does not vary with time.
+ * </ul>
+ * Note that searching String is probably faster than searching other objects,
+ * so searching String is still preferred if possible.
+ */
+public interface StringLike
+{
+  public char charAt(int i);
+
+  public String toString();
+
+  public int length();
+
+  public String substring(int i1, int i2);
+
+  /**
+   * Obtain the underlying object, be it a String, char[], RandomAccessFile,
+   * whatever.
+   */
+  public Object unwrap();
+
+  /**
+   * By default, the result is put in a String or char[] when a replace is done.
+   * If you wish to save the result in some other StringBufferLike then you can
+   * do this by implementing this method, or over-riding it's behavior from an
+   * existing class.
+   */
+  public BasicStringBufferLike newStringBufferLike();
+
+  public int indexOf(char c);
+}