「Qtの基礎 - HTML」の版間の差分

📢 Webサイト閉鎖と移転のお知らせ

このWebサイトは2026年9月に閉鎖いたします。

移転先はhttps://mochiu.net/index.php?title=Qtの基礎 - HTMLです。

新しい記事は移転先で追加しております。（旧サイトでは記事を追加しておりません）

← 古い編集

ビジュアルウィキテキスト

2024年10月14日 (月) 10:58時点における最新版

概要

Qtでは、HTMLを詳細にパースするライブラリが存在しないため、外部ライブラリを使用する必要がある。

HTMLがパースできるライブラリを、以下に示す。

libxml2
概要

libxml2は、XML文書を解析し、XPathクエリを実行するための非常に人気があるC言語ライブラリである。

C++からも使用可能である。

XPathサポート

XPath 1.0をサポートしている。
TinyXML-2
概要

軽量で簡単に使用できるC++のXML解析ライブラリである。

XPathの直接的なサポートは無いが、XMLノードを簡単に走査して目的のデータを見つけるための機能がある。

XPathサポート

直接的なXPathサポートは無いが、独自の検索関数を記述することで類似の機能を実現できる。
PugiXML
概要

軽量かつ高速なXML解析ライブラリで、C++で開発されている。

XPathサポート

XPath 1.0をフルサポートしており、HTMLやXMLファイルからのデータ抽出に適している。
Xerces-C++
概要

Apache Software Foundationにより開発された高性能なXML解析ライブラリである。

DOM、SAX、XPath 1.0をサポートしている。

XPathサポート

XPath 1.0をサポートしている。

XPath

libxml2ライブラリ

libxml2ライブラリとは

libxml2ライブラリは、XMLの処理に主眼を置いているが、HTMLの解析と操作にも対応している。
HTMLはXMLと比較して構造が緩やかであり、しばしば厳密な文法規則に従っていないため、libxml2ライブラリはHTMLの特性に合わせた機能を提供している。

libxml2ライブラリは、整形式でないHTMLドキュメントを解析する能力を持っている。
これは、閉じタグの欠落や属性値の引用符の省略等、Webページでよく見られる不完全なマークアップを適切に処理できることを意味する。
libxml2ライブラリは、可能な限りドキュメントの構造を推測して、妥当なDOM (Document Object Model) ツリーを構築する。

HTMLの解析には、libxml2ライブラリのhtmlParserモジュールが使用される。
このモジュールは、一般的なHTMLの特殊性、例えば大文字小文字を区別しない要素名、空要素の処理、特定の要素に対するデフォルトの属性の追加等を考慮している。

libxml2ライブラリを使用することにより、HTMLドキュメントの読み込み、要素や属性の追加・変更・削除、DOMツリーの操作が可能である。
また、XPath式を使用してHTML文書内の特定の要素を検索することもできる。

WebスクレイピングやHTMLコンテンツの自動生成、既存のHTMLドキュメントの修正等のタスクにおいて、libxml2ライブラリは有用なツールとなる。
ただし、モダンなWebアプリケーションで使用される動的なJavaScriptコンテンツの処理には制限があることに注意が必要である。

libxml2ライブラリは、HTMLをXHTML (XML準拠のHTML) に変換する機能も提供している。
これにより、既存のHTMLコンテンツをより厳格なXML処理パイプラインに統合することが可能となる。

このように、libxml2ライブラリはHTMLの処理においても柔軟性と堅牢性を提供して、Webコンテンツを扱う多くのアプリケーションで重要な役割を果たしている。

libxml2ライブラリのライセンス

libxml2ライブラリのライセンスは、MITライセンスに準拠している。

libxml2ライブラリのインストール

パッケージ管理システムからインストール

# RHEL
sudo dnf install libxml2-devel

# SUSE
sudo zypper install libxml2-devel

ソースコードからインストール

libxml2ライブラリのビルドに必要なライブラリをインストールする。

# RHEL
sudo dnf install cmake python3-devel \
                 zlib-devel         # zlibライブラリを使用する場合
                 xz-devel           # lzmaライブラリを使用する場合
                 readline-devel     # Readlineライブラリを使用する場合
                 libicu-devel       # ICUライブラリを使用する場合
                 meson ninja-build  # MesonおよびNinjaでビルドする場合

# SUSE
sudo zypper install cmake python3-devel \
                    zlib-devel      # zlibライブラリを使用する場合
                    xz-devel        # lzmaライブラリを使用する場合
                    readline-devel  # Readlineライブラリを使用する場合
                    libicu-devel    # ICUライブラリを使用する場合
                    meson ninja     # MesonおよびNinjaでビルドする場合

