Java/Data Type/String Strip

Chop i characters off the end of a string.

   <source lang="java">
   

/*

* 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;

/**

*
*  @author 
*  @version $Id: StringUtils.java 685685 2008-08-13 21:43:27Z nbubna $
*/

public class Main {

 /**
  * Line separator for the OS we are operating on.
  */
 private static final String EOL = System.getProperty("line.separator");

 /**
  * Chop i characters off the end of a string.
  * This method assumes that any EOL characters in String s
  * and the platform EOL will be the same.
  * A 2 character EOL will count as 1 character.
  *
  * @param s String to chop.
  * @param i Number of characters to chop.
  * @return String with processed answer.
  */
 public static String chop(String s, int i)
 {
     return chop(s, i, EOL);
 }
 /**
  * Chop i characters off the end of a string.
  * A 2 character EOL will count as 1 character.
  *
  * @param s String to chop.
  * @param i Number of characters to chop.
  * @param eol A String representing the EOL (end of line).
  * @return String with processed answer.
  */
 public static String chop(String s, int i, String eol)
 {
     if ( i == 0 || s == null || eol == null )
     {
        return s;
     }
     int length = s.length();
     /*
      * if it is a 2 char EOL and the string ends with
      * it, nip it off.  The EOL in this case is treated like 1 character
      */
     if ( eol.length() == 2 && s.endsWith(eol ))
     {
         length -= 2;
         i -= 1;
     }
     if ( i > 0)
     {
         length -= i;
     }
     if ( length < 0)
     {
         length = 0;
     }
     return s.substring( 0, length);
 }

}

 </source>
   
  
 
  

Filters string

   <source lang="java">

/*

* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common
* Development and Distribution License("CDDL") (collectively, the
* "License"). You may not use this file except in compliance with the
* License. You can obtain a copy of the License at
* http://www.netbeans.org/cddl-gplv2.html
* or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
* specific language governing permissions and limitations under the
* License.  When distributing the software, include this License Header
* Notice in each file and include the License file at
* nbbuild/licenses/CDDL-GPL-2-CP.  Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the
* License Header, with the fields enclosed by brackets [] replaced by
* your own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* Contributor(s):
*
* The Original Software is NetBeans. The Initial Developer of the Original
* Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
* Microsystems, Inc. All Rights Reserved.
*
* If you wish your version of this file to be governed by only the CDDL
* or only the GPL Version 2, indicate your decision by adding
* "[Contributor] elects to include this software in this distribution
* under the [CDDL or GPL Version 2] license." If you do not indicate a
* single choice of license, a recipient has the option to distribute
* your version of this file under either the CDDL, the GPL Version 2 or
* to extend the choice of license to its licensees as provided above.
* However, if you add GPL Version 2 code and therefore, elected the GPL
* Version 2 license, then the option applies only if the new code is
* made subject to such option by the copyright holder.
*/

import java.io.BufferedReader; import java.io.IOException; import java.io.PrintStream; import java.io.StringReader; import java.util.ArrayList; /** Filters string, you can simple use replaceString() method or create string

* filter for more sophisticated filtering.
*

*

* Usage:
*

 * StringFilter sf = new StringFilter();
 * // remove 1st comment
 * sf.addReplaceFilter("/*",  "*/", "");
 * // replace all multiple spaces
 * sf.addReplaceAllFilter("  ", " ");
 * // change author name
 * sf.addReplaceFilter("author: ", "", "author: spl@sun.ru");
 * String string = "/* comment */    4s  2s   3s author: xxx@sun.ru";
 * String result = sf.filter(string);
 * 

*
* @author Martin.Schovanek@sun.ru
* @see #replaceString(String original, String begin, String end, String replace)
*/

public class StringFilter {

   ArrayList<Pattern> filter = new ArrayList<Pattern>();
   
   /** Adds replace pattern into Filter.
    * @see #replaceString(String original, String begin, String end, String replace )
    * @param begin the begin of substring to be find
    * @param end the end of substring to be find
    * @param replace text to replace
    */
   public void addReplaceFilter(String begin, String end, String replace) {
       filter.add(new Pattern(begin, end, replace));
   }
   
   /** Adds replace pattern into Filter.
    * @see #replaceString(String original, String begin, String end, String replace )
    * @param find text to find
    * @param replace text to replace
    */
   public void addReplaceAllFilter(String find, String replace) {
       filter.add(new Pattern(find, find, replace));
   }
   
   /** Filters string.
    * @param str text to filter
    * @return filtred string
    */
   public String filter(String str) {
       for (int i = 0; i < filter.size(); i++) {
           Pattern p = (Pattern) filter.get(i);
           if (p != null)  str = replaceString(str, p.begin, p.end, p.replace);
       }
       return str;
   }
   
   /** Finds substring which starts with first occurrence of "begin" and ends
    * with nearest next occurrence of "end" and replces it with "replace ".<p>
    *
    * Usage:

*

     * replaceString("a-bcd-ef",    "b",  "d",  "")   => a--ef
     * replaceString("abc-def",     "",   "c",  "")   => -def
     * replaceString("ab-cdef",     "c",  "",   "")   => ab-
     * replaceString("ab-cdef-ab",  "ab", "ab", "AB") => AB-cdef-AB
     * replaceString("abcdef",      "",    "",  "AB") => abcdef
     * 

    *
    * @return filtred string
    * @param replace text to replace
    * @param original the original string
    * @param begin the begin of substring to be find
    * @param end the end of substring to be find
    */
   public static String replaceString(String original, String begin, String end, String replace ) {
       boolean replaceAll = false;
       int from;
       int to;
       int offset = 0;
       
       if (isEmpty(original) || (isEmpty(begin) && isEmpty(end))) return original;
       if (begin.equals(end)) replaceAll = true;
       do {
           from = isEmpty(begin) ? 0 : original.indexOf(begin, offset);
           if (from < 0)
               break;
           if (isEmpty(end)) {
               to = original.length();
           } else {
               to = original.indexOf(end, from);
               if (to < 0)
                   break;
               to += end.length();
           }
           original = original.substring(0, from) + replace  + original.substring(to, original.length());
           offset = from + replace.length();
       } while (replaceAll);
       
       return original;
   }
   
   /** Finds and replace all substrings.
    * @see #replaceString(String original, String begin, String end, String replace)
    * @param original the original string
    * @param find text to find
    * @param replace text to replace
    * @return filtred string
    */
   public static String replaceStringAll(String original, String find, String replace) {
       return replaceString(original, find, find, replace);
   }
   
   private static boolean isEmpty(String s) {
       return s == "" || s == null;
   }
   
   /** Filters input string to a PrintStream.
    * @param input string to be filtered
    * @param output stream to write results in
    */    
   public void filterLinesToStream (String input, PrintStream output) {
       BufferedReader br = new BufferedReader (new StringReader (input));
       try {
           for (;;) {
               String str = br.readLine();
               if (str == null)
                   break;
               str = filter (str);
               output.println (str);
           }
       } catch (IOException e) {
       } finally {
           try { br.close (); } catch (IOException e) {}
       }
   }
   
   private class Pattern {
       private String begin;
       private String end;
       private String replace;
       
       public Pattern(String begin, String end, String replace) {
           this.begin = begin;
           this.end = end;
           this.replace = replace;
       }
   }

}

 </source>
   
  
 
  

Gets the leftmost len characters of a String

   <source lang="java">
     

/**

* 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.
*/

/**

* <p>Operations on {@link java.lang.String} that are

* null safe.

*
* @see java.lang.String
* @author 
* @author Arun Mammen Thomas
* @author Gary Gregory
* @author Phil Steitz
* @author Al Chou
* @author Michael Davey
* @author Reuben Sivan
* @author Chris Hyzer
* @author Scott Johnson
* @since 1.0
* @version $Id: StringUtils.java 635447 2008-03-10 06:27:09Z bayard $
*/

public class Main {

 //-----------------------------------------------------------------------
 /**

*

Gets the leftmost len characters of a String.

  *

*

If len characters are not available, or the * String is null, the String will be returned without * an exception. An exception is thrown if len is negative.

  *

*

   * StringUtils.left(null, *)    = null
   * StringUtils.left(*, -ve)     = ""
   * StringUtils.left("", *)      = ""
   * StringUtils.left("abc", 0)   = ""
   * StringUtils.left("abc", 2)   = "ab"
   * StringUtils.left("abc", 4)   = "abc"
   * 

  *
  * @param str  the String to get the leftmost characters from, may be null
  * @param len  the length of the required String, must be zero or positive
  * @return the leftmost characters, null if null String input
  */
 public static String left(String str, int len) {
     if (str == null) {
         return null;
     }
     if (len < 0) {
         return "";
     }
     if (str.length() <= len) {
         return str;
     }
     return str.substring(0, len);
 }

}

 </source>
   
  
 
  

Gets the rightmost len characters of a String.

   <source lang="java">
     

/**

* 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.
*/

/**

*

Operations on {@link java.lang.String} that are * null safe.

*
* @see java.lang.String
* @author 
* @author Arun Mammen Thomas
* @author Gary Gregory
* @author Phil Steitz
* @author Al Chou
* @author Michael Davey
* @author Reuben Sivan
* @author Chris Hyzer
* @author Scott Johnson
* @since 1.0
* @version $Id: StringUtils.java 635447 2008-03-10 06:27:09Z bayard $
*/

