Reads binary data from a file and places the data into an array that you have already allocated without incurring a copy of the data. Unlike the Read from Binary File function, this function avoids run-time memory allocations.

이 함수의 기능은 사용자가 미리 할당하는 배열에 따라 달라집니다.

커넥터 팬은 이 다형성 함수의 기본 데이터 타입을 디스플레이합니다.


icon

입력/출력

  • cbsrn.png 참조 번호 입력 —

    참조 번호 입력은 읽으려는 파일과 연관된 파일 참조 번호입니다.

  • c1ddbl.png 데이터 입력 —

    데이터 입력은 데이터를 놓을 배열을 지정합니다. 이 함수는 배열이 보유할 수 있는 만큼의 데이터 원소를 읽고자 시도합니다. 이 함수가 지원하는 배열 및 데이터 타입에 대한 정보는 지원 테이블을 참조하십시오.

  • cenum.png 바이트 순서(0:big-endian, network order) —

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

    노트 이 함수를 사용하려면 사용자는 바이트 순서 파라미터가 LabVIEW를 실행하는 호스트 컴퓨터의 네이티브 바이트 순서와 일치하도록 설정해야 합니다. 컴퓨터가 빅 엔디안인 경우 native, host order 또는 big-endian, network order> 엔디안 형식을 선택합니다. 컴퓨터가 리틀 엔디안인 경우 native, host order 또는 little-endian 엔디안 형식을 선택합니다.
    0big-endian, network order (기본값)-가장 중요한 바이트가 가장 낮은 메모리 주소를 차지합니다. 이 엔디언 형태는 VxWorks와 같은 PowerPC 플랫폼에서 사용됩니다. 이 엔디언 형태는 또한 다른 플랫폼에 쓰인 데이터를 읽을 때도 사용됩니다.
    1native, host order―호스트 컴퓨터의 바이트 순서 포맷을 사용합니다. 이 엔디언 형태는 읽기와 쓰기 속도를 증가시킵니다.
    2little-endian―최하위 바이트가 가장 낮은 메모리 주소를 점유합니다. 이 엔디언 형태는 Windows, macOS, Linux에서 사용됩니다.
  • cerrcodeclst.png 에러 입력 —

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

  • ibsrn.png 참조 번호 출력 —

    참조 번호 출력은 함수가 읽는 파일의 참조 번호입니다. 이 출력을 다른 파일 함수에 와이어로 연결할 수 있습니다.

  • i1ddbl.png 데이터 출력 —

    데이터 출력은 파일로부터 읽은 데이터를 포함합니다. 이 출력은 유효한 데이터를 포함하기 위해 크기 조정되지 않습니다. 데이터 입력 배열이 모두 채워지기 전에 LabVIEW가 파일의 끝에 도달하는 경우, 배열은 일부 유효하지 않은 원소를 포함합니다. 읽은 원소 개수 출력을 사용하여 데이터 출력에서 유효한 데이터의 정확한 양을 알 수 있습니다. 데이터 입력 배열이 가득 차기 전 LabVIEW가 파일의 끝에 도달하지 않는 경우, LabVIEW는 파일 포인터를 읽기가 끝난 지점에 두어 마지막 읽기가 멈춘 곳에서 다음 번 읽기가 시작되도록 합니다.

  • ii32.png 읽은 원소 개수 —

    읽은 원소 개수는 파일의 데이터와 교체된 데이터 입력 배열에 있는 원소의 전체 개수를 반환합니다.

  • ierrcodeclst.png 에러 출력 —

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

    • 다음 블록다이어그램은 이 함수가 미리 할당된 배열과 작동하는 예를 보여줍니다. LabVIEW는 [미리 할당된 2진 파일로부터 읽기] 함수가 실행될 때마다 파일로부터 읽어 온 데이터를 동일한 배열에 놓습니다.

    미리 할당된 2진 파일로부터 읽기 지원

    이 함수는 데이터를 놓도록 연결한 배열에 다양한 레벨의 지원을 제공합니다:

    완벽하게 지원됩니다. 함수에 새로운 할당이 필요하지 않기 때문에 [2진 파일로부터 읽기] 함수보다 더 빠를 수 있습니다.

    지원됩니다. 함수에 새로운 할당 및 복사본이 필요하기 때문에 [2진 파일로부터 읽기] 함수보다 더 느릴 수 있습니다.

    함수에서 허용되지 않습니다.

    다음 테이블은 데이터 입력에 연결한 배열이 특정 테이터 타입을 포함하는 특정 배열 또는 배열의 슬라이스일 때의 지원에 대해 설명합니다.

    데이터 타입배열연속 배열 슬라이스비연속 배열 슬라이스1
    정수
    단정도 부동소수
    배정도 부동소수
    확장 정밀도, 부동 소수점 숫자²
    복소수 단정도 부동소수
    복소수 배정도 부동소수
    복잡한 확장 정밀도, 부동 소수점 숫자²
    고정 소수점 숫자²
    불리언
    문자열
    다른 모든 데이터 타입
    노트
    1. LabVIEW는 비연속 배열 슬라이스의 메모리 복제본을 만들어야 합니다. 그러므로 비연속 배열 슬라이스를 데이터 입력에 연결하는 경우, [미리 할당된 2진 파일로부터 읽기]는 [2진 파일로부터 읽기] 함수보다 더 빠르지 않습니다.
    2. [미리 할당된 2진 파일로부터 읽기] 함수는 확장형 정밀도, 복소수 확장형 정밀도 및 고정 소수점 데이터를 받습니다 그러나 이 함수는 기존 할당에 데이터를 넣을 수 없기 때문에 이진 파일에서 읽기 함수처럼 이러한 데이터 유형이 포함된 새 복사본을 위한 메모리를 할당합니다.

    또한 이 함수는 테이블에 있는 각 데이터 타입을 배열에 포함되지 않은 스칼라 값으로 모두 지원합니다.