nsIStringInputStream
Provides scriptable and specialized C++-only methods for initializing a
nsIInputStream implementation with a simple character array.
SetData - assign data to the input stream (copied on assignment).
NOTE: C++ code should consider using AdoptData or ShareData to avoid
making an extra copy of the stream data.
NOTE: For JS callers, the given data must not contain null characters
(other than a null terminator) because a null character in the middle of
the data string will be seen as a terminator when the data is converted
from a JS string to a C++ character array.
| data | - stream data |
| dataLen | - stream data length (-1 if length should be computed) |
NOTE: the following methods are designed to give C++ code added control
over the ownership and lifetime of the stream data. Use with care :-)
AdoptData - assign data to the input stream. the input stream takes
ownership of the given data buffer and will nsMemory::Free it when
the input stream is destroyed.
| data | - stream data |
| dataLen | - stream data length (-1 if length should be computed) |
ShareData - assign data to the input stream. the input stream references
the given data buffer until the input stream is destroyed. the given
data buffer must outlive the input stream.
| data | - stream data |
| dataLen | - stream data length (-1 if length should be computed) |