QLocalServer Class

멤버 함수 문서

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

지정된 parent 를 사용하여 새로운 로컬 소켓 서버를 생성합니다.

listen()도 참조하십시오 .

[virtual noexcept] QLocalServer::~QLocalServer()

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

서버가 삭제되기 전에, 아직 연결된 상태인 모든 클라이언트 QLocalSocket은 연결을 끊거나 다른 부모 객체에 재할당되어야 합니다.

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 에서 들어오는 연결을 수신 대기하도록 지시합니다. 서버가 이미 수신 대기 중이라면 listen()은 실패합니다. 성공 시 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

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

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

serverName(), isListening() 및 close()도 참조하십시오 .

bool QLocalServer::listen(qintptr socketDescriptor)

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

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

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 대기 중인 연결이 없는 상태에서 이 함수가 호출되면 is가 반환됩니다.

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 소켓 핸들입니다.
• INTEGRITY에서는 반환 값이 QTcpServer 소켓 디스크립터이며, 유형은 socketDescriptor 에 정의되어 있습니다.
• 그 외 모든 유닉스 계열 운영 체제에서는 유형이 수신 대기 중인 소켓을 나타내는 파일 디스크립터입니다.

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()도 참조하십시오 .