Gets the leftmost len characters of a String : String Strip « Data Type « Java






  1. Java
  2. Data Type
  3. String Strip

Gets the leftmost len characters of a String

       


/**
 * 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
 * <code>null</code> safe.</p>

 *
 * @see java.lang.String
 * @author <a href="http://jakarta.apache.org/turbine/">Apache Jakarta Turbine</a>
 * @author <a href="mailto:jon@latchkey.com">Jon S. Stevens</a>
 * @author Daniel L. Rall
 * @author <a href="mailto:gcoladonato@yahoo.com">Greg Coladonato</a>
 * @author <a href="mailto:ed@apache.org">Ed Korthof</a>
 * @author <a href="mailto:rand_mcneely@yahoo.com">Rand McNeely</a>
 * @author Stephen Colebourne
 * @author <a href="mailto:fredrik@westermarck.com">Fredrik Westermarck</a>
 * @author Holger Krauth
 * @author <a href="mailto:alex@purpletech.com">Alexander Day Chaffee</a>
 * @author <a href="mailto:hps@intermeta.de">Henning P. Schmiedehausen</a>
 * @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 {

  //-----------------------------------------------------------------------
  /**
   * <p>Gets the leftmost <code>len</code> characters of a String.</p>
   *
   * <p>If <code>len</code> characters are not available, or the
   * String is <code>null</code>, the String will be returned without
   * an exception. An exception is thrown if len is negative.</p>
   *
   * <pre>
   * StringUtils.left(null, *)    = null
   * StringUtils.left(*, -ve)     = ""
   * StringUtils.left("", *)      = ""
   * StringUtils.left("abc", 0)   = ""
   * StringUtils.left("abc", 2)   = "ab"
   * StringUtils.left("abc", 4)   = "abc"
   * </pre>
   *
   * @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, <code>null</code> 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);
  }

}








Related examples in the same category

1.Strips any of a set of characters from the end of a String.
2.Strips any of a set of characters from the start and end of a String allowing the characters to be stripped to be controlled.
3.Strips any of a set of characters from the start and end of every String in an array.
4.Strips any of a set of characters from the start of a String.
5.Strips whitespace from the start and end of a String returning an empty String if null input.
6.Strips whitespace from the start and end of a String returning null if the String is empty ("") after the strip.
7.Strips whitespace from the start and end of a String.
8.Strips whitespace from the start and end of every String in an array.
9.Remove/collapse multiple newline characters.
10.Removes a substring only if it is at the begining of a source string, otherwise returns the source string.
11.Removes a substring only if it is at the end of a source string, otherwise returns the source string.
12.Gets the rightmost len characters of a String.
13.Remove the leading and trailing quotes from str.
14.Remove the last character from a String.
15.Removes separator from the end of str if it's there, otherwise leave it alone.
16.Trim any of the characters
17.Strip Line Breaks
18.Removes newline, carriage return and tab characters from a string
19.Trim off trailing blanks but not leading blanks
20.Used to print out a string for error messages, chops is off at 60 chars for historical reasons.
21.Chop i characters off the end of a string.
22.Trim specified charcater from end and from of string
23.Trim specified charcater from end of string
24.Trim specified charcater from front of string
25.Trim specified token from both sides of the string
26.Trims several consecutive characters into one.
27.Trims the quotes.
28.Truncate text on a whitespace boundary (near a specified length)
29.Truncates large Strings showing a portion of the String's head and tail with the center cut out and replaced with '...'.
30.Truncate a String to the given length with no warnings or error raised if it is bigger.
31.Filters string
32.strip string