| asyncquery.h | | asyncquery.h | |
| | | | |
| skipping to change at line 56 | | skipping to change at line 56 | |
| * the execution of the query itself, but also the iteration. | | * the execution of the query itself, but also the iteration. | |
| * | | * | |
| * For executing a query asyncroneously simply use the static execu
teQuery() | | * For executing a query asyncroneously simply use the static execu
teQuery() | |
| * method which will return a pointer to the newly created query ob
ject. | | * method which will return a pointer to the newly created query ob
ject. | |
| * | | * | |
| * AsyncQuery objects will always delete themselves once the end of | | * AsyncQuery objects will always delete themselves once the end of | |
| * the iterator is reached and the finished signal has been emitted
. | | * the iterator is reached and the finished signal has been emitted
. | |
| * This also means that boolean results need to be read in a slot | | * This also means that boolean results need to be read in a slot | |
| * connected to the finished() signal. | | * connected to the finished() signal. | |
| * | | * | |
|
| * Typical usage would be to connect to the nextReady signal and ca | | * Typical usage would be to connect to the nextReady() signal, use | |
| ll | | one of the | |
| * next() in it to trigger async iteration to the next element. | | * binding() methods or currentStatement() to get the current value | |
| | | , and then | |
| | | * call next() in it to trigger async iteration to the next element | |
| | | : | |
| | | * | |
| | | * \code | |
| | | * void MyQueryHandler::slotNextReady( Soprano::Util::AsyncQuery* q | |
| | | uery ) { | |
| | | * // do something with the current value | |
| | | * addToSomeList( query->binding(0) ); | |
| | | * | |
| | | * // trigger async iteration to the next element | |
| | | * query->next(); | |
| | | * } | |
| | | * \endcode | |
| * | | * | |
| * \sa Soprano::Util::AsyncModel | | * \sa Soprano::Util::AsyncModel | |
| * | | * | |
| * \author Sebastian Trueg <trueg@kde.org> | | * \author Sebastian Trueg <trueg@kde.org> | |
| * | | * | |
| * \since 2.4 | | * \since 2.4 | |
| */ | | */ | |
| class SOPRANO_EXPORT AsyncQuery : public QObject, public Error::Err
orCache | | class SOPRANO_EXPORT AsyncQuery : public QObject, public Error::Err
orCache | |
| { | | { | |
| Q_OBJECT | | Q_OBJECT | |
| | | | |
| skipping to change at line 175 | | skipping to change at line 186 | |
| * backends need to always return \p true for boolean queries. | | * backends need to always return \p true for boolean queries. | |
| * | | * | |
| * \return \p true if this result refers to a boolean query (SP
ARQL ASK), i.e. | | * \return \p true if this result refers to a boolean query (SP
ARQL ASK), i.e. | |
| * boolValue() returns a valid value. | | * boolValue() returns a valid value. | |
| */ | | */ | |
| bool isBool() const; | | bool isBool() const; | |
| //@} | | //@} | |
| | | | |
| public Q_SLOTS: | | public Q_SLOTS: | |
| /** | | /** | |
|
| * Trigger iteration to the next element. Be aware that this ha | | * Trigger iteration to the next element once the current has b | |
| s not to be called | | een read via one of | |
| | | * the binding() methods or currentStatement(). Be aware that t | |
| | | his has not to be called | |
| * for the first element which is emitted automatically. | | * for the first element which is emitted automatically. | |
| * Once the next result has been retrieved the nextReady signal
is emitted. | | * Once the next result has been retrieved the nextReady signal
is emitted. | |
| * | | * | |
| * \return \p true if successful, \p false if the iteration rea
ched the end. | | * \return \p true if successful, \p false if the iteration rea
ched the end. | |
| */ | | */ | |
| bool next(); | | bool next(); | |
| | | | |
| /** | | /** | |
| * Closes the query. This will cancel the query if it is not fi
nished yet. | | * Closes the query. This will cancel the query if it is not fi
nished yet. | |
| * Afterwards the query will delete itself. It has the same eff
ect as | | * Afterwards the query will delete itself. It has the same eff
ect as | |
| * deleting the query object manually. | | * deleting the query object manually. | |
| * | | * | |
| * finished() will always be emitted in case the query was not
finished yet. | | * finished() will always be emitted in case the query was not
finished yet. | |
| */ | | */ | |
| void close(); | | void close(); | |
| | | | |
| Q_SIGNALS: | | Q_SIGNALS: | |
| /** | | /** | |
| * Emitted once the next value is ready when iterating the resu
lt via | | * Emitted once the next value is ready when iterating the resu
lt via | |
| * next(). Will be emitted automatically for the first element. | | * next(). Will be emitted automatically for the first element. | |
|
| | | * The last call in a connected slot should be next() to trigge | |
| | | r | |
| | | * iteration to the next element. | |
| * | | * | |
| * \param query The query itself for convinience. | | * \param query The query itself for convinience. | |
| */ | | */ | |
| void nextReady( Soprano::Util::AsyncQuery* query ); | | void nextReady( Soprano::Util::AsyncQuery* query ); | |
| | | | |
| /** | | /** | |
| * Emitted once the last element has been read and the internal | | * Emitted once the last element has been read and the internal | |
| * iterator is finished after the last call to next() or if the
result | | * iterator is finished after the last call to next() or if the
result | |
| * of a boolean query is available. | | * of a boolean query is available. | |
| * | | * | |
| | | | |
End of changes. 3 change blocks. |
| 5 lines changed or deleted | | 24 lines changed or added | |
|
| version.h | | version.h | |
| | | | |
| skipping to change at line 28 | | skipping to change at line 28 | |
| * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, | | * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, | |
| * Boston, MA 02110-1301, USA. | | * Boston, MA 02110-1301, USA. | |
| */ | | */ | |
| | | | |
| #ifndef _SOPRANO_VERSION_H_ | | #ifndef _SOPRANO_VERSION_H_ | |
| #define _SOPRANO_VERSION_H_ | | #define _SOPRANO_VERSION_H_ | |
| | | | |
| #include "soprano_export.h" | | #include "soprano_export.h" | |
| | | | |
| /// @brief Soprano version as string at compile time. | | /// @brief Soprano version as string at compile time. | |
|
| #define SOPRANO_VERSION_STRING "2.4.63" | | #define SOPRANO_VERSION_STRING "2.4.64" | |
| | | | |
| /// @brief The major Soprano version number at compile time | | /// @brief The major Soprano version number at compile time | |
| #define SOPRANO_VERSION_MAJOR 2 | | #define SOPRANO_VERSION_MAJOR 2 | |
| | | | |
| /// @brief The minor Soprano version number at compile time | | /// @brief The minor Soprano version number at compile time | |
| #define SOPRANO_VERSION_MINOR 4 | | #define SOPRANO_VERSION_MINOR 4 | |
| | | | |
| /// @brief The Soprano release version number at compile time | | /// @brief The Soprano release version number at compile time | |
|
| #define SOPRANO_VERSION_RELEASE 63 | | #define SOPRANO_VERSION_RELEASE 64 | |
| | | | |
| /** | | /** | |
| * \brief Create a unique number from the major, minor and release number o
f a %Soprano version | | * \brief Create a unique number from the major, minor and release number o
f a %Soprano version | |
| * | | * | |
| * This function can be used for preprocessing. For version information at
runtime | | * This function can be used for preprocessing. For version information at
runtime | |
| * use the version methods in the Soprano namespace. | | * use the version methods in the Soprano namespace. | |
| */ | | */ | |
| #define SOPRANO_MAKE_VERSION( a,b,c ) (((a) << 16) | ((b) << 8) | (c)) | | #define SOPRANO_MAKE_VERSION( a,b,c ) (((a) << 16) | ((b) << 8) | (c)) | |
| | | | |
| /** | | /** | |
| | | | |
End of changes. 2 change blocks. |
| 2 lines changed or deleted | | 2 lines changed or added | |
|