2진 파일로부터 읽기 함수

데이터 타입은 함수가 2진 파일을 읽을 때 사용하는 데이터의 타입을 설정합니다.

함수는 현재 파일 위치에서 시작하는 데이터를 데이터 타입의 카운트 인스턴스로 해석합니다. 타입이 배열 또는 문자열을 포함하는 배열, 문자열, 또는 클러스터인 경우, 함수는 해당 데이터 타입의 각 인스턴스가 크기 정보를 포함하는 것으로 가정합니다. 인스턴스가 크기 정보를 포함하지 않을 경우 함수는 데이터를 잘못 해석하게 됩니다. LabVIEW가 데이터와 타입이 일치하지 않은 것으로 결정한 경우, LabVIEW는 데이터를 지정된 타입에 대한 기본값으로 설정하고 에러를 반환합니다.

대화 상자 메시지는 파일 대화 상자의 파일과 디렉토리, 또는 폴더의 리스트 위에 나타나는 메시지입니다.

파일은 참조 번호 또는 절대 파일 경로가 될 수 있습니다.

경로인 경우, 이 함수는 경로가 지정하는 파일을 엽니다. 기본으로 파일 대화 상자를 디스플레이하고 파일을 선택하도록 입력요청합니다.

빈 경로 또는 상대 경로를 지정하거나 파일이 존재하지 않을 경우, 이 함수는 에러를 반환합니다.

카운트는 읽을 데이터 원소의 개수입니다. 데이터 원소는 데이터 타입의 바이트 또는 인스턴스가 될 수 있습니다.

함수는 데이터에 카운트 데이터 원소를 반환하거나, 파일 끝에 도달한 경우 지금까지 읽은 전체 데이터 원소와 파일 끝 에러를 반환합니다. 기본으로, 함수는 하나의 데이터 원소를 반환합니다. 카운트가 –1인 경우 함수는 현재 파일 위치에서 시작하여 전체 파일을 읽습니다. 카운트가 –1보다 작을 경우, 함수는 에러를 반환합니다.

데이터를 카운트에 연결하고 이때 지정한 데이터 타입이 배열인 경우, LabVIEW가 배열의 배열을 허용하지 않기 때문에 함수는 자동으로 배열의 클러스터, 즉 클러스터 배열을 반환합니다.

파일을 32비트 정수가 아닌 데이터 타입에 카운트를 연결하면 LabVIEW는 데이터 타입을 32비트 정수로 강제변환합니다. 이것은 사용자가 의도한 데이터 양을 VI가 읽지 못할 수 있다는 것을 의미합니다. –1을 카운트에 연결하고 읽으려는 파일 크기가 너무 커서 32비트 정수로 나타낼 수 없는 경우, LabVIEW는 에러를 반환합니다.

정수의 클러스터를 카운트에 연결하면, 함수가 각 클러스터 원소마다 한 개 차원이 할당되는 다차원 배열을 반환합니다. 예를 들어, 1, 2, 3의 값을 포함하는 클러스터를 카운트에 연결하는 경우, 함수는 3D 배열을 반환하는데, 이때 첫 번째 차원은 한 개 원소를 포함하고, 두 번째 차원은 두 개 원소를 포함하고, 세 번째 차원은 세 개 원소를 포함합니다.

바이트 순서는 결과 데이터의 엔디언 형태를 설정합니다. 바이트 순서, 또는 엔디언 형태는 정수가 메모리에서 최상위 바이트에서 최하위 바이트로 또는 그 반대로 표현되는지 여부를 나타냅니다. 함수는 데이터를 쓴 순서와 동일한 바이트 순서로 데이터를 읽어야 합니다.

0	big-endian, network order (기본값)-가장 중요한 바이트가 가장 낮은 메모리 주소를 차지합니다. 이 엔디언 형태는 VxWorks와 같은 PowerPC 플랫폼에서 사용됩니다. 이 엔디언 형태는 또한 다른 플랫폼에 쓰인 데이터를 읽을 때도 사용됩니다.
1	native, host order―호스트 컴퓨터의 바이트 순서 포맷을 사용합니다. 이 엔디언 형태는 읽기와 쓰기 속도를 증가시킵니다.
2	little-endian―최하위 바이트가 가장 낮은 메모리 주소를 점유합니다. 이 엔디언 형태는 Windows, macOS, Linux에서 사용됩니다.

에러 입력은 이 노드의 실행 전에 발생한 에러 조건을 설명합니다. 이 입력은 표준 에러 입력 기능을 제공합니다.

참조 번호 출력은 함수가 읽는 파일의 참조 번호입니다. 파일에서 하려는 작업에 따라 이 출력을 다른 파일 함수에 연결할 수 있습니다. 기본은 파일 경로에 의해 참조되거나 파일 대화 상자로부터 선택되었을 경우 파일을 닫는 것입니다. 파일이 참조 번호이거나 참조 번호 출력을 다른 함수에 연결한 경우, LabVIEW는 파일을 닫기 전까지 파일이 사용 중인것으로 가정합니다.

데이터는 파일로부터 읽은 지정된 데이터 타입의 데이터를 포함합니다. 데이터는 읽은 데이터 타입과 설정된 카운트에 따라 문자열, 배열, 배열의 클러스터 또는 클러스터 배열로 구성될 수 있습니다.

파일 대화 상자를 취소하는 경우, 취소됨은 참입니다.

그렇지않으면, 이 함수가 에러를 반환한 경우에도, 취소됨은 거짓입니다.

에러 출력은 에러 정보를 포함합니다. 이 출력은 표준 에러 출력 기능을 제공합니다.