libxml2ライブラリのGithub、または、libxml2ライブラリのGithubにアクセスして、ソースコードをダウンロードする。
ダウンロードしたファイルを解凍する。

tar xf libxml2-v<バージョン>.tar.gz
cd libxml2-v<バージョン>

libxml2ライブラリをビルドおよびインストールする。

mkdir build && cd build

# CMakeを使用する場合
cmake -DCMAKE_BUILD_TYPE=Release  \
      -DCMAKE_INSTALL_PREFIX=<libxml2ライブラリのインストールディレクトリ> \
      -DLIBXML2_WITH_HTTP=ON      \  # HTTPをサポートする場合
      -DLIBXML2_WITH_READLINE=ON  \  # Readlineを使用する場合
      -DLIBXML2_WITH_ICU=ON       \  # ICUライブラリを使用する場合
      -DLIBXML2_WITH_ZLIB=ON      \  # zlibライブラリを使用する場合
      -DLIBXML2_WITH_LZMA=ON      \  # lzmaライブラリを使用する場合
      ..
make -j $(nproc)
make install

# MesonおよびNinjaを使用する場合
meson setup ./build                                  \
      -Dprefix=<libxml2ライブラリのインストールディレクトリ> \
      -Dhttp=enabled                                   \
      -Dicu=enabled                                    \
      -Dlzma=enabled                                   \
      -Dzlib=enabled
ninja -C ./build
ninja -C ./build install

要素の取得

以下の例では、WebページのHTMLをダウンロードして、<head>タグ内の<title>タグの値を抽出している。

具体的には、まず、QNetworkAccessManagerクラスを使用してHTTPリクエストを送信して、QNetworkReplyクラスを使用してレスポンスを受信する。
次に、libxml2ライブラリを使用して、受信したレスポンスから<head>タグ内の<title>タグの値を抽出する。

libxml2ライブラリは、C言語で記述されたライブラリであるため、メモリ管理には特に注意が必要である。
例えば、xmlFreeDoc関数、xmlXPathFreeContext関数、xmlFree関数等を適切に使用すること。

 # Qtプロジェクトファイル (.pro)
 
 # Pkg-configを使用する場合
 CONFIG += link_pkgconfig
 PKGCONFIG += libxml-2.0
 
 # Pkg-Configを使用しない場合
 LIBS += -lxml2
 INCLUDEPATH += /<libxml2のインストールディレクトリ>/include/libxml2

 # CMakeLists.txtファイル
 
 # pkg-configを使うための準備
 find_package(PkgConfig REQUIRED)
 
 # pkg-configを使用してlibxml2ライブラリを検索
 pkg_search_module(LIBXML2 REQUIRED libxml-2.0)
 
 # ライブラリのインクルードディレクトリをターゲットに追加
 include_directories(${LIBXML2_INCLUDE_DIRS})
 
 # ライブラリのリンクディレクトリをターゲットに追加
 link_directories(${LIBXML2_LIBRARY_DIRS})
 
 target_include_directories(<プロジェクト名> PRIVATE
     # ...略
     ${LIBXML2_INCLUDE_DIRS}
 )
 
 target_link_libraries(<プロジェクト名>
     # ...略
     ${LIBXML2_LIBRARIES}
 )
 
 # libxml2のコンパイルオプション
 add_definitions(
     # ...略
     ${LIBXML2_CFLAGS_OTHER}
 )

 // main.h
 
 #ifndef MAIN_H
 #define MAIN_H
 
 #include <QCoreApplication>
 #include <QNetworkAccessManager>
 #include <QNetworkReply>
 
 class HtmlTitleFetcher : public QObject {
    Q_OBJECT
 
 private:
    QNetworkAccessManager *m_pManager;
    QNetworkReply         *m_pReply;
    QUrl url;
 
 private:
     void parseHtml(const QByteArray &htmlData);
 
 public:
    HtmlTitleFetcher(const QUrl &url, QObject *parent = nullptr);
 
 private slots:
    void onFinished();
 };
 
 #endif // MAIN_H

 // main.cpp
 
 #include <libxml/HTMLparser.h>
 #include <libxml/xpath.h>
 #include "main.h"
 
 HtmlTitleFetcher::HtmlTitleFetcher(const QUrl &url, QObject *parent) : QObject(parent), url(url)
 {
    m_pManager = new QNetworkAccessManager(this);
    QNetworkRequest request(url);
    m_pReply = manager->get(request);
    connect(m_pReply, SIGNAL(finished()), this, SLOT(onFinished()));
 }
 
 void HtmlTitleFetcher::onFinished()
 {
    if (m_pReply->error() == QNetworkReply::NoError) {
       QByteArray htmlData = m_pReply->readAll();
       parseHtml(htmlData);
    }
    else {
       std::cerr << QString("エラー : %1").arg(m_pReply->errorString()).toStdString() << std::endl;
    }
 
    reply->deleteLater();
 }
 
 void HtmlTitleFetcher::parseHtml(const QByteArray &htmlData)
 {
    htmlDocPtr doc = htmlReadMemory(htmlData.data(), htmlData.size(), nullptr, "UTF-8", HTML_PARSE_RECOVER | HTML_PARSE_NOERROR | HTML_PARSE_NOWARNING);
    if (doc == nullptr) {
       std::cerr << QString("HTMLデータのパースに失敗").toStdString() << std::endl;
       return;
    }
 
    xmlXPathContextPtr context = xmlXPathNewContext(doc);
    if (context == nullptr) {
       xmlFreeDoc(doc);
       std::cerr << QString("XPathの生成に失敗").toStdString() << std::endl;
       return;
    }
 
    xmlXPathObjectPtr result = xmlXPathEvalExpression((const xmlChar*)"//title", context);
    if (result == nullptr) {
       xmlXPathFreeContext(context);
       xmlFreeDoc(doc);
       std::cerr << QString("XPath式の評価に失敗").toStdString() << std::endl;
       return;
    }
 
    xmlNodeSetPtr nodeset = result->nodesetval;
    if (xmlXPathNodeSetIsEmpty(nodeset)) {
       std::cerr << QString("<title>タグが存在しません").toStdString() << std::endl;
    }
    else {
       xmlNodePtr cur = nodeset->nodeTab[0];
       if (cur != nullptr && cur->children != nullptr) {
          xmlChar *content = xmlNodeGetContent(cur);
          std::cerr << QString("<title>タグの値 : %1").arg(QString((char *)content)).toStdString() << std::endl;
          xmlFree(content);
       }
    }
 
    xmlXPathFreeObject(result);
    xmlXPathFreeContext(context);
    xmlFreeDoc(doc);
 }
 
 int main(int argc, char *argv[])
 {
    QCoreApplication app(argc, argv);
 
    QUrl url("https://www.example.com");
    HtmlTitleFetcher fetcher(url);
 
    return app.exec();
 }

