IDataInput Интерфейс

Определение

Пространство имен:: Java.IO

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Интерфейс DataInput обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.

[Android.Runtime.Register("java/io/DataInput", "", "Java.IO.IDataInputInvoker")]
public interface IDataInput : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("java/io/DataInput", "", "Java.IO.IDataInputInvoker")>]
type IDataInput = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Производный: Java.IO.DataInputStream

Java.IO.IObjectInput

Java.IO.ObjectInputStream

Java.IO.RandomAccessFile

Атрибуты: RegisterAttribute

Реализации: IJavaObject IJavaPeerable IDisposable

Интерфейс DataInput обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов. Существует также средство для восстановления String данных в измененном формате UTF-8.

Как правило, все подпрограммы чтения в этом интерфейсе, что если конец файла достигнут до того, как нужное число байтов было прочитано, EOFException создается (это тип IOException) . Если любой байт не может быть прочитан по какой-либо причине, отличной от конца файла, возникает исключение IOExceptionEOFException . В частности, может возникать исключение, IOException если входной поток был закрыт.

<h3>"modified-utf-8">Modified UTF-8</h3>

Реализации интерфейсов DataInput и DataOutput представляют строки Юникода в формате, который является незначительным изменением UTF-8. (Сведения о стандартном формате UTF-8 см. в разделе 3.9 Формы кодирования Юникодастандарта Юникод, версия 4.0)

<Символы ul><li>в диапазоне '\u005Cu0001''\u005Cu007F' , представленные одним байтом. <li>Null символ '\u005Cu0000' и символы в диапазоне '\u005Cu0080''\u005Cu07FF' , которые будут представлены парой байтов. <li>Символы в диапазоне '\u005Cu0800''\u005CuFFFF' , которые будут представлены тремя байтами. </ul>

<table class="plain" style="margin-left:2em;"><>Заголовок Кодировка значений< UTF-8/caption><thead><tr<>th scope="col" rowspan="2">Value</th><th scope="col" rowspan="2">Byte</th<>th scope="col" colspan="8" id="bit_a">Bit Values</th></tr tr>><<-- Value ---- Byte --<><>th scope="col" style="width:3em"> 7 </th><th scope="col" style="width:3em"> 6 </th><th scope="col" style="width:3em"> 5 /th<>th scope="col" style="width:3em" 4 </><th th scope="col" style="width:3em"> 3 </<>th th scope="col"> style="width:3em"> 2 </th<>th scope="col" style="width:3em"> 1 </><th th scope="col" style="width:3em"> 0 </th></thead<>tbody<>tr><th scope="row" style="text-align:< слева; font-weight:normal" to \u005Cu007F</><th th scope="row">\u005Cu0001 style="font-weight:normal; text-align:center"> 1 </<>th td style="text-align:center">0 <td colspan="7" style="text-align:right; padding-right:6em">bits 6-0 </tr tr><><th scope="row" rowspan="2" style="text-align:left; font-weight:normal",<>\u005Cu0000 br>\u005Cu0080 to<\u005Cu07FF /><th th scope="row" style="font-weight: нормальный; text-align:center"> 1 /th<>td style="text-align:center">1 <td style="text-align:center">1 <td style="text-align:center">0 <td colspan="5" style="text-align:right; padding-right:6em">bits 10-6 </tr tr><><-- (значение) --<>th scope="row" style="font-weight:normal; text-align:center"> 2 </th><td style="text-align:center">1 <td style="< text-align:center">0 <td colspan="6" style="text-align:right; padding-right:6em">bits 5-0 </tr tr><<>th scope="row" rowspan="3" style="text-align:left; font-weight:normal" to \u005CuFFFF</><th th scope="row">\u005Cu0800 style="font-weight:normal; text-align:center"> 1 </<>th td style="text-align:center">1 td style="text-align:center"1 <<td style=">text-align: center">1 td style="text-align:center">0 <td colspan="4" style="text-align:right; padding-right:6em">bits 15-12</tr<<>>-- (value) --<>th scope="row" style="font-weight:normal; text-align:center"> 2 </th<>td style="text-align:center">1 <td style="text-align:center"td <colspan=">6" style="text-align:right; padding-right:6em">bits 11-6 <</tr><tr><-- (значение) --<>th scope="row" style="font-weight:normal; text-align:center"> 3 </th><td style="text-align:center>"1 <td style="text-align:center">td <colspan="6" style="text-align:right; padding-right:6em">bits 5-0 </tr></tbody></table>

