Paths (TrueZIP Kernel 7.1.3 API)

java.lang.Object
- de.schlichtherle.truezip.io.Paths

@DefaultAnnotation(value=edu.umd.cs.findbugs.annotations.NonNull.class)
@ThreadSafe
public final class Paths
extends Object

Provides static utility methods for path names.

Author:: Christian Schlichtherle

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Paths.Normalizer` A normalizer for path names.
`static class`	`Paths.Splitter` Splits a given path name into its parent path name and member name.

Constructor Summary

Constructors
Modifier Constructor and Description

private Paths()
You cannot instantiate this class.

Constructors
Modifier	Constructor and Description
`private`	`Paths()` You cannot instantiate this class.

Method Summary

Methods
Modifier and Type	Method and Description
`static boolean`	`contains(String a, String b, char separatorChar)` Returns true if and only if the path name represented by `a` contains the path name represented by `b`.
`static String`	`cutTrailingSeparators(String path, char separatorChar)` Cuts off any separator characters at the end of the given path name, unless the path name contains of only separator characters, in which case a single separator character is retained to denote the root directory.
`static boolean`	`isAbsolute(String path, char separatorChar)` Returns `true` iff the given path name is absolute.
`static boolean`	`isRoot(String path)` Returns `true` iff the given path name refers to the root directory, i.e. if it's empty.
`static String`	`normalize(String path, char separatorChar)` Equivalent to `new Normalizer(separatorChar).`
`private static int`	`prefixLength(String path, char separatorChar)` Returns the length of the file system prefix in `path`.
`static Paths.Splitter`	`split(String path, char separatorChar, boolean keepTrailingSeparator)` Equivalent to `return new Splitter(separatorChar, keepTrailingSeparator).`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Paths
```
private Paths()
```
    You cannot instantiate this class.
- Method Detail
  - normalize
```
public static String normalize(String path,
               char separatorChar)
```
    Equivalent to new Normalizer(separatorChar).normalize(path).
  - cutTrailingSeparators
```
public static String cutTrailingSeparators(String path,
                           char separatorChar)
```
    Cuts off any separator characters at the end of the given path name, unless the path name contains of only separator characters, in which case a single separator character is retained to denote the root directory.
    
    Parameters:
    path - The path name to chop.
    separatorChar - The file name separator character.
    
    Returns:
    path if it's a path name without trailing separators or contains the separator character only. Otherwise, the substring until the first of at least one separating characters is returned.
  - split
```
public static Paths.Splitter split(String path,
                   char separatorChar,
                   boolean keepTrailingSeparator)
```
    Equivalent to return new Splitter(separatorChar, keepTrailingSeparator).split(path);.
  - isRoot
```
public static boolean isRoot(String path)
```
    Returns true iff the given path name refers to the root directory, i.e. if it's empty.
  - isAbsolute
```
public static boolean isAbsolute(String path,
                 char separatorChar)
```
    Returns true iff the given path name is absolute. Windows drives and UNC's are always recognized by this method, even on non-Windows platforms in order to ease interoperability.
    
    Parameters:
    path - the path name to test.
    separatorChar - the file name separator character.
    
    Returns:
    Whether or not path is prefixed and the prefix ends with a separator character.
  - prefixLength
```
private static int prefixLength(String path,
               char separatorChar)
```
    Returns the length of the file system prefix in path. File system prefixes are:
    1. A letter followed by a colon and an optional separator. On Windows, this is the notation for a drive.
    2. Two leading separators. On Windows, this is the notation for a UNC.
    3. A single leading separator. On Windows and POSIX, this is the notation for an absolute path.
    This method works identical on all platforms, so even if the separator is '/', two leading separators would be considered to be a UNC and hence the return value would be 2.
    Parameters:
    path - The file system path.
    separatorChar - The file name separator character.
    
    Returns:
    The number of characters in the prefix.
  - contains
```
public static boolean contains(String a,
               String b,
               char separatorChar)
```
    Returns true if and only if the path name represented by a contains the path name represented by b.
    
    Parameters:
    a - A non-null String reference.
    b - A non-null String reference.
    separatorChar - The file name separator character.

Class Paths

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Paths

Method Detail

normalize

cutTrailingSeparators

split

isRoot

isAbsolute

prefixLength

contains