LIBXML_TEST_VERSIONマクロは、libxml2ライブラリを使用する場合に、ライブラリのバージョンが使用者のプログラムが期待するものと一致していることを保証するために用いられる。
このマクロは、libxml2のヘッダファイルをインクルードした後に呼び出すことにより、プログラムがリンクされるlibxml2ライブラリのバージョンがヘッダファイルで定義されているバージョンと互換性があるかどうかを確認する。
もし互換性が無ければ、実行時にエラーが発生する。

LIBXML_TEST_VERSIONマクロを使用する主な理由は、APIの非互換性による問題を防ぐことである。
libxml2ライブラリは頻繁に更新されるため、新しいバージョンのライブラリには古いバージョンのコードとは互換性のない新機能や変更が含まれることがある。
LIBXML_TEST_VERSIONマクロを使用することにより、開発中にこの種の問題を早期に検出して対処することができる。

したがって、LIBXML_TEST_VERSIONマクロの記述は必須ではないが、
ライブラリのバージョンに依存する可能性のあるプログラムを開発している場合、特にライブラリの更新によって互換性の問題が生じる可能性がある場合には、このマクロを使用することを推奨する。

これにより、将来的な互換性の問題を防ぐことができ、より安定したソフトウェアの開発が可能になる。

文字実体参照 / 数値文字参照

HMTLの文字実体参照や数値文字参照を通常の文字に変換する。

 # CMakeを使用する場合
 find_package(QT NAMES Qt6 Qt5 REQUIRED COMPONENTS Gui)
 find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS Gui)
 
 pkg_check_modules(QT_GUI Qt${QT_VERSION_MAJOR}Gui REQUIRED IMPORTED_TARGET)
 
 target_link_libraries(<ターゲット名>
     Qt${QT_VERSION_MAJOR}::Gui
 )

 # QMakeを使用する場合
 QT += gui

 #include <QTextDocumentFragment>
 
 // 文字実体参照や数値文字参照を変換
 QString plainText = QTextDocumentFragment::fromHtml(htmlString).toPlainText();

