주요 콘텐츠

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

tcpclientfind

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와 함께 사용하여 연결에 액세스할 수 있습니다. 이러한 태그는 여러 함수에서 관리해야 할 클라이언트 연결이 여러 개 있을 때 유용합니다. 태그는 앱 콜백에서 연결을 찾고 액세스하는 데도 유용합니다. 태그 값을 설정하려면 tcpclientTag 속성을 사용하십시오.

    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)tcpclientSpeed 속성이 없기 때문에 빈 배열을 반환합니다.

    버전 내역

    R2024a에 개발됨

    참고 항목

    | |