Java String Replace replaceFirst(String input, String search, String replacement)

Description

Replaces the first search-string in the given input.

License

Open Source License

Parameter

Parameter	Description
input	the original string
search	the string which should be replaced in the input
replacement	the replacement for the search-string

Exception

Parameter	Description
IllegalArgumentException	when on of the parameters is null.

Return

the input string in which all search-strings are replaced with the replacement-string.

Declaration

public static String replaceFirst(String input, String search, String replacement) 

Method Source Code

//package com.java2s;
/*//from  w ww  . ja  v a2  s.  c  om
 * Created on 24-Nov-2003 at 14:38:43
 *
 * Copyright (c) 2004-2005 Robert Virkus / Enough Software
 *
 * This file is part of J2ME Polish.
 *
 * J2ME Polish 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.
 * 
 * J2ME Polish 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 J2ME Polish; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 * 
 * Commercial licenses are also available, please
 * refer to the accompanying LICENSE.txt or visit
 * http://www.j2mepolish.org for details.
 */

import java.util.Iterator;
import java.util.List;

public class Main {
    /**
     * Replaces the first search-string in the given input.
     *  
     * @param input the original string
     * @param search the string which should be replaced in the input
     * @param replacement the replacement for the search-string
     * @return the input string in which all search-strings are replaced with the replacement-string.
     * @throws IllegalArgumentException when on of the parameters is null.
     */
    public static String replaceFirst(String input, String search, String replacement) {
        if (input == null || search == null || replacement == null) {
            throw new IllegalArgumentException("TextUtil.replace: given input parameters must not be null.");
        }
        int pos = input.indexOf(search);
        if (pos == -1) {
            return input;
        }
        StringBuffer buffer = new StringBuffer();
        buffer.append(input.substring(0, pos)).append(replacement).append(input.substring(pos + search.length()));
        return buffer.toString();
    }

    /**
     * Takes a list and returns a space separated string with the string values of each list element.
     * 
     * @param arguments a list with objects
     * @return all objects in a string
     */
    public static String toString(List arguments) {
        StringBuffer buffer = new StringBuffer();
        for (Iterator iter = arguments.iterator(); iter.hasNext();) {
            String element = iter.next().toString();
            buffer.append(element);
            if (iter.hasNext()) {
                buffer.append(' ');
            }
        }
        return buffer.toString();
    }
}

Related

1. replace(String string, String pattern, String value)
2. replace(String string, String pattern, String value)
3. replace(String target, String replacement, String... args)
4. replaceAll(String source, String toReplace, String replacement)
5. replaceEmitKeys(String map, Collection newKeys)
6. replaceIgnoreCase(String line, String oldString, String newString)
7. replaceIgnoreCase(String source, String strBeReplace, String strReplaced)
8. replaceNonPrintableAsciiCharacters(String str)
9. replaceOnce(String template, String placeholder, String replacement)