|Modifier and Type||Method and Description|
Converts a path string, or a sequence of strings that when joined form a path string, to a
moredoes not specify any elements then the value of the
firstparameter is the path string to convert. If
morespecifies one or more elements then each non-empty string, including
first, is considered to be a sequence of name elements (see
Path) and is joined to form a path string. The details as to how the Strings are joined is provider specific but typically they will be joined using the
name-separatoras the separator. For example, if the name separator is "
getPath("/foo","bar","gus")is invoked, then the path string
"/foo/bar/gus"is converted to a
Pathrepresenting an empty path is returned if
firstis the empty string and
moredoes not contain any non-empty strings.
Note that while this method is very convenient, using it will imply
an assumed reference to the default
FileSystem and limit the
utility of the calling code. Hence it should not be used in library code
intended for flexible reuse. A more flexible alternative is to use an
Path instance as an anchor, such as:
Path dir = ... Path path = dir.resolve("file");
first- the path string or initial part of the path string
more- additional strings to be joined to form the path string
InvalidPathException- if the path string cannot be converted to a
Copyright (c) 2014, Oracle and/or its affiliates. All Rights Reserved. Use of this specification is subject to license terms.