@@ 36行目: / 36行目: @@
 == XPath ==
+==== libxml2ライブラリ ====
+===== libxml2ライブラリとは =====
+libxml2ライブラリは、XMLの処理に主眼を置いているが、HTMLの解析と操作にも対応している。<br>
+HTMLはXMLと比較して構造が緩やかであり、しばしば厳密な文法規則に従っていないため、libxml2ライブラリはHTMLの特性に合わせた機能を提供している。<br>
+<br>
+libxml2ライブラリは、整形式でないHTMLドキュメントを解析する能力を持っている。<br>
+これは、閉じタグの欠落や属性値の引用符の省略等、Webページでよく見られる不完全なマークアップを適切に処理できることを意味する。<br>
+libxml2ライブラリは、可能な限りドキュメントの構造を推測して、妥当なDOM (Document Object Model) ツリーを構築する。<br>
+<br>
+HTMLの解析には、libxml2ライブラリのhtmlParserモジュールが使用される。<br>
+このモジュールは、一般的なHTMLの特殊性、例えば大文字小文字を区別しない要素名、空要素の処理、特定の要素に対するデフォルトの属性の追加等を考慮している。<br>
+<br>
+libxml2ライブラリを使用することにより、HTMLドキュメントの読み込み、要素や属性の追加・変更・削除、DOMツリーの操作が可能である。<br>
+また、XPath式を使用してHTML文書内の特定の要素を検索することもできる。<br>
+<br>
+WebスクレイピングやHTMLコンテンツの自動生成、既存のHTMLドキュメントの修正等のタスクにおいて、libxml2ライブラリは有用なツールとなる。<br>
+<u>ただし、モダンなWebアプリケーションで使用される動的なJavaScriptコンテンツの処理には制限があることに注意が必要である。</u><br>
+<br>
+libxml2ライブラリは、HTMLをXHTML (XML準拠のHTML) に変換する機能も提供している。<br>
+これにより、既存のHTMLコンテンツをより厳格なXML処理パイプラインに統合することが可能となる。<br>
+<br>
+このように、libxml2ライブラリはHTMLの処理においても柔軟性と堅牢性を提供して、Webコンテンツを扱う多くのアプリケーションで重要な役割を果たしている。<br>
+<br>
+===== libxml2ライブラリのライセンス =====
+libxml2ライブラリのライセンスは、MITライセンスに準拠している。<br>
+<br>
+===== libxml2ライブラリのインストール =====
+* パッケージ管理システムからインストール
+ # RHEL
+ sudo dnf install libxml2-devel
+ # SUSE
+ sudo zypper install libxml2-devel
+<br>
+* ソースコードからインストール
+libxml2ライブラリのビルドに必要なライブラリをインストールする。<br>
+ # RHEL
+ sudo dnf install cmake python3-devel \
+                  zlib-devel         # zlibライブラリを使用する場合
+                  xz-devel           # lzmaライブラリを使用する場合
+                  readline-devel     # Readlineライブラリを使用する場合
+                  libicu-devel       # ICUライブラリを使用する場合
+                  meson ninja-build  # MesonおよびNinjaでビルドする場合
+ # SUSE
+ sudo zypper install cmake python3-devel \
+                     zlib-devel      # zlibライブラリを使用する場合
+                     xz-devel        # lzmaライブラリを使用する場合
+                     readline-devel  # Readlineライブラリを使用する場合
+                     libicu-devel    # ICUライブラリを使用する場合
+                     meson ninja     # MesonおよびNinjaでビルドする場合
+<br>
+[https://gitlab.gnome.org/GNOME/libxml2 libxml2ライブラリのGithub]、または、[https://github.com/GNOME/libxml2 libxml2ライブラリのGithub]にアクセスして、ソースコードをダウンロードする。<br>
+ダウンロードしたファイルを解凍する。<br>
+ tar xf libxml2-v<バージョン>.tar.gz
+ cd libxml2-v<バージョン>
+<br>
+libxml2ライブラリをビルドおよびインストールする。<br>
+ mkdir build && cd build
+ # CMakeを使用する場合
+ cmake -DCMAKE_BUILD_TYPE=Release  \
+       -DCMAKE_INSTALL_PREFIX=<libxml2ライブラリのインストールディレクトリ> \
+       -DLIBXML2_WITH_HTTP=ON      \  # HTTPをサポートする場合
+       -DLIBXML2_WITH_READLINE=ON  \  # Readlineを使用する場合
+       -DLIBXML2_WITH_ICU=ON       \  # ICUライブラリを使用する場合
+       -DLIBXML2_WITH_ZLIB=ON      \  # zlibライブラリを使用する場合
+       -DLIBXML2_WITH_LZMA=ON      \  # lzmaライブラリを使用する場合
+       ..
+ make -j $(nproc)
+ make install
+ # MesonおよびNinjaを使用する場合
+ meson setup ./build                                  \
+       -Dprefix=<libxml2ライブラリのインストールディレクトリ> \
+       -Dhttp=enabled                                   \
+       -Dicu=enabled                                    \
+       -Dlzma=enabled                                   \
+       -Dzlib=enabled
+ ninja -C ./build
+ ninja -C ./build install
+<br>
+===== 要素の取得 =====
 以下の例では、WebページのHTMLをダウンロードして、<head>タグ内の<title>タグの値を抽出している。<br>
 <br>
@@ 45行目: / 129行目: @@
 <br>
   <syntaxhighlight lang="make">
-  # QMakeを使用する場合
+  # Qtプロジェクトファイル (.pro)
+ # Pkg-configを使用する場合
+ CONFIG += link_pkgconfig
+ PKGCONFIG += libxml-2.0
+ # Pkg-Configを使用しない場合
   LIBS += -lxml2
   INCLUDEPATH += /<libxml2のインストールディレクトリ>/include/libxml2
@@ 51行目: / 141行目: @@
 <br>
   <syntaxhighlight lang="cmake">
-  # CMakeを使用する場合
+  # CMakeLists.txtファイル
+ # pkg-configを使うための準備
+ find_package(PkgConfig REQUIRED)
   # pkg-configを使用してlibxml2ライブラリを検索
@@ 188行目: / 281行目: @@
      return app.exec();
   }
