MochiuWiki : SUSE, EC, PCB

「Qtの基礎 - ファイル」の版間の差分

📢 Webサイト閉鎖と移転のお知らせ
このWebサイトは2026年9月に閉鎖いたします。
新しい記事は移転先で追加しております。（旧サイトでは記事を追加しておりません）

← 古い編集
ビジュアルウィキテキスト
 
(同じ利用者による、間の16版が非表示)
5行目: 5行目:
ファイルフォーマットは、公開・非公開のものがあり、各フォーマットを理解してファイルの入出力を行うことは難しいが、<br>
ファイルフォーマットは、公開・非公開のものがあり、各フォーマットを理解してファイルの入出力を行うことは難しいが、<br>
ライブラリを使用する場合、簡単に入出力を行うことができる。<br>
ライブラリを使用する場合、簡単に入出力を行うことができる。<br>
<br><br>
== 実行ファイルがあるディレクトリ ==
実行ファイルが存在するディレクトリを取得するには、以下のように記述する。<br>
<syntaxhighlight lang="c++">
QString strAppDir = QCoreApplication::applicationDirPath();
</syntaxhighlight>
<br><br>
== QIODevice::Textオプション ==
<code>QIODevice::Text</code>を指定する場合、改行コードは自動的にプラットフォームに合わせて変換される。<br>
<br><br>
<br><br>


67行目: 78行目:
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== 文字列の検索 ====
特定の文字列を検索する場合は、テキストファイルを読み込みながら検索する文字列が各行に含まれているかを確認する。<br>
<br>
以下の例では、各行が"hoge"という文字列と一致するかどうかを確認している。<br>
一致する行が存在する場合、その行を出力して処理を終了して、一致する行が存在しない場合はその旨を出力する。<br>
<syntaxhighlight lang="c++">
bool SearchString(const QString &filePath, const QString &str)
{
    QFile File(filePath);
    if (!File.open(QIODevice::ReadOnly | QIODevice::Text)) {
      std::cerr << QString("ファイルのオープンに失敗 : %1").arg(File.errorString()).toStdString() << std::endl;
      return false;
    }
    QTextStream in(&File);
    while (!in.atEnd()) {
      QString line = in.readLine();
      if (line == str) {
          std::cout << QString("%1 が見つかりました").arg(str).toStdString() << std::endl;
          File.close();
          return true;
      }
    }
    std::cout << QString("%1 は見つかりませんでした").arg(str).toStdString() << std::endl;
    File.close();
    return false;
}
</syntaxhighlight>
<br>
==== バイナリデータの読み込み ====
==== バイナリデータの読み込み ====
バイナリデータを読み込む場合は、<code>QFile</code>クラスの<code>readLine</code>メソッドまたは<code>readAll</code>メソッドを使用する。<br>
バイナリデータを読み込む場合は、<code>QFile</code>クラスの<code>readLine</code>メソッドまたは<code>readAll</code>メソッドを使用する。<br>
115行目: 158行目:
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== バイナリデータの書き込み ====
以下の例では、QTextStreamクラスを使用して書式を設定している。<br>
バイナリデータを書き込む場合は、<code>QFile</code>クラスの<code>write</code>メソッドを使用する。<br>
<br>
QDataStreamを使用してバイナリデータを書き出す場合、以下の問題が生じる。<br>
QDataStreamの仕様において、バイナリデータを書き込む場合、先頭にバイナリデータのサイズが追加される。<br>
これは、QDataStreamはバイナリデータを直列化するためのものだからである。<br>
  <syntaxhighlight lang="c++">
  <syntaxhighlight lang="c++">
  #include <QFile>
  // 浮動小数
QFile file(strFName);
QTextStream OutStream(&file);
   
   
  QFile File(FileName);
  // 浮動小数 e+形式
  if(!File.open(QIODevice::WriteOnly))
  OutStream.setRealNumberNotation(QTextStream::ScientificNotation);
{
    QString strErrMsg = "File(" + QFileInfo(File).fileName() + ") Open Error: " + File.errorString();
    qDebug() << strErrMsg;
    return;
}
   
   
  QByteArray ByAryData = QString("48656c6c6f").toUtf8().toHex();
  // 浮動小数の桁数を固定
  OutStream.setRealNumberNotation(QTextStream::FixedNotation);
  File.write(ByAryData);
   
   
  File.close();
  // 浮動小数点の桁数を設定
