/usr/include/soprano/asyncresult.h is in libsoprano-dev 2.9.4+dfsg1-0ubuntu4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 | /*
* This file is part of Soprano Project.
*
* Copyright (C) 2008-2009 Sebastian Trueg <trueg@kde.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef _SOPRANO_ASYNC_RESULT_H_
#define _SOPRANO_ASYNC_RESULT_H_
#include <QtCore/QObject>
#include <QtCore/QVariant>
#include "error.h"
#include "soprano_export.h"
namespace Soprano {
class StatementIterator;
class Node;
class NodeIterator;
class QueryResultIterator;
namespace Util {
class AsyncModel;
/**
* \class AsyncResult asyncmodel.h Soprano/Util/AsyncResult
*
* \brief A delayed result as returned by AsyncModel.
*
* \author Sebastian Trueg <trueg@kde.org>
*
* \since 2.1
*/
class SOPRANO_EXPORT AsyncResult : public QObject, public Error::ErrorCache
{
Q_OBJECT
Q_SIGNALS:
/**
* Emitted once the async operation is completed
* and the result can be read.
*
* The result will delete itself.
*/
void resultReady( Soprano::Util::AsyncResult* );
public:
/**
* Constructor method to ensure binary compatibility.
*
* \since 2.2
*/
static AsyncResult* createResult();
~AsyncResult();
/**
* The result of the async operation. Its type is dependent
* on the operation (for example Error::ErrorCode for
* AsyncModel::addStatementAsync or StatementIterator for
* AsyncModel::listStatementsAsync). Types may need to be
* registered with Q_DECLARE_METATYPE.
*
* Use Error::ErrorCache::lastError() to check
* for error details.
*
* This value is not ready before resultReady()
* has been emitted. <b>Do only use this in a slot connected to
* resultReady.</b>
*
* \sa errorCode, statementIterator, nodeIterator, queryResultIterator, node
*/
QVariant value() const { return m_result; }
/**
* Convinience method which converts value() into
* a Error::ErrorCode as returned for the following AsyncModel methods:
* \li AsyncModel::addStatementAsync
* \li AsyncModel::removeStatementAsync
* \li AsyncModel::removeAllStatementsAsync
*
* \sa value()
*
* \since 2.2
*/
Error::ErrorCode errorCode() const;
/**
* Convinience method which converts value() into
* a StatementIterator as returned AsyncModel::listStatementsAsync.
*
* \sa value()
*
* \since 2.2
*/
StatementIterator statementIterator() const;
/**
* Convinience method which converts value() into
* a StatementIterator as returned AsyncModel::listContextsAsync.
*
* \sa value()
*
* \since 2.2
*/
NodeIterator nodeIterator() const;
/**
* Convinience method which converts value() into
* a StatementIterator as returned AsyncModel::executeQueryAsync.
*
* \sa value()
*
* \since 2.2
*/
QueryResultIterator queryResultIterator() const;
/**
* Convinience method which converts value() into
* a StatementIterator as returned AsyncModel::createBlankNodeAsync.
*
* \sa value()
*
* \since 2.2
*/
Node node() const;
/**
* Sets the final result and emits the resultReady signal. This method
* should never be called by clients.
*/
void setResult( const QVariant& result, const Error::Error& error );
private Q_SLOTS:
void slotResultReady();
private:
AsyncResult();
QVariant m_result;
friend class AsyncModel;
};
}
}
#endif
|