Method
GioDataInputStreamread_until
Declaration
char*
g_data_input_stream_read_until (
GDataInputStream* stream,
const gchar* stop_chars,
gsize* length,
GCancellable* cancellable,
GError** error
)
Description
Reads a string from the data input stream, up to the first occurrence of any of the stop characters.
Note that, in contrast to g_data_input_stream_read_until_async(), this function consumes the stop character that it finds.
Don’t use this function in new code. Its functionality is
inconsistent with g_data_input_stream_read_until_async(). Both
functions will be marked as deprecated in a future release. Use
g_data_input_stream_read_upto()
instead, but note that that function
does not consume the stop character.
Deprecated since: | 2.56 |
Use |
Parameters
stop_chars |
const gchar* |
Characters to terminate the read. |
|
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
length |
gsize* |
A #gsize to get the length of the data read in. |
|
The argument will be set by the function. | |
The argument can be NULL . | |
cancellable |
GCancellable |
Optional |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
error |
GError ** |
The return location for a GError* , or NULL . |
Return value
Returns: | char* |
A string with the data that was read
before encountering any of the stop characters. Set |
|
The caller of the method takes ownership of the data, and is responsible for freeing it. | |
The value is a NUL terminated UTF-8 string. |