This file is indexed.

/usr/include/QtGStreamer/QGlib/signal.h is in libqtgstreamer-dev 0.10.1-2ubuntu4.

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
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
/*
    Copyright (C) 2010 George Kiagiadakis <kiagiadakis.george@gmail.com>
    Copyright (C) 2010 Collabora Ltd.
      @author George Kiagiadakis <george.kiagiadakis@collabora.co.uk>

    This library is free software; you can redistribute it and/or modify
    it under the terms of the GNU Lesser General Public License as published
    by the Free Software Foundation; either version 2.1 of the License, or
    (at your option) any later version.

    This program 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 General Public License for more details.

    You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef QGLIB_SIGNAL_H
#define QGLIB_SIGNAL_H

#include "global.h"
#include <QtCore/QString>
#include <QtCore/QFlags>
#include <QtCore/QSharedData>

//Qt's emit will clash
#if defined(emit)
# if !defined(QGLIB_NO_EMIT_WARNING) //define that to get rid of the warning
#  if defined(Q_CC_GNU)
#   warning "The emit keyword is defined and will be undefined here to compile QGlib::emit."
#   warning "It is recommended to compile your project with QT_NO_KEYWORDS defined."
#  elif defined(Q_CC_MSVC)
#   pragma message("Warning: The emit keyword is defined and will be undefined here to compile QGlib::emit.")
#   pragma message("Warning: It is recommended to compile your project with QT_NO_KEYWORDS defined.")
#  endif
# endif
# undef emit
# define QT_NO_EMIT //undocumented Qt macro that skips "#define emit" in qglobal.h
#endif

namespace QGlib {

/*! \headerfile signal.h <QGlib/Signal>
 * \brief Helper class providing introspection of GObject signals
 *
 * Signals are a generic notification mechanism. Each signal is bound to a
 * certain instantiatable Type and can be emitted on any instance of this type.
 *
 * This class allows you to inspect these signals. You can use the lookup() and
 * listSignals() methods to get a Signal instance. You can then use one of the
 * accessor methods to retrieve information about this signal.
 *
 * This class does not offer methods to emit or connect to signals.
 * To emit or connect a signal, use the QGlib::emit() and QGlib::connect()
 * methods, respectively.
 *
 * For more information, please read the relevant Glib documentation.
 *
 * \sa connect(), emit()
 */
class QTGLIB_EXPORT Signal
{
public:
    enum SignalFlag {
        RunFirst = 1<<0,
        RunLast = 1<<1,
        RunCleanup = 1<<2,
        NoRecurse = 1<<3,
        Detailed = 1<<4,
        Action = 1<<5,
        NoHooks = 1<<6
    };
    Q_DECLARE_FLAGS(SignalFlags, SignalFlag);

    Signal(const Signal & other);
    Signal & operator=(const Signal & other);
    virtual ~Signal();

    /*! Returns true if this Signal instance represents
     * an existing signal, or false otherwise. */
    bool isValid() const;

    uint id() const; ///< Returns the signal's id.
    QString name() const; ///< Returns the signal's name.
    SignalFlags flags() const; ///< Returns the signal's flags.

    /*! Returns the interface/instance Type that this signal can be emitted for. */
    Type instanceType() const;
    Type returnType() const; ///< Returns the return Type of the signal.
    QList<Type> paramTypes() const; ///< Returns the types of the signal parameters.

    /*! Finds and returns a Signal with the specified \a name
     * on the specified interface/instance \a type. */
    static Signal lookup(const char *name, Type type);

    /*! Returns a list with all the signals that an interface/instance \a type has. */
    static QList<Signal> listSignals(Type type);

private:
    QTGLIB_NO_EXPORT Signal(uint id);

    struct Private;
    QSharedDataPointer<Private> d;
};

Q_DECLARE_OPERATORS_FOR_FLAGS(Signal::SignalFlags)

#if defined(DOXYGEN_RUN)

/*! Emits a signal on a specified \a instance with the specified arguments.
 *
 * This method will convert all the specified arguments to GValues using Value::set()
 * and will then emit the signal using g_signal_emitv(). The returned value from the signal
 * (if the signal returns a value) will be converted from GValue to the type R using
 * Value::get() and will be returned. If some argument is not of the type that the signal
 * expects and a conversion is not possible, a warning will be printed to stderr at runtime
 * and the signal will not be emitted. On the contrary, if the return value is not of the type
 * that the signal returns and a conversion is not possible, the signal \em will be emitted,
 * but a default-constructed value for the type R will be returned and a warning will be
 * printed to stderr.
 *
 * Note that since the implementation uses Value::set() to convert the GValues into the
 * specified types, the same rules that apply to Value::set() apply here (i.e. you should
 * only use the types of the bindings and not the C types, which means QGst::ObjectPtr instead
 * of GstObject*, etc...).
 *
 * Emitting a signal is useful for the so-called Action signals. These are meant to be emitted
 * from the application and not connected to. They are more like dynamic methods that can be
 * identified with a string.
 *
 * \note
 * \li This method makes use of C++0x features (namely, variadic templates and rvalue
 * references). If your compiler does not support them, a hacky implementation using boost's
 * preprocessor, function and bind libraries will be compiled instead. That version has a
 * limit of 9 arguments by default. Define QGLIB_SIGNAL_MAX_ARGS to a greater value before
 * including QGlib/Signal if you want to support more arguments.
 * \li This function's name clashes with Qt's emit keyword. To compile it successfully,
 * the headers will undefine Qt's emit and print a warning at compile time. It is recommended
 * that you compile your project with QT_NO_KEYWORDS to avoid this, however note that this
 * means that the "signals", "slots" and "foreach" keywords will also be unavailable under these
 * names (you can use "Q_SIGNALS", "Q_SLOTS" and "Q_FOREACH" respectively). If you do not wish
 * to do that, you can also define QT_NO_EMIT or QGLIB_NO_EMIT_WARNING. The first one undefines
 * Qt's emit completely and the second one supresses the warning and undefines Qt's emit in all
 * the code files that include the QGlib/Signal header. In all cases, to emit Qt signals you
 * will have to use "Q_EMIT" instead of "emit".
 *
 * \param instance The instance of the object on which the signal will be emitted. You can pass
 * a RefPointer as an instance without any problems; it will automatically cast to void*.
 * \param detailedSignal The name of the signal that you want to emit, with an optional
 * detail if the signal is detailed. The detail may be specified with the following syntax:
 * "signal::detail".
 * \param args The arguments that will be passed to the signal.
 * \returns The return value of the signal.
 */
template <typename R, typename... Args>
R emit(void *instance, const char *detailedSignal, const Args & ... args);

/*! \overload
 * This method takes the detail argument as a quark, separated from the signal name.
 * It may be useful if you already have the quark of the detail that you want to specify.
 */
template <typename R, typename... Args>
R emitWithDetail(void *instance, const char *signal, Quark detail, const Args & ... args);

#endif //DOXYGEN_RUN

} //namespace QGlib

#if !QGLIB_HAVE_CXX0X && !defined(QGLIB_SIGNAL_MAX_ARGS)
# define QGLIB_SIGNAL_MAX_ARGS 9
#endif

#define IN_QGLIB_SIGNAL_H
# include "emitimpl.h"
#undef IN_QGLIB_SIGNAL_H

#if defined(QGLIB_SIGNAL_MAX_ARGS)
# undef QGLIB_SIGNAL_MAX_ARGS
#endif

#endif