Package org.gradle.api.file
Class RelativePath
- java.lang.Object
-
- org.gradle.api.file.RelativePath
-
- All Implemented Interfaces:
java.io.Serializable,java.lang.CharSequence,java.lang.Comparable<RelativePath>
public class RelativePath extends java.lang.Object implements java.io.Serializable, java.lang.Comparable<RelativePath>, java.lang.CharSequence
Represents a relative path from some base directory to a file. Used in file copying to represent both a source and target file path when copying files.
RelativePathinstances are immutable.- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static RelativePathEMPTY_ROOT
-
Constructor Summary
Constructors Constructor Description RelativePath(boolean endsWithFile, java.lang.String... segments)Creates aRelativePath.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description RelativePathappend(boolean endsWithFile, java.lang.String... segments)Appends the given names to the end of this path.RelativePathappend(RelativePath other)Appends the given path to the end of this path.charcharAt(int index)intcompareTo(RelativePath o)booleanequals(java.lang.Object o)java.io.FilegetFile(java.io.File baseDir)java.lang.StringgetLastName()RelativePathgetParent()Returns the parent of this path.java.lang.StringgetPathString()java.lang.String[]getSegments()inthashCode()booleanisFile()intlength()static RelativePathparse(boolean isFile, java.lang.String path)static RelativePathparse(boolean isFile, RelativePath parent, java.lang.String path)RelativePathplus(RelativePath other)Appends the given path to the end of this path.RelativePathprepend(java.lang.String... segments)Prepends the given names to the start of this path.RelativePathreplaceLastName(java.lang.String name)Returns a copy of this path, with the last name replaced with the given name.java.util.ListIterator<java.lang.String>segmentIterator()java.lang.CharSequencesubSequence(int start, int end)java.lang.StringtoString()
-
-
-
Field Detail
-
EMPTY_ROOT
public static final RelativePath EMPTY_ROOT
-
-
Method Detail
-
getSegments
public java.lang.String[] getSegments()
-
segmentIterator
public java.util.ListIterator<java.lang.String> segmentIterator()
-
isFile
public boolean isFile()
-
getPathString
public java.lang.String getPathString()
-
length
public int length()
- Specified by:
lengthin interfacejava.lang.CharSequence
-
charAt
public char charAt(int index)
- Specified by:
charAtin interfacejava.lang.CharSequence
-
subSequence
public java.lang.CharSequence subSequence(int start, int end)- Specified by:
subSequencein interfacejava.lang.CharSequence
-
getFile
public java.io.File getFile(java.io.File baseDir)
-
getLastName
public java.lang.String getLastName()
-
equals
public boolean equals(java.lang.Object o)
- Overrides:
equalsin classjava.lang.Object
-
hashCode
public int hashCode()
- Overrides:
hashCodein classjava.lang.Object
-
toString
public java.lang.String toString()
- Specified by:
toStringin interfacejava.lang.CharSequence- Overrides:
toStringin classjava.lang.Object
-
getParent
public RelativePath getParent()
Returns the parent of this path.- Returns:
- The parent of this path, or null if this is the root path.
-
parse
public static RelativePath parse(boolean isFile, java.lang.String path)
-
parse
public static RelativePath parse(boolean isFile, @Nullable RelativePath parent, java.lang.String path)
-
replaceLastName
public RelativePath replaceLastName(java.lang.String name)
Returns a copy of this path, with the last name replaced with the given name.
- Parameters:
name- The name.- Returns:
- The path.
-
append
public RelativePath append(RelativePath other)
Appends the given path to the end of this path.
- Parameters:
other- The path to append- Returns:
- The new path
-
plus
public RelativePath plus(RelativePath other)
Appends the given path to the end of this path.
- Parameters:
other- The path to append- Returns:
- The new path
-
append
public RelativePath append(boolean endsWithFile, java.lang.String... segments)
Appends the given names to the end of this path.- Parameters:
segments- The names to append.endsWithFile- when true, the new path refers to a file.- Returns:
- The new path.
-
prepend
public RelativePath prepend(java.lang.String... segments)
Prepends the given names to the start of this path.- Parameters:
segments- The names to prepend- Returns:
- The new path.
-
compareTo
public int compareTo(RelativePath o)
- Specified by:
compareToin interfacejava.lang.Comparable<RelativePath>
-
-