public class Main {

 /**

*

Gets the rightmost len characters of a String.

  *

*

If len characters are not available, or the String * is null, the String will be returned without an * an exception. An exception is thrown if len is negative.

  *

*

   * StringUtils.right(null, *)    = null
   * StringUtils.right(*, -ve)     = ""
   * StringUtils.right("", *)      = ""
   * StringUtils.right("abc", 0)   = ""
   * StringUtils.right("abc", 2)   = "bc"
   * StringUtils.right("abc", 4)   = "abc"
   * 

  *
  * @param str  the String to get the rightmost characters from, may be null
  * @param len  the length of the required String, must be zero or positive
  * @return the rightmost characters, null if null String input
  */
 public static String right(String str, int len) {
     if (str == null) {
         return null;
     }
     if (len < 0) {
         return "";
     }
     if (str.length() <= len) {
         return str;
     }
     return str.substring(str.length() - len);
 }

}

 </source>
   
  
 
  

Remove/collapse multiple newline characters.

   <source lang="java">
     

/*

* 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.    
*/

/**

*
*  @author 
*  @version $Id: StringUtils.java 685685 2008-08-13 21:43:27Z nbubna $
*/

public class Main {

 /**
  * Remove/collapse multiple newline characters.
  *
  * @param argStr string to collapse newlines in.
  * @return String
  */
 public static String collapseNewlines(String argStr)
 {
     char last = argStr.charAt(0);
     StringBuffer argBuf = new StringBuffer();
     for (int cIdx = 0 ; cIdx < argStr.length(); cIdx++)
     {
         char ch = argStr.charAt(cIdx);
         if (ch != "\n" || last != "\n")
         {
             argBuf.append(ch);
             last = ch;
         }
     }
     return argBuf.toString();
 }

}

 </source>
   
  
 
  

Removes a substring only if it is at the begining of a source string, otherwise returns the source string.

   <source lang="java">
     

/*

* 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.
*/

public class Main {

