package org.apache.maven.surefire.util.internal;

 /*

  * Licensed to the Apache Software Foundation (ASF) under one

  * or more contributor license agreements.  See the NOTICE file

  * distributed with this work for additional information

  * regarding copyright ownership.  The ASF licenses this file

  * to you under the Apache License, Version 2.0 (the

  * "License"); you may not use this file except in compliance

  * with the License.  You may obtain a copy of the License at

  *

  *     http://www.apache.org/licenses/LICENSE-2.0

  *

  * Unless required by applicable law or agreed to in writing,

  * software distributed under the License is distributed on an

  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY

  * KIND, either express or implied.  See the License for the

  * specific language governing permissions and limitations

  * under the License.

  */

 import java.util.StringTokenizer;

 /**

  * <p>Common <code>String</code> manipulation routines.</p>

  *

  * <p>Originally from

  * <a href="http://jakarta.apache.org/turbine/">Turbine</a> and the

  * GenerationJavaCore library.</p>

  *

  * @author <a href="mailto:jon@latchkey.com">Jon S. Stevens</a>

  * @author <a href="mailto:dlr@finemaltcoding.com">Daniel Rall</a>

  * @author <a href="mailto:gcoladonato@yahoo.com">Greg Coladonato</a>

  * @author <a href="mailto:bayard@generationjava.com">Henri Yandell</a>

  * @author <a href="mailto:ed@codehaus.org">Ed Korthof</a>

  * @author <a href="mailto:rand_mcneely@yahoo.com">Rand McNeely</a>

  * @author Stephen Colebourne

  * @author <a href="mailto:fredrik@westermarck.com">Fredrik Westermarck</a>

  * @author Holger Krauth

  * @author <a href="mailto:alex@purpletech.com">Alexander Day Chaffee</a>

  * @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>

  * @since 1.0

  * @version $Id: StringUtils.java 8001 2009-01-03 13:17:09Z vsiveton $

  * @noinspection JavaDoc

  *

  * A quick borrow from plexus-utils by Kristian Rosenvold, to restore jdk1.3 compat

  * Threw away all the unused stuff.

  *

  * NOTE: This class is not part of any api and is public purely for technical reasons !

  */

 public class StringUtils

 {

     // Splitting

     //--------------------------------------------------------------------------

     public static String[] split( String text, String separator )

     {

         int max = -1;

         StringTokenizer tok;

         if ( separator == null )

         {

             // Null separator means we're using StringTokenizer's default

             // delimiter, which comprises all whitespace characters.

             tok = new StringTokenizer( text );

         }

         else

         {

             tok = new StringTokenizer( text, separator );

         }

         int listSize = tok.countTokens();

         if ( ( max > 0 ) && ( listSize > max ) )

         {

             listSize = max;

         }

         String[] list = new String[listSize];

         int i = 0;

         int lastTokenBegin;

         int lastTokenEnd = 0;

         while ( tok.hasMoreTokens() )

         {

             if ( ( max > 0 ) && ( i == listSize - 1 ) )

             {

                 // In the situation where we hit the max yet have

                 // tokens left over in our input, the last list

                 // element gets all remaining text.

                 String endToken = tok.nextToken();

                 lastTokenBegin = text.indexOf( endToken, lastTokenEnd );

                 list[i] = text.substring( lastTokenBegin );

                 break;

             }

             else

             {

                 list[i] = tok.nextToken();

                 lastTokenBegin = text.indexOf( list[i], lastTokenEnd );

                 lastTokenEnd = lastTokenBegin + list[i].length();

             }

             i++;

         }

         return list;

     }

     // Replacing

     //--------------------------------------------------------------------------

     /**

      * <p>Replace all occurrences of a String within another String.</p>

      *

      * <p>A <code>null</code> reference passed to this method is a no-op.</p>

      *

      * @param text text to search and replace in

      * @param repl String to search for

      * @param with String to replace with

      * @return the text with any replacements processed

      */

     public static String replace( String text, String repl, String with )

     {

         int max = -1;

         if ( ( text == null ) || ( repl == null ) || ( with == null ) || ( repl.length() == 0 ) )

         {

             return text;

         }

         StringBuffer buf = new StringBuffer( text.length() );

         int start = 0, end;

         while ( ( end = text.indexOf( repl, start ) ) != -1 )

         {

             buf.append( text.substring( start, end ) ).append( with );

             start = end + repl.length();

             if ( --max == 0 )

             {

                 break;

             }

         }

         buf.append( text.substring( start ) );

         return buf.toString();

     }

     /**

      * <p>Checks if a (trimmed) String is <code>null</code> or blank.</p>

      *

      * @param str the String to check

      * @return <code>true</code> if the String is <code>null</code>, or

      *  length zero once trimmed

      */

     public static boolean isBlank( String str )

     {

         return ( ( str == null ) || ( str.trim().length() == 0 ) );

     }

 }