流

(待移除)将文本写入仪器

这串行，蓝牙，tcpip，udp，签证,通用接口总线对象函数将在未来的版本中被删除。使用串口，蓝牙，tcpclient，tcpserver，udpport,visadev对象的功能。有关更多信息，请参见兼容性的考虑．

语法

流(obj, cmd) 流(obj。”格式”、“cmd”) 流(obj, cmd的。”模式”) 流(obj。”格式”、“cmd”、“模式”)

参数

`obj`	一个接口对象。
`“cmd”`	写在乐器上的弦。
`＇``格式``＇`	C语言转换规范。
`＇``模式``＇`	指定数据是同步写入还是异步写入。

描述

流(obj, cmd)写入字符串cmd连接到的仪器obj．默认格式为% s \ n．写操作是同步的，并且会阻塞命令行，直到执行完成。

流(obj。”格式”、“cmd”)使用指定的格式写入字符串格式．

格式是C语言转换规范。转换规范包括％字符和转换字符d, i, o, u, x, x, f, e, e, g, g, c, ssprintf文件I/O格式规范或C手册获取更多信息。

流(obj, cmd的。”模式”)使用指定的命令行访问权限写入字符串模式．如果模式是同步，cmd同步写入，并且命令行被阻塞。如果模式是异步，cmd是异步写入的，并且命令行不会被阻塞。如果模式不指定，则写操作是同步的。

流(obj。”格式”、“cmd”、“模式”)使用指定的格式写入字符串。如果模式是同步，cmd是同步写的。如果模式是异步，cmd是异步写的。

例子

创建串口对象年代,连接年代在Windows^®机器到Tektronix^®tds210示波器，并编写RS232吗?命令流函数。RS232吗?指示范围返回串口通信设置。

s =串行(“COM1”);fopen(s) fprintf(s，'RS232?') settings = fscanf(s) settings = 9600;1;0

因为的默认格式流是% s \ n中指定的终止符《终结者》属性被自动写入。但是，在某些情况下，您可能希望禁止写入终止符。为此，必须显式地为不包含结束符的数据指定格式，或将结束符配置为空。

流(年代,“% s”、“RS232 ?”)

提示

在你可以给仪器写文字之前，它必须被连接obj与打开外部文件函数。连接的接口对象具有状态属性值的开放．当您试图执行写操作时，将返回错误obj未连接到仪器上。

的ValuesSent属性值随每次写入的值的数量而增加流发行。

如果输出缓冲区不能容纳所有要写入的数据，则会发生错误。属性可以指定输出缓冲区的大小OutputBufferSize财产。

流函数将返回错误消息flowcontrol财产硬件在串行对象上，并且没有检测到硬件连接。如果设备没有连接，或者连接的设备没有声明已经准备好接收数据，就会发生这种情况。检查远程设备的状态和流量控制设置，看看硬件流量控制是否在MATLAB中导致错误^®．

请注意

如果您想检查设备是否断言它已经准备好接收数据，请设置FlowControl来没有一个．一旦你连接到设备，检查PinStatus结构ClearToSend．如果ClearToSend是从，则远程设备端有问题。如果ClearToSend是在，有一个硬件FlowControl准备好接收数据并可以执行的设备流．

请注意

要获得可用于某个函数的选项列表，请按选项卡在MATLAB命令行上输入函数后键入。列表将展开，您可以滚动以选择属性或值。有关使用这个高级选项卡补全功能的信息，请参见使用制表符补全函数．

同步与异步写操作

默认情况下，文本同步写入仪器，命令行被阻塞，直到操作完成。属性可以执行异步写操作模式输入参数为异步．为异步写道,

的BytesToOutput属性值不断更新，以反映输出缓冲区中的字节数。
的回调函数OutputEmptyFcn属性在输出缓冲区为空时执行。

属性可以确定异步写操作是否正在进行TransferStatus财产。

使用fprintf完成写操作的规则

使用流完成的时候

写入指定的数据。
指定的时间超时属性传递。

写终结者的规则

对于串口、TCPIP、UDP和VISA-serial对象，出现\ n在cmd都被《终结者》属性值。因此，在使用默认格式时% s \ n，写入仪器的所有命令将以该属性值结束。

对于GPIB、VISA-GPIB、VISA-VXI和VISA-GPIB- vxi对象，出现\ n在cmd都被EOSCharCode属性值，如果EOSMode属性设置为写或读和写．例如,如果EOSMode被设置为写和EOSCharCode被设置为低频，然后所有的发生\ n用换行符替换。此外，对于GPIB对象，在写入结束符时断言结束或标识(EOI)行。