 // Remove
 //-----------------------------------------------------------------------
 /**

*

Removes a substring only if it is at the begining of a source string, * otherwise returns the source string.

  *

*

A null source string will return null. * An empty ("") source string will return the empty string. * A null search string will return the source string.

  *

*

   * StringUtils.removeStart(null, *)      = null
   * StringUtils.removeStart("", *)        = ""
   * StringUtils.removeStart(*, null)      = *
   * StringUtils.removeStart("www.domain.ru", "www.")   = "domain.ru"
   * StringUtils.removeStart("domain.ru", "www.")       = "domain.ru"
   * StringUtils.removeStart("www.domain.ru", "domain") = "www.domain.ru"
   * StringUtils.removeStart("abc", "")    = "abc"
   * 

  *
  * @param str  the source String to search, may be null
  * @param remove  the String to search for and remove, may be null
  * @return the substring with the string removed if found,
  *  null if null String input
  * @since 2.1
  */
 public static String removeStart(String str, String remove) {
     if (isEmpty(str) || isEmpty(remove)) {
         return str;
     }
     if (str.startsWith(remove)){
         return str.substring(remove.length());
     }
     return str;
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Removes a substring only if it is at the end of a source string, otherwise returns the source string.

   <source lang="java">
     

/*

* 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.
*/

public class Main {

 /**

*

Removes a substring only if it is at the end of a source string, * otherwise returns the source string.

  *

*

A null source string will return null. * An empty ("") source string will return the empty string. * A null search string will return the source string.

  *

*

   * StringUtils.removeEnd(null, *)      = null
   * StringUtils.removeEnd("", *)        = ""
   * StringUtils.removeEnd(*, null)      = *
   * StringUtils.removeEnd("www.domain.ru", ".ru.")  = "www.domain.ru"
   * StringUtils.removeEnd("www.domain.ru", ".ru")   = "www.domain"
   * StringUtils.removeEnd("www.domain.ru", "domain") = "www.domain.ru"
   * StringUtils.removeEnd("abc", "")    = "abc"
   * 

  *
  * @param str  the source String to search, may be null
  * @param remove  the String to search for and remove, may be null
  * @return the substring with the string removed if found,
  *  null if null String input
  * @since 2.1
  */
 public static String removeEnd(String str, String remove) {
     if (isEmpty(str) || isEmpty(remove)) {
         return str;
     }
     if (str.endsWith(remove)) {
         return str.substring(0, str.length() - remove.length());
     }
     return str;
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Removes newline, carriage return and tab characters from a string

   <source lang="java">
      

/**************************************************************************************

* Copyright (c) Jonas Bon�r, Alexandre Vasseur. All rights reserved.                 *
* http://aspectwerkz.codehaus.org                                                    *
* ---------------------------------------------------------------------------------- *
* The software in this package is published under the terms of the LGPL license      *
* a copy of which has been included with this distribution in the license.txt file.  *
**************************************************************************************/

import java.util.List; import java.util.ArrayList; /**

* Utility methods for strings.
*
* @author 
*/

public class Strings {

   /**
    * Removes newline, carriage return and tab characters from a string.
    *
    * @param toBeEscaped string to escape
    * @return the escaped string
    */
   public static String removeFormattingCharacters(final String toBeEscaped) {
       StringBuffer escapedBuffer = new StringBuffer();
       for (int i = 0; i < toBeEscaped.length(); i++) {
           if ((toBeEscaped.charAt(i) != "\n") && (toBeEscaped.charAt(i) != "\r") && (toBeEscaped.charAt(i) != "\t")) {
               escapedBuffer.append(toBeEscaped.charAt(i));
           }
       }
       String s = escapedBuffer.toString();
       return s;//
       // Strings.replaceSubString(s, "\"", "")
   }
  

}

 </source>
   
  
 
  

Removes separator from the end of str if it"s there, otherwise leave it alone.

   <source lang="java">
    

import java.io.PrintWriter; import java.sql.Connection; import java.sql.SQLException; /*

* 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.
*
*
*/

public class Main {

 /**

*

Removes separator from the end of * str if it"s there, otherwise leave it alone.

  *

*

NOTE: This method changed in version 2.0. * It now more closely matches Perl chomp. * For the previous behavior, use {@link #substringBeforeLast(String, String)}. * This method uses {@link String#endsWith(String)}.

  *

*

   * StringUtils.chomp(null, *)         = null
   * StringUtils.chomp("", *)           = ""
   * StringUtils.chomp("foobar", "bar") = "foo"
   * StringUtils.chomp("foobar", "baz") = "foobar"
   * StringUtils.chomp("foo", "foo")    = ""
   * StringUtils.chomp("foo ", "foo")   = "foo "
   * StringUtils.chomp(" foo", "foo")   = " "
   * StringUtils.chomp("foo", "foooo")  = "foo"
   * StringUtils.chomp("foo", "")       = "foo"
   * StringUtils.chomp("foo", null)     = "foo"
   * 

  *
  * @param str  the String to chomp from, may be null
  * @param separator  separator String, may be null
  * @return String without trailing separator, null if null String input
  */
 public static String chomp(String str, String separator) {
     if (isEmpty(str) || separator == null) {
         return str;
     }
     if (str.endsWith(separator)) {
         return str.substring(0, str.length() - separator.length());
     }
     return str;
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Remove the last character from a String.

   <source lang="java">
    

import java.io.PrintWriter; import java.sql.Connection; import java.sql.SQLException; /*

* 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.
*
*
*/

public class Main {

 /**
  * \u000a linefeed LF ("\n").
  * 
  * @see 
  * @since 2.2
  */
 public static final char CR = "\r";
 // Chopping
 //-----------------------------------------------------------------------
 /**

*

Remove the last character from a String.

  *

*

If the String ends in \r\n, then remove both * of them.

  *

*

   * StringUtils.chop(null)          = null
   * StringUtils.chop("")            = ""
   * StringUtils.chop("abc \r")      = "abc "
   * StringUtils.chop("abc\n")       = "abc"
   * StringUtils.chop("abc\r\n")     = "abc"
   * StringUtils.chop("abc")         = "ab"
   * StringUtils.chop("abc\nabc")    = "abc\nab"
   * StringUtils.chop("a")           = ""
   * StringUtils.chop("\r")          = ""
   * StringUtils.chop("\n")          = ""
   * StringUtils.chop("\r\n")        = ""
   * 

  *
  * @param str  the String to chop last character from, may be null
  * @return String without last character, null if null String input
  */
 public static String chop(String str) {
     if (str == null) {
         return null;
     }
     int strLen = str.length();
     if (strLen < 2) {
         return "";
     }
     int lastIdx = strLen - 1;
     String ret = str.substring(0, lastIdx);
     char last = str.charAt(lastIdx);
     if (last == LF) {
         if (ret.charAt(lastIdx - 1) == CR) {
             return ret.substring(0, lastIdx - 1);
         }
     }
     return ret;
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Remove the leading and trailing quotes from str.

   <source lang="java">
     

/**

* 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.
*/

/**

* Contains useful helper methods for classes within this package.
*
* @author John Keyes (john at integralsource.ru)
* @version $Revision: 680644 $, $Date: 2008-07-29 01:13:48 -0700 (Tue, 29 Jul 2008) $
*/

public class Main {

 /**
  * Remove the leading and trailing quotes from str.
  * E.g. if str is ""one two"", then "one two" is returned.
  *
  * @param str The string from which the leading and trailing quotes
  * should be removed.
  *
  * @return The string without the leading and trailing quotes.
  */
 static String stripLeadingAndTrailingQuotes(String str)
 {
     if (str.startsWith("\""))
     {
         str = str.substring(1, str.length());
     }
     if (str.endsWith("\""))
     {
         str = str.substring(0, str.length() - 1);
     }
     return str;
 }

}

 </source>
   
  
 
  

Strip Line Breaks

   <source lang="java">
      

/**

* 
* The ObjectStyle Group Software License, version 1.1
* ObjectStyle Group - http://objectstyle.org/
* 
* Copyright (c) 2002-2005, Andrei (Andrus) Adamchik and individual authors
* of the software. All rights reserved.
* 
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 
* 1. Redistributions of source code must retain the above copyright
*    notice, this list of conditions and the following disclaimer.
* 
* 2. Redistributions in binary form must reproduce the above copyright
*    notice, this list of conditions and the following disclaimer in
*    the documentation and/or other materials provided with the
*    distribution.
* 
* 3. The end-user documentation included with the redistribution, if any,
*    must include the following acknowlegement:
*    "This product includes software developed by independent contributors
*    and hosted on ObjectStyle Group web site (http://objectstyle.org/)."
*    Alternately, this acknowlegement may appear in the software itself,
*    if and wherever such third-party acknowlegements normally appear.
* 
* 4. The names "ObjectStyle Group" and "Cayenne" must not be used to endorse
*    or promote products derived from this software without prior written
*    permission. For written permission, email
*    "andrus at objectstyle dot org".
* 
* 5. Products derived from this software may not be called "ObjectStyle"
*    or "Cayenne", nor may "ObjectStyle" or "Cayenne" appear in their
*    names without prior written permission.
* 
* THIS SOFTWARE IS PROVIDED ``AS IS"" AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED.  IN NO EVENT SHALL THE OBJECTSTYLE GROUP OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* 
* 
* This software consists of voluntary contributions made by many
* individuals and hosted on ObjectStyle Group web site.  For more
* information on the ObjectStyle Group, please see
* <http://objectstyle.org/>.
*/

import java.io.BufferedInputStream; import java.io.BufferedOutputStream; import java.io.BufferedReader; import java.io.ByteArrayInputStream; import java.io.ByteArrayOutputStream; import java.io.File; import java.io.FileInputStream; import java.io.FileOutputStream; import java.io.FileReader; import java.io.IOException; import java.io.InputStream; import java.io.ObjectInputStream; import java.io.ObjectOutputStream; import java.io.OutputStream; import java.io.Serializable; import java.lang.reflect.Member; import java.lang.reflect.Modifier; import java.net.URL; import java.sql.SQLException; import java.util.ArrayList; import java.util.Collection; import java.util.Collections; import java.util.ruparator; import java.util.HashMap; import java.util.Iterator; import java.util.List; import java.util.Map; import java.util.regex.Pattern; import javax.xml.parsers.ParserConfigurationException; import javax.xml.parsers.SAXParser; import javax.xml.parsers.SAXParserFactory;

import org.xml.sax.SAXException; import org.xml.sax.XMLReader; /**

* Contains various unorganized static utility methods used across Cayenne.
* 
* @author Andrei Adamchik
*/

public class Util {

 /**
  * Strips "\n", "\r\n", "\r" from the argument string.
  * 
  * @since 1.2
  */
 public static String stripLineBreaks(String string, String replaceWith) {

     int len = string.length();
     StringBuffer buffer = new StringBuffer(len);
     for (int i = 0; i < len; i++) {
         char c = string.charAt(i);
         // skip \n, \r, \r\n
         switch (c) {
             case "\n":
             case "\r": // do lookahead
                 if (i + 1 < len && string.charAt(i + 1) == "\n") {
                     i++;
                 }
                 buffer.append(replaceWith);
                 break;
             default:
                 buffer.append(c);
         }
     }
     return buffer.toString();
 }

}

 </source>
   
  
 
  

Strips any of a set of characters from the end of a String.

   <source lang="java">
     

import java.util.Calendar; import java.util.Date; import java.util.Iterator; import java.util.TimeZone;

/**

* 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.
*/

/**

*

Operations on {@link java.lang.String} that are * null safe.

*
* @see java.lang.String
* @author 
* @author Arun Mammen Thomas
* @author Gary Gregory
* @author Phil Steitz
* @author Al Chou
* @author Michael Davey
* @author Reuben Sivan
* @author Chris Hyzer
* @author Scott Johnson
* @since 1.0
* @version $Id: StringUtils.java 635447 2008-03-10 06:27:09Z bayard $
*/

public class Main {

 /**

*

Strips any of a set of characters from the end of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripEnd(null, *)          = null
   * StringUtils.stripEnd("", *)            = ""
   * StringUtils.stripEnd("abc", "")        = "abc"
   * StringUtils.stripEnd("abc", null)      = "abc"
   * StringUtils.stripEnd("  abc", null)    = "  abc"
   * StringUtils.stripEnd("abc  ", null)    = "abc"
   * StringUtils.stripEnd(" abc ", null)    = " abc"
   * StringUtils.stripEnd("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripEnd(String str, String stripChars) {
     int end;
     if (str == null || (end = str.length()) == 0) {
         return str;
     }
     if (stripChars == null) {
         while ((end != 0) && Character.isWhitespace(str.charAt(end - 1))) {
             end--;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((end != 0) && (stripChars.indexOf(str.charAt(end - 1)) != -1)) {
             end--;
         }
     }
     return str.substring(0, end);
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Strips any of a set of characters from the start and end of a String allowing the characters to be stripped to be controlled.

   <source lang="java">
     

import java.util.Calendar; import java.util.Date; import java.util.Iterator; import java.util.TimeZone;

/**

* 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.
*/

/**

*

Operations on {@link java.lang.String} that are * null safe.

*
* @see java.lang.String
* @author 
* @author Arun Mammen Thomas
* @author Gary Gregory
* @author Phil Steitz
* @author Al Chou
* @author Michael Davey
* @author Reuben Sivan
* @author Chris Hyzer
* @author Scott Johnson
* @since 1.0
* @version $Id: StringUtils.java 635447 2008-03-10 06:27:09Z bayard $
*/

public class Main {

 /**

*

Strips any of a set of characters from the start and end of a String. * This is similar to {@link String#trim()} but allows the characters * to be stripped to be controlled.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}. * Alternatively use {@link #strip(String)}.

  *

*

   * StringUtils.strip(null, *)          = null
   * StringUtils.strip("", *)            = ""
   * StringUtils.strip("abc", null)      = "abc"
   * StringUtils.strip("  abc", null)    = "abc"
   * StringUtils.strip("abc  ", null)    = "abc"
   * StringUtils.strip(" abc ", null)    = "abc"
   * StringUtils.strip("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String strip(String str, String stripChars) {
     if (isEmpty(str)) {
         return str;
     }
     str = stripStart(str, stripChars);
     return stripEnd(str, stripChars);
 }
 /**

*

Strips any of a set of characters from the start of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripStart(null, *)          = null
   * StringUtils.stripStart("", *)            = ""
   * StringUtils.stripStart("abc", "")        = "abc"
   * StringUtils.stripStart("abc", null)      = "abc"
   * StringUtils.stripStart("  abc", null)    = "abc"
   * StringUtils.stripStart("abc  ", null)    = "abc  "
   * StringUtils.stripStart(" abc ", null)    = "abc "
   * StringUtils.stripStart("yxabc  ", "xyz") = "abc  "
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripStart(String str, String stripChars) {
     int strLen;
     if (str == null || (strLen = str.length()) == 0) {
         return str;
     }
     int start = 0;
     if (stripChars == null) {
         while ((start != strLen) && Character.isWhitespace(str.charAt(start))) {
             start++;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((start != strLen) && (stripChars.indexOf(str.charAt(start)) != -1)) {
             start++;
         }
     }
     return str.substring(start);
 }
 /**

*

Strips any of a set of characters from the end of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripEnd(null, *)          = null
   * StringUtils.stripEnd("", *)            = ""
   * StringUtils.stripEnd("abc", "")        = "abc"
   * StringUtils.stripEnd("abc", null)      = "abc"
   * StringUtils.stripEnd("  abc", null)    = "  abc"
   * StringUtils.stripEnd("abc  ", null)    = "abc"
   * StringUtils.stripEnd(" abc ", null)    = " abc"
   * StringUtils.stripEnd("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripEnd(String str, String stripChars) {
     int end;
     if (str == null || (end = str.length()) == 0) {
         return str;
     }
     if (stripChars == null) {
         while ((end != 0) && Character.isWhitespace(str.charAt(end - 1))) {
             end--;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((end != 0) && (stripChars.indexOf(str.charAt(end - 1)) != -1)) {
             end--;
         }
     }
     return str.substring(0, end);
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Strips any of a set of characters from the start and end of every String in an array.

   <source lang="java">
     

/**

* 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.
*/

/**

*

Operations on {@link java.lang.String} that are * null safe.

*
* @see java.lang.String
* @author 
* @author Arun Mammen Thomas
* @author Gary Gregory
* @author Phil Steitz
* @author Al Chou
* @author Michael Davey
* @author Reuben Sivan
* @author Chris Hyzer
* @author Scott Johnson
* @since 1.0
* @version $Id: StringUtils.java 635447 2008-03-10 06:27:09Z bayard $
*/

public class Main {

 // StripAll
 //-----------------------------------------------------------------------
 /**

*

Strips whitespace from the start and end of every String in an array. * Whitespace is defined by {@link Character#isWhitespace(char)}.

  *

*

A new array is returned each time, except for length zero. * A null array will return null. * An empty array will return itself. * A null array entry will be ignored.

  *

*

   * StringUtils.stripAll(null)             = null
   * StringUtils.stripAll([])               = []
   * StringUtils.stripAll(["abc", "  abc"]) = ["abc", "abc"]
   * StringUtils.stripAll(["abc  ", null])  = ["abc", null]
   * 

  *
  * @param strs  the array to remove whitespace from, may be null
  * @return the stripped Strings, null if null array input
  */
 public static String[] stripAll(String[] strs) {
     return stripAll(strs, null);
 }
 /**

*

Strips any of a set of characters from the start and end of every * String in an array.

  * Whitespace is defined by {@link Character#isWhitespace(char)}.</p>
  *

*

A new array is returned each time, except for length zero. * A null array will return null. * An empty array will return itself. * A null array entry will be ignored. * A null stripChars will strip whitespace as defined by * {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripAll(null, *)                = null
   * StringUtils.stripAll([], *)                  = []
   * StringUtils.stripAll(["abc", "  abc"], null) = ["abc", "abc"]
   * StringUtils.stripAll(["abc  ", null], null)  = ["abc", null]
   * StringUtils.stripAll(["abc  ", null], "yz")  = ["abc  ", null]
   * StringUtils.stripAll(["yabcz", null], "yz")  = ["abc", null]
   * 

  *
  * @param strs  the array to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped Strings, null if null array input
  */
 public static String[] stripAll(String[] strs, String stripChars) {
     int strsLen;
     if (strs == null || (strsLen = strs.length) == 0) {
         return strs;
     }
     String[] newArr = new String[strsLen];
     for (int i = 0; i < strsLen; i++) {
         newArr[i] = strip(strs[i], stripChars);
     }
     return newArr;
 }

 /**

*

Strips any of a set of characters from the start and end of a String. * This is similar to {@link String#trim()} but allows the characters * to be stripped to be controlled.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}. * Alternatively use {@link #strip(String)}.

  *

*

   * StringUtils.strip(null, *)          = null
   * StringUtils.strip("", *)            = ""
   * StringUtils.strip("abc", null)      = "abc"
   * StringUtils.strip("  abc", null)    = "abc"
   * StringUtils.strip("abc  ", null)    = "abc"
   * StringUtils.strip(" abc ", null)    = "abc"
   * StringUtils.strip("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String strip(String str, String stripChars) {
     if (isEmpty(str)) {
         return str;
     }
     str = stripStart(str, stripChars);
     return stripEnd(str, stripChars);
 }
 /**

*

Strips any of a set of characters from the start of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripStart(null, *)          = null
   * StringUtils.stripStart("", *)            = ""
   * StringUtils.stripStart("abc", "")        = "abc"
   * StringUtils.stripStart("abc", null)      = "abc"
   * StringUtils.stripStart("  abc", null)    = "abc"
   * StringUtils.stripStart("abc  ", null)    = "abc  "
   * StringUtils.stripStart(" abc ", null)    = "abc "
   * StringUtils.stripStart("yxabc  ", "xyz") = "abc  "
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripStart(String str, String stripChars) {
     int strLen;
     if (str == null || (strLen = str.length()) == 0) {
         return str;
     }
     int start = 0;
     if (stripChars == null) {
         while ((start != strLen) && Character.isWhitespace(str.charAt(start))) {
             start++;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((start != strLen) && (stripChars.indexOf(str.charAt(start)) != -1)) {
             start++;
         }
     }
     return str.substring(start);
 }
 /**

*

Strips any of a set of characters from the end of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripEnd(null, *)          = null
   * StringUtils.stripEnd("", *)            = ""
   * StringUtils.stripEnd("abc", "")        = "abc"
   * StringUtils.stripEnd("abc", null)      = "abc"
   * StringUtils.stripEnd("  abc", null)    = "  abc"
   * StringUtils.stripEnd("abc  ", null)    = "abc"
   * StringUtils.stripEnd(" abc ", null)    = " abc"
   * StringUtils.stripEnd("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripEnd(String str, String stripChars) {
     int end;
     if (str == null || (end = str.length()) == 0) {
         return str;
     }
     if (stripChars == null) {
         while ((end != 0) && Character.isWhitespace(str.charAt(end - 1))) {
             end--;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((end != 0) && (stripChars.indexOf(str.charAt(end - 1)) != -1)) {
             end--;
         }
     }
     return str.substring(0, end);
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Strips any of a set of characters from the start of a String.

   <source lang="java">
     

import java.util.Calendar; import java.util.Date; import java.util.Iterator; import java.util.TimeZone;

/**

* 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.
*/

/**

*

Operations on {@link java.lang.String} that are * null safe.

*
* @see java.lang.String
* @author 
* @author Arun Mammen Thomas
* @author Gary Gregory
* @author Phil Steitz
* @author Al Chou
* @author Michael Davey
* @author Reuben Sivan
* @author Chris Hyzer
* @author Scott Johnson
* @since 1.0
* @version $Id: StringUtils.java 635447 2008-03-10 06:27:09Z bayard $
*/

public class Main {

 /**

*

Strips any of a set of characters from the start of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripStart(null, *)          = null
   * StringUtils.stripStart("", *)            = ""
   * StringUtils.stripStart("abc", "")        = "abc"
   * StringUtils.stripStart("abc", null)      = "abc"
   * StringUtils.stripStart("  abc", null)    = "abc"
   * StringUtils.stripStart("abc  ", null)    = "abc  "
   * StringUtils.stripStart(" abc ", null)    = "abc "
   * StringUtils.stripStart("yxabc  ", "xyz") = "abc  "
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripStart(String str, String stripChars) {
     int strLen;
     if (str == null || (strLen = str.length()) == 0) {
         return str;
     }
     int start = 0;
     if (stripChars == null) {
         while ((start != strLen) && Character.isWhitespace(str.charAt(start))) {
             start++;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((start != strLen) && (stripChars.indexOf(str.charAt(start)) != -1)) {
             start++;
         }
     }
     return str.substring(start);
 }
 /**

*

Strips any of a set of characters from the end of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripEnd(null, *)          = null
   * StringUtils.stripEnd("", *)            = ""
   * StringUtils.stripEnd("abc", "")        = "abc"
   * StringUtils.stripEnd("abc", null)      = "abc"
   * StringUtils.stripEnd("  abc", null)    = "  abc"
   * StringUtils.stripEnd("abc  ", null)    = "abc"
   * StringUtils.stripEnd(" abc ", null)    = " abc"
   * StringUtils.stripEnd("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripEnd(String str, String stripChars) {
     int end;
     if (str == null || (end = str.length()) == 0) {
         return str;
     }
     if (stripChars == null) {
         while ((end != 0) && Character.isWhitespace(str.charAt(end - 1))) {
             end--;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((end != 0) && (stripChars.indexOf(str.charAt(end - 1)) != -1)) {
             end--;
         }
     }
     return str.substring(0, end);
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Strips whitespace from the start and end of a String.

   <source lang="java">
     

import java.util.Calendar; import java.util.Date; import java.util.Iterator; import java.util.TimeZone;

/**

* 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.
*/

/**

*

Operations on {@link java.lang.String} that are * null safe.

*
* @see java.lang.String
* @author 
* @author Arun Mammen Thomas
* @author Gary Gregory
* @author Phil Steitz
* @author Al Chou
* @author Michael Davey
* @author Reuben Sivan
* @author Chris Hyzer
* @author Scott Johnson
* @since 1.0
* @version $Id: StringUtils.java 635447 2008-03-10 06:27:09Z bayard $
*/

public class Main {

 // Stripping
 //-----------------------------------------------------------------------
 /**

*

Strips whitespace from the start and end of a String.

  *

*

This is similar to {@link #trim(String)} but removes whitespace. * Whitespace is defined by {@link Character#isWhitespace(char)}.

  *

*

A null input String returns null.

  *

*

   * StringUtils.strip(null)     = null
   * StringUtils.strip("")       = ""
   * StringUtils.strip("   ")    = ""
   * StringUtils.strip("abc")    = "abc"
   * StringUtils.strip("  abc")  = "abc"
   * StringUtils.strip("abc  ")  = "abc"
   * StringUtils.strip(" abc ")  = "abc"
   * StringUtils.strip(" ab c ") = "ab c"
   * 

  *
  * @param str  the String to remove whitespace from, may be null
  * @return the stripped String, null if null String input
  */
 public static String strip(String str) {
     return strip(str, null);
 }
 /**

*

Strips whitespace from the start and end of a String returning * null if the String is empty ("") after the strip.

  *

*

This is similar to {@link #trimToNull(String)} but removes whitespace. * Whitespace is defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripToNull(null)     = null
   * StringUtils.stripToNull("")       = null
   * StringUtils.stripToNull("   ")    = null
   * StringUtils.stripToNull("abc")    = "abc"
   * StringUtils.stripToNull("  abc")  = "abc"
   * StringUtils.stripToNull("abc  ")  = "abc"
   * StringUtils.stripToNull(" abc ")  = "abc"
   * StringUtils.stripToNull(" ab c ") = "ab c"
   * 

  *
  * @param str  the String to be stripped, may be null
  * @return the stripped String,
  *  null if whitespace, empty or null String input
  * @since 2.0
  */
 public static String stripToNull(String str) {
     if (str == null) {
         return null;
     }
     str = strip(str, null);
     return str.length() == 0 ? null : str;
 }
 /**

*

Strips whitespace from the start and end of a String returning * an empty String if null input.

  *

*

This is similar to {@link #trimToEmpty(String)} but removes whitespace. * Whitespace is defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripToEmpty(null)     = ""
   * StringUtils.stripToEmpty("")       = ""
   * StringUtils.stripToEmpty("   ")    = ""
   * StringUtils.stripToEmpty("abc")    = "abc"
   * StringUtils.stripToEmpty("  abc")  = "abc"
   * StringUtils.stripToEmpty("abc  ")  = "abc"
   * StringUtils.stripToEmpty(" abc ")  = "abc"
   * StringUtils.stripToEmpty(" ab c ") = "ab c"
   * 

  *
  * @param str  the String to be stripped, may be null
  * @return the trimmed String, or an empty String if null input
  * @since 2.0
  */
 public static String stripToEmpty(String str) {
     return str == null ? "" : strip(str, null);
 }
 /**

*

Strips any of a set of characters from the start and end of a String. * This is similar to {@link String#trim()} but allows the characters * to be stripped to be controlled.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}. * Alternatively use {@link #strip(String)}.

  *

*

   * StringUtils.strip(null, *)          = null
   * StringUtils.strip("", *)            = ""
   * StringUtils.strip("abc", null)      = "abc"
   * StringUtils.strip("  abc", null)    = "abc"
   * StringUtils.strip("abc  ", null)    = "abc"
   * StringUtils.strip(" abc ", null)    = "abc"
   * StringUtils.strip("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String strip(String str, String stripChars) {
     if (isEmpty(str)) {
         return str;
     }
     str = stripStart(str, stripChars);
     return stripEnd(str, stripChars);
 }
 /**

*

Strips any of a set of characters from the start of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripStart(null, *)          = null
   * StringUtils.stripStart("", *)            = ""
   * StringUtils.stripStart("abc", "")        = "abc"
   * StringUtils.stripStart("abc", null)      = "abc"
   * StringUtils.stripStart("  abc", null)    = "abc"
   * StringUtils.stripStart("abc  ", null)    = "abc  "
   * StringUtils.stripStart(" abc ", null)    = "abc "
   * StringUtils.stripStart("yxabc  ", "xyz") = "abc  "
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripStart(String str, String stripChars) {
     int strLen;
     if (str == null || (strLen = str.length()) == 0) {
         return str;
     }
     int start = 0;
     if (stripChars == null) {
         while ((start != strLen) && Character.isWhitespace(str.charAt(start))) {
             start++;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((start != strLen) && (stripChars.indexOf(str.charAt(start)) != -1)) {
             start++;
         }
     }
     return str.substring(start);
 }
 /**

*

Strips any of a set of characters from the end of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripEnd(null, *)          = null
   * StringUtils.stripEnd("", *)            = ""
   * StringUtils.stripEnd("abc", "")        = "abc"
   * StringUtils.stripEnd("abc", null)      = "abc"
   * StringUtils.stripEnd("  abc", null)    = "  abc"
   * StringUtils.stripEnd("abc  ", null)    = "abc"
   * StringUtils.stripEnd(" abc ", null)    = " abc"
   * StringUtils.stripEnd("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripEnd(String str, String stripChars) {
     int end;
     if (str == null || (end = str.length()) == 0) {
         return str;
     }
     if (stripChars == null) {
         while ((end != 0) && Character.isWhitespace(str.charAt(end - 1))) {
             end--;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((end != 0) && (stripChars.indexOf(str.charAt(end - 1)) != -1)) {
             end--;
         }
     }
     return str.substring(0, end);
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Strips whitespace from the start and end of a String returning an empty String if null input.

   <source lang="java">
     

import java.util.Calendar; import java.util.Date; import java.util.Iterator; import java.util.TimeZone;

/**

* 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.
*/

/**

*

Operations on {@link java.lang.String} that are * null safe.

*
* @see java.lang.String
* @author 
* @author Arun Mammen Thomas
* @author Gary Gregory
* @author Phil Steitz
* @author Al Chou
* @author Michael Davey
* @author Reuben Sivan
* @author Chris Hyzer
* @author Scott Johnson
* @since 1.0
* @version $Id: StringUtils.java 635447 2008-03-10 06:27:09Z bayard $
*/

public class Main {

 /**

*

Strips whitespace from the start and end of a String returning * an empty String if null input.

  *

*

This is similar to {@link #trimToEmpty(String)} but removes whitespace. * Whitespace is defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripToEmpty(null)     = ""
   * StringUtils.stripToEmpty("")       = ""
   * StringUtils.stripToEmpty("   ")    = ""
   * StringUtils.stripToEmpty("abc")    = "abc"
   * StringUtils.stripToEmpty("  abc")  = "abc"
   * StringUtils.stripToEmpty("abc  ")  = "abc"
   * StringUtils.stripToEmpty(" abc ")  = "abc"
   * StringUtils.stripToEmpty(" ab c ") = "ab c"
   * 

  *
  * @param str  the String to be stripped, may be null
  * @return the trimmed String, or an empty String if null input
  * @since 2.0
  */
 public static String stripToEmpty(String str) {
     return str == null ? "" : strip(str, null);
 }
 /**

*

Strips any of a set of characters from the start and end of a String. * This is similar to {@link String#trim()} but allows the characters * to be stripped to be controlled.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}. * Alternatively use {@link #strip(String)}.

  *

*

   * StringUtils.strip(null, *)          = null
   * StringUtils.strip("", *)            = ""
   * StringUtils.strip("abc", null)      = "abc"
   * StringUtils.strip("  abc", null)    = "abc"
   * StringUtils.strip("abc  ", null)    = "abc"
   * StringUtils.strip(" abc ", null)    = "abc"
   * StringUtils.strip("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String strip(String str, String stripChars) {
     if (isEmpty(str)) {
         return str;
     }
     str = stripStart(str, stripChars);
     return stripEnd(str, stripChars);
 }
 /**

*

Strips any of a set of characters from the start of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripStart(null, *)          = null
   * StringUtils.stripStart("", *)            = ""
   * StringUtils.stripStart("abc", "")        = "abc"
   * StringUtils.stripStart("abc", null)      = "abc"
   * StringUtils.stripStart("  abc", null)    = "abc"
   * StringUtils.stripStart("abc  ", null)    = "abc  "
   * StringUtils.stripStart(" abc ", null)    = "abc "
   * StringUtils.stripStart("yxabc  ", "xyz") = "abc  "
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripStart(String str, String stripChars) {
     int strLen;
     if (str == null || (strLen = str.length()) == 0) {
         return str;
     }
     int start = 0;
     if (stripChars == null) {
         while ((start != strLen) && Character.isWhitespace(str.charAt(start))) {
             start++;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((start != strLen) && (stripChars.indexOf(str.charAt(start)) != -1)) {
             start++;
         }
     }
     return str.substring(start);
 }
 /**

*

Strips any of a set of characters from the end of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripEnd(null, *)          = null
   * StringUtils.stripEnd("", *)            = ""
   * StringUtils.stripEnd("abc", "")        = "abc"
   * StringUtils.stripEnd("abc", null)      = "abc"
   * StringUtils.stripEnd("  abc", null)    = "  abc"
   * StringUtils.stripEnd("abc  ", null)    = "abc"
   * StringUtils.stripEnd(" abc ", null)    = " abc"
   * StringUtils.stripEnd("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripEnd(String str, String stripChars) {
     int end;
     if (str == null || (end = str.length()) == 0) {
         return str;
     }
     if (stripChars == null) {
         while ((end != 0) && Character.isWhitespace(str.charAt(end - 1))) {
             end--;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((end != 0) && (stripChars.indexOf(str.charAt(end - 1)) != -1)) {
             end--;
         }
     }
     return str.substring(0, end);
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Strips whitespace from the start and end of a String returning null if the String is empty ("") after the strip.

   <source lang="java">
     

import java.util.Calendar; import java.util.Date; import java.util.Iterator; import java.util.TimeZone;

/**

* 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.
*/

/**

*

Operations on {@link java.lang.String} that are * null safe.

*
* @see java.lang.String
* @author 
* @author Arun Mammen Thomas
* @author Gary Gregory
* @author Phil Steitz
* @author Al Chou
* @author Michael Davey
* @author Reuben Sivan
* @author Chris Hyzer
* @author Scott Johnson
* @since 1.0
* @version $Id: StringUtils.java 635447 2008-03-10 06:27:09Z bayard $
*/

public class Main {

 /**

*

Strips whitespace from the start and end of a String returning * null if the String is empty ("") after the strip.

  *

*

This is similar to {@link #trimToNull(String)} but removes whitespace. * Whitespace is defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripToNull(null)     = null
   * StringUtils.stripToNull("")       = null
   * StringUtils.stripToNull("   ")    = null
   * StringUtils.stripToNull("abc")    = "abc"
   * StringUtils.stripToNull("  abc")  = "abc"
   * StringUtils.stripToNull("abc  ")  = "abc"
   * StringUtils.stripToNull(" abc ")  = "abc"
   * StringUtils.stripToNull(" ab c ") = "ab c"
   * 

  *
  * @param str  the String to be stripped, may be null
  * @return the stripped String,
  *  null if whitespace, empty or null String input
  * @since 2.0
  */
 public static String stripToNull(String str) {
     if (str == null) {
         return null;
     }
     str = strip(str, null);
     return str.length() == 0 ? null : str;
 }
 /**

*

Strips whitespace from the start and end of a String returning * an empty String if null input.

  *

*

This is similar to {@link #trimToEmpty(String)} but removes whitespace. * Whitespace is defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripToEmpty(null)     = ""
   * StringUtils.stripToEmpty("")       = ""
   * StringUtils.stripToEmpty("   ")    = ""
   * StringUtils.stripToEmpty("abc")    = "abc"
   * StringUtils.stripToEmpty("  abc")  = "abc"
   * StringUtils.stripToEmpty("abc  ")  = "abc"
   * StringUtils.stripToEmpty(" abc ")  = "abc"
   * StringUtils.stripToEmpty(" ab c ") = "ab c"
   * 

  *
  * @param str  the String to be stripped, may be null
  * @return the trimmed String, or an empty String if null input
  * @since 2.0
  */
 public static String stripToEmpty(String str) {
     return str == null ? "" : strip(str, null);
 }
 /**

*

Strips any of a set of characters from the start and end of a String. * This is similar to {@link String#trim()} but allows the characters * to be stripped to be controlled.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}. * Alternatively use {@link #strip(String)}.

  *

*

   * StringUtils.strip(null, *)          = null
   * StringUtils.strip("", *)            = ""
   * StringUtils.strip("abc", null)      = "abc"
   * StringUtils.strip("  abc", null)    = "abc"
   * StringUtils.strip("abc  ", null)    = "abc"
   * StringUtils.strip(" abc ", null)    = "abc"
   * StringUtils.strip("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String strip(String str, String stripChars) {
     if (isEmpty(str)) {
         return str;
     }
     str = stripStart(str, stripChars);
     return stripEnd(str, stripChars);
 }
 /**

*

Strips any of a set of characters from the start of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripStart(null, *)          = null
   * StringUtils.stripStart("", *)            = ""
   * StringUtils.stripStart("abc", "")        = "abc"
   * StringUtils.stripStart("abc", null)      = "abc"
   * StringUtils.stripStart("  abc", null)    = "abc"
   * StringUtils.stripStart("abc  ", null)    = "abc  "
   * StringUtils.stripStart(" abc ", null)    = "abc "
   * StringUtils.stripStart("yxabc  ", "xyz") = "abc  "
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripStart(String str, String stripChars) {
     int strLen;
     if (str == null || (strLen = str.length()) == 0) {
         return str;
     }
     int start = 0;
     if (stripChars == null) {
         while ((start != strLen) && Character.isWhitespace(str.charAt(start))) {
             start++;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((start != strLen) && (stripChars.indexOf(str.charAt(start)) != -1)) {
             start++;
         }
     }
     return str.substring(start);
 }
 /**

*

Strips any of a set of characters from the end of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripEnd(null, *)          = null
   * StringUtils.stripEnd("", *)            = ""
   * StringUtils.stripEnd("abc", "")        = "abc"
   * StringUtils.stripEnd("abc", null)      = "abc"
   * StringUtils.stripEnd("  abc", null)    = "  abc"
   * StringUtils.stripEnd("abc  ", null)    = "abc"
   * StringUtils.stripEnd(" abc ", null)    = " abc"
   * StringUtils.stripEnd("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripEnd(String str, String stripChars) {
     int end;
     if (str == null || (end = str.length()) == 0) {
         return str;
     }
     if (stripChars == null) {
         while ((end != 0) && Character.isWhitespace(str.charAt(end - 1))) {
             end--;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((end != 0) && (stripChars.indexOf(str.charAt(end - 1)) != -1)) {
             end--;
         }
     }
     return str.substring(0, end);
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Strips whitespace from the start and end of every String in an array.

   <source lang="java">
     

/**

* 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.
*/

/**

*

Operations on {@link java.lang.String} that are * null safe.

*
* @see java.lang.String
* @author 
* @author Arun Mammen Thomas
* @author Gary Gregory
* @author Phil Steitz
* @author Al Chou
* @author Michael Davey
* @author Reuben Sivan
* @author Chris Hyzer
* @author Scott Johnson
* @since 1.0
* @version $Id: StringUtils.java 635447 2008-03-10 06:27:09Z bayard $
*/

public class Main {

 // StripAll
 //-----------------------------------------------------------------------
 /**

*

Strips whitespace from the start and end of every String in an array. * Whitespace is defined by {@link Character#isWhitespace(char)}.

  *

*

A new array is returned each time, except for length zero. * A null array will return null. * An empty array will return itself. * A null array entry will be ignored.

  *

*

   * StringUtils.stripAll(null)             = null
   * StringUtils.stripAll([])               = []
   * StringUtils.stripAll(["abc", "  abc"]) = ["abc", "abc"]
   * StringUtils.stripAll(["abc  ", null])  = ["abc", null]
   * 

  *
  * @param strs  the array to remove whitespace from, may be null
  * @return the stripped Strings, null if null array input
  */
 public static String[] stripAll(String[] strs) {
     return stripAll(strs, null);
 }
 /**

*

Strips any of a set of characters from the start and end of every * String in an array.

  * Whitespace is defined by {@link Character#isWhitespace(char)}.</p>
  *

*

A new array is returned each time, except for length zero. * A null array will return null. * An empty array will return itself. * A null array entry will be ignored. * A null stripChars will strip whitespace as defined by * {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripAll(null, *)                = null
   * StringUtils.stripAll([], *)                  = []
   * StringUtils.stripAll(["abc", "  abc"], null) = ["abc", "abc"]
   * StringUtils.stripAll(["abc  ", null], null)  = ["abc", null]
   * StringUtils.stripAll(["abc  ", null], "yz")  = ["abc  ", null]
   * StringUtils.stripAll(["yabcz", null], "yz")  = ["abc", null]
   * 

  *
  * @param strs  the array to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped Strings, null if null array input
  */
 public static String[] stripAll(String[] strs, String stripChars) {
     int strsLen;
     if (strs == null || (strsLen = strs.length) == 0) {
         return strs;
     }
     String[] newArr = new String[strsLen];
     for (int i = 0; i < strsLen; i++) {
         newArr[i] = strip(strs[i], stripChars);
     }
     return newArr;
 }

 /**

*

Strips any of a set of characters from the start and end of a String. * This is similar to {@link String#trim()} but allows the characters * to be stripped to be controlled.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}. * Alternatively use {@link #strip(String)}.

  *

*

   * StringUtils.strip(null, *)          = null
   * StringUtils.strip("", *)            = ""
   * StringUtils.strip("abc", null)      = "abc"
   * StringUtils.strip("  abc", null)    = "abc"
   * StringUtils.strip("abc  ", null)    = "abc"
   * StringUtils.strip(" abc ", null)    = "abc"
   * StringUtils.strip("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String strip(String str, String stripChars) {
     if (isEmpty(str)) {
         return str;
     }
     str = stripStart(str, stripChars);
     return stripEnd(str, stripChars);
 }
 /**

*

Strips any of a set of characters from the start of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripStart(null, *)          = null
   * StringUtils.stripStart("", *)            = ""
   * StringUtils.stripStart("abc", "")        = "abc"
   * StringUtils.stripStart("abc", null)      = "abc"
   * StringUtils.stripStart("  abc", null)    = "abc"
   * StringUtils.stripStart("abc  ", null)    = "abc  "
   * StringUtils.stripStart(" abc ", null)    = "abc "
   * StringUtils.stripStart("yxabc  ", "xyz") = "abc  "
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripStart(String str, String stripChars) {
     int strLen;
     if (str == null || (strLen = str.length()) == 0) {
         return str;
     }
     int start = 0;
     if (stripChars == null) {
         while ((start != strLen) && Character.isWhitespace(str.charAt(start))) {
             start++;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((start != strLen) && (stripChars.indexOf(str.charAt(start)) != -1)) {
             start++;
         }
     }
     return str.substring(start);
 }
 /**

*

Strips any of a set of characters from the end of a String.

  *

*

A null input String returns null. * An empty string ("") input returns the empty string.

  *

*

If the stripChars String is null, whitespace is * stripped as defined by {@link Character#isWhitespace(char)}.

  *

*

   * StringUtils.stripEnd(null, *)          = null
   * StringUtils.stripEnd("", *)            = ""
   * StringUtils.stripEnd("abc", "")        = "abc"
   * StringUtils.stripEnd("abc", null)      = "abc"
   * StringUtils.stripEnd("  abc", null)    = "  abc"
   * StringUtils.stripEnd("abc  ", null)    = "abc"
   * StringUtils.stripEnd(" abc ", null)    = " abc"
   * StringUtils.stripEnd("  abcyx", "xyz") = "  abc"
   * 

  *
  * @param str  the String to remove characters from, may be null
  * @param stripChars  the characters to remove, null treated as whitespace
  * @return the stripped String, null if null String input
  */
 public static String stripEnd(String str, String stripChars) {
     int end;
     if (str == null || (end = str.length()) == 0) {
         return str;
     }
     if (stripChars == null) {
         while ((end != 0) && Character.isWhitespace(str.charAt(end - 1))) {
             end--;
         }
     } else if (stripChars.length() == 0) {
         return str;
     } else {
         while ((end != 0) && (stripChars.indexOf(str.charAt(end - 1)) != -1)) {
             end--;
         }
     }
     return str.substring(0, end);
 }
 // Empty checks
 //-----------------------------------------------------------------------
 /**

*

Checks if a String is empty ("") or null.

  *

*

   * StringUtils.isEmpty(null)      = true
   * StringUtils.isEmpty("")        = true
   * StringUtils.isEmpty(" ")       = false
   * StringUtils.isEmpty("bob")     = false
   * StringUtils.isEmpty("  bob  ") = false
   * 

  *

*

NOTE: This method changed in Lang version 2.0. * It no longer trims the String. * That functionality is available in isBlank().

  *
  * @param str  the String to check, may be null
  * @return true if the String is empty or null
  */
 public static boolean isEmpty(String str) {
     return str == null || str.length() == 0;
 }

}

 </source>
   
  
 
  

Trim any of the characters

   <source lang="java">
      

/*

* Static String formatting and query routines.
* Copyright (C) 2001-2005 Stephen Ostermiller
* http://ostermiller.org/contact.pl?regarding=Java+Utilities
*
* This program 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.
*
* This program 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.
*
* See COPYING.TXT for details.
*/

import java.util.HashMap; import java.util.regex.Pattern; /**

* Utilities for String formatting, manipulation, and queries.
* More information about this class is available from .
*
* @author Stephen Ostermiller http://ostermiller.org/contact.pl?regarding=Java+Utilities
* @since ostermillerutils 1.00.00
*/

public class StringHelper {

 /**
  * Trim any of the characters contained in the second
  * string from the beginning and end of the first.
  *
  * @param s String to be trimmed.
  * @param c list of characters to trim from s.
  * @return trimmed String.
  * @throws NullPointerException if s is null.
  *
  * @since ostermillerutils 1.00.00
  */
 public static String trim(String s, String c){
   int length = s.length();
   if (c == null){
     return s;
   }
   int cLength = c.length();
   if (c.length() == 0){
     return s;
   }
   int start = 0;
   int end = length;
   boolean found; // trim-able character found.
   int i;
   // Start from the beginning and find the
   // first non-trim-able character.
   found = false;
   for (i=0; !found && i<length; i++){
     char ch = s.charAt(i);
     found = true;
     for (int j=0; found && j<cLength; j++){
       if (c.charAt(j) == ch) found = false;
     }
   }
   // if all characters are trim-able.
   if (!found) return "";
   start = i-1;
   // Start from the end and find the
   // last non-trim-able character.
   found = false;
   for (i=length-1; !found && i>=0; i--){
     char ch = s.charAt(i);
     found = true;
     for (int j=0; found && j<cLength; j++){
       if (c.charAt(j) == ch) found = false;
     }
   }
   end = i+2;
   return s.substring(start, end);
 }

}

 </source>
   
  
 
  

Trim off trailing blanks but not leading blanks

   <source lang="java">
   

/*

Derby - Class org.apache.derby.iapi.util.PropertyUtil
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.
*/

public class Main {

 /**
  * Trim off trailing blanks but not leading blanks
  *
  * @param str
  *
  * @return The input with trailing blanks stipped off
  */
 public static String trimTrailing( String str)
 {
     if( str == null)
         return null;
     int len = str.length();
     for( ; len > 0; len--)
     {
         if( ! Character.isWhitespace( str.charAt( len - 1)))
             break;
     }
     return str.substring( 0, len);
 } // end of trimTrailing

}

 </source>
   
  
 
  

Trim specified charcater from end and from of string

   <source lang="java">
  

/**********************************************************************************

*
* Copyright (c) 2003, 2004 The Regents of the University of Michigan, Trustees of Indiana University,
*                  Board of Trustees of the Leland Stanford, Jr., University, and The MIT Corporation
*
* Licensed under the Educational Community License Version 1.0 (the "License");
* By obtaining, using and/or copying this Original Work, you agree that you have read,
* understand, and will comply with the terms and conditions of the Educational Community License.
* You may obtain a copy of the License at:
*
*      http://cvs.sakaiproject.org/licenses/license_1_0.html
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
* INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*
**********************************************************************************/

public class Utils {

 /**
  * Trim specified charcater from front of string
  * 
  * @param text
  *          Text
  * @param character
  *          Character to remove
  * @return Trimmed text
  */
 public static String trimFront(String text, char character) {
   String normalizedText;
   int index;
   if (StringUtils.isNull(text)) {
     return text;
   }
   normalizedText = text.trim();
   index = 0;
   while (normalizedText.charAt(index) == character) {
     index++;
   }
   return normalizedText.substring(index).trim();
 }
 /**
  * Trim specified charcater from end of string
  * 
  * @param text
  *          Text
  * @param character
  *          Character to remove
  * @return Trimmed text
  */
 public static String trimEnd(String text, char character) {
   String normalizedText;
   int index;
   if (StringUtils.isNull(text)) {
     return text;
   }
   normalizedText = text.trim();
   index = normalizedText.length() - 1;
   while (normalizedText.charAt(index) == character) {
     if (--index < 0) {
       return "";
     }
   }
   return normalizedText.substring(0, index + 1).trim();
 }
 /**
  * Trim specified charcater from both ends of a String
  * 
  * @param text
  *          Text
  * @param character
  *          Character to remove
  * @return Trimmed text
  */
 public static String trimAll(String text, char character) {
   String normalizedText = trimFront(text, character);
   return trimEnd(normalizedText, character);
 }

}

 </source>
   
  
 
  

Trim specified charcater from end of string

   <source lang="java">
  

/**********************************************************************************

*
* Copyright (c) 2003, 2004 The Regents of the University of Michigan, Trustees of Indiana University,
*                  Board of Trustees of the Leland Stanford, Jr., University, and The MIT Corporation
*
* Licensed under the Educational Community License Version 1.0 (the "License");
* By obtaining, using and/or copying this Original Work, you agree that you have read,
* understand, and will comply with the terms and conditions of the Educational Community License.
* You may obtain a copy of the License at:
*
*      http://cvs.sakaiproject.org/licenses/license_1_0.html
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
* INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*
**********************************************************************************/

public class Utils {

 /**
  * Trim specified charcater from front of string
  * 
  * @param text
  *          Text
  * @param character
  *          Character to remove
  * @return Trimmed text
  */
 public static String trimFront(String text, char character) {
   String normalizedText;
   int index;
   if (StringUtils.isNull(text)) {
     return text;
   }
   normalizedText = text.trim();
   index = 0;
   while (normalizedText.charAt(index) == character) {
     index++;
   }
   return normalizedText.substring(index).trim();
 }
 /**
  * Trim specified charcater from end of string
  * 
  * @param text
  *          Text
  * @param character
  *          Character to remove
  * @return Trimmed text
  */
 public static String trimEnd(String text, char character) {
   String normalizedText;
   int index;
   if (StringUtils.isNull(text)) {
     return text;
   }
   normalizedText = text.trim();
   index = normalizedText.length() - 1;
   while (normalizedText.charAt(index) == character) {
     if (--index < 0) {
       return "";
     }
   }
   return normalizedText.substring(0, index + 1).trim();
 }
 /**
  * Trim specified charcater from both ends of a String
  * 
  * @param text
  *          Text
  * @param character
  *          Character to remove
  * @return Trimmed text
  */
 public static String trimAll(String text, char character) {
   String normalizedText = trimFront(text, character);
   return trimEnd(normalizedText, character);
 }

}

 </source>
   
  
 
  

Trim specified charcater from front of string

   <source lang="java">
  

/**********************************************************************************

*
* Copyright (c) 2003, 2004 The Regents of the University of Michigan, Trustees of Indiana University,
*                  Board of Trustees of the Leland Stanford, Jr., University, and The MIT Corporation
*
* Licensed under the Educational Community License Version 1.0 (the "License");
* By obtaining, using and/or copying this Original Work, you agree that you have read,
* understand, and will comply with the terms and conditions of the Educational Community License.
* You may obtain a copy of the License at:
*
*      http://cvs.sakaiproject.org/licenses/license_1_0.html
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
* INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*
**********************************************************************************/

public class Utils {

 /**
  * Trim specified charcater from front of string
  * 
  * @param text
  *          Text
  * @param character
  *          Character to remove
  * @return Trimmed text
  */
 public static String trimFront(String text, char character) {
   String normalizedText;
   int index;
   if (StringUtils.isNull(text)) {
     return text;
   }
   normalizedText = text.trim();
   index = 0;
   while (normalizedText.charAt(index) == character) {
     index++;
   }
   return normalizedText.substring(index).trim();
 }
 /**
  * Trim specified charcater from end of string
  * 
  * @param text
  *          Text
  * @param character
  *          Character to remove
  * @return Trimmed text
  */
 public static String trimEnd(String text, char character) {
   String normalizedText;
   int index;
   if (StringUtils.isNull(text)) {
     return text;
   }
   normalizedText = text.trim();
   index = normalizedText.length() - 1;
   while (normalizedText.charAt(index) == character) {
     if (--index < 0) {
       return "";
     }
   }
   return normalizedText.substring(0, index + 1).trim();
 }
 /**
  * Trim specified charcater from both ends of a String
  * 
  * @param text
  *          Text
  * @param character
  *          Character to remove
  * @return Trimmed text
  */
 public static String trimAll(String text, char character) {
   String normalizedText = trimFront(text, character);
   return trimEnd(normalizedText, character);
 }

}

 </source>
   
  
 
  

Trim specified token from both sides of the string

   <source lang="java">
  

/**

* 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.
*/

public class Utils {

 public static String trim(String target, String token) {
   int tokenLength = token.length();
   int targetLength = target.length();
   if (target.startsWith(token)) {
     return trim(target.substring(tokenLength), token);
   }
   if (target.endsWith(token)) {
     return trim(target.substring(0, targetLength - tokenLength), token);
   }
   return target;
 }

}

 </source>
   
  
 
  

Trims several consecutive characters into one.

   <source lang="java">
  

/*

*  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. 
*  
*/

/**

* Various string manipulation methods that are more efficient then chaining
* string operations: all is done in the same buffer without creating a bunch of
* string objects.
* 
* @author 
*/

public class Main {

 /**
  * Trims several consecutive characters into one.
  * 
  * @param str
  *            the string to trim consecutive characters of
  * @param ch
  *            the character to trim down
  * @return the newly trimmed down string
  */
 public static final String trimConsecutiveToOne( String str, char ch )
 {
     if ( ( null == str ) || ( str.length() == 0 ) )
     {
         return "";
     }
     char[] buffer = str.toCharArray();
     char[] newbuf = new char[buffer.length];
     int pos = 0;
     boolean same = false;
     for ( int i = 0; i < buffer.length; i++ )
     {
         char car = buffer[i];
         if ( car == ch )
         {
             if ( same )
             {
                 continue;
             }
             else
             {
                 same = true;
                 newbuf[pos++] = car;
             }
         }
         else
         {
             same = false;
             newbuf[pos++] = car;
         }
     }
     return new String( newbuf, 0, pos );
 }

}

 </source>
   
  
 
  

Trims the quotes.

   <source lang="java">
  

/*******************************************************************************

* Copyright (c) 2004 Actuate Corporation.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
*  Actuate Corporation  - initial API and implementation
*******************************************************************************/

/**

* Collection of string utilities.
* 
*/

public class StringUtil {

 /**
  * Trims the quotes.

*

* For example, *

*
• ("a.b") => a.b *
• ("a.b) => "a.b *
• (a.b") => a.b" *

  * 
  * @param value
  *            the string may have quotes
  * @return the string without quotes
  */
 public static String trimQuotes( String value )
 {
   if ( value == null )
     return value;
   value = value.trim( );
   if ( value.startsWith( "\"" ) && value.endsWith( "\"" ) )
     return value.substring( 1, value.length( ) - 1 );
   
   return value;
 }

}

 </source>
   
  
 
  

Truncate a String to the given length with no warnings or error raised if it is bigger.

   <source lang="java">
   

/*

Derby - Class org.apache.derby.iapi.util.PropertyUtil
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.
*/

public class Main {

 /**
 Truncate a String to the given length with no warnings
 or error raised if it is bigger.
 @param  value String to be truncated
 @param  length  Maximum length of string
 @return Returns value if value is null or value.length() is less or equal to than length, otherwise a String representing
   value truncated to length.

• /

public static String truncate(String value, int length) {

 if (value != null && value.length() > length)
   value = value.substring(0, length);
 return value;

}

}

 </source>
   
  
 
  

Truncates large Strings showing a portion of the String"s head and tail with the center cut out and replaced with "...".

   <source lang="java">
  

/*

*  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. 
*  
*/

/**

* Various string manipulation methods that are more efficient then chaining
* string operations: all is done in the same buffer without creating a bunch of
* string objects.
* 
* @author 
*/

public class Main {

 /**
  * Truncates large Strings showing a portion of the String"s head and tail
  * with the center cut out and replaced with "...". Also displays the total
  * length of the truncated string so size of "..." can be interpreted.
  * Useful for large strings in UIs or hex dumps to log files.
  * 
  * @param str
  *            the string to truncate
  * @param head
  *            the amount of the head to display
  * @param tail
  *            the amount of the tail to display
  * @return the center truncated string
  */
 public static final String centerTrunc( String str, int head, int tail )
 {
     StringBuffer buf = null;
     // Return as-is if String is smaller than or equal to the head plus the
     // tail plus the number of characters added to the trunc representation
     // plus the number of digits in the string length.
     if ( str.length() <= ( head + tail + 7 + str.length() / 10 ) )
     {
         return str;
     }
     buf = new StringBuffer();
     buf.append( "[" ).append( str.length() ).append( "][" );
     buf.append( str.substring( 0, head ) ).append( "..." );
     buf.append( str.substring( str.length() - tail ) );
     buf.append( "]" );
     return buf.toString();
 }

}

 </source>
   
  
 
  

Truncate text on a whitespace boundary (near a specified length)

   <source lang="java">
  

/**********************************************************************************

*
* Copyright (c) 2003, 2004 The Regents of the University of Michigan, Trustees of Indiana University,
*                  Board of Trustees of the Leland Stanford, Jr., University, and The MIT Corporation
*
* Licensed under the Educational Community License Version 1.0 (the "License");
* By obtaining, using and/or copying this Original Work, you agree that you have read,
* understand, and will comply with the terms and conditions of the Educational Community License.
* You may obtain a copy of the License at:
*
*      http://cvs.sakaiproject.org/licenses/license_1_0.html
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
* INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*
**********************************************************************************/

public class Utils {

 private static final int MINIMUM_SUPPORTED_LENGTH = 4;
 
 /**
  * Truncate text on a whitespace boundary (near a specified length). The
  * length of the resultant string will be in the range:

  *    (requested-length * .25) ~ (requested-length * 1.5) 
  * 
  * @param text
  *          Text to truncate
  * @param length
  *          Target length
  * @return Truncated text
  */
 public static String truncateAtWhitespace(String text, int length) {
   int desired, lowerBound, upperBound;
   /*
    * Make sure we have a reasonable length to work with
    */
   if (length < MINIMUM_SUPPORTED_LENGTH) {
     throw new IllegalArgumentException("Requested length too short (must be "
         + MINIMUM_SUPPORTED_LENGTH + " or greated)");
   }
   /*
    * No need to truncate - the original string "fits"
    */
   if (text.length() <= length) {
     return text;
   }
   /*
    * Try to find whitespace befor the requested maximum
    */
   lowerBound = length / 4;
   upperBound = length + (length / 2);
   for (int i = length - 1; i > lowerBound; i--) {
     if (Character.isWhitespace(text.charAt(i))) {
       return text.substring(0, i);
     }
   }
   /*
    * No whitespace - look beyond the desired maximum
    */
   for (int i = (length); i < upperBound; i++) {
     if (Character.isWhitespace(text.charAt(i))) {
       return text.substring(0, i);
     }
   }
   /*
    * No whitespace, just truncate the text at the requested length
    */
   return text.substring(0, length);
 }

}

 </source>
   
  
 
  

Used to print out a string for error messages, chops is off at 60 chars for historical reasons.

   <source lang="java">
   

/*

Derby - Class org.apache.derby.iapi.util.PropertyUtil
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.
*/

public class Main {

 /**
  * Used to print out a string for error messages, 
  * chops is off at 60 chars for historical reasons.
  */
 public final static String formatForPrint(String input)
 {
   if (input.length() > 60)
   {
     StringBuffer tmp = new StringBuffer(input.substring(0, 60));
     tmp.append("&");
     input = tmp.toString();
   }
   return input;
 }

}

 </source>