oshi.util

Class ParseUtil

java.lang.Object

oshi.util.ParseUtil

public abstract class ParseUtil
extends Object

String parsing utility.

Author:

alessio.fachechi[at]gmail[dot]com

Constructor Summary

Constructors

Constructor and Description
ParseUtil()

Method Summary

Modifier and Type	Method and Description
static float	byteArrayToFloat(byte[] bytes, int size, int fpBits) Convert a byte array to its floating point representation.
static long	byteArrayToLong(byte[] bytes, int size) Convert a byte array to its integer representation.
static long	cimDateTimeToMillis(String cimDate) Parses a CIM_DateTime format (from WMI) to milliseconds since the epoch.
static byte[]	hexStringToByteArray(String digits) Parse a string of hexadecimal digits into a byte array
static String	hexStringToString(String hexString) Parses a string of hex digits to a string
static String	jsonPrettyPrint(javax.json.JsonObject json) Pretty print a JSON string.
static byte[]	longToByteArray(long value, int valueSize, int length) Convert a long value to a byte array using Big Endian, truncating or padding with zeros (if necessary) so the array has the specified length.
static long	parseHertz(String hertz) Parse hertz from a string, eg.
static int	parseLastInt(String s, int i) Parse the last element of a string to a value
static byte[]	stringToByteArray(String text, int length) Parse a human readable string into a byte array, truncating or padding with zeros (if necessary) so the array has the specified length.
static long	strToLong(String str, int size) Convert a string to an integer representation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ParseUtil

public ParseUtil()

Method Detail

parseHertz

public static long parseHertz(String hertz)

Parse hertz from a string, eg. "2.00MHz" in 2000000L.

Parameters:

hertz - Hertz size.

Returns:

Long Hertz value or -1 if not parsable.

parseLastInt

public static int parseLastInt(String s,
                               int i)

Parse the last element of a string to a value

Parameters:

s - The string to parse

i - Default integer if not parsable

Returns:

Integer value or the given default if not parsable

hexStringToByteArray

public static byte[] hexStringToByteArray(String digits)

Parse a string of hexadecimal digits into a byte array

Parameters:

digits - The string to be parsed

Returns:

a byte array with each pair of characters converted to a byte

stringToByteArray

public static byte[] stringToByteArray(String text,
                                       int length)

Parse a human readable string into a byte array, truncating or padding with zeros (if necessary) so the array has the specified length.

Parameters:

text - The string to be parsed

length - Length of the returned array.

Returns:

A byte array of specified length, with each of the first length characters converted to a byte. If length is longer than the provided string length, will be filled with zeroes.

longToByteArray

public static byte[] longToByteArray(long value,
                                     int valueSize,
                                     int length)

Convert a long value to a byte array using Big Endian, truncating or padding with zeros (if necessary) so the array has the specified length.

Parameters:

value - The value to be converted

valueSize - Number of bytes representing the value

length - Number of bytes to return

Returns:

A byte array of specified length representing the long in the first valueSize bytes

strToLong

public static long strToLong(String str,
                             int size)

Convert a string to an integer representation.

Parameters:

str - A human readable string

size - Number of characters to convert to the long. May not exceed 8.

Returns:

An integer representing the string where each character is treated as a byte

byteArrayToLong

public static long byteArrayToLong(byte[] bytes,
                                   int size)

Convert a byte array to its integer representation.

Parameters:

bytes - An array of bytes no smaller than the size to be converted

size - Number of bytes to convert to the long. May not exceed 8.

Returns:

An integer representing the byte array as a 64-bit number

byteArrayToFloat

public static float byteArrayToFloat(byte[] bytes,
                                     int size,
                                     int fpBits)

Convert a byte array to its floating point representation.

Parameters:

bytes - An array of bytes no smaller than the size to be converted

size - Number of bytes to convert to the float. May not exceed 8.

fpBits - Number of bits representing the decimal

Returns:

A float; the integer portion representing the byte array as an integer shifted by the bits specified in fpBits; with the remaining bits used as a decimal

jsonPrettyPrint

public static String jsonPrettyPrint(javax.json.JsonObject json)

Pretty print a JSON string.

Parameters:

json - A JSON object

Returns:

String representing the object with added whitespace, new lines, indentation

cimDateTimeToMillis

public static long cimDateTimeToMillis(String cimDate)

Parses a CIM_DateTime format (from WMI) to milliseconds since the epoch. See https://msdn.microsoft.com/en-us/library/aa387237(v=vs.85).aspx

Parameters:

cimDate - A string containing the CIM_DateTime

Returns:

The corresponding DateTime as a number of milliseconds since the epoch

hexStringToString

public static String hexStringToString(String hexString)

Parses a string of hex digits to a string

Parameters:

hexString - A sequence of hex digits

Returns:

The corresponding string if valid hex; otherwise the original hexString