实现QIODevice::writeData，混淆文档

Question

我试图为实时音频应用程序实现一个双缓冲区，而QAudioInput要求它是QIODevice的一个子类。我发现这个方法的文档非常令人困惑。

首先，文档中的方法签名与具有virtual qint64 writeData(const char *data, qint64 len) = 0;的QT5.9.2的标头不匹配。

但是，文档中有这样的签名：qint64 QIODevice::writeData(const char *data, qint64 maxSize)

maxSize参数使我感到困惑，因为它意味着我只需缓冲一些数据，而文档也暗示了这一点：

将数据写入maxSize字节到设备。返回写入的字节数，如果发生错误，则返回-1。

然而，在文件的后面，我认为这似乎是自相矛盾的：

在重新实现此函数时，重要的是此函数在返回之前写入所有可用数据。为了使QDataStream能够对类进行操作，这是必需的。QDataStream假定所有信息都是写入的，因此如果出现问题，不会重新尝试编写。

那么，我的QIODevice实现是否负责在一个调用中缓冲所有数据？

Answer 1

他们主要想说的是:传递的data是maxSize字节长。您的实现应该写入所有数据并返回写入的字节数。

可以编写比可用的更少的数据，但您不应该。如果这样做，一些使用您的设备的类可能不会对此做出反应(如QDataStream)。这取决于QAudioInput如何处理写调用。如果它检查结果并再次写入丢失的数据(如果没有完整写入)，则不写入所有数据就可以了。如果不是这样的话，您必须始终编写所有数据。

只需尝试一下:始终只写一个字节(并返回1)。如果它工作正常，如果不是，您必须始终写入所有传递的数据，或者使用-1失败。