InvalidPathException (Java SE 9 & JDK 9 ) (original) (raw)

• java.lang.Object

• • java.lang.Throwable
  • • java.lang.Exception
      • • java.lang.RuntimeException
          * * java.lang.IllegalArgumentException
          * * java.nio.file.InvalidPathException

• All Implemented Interfaces:
  [Serializable](../../../java/io/Serializable.html "interface in java.io")

public class InvalidPathException
extends IllegalArgumentException
Unchecked exception thrown when path string cannot be converted into aPath because the path string contains invalid characters, or the path string is invalid for other file system specific reasons.
Since:
1.7
See Also:
Serialized Form

• • Constructor Summary

  Constructors

  Constructor	Description
  InvalidPathException​(String input,String reason)	Constructs an instance from the given input string and reason.
  InvalidPathException​(String input,String reason, int index)	Constructs an instance from the given input string, reason, and error index.

  • Method Summary

  All Methods Instance Methods Concrete Methods

  Modifier and Type	Method	Description
  int	getIndex​()	Returns an index into the input string of the position at which the error occurred, or -1 if this position is not known.
  String	getInput​()	Returns the input string.
  String	getMessage​()	Returns a string describing the error.
  String	getReason​()	Returns a string explaining why the input string was rejected.

     * ### Methods inherited from class java.lang.[Object](../../../java/lang/Object.html "class in java.lang")  
     `[clone](../../../java/lang/Object.html#clone--), [equals](../../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../../java/lang/Object.html#finalize--), [getClass](../../../java/lang/Object.html#getClass--), [hashCode](../../../java/lang/Object.html#hashCode--), [notify](../../../java/lang/Object.html#notify--), [notifyAll](../../../java/lang/Object.html#notifyAll--), [wait](../../../java/lang/Object.html#wait--), [wait](../../../java/lang/Object.html#wait-long-), [wait](../../../java/lang/Object.html#wait-long-int-)`  
     * ### Methods inherited from class java.lang.[Throwable](../../../java/lang/Throwable.html "class in java.lang")  
     `[addSuppressed](../../../java/lang/Throwable.html#addSuppressed-java.lang.Throwable-), [fillInStackTrace](../../../java/lang/Throwable.html#fillInStackTrace--), [getCause](../../../java/lang/Throwable.html#getCause--), [getLocalizedMessage](../../../java/lang/Throwable.html#getLocalizedMessage--), [getStackTrace](../../../java/lang/Throwable.html#getStackTrace--), [getSuppressed](../../../java/lang/Throwable.html#getSuppressed--), [initCause](../../../java/lang/Throwable.html#initCause-java.lang.Throwable-), [printStackTrace](../../../java/lang/Throwable.html#printStackTrace--), [printStackTrace](../../../java/lang/Throwable.html#printStackTrace-java.io.PrintStream-), [printStackTrace](../../../java/lang/Throwable.html#printStackTrace-java.io.PrintWriter-), [setStackTrace](../../../java/lang/Throwable.html#setStackTrace-java.lang.StackTraceElement:A-), [toString](../../../java/lang/Throwable.html#toString--)`

• • Constructor Detail

     * #### InvalidPathException  
     public InvalidPathException​([String](../../../java/lang/String.html "class in java.lang") input,  
                                 [String](../../../java/lang/String.html "class in java.lang") reason,  
                                 int index)  
     Constructs an instance from the given input string, reason, and error index.  
     Parameters:  
     `input` \- the input string  
     `reason` \- a string explaining why the input was rejected  
     `index` \- the index at which the error occurred, or `-1` if the index is not known  
     Throws:  
     `[NullPointerException](../../../java/lang/NullPointerException.html "class in java.lang")` \- if either the input or reason strings are `null`  
     `[IllegalArgumentException](../../../java/lang/IllegalArgumentException.html "class in java.lang")` \- if the error index is less than `-1`  
     * #### InvalidPathException  
     public InvalidPathException​([String](../../../java/lang/String.html "class in java.lang") input,  
                                 [String](../../../java/lang/String.html "class in java.lang") reason)  
     Constructs an instance from the given input string and reason. The resulting object will have an error index of `-1`.  
     Parameters:  
     `input` \- the input string  
     `reason` \- a string explaining why the input was rejected  
     Throws:  
     `[NullPointerException](../../../java/lang/NullPointerException.html "class in java.lang")` \- if either the input or reason strings are `null`  

  • Method Detail

    * #### getInput  
    public [String](../../../java/lang/String.html "class in java.lang") getInput​()  
    Returns the input string.  
    Returns:  
    the input string  
    * #### getReason  
    public [String](../../../java/lang/String.html "class in java.lang") getReason​()  
    Returns a string explaining why the input string was rejected.  
    Returns:  
    the reason string  
    * #### getIndex  
    public int getIndex​()  
    Returns an index into the input string of the position at which the error occurred, or `-1` if this position is not known.  
    Returns:  
    the error index  
    * #### getMessage  
    public [String](../../../java/lang/String.html "class in java.lang") getMessage​()  
    Returns a string describing the error. The resulting string consists of the reason string followed by a colon character (`':'`), a space, and the input string. If the error index is defined then the string `" at index "` followed by the index, in decimal, is inserted after the reason string and before the colon character.  
    Overrides:  
    `[getMessage](../../../java/lang/Throwable.html#getMessage--)` in class `[Throwable](../../../java/lang/Throwable.html "class in java.lang")`  
    Returns:  
    a string describing the error

Report a bug or suggest an enhancement
For further API reference and developer documentation see the Java SE Documentation, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples.
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2017, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. Use is subject to license terms and the documentation redistribution policy.