C# Класс Google.ProtocolBuffers.CodedInputStream

Readings and decodes protocol message fields.

This class contains two kinds of methods: methods that read specific protocol message constructs and field types (e.g. ReadTag and ReadInt32) and methods that read low-level values (e.g. ReadRawVarint32 and ReadRawBytes). If you are reading encoded protocol messages, you should use the former methods, but if you are reading some other format of your own design, use the latter. The names of the former methods are taken from the protocol buffer type names, not .NET types. (Hence ReadFloat instead of ReadSingle, and ReadBool instead of ReadBoolean.) TODO(jonskeet): Consider whether recursion and size limits shouldn't be readonly, set at construction time.

Показать файл Открыть проект Примеры использования класса

Открытые методы

Метод	Описание
CreateInstance ( Stream input ) : CodedInputStream	Creates a new CodedInputStream reading data from the given stream.
CreateInstance ( byte buf ) : CodedInputStream	Creates a new CodedInputStream reading data from the given byte array.
PopLimit ( int oldLimit ) : void	Discards the current limit, returning the previous limit.
PushLimit ( int byteLimit ) : int	Sets currentLimit to (current position) + byteLimit. This is called when descending into a length-delimited embedded message. The previous limit is returned.
ReadBool ( ) : bool	Read a bool field from the stream.
ReadBytes ( ) : ByteString	Reads a bytes field value from the stream.
ReadDouble ( ) : double	Read a double field from the stream.
ReadEnum ( ) : int	Reads an enum field value from the stream. The caller is responsible for converting the numeric value to an actual enum.
ReadFloat ( ) : float	Read a float field from the stream.
ReadGroup ( int fieldNumber, IBuilder builder, ExtensionRegistry extensionRegistry ) : void	Reads a group field value from the stream.
ReadInt32 ( ) : int	Read an int32 field from the stream.
ReadInt64 ( ) : long	Read an int64 field from the stream.
ReadMessage ( IBuilder builder, ExtensionRegistry extensionRegistry ) : void	Reads an embedded message field value from the stream.
ReadPrimitiveField ( FieldType fieldType ) : object	Reads a field of any primitive type. Enums, groups and embedded messages are not handled by this method.
ReadRawByte ( ) : byte	Read one byte from the input.
ReadRawBytes ( int size ) : System.ByteBuffer	Read a fixed size of bytes from the input.
ReadSFixed32 ( ) : int	Reads an sfixed32 field value from the stream.
ReadSFixed64 ( ) : long	Reads an sfixed64 field value from the stream.
ReadSInt32 ( ) : int	Reads an sint32 field value from the stream.
ReadSInt64 ( ) : long	Reads an sint64 field value from the stream.
ReadString ( ) : String	Reads a string field from the stream.
ReadUnknownGroup ( int fieldNumber, Google.ProtocolBuffers.UnknownFieldSet builder ) : void	Reads a group field value from the stream and merges it into the given UnknownFieldSet.
ResetSizeCounter ( ) : void	Resets the current size counter to zero (see SetSizeLimit).
SetRecursionLimit ( int limit ) : int	Set the maximum message recursion depth. In order to prevent malicious messages from causing stack overflows, CodedInputStream limits how deeply messages may be nested. The default limit is 64.
SetSizeLimit ( int limit ) : int	Set the maximum message size. In order to prevent malicious messages from exhausting memory or causing integer overflows, CodedInputStream limits how large a message may be. The default limit is 64MB. You should set this limit as small as you can without harming your app's functionality. Note that size limits only apply when reading from an InputStream, not when constructed around a raw byte array (nor with ByteString.NewCodedInput). If you want to read several messages from a single CodedInputStream, you can call ResetSizeCounter() after each message to avoid hitting the size limit.
SkipMessage ( ) : void	Reads and discards an entire message. This will read either until EOF or until an endgroup tag, whichever comes first.
SkipRawBytes ( int size ) : void	Reads and discards size bytes.

Приватные методы

Метод	Описание
CheckLastTagWas ( uint value ) : void
CodedInputStream ( Stream input ) : System
CodedInputStream ( byte buffer ) : System
DecodeZigZag32 ( uint n ) : int
DecodeZigZag64 ( ulong n ) : long
ReadFixed32 ( ) : uint
ReadFixed64 ( ) : ulong
ReadRawLittleEndian32 ( ) : uint
ReadRawLittleEndian64 ( ) : ulong
ReadRawVarint32 ( ) : uint
ReadRawVarint32 ( Stream input ) : uint	Reads a varint from the input one byte at a time, so that it does not read any bytes after the end of the varint. If you simply wrapped the stream in a CodedInputStream and used ReadRawVarint32(Stream)} then you would probably end up reading past the end of the varint since CodedInputStream buffers its input.
ReadRawVarint64 ( ) : ulong
ReadTag ( ) : uint
ReadUInt32 ( ) : uint
ReadUInt64 ( ) : ulong
RecomputeBufferSizeAfterLimit ( ) : void
RefillBuffer ( bool mustSucceed ) : bool	Called when buffer is empty to read more bytes from the input. If mustSucceed is true, RefillBuffer() gurantees that either there will be at least one byte in the buffer when it returns or it will throw an exception. If mustSucceed is false, RefillBuffer() returns false if no more bytes were available.
SkipField ( uint tag ) : bool
SkipImpl ( int amountToSkip ) : void	Abstraction of skipping to cope with streams which can't really skip.
SlowReadRawVarint32 ( ) : uint	Same code as ReadRawVarint32, but read each byte individually, checking for buffer overflow.

