QSctpSocket Class
La clase QSctpSocket proporciona un socket SCTP. Más información...
| Encabezado: | #include <QSctpSocket> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
| Heredan: | QTcpSocket |
- Lista de todos los miembros, incluidos los heredados
- QSctpSocket forma parte de la API de programación de redes.
Funciones públicas
| QSctpSocket(QObject *parent = nullptr) | |
| virtual | ~QSctpSocket() |
| bool | isInDatagramMode() const |
| int | maximumChannelCount() const |
| QNetworkDatagram | readDatagram() |
| void | setMaximumChannelCount(int count) |
| bool | writeDatagram(const QNetworkDatagram &datagram) |
Funciones públicas reimplementadas
| virtual void | close() override |
| virtual void | disconnectFromHost() override |
Funciones protegidas reimplementadas
| virtual qint64 | readData(char *data, qint64 maxSize) override |
| virtual qint64 | readLineData(char *data, qint64 maxlen) override |
Descripción detallada
El SCTP (Stream Control Transmission Protocol) es un protocolo de la capa de transporte que desempeña una función similar a la de los populares protocolos TCP y UDP. Al igual que el UDP, el SCTP está orientado a mensajes, pero garantiza un transporte fiable y en secuencia de los mensajes con control de congestión, al igual que el TCP.
El SCTP es un protocolo orientado a la conexión que permite la transmisión simultánea y completa de múltiples flujos de datos entre puntos finales. Esta transmisión multihilo permite que los datos se envíen por canales independientes, de modo que, si se produce una pérdida de datos en un flujo, la entrega de los demás flujos no se verá afectada.
Al estar orientado a mensajes, el SCTP transporta una secuencia de mensajes, en lugar de transportar un flujo ininterrumpido de bytes como hace el TCP. Al igual que en el UDP, en el SCTP un remitente envía un mensaje en una sola operación, y ese mismo mensaje se transmite al proceso de la aplicación receptora en una sola operación. Pero, a diferencia del UDP, la entrega está garantizada.
También admite el «multihoming», lo que significa que un punto final conectado puede tener asociadas direcciones IP alternativas para sortear fallos de red o condiciones cambiantes.
QSctpSocket es una subclase de uso práctico de ` QTcpSocket ` que permite emular un flujo de datos TCP sobre SCTP o establecer una conexión SCTP para un servicio de datagramas fiable.
QSctpSocket puede funcionar en uno de estos dos modos:
- Flujo continuo de bytes (emulación de TCP).
- Modo de datagramas multihilo.
Para configurar el modo de flujo continuo de bytes, instancie QSctpSocket y llame a ` setMaximumChannelCount()` con un valor negativo. Esto permite utilizar QSctpSocket como un ` QTcpSocket` con búfer normal. Puedes llamar a ` connectToHost()` para iniciar la conexión con el punto final, a ` write()` para transmitir y a ` read()` para recibir datos del par, pero no podrás distinguir los límites de los mensajes.
Por defecto, QSctpSocket funciona en modo datagrama. Antes de conectarse, llame a ` setMaximumChannelCount()` para establecer el número máximo de canales que la aplicación está preparada para admitir. Este número es un parámetro negociado con el punto final remoto y su valor puede estar limitado por el sistema operativo. El valor por defecto, 0, indica que se utilice el valor del par. Si ambos extremos tienen valores por defecto, el número de canales de conexión dependerá del sistema. Tras establecer una conexión, puede obtener el número real de canales llamando a readChannelCount() y writeChannelCount().
QSctpSocket *socket = new QSctpSocket(this);
socket->setMaxChannelCount(16);
socket->connectToHost(QHostAddress::LocalHost, 1973);
if (socket->waitForConnected(1000)) {
int inputChannels = socket->readChannelCount();
int outputChannels = socket->writeChannelCount();
....
}En modo datagrama, QSctpSocket realiza el almacenamiento en búfer de los datagramas de forma independiente para cada canal. Se puede poner en cola un datagrama en el búfer del canal actual llamando a writeDatagram() y leer un datagrama pendiente llamando a readDatagram(), respectivamente.
En el modo de datagramas se permite el uso de las funciones estándar de QIODevice, como read(), readLine() y write(), entre otras, con las mismas limitaciones que en el modo de flujo continuo de bytes.
Nota: Esta clase no es compatible con la plataforma Windows.
Véase también QSctpServer, QTcpSocket y QAbstractSocket.
Documentación de las funciones miembro
[explicit] QSctpSocket::QSctpSocket(QObject *parent = nullptr)
Crea un objeto QSctpSocket en el estado « UnconnectedState ».
Establece el modo de funcionamiento de datagramas. El argumento ` parent ` se pasa al constructor de ` QObject`.
Véase también socketType() y setMaximumChannelCount().
[virtual noexcept] QSctpSocket::~QSctpSocket()
Elimina el socket y, si es necesario, cierra la conexión.
Véase también close().
[override virtual] void QSctpSocket::close()
Reimplementa: QAbstractSocket::close().
[override virtual] void QSctpSocket::disconnectFromHost()
Reimplementa: QAbstractSocket::disconnectFromHost().
bool QSctpSocket::isInDatagramMode() const
Devuelve « true » si el socket está funcionando en modo datagrama.
Véase también setMaximumChannelCount().
int QSctpSocket::maximumChannelCount() const
Devuelve el número máximo de canales que QSctpSocket es capaz de admitir.
Un valor de 0 (el valor por defecto) significa que el número de canales de conexión lo establecería el punto final remoto.
Devuelve -1 si QSctpSocket se está ejecutando en modo de flujo continuo de bytes.
Véase también setMaximumChannelCount(), readChannelCount() y writeChannelCount().
[override virtual protected] qint64 QSctpSocket::readData(char *data, qint64 maxSize)
Reimplementa: QAbstractSocket::readData(char *data, qint64 maxSize).
QNetworkDatagram QSctpSocket::readDatagram()
Lee un datagrama del búfer del canal de lectura actual y lo devuelve como un objeto ` QNetworkDatagram `, junto con la dirección de host y el puerto del remitente. Si es posible, esta función también intentará determinar la dirección de destino del datagrama, el puerto y el número de saltos en el momento de la recepción.
En caso de fallo, devuelve un objeto ` QNetworkDatagram ` que indica ` not valid`.
Véanse también writeDatagram(), isInDatagramMode() y currentReadChannel().
[override virtual protected] qint64 QSctpSocket::readLineData(char *data, qint64 maxlen)
Reimplementa: QAbstractSocket::readLineData(char *data, qint64 maxlen).
void QSctpSocket::setMaximumChannelCount(int count)
Establece el número máximo de canales que la aplicación está preparada para admitir en modo datagrama en count. Si count es 0, se utiliza el valor del punto final para el número máximo de canales. Un valor negativo de count establece un modo de flujo continuo de bytes.
Llama a este método únicamente cuando ` QSctpSocket ` se encuentre en `UnconnectedState`.
Véase también maximumChannelCount(), readChannelCount() y writeChannelCount().
bool QSctpSocket::writeDatagram(const QNetworkDatagram &datagram)
Escribe un « datagram » en el búfer del canal de escritura actual. Devuelve «true» si se realiza correctamente; en caso contrario, devuelve «false».
Véase también readDatagram(), isInDatagramMode() y currentWriteChannel().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.