类

GioSocket

自：2.22

描述 [src]

class Gio.Socket : GObject.Object
  implements Gio.DatagramBased, Gio.Initable {
  priv: GSocketPrivate*
}

GSocket 是一种底层的网络原语。它在可移植的 GObject 基础上，对 BSD 套接字 API 进行了大致的直接映射。它支持 UNIX 套接字实现和 Windows 上的 winsock2。

GSocket 是平台无关的基础，基于它构建了更高级的网络原语。应用程序通常不会直接使用它，而是通过 GSocketClient、GSocketService 和 GSocketConnection 等类来使用。但在某些情况下，直接使用 GSocket 可能非常有用。

GSocket 实现了 GInitable 接口，因此如果它通过 g_object_new() 等手动构建，则必须在使用该对象之前调用 g_initable_init() 并检查结果。这会在 g_socket_new() 和 g_socket_new_from_fd() 中自动完成，因此这些函数可以返回 NULL。

套接字以两种一般模式操作：阻塞或非阻塞。在阻塞模式下，所有操作（未明确指定阻塞参数的操作）将阻塞，直到请求的操作完成或有错误发生。在非阻塞模式下，所有可能导致阻塞的调用将立即返回 G_IO_ERROR_WOULD_BLOCK 错误。要了解调用何时可以成功运行，可以调用 g_socket_condition_check() 或 g_socket_condition_wait()。您还可以使用 g_socket_create_source() 并将其附加到 GMainContext 以在 I/O 可用时获得回调。请注意，所有套接字始终在系统上设置为非阻塞模式，而阻塞模式在 GSocket 中是模拟的。

在非阻塞模式下工作时，应用程序应始终能够处理获取 G_IO_ERROR_WOULD_BLOCK 错误，即使在某些其他函数声明 I/O 可用时也是如此。这种情况可能很容易发生在应用程序中的竞争条件的情况下，但也可能由其他原因引起。例如，在 Windows 上，套接字在写入返回 G_IO_ERROR_WOULD_BLOCK 之前始终被视为可写。

GSocket 可以是面向连接的，也可以是数据报基于的。对于面向连接的类型，您必须首先通过连接到地址或从一个地址接受连接来建立连接。对于无连接套接字类型，目标/源地址在每个 I/O 操作中指定或接收。

所有套接字文件描述符都被设置为在 exec 时关闭。

请注意，创建一个 GSocket 会导致程序剩余部分忽略信号 SIGPIPE。如果您正在编写使用 GSocket 的命令行工具，您可能需要考虑到，当程序尝试在关闭后写入 stdout 时，程序不会自动被杀死。

与其他GLib中的大部分API一样，GSocket本身不是线程安全的。要从多个线程并发使用一个GSocket，你必须实现自己的锁机制。

Nagle算法

从GLib 2.80版本开始，GSocket将自动为所有G_SOCKET_TYPE_STREAM套接字设置TCP_NODELAY选项。这禁用了Nagle算法，因为它在现代网络上通常弊大于利。

如果你的应用程序需要启用Nagle算法，请在构造GSocket后调用g_socket_set_option()来启用它。

socket = g_socket_new (…, G_SOCKET_TYPE_STREAM, …);
if (socket != NULL)
  {
    g_socket_set_option (socket, IPPROTO_TCP, TCP_NODELAY, FALSE, &local_error);
    // handle error if needed
  }

自版本：2.22起可用

祖先

GObject

实现

构造函数

g_socket_new

根据指定的族、类型和协议创建一个新的GSocket。如果protocol为0（G_SOCKET_PROTOCOL_DEFAULT），则使用族和类型的默认协议类型。

自：2.22

g_socket_new_from_fd

从一个原生文件描述符或Windows套接字SOCKET句柄创建一个新的GSocket

自：2.22

从GObject（43）继承的方法。

请参阅GObject 获取方法的完整列表。

从GInitable（1）继承的方法

g_initable_init

初始化实现该接口的对象。

自：2.22

信号

从GObject（1）继承的信号。

GObject::notify

当通过g_object_set_property()、g_object_set()等设置对象的一个属性值时，会发出notify信号。

类结构

struct GioSocketClass {
  GObjectClass parent_class;
  void (* _g_reserved1) (
void
  );
  void (* _g_reserved2) (
void
  );
  void (* _g_reserved3) (
void
  );
  void (* _g_reserved4) (
void
  );
  void (* _g_reserved5) (
void
  );
  void (* _g_reserved6) (
void
  );
  void (* _g_reserved7) (
void
  );
  void (* _g_reserved8) (
void
  );
  void (* _g_reserved9) (
void
  );
  void (* _g_reserved10) (
void
  );
  
}

没有可用的描述。

类成员

parent_class: GObjectClass: 没有可用的描述。
_g_reserved1: void (* _g_reserved1) ( void ): 没有可用的描述。
_g_reserved2: void (* _g_reserved2) ( void ): 没有可用的描述。
_g_reserved3: void (* _g_reserved3) ( void ): 没有可用的描述。
_g_reserved4: void (* _g_reserved4) ( void ): 没有可用的描述。
_g_reserved5: void (* _g_reserved5) ( void ): 没有可用的描述。
_g_reserved6: void (* _g_reserved6) ( void ): 没有可用的描述。
_g_reserved7: void (* _g_reserved7) ( void ): 没有可用的描述。
_g_reserved8: void (* _g_reserved8) ( void ): 没有可用的描述。
_g_reserved9: void (* _g_reserved9) ( void ): 没有可用的描述。
_g_reserved10: void (* _g_reserved10) ( void ): 没有可用的描述。

描述 [src]

Nagle算法

祖先

实现

构造函数

实例方法

从GObject（43）继承的方 法。

从GDatagramBased（5）继承的方法。

从GInitable（1）继承的方法

属性

信号

从GObject（1）继承的信号。

类结构

类成员

从GObject（43）继承的方法。