cms/util/StringUtils.java

//---PACKAGE DECLARATION---
package uk.ac.ukc.iscream.util;

//---IMPORTS---
import java.util.*;

/**
 * A class containing useful methods for manipulating
 * String objects.
 *
 * @author  $Author$
 * @version $Id$
 */
public class StringUtils {

//---FINAL ATTRIBUTES---

    /**
     * The current CVS revision of this class
     */
    public static final String REVISION = "$Revision: 1.1 $";
    
//---STATIC METHODS---

    /**
     * Searches a string and replaces all occurences 
     * of the given search text with the given replacement
     * text.
     *
     * @param text the text to search and replace in
     * @param search the string to look for and replace
     * @param replace the text to replace with
     * @return the updated version of text
     */
    public static String replaceText(String text, String search, String replace) {
        StringBuffer textBuffer = new StringBuffer(text);
        int currIndex = 0;
        currIndex = text.indexOf(search, currIndex);
        while(currIndex != -1) {
            if (currIndex != -1) {
                textBuffer.delete(currIndex, currIndex + search.length());
                textBuffer.insert(currIndex, replace);
            }
            text = textBuffer.toString();
            currIndex = text.indexOf(search, currIndex + search.length());
        }
        return new String(textBuffer);
    }

//---CONSTRUCTORS---

//---PUBLIC METHODS---

    /**
     * Overrides the {@link java.lang.Object#toString() Object.toString()}
     * method to provide clean logging (every class should have this).
     *
     * This uses the uk.ac.ukc.iscream.util.FormatName class
     * to format the toString()
     *
     * @return the name of this class and its CVS revision
     */
    public String toString() {
        return FormatName.getName(
            _name,
            getClass().getName(),
            REVISION);
    }

//---PRIVATE METHODS---

//---ACCESSOR/MUTATOR METHODS---

//---ATTRIBUTES---

    /**
     * This is the friendly identifier of the
     * component this class is running in.
     * eg, a Filter may be called "filter1",
     * If this class does not have an owning
     * component,  a name from the configuration
     * can be placed here.  This name could also
     * be changed to null for utility classes.
     */
    private String _name = null;

//---STATIC ATTRIBUTES---

}
Revision:	1.1
Committed:	Sun Feb 4 04:56:08 2001 UTC (23 years, 2 months ago) by tdb
Branch:	MAIN
Log Message:	A new class providing methods (ok, one method) to manipulate String objects. These methods are really the sort of thing you'd expect Java to have... but it doesn't :/
#	Content
1	//---PACKAGE DECLARATION---
2	package uk.ac.ukc.iscream.util;
3
4	//---IMPORTS---
5	import java.util.*;
6
7	/**
8	* A class containing useful methods for manipulating
9	* String objects.
10	*
11	* @author $Author$
12	* @version $Id$
13	*/
14	public class StringUtils {
15
16	//---FINAL ATTRIBUTES---
17
18	/**
19	* The current CVS revision of this class
20	*/
21	public static final String REVISION = "$Revision: 1.1 $";
22
23	//---STATIC METHODS---
24
25	/**
26	* Searches a string and replaces all occurences
27	* of the given search text with the given replacement
28	* text.
29	*
30	* @param text the text to search and replace in
31	* @param search the string to look for and replace
32	* @param replace the text to replace with
33	* @return the updated version of text
34	*/
35	public static String replaceText(String text, String search, String replace) {
36	StringBuffer textBuffer = new StringBuffer(text);
37	int currIndex = 0;
38	currIndex = text.indexOf(search, currIndex);
39	while(currIndex != -1) {
40	if (currIndex != -1) {
41	textBuffer.delete(currIndex, currIndex + search.length());
42	textBuffer.insert(currIndex, replace);
43	}
44	text = textBuffer.toString();
45	currIndex = text.indexOf(search, currIndex + search.length());
46	}
47	return new String(textBuffer);
48	}
49
50	//---CONSTRUCTORS---
51
52	//---PUBLIC METHODS---
53
54	/**
55	* Overrides the {@link java.lang.Object#toString() Object.toString()}
56	* method to provide clean logging (every class should have this).
57	*
58	* This uses the uk.ac.ukc.iscream.util.FormatName class
59	* to format the toString()
60	*
61	* @return the name of this class and its CVS revision
62	*/
63	public String toString() {
64	return FormatName.getName(
65	_name,
66	getClass().getName(),
67	REVISION);
68	}
69
70	//---PRIVATE METHODS---
71
72	//---ACCESSOR/MUTATOR METHODS---
73
74	//---ATTRIBUTES---
75
76	/**
77	* This is the friendly identifier of the
78	* component this class is running in.
79	* eg, a Filter may be called "filter1",
80	* If this class does not have an owning
81	* component, a name from the configuration
82	* can be placed here. This name could also
83	* be changed to null for utility classes.
84	*/
85	private String _name = null;
86
87	//---STATIC ATTRIBUTES---
88
89	}