DocumentaciónDESCONECTAR(s)

DESCONECTAR(s)\texttt{DESCONECTAR}(s)

Nombre

DESCONECTAR - Cierra una conexion de socket.

Sinopsis

ok = DESCONECTAR(s)

Descripcion

Cierra un socket que estaba conectado o en escucha.

Se usa para finalizar ordenadamente la comunicacion y liberar el recurso asociado.

Comportamiento

  • Recibe un SOCKET por referencia.
  • Cierra la conexion o el canal abierto.
  • Retorna VERDADERO si el cierre fue correcto.

Funciones API relacionadas

  • CONECTAR()
  • ENVIAR()
  • RECIBIR()
  • ESCUCHAR()
  • ACEPTAR()

Parámetros

ParámetroTipoDescripción
sSOCKETSocket (por referencia).

Valor de retorno

LOGICO - Resultado logico.

  • VERDADERO: desconectó.
  • FALSO: en caso contrario.

Ejemplo

ejemplo.blox

//
// DESCONECTAR() - La función DESCONECTAR se usa para cerrar una conexión 
// de SOCKET ya establecida y liberar los recursos asociados. 
//
// Sintaxis: 
// DESCONECTAR(s)
//
// Recibe como parámetro una variable tipo SOCKET, la misma que fue usada 
// para establecer la conexión con CONECTAR() o ESCUCHAR().
//
// Tras llamar a DESCONECTAR, el atributo <conectado> de la variable 
// SOCKET será FALSO y no se podrá enviar ni recibir más datos a través 
// de ese socket.
//
// Ejemplo:
//      DESCONECTAR(s)
//


// CLIENTE en comunicacion TCP/IP
//
FUNCION PRINCIPAL
INICIO

    TABLA t
    NUMERICO i, fin
    LOGICO recibido
    SOCKET s

    s.ip = "127.0.0.1"
    s.port = 5555
    
    CONECTAR(s)

    SI (s.conectado) ENTONCES
        IMPRIMIR("\n\nConectado al servidor.\n")
        
        DESCONECTAR(s)
    SINO
        IMPRIMIR("\n\nNo se pudo conectar al servidor.")
    FIN_SI

FINAL