文字列リスト操作共通関数 [詳解]

#include <stdlib.h>
#include <string.h>
#include "cmnclib/Common.h"
#include "cmnclib/CmnString.h"
#include "cmnclib/CmnData.h"
#include "cmnclib/CmnLog.h"

関数
CmnStringList *	CmnStringList_Create ()
	文字列リスト作成 [詳解]

void	CmnStringList_Free (CmnStringList *list)
	文字列リスト解放 [詳解]

void	CmnStringList_Add (CmnStringList list, const char str)
	文字列リスト要素追加 [詳解]

char *	CmnStringList_Get (CmnStringList *list, int index)
	文字列リスト要素取得 [詳解]

詳解

文字列リスト操作共通関数

単方向リスト（CmnDataList.c）のラッパで、<BR> 文字列をリストで保持するのに適している。

著者: H.Kumagai

日付: 2004-06-16

参照: 単方向リスト CmnDataList.c

Revision: 1.1

関数詳解

void CmnStringList_Add	(	CmnStringList *	list,
		const char *	str
	)

文字列リスト要素追加

文字列リストの末尾に要素を追加する。
引数が不正な場合は何もしない。
また、メモリ確保に失敗した場合は、データがNULLの要素を追加する。

引数

list	(I/O) 要素を追加するリストへのポインタ
str	(I) 追加する要素（文字列）

著者: H.Kumagai

CmnStringList* CmnStringList_Create ( )

文字列リスト作成

文字列リストを新規に作成する

戻り値: 作成した文字列リストへのポインタ。作成に失敗した場合はNULLを返す。

著者: H.Kumagai

void CmnStringList_Free ( CmnStringList * list )

文字列リスト解放

文字列リストを破棄し、メモリ領域を解放する

引数

list	(I/O) 解放する文字列リストへのポインタ

著者: H.Kumagai

char* CmnStringList_Get	(	CmnStringList *	list,
		int	index
	)

文字列リスト要素取得

文字列リストから要素（文字列）を取得する

引数

list	(I) 要素を取得するリストへのポインタ
index	(I) 取得する要素のインデックス（最初の要素を0とする）

戻り値: 取得した文字列へのポインタ（listやindexが不正な場合はNULLを返す）

著者: H.Kumagai