Различия между этим форматом и стандартным форматом UTF-8: <ul><li>Null байт '\u005Cu0000' кодируется в формате 2-байтов, а не 1-байтов, чтобы кодированные строки никогда не имели встроенных значений NULL. <li>Используются только 1-байтовые, 2-байтовые и 3-байтовые форматы. <li>Дополнительные символы представлены в виде суррогатных пар. </ul>

Добавлено в версии 1.0.

Java документации по java.io.DataInput.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Свойства

Имя	Описание
Handle	Возвращает значение JNI базового объекта Android. (Унаследовано от IJavaObject)
JniIdentityHashCode	Возвращает значение `java.lang.System.identityHashCode()` для упаковаемого экземпляра. (Унаследовано от IJavaPeerable)
JniManagedPeerState	Состояние управляемого однорангового узла. (Унаследовано от IJavaPeerable)
JniPeerMembers	Поддержка доступа к членам и вызовов. (Унаследовано от IJavaPeerable)
PeerReference	JniObjectReference Возвращает экземпляр объекта в оболочке Java. (Унаследовано от IJavaPeerable)

Методы

Имя	Описание
Disposed()	Вызывается при удалении экземпляра. (Унаследовано от IJavaPeerable)
DisposeUnlessReferenced()	Если нет невыполненных ссылок на этот экземпляр, то вызывается `Dispose()`; в противном случае ничего не делает. (Унаследовано от IJavaPeerable)
Finalized()	Вызывается при завершении экземпляра. (Унаследовано от IJavaPeerable)
ReadBoolean()	Считывает один входной байт и возвращает `true` , если этот байт ненулево, `false` если этот байт равен нулю.
ReadByte()	Считывает и возвращает один входной байт.
ReadChar()	Считывает два входных байта и возвращает `char` значение.
ReadDouble()	Считывает восемь входных байтов и возвращает `double` значение.
ReadFloat()	Считывает четыре входных байта и возвращает `float` значение.
ReadFully(Byte[], Int32, Int32)	Считывает `len` байты из входного потока.
ReadFully(Byte[])	Считывает некоторые байты из входного потока и сохраняет их в буферном массиве `b`.
ReadInt()	Считывает четыре входных байта и возвращает `int` значение.
ReadLine()	Считывает следующую строку текста из входного потока.
ReadLong()	Считывает восемь входных байтов и возвращает `long` значение.
ReadShort()	Считывает два входных байта и возвращает `short` значение.
ReadUnsignedByte()	Считывает один входной байт, ноль расширяет его на тип `int`и возвращает результат, который, следовательно, находится в диапазоне `0` через `255`.
ReadUnsignedShort()	Считывает два входных байта и возвращает `int` значение в диапазоне`0`.`65535`
ReadUTF()	Считывает строку, закодированную с помощью измененного формата UTF-8.
SetJniIdentityHashCode(Int32)	Задайте значение, возвращаемое `JniIdentityHashCode`. (Унаследовано от IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов. (Унаследовано от IJavaPeerable)
SetPeerReference(JniObjectReference)	Задайте значение, возвращаемое `PeerReference`. (Унаследовано от IJavaPeerable)
SkipBytes(Int32)	Делает попытку пропускать `n` байты данных из входного потока, отменяя пропущенные байты.
UnregisterFromRuntime()	Отмените регистрацию этого экземпляра, чтобы среда выполнения не возвращала ее из будущих Java.Interop.JniRuntime+JniValueManager.PeekValue вызовов. (Унаследовано от IJavaPeerable)

Методы расширения

Имя	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadBooleanAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadByteAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadCharAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadDoubleAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadFloatAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadFullyAsync(IDataInput, Byte[], Int32, Int32)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadFullyAsync(IDataInput, Byte[])	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadIntAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadLineAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadLongAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadShortAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadUnsignedByteAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadUnsignedShortAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
ReadUTFAsync(IDataInput)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
SkipBytesAsync(IDataInput, Int32)	Интерфейс `DataInput` обеспечивает чтение байтов из двоичного потока и восстановление данных из них в любом из Java примитивных типов.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

Применяется к