ByteSink Class Reference

#include <bytestream.h>

Inheritance diagram for ByteSink:

Public Member Functions
	ByteSink ()
virtual	~ByteSink ()
virtual void	Append (const char *bytes, int32_t n)=0
virtual char *	GetAppendBuffer (int32_t min_capacity, int32_t desired_capacity_hint, char *scratch, int32_t scratch_capacity, int32_t *result_capacity)
virtual void	Flush ()
	ByteSink ()
virtual	~ByteSink ()
virtual void	Append (const char *bytes, int32_t n)=0
virtual char *	GetAppendBuffer (int32_t min_capacity, int32_t desired_capacity_hint, char *scratch, int32_t scratch_capacity, int32_t *result_capacity)
virtual void	Flush ()
	ByteSink ()
virtual	~ByteSink ()
virtual void	Append (const char *bytes, int32_t n)=0
virtual char *	GetAppendBuffer (int32_t min_capacity, int32_t desired_capacity_hint, char *scratch, int32_t scratch_capacity, int32_t *result_capacity)
virtual void	Flush ()

Detailed Description

A ByteSink can be filled with bytes. ICU 4.2

Constructor & Destructor Documentation

ByteSink() [1/3]

ByteSink::ByteSink ( )

inline

Default constructor. ICU 4.2

~ByteSink() [1/3]

virtual ByteSink::~ByteSink ( )

virtual

Virtual destructor. ICU 4.2

ByteSink() [2/3]

ByteSink::ByteSink ( )

inline

Default constructor. ICU 4.2

~ByteSink() [2/3]

virtual ByteSink::~ByteSink ( )

virtual

Virtual destructor. ICU 4.2

ByteSink() [3/3]

ByteSink::ByteSink ( )

inline

Default constructor. ICU 4.2

~ByteSink() [3/3]

virtual ByteSink::~ByteSink ( )

virtual

Virtual destructor. ICU 4.2

Member Function Documentation

Append() [1/3]

virtual void ByteSink::Append ( const char *  bytes, int32_t  n  )

pure virtual

Append "bytes[0,n-1]" to this.

Parameters

bytes	the pointer to the bytes
n	the number of bytes; must be non-negative ICU 4.2

Implemented in CheckedArrayByteSink, CheckedArrayByteSink, and CheckedArrayByteSink.

Append() [2/3]

virtual void ByteSink::Append ( const char *  bytes, int32_t  n  )

pure virtual

Append "bytes[0,n-1]" to this.

Parameters

bytes	the pointer to the bytes
n	the number of bytes; must be non-negative ICU 4.2

Implemented in CheckedArrayByteSink, CheckedArrayByteSink, and CheckedArrayByteSink.

Append() [3/3]

virtual void ByteSink::Append ( const char *  bytes, int32_t  n  )

pure virtual

Append "bytes[0,n-1]" to this.

Parameters

bytes	the pointer to the bytes
n	the number of bytes; must be non-negative ICU 4.2

Implemented in CheckedArrayByteSink, CheckedArrayByteSink, and CheckedArrayByteSink.

Flush() [1/3]

virtual void ByteSink::Flush ( )

virtual

Flush internal buffers. Some byte sinks use internal buffers or provide buffering and require calling Flush() at the end of the stream. The ByteSink should be ready for further Append() calls after Flush(). The default implementation of Flush() does nothing. ICU 4.2

Flush() [2/3]

virtual void ByteSink::Flush ( )

virtual

Flush internal buffers. Some byte sinks use internal buffers or provide buffering and require calling Flush() at the end of the stream. The ByteSink should be ready for further Append() calls after Flush(). The default implementation of Flush() does nothing. ICU 4.2

Flush() [3/3]

virtual void ByteSink::Flush ( )

virtual

Flush internal buffers. Some byte sinks use internal buffers or provide buffering and require calling Flush() at the end of the stream. The ByteSink should be ready for further Append() calls after Flush(). The default implementation of Flush() does nothing. ICU 4.2

GetAppendBuffer() [1/3]

virtual char* ByteSink::GetAppendBuffer ( int32_t  min_capacity, int32_t  desired_capacity_hint, char *  scratch, int32_t  scratch_capacity, int32_t *  result_capacity  )

virtual

Returns a writable buffer for appending and writes the buffer's capacity to *result_capacity. Guarantees *result_capacity>=min_capacity. May return a pointer to the caller-owned scratch buffer which must have scratch_capacity>=min_capacity. The returned buffer is only valid until the next operation on this ByteSink.

After writing at most *result_capacity bytes, call Append() with the pointer returned from this function and the number of bytes written. Many Append() implementations will avoid copying bytes if this function returned an internal buffer.

Partial usage example: int32_t capacity; char* buffer = sink->GetAppendBuffer(..., &capacity); ... Write n bytes into buffer, with n <= capacity. sink->Append(buffer, n); In many implementations, that call to Append will avoid copying bytes.