OutStream.setRealNumberPrecision(3);
  </syntaxhighlight>
  </syntaxhighlight>
<br><br>
== CSVファイル ==
以下の例では、CSVファイルを作成している。<br>
処理手順は以下の通りである。<br>
# 数値データを生成する。<br>ここでは、sin曲線y=sin(x)を生成する。
# 数値データをテキストデータに変換する。
# ファイル保存ダイアログを開いて、保存するファイル名を入力する。
# 全テキストデータを書き込む。
<br>
<br>
列ごとに列幅を設定する場合は、1つ列を出力するごとに設定する必要がある。<br>
  <syntaxhighlight lang="c++">
  <syntaxhighlight lang="c++">
  #include <QFileDialog>
  QFile file(strFName);
#include <QMessageBox>
  QTextStream OutStream(&file);
  #include <QTextStream>
#include <QFile>
#include <vector>
#include <math.h>
#include <sstream>
#include "mainwindow.h"
#include "ui_mainwindow.h"
   
   
  using namespace std;
  // 列を右寄せに設定
OutStream.setFieldAlignment(QTextStream::AlignRight);
   
   
  MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow)
  // 1列目の文字数を設定 
  {
  OutStream.setFieldWidth(20);
    ui->setupUi(this);
  OutStream << "1列目"
  }
   
   
  MainWindow::~MainWindow()
  // 2列目の文字数を設定 
  {
// 最終列の改行では、std::endlを使用してはならない
    delete ui;
OutStream.setFieldWidth(40);
  }
  OutStream << "2列目" + "\n" << flush;
  </syntaxhighlight>
void MainWindow::OnButtonClicked()
<br>
  {
<u>※注意</u><br>
    // Input File Name
<u>最終列の改行において、std::endlを使用する場合、それが1つの列として扱われるため、</u><br>
    QString FileName = QFileDialog::getSaveFileName(this, tr("Save CSV File"), "", tr("CSV (*.csv);;All Files (*)"));
<u>空列が1つ余計に追加されて余分な空白が末尾に追加されてしまう。</u><br>
<br>
以下の例では、出力エンコーディングを指定する。<br>
  <syntaxhighlight lang="c++">
// 例. UTF-8にする場合
QFile file(strFName);
QTextStream OutStream(&file);
   
   
    if(FileName.isEmpty())
  OutStream.setCodec("UTF-8");
    { // Cancel
      return;
    }
    // Generate CSV Data
    int iSize = 100;
    vector<double> lx(iSize, 0.0f),
                  ly(iSize, 0.0f);
    double dx = 2 * 3.15159 / iSize;
    for(int i = 0; i < iSize; i++)
    {
      lx[i] = i * dx;
      ly[i] = sin(vx);
    }
    // Convert from Double to String
    QString strFileData = "";
    //stringstream ss;
    for(int i = 0; i < iSize; i++)
    {
        strFileData += lx[i] + ", " + ly[i] + "\n";
        //ss << lx[i] << "," << ly[i] << endl;
    }
   
    // Write to File
    QFile File(FileName);
 
    if(!File.open(QIODevice::WriteOnly))
    {
        QMessageBox::information(this, tr("Unable to open file"), File.errorString());
        return;
    }
    QTextStream OutStream(&File);
    // 浮動小数点をe形式にする
    //OutStream.setRealNumberNotation(QTextStream::ScientificNotation);
    // 浮動小数点の桁数を固定
    //OutStream.setRealNumberNotation(QTextStream::FixedNotation);
    // 浮動小数点の桁数を設定
    OutStream.setRealNumberPrecision(3);
    OutStream << strFileData;
    //OutStream << ss.str().c_str();
    File.close();
}
  </syntaxhighlight>
  </syntaxhighlight>
<br><br>
== INIファイル ==
==== INIファイルの書き込み ====
以下の例では、ソフトウェアにおけるウインドウの状態を保存している。<br>
<br>
<br>
ウインドウの座標、縦横のサイズ、状態、最少幅、タイトル文字列をSetting.iniファイルに保存する。<br>
出力エンコードをShift-JISに設定する場合、"～"が文字化けする時がある。<br>
もし、Settings.iniファイルが存在する場合は上書きする。<br>
詳細を知りたい場合は、こちらのWebサイトを参照すること。<br>
http://park3.wakwak.com/~ozashin/sw_tips/webapp_tips/sjis_charset.html<br>
<br>
この文字化けを直すには、以下のように記述する。(Winodwsのみ)<br>
  <syntaxhighlight lang="c++">
  <syntaxhighlight lang="c++">
  void MainWindow::saveSetting()
  QFile file(strFName);
  {
  QTextStream OutStream(&file);
    QSettings settings("settings.ini", QSettings::IniFormat, this);
    settings.beginGroup("MainWindow");
    settings.setValue("pos", pos());
   
   
    if(!isMaximized())
  OutStream << str.replace(QChar(0x301C), QChar(0xFF5E));
    {
      settings.setValue("size", size());
    }
   
    settings.setValue("maximized", isMaximized());
    settings.setValue("miniwid", minimumWidth());
    settings.setValue("title", windowTitle());
    settings.endGroup();
}
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
以下の例では、ソフトウェア終了時に、ウインドウの幅と高さをINIファイルに保存している。<br>
以下の例では、ファイルの先頭にテキストを追記している。<br>
# まず、既存のファイルの内容を読み込み、その内容をメモリ（<code>QString</code>クラスや<code>QByteArray</code>）に保存する。
# 次に、追加する内容と元のファイル内容を結合させる。
# 最後に、新しい内容でファイルを上書きする。
  <syntaxhighlight lang="c++">
  <syntaxhighlight lang="c++">
  // mainwindow.cpp
  #include <QFile>
#include <QTextStream>
   
   
  #include <QMessageBox>
  QFile File("/tmp/sample.txt");
  #include <QSettings>
  if (!File.open(QIODevice::ReadOnly | QIODevice::Text)) {
#include <QSize>
    std::cerr << QString("Failed to open file for reading.").toStdString() << std::endl;
#include "mainwindow.h"
    return -1;
  #include "ui_mainwindow.h"
  }
   
   
  MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow)
  // 元のファイル内容を読み込む
  {
  QString oldText;
    ui->setupUi(this);
QTextStream in(&File);
   
  oldText = in.readAll();
    ORG_NAME = "My Company";
File.close();
    APP_NAME = "My Tool";
   
   
    QSettings settings(ORG_NAME, APP_NAME);
// 追加する内容と元のファイル内容を結合させる
    int width = settings.value("Window / Width").toInt();
QString newText = "hoge" + "\n" + oldText;
    int height = settings.value("Window / Height").toInt();
   
   
     this->resize(QSize(width, height));
// ファイルに新しい内容を書き込む
if (!File.open(QIODevice::WriteOnly | QIODevice::Text)) {
     std::cerr << QString("Failed to open file for writing.").toStdString() << std::endl;
    return -1;
  }
  }
   
   
  MainWindow::~MainWindow()
  QTextStream out(&File);
{
  out << newText;
    delete ui;
  File.close();
}
// ソフトウェアの終了処理はcloseEventをオーバーライドすることで実現できる
void MainWindow::closeEvent(QCloseEvent *event)
{
    int width = this->geometry().width();
    int height = this->geometry().height();
   
    QMessageBox::information(this, "Finish Timing", tr("window width : %1 \nwindow height : %2").arg(width).arg(height));
   
    QSettings settings(ORG_NAME, APP_NAME);
    settings.setValue("Window / Width", width);
    settings.setValue("Window / Height", height);
}
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== バイナリデータの書き込み ====
バイナリデータを書き込む場合は、<code>QFile</code>クラスの<code>write</code>メソッドを使用する。<br>
<br>
QDataStreamを使用してバイナリデータを書き出す場合、以下の問題が生じる。<br>
QDataStreamの仕様において、バイナリデータを書き込む場合、先頭にバイナリデータのサイズが追加される。<br>
これは、QDataStreamはバイナリデータを直列化するためのものだからである。<br>
  <syntaxhighlight lang="c++">
  <syntaxhighlight lang="c++">
  // mainwindow.h
  #include <QFile>
   
   
  #ifndef MAINWINDOW_H
  QFile File(FileName);
#define MAINWINDOW_H
  if(!File.open(QIODevice::WriteOnly))
#include <QMainWindow>
namespace Ui {class MainWindow;}
   
class MainWindow : public QMainWindow
  {
  {
     Q_OBJECT
     QString strErrMsg = "File(" + QFileInfo(File).fileName() + ") Open Error: " + File.errorString();
    qDebug() << strErrMsg;
    return;
}
   
   
  private:
  QByteArray ByAryData = QString("48656c6c6f").toUtf8().toHex();
    const QString ORG_NAME;
    const QString APP_NAME;
   
   
  public:
  File.write(ByAryData);
    explicit MainWindow(QWidget *parent = 0);
    ~MainWindow();
   
   
  private:
  File.close();
    Ui::MainWindow *ui;
protected:
    virtual void closeEvent(QCloseEvent *event);
};
#endif // MAINWINDOW_H
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== INIファイルの読み込み ====
また、<code>QByteArray</code>クラスは、以下のように宣言することができる。<br>
以下の例では、前回のウインドウの状態を復元している。<br>
Setting.iniファイルから必要な情報を読み込み、画面の状態を変更する。<br>
<br>
Settings.iniファイルが存在しない場合またはpos等のキー値が無ければ何もしない。<br>
  <syntaxhighlight lang="c++">
  <syntaxhighlight lang="c++">
  bool MainWindow::loadSetting()
  // 宣言 1
  {
  QByteArray data_1 = {0x0c, 0x06, 0x04, 0x04, 0x02, 0x00};
    QSettings settings("settings.ini", QSettings::IniFormat, this);
    settings.beginGroup("MainWindow");
   
   
    if(settings.contains("pos"))
// 宣言 2
    {
  QByteArray data_2 = QByteArray("\x0c\x06\x04\x04\x02\x00", 6);
      move(settings.value("pos", QPoint(50, 40)).toPoint());
    }
   
    if(settings.contains("size"))
    {
      resize(settings.value("size", QSize(800, 720)).toSize());
    }
    if(settings.value("maximized").toBool())
    {
      setWindowState(windowState() | Qt::WindowMaximized);
    }
   
   
    if(settings.contains("miniwid"))
// 宣言 3
    {
QByteArray data_3;
      setMinimumWidth(settings.value("miniwid", 400).toInt());
data_3.append((char)0x0c);
    }
data_3.append((char)0x06);
data_3.append((char)0x04);
data_3.append((char)0x04);
data_3.append((char)0x02);
data_3.append((char)0x00);
data_3.append((char)0xFF);
   
   
    if(settings.contains("title"))
std::cout << data_3.size() << std::endl;
    {
std::cout << data_3.toHex().toStdString().c_str() << std::endl;
      setWindowTitle(settings.value("title", "なし").toString());
    }
   
   
    settings.endGroup();
// 宣言 4
  }
char v1 = 0x01,
      v2 = 0x02;
  QByteArray data_4(std::begin<char>({0x00, v1, v2, v2, 0x05, 0x06, '\xf3'}), 7);
  </syntaxhighlight>
  </syntaxhighlight>
<br>
以下に、設定ファイル(Settings.ini)の内容を示す。<br>
左上位置(46, 15)、画面サイズ(800x600)、最大化(false)、最少幅(400)、画面のタイトルが"サンプル画面"の場合である。<br>
[MainWindow]
pos=@Point(46 15)
size=@Size(800 600)
maximized=false
miniwid=400
title=\x30b5\x30f3\x30d7\x30eb\x753b\x9762
<br><br>
<br><br>


== ファイル情報 ==
== ファイル情報 ==
==== ファイルの存在確認 ====
==== ファイルの存在確認 ====
ファイルが存在すればtrue、存在しなければfalseを返す。<br>
ファイルが存在すれば<code>true</code>、存在しなければ<code>false</code>を返す。<br>
  <syntaxhighlight lang="c++">
  <syntaxhighlight lang="c++">
  bool MainWindow::FileExists(QString FileName)
#include <QFileInfo>
  bool MainWindow::FileExists(const QString &FileName)
  {
  {
     QFileInfo FileInfo(FileName);
     QFileInfo FileInfo(FileName);
394行目: 318行目:
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
また、<code>QFile</code>クラスを使用する場合は、以下のように記述する。<br>
<syntaxhighlight lang="c++">
if(QFile::exists("<ファイルのパス>"))
{  // ファイルが存在する場合
}
else
{  // ファイルが存在しない場合
}
</syntaxhighlight>
<br>
==== ファイルタイプの取得 ====
==== ファイルタイプの取得 ====
ファイルタイプの確認において、ファイルは1、ディレクトリは2、その他は0を返す。<br>
ファイルタイプの確認において、ファイルは1、ディレクトリは2、その他は0を返す。<br>
487行目: 424行目:
|}
|}
</center>
</center>
<br><br>
== ファイルの検索 ==
==== QDirを使用する ====
<syntaxhighlight lang="c++">
QString path = QApplication::applicationDirPath() + "/images/";
QStringList nameFilters;
nameFilters.append("*.png");
nameFilters.append("*.jpg");
QDir dir(path);
QStringList entry = dir.entryList(nameFilters, QDir::Files);
for(QString file : entry)
{  // 検索して見つかったファイル群
    qDebug() << dir.filePath(file);
}
</syntaxhighlight>
<br>
==== QDirIteratorを使用する ====
<syntaxhighlight lang="c++">
QString path = QApplication::applicationDirPath() + "/images/";
QStringList nameFilters;
nameFilters.append("*.png");
nameFilters.append("*.jpg");
QDirIterator itDirs(path, nameFilters, QDir::Files);
while(itDirs.hasNext())
{
    QString file = itDirs.next();
    qDebug() << file;
}
</syntaxhighlight>
<br><br>
<br><br>


510行目: 481行目:
   return list;
   return list;
  }
  }
</syntaxhighlight>
<br>
<u>再帰呼び出しを使用せずに、サブディレクトリまで検索することもできる。</u><br>
<syntaxhighlight lang="c++">
QString path = QApplication::applicationDirPath() + "/images/";
QStringList nameFilters;
nameFilters.append("*.png");
nameFilters.append("*.jpg");
QDirIterator itDirs(path, nameFilters, QDir::Files, QDirIterator::Subdirectories);
while(itDirs.hasNext())
{
    QString file = itDirs.next();
    qDebug() << file;
}
</syntaxhighlight>
<br><br>
== 一時ファイル ==
一時ファイルを作成するには、<code>QTemporaryFile</code>クラスを使用する。<br>
<br>
<code>QFile</code>クラスと異なる点は、以下の通りである。<br>
* 常に読み書きモードで開く。
* ファイルパスが衝突しない。
* デストラクタが呼び出されたら自動的に削除される。
<br>
特に、ファイル名には重複した名前が付かない仕組みになっている。(ファイルパスが衝突しないことは重要である)<br>
ファイル名を重複しないように、"<ソフトウェア名>.<xxx>"のような名前を付けて、システムディレクトリに保存される。<br>
<br>
以下の例では、既存のファイルをシステムディレクトリの一時ファイルとしてコピーしている。<br>
<br>
一時ファイルのパスは、<code>fileTemplate</code>メソッドから取得できる。<br>
(<code>setFileTemplate</code>メソッドを使用して、一時ファイルのパスを変更することもできる)<br>
他は、<code>QFile</code>クラスの使用方法と同様である。<br>
<syntaxhighlight lang="c++">
QTemporaryFile TmpFile;
 
QFile::copy("<既存ファイルのパス>", TmpFile.fileTemplate());
TmpFile.open();
// ...略
  </syntaxhighlight>
  </syntaxhighlight>
<br><br>
<br><br>
== メモリマップファイル ==
メモリマップファイルとは、メモリ空間の一部のように直接読み書きできるファイルのことである。<br>
<br>
メモリマップファイルのメリットを以下に示す。<br>
* 高速にアクセスすることが可能である。
* メモリ内容を書き換えることにより、ファイルの内容を更新できる。
* 大きなサイズのファイルを扱う場合、使用するメモリ量が少ない。
<br>
メモリマッピングには、<code>QFileDevice</code>クラスの<code>map</code>メソッドを使用する。<br>
# <code>QFile</code>クラスを使用して、ファイルを作成または開く。
# <code>map</code>メソッドを使用して、ファイルの内容をメモリにマッピングする。<br>マッピングに成功した場合、ファイルのメモリ空間を<code>unsigned char</code>型の配列として返す。<br>それを介して、ファイルを読み書きすることが可能となる。
# マッピングした内容を読み書きする。
# メモリをアンマッピングする。
<br>
<code>QFile</code>クラスのデストラクタが呼ばれた場合、または、同じインスタンスで新しいファイルを開いた場合は、自動的にアンマッピングされる。<br>
<br>
以下の例では、既存のファイルを開いて10文字目の文字を書き換えている。<br>
<syntaxhighlight lang="c++">
// ファイルを開く
QFile file("Sample.txt");
file.open(QFile::ReadWrite);
// ファイルの内容をメモリにマッピング
unsigned char *pMem = file.map(0, file.size());
// 10文字目を書き換える
pMem[10] = 'A';
// メモリをアンマッピング
file.unmap(memory);
// ファイルを閉じる
file.close();
</syntaxhighlight>
<br><br>
== ファイルパス ==
==== 絶対パスの検証 ====
ファイルのパスがファイルシステム上で有効な形式を持っているかどうか (例: 不正な文字、パスの構造がシステムの要件を満たしているか等) を検証する。<br>
<br>
Qtでは、有効なパスが有効かどうかを検証するメソッドは存在しない。<br>
しかし、<code>QFileInfo</code>クラスおよび<code>QDir</code>クラスを使用して間接的にパスの妥当性を検証することができる。<br>
<syntaxhighlight lang="c++">
#include <QFileInfo>
#include <QDir>
// QFileInfoを使ってパスの情報を取得
QFileInfo FileInfo("/tmp/sample.txt");
// ファイル名に使用できない文字が含まれているかどうかを確認
QString fileName = FileInfo.fileName();
if (fileName.isEmpty() || fileName.contains(QRegExp("[\/\\0]"))) {
    // ファイル名に不適切な文字が含まれている場合
    return false;
}
// パスが絶対パスかどうかを確認 (相対パスは不適切とする)
if (!FileInfo.isAbsolute()) {
    return false;
}
</syntaxhighlight>
<br>
==== 相対パスの確認 ====
相対パスの場合、基準となるディレクトリからの解決が可能かどうかを確認する。<br>
相対パスは特定のディレクトリを基準として解釈されるため、その基準ディレクトリから相対パスを解決 (絶対パスに変換) することにより、パスが想定通りの形式であるかを検証できる。<br>
<br>
以下の例では、指定された基準ディレクトリ(basePath)から相対パス(relativePath)を解決して絶対パスに変換して、その絶対パスに対してファイル名が適切な形式を持つかどうか等の検証を行っている。<br>
実際のシナリオでは、更に詳細な検証が必要になるが、このように相対パスを絶対パスに変換して検証することになる。<br>
<syntaxhighlight lang="c++">
#include <QDir>
QString basePath    = "<基準ディレクトリ>";
QString relativePath = "<相対パス>";
QDir baseDir(basePath);
QString resolvedPath = baseDir.absoluteFilePath(relativePath);
// 解決されたパスを確認 (不正な文字等)
QFileInfo FileInfo(resolvedPath);
QString fileName = FileInfo.fileName();
if (fileName.isEmpty() || fileName.contains(QRegExp("[\/\\0]"))) {
    // ファイル名に不適切な文字が含まれている場合
    return false;
}
</syntaxhighlight>
<br><br>


__FORCETOC__
__FORCETOC__
[[カテゴリ:Qt]]
[[カテゴリ:Qt]]
「http://mochiuwiki.e2.valueserver.jp/index.php?title=Qtの基礎_-_ファイル」から取得