주요 콘텐츠

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

tcpclientfind

R2026b

TCP/IP 클라이언트 연결 찾기

R2024a 이후

    설명

    T = tcpclientfind는 기존 TCP/IP 클라이언트 연결을 찾아 각 연결에 해당하는 tcpclient 객체 배열을 반환합니다.

    예제

    T = tcpclientfind(Name=Value)는 하나 이상의 이름-값 인자로 지정된 속성 값과 일치하는 연결을 찾습니다. 예를 들어, T = tcpclientfind(Tag="mySensor")는 Tag 속성이 "mySensor"로 설정된 기존 TCP/IP 클라이언트 연결을 반환합니다.

    예제

    예제

    모두 축소

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

    T = tcpclientfind
    T = 
    
       tcpclient with properties:
    
                  Address: '198.51.100.255'
                     Port: 80
                      Tag: ""
        NumBytesAvailable: 0
    

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

    delete(T)

    이 명령은 tcpclient 객체를 삭제하고 클라이언트 연결을 끊습니다. 호스트에 다시 연결하려면 tcpclient를 사용하여 새 클라이언트 인터페이스를 생성해야 합니다.

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

    tcpclientfind
    ans =
    
         []

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

    T
    T = 
    
      handle to deleted tcpclient

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

    clear T

    연결에 태그를 할당하고 나중에 해당 태그를 tcpclientfind와 함께 사용하여 연결에 액세스할 수 있습니다. 이러한 태그는 여러 함수에서 관리해야 할 클라이언트 연결이 여러 개 있을 때 유용합니다. 태그는 앱 콜백에서 연결을 찾고 액세스하는 데도 유용합니다. 태그 값을 설정하려면 tcpclient의 Tag 속성을 사용하십시오.

    Tag 속성에 값을 할당하여 두 개의 TCP/IP 클라이언트 연결을 생성합니다.

    c1 = tcpclient("192.168.1.2",6000,Tag="Send");
    c2 = tcpclient("192.168.1.2",10000,Timeout=2,Tag="Receive");

    태그 "Receive"와의 연결을 찾아보세요.

    T = tcpclientfind(Tag="Receive")
    T = 
    
      tcpclient with properties:
    
                  Address: '192.168.1.2'
                     Port: 10000
                      Tag: "Receive"
        NumBytesAvailable: 0
    
      Show all properties, functions

    이름-값 인수

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

    예: tcpclientfind(Tag="Send",Port=6000)는 Tag 속성이 "Send"로 설정된 포트 6000에 대한 기존 TCP/IP 클라이언트 연결을 반환합니다.

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

    출력 인수

    모두 축소

    TCP/IP 클라이언트 연결로, tcpclient 객체 또는 tcpclient 객체 배열로 반환됩니다. 이름-값 인수 없이 tcpclientfind를 호출하면 T에는 모든 기존 연결이 포함됩니다. 그렇지 않으면 T에는 이름-값 인수로 지정한 값과 속성이 일치하는 모든 연결이 포함됩니다.

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

    • 현재 활성화된 TCP/IP 클라이언트 연결이 없습니다.

    • 기존 연결이 지정된 속성 값과 일치하지 않습니다. 예를 들어, Tag="Scope"를 지정했을 때, Tag 속성이 "Scope"인 기존 연결이 없다면 T는 비어 있습니다.

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

    버전 내역

    R2024a에 개발됨

    참고 항목

    | |