QLocalServer Class

멤버 함수 문서

[explicit] QLocalServer::QLocalServer(QObject *parent = nullptr)

주어진 parent 을 사용하여 새 로컬 소켓 서버를 만듭니다.

listen()도 참조하세요 .

[virtual noexcept] QLocalServer::~QLocalServer()

QLocalServer 객체를 삭제합니다. 서버가 연결을 수신 대기 중이면 자동으로 닫힙니다.

서버가 삭제되기 전에 아직 연결되어 있는 모든 클라이언트 QLocal소켓은 연결을 끊거나 부모를 다시 지정해야 합니다.

close()도 참조하세요 .

[protected, since 6.8] void QLocalServer::addPendingConnection(QLocalSocket *socket)

이 함수는 QLocalServer::incomingConnection()에서 호출하여 socket 을 보류 중인 수신 연결 목록에 추가합니다.

이 함수는 Qt 6.8에 도입되었습니다.

incomingConnection() 및 newConnection()도 참조하십시오 .

void QLocalServer::close()

수신 연결에 대한 수신 대기 중지. 기존 연결은 영향을 받지 않지만 새 연결은 거부됩니다.

isListening() 및 listen()도 참조하세요 .

QString QLocalServer::errorString() const

serverError()에서 보고된 현재 오류에 적합한 사람이 읽을 수 있는 메시지를 반환합니다. 적절한 문자열을 사용할 수 없으면 빈 문자열이 반환됩니다.

serverError()도 참조하세요 .

QString QLocalServer::fullServerName() const

서버가 수신 대기 중인 전체 경로를 반환합니다.

참고: 플랫폼에 따라 다릅니다.

listen() 및 serverName()도 참조하세요 .

[virtual] bool QLocalServer::hasPendingConnections() const

서버에 보류 중인 연결이 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

nextPendingConnection() 및 setMaxPendingConnections()도 참조하세요 .

[virtual protected] void QLocalServer::incomingConnection(quintptr socketDescriptor)

이 가상 함수는 새 연결을 사용할 수 있을 때 QLocalServer 에 의해 호출됩니다. socketDescriptor 은 수락된 연결의 기본 소켓 설명자입니다.

기본 구현은 QLocalSocket 을 생성하고 소켓 기술자를 설정한 다음 QLocalSocket 을 보류 중인 연결의 내부 목록에 저장합니다. 마지막으로 newConnection()가 전송됩니다.

연결이 가능할 때 서버의 동작을 변경하려면 이 함수를 다시 구현하세요.

newConnection(), nextPendingConnection() 및 QLocalSocket::setSocketDescriptor()도 참조하세요 .

bool QLocalServer::isListening() const

서버가 수신 연결을 수신 대기 중이면 true, 그렇지 않으면 false를 반환합니다.

listen() 및 close()도 참조하세요 .

bool QLocalServer::listen(const QString &name)

서버에 name 에서 들어오는 연결을 수신 대기하도록 지시합니다. 서버가 현재 수신 대기 중이면 false를 반환합니다. 성공하면 참을 반환하고 그렇지 않으면 거짓을 반환합니다.

name 는 단일 이름일 수 있으며 QLocalServer 는 올바른 플랫폼별 경로를 결정합니다. serverName()는 listen에 전달된 이름을 반환합니다.

일반적으로는 "foo"와 같은 이름을 전달하지만, Unix에서는 "/tmp/foo"와 같은 경로일 수도 있고, Windows에서는 "\\.\pipe\foo"와 같은 파이프 경로일 수도 있습니다.

serverName(), isListening() 및 close()도 참조하세요 .

bool QLocalServer::listen(qintptr socketDescriptor)

서버가 socketDescriptor 에서 들어오는 연결을 수신 대기하도록 지시합니다. 이 속성은 서버가 현재 수신 대기 중이면 false 을 반환합니다. 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 소켓은 별도의 플랫폼별 함수가 호출되지 않은 상태에서 새 연결을 수락할 준비가 되어 있어야 합니다. 소켓은 비차단 모드로 설정됩니다.

serverName(), fullServerName()는 플랫폼에서 이 옵션을 지원하는 경우 이름이 포함된 문자열을 반환하고, 그렇지 않으면 빈 QString 을 반환합니다. 특히 Linux에서 지원하는 추상 네임스페이스의 소켓 주소에 인쇄할 수 없는 문자가 포함된 경우 유용한 이름을 반환하지 않습니다.

isListening() 및 close()도 참조하세요 .

[since 6.3] int QLocalServer::listenBacklogSize() const

수락할 연결의 백로그 큐 크기를 반환합니다.

이 함수는 Qt 6.3에 도입되었습니다.

setListenBacklogSize()도 참조하세요 .

