Qt:Документация 4.3.2/qbuffer

Материал из Wiki.crossplatform.ru

Перейти к: навигация, поиск
40px Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

Image:qt-logo.png

Главная · Все классы · Основные классы · Классы по группам · Модули · Функции

Image:trolltech-logo.png

Содержание

[править] QBuffer Class Reference
[модуль QtCore ]

The QBuffer class provides a QIODevice interface for a QByteArray. More...

 #include <QBuffer>

Наследует QIODevice.

Примечание: все функции в этом классе реентерабельны.

[править] Открытые функции

  • 32 открытые функции, унаследованные от QIODevice
  • 29 открытых функций, унаследованных от QObject

[править] Дополнительные унаследованные члены

  • 1 свойство, унаследованное от QObject
  • 1 открытый слот, унаследованный от QObject
  • 3 сигнала, унаследованные от QIODevice
  • 1 сигнал, унаследованный от QObject
  • 5 статических открытых членов, унаследованных от QObject
  • 5 защищенных функций, унаследованных от QIODevice
  • 7 защищенных функций, унаследованных от QObject

[править] Подробное описание

The QBuffer class provides a QIODevice interface for a QByteArray.

QBuffer allows you to access a QByteArray using the QIODevice interface. The QByteArray is treated just as a standard random-accessed file. Пример:

     QBuffer buffer;
     char ch;
 
     buffer.open(QBuffer::ReadWrite);
     buffer.write("Qt rocks!");
     buffer.seek(0);
     buffer.getChar(&amp;ch);  // ch == 'Q'
     buffer.getChar(&amp;ch);  // ch == 't'
     buffer.getChar(&amp;ch);  // ch == ' '
     buffer.getChar(&amp;ch);  // ch == 'r'

By default, an internal QByteArray buffer is created for you when you create a QBuffer. You can access this buffer directly by calling buffer(). You can also use QBuffer with an existing QByteArray by calling setBuffer(), or by passing your array to QBuffer's constructor.

Call open() to open the buffer. Then call write() or putChar() to write to the buffer, and read(), readLine(), readAll(), or getChar() to read from it. size() returns the current size of the buffer, and you can seek to arbitrary positions in the buffer by calling seek(). When you are done with accessing the buffer, call close().

The following code snippet shows how to write data to a QByteArray using QDataStream and QBuffer:

     QByteArray byteArray;
     QBuffer buffer(&amp;byteArray);
     buffer.open(QIODevice::WriteOnly);
 
     QDataStream out(&amp;buffer);
     out << QApplication::palette();

Effectively, we convert the application's QPalette into a byte array. Here's how to read the data from the QByteArray:

     QPalette palette;
     QBuffer buffer(&amp;byteArray);
     buffer.open(QIODevice::ReadOnly);
 
     QDataStream in(&amp;buffer);
     in >> palette;

QTextStream and QDataStream also provide convenience constructors that take a QByteArray and that create a QBuffer behind the scenes.

QBuffer emits readyRead() when new data has arrived in the buffer. By connecting to this signal, you can use QBuffer to store temporary data before processing it. For example, you can pass the buffer to QFtp when downloading a file from an FTP server. Whenever a new payload of data has been downloaded, readyRead() is emitted, and you can process the data that just arrived. QBuffer also emits bytesWritten() every time new data has been written to the buffer.

See also QFile, QDataStream, QTextStream, and QByteArray.


[править] Описание функций-членов

[править]
QBuffer::QBuffer ( QObject * parent = 0 )

Constructs an empty buffer with the given parent. You can call setData() to fill the buffer with data, or you can open it in write mode and use write().

See also open().

[править]
QBuffer::QBuffer ( QByteArray * byteArray, QObject * parent = 0 )

Constructs a QBuffer that uses the QByteArray pointed to by byteArray as its internal buffer, and with the given parent. The caller is responsible for ensuring that byteArray remains valid until the QBuffer is destroyed, or until setBuffer() is called to change the buffer. QBuffer doesn't take ownership of the QByteArray.

If you open the buffer in write-only mode or read-write mode and write something into the QBuffer, byteArray will be modified.

Пример:

     QByteArray byteArray("abc");
     QBuffer buffer(&amp;byteArray);
     buffer.open(QIODevice::WriteOnly);
     buffer.seek(3);
     buffer.write("def", 3);
     buffer.close();
     // byteArray == "abcdef"

See also open(), setBuffer(), and setData().

[править]
QBuffer::~QBuffer ()

Destroys the buffer.

[править]
QByteArray & QBuffer::buffer ()

Returns a reference to the QBuffer's internal buffer. You can use it to modify the QByteArray behind the QBuffer's back.

See also setBuffer() and data().

[править]
const QByteArray & QBuffer::buffer () const

Эта перегруженная функция предоставлена для удобства.

This is the same as data().

[править]
const QByteArray & QBuffer::data () const

Returns the data contained in the buffer.

This is the same as buffer().

See also setData() and setBuffer().

[править]
void QBuffer::setBuffer ( QByteArray * byteArray )

Makes QBuffer uses the QByteArray pointed to by byteArray as its internal buffer. The caller is responsible for ensuring that byteArray remains valid until the QBuffer is destroyed, or until setBuffer() is called to change the buffer. QBuffer doesn't take ownership of the QByteArray.

Does nothing if isOpen() is true.

If you open the buffer in write-only mode or read-write mode and write something into the QBuffer, byteArray will be modified.

Пример:

     QByteArray byteArray("abc");
     QBuffer buffer;
     buffer.setBuffer(&amp;byteArray);
     buffer.open(QIODevice::WriteOnly);
     buffer.seek(3);
     buffer.write("def", 3);
     buffer.close();
     // byteArray == "abcdef"

If byteArray is 0, the buffer creates its own internal QByteArray to work on. This byte array is initially empty.

See also buffer(), setData(), and open().

[править]
void QBuffer::setData ( const QByteArray & data )

Sets the contents of the internal buffer to be data. This is the same as assigning data to buffer().

Does nothing if isOpen() is true.

See also data() and setBuffer().

[править]
void QBuffer::setData ( const char * data, int size )

Эта перегруженная функция предоставлена для удобства.

Sets the contents of the internal buffer to be the first size bytes of data.



Copyright © 2007 Trolltech Trademarks
Qt 4.3.2