函数
GioIconnew_for_string
since: 2.20
声明 [src]
GIcon*
g_icon_new_for_string (
const gchar* str,
GError** error
)
描述 [src]
从字符串生成一个GIcon实例。如果str不是有效的字符串，则此函数会失败 - 有关讨论请参阅g_icon_to_string()。
如果您的应用程序或库提供了一个或多个GIcon实现，您需要确保在调用g_icon_new_for_string()之前，每个GType都已注册到类型系统。
Available since: 2.20
参数
str-
类型：
const gchar*通过g_icon_to_string()获得的字符串。
这些数据由函数的调用者拥有。 该值是一个以空字符终止的UTF-8字符串。 error-
类型：
GError **一个可恢复错误的返回位置。
该参数可以是 NULL。如果返回位置不是 NULL，则您必须将其初始化为空的GError*。如果没有错误，函数将通过将参数初始化为 NULL来保留其初始化状态。如果有错误，该参数将被设置为一个新的分配的 GError；调用者将负责管理该数据，并负责释放它。
返回值
类型： GIcon
实现GIcon接口的对象，或者在error被设置的情况下为NULL。
| 该函数的调用者获得数据的所有权，并负责释放它。 |