方法

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;调用者将占用数据并负责释放它。

返回值

类型: char*

在遇到任何停止字符之前读取的数据的字符串。将length设置为#gsize以获取字符串的长度。在发生错误时,此函数将返回NULL

该方法调用的调用者负责获取返回的数据,并负责释放它。
这是一个以NUL结尾的UTF-8字符串。