len bytes to this buffer from the given source
+ * array starting at index off. The capacity of the buffer
+ * is increased, if necessary, to accommodate all len bytes.
+ *
+ * @param b the bytes to be appended.
+ * @param off the index of the first byte to append.
+ * @param len the number of bytes to append.
+ * @throws IndexOutOfBoundsException if off if out of
+ * range, len is negative, or
+ * off + len is out of range.
+ */
+ public void append(final byte[] b, int off, int len) {
+ if (b == null) {
+ return;
+ }
+ if ((off < 0) || (off > b.length) || (len < 0) ||
+ ((off + len) < 0) || ((off + len) > b.length)) {
+ throw new IndexOutOfBoundsException("off: "+off+" len: "+len+" b.length: "+b.length);
+ }
+ if (len == 0) {
+ return;
+ }
+ int newlen = this.len + len;
+ if (newlen > this.buffer.length) {
+ expand(newlen);
+ }
+ System.arraycopy(b, off, this.buffer, this.len, len);
+ this.len = newlen;
+ }
+
+ /**
+ * Appends b byte to this buffer. The capacity of the buffer
+ * is increased, if necessary, to accommodate the additional byte.
+ *
+ * @param b the byte to be appended.
+ */
+ public void append(int b) {
+ int newlen = this.len + 1;
+ if (newlen > this.buffer.length) {
+ expand(newlen);
+ }
+ this.buffer[this.len] = (byte)b;
+ this.len = newlen;
+ }
+
+ /**
+ * Appends len chars to this buffer from the given source
+ * array starting at index off. The capacity of the buffer
+ * is increased if necessary to accommodate all len chars.
+ *
+ * The chars are converted to bytes using simple cast.
+ *
+ * @param b the chars to be appended.
+ * @param off the index of the first char to append.
+ * @param len the number of bytes to append.
+ * @throws IndexOutOfBoundsException if off if out of
+ * range, len is negative, or
+ * off + len is out of range.
+ */
+ public void append(final char[] b, int off, int len) {
+ if (b == null) {
+ return;
+ }
+ if ((off < 0) || (off > b.length) || (len < 0) ||
+ ((off + len) < 0) || ((off + len) > b.length)) {
+ throw new IndexOutOfBoundsException("off: "+off+" len: "+len+" b.length: "+b.length);
+ }
+ if (len == 0) {
+ return;
+ }
+ int oldlen = this.len;
+ int newlen = oldlen + len;
+ if (newlen > this.buffer.length) {
+ expand(newlen);
+ }
+ for (int i1 = off, i2 = oldlen; i2 < newlen; i1++, i2++) {
+ this.buffer[i2] = (byte) b[i1];
+ }
+ this.len = newlen;
+ }
+
+ /**
+ * Appends len chars to this buffer from the given source
+ * char array buffer starting at index off. The capacity
+ * of the buffer is increased if necessary to accommodate all
+ * len chars.
+ *
+ * The chars are converted to bytes using simple cast.
+ *
+ * @param b the chars to be appended.
+ * @param off the index of the first char to append.
+ * @param len the number of bytes to append.
+ * @throws IndexOutOfBoundsException if off if out of
+ * range, len is negative, or
+ * off + len is out of range.
+ */
+ public void append(final CharArrayBuffer b, int off, int len) {
+ if (b == null) {
+ return;
+ }
+ append(b.buffer(), off, len);
+ }
+
+ /**
+ * Clears content of the buffer. The underlying byte array is not resized.
+ */
+ public void clear() {
+ this.len = 0;
+ }
+
+ /**
+ * Converts the content of this buffer to an array of bytes.
+ *
+ * @return byte array
+ */
+ public byte[] toByteArray() {
+ byte[] b = new byte[this.len];
+ if (this.len > 0) {
+ System.arraycopy(this.buffer, 0, b, 0, this.len);
+ }
+ return b;
+ }
+
+ /**
+ * Returns the byte value in this buffer at the specified
+ * index. The index argument must be greater than or equal to
+ * 0, and less than the length of this buffer.
+ *
+ * @param i the index of the desired byte value.
+ * @return the byte value at the specified index.
+ * @throws IndexOutOfBoundsException if index is
+ * negative or greater than or equal to {@link #length()}.
+ */
+ public int byteAt(int i) {
+ return this.buffer[i];
+ }
+
+ /**
+ * Returns the current capacity. The capacity is the amount of storage
+ * available for newly appended bytes, beyond which an allocation
+ * will occur.
+ *
+ * @return the current capacity
+ */
+ public int capacity() {
+ return this.buffer.length;
+ }
+
+ /**
+ * Returns the length of the buffer (byte count).
+ *
+ * @return the length of the buffer
+ */
+ public int length() {
+ return this.len;
+ }
+
+ /**
+ * Ensures that the capacity is at least equal to the specified minimum.
+ * If the current capacity is less than the argument, then a new internal
+ * array is allocated with greater capacity. If the required
+ * argument is non-positive, this method takes no action.
+ *
+ * @param required the minimum required capacity.
+ *
+ * @since 4.1
+ */
+ public void ensureCapacity(int required) {
+ if (required <= 0) {
+ return;
+ }
+ int available = this.buffer.length - this.len;
+ if (required > available) {
+ expand(this.len + required);
+ }
+ }
+
+ /**
+ * Returns reference to the underlying byte array.
+ *
+ * @return the byte array.
+ */
+ public byte[] buffer() {
+ return this.buffer;
+ }
+
+ /**
+ * Sets the length of the buffer. The new length value is expected to be
+ * less than the current capacity and greater than or equal to
+ * 0.
+ *
+ * @param len the new length
+ * @throws IndexOutOfBoundsException if the
+ * len argument is greater than the current
+ * capacity of the buffer or less than 0.
+ */
+ public void setLength(int len) {
+ if (len < 0 || len > this.buffer.length) {
+ throw new IndexOutOfBoundsException("len: "+len+" < 0 or > buffer len: "+this.buffer.length);
+ }
+ this.len = len;
+ }
+
+ /**
+ * Returns true if this buffer is empty, that is, its
+ * {@link #length()} is equal to 0.
+ * @return true if this buffer is empty, false
+ * otherwise.
+ */
+ public boolean isEmpty() {
+ return this.len == 0;
+ }
+
+ /**
+ * Returns true if this buffer is full, that is, its
+ * {@link #length()} is equal to its {@link #capacity()}.
+ * @return true if this buffer is full, false
+ * otherwise.
+ */
+ public boolean isFull() {
+ return this.len == this.buffer.length;
+ }
+
+ /**
+ * Returns the index within this buffer of the first occurrence of the
+ * specified byte, starting the search at the specified
+ * beginIndex and finishing at endIndex.
+ * If no such byte occurs in this buffer within the specified bounds,
+ * -1 is returned.
+ *
+ * There is no restriction on the value of beginIndex and
+ * endIndex. If beginIndex is negative,
+ * it has the same effect as if it were zero. If endIndex is
+ * greater than {@link #length()}, it has the same effect as if it were
+ * {@link #length()}. If the beginIndex is greater than
+ * the endIndex, -1 is returned.
+ *
+ * @param b the byte to search for.
+ * @param beginIndex the index to start the search from.
+ * @param endIndex the index to finish the search at.
+ * @return the index of the first occurrence of the byte in the buffer
+ * within the given bounds, or -1 if the byte does
+ * not occur.
+ *
+ * @since 4.1
+ */
+ public int indexOf(byte b, int beginIndex, int endIndex) {
+ if (beginIndex < 0) {
+ beginIndex = 0;
+ }
+ if (endIndex > this.len) {
+ endIndex = this.len;
+ }
+ if (beginIndex > endIndex) {
+ return -1;
+ }
+ for (int i = beginIndex; i < endIndex; i++) {
+ if (this.buffer[i] == b) {
+ return i;
+ }
+ }
+ return -1;
+ }
+
+ /**
+ * Returns the index within this buffer of the first occurrence of the
+ * specified byte, starting the search at 0 and finishing
+ * at {@link #length()}. If no such byte occurs in this buffer within
+ * those bounds, -1 is returned.
+ *
+ * @param b the byte to search for.
+ * @return the index of the first occurrence of the byte in the
+ * buffer, or -1 if the byte does not occur.
+ *
+ * @since 4.1
+ */
+ public int indexOf(byte b) {
+ return indexOf(b, 0, this.len);
+ }
+}