com.upokecenter.cbor.ICharacterInput Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of cbor Show documentation

A Java implementation of Concise Binary Object Representation (CBOR), a general-purpose binary data format defined in RFC 7049.

There is a newer version: 5.0.0-alpha1

Show newest version

package com.upokecenter.cbor;

    /**
     * An interface for reading Unicode characters from a data source.
     */
  interface ICharacterInput {
    /**
     * Reads a Unicode character from a data source.
     * @return Either a Unicode code point (from 0-0xd7ff or from 0xe000 to
     * 0x10ffff), or the value -1 indicating the end of the source.
     */
    int ReadChar();

    /**
     * Reads a sequence of Unicode code points from a data source.
     * @param chars Output buffer.
     * @param index Index in the output buffer to start writing to.
     * @param length Maximum number of code points to write.
     * @return Either a Unicode code point (from 0-0xd7ff or from 0xe000 to
     * 0x10ffff), or the value -1 indicating the end of the source.
     * @throws IllegalArgumentException Either "index" or "length" is less than 0 or
     *  greater than "chars"'s length, or "chars"'s length minus "index" is
     *  less than "length".
     * @throws NullPointerException The parameter {@code chars} is null.
     */
    int Read(int[] chars, int index, int length);
  }