summaryrefslogtreecommitdiffstats
path: root/src/bm/bmmisc.h
blob: 057adacc2197f346b565a4082ffd8c2893eab782 (plain)
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
/****************************************************************************
**
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
** Contact: Qt Software Information (qt-info@nokia.com)
**
** This file is part of the BM project on Qt Labs.
**
** This file may be used under the terms of the GNU General Public
** License version 2.0 or 3.0 as published by the Free Software Foundation
** and appearing in the file LICENSE.GPL included in the packaging of
** this file.  Please review the following information to ensure GNU
** General Public Licensing requirements will be met:
** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
** http://www.gnu.org/copyleft/gpl.html.
**
** If you are unsure which license is appropriate for your use, please
** contact the sales department at qt-sales@nokia.com.
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
****************************************************************************/

#ifndef BMMISC_H
#define BMMISC_H

#include <QVector>
#include <QString>
#include <QStringList>
#include <QPair>
#include <QImage>
#include <QDateTime>
#include <QSqlQuery>

class BMMisc
{
public:

    static bool getTimestamp(
        const QStringList &args, int pos, QString *timestamp, QString *error = 0);
    static void printJSONOutput(const QString &s);
    static void printHTMLOutput(const QString &s);
    static void printHTMLErrorPage(const QString &s);
    static void printImageOutput(
        const QImage &image, const QString &format, const QString &error, bool httpHeader = true);
    static bool getLastInsertId(QSqlQuery *query, int *id);
    static QString lastQueryError(const QSqlQuery &query);
    static qreal normalizedDifference(qreal a, qreal b);
    static QString getOption(const QStringList &args, const QString &name, int offset = 0);
    static bool getOption(
        const QStringList &args, const QString &option, QStringList *values, int nvalues, int nskip,
        QString *error = 0);
    static bool getMultiOption(
        const QStringList &args, const QString &option, QStringList *values, QString *error,
        bool unique = true);
    static bool getMultiOption2(
        const QStringList &args, const QString &option, QList<QStringList> *values, int n,
        QString *error);
    static bool hasOption(const QStringList &args, const QString &option);
    static qreal median(const QList<qreal> &values);
    static int medianPos(const QList<qreal> &values, bool lastDuplicate = true);
    static qreal v2y(
        const qreal v, const qreal ymax, const qreal vmin, const qreal yfact, const qreal ydefault);
    static QDateTime createCurrDateTime(int timestamp);
    static QString secs2daysText(const int secs, const uint precision);
    static bool saveImageToFile(const QImage &image, const QString &fileName, QString *error);
    static QString ageColor(const int secs);
    static QString redToGreenColor(
        qreal val, qreal minAbsVal, qreal maxAbsVal, bool higherIsBetter = false);
    static QString diffColor(qreal diff, bool higherIsbetter = false);
    static bool lowerIsBetter(const QString &metric);
    static qreal log2val(qreal val, const QString &metric);
    static qreal log2diff(qreal val1, qreal val2, const QString &metric);
    static bool normalize(QList<qreal> &v);
    static QString compactDateString(int timestamp);

    // ### 2 B DOCUMENTED!
    // (Note that a function template cannot be compiled and linked independently, so its
    // definition needs to go here)
    template <typename T> static void insertRankedId(
        QList<QPair<T, qreal> > *ranked, int limit, T t, qreal value)
    {
        Q_ASSERT(limit >= 0);

        int i;
        for (i = 0; (i < limit) && (i < ranked->size()); ++i) {
            if (value > ranked->at(i).second)
                break;
        }

        if (i == limit)
            return;

        Q_ASSERT(i <= ranked->size());
        ranked->insert(i, qMakePair(t, value));

        if (ranked->size() > limit) {
            Q_ASSERT(ranked->size() == (limit + 1));
            ranked->removeLast();
            Q_ASSERT(ranked->size() == limit);
        }
    }
};

#endif // BMMISC_H