java.lang
Class StringIndexOutOfBoundsException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by java.lang.IndexOutOfBoundsException
                  extended by java.lang.StringIndexOutOfBoundsException

@TransactionType(value=NOT_SUPPORTED)
public class StringIndexOutOfBoundsException
extends IndexOutOfBoundsException

Thrown by the charAt method in class String and by other String methods to indicate that an index is either negative or greater than or equal to the size of the string.

Direct instances of this exception class are not bound to any context and can be passed between contexts without any restrictions. Objects created and returned by the methods of this class are owned by the caller. In particular, a call to the Throwable.getMessage() returns a String instance bound to the owner context of the caller.

See Runtime Environment Specification for the Java Card Platform, Connected Edition, chapter 7 for details regarding transfer of ownership.

Since:
JDK1.0, CLDC 1.0, Java Card 3.0
See Also:
String.charAt(int)

Constructor Summary
StringIndexOutOfBoundsException()
          Constructs a StringIndexOutOfBoundsException with no detail message.
StringIndexOutOfBoundsException(int index)
          Constructs a new StringIndexOutOfBoundsException class with an argument indicating the illegal index.
StringIndexOutOfBoundsException(String s)
          Constructs a StringIndexOutOfBoundsException with the specified detail message.
 
Method Summary
 
Methods inherited from class java.lang.Throwable
getMessage, printStackTrace, toString
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

StringIndexOutOfBoundsException

public StringIndexOutOfBoundsException()
Constructs a StringIndexOutOfBoundsException with no detail message.

Since:
JDK1.0.

StringIndexOutOfBoundsException

public StringIndexOutOfBoundsException(String s)
Constructs a StringIndexOutOfBoundsException with the specified detail message.

Parameters:
s - the detail message.

StringIndexOutOfBoundsException

public StringIndexOutOfBoundsException(int index)
Constructs a new StringIndexOutOfBoundsException class with an argument indicating the illegal index.

Parameters:
index - the illegal index.


Copyright (c) 2009 Sun Microsystems, Inc. All rights reserved.