的fscanf

读取仪器数据，而格式文本

句法

A =的fscanf（OBJ） A =的fscanf（OBJ，”格式“） A =的fscanf（OBJ，”格式'，尺寸） [A，COUNT] =的fscanf（...） [A，计数，MSG] =的fscanf（...） [A，计数，味精，datagramaddress] =的fscanf（OBJ，...） [A，计数，味精，datagramaddress，datagramport] =的fscanf（OBJ，...）

参数

`OBJ`	接口对象。
`“``格式``“`	C语言转换规格。
`尺寸`	值的数量阅读。
`一个`	从仪器读取的数据和文本格式。
`计数`	值的读取数量。
`味精`	一条消息，指示如果读操作不成功。
`datagramaddress`	数据报发件人的地址。
`datagramport`	数据报发送的端口。

描述

A =的fscanf（OBJ）从连接到该仪器中读取数据OBJ，并返回到一个。该数据被转换使用为文本％C格式。

A =的fscanf（OBJ，”格式“）读取数据并将其根据转换格式。

格式是C语言转换规范。转换规范涉及％字符和转换字符D，I，O，U，X，X，F，E，E，G，G，C和S。请参阅sscanf的文件I / O格式的规格或对更多信息的C语言手册。

A =的fscanf（OBJ，”格式'，尺寸）读取指定的由值的数量尺寸。为有效选项尺寸是

`ñ`	阅读最多`ñ`值插入的列向量。
`[M，N]`	读至多m乘n个值填充m乘n的列的顺序的矩阵。

尺寸不可能是INF并返回一个错误，如果值的指定数目不能被存储在输入缓冲器中。如果尺寸的形式是不[M，N]和字符转换被指定，那么一个返回为一个行向量。您指定的大小，以字节为单位，与输入缓冲区的InputBufferSize属性。ASCII值是一个字节。

如果OBJ是UDP对象和DatagramTerminateMode是离中，尺寸价值兑现。如果尺寸小于所述数据报的长度，只尺寸读取数值。如果尺寸比数据报的长度，将发出警告，指出一个完整的数据报前阅读尺寸值达到。

[A，COUNT] =的fscanf（...）返回读取值的数量计数。

[A，计数，MSG] =的fscanf（...）返回一条警告消息味精如果读操作没有成功完成。

[A，计数，味精，datagramaddress] =的fscanf（OBJ，...）返回的数据包地址datagramaddress如果OBJ是一个UDP对象。如果超过一个数据报被读取，datagramaddress是“”。

[A，计数，味精，datagramaddress，datagramport] =的fscanf（OBJ，...）返回数据包端口datagramport如果OBJ是一个UDP对象。如果超过一个数据报被读取，datagramport是[]。

例子

创建串口对象小号在Windows^®机及连接小号到Tektronix^®TDS示波器210，其被显示的正弦波。

S =串行（ 'COM1'）;FOPEN（S）

使用fprintf中功能配置的范围以测量正弦波的峰 - 峰电压，返回测量类型，并返回峰 - 峰值电压。

fprintf中的（S， 'MEASUREMENT：IMMED：TYPE PK2PK'）fprintf中的（S， 'MEASUREMENT：IMMED：TYPE？'）fprintf中的（S， 'MEASUREMENT：IMMED：VAL'）

因为对于默认值ReadAsyncMode属性连续与两个查询命令相关联的数据自动地返回到输入缓冲器。

s.BytesAvailable ANS = 13

用的fscanf读取测量类型。当读取第一终止该操作将完成。

MEAS =的fscanf（S）MEAS = PK2PK

用的fscanf读取峰 - 峰值电压为浮点数，并且排除终止子。

pk2pk =的fscanf（S， '％E'，6）pk2pk = 2.0200

断开小号从范围，并且删除小号从存储器和工作区。

FCLOSE（S）删除（S）清零S

提示

在您可以从仪器读取数据时，它必须连接到OBJ与FOPEN功能。阿连接的接口对象具有一个状态财产价值打开。如果您尝试执行读操作时，则返回错误OBJ未连接到仪器上。

如果味精不包括作为输出参数和读操作没有成功，则警告消息被返回给命令行。

该ValuesReceived每次 - 属性值增加值的数量读 - 包括终止子的fscanf发出。

注意

为了得到一个选项列表，你可以在一个函数中使用，按标签在MATLAB输入功能键后^®命令行。名单的扩大，并且可以滚动选择的属性或值。有关使用这一先进的制表符完成功能的信息，请参阅使用Tab键完成的功能。

规则完成读操作用的fscanf

读操作与的fscanf阻止访问MATLAB命令行直到

终结器读取。对于串口，TCPIP，UDP和VISA串行对象，终止由给定终结者属性。如果终结者是空的，的fscanf当其他条件被满足时将完成执行和返回控制。对于UDP对象，DatagramTerminateMode一定是离。
对于所有其他接口的对象，终止由给定EOSCharCode属性。
由指定的时间超时所有权转移。
值的数目由指定尺寸被读取。对于UDP对象，DatagramTerminateMode一定是离。
数据报被接收（用于UDP对象，只有当DatagramTerminateMode是上）。
输入缓冲器被充满。
该EOI线确定（仅GPIB和VXI仪器）。