All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.orangesignal.jlha.LittleEndian Maven / Gradle / Ivy

Go to download

OrangeSignal CSV is a very flexible csv (comma-separated values) read and write library for Java.

The newest version!
/**
 * Copyright (C) 2001-2002  Michel Ishizuka  All rights reserved.
 * 
 * 以下の条件に同意するならばソースとバイナリ形式の再配布と使用を
 * 変更の有無にかかわらず許可する。
 * 
 * 1.ソースコードの再配布において著作権表示と この条件のリスト
 *     および下記の声明文を保持しなくてはならない。
 * 
 * 2.バイナリ形式の再配布において著作権表示と この条件のリスト
 *     および下記の声明文を使用説明書もしくは その他の配布物内に
 *     含む資料に記述しなければならない。
 * 
 * このソフトウェアは石塚美珠瑠によって無保証で提供され、特定の目
 * 的を達成できるという保証、商品価値が有るという保証にとどまらず、
 * いかなる明示的および暗示的な保証もしない。
 * 石塚美珠瑠は このソフトウェアの使用による直接的、間接的、偶発
 * 的、特殊な、典型的な、あるいは必然的な損害(使用によるデータの
 * 損失、業務の中断や見込まれていた利益の遺失、代替製品もしくは
 * サービスの導入費等が考えられるが、決してそれだけに限定されない
 * 損害)に対して、いかなる事態の原因となったとしても、契約上の責
 * 任や無過失責任を含む いかなる責任があろうとも、たとえそれが不
 * 正行為のためであったとしても、またはそのような損害の可能性が報
 * 告されていたとしても一切の責任を負わないものとする。
 */

package com.orangesignal.jlha;

import java.io.EOFException;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;

/**
 * リトルエンディアンで バイト配列や InputStream, OutputStream にアクセスするメソッドを提供するユーティリティクラス。
 * 
 * @author $Author: dangan $
 * @version $Revision: 1.0 $
 */
public final class LittleEndian {

	// ------------------------------------------------------------------
	// Constructor

	/**
	 * デフォルトコンストラクタ。使用不可。
	 */
	private LittleEndian() {}

	// ------------------------------------------------------------------
	// shared method
	// ------------------------------------------------------------------
	// read from byte array

	/**
	 * ByteArray の index の位置から リトルエンディアンで 2バイト値を読み出す。読み出された 2バイト値は 0x0000~0xFFFFにマップされる。
	 * 
	 * @param ByteArray バイト配列
	 * @param index ByteArray内のデータの開始位置
	 * @return 読み出された2バイト値
	 * @exception ArrayIndexOutOfBoundsException indexから始まるデータが ByteArrayの範囲内に無い場合。
	 */
	public static final int readShort(final byte[] ByteArray, final int index) {
		return ByteArray[index] & 0xFF | (ByteArray[index + 1] & 0xFF) << 8;
	}

	/**
	 * ByteArray の index の位置からリトルエンディアンで 4バイト値を読み出す。
	 * 
	 * @param ByteArray バイト配列
	 * @param index ByteArray内のデータの開始位置
	 * @return 読み出された4バイト値
	 * @exception ArrayIndexOutOfBoundsException indexから始まるデータが ByteArrayの範囲内に無い場合。
	 */
	public static final int readInt(final byte[] ByteArray, final int index) {
		return ByteArray[index] & 0xFF | (ByteArray[index + 1] & 0xFF) << 8 | (ByteArray[index + 2] & 0xFF) << 16 | ByteArray[index + 3] << 24;
	}

	/**
	 * ByteArray の index の位置からリトルエンディアンで 8バイト値を読み出す。
	 * 
	 * @param ByteArray バイト配列
	 * @param index ByteArray内のデータの開始位置
	 * 
	 * @return 読み出された8バイト値
	 * 
	 * @exception ArrayIndexOutOfBoundsException indexから始まるデータが ByteArrayの範囲内に無い場合。
	 */
	public static final long readLong(final byte[] ByteArray, final int index) {
		return readInt(ByteArray, index) & 0xFFFFFFFFL | (long) readInt(ByteArray, index + 4) << 32L;
	}

	// ------------------------------------------------------------------
	// shared method
	// ------------------------------------------------------------------
	// read from InputStream

	/**
	 * 入力ストリーム in から リトルエンディアンで 2byte値を読み出す。
	 * 
	 * @param in 入力ストリーム
	 * @return 読み出された2byte値
	 * @exception EOFException 既に End Of Streamに達していたか、 読み込みの途中で End Of Streamに達した。 読み込み途中のデータは消失する。
	 * @exception IOException 入出力エラーが発生した場合
	 */
	public static final int readShort(final InputStream in) throws IOException {
		final int byte1 = in.read();
		final int byte2 = in.read();

		if (0 <= byte1 && 0 <= byte2) {
			return byte1 & 0xFF | (byte2 & 0xFF) << 8;
		}
		throw new EOFException();
	}

	/**
	 * 入力ストリーム in から リトルエンディアンで 4byte値を読み出す。
	 * 
	 * @param in 入力ストリーム
	 * @return 読み出された4byte値
	 * @exception EOFException 既に End Of Streamに達していたか、 読み込みの途中で End Of Streamに達した。 読み込み途中のデータは消失する。
	 * @exception IOException 入出力エラーが発生した場合
	 */
	public static final int readInt(final InputStream in) throws IOException {
		final int byte1 = in.read();
		final int byte2 = in.read();
		final int byte3 = in.read();
		final int byte4 = in.read();

		if (0 <= byte1 && 0 <= byte2 && 0 <= byte3 && 0 <= byte4) {
			return byte1 & 0xFF | (byte2 & 0xFF) << 8 | (byte3 & 0xFF) << 16 | byte4 << 24;
		}
		throw new EOFException();
	}

	/**
	 * 入力ストリーム in から リトルエンディアンで 8byte値を読み出す。
	 * 
	 * @param in 入力ストリーム
	 * @return 読み出された8byte値
	 * @exception EOFException 既に End Of Streamに達していたか、 読み込みの途中で End Of Streamに達した。 読み込み途中のデータは消失する。
	 * @exception IOException 入出力エラーが発生した場合
	 */
	public static final long readLong(final InputStream in) throws IOException {
		return readInt(in) & 0xFFFFFFFFL | (long) readInt(in) << 32;

	}

	// ------------------------------------------------------------------
	// shared method
	// ------------------------------------------------------------------
	// write to byte array

	/**
	 * ByteArray の index の位置にリトルエンディアンで 2byte値を書き出す。
	 * 
	 * @param bytes バイト配列
	 * @param index ByteArray内のデータを書きこむ位置
	 * @param value 書きこむ 2byte値
	 * @exception ArrayIndexOutOfBoundsException indexから始まるデータが ByteArrayの範囲内に無い場合。
	 */
	public static final void writeShort(final byte[] bytes, final int index, final int value) {
		if (0 <= index && index + 1 < bytes.length) {
			bytes[index] = (byte) value;
			bytes[index + 1] = (byte) (value >> 8);
		} else {
			throw new ArrayIndexOutOfBoundsException();
		}
	}

	/**
	 * ByteArray の index の位置にリトルエンディアンで 4byte値を書き出す。
	 * 
	 * @param bytes バイト配列
	 * @param index ByteArray内のデータを書きこむ位置
	 * @param value 書きこむ 4byte値
	 * @exception ArrayIndexOutOfBoundsException indexから始まるデータが ByteArrayの範囲内に無い場合。
	 */
	public static final void writeInt(final byte[] bytes, final int index, final int value) {
		if (0 <= index && index + 3 < bytes.length) {
			bytes[index] = (byte) value;
			bytes[index + 1] = (byte) (value >> 8);
			bytes[index + 2] = (byte) (value >> 16);
			bytes[index + 3] = (byte) (value >> 24);
		} else {
			throw new ArrayIndexOutOfBoundsException();
		}
	}

	/**
	 * ByteArray の index の位置にリトルエンディアンで 8byte値を書き出す。
	 * 
	 * @param bytes バイト配列
	 * @param index ByteArray内のデータを書きこむ位置
	 * @param value 書きこむ 8byte値
	 * @exception ArrayIndexOutOfBoundsException indexから始まるデータが ByteArrayの範囲内に無い場合。
	 */
	public static final void writeLong(final byte[] bytes, final int index, final long value) {
		if (0 <= index && index + 7 < bytes.length) {
			writeInt(bytes, index, (int) value);
			writeInt(bytes, index + 4, (int) (value >> 32));
		} else {
			throw new ArrayIndexOutOfBoundsException();
		}
	}

	// ------------------------------------------------------------------
	// shared method
	// ------------------------------------------------------------------
	// write to OutputStream

	/**
	 * 出力ストリーム out に リトルエンディアンで 2バイト書き出す。
	 * 
	 * @param out 出力ストリーム
	 * @param value 書き出す2バイト値
	 * @exception IOException 入出力エラーが発生した場合
	 */
	public static final void writeShort(final OutputStream out, final int value) throws IOException {
		out.write(value & 0xFF);
		out.write(value >> 8 & 0xFF);
	}

	/**
	 * 出力ストリーム out に リトルエンディアンで 4バイト値を書き出す。
	 * 
	 * @param out 出力ストリーム
	 * @param value 書き出す1バイト値
	 * @exception IOException 入出力エラーが発生した場合
	 */
	public static final void writeInt(final OutputStream out, final int value) throws IOException {
		out.write(value & 0xFF);
		out.write(value >> 8 & 0xFF);
		out.write(value >> 16 & 0xFF);
		out.write(value >>> 24);
	}

	/**
	 * 出力ストリーム out に リトルエンディアンで 8バイト値を書き出す。
	 * 
	 * @param out 出力ストリーム
	 * @param value 書き出す1バイト値
	 * @exception IOException 入出力エラーが発生した場合
	 */
	public static final void writeLong(final OutputStream out, final long value) throws IOException {
		final int low = (int) value;
		final int hi = (int) (value >> 32);
		out.write(low & 0xFF);
		out.write(low >> 8 & 0xFF);
		out.write(low >> 16 & 0xFF);
		out.write(low >>> 24);
		out.write(hi & 0xFF);
		out.write(hi >> 8 & 0xFF);
		out.write(hi >> 16 & 0xFF);
		out.write(hi >>> 24);
	}

}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy