Notes C API探訪: 数値をテキストにコンバートする
前回までの「Qt5再入門」15回シリーズでお届けしたコンバートシミュレーターダイアログで、Qt5のウィジェット開発機能を使ったGUIを構築してきました。このダイアログはあくまでUI、入出力の手段であって、本命は今回以降の「数値、日時とテキストとの相互コンバート」になります。今回は数値からテキストへのコンバートについて扱います。
前回の記事で紹介したソースコードに、以下の記述がありました。
// convertsimulatordialog.cppから抜粋
void ConvertSimulatorDialog::convertNumberToText() {
nxpp::NumberToTextConverter converter;
setIntlFormat(&converter);
setNumberFormat(&converter);
try {
bool ok = false;
double num = ui->numberToTextSrcLineEdit->text().toDouble(&ok);
if (!ok) {
consoleLog(tr("Unable to convert numbers to text.")); // throwもあり
return;
}
nxpp::Lmbcs text = converter(&num);
ui->numberToTextDestLineEdit->setText(fromLmbcsQ(text));
}
// Notesステータスがスローされたらそのエラーメッセージに変換して表示
catch (nxpp::Status &status) {
consoleLog(nxpp::qt::fromStatus(status.error()));
}
// それ以外の例外ならそのメッセージを表示
catch (std::exception &ex) {
std::string what(ex.what());
consoleLog(QString::fromStdString(what));
}
}この中に、nxpp::NumberToTextConverter という、私が定義したクラスがあります。これは数値からテキストに変換するクラスで、 operator () を備えているので、「関数オブジェクト」として使用することができます。
まずは定義を見ていきます。
// nxpp/include/nxpp/nxpp_number.hpp
// ...
namespace nxpp {
// ...
class NumberToTextConverter
: public NumberConverter
{
public:
NumberToTextConverter() : NumberConverter() {}
NumberToTextConverter(
intl::SettingsPtr iPtr,
NumberFormatPtr nPtr
)
: NumberConverter(iPtr, nPtr)
{}
Lmbcs operator () (NUMBER *pNum) const {
char buffer[MAXALPHANUMBER] = "";
WORD len = 0;
Status status = ConvertFLOATToText(
!intlSettingsPtr_ ? nullptr : intlSettingsPtr_->data(),
!formatPtr_ ? nullptr : formatPtr_->data(),
pNum,
buffer,
MAXALPHANUMBER,
&len
);
if (!status) { throw status; }
return Lmbcs(buffer, len);
}
};
// ...
} // namespace nxpp
// ...関数オブジェクトの「関数機能」実装がメインで、NUMBERポインタを受け取り、ConvertFLOATToText関数を呼び出して、数値をテキストに変換し、LMBCS文字列として返しています。
ConvertFLOATToText関数は、INTLFORMATとNFMTを受け入れることができるので、このオブジェクト関数のオブジェクト内に、設定があればそれらを使用し、なければヌルポインタでConvertFLOATToText関数を呼び出すようになっています。
さて、この関数オブジェクトクラスの継承元 NumberConverter はどうなっているのか見てみます。
// nxpp/include/nxpp/nxpp_number.hpp
// ...
namespace nxpp {
// ...
using NumberFormatPtr = std::shared_ptr<NumberFormat>;
class NumberConverter
: public intl::ConverterBase<NumberFormat>
{
public:
NumberConverter() : intl::ConverterBase<NumberFormat>() {}
NumberConverter(
intl::SettingsPtr iPtr,
NumberFormatPtr nPtr
)
: intl::ConverterBase<NumberFormat>(iPtr, nPtr)
{}
};
// ...
} // namespace nxpp
// ...コード中の NumberFormat は、以前紹介したNFMT構造体のラップクラスです。
このクラスは、さらに intl::ConverterBase テンプレートクラスを継承元にしていますので、これも定義を見てみます。
// nxpp/include/nxpp/nxpp_intl.hpp
// ...
namespace nxpp::intl {
// ...
using SettingsPtr = std::shared_ptr<Settings>;
template <class T>
class ConverterBase
{
protected:
SettingsPtr intlSettingsPtr_;
std::shared_ptr<T> formatPtr_;
public:
ConverterBase() : intlSettingsPtr_() , formatPtr_() {}
ConverterBase(
intl::SettingsPtr iPtr,
std::shared_ptr<T> tPtr
)
: intlSettingsPtr_(iPtr)
, formatPtr_(tPtr)
{}
void setIntlSettings(SettingsPtr sPtr) {
intlSettingsPtr_ = sPtr;
}
void setFormat(std::shared_ptr<T> ptr) {
formatPtr_ = ptr;
}
};
// ...
} // namespace nxpp::intl
// ...メンバ変数として、INTLFORMATをラップしたクラスのスマートポインタと、NFMTまたはTFMTをラップしたクラスのスマートポインタを有します。これらは、デフォルトではヌルポインタとなっています。API関数 Convert***ToText、またはConvertTextTo***では、ヌルポインタは「設定なし」と見立てて処理できるので、その仕様に合わせています。
フォーマットを調整して適用したい場合、それぞれのスマートポインタを受け入れられるようにもなっています。
まとめ
今回は、ご紹介予定の関数オブジェクトクラスのうちから1つだけ紹介しました。
1. 数値 → テキスト (今回紹介済み)
2. テキスト → 数値
3. 日時 → テキスト
4. テキスト → 日時
残りの3つも、原則今回のクラスの設計と同じようなスタイルを踏襲しています。予定としては、次回に2番を、以降に3と4をご紹介する予定です。
実は、3と4は日時が絡みますが、Qtの日時ウィジェットからNotes C APIのTIMEDATE構造体に変換したり、その逆の変換もしなくてはいけません。API自体は「Notes C API探訪: TIME(データ型)」の回でご紹介しているので、そのラップコードも一緒にご紹介していきたいと思います。