函数

GioNetworkAddressparse

自：2.22

声明 [源]

GSocketConnectable*
g_network_address_parse (
  const gchar* host_and_port,
  guint16 default_port,
  GError** error
)

描述 [源]

创建一个新的 GSocketConnectable，用于连接到指定的 hostname 和 port。如果解析 host_and_port 失败，可能会失败并返回 NULL。

host_and_port 可以是多种公认格式的任何一种；IPv6 地址，IPv4 地址，或域名（在这种情况下将执行 DNS 查找）。支持对所有地址类型进行 [] 引号引用。可以通过冒号以正常方式指定端口覆盖。

如果 host_and_port 中未指定端口，则将使用 default_port 作为连接的端口号。

一般情况下，期望 host_and_port 由用户提供（使他们能够提供主机名，以及在必要时提供端口覆盖），并且期望 default_port 由应用程序提供。

(host_and_port 的端口号部分还可以指定为服务名称而不是数字端口号，但此功能已弃用，因为它依赖于 /etc/services 的内容，这通常在其他平台（如 Linux）上相对稀疏。)

自可用：2.22

参数

host_and_port

类型： const gchar*

主机名和可选端口号。

数据由函数调用者拥有。
该值是一个以 NUL 结尾的 UTF-8 字符串。
default_port

类型： guint16

如果不是在 host_and_port 中，将用作默认端口号。

error

类型： GError **

可用于恢复错误的返回位置的指针。

该参数可以是 NULL。
如果返回位置不是 NULL，则必须将其初始化为 NULL GError*。
如果没有错误，函数将保留初始化的参数为 NULL。
如果出错，则参数将设置为新建的 GError；调用者将拥有该数据，并负责释放它。

返回值

类型： GNetworkAddress

新的 GNetworkAddress，或者在错误的情况下为 NULL。

函数调用者将拥有该数据，并负责释放它。