Common

函数
void	OGE_Print (string sInfo)
	把字符串输出到控制台
string	OGE_IntToStr (int iValue)
	整数转字符串
int	OGE_StrToInt (string sValue)
	字符串转整数
int	OGE_HexToInt (string sValue)
	十六进制字符串转整数
string	OGE_FloatToStr (double fValue)
	浮点转字符串
double	OGE_StrToFloat (string sValue)
	字符串转浮点数
string	OGE_TrimStr (string sText)
	修剪字符串，去掉字串开头和结尾的空格、制表、回车和换行符等
int	OGE_GetTicks ()
	取得从操作系统启动到现在所经过的毫秒数
int	OGE_GetOS ()
	取得当前操作系统类型
string	OGE_GetDateTimeStr ()
	取得当前时间的字串形式
bool	OGE_GetDateTime (int &year, int &month, int &day, int &hour, int &min, int &sec)
	取得当前日期时间
void	OGE_Delay (int iMilliSeconds)
	等待若干毫秒再返回
int	OGE_Random (int iMax)
	取得在某一范围内的随机整数（大于或等于零）
double	OGE_RandomFloat ()
	取得一个介乎于0和1之间的随机小数
int	OGE_MakeColor (int iRed, int iGreen, int iBlue)
	转换三原色为符合当前游戏像素格式的颜色值
string	OGE_GetDefaultCharset ()
	取得游戏的缺省字符集
void	OGE_SetDefaultCharset (string sCharsetName)
	设置游戏的缺省字符集
string	OGE_GetSystemCharset ()
	取得操作系统所使用的字符集
void	OGE_SetSystemCharset (string sCharsetName)
	把操作系统所使用的字符集名称告诉游戏引擎
bool	OGE_IsInputUnicode ()
	检查当前通过输入法输入的文本是不是Unicode
int	OGE_StrToUnicode (string sText, string sCharsetName, int iBufferId)
	把字符串转换成Unicode
string	OGE_UnicodeToStr (int iUnicodeBufferId, int iBufferSize, string sCharsetName)
	把Unicode字符串转为普通字符串
int	OGE_StrLen (string sText)
	取得字符串的长度
int	OGE_FindStr (string sText, string sSubText, int iStartPos)
	在字符串中找出指定子串的位置
string	OGE_CopyStr (string sText, int iStartPos, int iCount)
	取某一字符串中的子串
string	OGE_DeleteStr (string sText, int iStartPos, int iCount)
	从字符串中删除一段子串
string	OGE_ReplaceStr (string sText, string sOldSubText, string sNewSubText)
	用新的子串替换字符串中的原有子串

---

函数文档

string OGE_CopyStr	(	string	sText,
		int	iStartPos,
		int	iCount
	)

取某一字符串中的子串

参数:

[in]	sText	某一字符串
[in]	iStartPos	子串的开始位置
[in]	iCount	子串的长度

返回:

返回子串

void OGE_Delay

(

int

iMilliSeconds

)

等待若干毫秒再返回

参数:

[in]

iMilliSeconds

需等待的毫秒数

string OGE_DeleteStr	(	string	sText,
		int	iStartPos,
		int	iCount
	)

从字符串中删除一段子串

参数:

[in]	sText	某一字符串
[in]	iStartPos	开始删除的位置
[in]	iCount	要删除的子串的长度

返回:

删除子串后的字符串

int OGE_FindStr	(	string	sText,
		string	sSubText,
		int	iStartPos
	)

在字符串中找出指定子串的位置

参数:

[in]	sText	整个字符串
[in]	sSubText	要搜索的子字符串
[in]	iStartPos	开始搜索的位置

返回:

返回子串在字符串中的位置

string OGE_FloatToStr

(

double

fValue

)

浮点转字符串

参数:

[in]

fValue

待转换的浮点数

返回:

转换后得到的字符串

bool OGE_GetDateTime	(	int &	year,
		int &	month,
		int &	day,
		int &	hour,
		int &	min,
		int &	sec
	)

取得当前日期时间

参数:

[out]	year	当前年
[out]	month	当前月
[out]	day	当前日
[out]	hour	当前时
[out]	min	当前分
[out]	sec	当前秒

返回:

若成功则返回真，否则返回假

string OGE_GetDateTimeStr

(

)

取得当前时间的字串形式

返回:

返回当前时间的字串形式

string OGE_GetDefaultCharset

(

)

取得游戏的缺省字符集

返回:

缺省字符集的名称

int OGE_GetOS

(

)

取得当前操作系统类型

返回:

返回当前操作系统类型

string OGE_GetSystemCharset

(

)

取得操作系统所使用的字符集

返回:

字符集的名称

int OGE_GetTicks

(

)

取得从操作系统启动到现在所经过的毫秒数

返回:

所经过的毫秒数

int OGE_HexToInt

(

string

sValue

)

十六进制字符串转整数

参数:

[in]

sValue

十六进制字符串

返回:

转换后得到的整数

string OGE_IntToStr

(

int

iValue

)

整数转字符串

参数:

[in]

iValue

待转换的整数值

返回:

转换后得到的字符串

bool OGE_IsInputUnicode

(

)

检查当前通过输入法输入的文本是不是Unicode

返回:

如果是Unicode则返回真，否则返回假

int OGE_MakeColor	(	int	iRed,
		int	iGreen,
		int	iBlue
	)

转换三原色为符合当前游戏像素格式的颜色值

参数:

[in]	iRed	红色分量
[in]	iGreen	绿色分量
[in]	iBlue	蓝色分量

返回:

返回符合当前游戏色深格式的颜色值

void OGE_Print

(

string

sInfo

)

把字符串输出到控制台

参数:

[in]

sInfo

所输出的字符串

int OGE_Random

(

int

iMax

)

取得在某一范围内的随机整数（大于或等于零）

参数:

[in]

iMax

随机数的最大值

返回:

返回一个介乎于0和最大值之间的随机整数

double OGE_RandomFloat

(

)

取得一个介乎于0和1之间的随机小数

返回:

返回一随机纯小数

string OGE_ReplaceStr	(	string	sText,
		string	sOldSubText,
		string	sNewSubText
	)

用新的子串替换字符串中的原有子串

参数:

[in]	sText	某一字符串
[in]	sOldSubText	要替换的子串
[in]	sNewSubText	用于替换原有子串的新子串

返回:

替换了子串以后的字符串

void OGE_SetDefaultCharset

(

string

sCharsetName

)

设置游戏的缺省字符集

参数:

[in]

sCharsetName

缺省字符集的名称

void OGE_SetSystemCharset

(

string

sCharsetName

)

把操作系统所使用的字符集名称告诉游戏引擎

参数:

[in]

sCharsetName

字符集名称

int OGE_StrLen

(

string

sText

)

取得字符串的长度

参数:

[in]

sText

某一字符串

返回:

改字符串的长度

double OGE_StrToFloat

(

string

sValue

)

字符串转浮点数

参数:

[in]

sValue

待转换的字符串

返回:

转换后得到的浮点数

int OGE_StrToInt

(

string

sValue

)

字符串转整数

参数:

[in]

sValue

待转换的字符串

返回:

转换后得到的整数

int OGE_StrToUnicode	(	string	sText,
		string	sCharsetName,
		int	iBufferId
	)

把字符串转换成Unicode

参数:

[in]	sText	待转换的字符串
[in]	sCharsetName	字符串所使用的字符集名称
[in]	iBufferId	生成的Unicode将会保存到的缓冲区的ID

返回:

如果转换成功则返回Unicode字符串的长度

string OGE_TrimStr

(

string

sText

)

修剪字符串，去掉字串开头和结尾的空格、制表、回车和换行符等

参数:

[in]

sText

待修剪的字符串

返回:

修剪后的字符串

string OGE_UnicodeToStr	(	int	iUnicodeBufferId,
		int	iBufferSize,
		string	sCharsetName
	)

把Unicode字符串转为普通字符串

参数:

[in]	iUnicodeBufferId	放置Unicode字符串的缓冲区的ID
[in]	iBufferSize	缓冲区的大小
[in]	sCharsetName	所转换成的普通字符串所使用的字符集名称

返回:

返回使用指定字符集的普通字符串