класс TCPSocket

Родитель:: IPSocket

TCPSocket представляет клиентский сокет TCP/IP.

Простой клиент может выглядеть так:

require 'socket'

s = TCPSocket.new 'localhost', 2000

while line = s.gets # Read lines from socket
  puts line         # and print them
end

s.close             # close socket when done

Публичные методы класса

gethostbyname(hostname) → [official_hostname, alias_hostnames, address_family, *address_list] Показать исходный код

static VALUE
tcp_s_gethostbyname(VALUE obj, VALUE host)
{
    rb_warn("TCPSocket.gethostbyname is deprecated; use Addrinfo.getaddrinfo instead.");
    struct rb_addrinfo *res =
        rsock_addrinfo(host, Qnil, AF_UNSPEC, SOCK_STREAM, AI_CANONNAME, Qnil);
    return rsock_make_hostent(host, res, tcp_sockaddr);
}

Вместо этого используйте Addrinfo.getaddrinfo. Этот метод устарел по следующим причинам:

Третий элемент результата — семейство адресов первого адреса. Семейства адресов остальных адресов не возвращаются.
gethostbyname() может выполняться долго и блокировать другие потоки. (GVL нельзя освободить, поскольку gethostbyname() не является потокобезопасной.)
Этот метод использует функцию gethostbyname(), уже удалённую из POSIX.

Этот метод выполняет поиск информации о хосте по имени хоста.

TCPSocket.gethostbyname("localhost")
#=> ["localhost", ["hal"], 2, "127.0.0.1"]

new(remote_host, remote_port, local_host=nil, local_port=nil, resolv_timeout: nil, connect_timeout: nil, open_timeout: nil, fast_fallback: true) Показать исходный код

static VALUE
tcp_init(int argc, VALUE *argv, VALUE sock)
{
    VALUE remote_host, remote_serv;
    VALUE local_host, local_serv;
    VALUE opt;
    static ID keyword_ids[5];
    VALUE kwargs[5];
    VALUE resolv_timeout = Qnil;
    VALUE connect_timeout = Qnil;
    VALUE open_timeout = Qnil;
    VALUE fast_fallback = Qnil;
    VALUE test_mode_settings = Qnil;

    if (!keyword_ids[0]) {
        CONST_ID(keyword_ids[0], "resolv_timeout");
        CONST_ID(keyword_ids[1], "connect_timeout");
        CONST_ID(keyword_ids[2], "open_timeout");
        CONST_ID(keyword_ids[3], "fast_fallback");
        CONST_ID(keyword_ids[4], "test_mode_settings");
    }

    rb_scan_args(argc, argv, "22:", &remote_host, &remote_serv,
                        &local_host, &local_serv, &opt);

    if (!NIL_P(opt)) {
        rb_get_kwargs(opt, keyword_ids, 0, 5, kwargs);
        if (kwargs[0] != Qundef) { resolv_timeout = kwargs[0]; }
        if (kwargs[1] != Qundef) { connect_timeout = kwargs[1]; }
        if (kwargs[2] != Qundef) { open_timeout = kwargs[2]; }
        if (kwargs[3] != Qundef) { fast_fallback = kwargs[3]; }
        if (kwargs[4] != Qundef) { test_mode_settings = kwargs[4]; }
    }

    if (fast_fallback == Qnil) {
        fast_fallback = rb_ivar_get(rb_cSocket, tcp_fast_fallback);
        if (fast_fallback == Qnil) fast_fallback = Qtrue;
    }

    return rsock_init_inetsock(sock, remote_host, remote_serv,
                               local_host, local_serv, INET_CLIENT,
                               resolv_timeout, connect_timeout, open_timeout,
                               fast_fallback, test_mode_settings);
}

Открывает TCP-соединение с remote_host на remote_port. Если указаны local_host и local_port, эти параметры используются на локальной стороне для установки соединения.

Начиная с Ruby 3.4, этот метод по умолчанию работает по алгоритму Happy Eyeballs версии 2 (RFC 8305), за исключением Windows.

Подробности об алгоритме Happy Eyeballs версии 2 см. в разделе Socket.tcp_fast_fallback=.

Чтобы метод работал так же, как в Ruby 3.3 и более ранних версиях, явно укажите параметр fast_fallback:false. Установка Socket.tcp_fast_fallback=false также отключит Happy Eyeballs версии 2 не только для этого метода, но и глобально для всех Socket.

При использовании TCPSocket.new в Windows алгоритм Happy Eyeballs версии 2 не применяется, и метод работает так же, как в Ruby 3.3 и более ранних версиях.

:resolv_timeout: Задаёт время ожидания в секундах, отсчитываемое с момента начала разрешения имени хоста.
:connect_timeout: Этот метод последовательно пытается подключиться ко всем кандидатным адресам назначения.
Параметр connect_timeout задаёт время ожидания в секундах, отсчитываемое с начала попытки подключения к последнему кандидату.
По умолчанию все попытки подключения продолжаются до истечения времени ожидания.
Если явно задан параметр fast_fallback:false,
для каждой попытки подключения устанавливается время ожидания, и любая попытка, превысившая его, отменяется.
:open_timeout: Задаёт время ожидания в секундах, отсчитываемое с начала выполнения метода.
Если это время истечёт, пока остаются адреса, попытки подключения к которым ещё не предпринимались, дальнейшие попытки выполняться не будут.
Если этот параметр указан вместе с другими параметрами времени ожидания, будет вызвано исключение ArgumentError.
:fast_fallback: Включает алгоритм Happy Eyeballs версии 2 (включён по умолчанию).

Ruby Core © 1993–2025 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.