1 /* 2 * Licensed to the Apache Software Foundation (ASF) under one or more 3 * contributor license agreements. See the NOTICE file distributed with 4 * this work for additional information regarding copyright ownership. 5 * The ASF licenses this file to You under the Apache License, Version 2.0 6 * (the "License"); you may not use this file except in compliance with 7 * the License. You may obtain a copy of the License at 8 * 9 * http://www.apache.org/licenses/LICENSE-2.0 10 * 11 * Unless required by applicable law or agreed to in writing, software 12 * distributed under the License is distributed on an "AS IS" BASIS, 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 */ 17 18 package java.lang; 19 20 /** 21 * Thrown when the a string is indexed with a value less than zero, or greater 22 * than or equal to the size of the array. 23 */ 24 public class StringIndexOutOfBoundsException extends IndexOutOfBoundsException { 25 26 private static final long serialVersionUID = -6762910422159637258L; 27 28 /** 29 * Constructs a new {@code StringIndexOutOfBoundsException} that includes 30 * the current stack trace. 31 */ StringIndexOutOfBoundsException()32 public StringIndexOutOfBoundsException() { 33 } 34 35 /** 36 * Constructs a new {@code StringIndexOutOfBoundsException} with the current 37 * stack trace and a detail message that is based on the specified invalid 38 * {@code index}. 39 * 40 * @param index 41 * the index which is out of bounds. 42 */ StringIndexOutOfBoundsException(int index)43 public StringIndexOutOfBoundsException(int index) { 44 super("String index out of range: " + index); 45 } 46 47 /** 48 * Constructs a new {@code StringIndexOutOfBoundsException} with the current 49 * stack trace and the specified detail message. 50 * 51 * @param detailMessage 52 * the detail message for this exception. 53 */ StringIndexOutOfBoundsException(String detailMessage)54 public StringIndexOutOfBoundsException(String detailMessage) { 55 super(detailMessage); 56 } 57 58 /** 59 * Used internally for consistent high-quality error reporting. 60 * @hide 61 */ StringIndexOutOfBoundsException(String s, int index)62 public StringIndexOutOfBoundsException(String s, int index) { 63 this(s.length(), index); 64 } 65 66 /** 67 * Used internally for consistent high-quality error reporting. 68 * @hide 69 */ StringIndexOutOfBoundsException(int sourceLength, int index)70 public StringIndexOutOfBoundsException(int sourceLength, int index) { 71 super("length=" + sourceLength + "; index=" + index); 72 } 73 74 /** 75 * Used internally for consistent high-quality error reporting. 76 * @hide 77 */ StringIndexOutOfBoundsException(String s, int offset, int count)78 public StringIndexOutOfBoundsException(String s, int offset, int count) { 79 this(s.length(), offset, count); 80 } 81 82 /** 83 * Used internally for consistent high-quality error reporting. 84 * @hide 85 */ StringIndexOutOfBoundsException(int sourceLength, int offset, int count)86 public StringIndexOutOfBoundsException(int sourceLength, int offset, 87 int count) { 88 super("length=" + sourceLength + "; regionStart=" + offset 89 + "; regionLength=" + count); 90 } 91 } 92