org.apache.datasketches.ByteArrayUtil Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of datasketches-java Show documentation
Show all versions of datasketches-java Show documentation
Core sketch algorithms used alone and by other Java repositories in the DataSketches library.
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.datasketches;
/**
* Useful methods for byte arrays.
* @author Lee Rhodes
*/
public final class ByteArrayUtil {
/**
* Get a short from the given byte array starting at the given offset
* in little endian order.
* There is no bounds checking.
* @param array source byte array
* @param offset source offset
* @return the short
*/
public static short getShortLE(final byte[] array, final int offset) {
return (short) ((array[offset ] & 0XFF )
| ((array[offset + 1] & 0XFF) << 8));
}
/**
* Put the source short into the destination byte array starting at the given offset
* in little endian order.
* There is no bounds checking.
* @param array destination byte array
* @param offset destination offset
* @param value source short
*/
public static void putShortLE(final byte[] array, final int offset, final short value) {
array[offset ] = (byte) (value );
array[offset + 1] = (byte) (value >>> 8);
}
/**
* Get a short from the given byte array starting at the given offset
* in big endian order.
* There is no bounds checking.
* @param array source byte array
* @param offset source offset
* @return the short
*/
public static short getShortBE(final byte[] array, final int offset) {
return (short) ((array[offset + 1] & 0XFF )
| ((array[offset ] & 0XFF) << 8));
}
/**
* Put the source short into the destination byte array starting at the given offset
* in big endian order.
* There is no bounds checking.
* @param array destination byte array
* @param offset destination offset
* @param value source short
*/
public static void putShortBE(final byte[] array, final int offset, final short value) {
array[offset + 1] = (byte) (value );
array[offset ] = (byte) (value >>> 8);
}
/**
* Get a int from the given byte array starting at the given offset
* in little endian order.
* There is no bounds checking.
* @param array source byte array
* @param offset source offset
* @return the int
*/
public static int getIntLE(final byte[] array, final int offset) {
return ( array[offset ] & 0XFF )
| ((array[offset + 1] & 0XFF) << 8)
| ((array[offset + 2] & 0XFF) << 16)
| ((array[offset + 3] & 0XFF) << 24);
}
/**
* Put the source int into the destination byte array starting at the given offset
* in little endian order.
* There is no bounds checking.
* @param array destination byte array
* @param offset destination offset
* @param value source int
*/
public static void putIntLE(final byte[] array, final int offset, final int value) {
array[offset ] = (byte) (value );
array[offset + 1] = (byte) (value >>> 8);
array[offset + 2] = (byte) (value >>> 16);
array[offset + 3] = (byte) (value >>> 24);
}
/**
* Get a int from the given byte array starting at the given offset
* in big endian order.
* There is no bounds checking.
* @param array source byte array
* @param offset source offset
* @return the int
*/
public static int getIntBE(final byte[] array, final int offset) {
return ( array[offset + 3] & 0XFF )
| ((array[offset + 2] & 0XFF) << 8)
| ((array[offset + 1] & 0XFF) << 16)
| ((array[offset ] & 0XFF) << 24);
}
/**
* Put the source int into the destination byte array starting at the given offset
* in big endian order.
* There is no bounds checking.
* @param array destination byte array
* @param offset destination offset
* @param value source int
*/
public static void putIntBE(final byte[] array, final int offset, final int value) {
array[offset + 3] = (byte) (value );
array[offset + 2] = (byte) (value >>> 8);
array[offset + 1] = (byte) (value >>> 16);
array[offset ] = (byte) (value >>> 24);
}
/**
* Get a long from the given byte array starting at the given offset
* in little endian order.
* There is no bounds checking.
* @param array source byte array
* @param offset source offset
* @return the long
*/
public static long getLongLE(final byte[] array, final int offset) {
return ( array[offset ] & 0XFFL )
| ((array[offset + 1] & 0XFFL) << 8)
| ((array[offset + 2] & 0XFFL) << 16)
| ((array[offset + 3] & 0XFFL) << 24)
| ((array[offset + 4] & 0XFFL) << 32)
| ((array[offset + 5] & 0XFFL) << 40)
| ((array[offset + 6] & 0XFFL) << 48)
| ((array[offset + 7] & 0XFFL) << 56);
}
/**
* Put the source long into the destination byte array starting at the given offset
* in little endian order.
* There is no bounds checking.
* @param array destination byte array
* @param offset destination offset
* @param value source long
*/
public static void putLongLE(final byte[] array, final int offset, final long value) {
array[offset ] = (byte) (value );
array[offset + 1] = (byte) (value >>> 8);
array[offset + 2] = (byte) (value >>> 16);
array[offset + 3] = (byte) (value >>> 24);
array[offset + 4] = (byte) (value >>> 32);
array[offset + 5] = (byte) (value >>> 40);
array[offset + 6] = (byte) (value >>> 48);
array[offset + 7] = (byte) (value >>> 56);
}
/**
* Get a long from the source byte array starting at the given offset
* in big endian order.
* There is no bounds checking.
* @param array source byte array
* @param offset source starting point
* @return the long
*/
public static long getLongBE(final byte[] array, final int offset) {
return ( array[offset + 7] & 0XFFL )
| ((array[offset + 6] & 0XFFL) << 8)
| ((array[offset + 5] & 0XFFL) << 16)
| ((array[offset + 4] & 0XFFL) << 24)
| ((array[offset + 3] & 0XFFL) << 32)
| ((array[offset + 2] & 0XFFL) << 40)
| ((array[offset + 1] & 0XFFL) << 48)
| ((array[offset ] & 0XFFL) << 56);
}
/**
* Put the source long into the destination byte array starting at the given offset
* in big endian order.
* There is no bounds checking.
* @param array destination byte array
* @param offset destination starting point
* @param value source long
*/
public static void putLongBE(final byte[] array, final int offset, final long value) {
array[offset + 7] = (byte) (value );
array[offset + 6] = (byte) (value >>> 8);
array[offset + 5] = (byte) (value >>> 16);
array[offset + 4] = (byte) (value >>> 24);
array[offset + 3] = (byte) (value >>> 32);
array[offset + 2] = (byte) (value >>> 40);
array[offset + 1] = (byte) (value >>> 48);
array[offset ] = (byte) (value >>> 56);
}
/**
* Get a float from the given byte array starting at the given offset
* in little endian order.
* There is no bounds checking.
* @param array source byte array
* @param offset source offset
* @return the float
*/
public static float getFloatLE(final byte[] array, final int offset) {
return Float.intBitsToFloat(getIntLE(array, offset));
}
/**
* Put the source float into the destination byte array starting at the given offset
* in little endian order.
* There is no bounds checking.
* @param array destination byte array
* @param offset destination offset
* @param value source float
*/
public static void putFloatLE(final byte[] array, final int offset, final float value) {
putIntLE(array, offset, Float.floatToRawIntBits(value));
}
/**
* Get a float from the given byte array starting at the given offset
* in big endian order.
* There is no bounds checking.
* @param array source byte array
* @param offset source offset
* @return the float
*/
public static float getFloatBE(final byte[] array, final int offset) {
return Float.intBitsToFloat(getIntBE(array, offset));
}
/**
* Put the source float into the destination byte array starting at the given offset
* in big endian order.
* There is no bounds checking.
* @param array destination byte array
* @param offset destination offset
* @param value source float
*/
public static void putFloatBE(final byte[] array, final int offset, final float value) {
putIntBE(array, offset, Float.floatToRawIntBits(value));
}
/**
* Get a double from the given byte array starting at the given offset
* in little endian order.
* There is no bounds checking.
* @param array source byte array
* @param offset source offset
* @return the double
*/
public static double getDoubleLE(final byte[] array, final int offset) {
return Double.longBitsToDouble(getLongLE(array, offset));
}
/**
* Put the source double into the destination byte array starting at the given offset
* in little endian order.
* There is no bounds checking.
* @param array destination byte array
* @param offset destination offset
* @param value source double
*/
public static void putDoubleLE(final byte[] array, final int offset, final double value) {
putLongLE(array, offset, Double.doubleToRawLongBits(value));
}
/**
* Get a double from the given byte array starting at the given offset
* in big endian order.
* There is no bounds checking.
* @param array source byte array
* @param offset source offset
* @return the double
*/
public static double getDoubleBE(final byte[] array, final int offset) {
return Double.longBitsToDouble(getLongBE(array, offset));
}
/**
* Put the source double into the destination byte array starting at the given offset
* in big endian order.
* There is no bounds checking.
* @param array destination byte array
* @param offset destination offset
* @param value source double
*/
public static void putDoubleBE(final byte[] array, final int offset, final double value) {
putLongBE(array, offset, Double.doubleToRawLongBits(value));
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy