Portál AbcLinuxu, 30. dubna 2025 18:12
Konzolové programy v Qt 4 – 1 (úvod)
Články
-
Konzolové programy v Qt 4 – 1 (úvod)
Tento seriál bude pojetím připomínat sérii článků o programování GUI programů v Qt 4 a lišit se bude v zaměření. Zaměřovat se budu na součásti, které k běhu nevyžadují modul QtGui a tedy ani X server. Některé věci je zbytečné předvádět graficky, zatímco jiné se do konzole přímo hodí.
Než se pustíte do dalšího čtení, doporučuji prohlédnout si alespoň první díl seriálu o GUI, protože základy jsou podobné a nemá význam opakovat zde celý úvod od začátku.
Cílovou skupinou tohoto seriálu jsou lidé s alespoň základními znalostmi C++. Ačkoliv bude veškerý kód okomentovaný, cílem seriálu není vyučování základů C++.
Jak začít?
Je to celkem prosté. Ve funkci main() místo QApplication vytvoříte instanci QCoreApplication a pak už se jen stačí vyhýbat součástem z modulu QtGui.
První ukázkový program, který jsem připravil, slouží k práci s datem. Zadáte nějaké datum a můžete k němu přičítat (nebo od něj odečítat) dny (d), měsíce (m) a roky (y). Ukázka:
$ ./qdatemod today -7d +1m
neděle, 10. května 2009 -> středa, 3. června 2009
$ ./qdatemod 1.1.1970 +39y +4m +9d
čtvrtek, 1. ledna 1970 -> neděle, 10. května 2009
main.cpp: Nejjednodušší možná varianta. Vytvoříme instanci hlavní třídy a nespouštíme smyčku událostí pomocí app.exec(), protože by nám zde byla k ničemu. Místo toho vracíme hodnotu metody run(), která implementuje veškerou funkčnost.
#include <QCoreApplication>
#include "datemod.h"
int main(int argc, char *argv[])
{
QCoreApplication app(argc, argv);
DateMod main;
return main.run();
}
datemod.h: API.
#ifndef DATEMOD_H
#define DATEMOD_H
#include <QObject>
#include <QDate>
#include <QStringList>
#include <QTextStream>
class DateMod : public QObject
{
public:
DateMod();
int run();
private:
int error(QString text, int retcode = 1);
QDate baseDate;
QStringList argList;
QTextStream Output;
};
#endif // DATEMOD_H
datemod.cpp: Zde je novinkou použití třídy QTextStream, která poskytuje rozhraní pro čtení a zápis textu. V programu je použita pro zápis na standardní chybový výstup.
#include "datemod.h"
#include <QCoreApplication>
#include <QDebug>
DateMod::DateMod() : Output(stderr, QIODevice::WriteOnly)
{
// uložíme si seznam argumentů
argList << QCoreApplication::arguments();
// a odstraníme první položku (název spouštěného souboru)
argList.removeFirst();
}
int DateMod::run()
{
// potřebujeme alespoň 1 argument (datum)
if(argList.size() < 1)
return error(tr("Need at least one argument (a 'd.M.yyyy' date)!"));
// načteme zadané datum ("today" nastaví dnešní datum)
if(argList.first() != tr("today"))
{
baseDate = QDate::fromString(argList.first(), "d.M.yyyy");
if(baseDate.isNull())
return error(tr("The date you've entered is not valid.") + " " +
tr("It's not 'd.M.yyyy' or it doesn't exist or it's out of range."));
} else
baseDate = QDate::currentDate();
// odstraníme ze seznamu první argument
argList.removeFirst();
// pokud nemáme žádné další argumenty, vypíšeme samotné datum
if(!argList.size())
return error(baseDate.toString(Qt::DefaultLocaleLongDate), 0);
// regulární výraz, který nám pomůže odfiltrovat zjevné nesmysly a
// dostat z řetězce potřebné části
QRegExp regex("^([+-]?[0-9]+)([dmy])$");
QDate newDate = baseDate;
// dokud seznam argumentů není prázdný
while(!argList.isEmpty())
{
// pokud argument neodpovídá regulárnímu výrazu
if(!argList.first().contains(regex))
return error(tr("Invalid argument: ") + argList.first());
// odstraníme první argument
argList.removeFirst();
bool ok = false;
// převedeme zadané číslo na integer
int add = regex.cap(1).toInt(&ok);
// a zkontrolujeme, zda se to podařilo
if(!ok)
return error(tr("Conversion of ") + regex.cap(1) + tr(" to int failed."));
// uložíme si znak na konci argumentu
char what = regex.cap(2)[0].toAscii();
// podle toho, jaký je na konci argumentu znak, přidáme k aktuálnímu datu
// zadaný počet dní, měsíců nebo roků
switch(what)
{
case 'd':
newDate = newDate.addDays(add);
break;
case 'm':
newDate = newDate.addMonths(add);
break;
case 'y':
newDate = newDate.addYears(add);
break;
default:
break;
}
// pokud nové datum není validní
if(newDate.isNull())
return error(tr("Shifted date is invalid (probably out of range)."));
}
// když vše proběhne v pořádku, vypíšeme původní a nové datum
return error(baseDate.toString(Qt::DefaultLocaleLongDate) + " -> " +
newDate.toString(Qt::DefaultLocaleLongDate), 0);
}
// vypíše text na std. chybový výstup a vrátí hodnotu retcode
int DateMod::error(QString text, int retcode)
{
// vypíšeme text
Output << text << "\n";
Output.flush();
return retcode;
}
Zdrojáky si můžete stáhnout v archívu qdatemod.tar.bz2.
Spouštění externích procesů
Občas se stane, že z programu potřebujete spustit nějakou utilitu. Pro tyto účely je v Qt k dispozici třída QProcess, která v tomto směru nabízí zajímavé možnosti. Její použití si nyní předvedeme na jednoduchém příkladu.
Na rozdíl od předchozího programu bude mít tento smyčku událostí, i když by se bez ní obešel. Nikdy totiž neuškodí – spíš naopak, je to taková jistota, že po sobě program stihne uklidit v každém případě.
Program spouští příkaz
/sbin/ip address show
a parsuje z jeho výstupu názvy síťových rozhraní v systému. Výstup by měl být stejný, jako když na GNU/Linuxu spustíte
/sbin/ip a | sed -nr '/^[0-9]+:/ s/^[^:]+: ([^:]+).*/\1/p'
Na mém systému toto (i následující program) vypíše:
lo
marvell
nvidia
sit0
vboxnet0
Následuje kód:
main.cpp:
#include <QCoreApplication>
#include <QTimer>
#include "process.h"
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
// toto zajistí ukončení programu po jeho vykonání
QTimer::singleShot(0, &a, SLOT(quit()));
// vytvoříme instanci hlavní třídy
Process main;
// a spustíme program
main.run();
// spustíme smyčku událostí, která se v tomto případě
// v podstatě hned ukončí
return a.exec();
}
process.h: API.
#ifndef PROCESS_H
#define PROCESS_H
#include <QObject>
#include <QStringList>
#include <QProcess>
// třídu zakládám na QObject, jelikož používám sloty a lokalizační systém Qt
class Process : public QObject
{
Q_OBJECT
public:
Process();
void run();
private:
QProcess* process;
QString executable;
QStringList arguments;
private slots:
void handleOutput(int, QProcess::ExitStatus);
void handleError(QProcess::ProcessError);
};
#endif // PROCESS_H
process.cpp:
#include "process.h"
#include <QDebug>
Process::Process()
{
// vytvoříme instanci objektu QProcess
process = new QProcess(this);
// cesta k programu, který budeme spouštět
executable = "/sbin/ip";
// argumenty programu
arguments << "address" << "show";
// propojíme signály procesu se sloty této třídy
connect(process, SIGNAL(finished(int,QProcess::ExitStatus)), this, SLOT(handleOutput(int,QProcess::ExitStatus)));
connect(process, SIGNAL(error(QProcess::ProcessError)), this, SLOT(handleError(QProcess::ProcessError)));
}
// zpracuje chybový signál (vypíše chybovou hlášku)
void Process::handleError(QProcess::ProcessError error)
{
switch(error)
{
case QProcess::FailedToStart:
qDebug() << tr("The process failed to start. (Either the file doesn't exist, or you have insufficient permissions to invoke it.)");
break;
case QProcess::Crashed:
qDebug() << tr("The process crashed.");
break;
case QProcess::ReadError:
qDebug() << tr("An error occurred when attempting to read from the process.");
break;
default:
qDebug() << tr("An unknown error occurred.");
break;
}
}
// zpracuje výstup programu; vypíše seznam síťových rozhraní
void Process::handleOutput(int /*retcode*/, QProcess::ExitStatus status)
{
if(status == QProcess::CrashExit)
{
qDebug() << tr("process crashed, quitting");
return;
}
// vezme celý výstup programu a rozdělí jej do seznamu,
// kde každý řádek představuje jednu položku
QList<QByteArray> outlines = process->readAllStandardOutput().split('\n');
// vytvoříme si regulární výraz (s referencí)
// tento regexp hledá číslo na začátku, za ním dvojtečku a jako referenci bere
// řetězec, který je za tím (až po další dvojtečku)
// například z "1: abc: def" bude reference "abc"
QRegExp rx("^[0-9]+: ([^:]+)");
// otevřeme si std. výstup pro zápis
QTextStream out(stdout, QIODevice::WriteOnly);
// postupně projdeme každý řádek
for(int i=0; i<outlines.size(); i++)
// pokud výraz odpovídá
if(rx.indexIn(outlines[i]) != -1)
// vypíšeme první referenci
out << rx.cap(1) << '\n';
out.flush();
}
void Process::run()
{
// spustí program s danými argumenty
process->start(executable, arguments);
// čeká, dokud se program neukončí
process->waitForFinished(-1);
}
Zdrojáky si můžete stáhnout v archívu process.tar.bz2.
Související články
Odkazy a zdroje
Další články z této rubriky
Diskuse k tomuto článku
10.7.2009 00:48
__
Re: Konzolové programy v Qt 4 – 1 (úvod)
10.7.2009 08:49
vencas | skóre: 32
Re: Konzolové programy v Qt 4 – 1 (úvod)
10.7.2009 09:47
Re: Konzolové programy v Qt 4 – 1 (úvod)
10.7.2009 12:47
mirec | skóre: 32
| blog:
mirecove_dristy
| Poprad
Re: Konzolové programy v Qt 4 – 1 (úvod)
11.7.2009 00:23
limit_false
Pozor na fork()
ISSN 1214-1267, (c) 1999-2007 Stickfish s.r.o.
10.7.2009 00:52
David Watzke | skóre: 74
| blog: Blog...
| Praha
10.7.2009 12:29
Petr Tomášek | skóre: 39
| blog: Vejšplechty
10.7.2009 18:08
Max | skóre: 72
| blog: Max_Devaine
.
12.7.2009 21:27
andree | skóre: 39
| blog: andreeeeelog
10.7.2009 16:49
17.7.2009 11:38
12.7.2009 12:06
10.7.2009 12:47
13.7.2009 15:13