If the ByteSink allocates or reallocates an internal buffer, it should use the desired_capacity_hint if appropriate. If a caller cannot provide a reasonable guess at the desired capacity, it should pass desired_capacity_hint=0.

If a non-scratch buffer is returned, the caller may only pass a prefix to it to Append(). That is, it is not correct to pass an interior pointer to Append().

The default implementation always returns the scratch buffer.

Parameters

min_capacity	required minimum capacity of the returned buffer; must be non-negative
desired_capacity_hint	desired capacity of the returned buffer; must be non-negative
scratch	default caller-owned buffer
scratch_capacity	capacity of the scratch buffer
result_capacity	pointer to an integer which will be set to the capacity of the returned buffer

Returns

a buffer with *result_capacity>=min_capacity ICU 4.2

Reimplemented in CheckedArrayByteSink, CheckedArrayByteSink, and CheckedArrayByteSink.

GetAppendBuffer() [2/3]

virtual char* ByteSink::GetAppendBuffer ( int32_t  min_capacity, int32_t  desired_capacity_hint, char *  scratch, int32_t  scratch_capacity, int32_t *  result_capacity  )

virtual

Returns a writable buffer for appending and writes the buffer's capacity to *result_capacity. Guarantees *result_capacity>=min_capacity. May return a pointer to the caller-owned scratch buffer which must have scratch_capacity>=min_capacity. The returned buffer is only valid until the next operation on this ByteSink.

After writing at most *result_capacity bytes, call Append() with the pointer returned from this function and the number of bytes written. Many Append() implementations will avoid copying bytes if this function returned an internal buffer.

Partial usage example: int32_t capacity; char* buffer = sink->GetAppendBuffer(..., &capacity); ... Write n bytes into buffer, with n <= capacity. sink->Append(buffer, n); In many implementations, that call to Append will avoid copying bytes.

If the ByteSink allocates or reallocates an internal buffer, it should use the desired_capacity_hint if appropriate. If a caller cannot provide a reasonable guess at the desired capacity, it should pass desired_capacity_hint=0.

If a non-scratch buffer is returned, the caller may only pass a prefix to it to Append(). That is, it is not correct to pass an interior pointer to Append().

The default implementation always returns the scratch buffer.

Parameters

min_capacity	required minimum capacity of the returned buffer; must be non-negative
desired_capacity_hint	desired capacity of the returned buffer; must be non-negative
scratch	default caller-owned buffer
scratch_capacity	capacity of the scratch buffer
result_capacity	pointer to an integer which will be set to the capacity of the returned buffer

Returns

a buffer with *result_capacity>=min_capacity ICU 4.2

Reimplemented in CheckedArrayByteSink, CheckedArrayByteSink, and CheckedArrayByteSink.

GetAppendBuffer() [3/3]

virtual char* ByteSink::GetAppendBuffer ( int32_t  min_capacity, int32_t  desired_capacity_hint, char *  scratch, int32_t  scratch_capacity, int32_t *  result_capacity  )

virtual

Returns a writable buffer for appending and writes the buffer's capacity to *result_capacity. Guarantees *result_capacity>=min_capacity. May return a pointer to the caller-owned scratch buffer which must have scratch_capacity>=min_capacity. The returned buffer is only valid until the next operation on this ByteSink.

After writing at most *result_capacity bytes, call Append() with the pointer returned from this function and the number of bytes written. Many Append() implementations will avoid copying bytes if this function returned an internal buffer.

Partial usage example: int32_t capacity; char* buffer = sink->GetAppendBuffer(..., &capacity); ... Write n bytes into buffer, with n <= capacity. sink->Append(buffer, n); In many implementations, that call to Append will avoid copying bytes.

If the ByteSink allocates or reallocates an internal buffer, it should use the desired_capacity_hint if appropriate. If a caller cannot provide a reasonable guess at the desired capacity, it should pass desired_capacity_hint=0.

If a non-scratch buffer is returned, the caller may only pass a prefix to it to Append(). That is, it is not correct to pass an interior pointer to Append().

The default implementation always returns the scratch buffer.

Parameters

min_capacity	required minimum capacity of the returned buffer; must be non-negative
desired_capacity_hint	desired capacity of the returned buffer; must be non-negative
scratch	default caller-owned buffer
scratch_capacity	capacity of the scratch buffer
result_capacity	pointer to an integer which will be set to the capacity of the returned buffer

Returns

a buffer with *result_capacity>=min_capacity ICU 4.2

Reimplemented in CheckedArrayByteSink, CheckedArrayByteSink, and CheckedArrayByteSink.

---

The documentation for this class was generated from the following file:

• DerivedData/WebKit/Build/Products/Debug/WebCore.framework/Versions/A/PrivateHeaders/icu/unicode/bytestream.h