Extract a length-prefixed string into the specified variable.
Assign to the specified variable the string comprised of the length of the string (see getLength) and the string data (see getUint8), update the cursor location, and return a reference to this stream. If this stream is initially invalid, this operation has no effect. If this function otherwise fails to extract a valid value, this stream is marked invalid and the value of variable is undefined.
a reference to this stream
| Name | Description |
|---|---|
| variable | destination for the extracted string |