dkutil Tutorial 1.0x用

DxLibFanに戻る

最初に･･･
dkutilとは
最初に必要なもの
dkutilを使うのに必要なツール、ライブラリ
VisualC++での使い方
~~Dev-C++での使い方~~
dkutilのコンパイルオプション
主要関数使い方
主要クラス使い方
private class の使い方
common interface (共通インターフェイス仕様)
sample サンプル
Licence (ライセンス) (使用条件) (とても緩い使用条件ですよ^^；)
Frequency asked Question (よく聞かれる質問) (FAQ) (Q & A)
download dkutil (dkutilをダウンロードする)

最初に･･･

略称解説

ＤＫＵＴ :dKingyo Utility Toolkit
ＤＫＵＴＰ：dKingyo Utility Toolkit Project
以下の語句は多分、e-wordなどで資料が出てきます。
あとはGoogleに頼るのが一番だと思います。

LGPL
GPL
BSD Licence
ライブラリ
DLL
VC
C++
C言語
HTML
Java

dkutilとは

簡単に言うと、Windowsのソフトを作る際に面倒な処理を肩代わりしてくれるライブラリです。
詳しくは sourceforgeのページのdkutilのページに書いています。

最初に必要なもの

クラスを使える程度のC++の知識
ちょっとしたパソコン用語を検索する能力(例：パスとかライブラリとかクラスとか)
そのような用語を調べるにはe-wordとかASCII デジタル用語辞典を使ってください。非常に簡単にすばやく調べられ効率的に学習できます＾＾

dkutilを使うのに必要なもの

C++コンパイラ(VisualC++6.0以降奨励,~~Dev-C++ (MinGWは最新版のもの)~~
boost 1.30.2 以降 | download |
関連：鼻血Boost(StudioKingyo内)
注意：
VisualC++6,0でdkutilを使う場合はboost 1.30.2を使わないとboost::spiritをコンパイルできません。
Loki 最新版 | download |
関連：Loki Memo(StudioKingyo内)
注意：
dkutil1.03からLokiは使わなくても良くなりました。
STLPort 4.6以降 |
注意：
dkutilはSTLPortが無くてもコンパイルできると思うが、試した事が無いので定かではない。
STLPortを使わないのであれば、libファイル内のdkutil.lib等は使ってはいけない。なぜなら、STLPort用にコンパイルされたものだからだ。
よって、自分でdkutilを設定し、コンパイルする必要がある。
dkutil_c
dkutil_c（以下dkc)はC言語用の簡易ライブラリです。
ちょっとした機能郡がたくさん入っています。詳しくはdkutil_cチュートリアルのページで注意：
dkutil_parser
dkutilのパーサーの機能をdkutil_parserとして分離してしまいました。
デフォルトではdkutilはdkutil_parserをincludeします。 NOT_USE_DKP_BOOST_SPIRIT等をdkutilをインクルードする前に定義することにより、コンパイル時間が短くなる等の恩恵が得られるかもしれません。
注意：
boostの注意を見てみてください。

VisualC++での使い方

設定方法 VCパワーユーザー向け要約

c:\dkutilが解凍したパスがなっている場合、includeファイルのパス指定にC:\を･･･
ライブラリファイルのパス指定をc:\dkutil\libに･･･
プリコンパイル済みヘッダに以下のコードをコピペする。
/* これを定義することによってVisualC++の場合、いっしょにライブラリファイルも読み込んでくれる。 */ #define DKUTIL_MSVC_IMPORT_LIB //dkutilのすべてをインクルード #include <dkutil/include/dkutilAllInclude.h>
これでdkutilの機能をほぼすべて使うことができる。

主要クラス使い方

private class の使い方

dkutil::private_ namespace内にあるのがそれです。このネームスペース内の関数は実際、あまり、使ってほしくない非奨励、開発者向け、ただ今、バグ取り版のネームスペースだったのですが、最近のものはほとんどバグが取れちゃいましたね。（まだあるかも）
その中で、特にお勧め名CSVParserクラスとCSVAnalyzerクラスの使い方を解説します。
クラス概要
CVSParser
CVSAnalyzer

How to use
まずはサンプルソースを。って、ｶﾞ━━(ﾟДﾟ;)━━━ﾝ!!　新たなバグを発見･･･ちょっと直す。（でも他にもありそう)これだから文字列処理は･･･。
お正月はこいつと格闘か･･･。いちおう、バグありのクラスだったけども、サンプルソースを書いたので載せておきます。

2003/12/29:ちなみにバグは9999999999999を上手くCSVAnalyzerで解析できないバグです。
2004/12/29:バグを直し、以下のソースを更新。

/*!
csv_stringとはカンマ区切り文字のこと。
例：dkingyo,0x0111,1000,0xokok,9999999999999,0000dkutil,00000

*/
void TestCSVParseAndAnalyze(const char *csv_string){
	dkutil::private_::CSVParser parse;

const int w=20,h=10;
	//本当はstd::list<std::string> とかが良いのですが･･･今回はcharの配列で。
	char buff[h+1][w+1];

//パーサーでパースする。
	parse.reset(csv_string);
	
	
	//■文字列をもらいたい場合。
	//すべてのパースした文字列をコピーする。
	dkutil::private_::CSVParser::const_iterator cit = parse.begin();
	{	
		dODS("■文字列をもらいたい場合。");
		int i=0;
		for(;cit != parse.end();cit++,i++){
			//バッファが無くなったら終了
			if(i > h) break;
			//CSVParserの内部で文字列を保存している型と同じ型の変数を宣言したい時は
			dkutil::private_::CSVParser::DATA_TYPE data;//と宣言する。
			//データを入れる。
			data = (*cit);
			//文字列をバッファにコピーする。
			strncpy(buff[i],data.str.c_str(),w);
		}
		int loopcount = (i > h) ? h : i;
		//そして表示
		for(i=0;i<loopcount;i++){
			//dODSはOutputDebugStringをprintfみたいに可変引数をもらえるようにした関数
			dODS(buff[i]);
		}
	}

//■文字列をそれにあったデータにしたい場合
	//例：1000という文字列だったらint型に変換して1000に代入する。
	//  ：0x01という文字列だったら16進法なので10進法に直してint型の変数に代入する。
	//　：文字列だったらstd::stringに代入する。
	//　：浮動小数点だったらdoubleに代入する。

{
		dODS("■文字列をそれにあったデータにしたい場合");
		int i=0;
		//出ました！CSVAnalyzerクラス
		dkutil::private_::CSVAnalyzer analyze;
		//CSVParserクラスを入れる。そうすると、解析してくれる。
		analyze.reset(parse);
		
		//解析したら、その結果と変換したデータをいただく。
		dkutil::private_::CSVAnalyzer::const_iterator cit = analyze.begin();

//char mozi[10]="";
		std::string mozi;
		int Int;
		UINT UInt;
		LONGLONG Longlong;
		ULONGLONG Ulonglong;
		double Double;

for(;cit != analyze.end();cit++){
			//こちらもCSVParserと同じく内部で使用している型と同じ型の変数を宣言したい時は
			dkutil::private_::CSVAnalyzer::DATA_TYPE data;//と宣言する。
			//代入
			data = (*cit);

//いずれ、switchで出来るようにする予定。

switch(data.type()){
			case edkDouble:
				//data中のd変数にdouble型データが入っている
				//以下、data.iとかdata.llとかも各型のデータが入っている。
				Double = data.GetUnionData().d;
				dODS("double type");
				break;
			case edkInt:
				//int型だった
				
				Int = data.GetUnionData().i;
				dODS("int type");
				break;
			case edkUInt:
				//Uint
				UInt = data.GetUnionData().ui;
				dODS("unsigned int type");
				break;
			case edkLongLong:
				//LONGLONG型だった。
				Longlong = data.GetUnionData().ll;
				dODS("LONGLONG type");
				break;
			case edkULongLong:
		
				//ULONGLONG型だった。
				Ulonglong = data.GetUnionData().ull;
				dODS("ULONGLONG type");
				break;
			case edkString:
				//std::string型（文字列)だった。
				//strncpy(mozi,data.mstr.c_str(),sizeof(mozi) - 1);
				//やっぱりstrncpyでも危ない。なぜならdata.mstr.c_str()の方が
				//sizeof(mozi) - 1より小さい場合はmstr.c_str()側の
				//バッファがオーバーするからだ。
				//こういうのを防ぐためにdkutilStdio.hというのがdkutilには用意されている。

//std::stringで代入
				mozi = data.c_str();
				dODS("std::stirng type");

break;
			default:
				//にがなんだか分からなかった。（それはまずありえないけど。)
				dODS("unknown type... it's bug!!");
				break;
			}
			//中に入っているデータをOutputDebugStringかなんかで表示する。
			data.print();
		}//end of for loop
	}//end of scope

}

まぁ、簡単に言うと、 CSVParserもCSVAnalyzerもresetメンバ関数にデータをぶち込んで解析結果を begin() end()でイテレーションして得る。という形です。
STLのvectorやlistを使っている方ならすぐに慣れるでしょう＾＾

Common Interface (共通インターフェイス)

ちと仕様変更中

サンプル

dkutil/dkutil_testフォルダ内にあるtested.cppには私がバグ取りに使った人工的なサンプルプログラムがあります。

サンプルアプリケーション

signatuan
MD5 SHA1 SHA256 SHA512 およびCRC各種を使ったファイルのシグネチャ出力アプリケーション
signatuan 0.002 : 一部コンパイルできないかも
signatuan 0.003 : オブジェクト指向風
signatuan 0.004 : シグネチャ出力速度を改善
signatuan 0.005 : シグネチャ出力結果がバグっていたところを改善
signatuan 0.006 : SHA512が上手く出力できなかったところを改善

Licence (使用条件)

ライセンスは BSD Licence または GNU Lesser General Public License(LGPL) です。
どちらかお好きな方を適用してください。
日本語訳、簡単な要約についてはd金魚の独断的ライセンス解釈にて

MD5のソースを使った場合は

zlibを使った場合は

libpngを使った場合は

BSD Licenceとして配布する場合

このライブラリをバイナリ、ソースに関わらず、配布する場合は以下の Copyrightと条文を明記する事がBSD Licenceで使用する場合に必要事項との事です。
（説明書の片隅にでもコピペしてください。）
何故、明記しないといけないかと言うと、BSD Licenceでのルールとなっているからです。
また、私側も法的な事に巻き込まれたくないからです。
どうか明記してください。お願いします。m(_ _)m
また、includeフォルダ内にあるdkutilAllInclude.hも見て頂けると幸いです。

//**********************************************************
ここからコピペ

dkutil Copyright (c) 2003-, by d金魚 (

)
All rights reserved.

Redistribution and use in source and binary forms,
 with or without modification, are permitted provided that the following
 conditions are met:

･Redistributions of source code must retain the above copyright notice,
 this list of conditions and the following disclaimer. 

･Redistributions in binary form must reproduce the above copyright notice,
 this list of conditions and the following disclaimer in the documentation
 and/or other materials provided with the distribution.
 
･Neither the name of the dKingyo Utility Toolkit Project nor the names of
 its contributors may be used to endorse or promote products derived from
 this software without specific prior written permission. 

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
 IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER 
OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


コピペ終了
//**********************************************************

Frequently asked question(よく聞かれる質問)

略称の意味はこちら
技術的質問
Ｑ： boostはdkutilでどのように使用されていますか？
Ａ：includeフォルダ内のdkutilBoostPolicy.hを見ると何をインクルードしているかわかります。
主に、使用しているのは以下の機能です。

dkutil_parser内でboost::spiritでパーサーを用意しています。
~~boost::filesystemでファイル系の機能を用意しています。~~(dkutil1.03以降にて廃止しました。)
boost::formatをいろんなところに使用しています。
boost/utility.hpp内のものをいろんなところに使用しています。
scoped_arrayとscoped_ptrを使用しています。

著作権に関して。
Ｑ：ＤＫＵＴの使い方、ＤＫＵＴＰ関連の記事を私のHP(非商業系メディア)に掲載していいですか？
Ａ：公序良俗に反しない、かつ、閲覧するのが有料でなければ、自由にしてかまいません。

Ｑ：ＤＫＵＴの使い方や情報を本等の商業系メディアに掲載したいのですが･･･
Ａ：ＤＫＵＴの事がメイン*1になって掲載しないのであれば、自由に掲載して構いません。といいますか、どんどん掲載してください＾＾（Smile
*1:ここでいうメインとメインではないの境はあいまいになりそうなので定義しておきます。
「メイン」とは・・・
「 dkutilライブラリを使ってのプログラミング」みたいなタイトルの本が勝手に出版されたら、dkutilの製作者、関係者はどう思うでしょうか？
私のプログラムを勝手に利用された!!と思ってしまいますよね。
そのような方がProjectに貢献していないのに、自己利益のために使われてるよ！...と。
ソースを提供してくださった方々に失礼です。
「メインではない」とは･･･
雑誌や本等にちょっとしたチップスが紹介された。ちょっとした関数、クラスの使用方法が掲載された。 URLや情報、感想、批評、好評、批判が記載された。バリバリOKです。どんどん掲載してください＾＾(smile)

その他
Ｑ： dkutilの読み方は？また、発音はどう発音するのですか？
Ａ：私は「ディーケーゆーてぃる」と発音してますが･･･え！？違うの？

SEO		[PR] 爆速!無料ブログ無料ホームページ開設無料ライブ放送