RBuf16 Class Reference

Transfers ownership of the specified 16-bit resizable buffer descriptor's buffer to this object.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

See also: RBuf16::Close()

Assigns ownership of the specified allocated memory to this object.

The allocated memory forms the buffer for this descriptor. The current length of the descriptor is set to zero.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

USER 8 If the specified maximum length is greater then the size of the allocated heap cell, or the specified maximum length is NOT zero when the pointer to the heap cell is NULL.

See also: TDesC16::Length() TDes16::MaxLength() RBuf16::Close()

Assigns ownership of the specified allocated memory to this object.

The allocated memory forms the buffer for this descriptor. The current length of the descriptor is set to the value of the second parameter.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

USER 8 If the specified maximum length is greater then the size of the allocated heap cell, or the specified length is greater then the specified maximum length, or the specified maximum length is NOT zero when the pointer to the heap cell is NULL.

See also: TDesC16::Length() TDes16::MaxLength() RBuf16::Close()

Transfers ownership of the specified heap descriptor to this object.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

See also: RBuf16::Close()

Pushes a cleanup item for this object onto the cleanup stack.

The effect of this is to cause Close() to be called on this 16-bit resizable buffer descriptor, when CleanupStack::PopAndDestroy() is called at some later time.

...
RBuf16 x;
....
x.CleanupClosePushL();
...
CleanupStack::PopAndDestroy();
...

See also: RBuf16::Close()

Deallocates memory assigned to this object, and re-initializes the object as a zero-length descriptor.

Creates a 16-bit resizable buffer descriptor.

The function allocates sufficient memory to contain descriptor data up to the specified maximum length.

The current length of the descriptor is set to zero. The maximum length of the descriptor is set to the specified value.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

See also: TDesC16::Length() TDes16::MaxLength() RBuf16::Close()

Creates a 16-bit resizable buffer descriptor to contain a copy of the specified (source) descriptor.

The function allocates sufficient memory so that this descriptor's maximum length is the same as the length of the source descriptor. Both the current length and the maximum length of this descriptor are set to the length of the source descriptor.

The data contained in the source descriptor is copied into this descriptor.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

See also: TDesC16::Length() TDes16::MaxLength() TDes16::Copy() RBuf16::Close()

Creates a 16-bit resizable buffer descriptor to contain a copy of the specified (source) descriptor.

The function allocates sufficient memory so that this descriptor's maximum length is the same as the value of the aMaxLength parameter.

The data contained in the source descriptor is copied into this descriptor. The length of data copied is either

or

whichever is the smaller value. The current length of this descriptor is also set to the smaller value.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

See also: TDesC16::Length() TDes16::MaxLength() TDes16::Copy() RBuf16::Close()

Creates 16-bit resizable buffer descriptor, and leaves on failure.

The function allocates sufficient memory to contain descriptor data up to the specified maximum length.

The current length of the descriptor is set to zero. The maximum length of the descriptor is set to the specified value.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

KErrNoMemory If there is insufficient memory.

See also: TDesC16::Length() TDes16::MaxLength() RBuf16::Close()

Creates a 16-bit resizable buffer descriptor that has been initialised with data from the specified read stream; leaves on failure.

Data is assigned to the new descriptor from the specified stream. This variant assumes that the stream contains the length of the data followed by the data itself.

The function is implemented by calling the HBufC16::NewL(RReadStream&,TInt) variant and then assigning the resulting heap descriptor using the RBuf16::Assign(HBufC16*) variant. The comments that describe the HBufC16::NewL() variant also apply to this RBuf16::CreateL() function.

The function may leave with one of the system-wide error codes, specifically KErrOverflow, if the length of the data as read from the stream is greater than the upper limit as specified by the aMaxLength parameter.

Creates a 16-bit resizable buffer descriptor to contain a copy of the specified (source) descriptor, and leaves on failure.

The function allocates sufficient memory so that this descriptor's maximum length is the same as the length of the source descriptor.Both the current length and the maximum length of this descriptor are set to the length of the source descriptor.

The data contained in the source descriptor is copied into this descriptor.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

KErrNoMemory If there is insufficient memory.

See also: TDesC16::Length() TDes16::MaxLength() TDes16::Copy() RBuf16::Close()

Creates a 16-bit resizable buffer descriptor to contain a copy of the specified (source) descriptor, and leaves on failure.

The function allocates sufficient memory so that this descriptor's maximum length is the same as the value of the aMaxLength parameter.

The data contained in the source descriptor is copied into this descriptor. The length of data copied is either

or

whichever is the smaller value. The current length of this descriptor is also set to the smaller value.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

KErrNoMemory If there is insufficient memory.

See also: TDesC16::Length() TDes16::MaxLength() TDes16::Copy() RBuf16::Close()

Creates a 16-bit resizable buffer descriptor.

The function allocates sufficient memory to contain descriptor data up to the specified maximum length.

Both the current length and the maximum length of the descriptor are set to the specified value.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

See also: RBuf16::Close()

Creates a 16-bit resizable buffer descriptor, and leaves on failure.

The function allocates sufficient memory to contain descriptor data up to the specified maximum length.

Both the current length and the maximum length of the descriptor are set to the specified value.

Note that the function assumes that this descriptor does not already own any allocated memory. It does not check, nor does it free any pre-existing owned allocated memory. If this descriptor does already own allocated memory, RBuf16::Close() should be invoked on this descriptor before this function is invoked.

KErrNoMemory If there is insufficient memory.

See also: TDesC16::Length() TDes16::MaxLength() RBuf16::Close()

Resizes this 16-bit resizable buffer descriptor.

The length and contents of the descriptor are unchanged.

If the buffer descriptor was created from a zero-length heap descriptor HBufC, this method might leak memory (the heap descriptor is not freed). It is possible to avoid this by calling the Close() method prior to ReAlloc(), but this should be done only in this situation (otherwise the buffer contents will be lost).

    if (desc.MaxLength() == 0) desc.Close();

USER 14 If the new maximum length is less then the current descriptor length.

Resizes this 16-bit resizable buffer descriptor, leaving on failure.

The length and contents of the descriptor are unchanged.

If the buffer descriptor was created from a zero-length heap descriptor HBufC, this method might leak memory (the heap descriptor is not freed). It is possible to avoid this by calling the Close() method prior to ReAllocL(), but this should be done only in this situation (otherwise the buffer contents will be lost).

    if (desc.MaxLength() == 0) desc.Close();

USER 14 If the new maximum length is less then the current descriptor length.

Swaps the content of two 16-bit resizable buffer descriptors.

Copies data into this descriptor replacing any existing data.

The length of this descriptor is set to reflect the new data.

Copies data into this descriptor replacing any existing data.

The length of this descriptor is set to reflect the new data.

Copies data into this descriptor replacing any existing data.

The length of this descriptor is set to reflect the new data.