DocumentaciónESCUCHAR(s)

ESCUCHAR(s)\texttt{ESCUCHAR}(s)

Nombre

ESCUCHAR - Pone un socket en modo servidor.

Sinopsis

ok = ESCUCHAR(s)

Descripcion

Configura un socket para quedar a la espera de conexiones entrantes.

Es el paso previo a ACEPTAR() cuando se construye un servidor simple dentro del runtime.

Comportamiento

  • Recibe un SOCKET por referencia.
  • Lo deja en estado de escucha.
  • Retorna VERDADERO si pudo comenzar a escuchar.

Funciones API relacionadas

  • ACEPTAR()
  • DESCONECTAR()
  • OBTENER_IP()

Parámetros

ParámetroTipoDescripción
sSOCKETSocket (por referencia).

Valor de retorno

LOGICO - Resultado logico.

  • VERDADERO: quedó escuchando.
  • FALSO: en caso contrario.

Ejemplo

ejemplo.blox
//
// ESCUCHAR() - La función ESCUCHAR prepara un socket para actuar como 
// servidor, permitiendo aceptar conexiones entrantes de clientes en el 
// puerto y dirección IP configurados.
//
// Recibe como parámetro una variable tipo SOCKET, que representa al 
// servidor.
//
// Ejemplo:
//      SOCKET servidor
//      servidor.ip = "0.0.0.0"
//      servidor.port = 8080
//      ESCUCHAR(servidor)
//
// El resultado de este comando se almacena en el atributo <conectado> 
// de la variable SOCKET.
//


// SERVIDOR en comunicacion TCP/IP
//
FUNCION PRINCIPAL
INICIO "SERVIDOR TCP"

    SOCKET srv, client
    srv.ip = "127.0.0.1"
    srv.port = 5555

    TABLA datos
    NUMERICO i
    LOGICO sts

    ESCUCHAR(srv)

    IMPRIMIR("\nEsperando conexion del CLIENTE...\n\n")

    ...

    DESCONECTAR(srv)
    IMPRIMIR("\n\SERVIDOR terminado.")
FINAL