Add ability to report absolute positions (relative to the root stream)

Fix #26

Author: Mingun

src/main/java/io/kaitai/struct/ByteBufferKaitaiStream.java

@@ -1,5 +1,5 @@
 /**
- * Copyright 2015-2019 Kaitai Project: MIT license
+ * Copyright 2015-2020 Kaitai Project: MIT license
  *
  * Permission is hereby granted, free of charge, to any person obtaining
  * a copy of this software and associated documentation files (the
@@ -55,18 +55,47 @@ public ByteBufferKaitaiStream(String fileName) throws IOException {
     /**
      * Initializes a stream that will get data from given byte array when read.
      * Internally, ByteBuffer wrapping given array will be used.
+     *
      * @param arr byte array to read
      */
     public ByteBufferKaitaiStream(byte[] arr) {
+        this(arr, 0);
+    }
+
+    /**
+     * Initializes a stream that will get data from given byte array when read.
+     * Internally, ByteBuffer wrapping given array will be used.
+     *
+     * @param arr byte array to read
+     * @param offset offset from the root stream where this stream begins
+     *
+     * @since 0.10
+     */
+    public ByteBufferKaitaiStream(byte[] arr, long offset) {
+        super(offset);
         fc = null;
         bb = ByteBuffer.wrap(arr);
     }
 
     /**
      * Initializes a stream that will get data from given ByteBuffer when read.
+     *
      * @param buffer ByteBuffer to read
      */
     public ByteBufferKaitaiStream(ByteBuffer buffer) {
+        this(buffer, 0);
+    }
+
+    /**
+     * Initializes a stream that will get data from given ByteBuffer when read.
+     *
+     * @param buffer ByteBuffer to read
+     * @param offset offset from the root stream where this stream begins
+     *
+     * @since 0.10
+     */
+    public ByteBufferKaitaiStream(ByteBuffer buffer, long offset) {
+        super(offset);
         fc = null;
         bb = buffer;
     }

src/main/java/io/kaitai/struct/KaitaiStream.java

@@ -1,5 +1,5 @@
 /**
- * Copyright 2015-2019 Kaitai Project: MIT license
+ * Copyright 2015-2020 Kaitai Project: MIT license
  *
  * Permission is hereby granted, free of charge, to any person obtaining
  * a copy of this software and associated documentation files (the
@@ -56,6 +56,24 @@
 public abstract class KaitaiStream implements Closeable {
     protected int bitsLeft = 0;
     protected long bits = 0;
+    /**
+     * Offset from the root stream where this stream begins.
+     *
+     * @since 0.10
+     */
+    protected final long offset;
+
+    /** Initializes a stream with zero offset from the root stream. */
+    public KaitaiStream() { this(0); }
+
+    /**
+     * Initializes a stream with specified offset from the root stream.
+     *
+     * @param offset offset from the root stream where this stream begins
+     *
+     * @since 0.10
+     */
+    public KaitaiStream(long offset) { this.offset = offset; }
 
     @Override
     abstract public void close() throws IOException;
@@ -80,6 +98,16 @@ public abstract class KaitaiStream implements Closeable {
      */
     abstract public void seek(long newPos);
 
+    /**
+     * Get position of a stream pointer relative to the root stream in the stream hierarchy.
+     * Root stream is a stream without parent stream.
+     *
+     * @return the pointer position, number of bytes from the beginning of the root stream
+     *
+     * @since 0.10
+     */
+    public long offset() { return this.offset; }
+
     /**
      * Get current position of a stream pointer.
      * @return pointer position, number of bytes from the beginning of the stream