方法
GioDataInputStreamread_until
已弃用:2.56
声明 [src]
char*
g_data_input_stream_read_until (
GDataInputStream* stream,
const gchar* stop_chars,
gsize* length,
GCancellable* cancellable,
GError** error
)
描述 [src]
从数据输入流中读取一个字符串,直到遇到第一个停止字符。
请注意,与g_data_input_stream_read_until_async()不同,此函数会消费找到的停止字符。
不要在新代码中使用此函数。其功能与g_data_input_stream_read_until_async()不一致。这两个函数将在未来的版本中标记为已弃用。请改用g_data_input_stream_read_upto()
,但请注意,该函数不会消费停止字符。
自2.56版弃用
改用g_data_input_stream_read_upto()
,它对停止字符的行为更一致。
参数
stop_chars
-
类型:
const gchar*
终止读取的字符。
数据由方法的调用者拥有。 这是一个以NUL结尾的UTF-8字符串。 length
-
类型:
gsize*
获取读取数据长度的#gsize。
该参数将由函数设置。 该参数可以是 NULL
。 cancellable
-
类型:
GCancellable
可选的
GCancellable
对象,NULL
表示忽略。该参数可以是 NULL
。数据由方法的调用者拥有。 error
-
类型:
GError **
一个可恢复错误的返回位置。
该参数可以是 NULL
。如果返回位置不为 NULL
,则必须将其初始化为空GError%
。如果没有任何错误,方法会将该参数保留为 NULL
。发生错误时,该参数将被设置为一个新的 GError
;调用者将占用数据并负责释放它。