int QLocalServer::maxPendingConnections() const

수락 대기 중인 최대 연결 수를 반환합니다. 기본값은 30개입니다.

setMaxPendingConnections() 및 hasPendingConnections()도 참조하세요 .

[signal] void QLocalServer::newConnection()

이 신호는 새 연결을 사용할 수 있을 때마다 발신됩니다.

hasPendingConnections() 및 nextPendingConnection()도 참조하세요 .

[virtual] QLocalSocket *QLocalServer::nextPendingConnection()

다음 보류 중인 연결을 연결된 QLocalSocket 객체로 반환합니다.

이 소켓은 서버의 자식으로 생성되므로 QLocalServer 객체가 삭제되면 자동으로 삭제됩니다. 그래도 메모리 낭비를 피하기 위해 객체가 완료되면 명시적으로 삭제하는 것이 좋습니다.

nullptr 보류 중인 연결이 없을 때 이 함수를 호출하면 반환됩니다.

hasPendingConnections(), newConnection(), incomingConnection()도 참조하세요 .

[static] bool QLocalServer::removeServer(const QString &name)

listen() 호출을 실패하게 만들 수 있는 모든 서버 인스턴스를 제거하고 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 이 함수는 이전 서버 인스턴스가 정리되지 않은 경우 크래시에서 복구하기 위한 함수입니다.

Windows에서는 이 함수가 아무 작업도 수행하지 않으며, Unix에서는 name 에 의해 지정된 소켓 파일을 제거합니다.

QAbstractSocket::SocketError QLocalServer::serverError() const

마지막으로 발생한 오류 유형 또는 NoError 를 반환합니다.

errorString()도 참조하세요 .

QString QLocalServer::serverName() const

서버가 연결을 수신 대기 중이면 서버 이름을 반환하고, 그렇지 않으면 QString()을 반환합니다.

listen() 및 fullServerName()도 참조하세요 .

[since 6.3] void QLocalServer::setListenBacklogSize(int size)

수락할 연결의 백로그 큐 크기를 size 로 설정합니다. 운영 체제에서 이 값을 줄이거나 무시할 수 있습니다. 기본적으로 큐 크기는 50입니다.

이 함수는 Qt 6.3에 도입되었습니다.

listenBacklogSize()도 참조하세요 .

void QLocalServer::setMaxPendingConnections(int numConnections)

허용 대기 중인 최대 연결 수를 numConnections 로 설정합니다. QLocalServer 은 nextPendingConnection()이 호출되기 전에 numConnections 수신 연결을 더 이상 허용하지 않습니다.

참고: QLocalServer 이 최대 보류 중인 연결 수에 도달하면 새 연결 수락을 중지하지만 운영 체제에서는 여전히 대기열에 유지하여 클라이언트가 연결되었음을 알리는 결과를 초래할 수 있습니다.

maxPendingConnections() 및 hasPendingConnections()도 참조하세요 .

qintptr QLocalServer::socketDescriptor() const

서버가 수신 명령을 수신 대기하는 데 사용하는 네이티브 소켓 기술자를 반환하거나 서버가 수신 대기 중이 아닌 경우 -1을 반환합니다.

디스크립터의 유형은 플랫폼에 따라 다릅니다:

• Windows에서 반환되는 값은 Winsock 2 소켓 핸들입니다.
• 무결성에서 반환되는 값은 QTcpServer 소켓 기술자이며 유형은 socketDescriptor 에 의해 정의됩니다.
• 다른 모든 UNIX 계열 운영 체제에서 유형은 수신 소켓을 나타내는 파일 기술자입니다.

listen()도 참조하세요 .

QLocalServer::SocketOptions QLocalServer::socketOptions() const

소켓에 설정된 소켓 옵션을 반환합니다.

setSocketOptions()도 참조하세요 .

bool QLocalServer::waitForNewConnection(int msec = 0, bool *timedOut = nullptr)

최대 msec 밀리초 동안 또는 들어오는 연결을 사용할 수 있을 때까지 기다립니다. 연결이 가능하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 작업 시간이 초과되고 timedOut 이 nullptr 이 아닌 경우 *timedOut이 true로 설정됩니다.

이것은 차단 함수 호출입니다. 함수가 반환될 때까지 전체 애플리케이션이 응답을 중지하므로 단일 스레드 GUI 애플리케이션에서는 사용하지 않는 것이 좋습니다. waitForNewConnection()은 사용 가능한 이벤트 루프가 없을 때 주로 유용합니다.

차단하지 않는 대안은 newConnection() 신호에 연결하는 것입니다.

msec가 -1이면 이 함수는 시간 초과되지 않습니다.

hasPendingConnections() 및 nextPendingConnection()도 참조하세요 .