0.9.0 - Remove unused WriteToFile. Update Bytes documentation. Renamed FileFilterUtil standardizePathName() -> standardSeparator() and added overload.

Author: TeamworkGuy2

CHANGELOG.md

@@ -4,7 +4,20 @@ This project does its best to adhere to [Semantic Versioning](http://semver.org/
 
 
 --------
-### [0.8.3](N/A) - 2019-04-01
+### [0.9.0](N/A) - 2019-11-02
+#### Added
+* `FileFilterUtil.standardSeparator(String, char)` overload
+
+#### Changed
+* `FileFilterUtil.standardizePathName()` -> `FileFilterUtil.standardSeparator()`
+* Clarified `Bytes` documentation
+
+#### Removed
+* Unused `WriteToFile` class
+
+
+--------
+### [0.8.3](https://github.com/TeamworkGuy2/JFileIo/commit/bba7aeae82a99f895f9deacc5f1befaac0352b85) - 2019-04-01
 #### Fixed
 * Fix `FileReadUtil.decode()`, `readText()`, `readChars()`, and `readString()` overrides failing for empty streams/files
 

bin/jfile_io-with-tests.jar

@@ -1,5 +1,5 @@
 {
-	"version" : "0.8.3",
+	"version" : "0.9.0",
 	"name" : "jfile-io",
 	"description" : "Java Helpers for File I/O: filtered FileVisitor builders, rolling file renamer, cached buffer file reader, and other File/Path helpers to make Java I/O easier",
 	"homepage" : "https://github.com/TeamworkGuy2/JFileIo",

bin/jfile_io.jar

@@ -1,6 +1,6 @@
 package twg2.io.files;
 
-/** A utility class for converting primitive types to bytes.
+/** A utility class for converting primitive types to/from bytes in big-endian order.
  * For example converting an integer to 4 bytes and storing those 4 bytes
  * at a specific location in a byte array.
  * @author TeamworkGuy2
@@ -10,32 +10,33 @@ public final class Bytes {
 
 	private Bytes() { throw new AssertionError("cannot instantiate Bytes"); }
 
-	/** Write a double to the specified byte array as 8 bytes
+
+	/** Write a double to the specified byte array as 8 bytes (big-endian order)
 	 * @param value the double to write
-	 * @param b the byte array to write the long to
+	 * @param b the byte array to write the 'value' to
 	 * @param offset the offset into the array at which to write the 8 bytes
 	 */
-	public static final void writeDouble(double value, byte[] b, int offset) {
+	public static void writeDouble(double value, byte[] b, int offset) {
 		writeLong(Double.doubleToRawLongBits(value), b, offset);
 	}
 
 
-	/** Write a float to the specified byte array as 4 bytes
+	/** Write a float to the specified byte array as 4 bytes (big-endian order)
 	 * @param value the float to write
-	 * @param b the byte array to write the float to
+	 * @param b the byte array to write the 'value' to
 	 * @param offset the offset into the array at which to write the 4 bytes
 	 */
-	public static final void writeFloat(float value, byte[] b, int offset) {
+	public static void writeFloat(float value, byte[] b, int offset) {
 		writeInt(Float.floatToRawIntBits(value), b, offset);
 	}
 
 
-	/** Write a long to the specified byte array as 8 bytes
+	/** Write a long to the specified byte array as 8 bytes (big-endian order)
 	 * @param value the long to write
-	 * @param b the byte array to write the long to
+	 * @param b the byte array to write the 'value' to
 	 * @param offset the offset into the array at which to write the 8 bytes
 	 */
-	public static final void writeLong(long value, byte[] b, int offset) {
+	public static void writeLong(long value, byte[] b, int offset) {
 		b[offset] = (byte)(value >>> 56);
 		b[offset+1] = (byte)(value >>> 48);
 		b[offset+2] = (byte)(value >>> 40);
@@ -47,52 +48,52 @@ public static final void writeLong(long value, byte[] b, int offset) {
 	}
 
 
-	/** Write an int to the specified byte array as 4 bytes
+	/** Write an int to the specified byte array as 4 bytes (big-endian order)
 	 * @param value the integer to write
-	 * @param b the byte array to write the integer to
+	 * @param b the byte array to write the 'value' to
 	 * @param offset the offset into the array at which to write the 4 bytes
 	 */
-	public static final void writeInt(int value, byte[] b, int offset) {
+	public static void writeInt(int value, byte[] b, int offset) {
 		b[offset] = (byte)(value >>> 24);
 		b[offset+1] = (byte)(value >>> 16);
 		b[offset+2] = (byte)(value >>> 8);
 		b[offset+3] = (byte)(value );
 	}
 
 
-	/** Write a short to the specified byte array as 2 bytes
+	/** Write a short to the specified byte array as 2 bytes (big-endian order)
 	 * @param value the short to write
-	 * @param b the byte array to write the short to
+	 * @param b the byte array to write the 'value' to
 	 * @param offset the offset into the array at which to write the 2 bytes
 	 */
-	public static final void writeShort(short value, byte[] b, int offset) {
+	public static void writeShort(short value, byte[] b, int offset) {
 		b[offset] = (byte)(value >>> 8);
 		b[offset+1] = (byte)(value );
 	}
 
 
-	/** Write a boolean to the specified byte array as 1 byte (1=true, 0=false)
+	/** Write a boolean to the specified byte array as 1 byte (1=true, 0=false) (big-endian order)
 	 * @param value the boolean to write
-	 * @param b the byte array to write the short to
+	 * @param b the byte array to write the 'value' to
 	 * @param offset the offset into the array at which to write the byte
 	 */
-	public static final void writeBoolean(boolean value, byte[] b, int offset) {
+	public static void writeBoolean(boolean value, byte[] b, int offset) {
 		b[offset] = (byte)(value ? 1 : 0);
 	}
 
 
-	/** Read a double value from the specified location in the specified array
+	/** Read a double value from the specified location in the specified array (assumes big-endian order)
 	 * @param b the array to read the double from
 	 * @param offset the offset into the array at which to read the 8 bytes
 	 * @return eight bytes read from the indices {@code [offset, offset+3]} and
 	 * converted to a double
 	 */
-	public static final double readDouble(byte[] b, int offset) {
+	public static double readDouble(byte[] b, int offset) {
 		return Double.longBitsToDouble(readLong(b, offset));
 	}
 
 
-	/** Read a float value from the specified location in the specified array
+	/** Read a float value from the specified location in the specified array (assumes big-endian order)
 	 * @param b the array to read the float from
 	 * @param offset the offset into the array at which to read the 4 bytes
 	 * @return four bytes read from the indices {@code [offset, offset+3]} and
@@ -103,7 +104,7 @@ public static final float readFloat(byte[] b, int offset) {
 	}
 
 
-	/** Read a long value from the specified location in the specified array
+	/** Read a long value from the specified location in the specified array (assumes big-endian order)
 	 * @param b the array to read the long from
 	 * @param offset the offset into the array at which to read the 8 bytes
 	 * @return eight bytes read from the indices {@code [offset, offset+3]} and converted to
@@ -124,7 +125,7 @@ public static final long readLong(byte[] b, int offset) {
 	}
 
 
-	/** Read an integer value from the specified location in the specified array
+	/** Read an integer value from the specified location in the specified array (assumes big-endian order)
 	 * @param b the array to read the integer from
 	 * @param offset the offset into the array at which to read the 4 bytes
 	 * @return four bytes read from the indices {@code [offset, offset+3]} and converted to
@@ -135,7 +136,7 @@ public static final int readInt(byte[] b, int offset) {
 	}
 
 
-	/** Read a short value from the specified location in the specified array
+	/** Read a short value from the specified location in the specified array (assumes big-endian order)
 	 * @param b the array to read the short from
 	 * @param offset the offset into the array at which to read the 2 bytes
 	 * @return two bytes read from indices {@code offset} and {@code offset+1} and converted to
@@ -146,7 +147,7 @@ public static final short readShort(byte[] b, int offset) {
 	}
 
 
-	/** Read a boolean value from the specified location in the specified byte array (1=true, 0=false)
+	/** Read a boolean value from the specified location in the specified byte array (1=true, 0=false) (assumes big-endian order)
 	 * @param b the array to read the boolean from
 	 * @param offset the offset into the array at which to read the byte
 	 * @return two bytes read from indices {@code offset} and {@code offset+1} and converted to

package-lib.json

@@ -37,7 +37,7 @@ public static void printCharsets() {
 	 * @param strs
 	 * @return true if the {@code strs} contained non-ASCII characters, false if all characters were ASCII
 	 */
-	public static final boolean checkForNonAsciiChars(String resourceName, List<String> strs) {
+	public static boolean checkForNonAsciiChars(String resourceName, List<String> strs) {
 		boolean res = false;
 		for(String str : strs) {
 			for(int i = 0, size = str.length(); i < size; i ++) {

src/twg2/io/files/Bytes.java

@@ -14,16 +14,25 @@
  * @author TeamworkGuy2
  * @since 2015-9-19
  */
-public class FileFilterUtil {
+public final class FileFilterUtil {
+
+	private FileFilterUtil() { throw new AssertionError("cannot instantiate static class FileFilterUtil"); }
 
 
 	/** Replace filesystem specific separators in a string with the current {@link File#separatorChar}
 	 */
-	public static String standardizePathName(String path) {
+	public static String standardSeparator(String path) {
 		return path.replace('\\', File.separatorChar).replace('/', File.separatorChar);
 	}
 
 
+	/** Replace filesystem specific separators in a string with the 'separator'
+	 */
+	public static String standardSeparator(String path, char separator) {
+		return path.replace('\\', separator).replace('/', separator);
+	}
+
+
 
 
 	/** A compound {@link FileFilter} that also supports tracking matches and failed matches from

src/twg2/io/files/CharsetUtil.java

@@ -35,7 +35,7 @@ public final class FileUtil {
 	private static final long MAX_FILE_SIZE = 1073741824;
 
 
-	private FileUtil() { throw new AssertionError("cannot instantiate static class FileUtility"); }
+	private FileUtil() { throw new AssertionError("cannot instantiate static class FileUtil"); }
 
 
 	/** Overwrite the destination file with the source file