Download the PHP package clue/qdatastream without Composer
On this page you can find all versions of the php package clue/qdatastream. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download clue/qdatastream
More information about clue/qdatastream
Files in clue/qdatastream
Package qdatastream
Short Description Lightweight PHP library that allows exchanging binary data with Qt programs (QDataStream)
License MIT
Homepage https://github.com/clue/php-qdatastream
Informations about the package qdatastream
clue/qdatastream
Lightweight PHP library that allows exchanging binary data with Qt programs (QDataStream)
Table of contents
- Usage
- Writer
- Reader
- QVariant
- Types
- Install
- Tests
- License
Usage
Writer
The Writer
class can be used to build a binary buffer string from the
structured data you write to it.
See the class outline for more details.
Reader
The Reader
class can be used to read data from a binary buffer string.
See the class outline for more details.
QVariant
The QVariant
class can be used to encapsulate any kind of data with an
explicit data type. When writing a QVariant
to a buffer, it will also
include its data type so that reading it back in can be done automatically
without having to know the data type in advance.
Additionally, you can use the writeQVariant()
method without having to specify
the data type in advance and let this class "guess" an appropriate data
type for serialization and add this type information to the serialized data.
This works similar to JSON encoding and accepts primitive values of type int
,
bool
, string
, null
and nested structures or type array
or instances of stdClass
:
Note that associative arrays and stdClass
objects be will serialized as a "map",
while vector arrays will be serialized as a "list". In order to avoid confusion
between these similar data structures, using instances of stdClass
is considered
the preferred method in this project.
See the class outline for more details.
Types
The Types
class exists to work with different data types and offers a number
of public constants to work with explicit data types and is otherwise mostly
used internally only.
See the class outline for more details.
Install
The recommended way to install this library is through Composer. New to Composer?
This will install the latest supported version:
See also the CHANGELOG for details about version upgrades.
This project aims to run on any platform and thus does not require any PHP extensions and supports running on legacy PHP 5.3 through current PHP 8+. It's highly recommended to use PHP 7+ for this project.
The QString
and QChar
types use the ext-mbstring
for converting
between different character encodings.
If this extension is missing, then this library will use a slighty slower Regex
work-around that should otherwise work equally well.
Installing ext-mbstring
is highly recommended.
Tests
To run the test suite, you first need to clone this repo and then install all dependencies through Composer:
To run the test suite, go to the project root and run:
License
This project is released under the permissive MIT license.
Did you know that I offer custom development services and issuing invoices for sponsorships of releases and for contributions? Contact me (@clue) for details.