org.graalvm.polyglot.io.ByteSequence Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of graal-sdk Show documentation
Show all versions of graal-sdk Show documentation
GraalVM is an ecosystem for compiling and running applications written in multiple languages.
GraalVM removes the isolation between programming languages and enables interoperability in a shared runtime.
/*
* Copyright (c) 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package org.graalvm.polyglot.io;
import java.util.NoSuchElementException;
import java.util.PrimitiveIterator;
import java.util.Spliterator;
import java.util.Spliterators;
import java.util.function.IntConsumer;
import java.util.stream.IntStream;
import java.util.stream.StreamSupport;
/**
* A ByteSequence is a readable sequence of byte values. This interface
* provides uniform, read-only access to many different kinds of byte sequences.
*
* This interface does not refine the general contracts of the
* {@link java.lang.Object#equals(java.lang.Object) equals} and {@link java.lang.Object#hashCode()
* hashCode} methods. The result of comparing two objects that implement ByteSequence is
* therefore, in general, undefined. Each object may be implemented by a different class, and there
* is no guarantee that each class will be capable of testing its instances for equality with those
* of the other. It is therefore inappropriate to use arbitrary ByteSequence instances as
* elements in a set or as keys in a map.
*
*
* @since 1.0
*/
public interface ByteSequence {
/**
* Returns the length of this byte sequence.
*
* @return the number of bytes in this sequence
* @since 1.0
*/
int length();
/**
* Returns the byte value at the specified index. An index ranges from zero to
* length() - 1. The first char value of the sequence is at index zero,
* the next at index one, and so on, as for array indexing.
*
* @param index the index of the byte value to be returned
* @return the specified byte value
* @throws IndexOutOfBoundsException if the index argument is negative or not less than
* length()
* @since 1.0
*/
byte byteAt(int index);
/**
* Returns a ByteSequence that is a subsequence of this sequence. The subsequence
* starts with the byte value at the specified index and ends with the
* byte value at index end - 1. The length (in bytes) of the
* returned sequence is end - start, so if start == end then an empty sequence
* is returned.
*
* @param startIndex the start index, inclusive
* @param endIndex the end index, exclusive
* @return the specified subsequence
* @throws IndexOutOfBoundsException if start or end are negative, if
* end is greater than length(), or if start is greater
* than end
* @since 1.0
*/
default ByteSequence subSequence(int startIndex, int endIndex) {
int l = endIndex - startIndex;
if (l < 0) {
throw new IndexOutOfBoundsException(String.valueOf(l));
}
if (startIndex < 0) {
throw new IndexOutOfBoundsException(String.valueOf(startIndex));
}
if (startIndex + l > length()) {
throw new IndexOutOfBoundsException(String.valueOf(startIndex + l));
}
return new ByteSequence() {
public int length() {
return l;
}
public byte byteAt(int index) {
return ByteSequence.this.byteAt(startIndex + index);
}
};
}
/**
* Returns a byte[] containing the bytes in this sequence in the same order as this
* sequence. The length of the byte array will be the length of this sequence. Creates a new
* byte array with every invocation.
*
* @since 1.0
*/
default byte[] toByteArray() {
byte[] b = new byte[length()];
for (int i = 0; i < b.length; i++) {
b[i] = byteAt(i);
}
return b;
}
/**
* Returns a stream of {@code int} zero-extending the {@code byte} values from this sequence.
*
* @return an IntStream of byte values from this sequence
* @since 1.0
*/
default IntStream bytes() {
class ByteIterator implements PrimitiveIterator.OfInt {
int cur = 0;
public boolean hasNext() {
return cur < length();
}
public int nextInt() {
if (hasNext()) {
return byteAt(cur++) & 0xFF;
} else {
throw new NoSuchElementException();
}
}
@Override
public void forEachRemaining(IntConsumer block) {
for (; cur < length(); cur++) {
block.accept(byteAt(cur) & 0xFF);
}
}
}
return StreamSupport.intStream(() -> Spliterators.spliterator(
new ByteIterator(),
length(),
Spliterator.ORDERED),
Spliterator.SUBSIZED | Spliterator.SIZED | Spliterator.ORDERED,
false);
}
/**
* Creates a ByteSequence from an existing byte[]. The byte array is
* not defensively copied, therefore the given bytes must not mutate to ensure the contract of
* an immutable ByteSequence.
*
* @since 1.0
*/
static ByteSequence create(byte[] buffer) {
return new ByteArraySequence(buffer, 0, buffer.length);
}
}