+ </syntaxhighlight>
+<br>
+<code>LIBXML_TEST_VERSION</code>マクロは、libxml2ライブラリを使用する場合に、ライブラリのバージョンが使用者のプログラムが期待するものと一致していることを保証するために用いられる。<br>
+このマクロは、libxml2のヘッダファイルをインクルードした後に呼び出すことにより、プログラムがリンクされるlibxml2ライブラリのバージョンがヘッダファイルで定義されているバージョンと互換性があるかどうかを確認する。<br>
+もし互換性が無ければ、実行時にエラーが発生する。<br>
+<br>
+<code>LIBXML_TEST_VERSION</code>マクロを使用する主な理由は、APIの非互換性による問題を防ぐことである。<br>
+libxml2ライブラリは頻繁に更新されるため、新しいバージョンのライブラリには古いバージョンのコードとは互換性のない新機能や変更が含まれることがある。<br>
+<code>LIBXML_TEST_VERSION</code>マクロを使用することにより、開発中にこの種の問題を早期に検出して対処することができる。<br>
+<br>
+したがって、<code>LIBXML_TEST_VERSION</code>マクロの記述は必須ではないが、<br>
+ライブラリのバージョンに依存する可能性のあるプログラムを開発している場合、特にライブラリの更新によって互換性の問題が生じる可能性がある場合には、このマクロを使用することを推奨する。<br>
+<br>
+これにより、将来的な互換性の問題を防ぐことができ、より安定したソフトウェアの開発が可能になる。<br>
+<br><br>
+== 文字実体参照 / 数値文字参照 ==
+HMTLの文字実体参照や数値文字参照を通常の文字に変換する。<br>
+<br>
+ <syntaxhighlight lang="cmake">
+ # CMakeを使用する場合
+ find_package(QT NAMES Qt6 Qt5 REQUIRED COMPONENTS Gui)
+ find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS Gui)
+ pkg_check_modules(QT_GUI Qt${QT_VERSION_MAJOR}Gui REQUIRED IMPORTED_TARGET)
+ target_link_libraries(<ターゲット名>
+     Qt${QT_VERSION_MAJOR}::Gui
+ )
+ </syntaxhighlight>
+<br>
+ <syntaxhighlight lang="make">
+ # QMakeを使用する場合
+ QT += gui
+ </syntaxhighlight>
+<br>
+ <syntaxhighlight lang="c++">
+ #include <QTextDocumentFragment>
+ // 文字実体参照や数値文字参照を変換
+ QString plainText = QTextDocumentFragment::fromHtml(htmlString).toPlainText();
   </syntaxhighlight>
 <br><br>
+{{#seo:
+|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
+|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
+|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
+|image=/resources/assets/MochiuLogo_Single_Blue.png
+}}
 __FORCETOC__
 [[カテゴリ:Qt]]