Reads the specified .tdms file and returns data in a format specified by the data type input.


icon

Inputs/Outputs

  • ci64.png count (-1) —

    count specifies the maximum number of data elements you want to read. The default is -1, which specifies that this function reads all data elements. If the disable buffering? input of the TDMS Advanced Open function is TRUE, the value of (count * the length of data type) must be a multiple of the sector size.

    You can calculate the size, in bytes, that this function reads by multiplying the value of count by the number of bytes of data type. For example, if the value of count is 512 and data type is an unsigned 16-bit integer, then you can calculate the size that this function reads as follows: 512×(16÷8) = 1024 bytes.

  • cgnrn.png tdms file —

    tdms file specifies a reference number to the .tdms file on which to perform the operation. Use the TDMS Advanced Open function to open the refnum.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • cu8.png data type —

    data type specifies the type of data on which you want to perform the operation. This input accepts integers, floating-point numbers, Booleans, and timestamps.

    Note You can wire the following floating-point numbers to this input:
    • Single-precision and double-precision floating-point numbers
    • Complex single-precision and double-precision floating-point numbers
    • (Windows) Extended-precision floating-point numbers
  • ignrn.png tdms file out —

    tdms file out returns a TDMS file reference to the .tdms file on which you performed the operation.

  • i1du8.png data —

    data returns the data this function reads from the .tdms file in the specified data type.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

  • ibool.png read process finished? —

    read process finished? indicates whether the reading process finished or not.

    Tip Use this Boolean value as one of the stop conditions for a While Loop. For example, you can put the TDMS Advanced Synchronous Read function in the While Loop to read data infinitely until the value of read process finished? becomes TRUE. This value becomes TRUE when the TDMS Advanced Synchronous Read function reaches the end of a .tdms file.

    • Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\File IO\TDMS\Advanced Read and Write\Synchronous Read and Write\TDMS Advanced Synchronous Read.vi