Описание методов

CreateInstance() публичный статический Метод

Creates a new CodedInputStream reading data from the given stream.

public static CreateInstance ( Stream input ) : CodedInputStream
input	Stream
Результат	CodedInputStream

CreateInstance() публичный статический Метод

Creates a new CodedInputStream reading data from the given byte array.

public static CreateInstance ( byte buf ) : CodedInputStream
buf	byte
Результат	CodedInputStream

PopLimit() публичный Метод

Discards the current limit, returning the previous limit.

public PopLimit ( int oldLimit ) : void
oldLimit	int
Результат	void

PushLimit() публичный Метод

Sets currentLimit to (current position) + byteLimit. This is called when descending into a length-delimited embedded message. The previous limit is returned.

public PushLimit ( int byteLimit ) : int
byteLimit	int
Результат	int

ReadBool() публичный Метод

Read a bool field from the stream.

public ReadBool ( ) : bool
Результат	bool

ReadBytes() публичный Метод

Reads a bytes field value from the stream.

public ReadBytes ( ) : ByteString
Результат	ByteString

ReadDouble() публичный Метод

Read a double field from the stream.

public ReadDouble ( ) : double
Результат	double

ReadEnum() публичный Метод

Reads an enum field value from the stream. The caller is responsible for converting the numeric value to an actual enum.

public ReadEnum ( ) : int
Результат	int

ReadFloat() публичный Метод

Read a float field from the stream.

public ReadFloat ( ) : float
Результат	float

ReadGroup() публичный Метод

Reads a group field value from the stream.

public ReadGroup ( int fieldNumber, IBuilder builder, ExtensionRegistry extensionRegistry ) : void
fieldNumber	int
builder	IBuilder
extensionRegistry	ExtensionRegistry
Результат	void

ReadInt32() публичный Метод

Read an int32 field from the stream.

public ReadInt32 ( ) : int
Результат	int

ReadInt64() публичный Метод

Read an int64 field from the stream.

public ReadInt64 ( ) : long
Результат	long

ReadMessage() публичный Метод

Reads an embedded message field value from the stream.

public ReadMessage ( IBuilder builder, ExtensionRegistry extensionRegistry ) : void
builder	IBuilder
extensionRegistry	ExtensionRegistry
Результат	void

ReadPrimitiveField() публичный Метод

Reads a field of any primitive type. Enums, groups and embedded messages are not handled by this method.

public ReadPrimitiveField ( FieldType fieldType ) : object
fieldType	FieldType
Результат	object

ReadRawByte() публичный Метод

Read one byte from the input.

/// the end of the stream or the current limit was reached ///

public ReadRawByte ( ) : byte
Результат	byte

ReadRawBytes() публичный Метод

Read a fixed size of bytes from the input.

/// the end of the stream or the current limit was reached ///

public ReadRawBytes ( int size ) : System.ByteBuffer
size	int
Результат	System.ByteBuffer

ReadSFixed32() публичный Метод

Reads an sfixed32 field value from the stream.

public ReadSFixed32 ( ) : int
Результат	int

ReadSFixed64() публичный Метод

Reads an sfixed64 field value from the stream.

public ReadSFixed64 ( ) : long
Результат	long

ReadSInt32() публичный Метод

Reads an sint32 field value from the stream.

public ReadSInt32 ( ) : int
Результат	int

ReadSInt64() публичный Метод

Reads an sint64 field value from the stream.

public ReadSInt64 ( ) : long
Результат	long

ReadString() публичный Метод

Reads a string field from the stream.

public ReadString ( ) : String
Результат	String

ReadUnknownGroup() публичный Метод

Reads a group field value from the stream and merges it into the given UnknownFieldSet.

public ReadUnknownGroup ( int fieldNumber, Google.ProtocolBuffers.UnknownFieldSet builder ) : void
fieldNumber	int
builder	Google.ProtocolBuffers.UnknownFieldSet
Результат	void

ResetSizeCounter() публичный Метод

Resets the current size counter to zero (see SetSizeLimit).

public ResetSizeCounter ( ) : void
Результат	void

SetRecursionLimit() публичный Метод

Set the maximum message recursion depth.

In order to prevent malicious messages from causing stack overflows, CodedInputStream limits how deeply messages may be nested. The default limit is 64.

public SetRecursionLimit ( int limit ) : int
limit	int
Результат	int

SetSizeLimit() публичный Метод

Set the maximum message size.

In order to prevent malicious messages from exhausting memory or causing integer overflows, CodedInputStream limits how large a message may be. The default limit is 64MB. You should set this limit as small as you can without harming your app's functionality. Note that size limits only apply when reading from an InputStream, not when constructed around a raw byte array (nor with ByteString.NewCodedInput). If you want to read several messages from a single CodedInputStream, you can call ResetSizeCounter() after each message to avoid hitting the size limit.

public SetSizeLimit ( int limit ) : int
limit	int
Результат	int

SkipMessage() публичный Метод

Reads and discards an entire message. This will read either until EOF or until an endgroup tag, whichever comes first.

public SkipMessage ( ) : void
Результат	void

SkipRawBytes() публичный Метод

Reads and discards size bytes.

the end of the stream /// or the current limit was reached

public SkipRawBytes ( int size ) : void
size	int
Результат	void