Java Collection Join joinStrings(Collection strings)

Description

Join a collection of strings into a single String object, in the order indicated by the collection's iterator.

License

Open Source License

Parameter

Parameter	Description
strings	a collection containing exclusively String objects

Exception

Parameter	Description
IllegalArgumentException	if the collection contains an elementthat is not a String

Return

a single String object

Declaration

public static String joinStrings(Collection strings)
    

Method Source Code

//package com.java2s;
/**// w w w.  jav a 2s . c  o m
 * Copyright 2000-2006 DFKI GmbH.
 * All Rights Reserved.  Use is subject to license terms.
 * 
 * Permission is hereby granted, free of charge, to use and distribute
 * this software and its documentation without restriction, including
 * without limitation the rights to use, copy, modify, merge, publish,
 * distribute, sublicense, and/or sell copies of this work, and to
 * permit persons to whom this work is furnished to do so, subject to
 * the following conditions:
 * 
 * 1. The code must retain the above copyright notice, this list of
 *    conditions and the following disclaimer.
 * 2. Any modifications must be clearly marked as such.
 * 3. Original authors' names are not deleted.
 * 4. The authors' names are not used to endorse or promote products
 *    derived from this software without specific prior written
 *    permission.
 *
 * DFKI GMBH AND THE CONTRIBUTORS TO THIS WORK DISCLAIM ALL WARRANTIES WITH
 * REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL DFKI GMBH NOR THE
 * CONTRIBUTORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
 * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
 * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
 * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
 * THIS SOFTWARE.
 */

import java.util.Collection;

import java.util.Iterator;

public class Main {
    /**
     * Join a collection of strings into a single String object, in the order
     * indicated by the collection's iterator.
     * @param strings a collection containing exclusively String objects
     * @return a single String object
     * @throws IllegalArgumentException if the collection contains an element
     * that is not a String
     */
    public static String joinStrings(Collection strings) {
        StringBuffer buf = new StringBuffer();
        if (strings == null) {
            throw new NullPointerException("Received null collection");
        }
        for (Iterator it = strings.iterator(); it.hasNext();) {
            Object obj = it.next();
            if (obj == null) {
                throw new NullPointerException(
                        "Received collection containing null object");
            }
            if (!(obj instanceof String)) {
                throw new IllegalArgumentException(
                        "Received collection containing non-String object: "
                                + obj.toString());
            }
            buf.append((String) obj);
        }
        return buf.toString();
    }
}

Related

1. joinSequence(Collection sequence)
2. joinSort(Collection c, String separator)
3. joinSorted(Collection s, String delimiter)
4. joinString(Collection values, String delimiter)
5. joinStringCollection(Collection collection, String separator)
6. joinStrings(Collection names)
7. joinStrings(Collection strings)
8. joinStrings(String delim, Collection strs)
9. joinStringValues(Collection