mirror of https://github.com/simonbrunel/qtpromise.git synced 2025-02-02 19:27:42 +08:00

Simon Brunel 3c1461b8d0 Enhance the documentation and add markdown lint

- Add npm package.json to make easier maintaining dependencies.
- Make markdown files consistent using remark.
- Wrap markdown lines to 100 characters.
- Better README.md layout and visual.
- Enable VuePress landing/home page.
- Upgrade to latest VuePress version.
- Add link to the new Qt Marketplace.

2019-12-21 10:27:26 +01:00

1.6 KiB

Raw Blame History

title
map

QtPromise::map

Since: 0.4.0

QtPromise::map(Sequence<T> values, Mapper mapper) -> QPromise<QVector<R>>

// With:
// - Sequence: STL compatible container (e.g. QVector, etc.)
// - Mapper: Function(T value, int index) -> R | QPromise<R>

Iterates over values and maps the sequence to another using the given mapper function. The type returned by mapper determines the type of the output promise. If mapper throws, output is rejected with the new exception.

If mapper returns a promise (or QFuture), the output promise is delayed until all the promises are resolved. If any of the promises fails, output immediately rejects with the error of the promise that rejected, whether or not the other promises are resolved.

auto output = QtPromise::map(QVector{
    QUrl("http://a..."),
    QUrl("http://b..."),
    QUrl("http://c...")
}, [](const QUrl& url, ...) {
    return QPromise<QByteArray>([&](auto resolve, auto reject) {
        // download content at url and resolve
        // {...}
    });
});

// 'output' resolves as soon as all promises returned by
// 'mapper' are fulfilled or at least one is rejected.

// 'output' type: QPromise<QVector<QByteArray>>
output.then([](const QVector<QByteArray>& res) {
    // {...}
});

::: tip NOTE The order of the output sequence values is guarantee to be the same as the original sequence, regardless of completion order of the promises returned by mapper. :::

1.6 KiB Raw Blame History

QtPromise::map

1.6 KiB

Raw Blame History