Extracted from Pike v8.0 release 28 as of 2015-08-03.
   

Method Stdio.Buffer()->add_hstring()


Method add_hstring

Buffer add_hstring(string(8bit) data, int size_size)
Buffer add_hstring(Stdio.Buffer data, int size_size)
Buffer add_hstring(System.Memory data, int size_size)
Buffer add_hstring(String.Buffer data, int size_size)
Buffer add_hstring(array data, int size_size)

Description

Adds length of data followed by data to the buffer.

This is identical to sprintf("%"+size_size+"H",(string)Stdio.Buffer(data)) but significantly faster.

size_size is the number of bytes used to represent the length of the data. It must be less than Int.NATIVE_MAX.

The supported data argument types are

string(8bit)

An eight bit string.

System.Memory

A chunk of memory. The whole memory area is added.

Stdio.Buffer

A chunk of memory. The whole memory area is added.

String.Buffer

A chunk of memory. The whole memory area is added.

array

Add all elements in the array individually. Each element may be any one of the types listed here.