com.upokecenter.util.IWriter Maven / Gradle / Ivy

Go to download
package com.upokecenter.util;
/*
Written by Peter O. in 2014.
Any copyright is dedicated to the Public Domain.
http://creativecommons.org/publicdomain/zero/1.0/
If you like this, you should donate to Peter O.
at: http://upokecenter.dreamhosters.com/articles/donate-now-2/
 */

    /**
     * A generic interface for writing bytes of data.
     */
  public interface IWriter extends IByteWriter {
    /**
     * Writes a portion of a byte array to the data source.
     * @param bytes A byte array containing the data to write.
     * @param offset A zero-based index showing where the desired portion of {@code
     * bytes} begins.
     * @param length The number of elements in the desired portion of {@code bytes}
     * (but not more than {@code bytes} 's length).
     * @throws NullPointerException Should be thrown if the parameter "bytes" is
     * null.
     * @throws IllegalArgumentException Should be thrown if either "offset" or "length" is
     * less than 0 or greater than "bytes" 's length, or "bytes" 's length
     * minus "offset" is less than "length".
     */
    void write(byte[] bytes, int offset, int length);
  }