|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.gjt.sp.jedit.MiscUtilities
Path name manipulation, string manipulation, and more.
The most frequently used members of this class are:
Some path name methods:
String comparison:
A compareStrings(String,String,boolean)
method that unlike
This class also defines several inner classes for use with the sorting features of the Java collections API:
For example, you might call:
Arrays.sort(myListOfStrings,
new MiscUtilities.StringICaseCompare());
Nested Class Summary | |
static interface |
MiscUtilities.Compare
An interface for comparing objects. |
static class |
MiscUtilities.MenuItemCompare
Compares menu item labels. |
static class |
MiscUtilities.StringCompare
Compares strings. |
static class |
MiscUtilities.StringICaseCompare
Compares strings ignoring case. |
Field Summary | |
static java.text.DecimalFormat |
KB_FORMAT
|
static java.text.DecimalFormat |
MB_FORMAT
|
static java.lang.String |
UTF_8_Y
This encoding is not supported by Java, yet it is useful. |
Method Summary | |
static java.lang.String |
buildToVersion(java.lang.String build)
Converts an internal version number (build) into a `human-readable' form. |
static java.lang.String |
canonPath(java.lang.String path)
Returns the canonical form of the specified path name. |
static java.lang.String |
charsToEntities(java.lang.String str)
Converts <, >, & in the string to their HTML entity equivalents. |
static java.lang.String |
charsToEscapes(java.lang.String str)
Escapes newlines, tabs, backslashes, and quotes in the specified string. |
static java.lang.String |
charsToEscapes(java.lang.String str,
java.lang.String toEscape)
Escapes the specified characters in the specified string. |
static java.lang.String |
classToFile(java.lang.String name)
Converts a class name to a file name. |
static int |
compareStrings(java.lang.String str1,
java.lang.String str2,
boolean ignoreCase)
Compares two strings. |
static int |
compareVersions(java.lang.String v1,
java.lang.String v2)
Deprecated. Call compareStrings() instead |
static java.lang.String |
concatPath(java.lang.String parent,
java.lang.String path)
Like constructPath(java.lang.String, java.lang.String) , except path will be
appended to parent even if it is absolute. |
static java.lang.String |
constructPath(java.lang.String parent,
java.lang.String path)
Constructs an absolute path name from a directory and another path name. |
static java.lang.String |
constructPath(java.lang.String parent,
java.lang.String path1,
java.lang.String path2)
Constructs an absolute path name from three path components. |
static java.lang.String |
createWhiteSpace(int len,
int tabSize)
Creates a string of white space with the specified length. |
static java.lang.String |
createWhiteSpace(int len,
int tabSize,
int start)
Creates a string of white space with the specified length. |
static java.lang.String |
escapesToChars(java.lang.String str)
Converts "\n" and "\t" escapes in the specified string to newlines and tabs. |
static java.lang.String |
fileToClass(java.lang.String name)
Converts a file name to a class name. |
static java.lang.String |
formatFileSize(long length)
Formats the given file size into a nice string (123 bytes, 10.6 KB, 1.2 MB). |
static java.lang.String[] |
getEncodings()
Returns a list of supported character encodings. |
static java.lang.String |
getFileExtension(java.lang.String name)
Returns the extension of the specified filename, or an empty string if there is none. |
static java.lang.String |
getFileName(java.lang.String path)
Returns the last component of the specified path. |
static java.lang.String |
getFileNameNoExtension(java.lang.String path)
Returns the last component of the specified path name without the trailing extension (if there is one). |
static java.lang.String |
getFileParent(java.lang.String path)
Deprecated. Call getParentOfPath() instead |
static java.lang.String |
getFileProtocol(java.lang.String url)
Deprecated. Call getProtocolOfURL() instead |
static int |
getLeadingWhiteSpace(java.lang.String str)
Returns the number of leading white space characters in the specified string. |
static int |
getLeadingWhiteSpaceWidth(java.lang.String str,
int tabSize)
Returns the width of the leading white space in the specified string. |
static java.lang.String |
getLongestPrefix(java.util.List str,
boolean ignoreCase)
Returns the longest common prefix in the given set of strings. |
static java.lang.String |
getLongestPrefix(java.lang.Object[] str,
boolean ignoreCase)
Returns the longest common prefix in the given set of strings. |
static java.lang.String |
getLongestPrefix(java.lang.String[] str,
boolean ignoreCase)
Returns the longest common prefix in the given set of strings. |
static int |
getOffsetOfVirtualColumn(javax.swing.text.Segment seg,
int tabSize,
int column,
int[] totalVirtualWidth)
Returns the array offset of a virtual column number (taking tabs into account) in the segment. |
static java.lang.String |
getParentOfPath(java.lang.String path)
Returns the parent of the specified path. |
static java.lang.String |
getProtocolOfURL(java.lang.String url)
Returns the protocol specified by a URL. |
static int |
getTrailingWhiteSpace(java.lang.String str)
Returns the number of trailing whitespace characters in the specified string. |
static int |
getVirtualWidth(javax.swing.text.Segment seg,
int tabSize)
Returns the virtual column number (taking tabs into account) of the specified offset in the segment. |
static java.lang.String |
globToRE(java.lang.String glob)
Converts a Unix-style glob to a regular expression. |
static boolean |
isAbsolutePath(java.lang.String path)
Returns if the specified path name is an absolute path or URL. |
static boolean |
isSupportedEncoding(java.lang.String encoding)
Returns if the given character encoding is supported. |
static boolean |
isToolsJarAvailable()
If on JDK 1.2 or higher, make sure that tools.jar is available. |
static boolean |
isURL(java.lang.String str)
Checks if the specified string is a URL. |
static boolean |
objectsEqual(java.lang.Object o1,
java.lang.Object o2)
Returns if two strings are equal. |
static int |
parsePermissions(java.lang.String s)
Parse a Unix-style permission string (rwxrwxrwx). |
static void |
quicksort(java.util.List list,
java.util.Comparator compare)
Sorts the specified list. |
static void |
quicksort(java.lang.Object[] obj,
java.util.Comparator compare)
Sorts the specified array. |
static void |
quicksort(java.lang.Object[] obj,
MiscUtilities.Compare compare)
Sorts the specified array. |
static void |
quicksort(java.util.Vector vector,
java.util.Comparator compare)
Sorts the specified vector. |
static void |
quicksort(java.util.Vector vector,
MiscUtilities.Compare compare)
Sorts the specified vector. |
static java.lang.String |
resolveSymlinks(java.lang.String path)
Resolves any symbolic links in the path name specified using File.getCanonicalPath() . |
static void |
saveBackup(java.io.File file,
int backups,
java.lang.String backupPrefix,
java.lang.String backupSuffix,
java.lang.String backupDirectory)
Saves a backup (optionally numbered) of a file. |
static void |
saveBackup(java.io.File file,
int backups,
java.lang.String backupPrefix,
java.lang.String backupSuffix,
java.lang.String backupDirectory,
int backupTimeDistance)
Saves a backup (optionally numbered) of a file. |
static boolean |
stringsEqual(java.lang.String s1,
java.lang.String s2)
Deprecated. Call objectsEqual() instead. |
static java.lang.String |
throwableToString(java.lang.Throwable t)
Returns a string containing the stack trace of the given throwable. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final java.lang.String UTF_8_Y
public static final java.text.DecimalFormat KB_FORMAT
public static final java.text.DecimalFormat MB_FORMAT
Method Detail |
public static java.lang.String canonPath(java.lang.String path)
~
. For local path names
only.
path
- The path namepublic static java.lang.String resolveSymlinks(java.lang.String path)
File.getCanonicalPath()
. For local path
names only.
public static boolean isAbsolutePath(java.lang.String path)
public static java.lang.String constructPath(java.lang.String parent, java.lang.String path)
parent
- The directorypath
- The path namepublic static java.lang.String constructPath(java.lang.String parent, java.lang.String path1, java.lang.String path2)
parent
- The parent directorypath1
- The first pathpath2
- The second pathpublic static java.lang.String concatPath(java.lang.String parent, java.lang.String path)
constructPath(java.lang.String, java.lang.String)
, except path
will be
appended to parent
even if it is absolute.
For local path names only..
path
- parent
- public static java.lang.String getFileExtension(java.lang.String name)
name
- The file name or pathpublic static java.lang.String getFileName(java.lang.String path)
path
- The path namepublic static java.lang.String getFileNameNoExtension(java.lang.String path)
path
- The path namepublic static java.lang.String getFileParent(java.lang.String path)
public static java.lang.String getParentOfPath(java.lang.String path)
path
- The path namepublic static java.lang.String getFileProtocol(java.lang.String url)
public static java.lang.String getProtocolOfURL(java.lang.String url)
url
- The URLpublic static boolean isURL(java.lang.String str)
str
- The string to check
public static void saveBackup(java.io.File file, int backups, java.lang.String backupPrefix, java.lang.String backupSuffix, java.lang.String backupDirectory)
file
- A local filebackups
- The number of backups. Must be >= 1. If > 1, backup
files will be numbered.backupPrefix
- The backup file name prefixbackupSuffix
- The backup file name suffixbackupDirectory
- The directory where to save backups; if null,
they will be saved in the same directory as the file itself.public static void saveBackup(java.io.File file, int backups, java.lang.String backupPrefix, java.lang.String backupSuffix, java.lang.String backupDirectory, int backupTimeDistance)
file
- A local filebackups
- The number of backups. Must be >= 1. If > 1, backup
files will be numbered.backupPrefix
- The backup file name prefixbackupSuffix
- The backup file name suffixbackupDirectory
- The directory where to save backups; if null,
they will be saved in the same directory as the file itself.backupTimeDistance
- The minimum time in minutes when a backup
version 1 shall be moved into version 2; if 0, backups are always
moved.public static java.lang.String fileToClass(java.lang.String name)
name
- The file namepublic static java.lang.String classToFile(java.lang.String name)
name
- The class namepublic static int getLeadingWhiteSpace(java.lang.String str)
str
- The stringpublic static int getTrailingWhiteSpace(java.lang.String str)
str
- The stringpublic static int getLeadingWhiteSpaceWidth(java.lang.String str, int tabSize)
str
- The stringtabSize
- The tab sizepublic static int getVirtualWidth(javax.swing.text.Segment seg, int tabSize)
seg
- The segmenttabSize
- The tab sizepublic static int getOffsetOfVirtualColumn(javax.swing.text.Segment seg, int tabSize, int column, int[] totalVirtualWidth)
seg
- The segmenttabSize
- The tab sizecolumn
- The virtual column numbertotalVirtualWidth
- If this array is non-null, the total
virtual width will be stored in its first location if this method
returns -1.
public static java.lang.String createWhiteSpace(int len, int tabSize)
To get a whitespace string tuned to the current buffer's settings, call this method as follows:
myWhitespace = MiscUtilities.createWhiteSpace(myLength, (buffer.getBooleanProperty("noTabs") ? 0 : buffer.getTabSize()));
len
- The lengthtabSize
- The tab size, or 0 if tabs are not to be usedpublic static java.lang.String createWhiteSpace(int len, int tabSize, int start)
To get a whitespace string tuned to the current buffer's settings, call this method as follows:
myWhitespace = MiscUtilities.createWhiteSpace(myLength, (buffer.getBooleanProperty("noTabs") ? 0 : buffer.getTabSize()));
len
- The lengthtabSize
- The tab size, or 0 if tabs are not to be usedstart
- The start offset, for tab alignmentpublic static java.lang.String globToRE(java.lang.String glob)
? becomes ., * becomes .*, {aa,bb} becomes (aa|bb).
glob
- The glob patternpublic static java.lang.String escapesToChars(java.lang.String str)
str
- The stringpublic static java.lang.String charsToEscapes(java.lang.String str)
str
- The stringpublic static java.lang.String charsToEscapes(java.lang.String str, java.lang.String toEscape)
str
- The stringtoEscape
- Any characters that require escapingpublic static int compareVersions(java.lang.String v1, java.lang.String v2)
compareStrings()
instead
public static int compareStrings(java.lang.String str1, java.lang.String str2, boolean ignoreCase)
Unlike
str1
- The first stringstr2
- The second stringignoreCase
- If true, case will be ignored
public static boolean stringsEqual(java.lang.String s1, java.lang.String s2)
objectsEqual()
instead.
public static boolean objectsEqual(java.lang.Object o1, java.lang.Object o2)
o1.equals(o2)
.
public static java.lang.String charsToEntities(java.lang.String str)
str
- The stringpublic static java.lang.String formatFileSize(long length)
length
- The sizepublic static java.lang.String getLongestPrefix(java.util.List str, boolean ignoreCase)
str
- The stringsignoreCase
- If true, case insensitivepublic static java.lang.String getLongestPrefix(java.lang.String[] str, boolean ignoreCase)
str
- The stringsignoreCase
- If true, case insensitivepublic static java.lang.String getLongestPrefix(java.lang.Object[] str, boolean ignoreCase)
str
- The strings (calls toString()
on each object)ignoreCase
- If true, case insensitivepublic static void quicksort(java.lang.Object[] obj, java.util.Comparator compare)
Arrays.sort()
.
obj
- The arraycompare
- Compares the objectspublic static void quicksort(java.util.Vector vector, java.util.Comparator compare)
vector
- The vectorcompare
- Compares the objectspublic static void quicksort(java.util.List list, java.util.Comparator compare)
list
- The listcompare
- Compares the objectspublic static void quicksort(java.lang.Object[] obj, MiscUtilities.Compare compare)
Arrays.sort()
.
obj
- The arraycompare
- Compares the objectspublic static void quicksort(java.util.Vector vector, MiscUtilities.Compare compare)
vector
- The vectorcompare
- Compares the objectspublic static java.lang.String buildToVersion(java.lang.String build)
build
- The buildpublic static boolean isToolsJarAvailable()
tools.jar is searched for in the following places:
On older JDK's this method does not perform any checks, and returns
true
(even though there is no tools.jar).
false
if and only if on JDK 1.2 and tools.jar
could not be found. In this case it prints some warnings on Log,
too, about the places where it was searched for.public static int parsePermissions(java.lang.String s)
s
- The string (must be 9 characters long).public static java.lang.String[] getEncodings()
public static boolean isSupportedEncoding(java.lang.String encoding)
public static java.lang.String throwableToString(java.lang.Throwable t)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |