주요 콘텐츠

이 페이지는 기계 번역을 사용하여 번역되었습니다. 영어 원문을 보려면 여기를 클릭하십시오.

tcpserverfind

R2026b

TCP/IP 서버 찾기

R2024a 이후

    설명

    T = tcpserverfind는 기존 TCP/IP 서버를 찾아 각 서버에 해당하는 tcpserver 객체 배열을 반환합니다.

    예제

    T = tcpserverfind(Name=Value)는 하나 이상의 이름-값 인수로 지정된 속성 값과 일치하는 서버를 찾습니다. 예를 들어, T = tcpserverfind(Tag="Scope")는 Tag 속성이 "Scope"로 설정된 기존 서버들을 반환합니다.

    예제

    예제

    모두 축소

    MATLAB® 작업 공간에 존재하거나 클래스 속성 또는 앱 속성으로 저장된 tcpserver 연결이 있는 경우 다른 함수 또는 앱 콜백에서 tcpserver 객체에 액세스하지 못할 수 있습니다. 이 경우 tcpserverfind를 사용하여 연결을 찾아 삭제할 수 있습니다.

    T = tcpserverfind
    T = 
    
      TCPServer with properties:
    
            ServerAddress: "127.0.0.1"
               ServerPort: 6000
                Connected: 0
            ClientAddress: ""
               ClientPort: []
                      Tag: "Analyzer"
        NumBytesAvailable: 0
    

    이 연결을 닫으려면 T를 삭제합니다.

    delete(T)

    이 명령은 tcpserver 객체를 삭제하고 서버와의 연결을 끊습니다. 서버에 다시 연결하려면 tcpserver로 새로운 서버 인터페이스를 만들어야 합니다.

    삭제 후 tcpserverfind를 호출하여 기존 연결이 없음을 확인합니다.

    tcpserverfind
    ans =
    
         []

    변수 T가 여전히 작업 공간에 존재하지만 이제는 유효하지 않은 핸들입니다.

    T
    T = 
    
      handle to deleted tcpserver

    tcpserver는 핸들 객체이므로 인터페이스를 삭제한 후에도 변수가 유지됩니다. (이 유형의 객체에 대한 자세한 내용은 핸들 객체 동작 항목을 참조하십시오.) clear를 사용하여 작업 공간에서 유효하지 않은 핸들을 제거할 수 있습니다.

    clear T

    TCP/IP 서버에 태그를 할당하고, 나중에 tcpserverfind와 함께 해당 태그를 사용하여 서버에 액세스할 수 있습니다. 이러한 태그는 여러 함수에 걸쳐 관리해야 할 서버가 여러 대일 때 유용합니다. 태그는 앱 콜백에서 서버를 찾아 액세스하는 데에도 유용합니다. 태그 값을 설정하려면 tcpcserver의 Tag 속성을 사용하십시오.

    Tag 속성에 값을 할당하여 두 개의 TCP/IP 서버를 생성합니다.

    s1 = tcpserver("localhost",4000,Tag="Scope");
    s2 = tcpserver("localhost",6000,Tag="Analyzer");

    "Analyzer" 태그가 붙은 서버를 찾으세요.

    T = tcpserverfind(Tag="Analyzer")
    T = 
    
      TCPServer with properties:
    
            ServerAddress: "127.0.0.1"
               ServerPort: 6000
                Connected: 0
            ClientAddress: ""
               ClientPort: []
                      Tag: "Analyzer"
        NumBytesAvailable: 0
    
      Show all properties, functions

    이름-값 인수

    선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

    예: tcpserverfind(Tag="Scope",ServerPort=6000)는 Tag 속성이 "Scope"로 설정된, 포트 6000을 사용하는 기존 서버들을 반환합니다.

    tcpserverfind의 경우, tcpserver 객체의 하나 이상의 속성을 이름-값 인수로 사용하여 찾고자 하는 서버의 특성을 지정할 수 있습니다.

    출력 인수

    모두 축소

    TCP/IP 서버로, tcpserver 객체 또는 tcpserver 객체 배열로 반환됩니다. 이름-값 인수를 지정하지 않고 tcpserverfind를 호출하면, T에는 존재하는 모든 TCP/IP 서버가 포함됩니다. 그렇지 않은 경우, T에는 이름-값 인수로 지정한 값과 속성이 일치하는 모든 서버가 포함됩니다.

    T는 다음의 경우 비어 있습니다.

    • 현재 실행 중인 TCP/IP 서버가 없습니다.

    • 지정된 속성 값과 일치하는 서버가 없습니다. 예를 들어, Tag="Scope"를 지정했는데 Tag 속성이 "Scope"인 서버가 존재하지 않는다면, T는 비어 있게 됩니다.

    • tcpserver 객체가 가지고 있지 않은 속성을 매칭하려고 합니다. 예를 들어, tcpserverfind(Speed=14400)는 tcpserver에 Speed 속성이 없기 때문에 빈 배열을 반환합니다.

    버전 내역

    R2024a에 개발됨

    참고 항목

    | |