C Programming

BOOL GetMessage(
　LPMSG lpMsg,
　HWND hWnd,
　UINT wMsgFilterMin,
　UINT wMsgFilterMax
);

メッセージキューからメッセージを取得する

lpMsg	lpMsgに指定したMSG構造体にhWndのメッセージを抽出する
hWnd	ウインドウを特定せず、すべてのメッセージを受け取る場合はNULLを指定
wMsgFilterMin wMsgFilterMax	取得するメッセージを特定の範囲に限定したい場合に利用するフィルタ 通常は、すべてのメッセージを処理する必要があるので0を指定する

一般的な使用例

while ( GetMessage( &msg, NULL, 0, 0 ) ) {
　TranslateMessage( &msg );
　DispatchMessage( &msg );
}

・GetMessage()関数は処理するメッセージが発生するまで制御を返しません。
・TranslateMessageは、一部のメッセージをプログラムで扱いやすいように変換するAPIです。
・DispatchMessageは、MSG構造体のhwndメンバーを参照して、そのウィンドウ・プロシージャを呼び出すようにWindowsに依頼します。

typedef struct tagMSG {
　HWND hwnd;
　UINT message;
　WPARAM wParam;
　LPARAM lParam;
　DWORD time;
　POINT pt;
} MSG;

MSG構造体は、スレッドのメッセージキューからのメッセージ情報を保持します。

hwnd	メッセージを受け取るウィンドウプロシージャを持つウィンドウを識別します。
message	メッセージ番号を指定します。
wParam	メッセージの付加情報を示します。意味はmessageメンバの値によって特定されます。
lParam	メッセージの付加情報を示します。意味はmessageメンバの値によって特定されます。
time	メッセージがポストされた時間を示します。
pt	メッセージがポストされたときのカーソル位置を画面座標で示します。

一般的なメッセージはwinuser.hの中で、「WM_」で始まるシンボルとして数百個が定義されています。
メッセージはmessageメンバに格納され、そのパラメータがwParamとlParamメンバに格納されます。
WPARAMとLPARAMは単純な整数型ですが、情報が多い場合は構造体へのポインタをパラメータとすることもあります。

ATOM RegisterClass( CONST WNDCLASS *lpWndClass );

ウィドウクラスの作成に失敗すると0を返します。
アトムはシステムがグローバルに管理している整数値です。
この場合は登録されたクラスを一意に示す整数値を返します。

typedef struct {
　UINT style;
　WNDPROC lpfnWndProc;
　int cbClsExtra;
　int cbWndExtra;
　HINSTANCE hInstance;
　HICON hIcon;
　HCURSOR hCursor;
　HBRUSH hbrBackground;
　LPCTSTR lpszMenuName;
　LPCTSTR lpszClassName;
} WNDCLASS;


WNDCLASS構造体は、ウィンドウクラスを記述する各種のフィールドで構成されます。

style	ウィンドウの基本的な設定を行うビットフラグを指定する。
lpfnWndProc	ウィンドウプロシージャ。拡張の必要が無ければDefWindowProc()で良い。
cbClsExtra	使用しない。0にする。
cbWndExtra	使用しない。0にする。
hInstance	このウィンドウクラスを登録するアプリケーションのインスタンスハンドルを指定する。WinMain()関数が引数で受け取ったインスタンスハンドルを設定する。
hIcon	ウィンドウのアイコン。NULLを指定した場合は標準のアイコン。
hCursor	マウスがウィンドウ上にあるときのカーソル。NULLを指定した場合は、現在のカーソルがそのまま表示される。
hbrBackground	背景色。色の値は標準のシステムカラーの1つでなければならない。(選ばれた値には1を加えなければならない。)
lpszMenuName	ウィンドウのデフォルトメニューとなるメニューの名前を指定する。
LpszClassName	一意のクラス名。

設定の例（ソースとしてのサンプルではありません。）

#define CLASSNAME "Project_Name"

WNDCLASS wc;

wc.style = 0;
wc.style = CS_HREDRAW | CS_VREDRAW;
wc.style = CS_BYTEALIGNCLIENT | CS_BYTEALIGNWINDOW;

wc.lpfnWndProc = WndProc;
wc.lpfnWndProc = DefWindowProc; // 拡張の必要が無ければデフォルトのウィンドウプロシージャで良い

wc.cbClsExtra = 0;
wc.cbWndExtra = 0;
wc.hInstance = hInstance;

wc.hIcon = NULL;
wc.hIcon = LoadIcon( hInstance, IDI_APPLICATION );
wc.hIcon = LoadIcon( hInstance, MAKEINTRESOURCE( IDI_PROJECTNAME ) );

wc.hCursor = LoadCursor( NULL, IDC_ARROW );

wc.hbrBackground = ( HBRUSH )( COLOR_WINDOW + 1 ); // COLOR_で始まるのはシステムカラーを示す定数

wc.lpszMenuName = 0;
wc.lpszMenuName = MAKEINTRESOURCE( IDC_PROJECTNAME );

wc.lpszClassName = CLASSNAME; // クラス名

HICON LoadIcon(
　HINSTANCE hInstance,
　LPCTSTR lpIconName
);

事前に定義されたアイコンを使用するには、
hInstanceにNULLを設定し
lpIconNameに以下の値の1つを設定してください。

IDI_APPLICATION	Default application icon.
IDI_ASTERISK	Same as IDI_INFORMATION.
IDI_ERROR	Hand-shaped icon.
IDI_EXCLAMATION	Same as IDI_WARNING.
IDI_HAND	Same as IDI_ERROR.
IDI_INFORMATION	Asterisk icon.
IDI_QUESTION	Question mark icon.
IDI_WARNING	Exclamation point icon.
IDI_WINLOGO	Windows logo icon. Windows XP: Default application icon.

HCURSOR LoadCursor(
　HINSTANCE hInstance,
　LPCTSTR lpCursorName
);

事前に定義されたカーソルを使用するためには、
hInstanceにNULLを設定し
lpCursorNameに以下の値の1つを設定してください。

IDC_APPSTARTING	Standard arrow and small hourglass
IDC_ARROW	Standard arrow
IDC_CROSS	Crosshair
IDC_HAND	Windows 98/Me, Windows 2000/XP: Hand
IDC_HELP	Arrow and question mark
IDC_IBEAM	I-beam
IDC_ICON	Obsolete for applications marked version 4.0 or later.
IDC_NO	Slashed circle
IDC_SIZE	Obsolete for applications marked version 4.0 or later. Use IDC_SIZEALL.
IDC_SIZEALL	Four-pointed arrow pointing north, south, east, and west
IDC_SIZENESW	Double-pointed arrow pointing northeast and southwest
IDC_SIZENS	Double-pointed arrow pointing north and south
IDC_SIZENWSE	Double-pointed arrow pointing northwest and southeast
IDC_SIZEWE	Double-pointed arrow pointing west and east
IDC_UPARROW	Vertical arrow
IDC_WAIT	Hourglass

int WINAPI WinMain(
　HINSTANCE hInstance,
　HINSTANCE hPrevInstance,
　LPSTR lpCmdLine,
　int nCmdShow
);

hInstance	WinMain関数を実行しているアプリケーションそのものを表すインスタンスハンドルが格納されている。
hPrevInstance	通常はNULLが格納されます。このパラメータは16ビットWindows時代に使われていたもので、Win32 APIでは利用する事はありません。
lpCmdLine	コマンドライン引数で渡されたNULLで終わる文字列へのポインタ
nCmdShow	ウィンドウをどのように表示するべきかを指定した値が格納されています。

・hInstanceは、実行中のアプリケーションを識別する為の整数値（インスタンス・ハンドル）を受け取るものだが、現在の32ビットWindowsのシステム(Win32)では、どのアプリケーションを実行しても同じ値が渡されるので、この値を利用してアプリケーションを一意に識別する事は出来ない。しかし、APIの中にはアプリケーション自身を参照する為にこの値を引数にとるものがある。アプリケーションのあちこちで必要になる事があるので、グローバル変数に保存しておく場合も多い。
・hPrevInstanceもインスタンス・ハンドルだが、これはWindows3.1などの16ビットwindowsの互換性のために残っているものだ。16ビットWindowsでは、同じアプリケーションがすでに実行中である場合は、先に起動したアプリケーションのインスタンス・ハンドルがここに格納されるようになっていた。Win32では必ず0がセットされるので、利用価値はない。
・lpCmdLineはmain関数の2番目の引数(argv)と違ってパラメータごとに切り分けれれた形にはなってないため、必要なら自分で文字列を解析しなければならない。標準の機能ではないが、VisualC++では解析済みのパラメータが__argvというグローバル変数にセットされている。

int atoi( const char *str )
long atol( const char *str )
double atof( const char *str )

atoi関数は文字列strをint型に変換して返す。
atol関数は文字列strをlong型に変換して返す。
atof関数は文字列strをdouble型に変換して返す。

i = atoi( str )

文字列strをint型に変換してint型変数iに代入する

l = atol( str )

文字列strをlong型に変換してlong型変数lに代入する

d = atof( str )

文字列strをdouble型に変換してdouble型変数dに代入する

#include <stdio.h>
#include <stdlib.h>
void main()
{
　int d;
　printf( "%d\n", d = atoi( " 100" ) );
　printf( "%d\n", d = atoi( " 100 234" ) );
　printf( "%d\n", d = atoi( "-200" ) );
　printf( "%d\n", d = atoi( "+200" ) );
　printf( "%d\n", d = atoi( "- 200" ) );
　printf( "%d\n", d = atoi( "300abc4" ) );
}

実行結果

100
100
-200
200
0
300

・先行する空白は無視される。
・'+'または'-'がある時は符合とされる。
・符号指定が省略された場合は'+'とみなされる。
・文字列に数字でない文字が現れたら、そこで変換を終了する

int abs( int n )
long labs( long n )
double fabs( double x )

abs関数はint型数値nの絶対値を返す。
labs関数はlong型数値nの絶対値を返す。
fabs関数はdouble型数値xの絶対値を返す。

printf( "%d\n", abs( -321 ) );
printf( "%ld\n", labs( -987654321 ) );
printf( "%4.2f\n", fabs( -23.4 ) );

実行結果

321
987654321
23.40

div_t div( int numer, int denom )
ldiv_t ldiv( long int numer, long int denom )

int型の引数を使用してdivを呼び出すと、
numer を denom で割り、商および剰余を求める。
商int quotおよび剰余int remで構成されるdiv_t型の構造体が返される。

ldiv関数は、引数および返される構造体のメンバがすべて
long int型である点を除いて、div関数と同じである。

div_t d;
d = div( 20, 6 );
printf( "商:%d 剰余:%d\n", d.quot, d.rem );

実行結果

商:3 剰余:2

double fmod( double x, double y )

浮動小数点数の剰余を計算する。

z = fmod( 10.5, 3.2 );

zは0.9になる。

double ceil( double x )
double floor( double x )

ceil関数は数値を切り上げる。
floor関数は数値を切り下げる。

printf( "%4.2f\n", ceil(12.11) );
printf( "%4.2f\n", ceil(-5.68) );

実行結果

13.00
-5.00

printf( "%4.2f\n", floor(12.11) );
printf( "%4.2f\n", floor(-5.68) );

実行結果

12.00
-6.00

int rand( void )
void srand( unsigned int seed )

rand関数は0〜32767までの整数乱数値を発生させる。

単純にrand関数を使うと毎回同じ乱数列になる為
毎回異なる乱数列を得たい場合は
時間関数timeと乱数系列初期値設定関数srandを使い
次のように記述する。

srand( ( unsigned )time( NULL ) );

サンプル

#include <stdio.h>
#include <stdlib.h>
#include <time.h>

void main()
{
　int i;
　srand( ( unsigned )time( NULL ) );

　// 0〜32767の整数乱数
　for ( i=0; i<=10; i++ )　printf( "%d\n", rand() );
　// 0〜1の実数乱数
　for ( i=0; i<=10; i++ )　printf( "%f\n", rand() / 32767.0 );
　// 0〜1未満の実数乱数
　for ( i=0; i<=10; i++ )　printf( "%f\n", rand() / 32767.1 );
　// このように書いているのもある
　for ( i=0; i<=10; i++ )　printf( "%f\n", rand() / 32768.0 );
　// 1〜6の整数乱数
　for ( i=0; i<=10; i++ )　printf( "%d\n", ( int )( ( rand() / 32767.1 * 6 ) + 1 ) );
　// これだと商が1.0の場合に7がでてしまう
　for ( i=0; i<=10; i++ )　printf( "%d\n", ( int )( ( rand() / 32767.0 * 6 ) + 1 ) );
}

以下のような式もあったりします。

( rand() % ( 上限 - ( 下限 ) + 1 ) ) + 下限

・0〜9の値

rand() % 10

・1〜6の値

( rand() % 6 ) + 1

・-3〜3の値

( rand() % 7 ) - 3

int strcmp( const char *str1, const char *str2 )

文字列str1と文字列str2を比較し、以下の値を返す。

値	str1 と str2 の関係
< 0	str1 は str2 より小さい
0	str1 と str2 は等しい
> 0	str1 は str2 より大きい

if ( strcmp( str, "aaa" ) == 0 ) {
　・・・
}

もし文字列strが"aaa"なら処理をする

char *strcpy( char *dest, const char *source )

文字列destに文字列sourceをコピーする

strcpy( s, "strcpy test" );

文字配列sに"strcpy test"をコピーする

void qsort( void *base, size_t num, size_t width
, int ( __cdecl *compare )( const void *, const void * ) )

widthに指定したバイト数の要素num個から成る配列baseを並べ替える。
base引数は、並べ替える配列のベースへのポインタである。
引数compareは、比較関数へのポインタである。
qsort 関数は、並べ替えの間に次のcompareルーチンを1回または複数回呼び出し、
そのたびに2つの配列要素へのポインタを渡す。
qsort関数は、並べ替えた後の要素で、この配列を上書きする。

比較関数はユーザーが自作する。
また、qsort関数の第4引数に示された仕様でなければならない。

比較関数は、要素を比較し、次のいずれかの値を返すこと。

< 0	昇順：elem1はelem2より小さい、降順：elem1はelem2より大きい
0	elem1 は elem2 に等しい
> 0	昇順：elem1はelem2より大きい、降順：elem1はelem2より小さい

#include
#include // qsort用
#include // strcmp用

int intcmp( const void *, const void * );
int intrcmp( const void *, const void * );
int dblcmp( const void *, const void * );
int mystrcmp( const void *, const void * );

void main()
{
　int id[10] = { 45, 65, 23, 87, 53, 67, 32, 19, 73, 66 };
　double dd[10] = { 3.56, 7.43, 5.76, 3.67, 9.65, 5.64, 2.75, 4.55, 6.32, 4.78 };
　char *pstr[5] = { "apple", "orange", "banana", "lemon", "peach" };
　int i;

　printf( "--int昇順--\n" );
　qsort( id, 10, sizeof( int ), intcmp );
　for ( i=0; i<10; i++ ) printf( "%d ", id[i] );
　puts( "\n" );

　printf( "--int降順--\n" );
　qsort( id, 10, sizeof( int ), intrcmp );
　for ( i=0; i<10; i++ ) printf( "%d ", id[i] );
　puts( "\n" );

　printf( "--double昇順--\n" );
　qsort( dd, 10, sizeof( double ), dblcmp );
　for ( i=0; i<10; i++ ) printf( "%4.2f ", dd[i] );
　puts( "\n" );

　printf( "--文字列昇順--\n" );
　qsort( pstr, 5, sizeof( char* ), mystrcmp );
　for ( i=0; i<5; i++ ) printf( "%s ", pstr[i] );
　puts( "\n" );

}

int intcmp( const void *a, const void *b )
{
　return( *(int*)a - *(int*)b );
}

int intrcmp( const void *a, const void *b )
{
　return( *(int*)b - *(int*)a );
}

int dblcmp( const void *a, const void *b )
{
　if ( *(double*)a < *(double*)b )
　　return -1;
　else if ( *(double*)a == *(double*)b )
　　return 0;
　else
　　return 1;
}

int mystrcmp( const void *a, const void *b )
{
　return strcmp( *(char**)a, *(char**)b );
}

実行結果

--int昇順--
19 23 32 45 53 65 66 67 73 87

--int降順--
87 73 67 66 65 53 45 32 23 19

--double昇順--
2.75 3.56 3.67 4.55 4.78 5.64 5.76 6.32 7.43 9.65

--文字列昇順--
apple banana lemon orange peach

自作する比較関数ですが、古いテキストの記述方法だと蹴られまくりました。
恐るべし。