第四章 易语言核心库命令对照表

109691180

第四章 易语言核心库命令对照表基于火山软件开发平台飞扬#20版本后续可能会有变动

一、流程控制

易语言	火山	注释
如果	如果	本命令根据提供的逻辑参数的值，来决定是否改变程序的执行位置。
如果真	如果真	本命令和如果命令相比，没有参数为假时执行的部分。
判断	无	本命令根据提供的逻辑参数的值，来决定是否改变程序的执行位置。
无	分支判断 / 分支	开始对一个整数参数的值进行分支判断处理。 “分支判断”方法的子语句体中只能存在“分支”或“默认分支”方法的调用语句，并且至少包含一个。
判断循环首 / 尾	判断循环	根据首方法提供的逻辑参数的值，来决定是否进入循环。
循环判断首 / 尾	循环判断首 / 尾	根据尾方法提供的逻辑参数的值，来决定是否返回到循环首部继续进行循环。
计次循环首 / 尾	计次循环	执行本命令将把循环体内的命令重复执行指定的次数。
变量循环首 / 尾	循环	执行本命令将利用变量对循环体内的命令进行循环执行。第一次执行此命令时将使用“变量起始值”参数初始化“循环变量”参数所指定的变量。每次（包括第一次）执行到此命令处都将判断循环变量内的值是否已经超过“变量目标值”参数所指定的值，如已超过，则跳转到对应的“变量循环尾”命令的下一条命令处继续执行，否则顺序执行下一条语句继续进行循环。
到循环尾	到循环尾	本命令转移当前程序执行位置到当前所处循环体的循环尾语句处。
跳出循环	跳出循环	本命令转移当前程序执行位置到当前所处循环体循环尾语句的下一条语句处。
返回	返回	本命令转移当前程序执行位置到调用本子程序语句的下一条语句处,并可根据需要（如果有）返回一个值到子程序调用处。
结束	结束	本命令结束当前程序的运行。

二、算数运算

易语言	火山	注释
相乘	*	表示乘法运算
相除	/	表示除法运算
整除	无	表示整除，在火山视窗中直接使用强制转换即可。
求余数	%	表示求余数
相加	+	表示加法运算
相减	-	表示减法运算
负	-	表示取负数
取符号	取符号	返回一个整数，如果小于零，表明给定数值为负；如果等于零，表明给定数值为零；如果大于零，表明给定数值为正。
取绝对值	取整数绝对值 取小数绝对值 取长整数绝对值	取一个数值的绝对值。
取整	取整	返回一个小数的整数部分。本命令与“绝对取整”命令不相同之处为： 如果给定小数为负数，则本命令返回小于或等于该小数的第一个负整数，而“绝对取整”命令则会返回大于或等于该小数的第一个负整数。例如，本命令将 -7.8 转换成 -8，而“绝对取整”命令将 -7.8 转换成 -7。
绝对取整	绝对取整	返回一个小数的整数部分。本命令与“取整”命令不相同之处为： 如果给定小数为负数，则本命令返回大于或等于该小数的第一个负整数，而“取整”命令则会返回小于或等于该小数的第一个负整数。例如，本命令将 -7.8 转换成 -7，而“取整”命令将 -7.8 转换成 -8。
四舍五入	四舍五入	返回按照指定的方式进行四舍五入运算的结果数值
求次方	求次方	返回指定数值的指定次方
求平方根	求平方根	返回指定数值的平方根
求正弦	求正弦	返回指定角的正弦值
求余弦	求余弦	返回指定角的余弦值
求正切	求正切	返回指定角的正切值
求反正切	求反正切	返回指定角的反正切值
求自然对数	求自然对数	返回指定参数的自然对数值
求反对数	求反对数	返回 E（自然对数的底）的某次方
是否运算正确	是否运算正确	对乘、除、“求次方”、“求平方根”、“求正弦值”、“求余弦值”、“求正切值”、“求反正切值”、“求自然对数”、“求反对数”等等数学运算命令所计算出来的双精度结果数值进行校验，如果该数值正确有效，返回真。如果该数值是运算错误或运算溢出后的结果，返回假。
置随机数种子	置随机数种子	为随机数生成器初始化一个种子值，不同的种子值将导致“取随机数”命令返回不同的随机数系列。
取随机数	取随机数	返回一个指定范围内的随机数值。

三、逻辑比较

易语言	火山	注释
等于	=	用于将右侧的参数值赋予给左侧参数内容
等于	==	用于比较左侧参数与右侧参数是否相等
不等于	!=	当左侧参数不等于右侧参数时返回真
小于	<	当左侧参数小于右侧参数时返回真
大于	>	当左侧参数大于右侧参数时返回真
小于或等于	<=	当左侧参数小于等于右侧参数时返回真
大于或等于	>=	当左侧参数大于等于右侧参数时返回真
近似等于	是否以文本开头	返回当前文本是否以所指定文本开头。
并且	&&	用于并且逻辑操作，当左侧参数和右侧参数均为逻辑值真时，最终整个表达式的结果返回真。
或者	||	用于或者逻辑操作，当左侧参数或右侧参数其中任意一个的逻辑值为真，最终整个表达式的结果返回真。
取反	取反	如果参数值为真则返回假，如果参数值为假则返回真。

四、位运算

易语言	火山	注释
位取反	位取反	将所指定整数值的每一位进行反转，返回反转后的结果。
位与	位与 连续位与	将多个整数值进行位与运算，返回运算后的结果。
位或	位或 连续位或	将多个整数值进行位或运算，返回运算后的结果。
位异或	位异或 连续位异或	将多个整数值进行位异或运算，返回运算后的结果。
左移	位左移	将参数1的每一位向左移动参数2所指定的数目,返回运算后的结果.
右移	位右移	将参数1的每一位向右移动参数2所指定的数目，返回运算后的结果。
合并整数	合并整数	将第一个整数的低16位放置到结果整数的低16位，将第二个整数的低16位放置到结果整数的高16位，以此合并成一个整数，并返回合并后的结果。
合并短整数	合并短整数	将第一个整数的低8位放置到结果短整数的低8位，将第二个整数的低8位放置到结果短整数的高8位，以此合并成一个短整数，并返回合并后的结果。

五、变量操作

易语言	火山	注释
赋值	=	将指定的常数、常数集、常量、资源、对象或者变量赋于到指定的变量或变量数组中去。
连续赋值	连续赋值	将一个值连续赋予到所指定的一系列同类型变量中。 注：在火山视窗中暂不支持对属性进行赋值。

六、数组操作

在火山视窗中的数组操作主要使用XX数组类进行操作，譬如：文本数组类，整数数组类。

易语言	火山	注释
重定义数组	数组变量.重置数组	重置数组中的成员数为所指定的数目
取数组成员数	取数组成员数 整数数组.取成员数	获取数组的成员数量
取数组下标	无	返回指定数组维可用的最大下标（最小下标固定为1）
复制数组	无	将数组数据复制到指定的数组变量，该数组变量内的所有数据和数组维定义信息将被全部覆盖。
加入成员	数组变量.加入成员	将一个所指定类型的成员值加入到数组的尾部
插入成员	数组变量.插入成员	将所指定的成员值插入到所指定的索引位置
删除成员	数组变量.删除成员	删除数组中所指定索引位置处的成员
清除数组	数组变量.删除所有成员	删除指定数组变量中的所有成员
数组排序	数组变量.排序	对数组中的所有成员进行排序
数组清零	数组变量.清零	将数组中的所有成员值清除为零值

七、环境存取

易语言	火山	注释
取命令行	取命令行	本命令可以取出在启动程序时附加在其可执行文件名后面的所有以空格分隔的命令行文本段
取运行目录	取运行目录	取当前被执行的程序文件所处的目录
取执行文件名	取执行文件名	取当前被执行的程序文件的名称
读环境变量	读环境变量	读取系统环境变量
写环境变量	写环境变量	设置系统环境变量

八、拼音处理

易语言	火山	注释
取所有发音	无	返回包含指定汉字所有拼音编码的文本数组（支持多音字），目前仅支持国标汉字。
取发音数目	无	返回指定汉字的发音数目
取拼音	无	返回包含指定汉字的指定拼音编码的文本
取声母	无	返回包含指定汉字指定拼音编码的声母部分文本
取韵母	无	返回包含指定汉字指定拼音编码的韵母部分文本
发音比较	无	比较两段文本的发音，如果发音相同返回真，否则返回假。对于文本中的非国标汉字部分，将仅进行简单的值比较。
输入字比较	无	将一个拼音输入字文本与另外一个普通文本比较，如果两者相符，返回真，否则返回假。

九、文本操作

易语言	火山	注释
取文本长度	取文本长度	返回所指定文本型数据的长度
取文本左边	取文本左边	返回一个文本，其中包含指定文本中从左边算起指定数量的字符。
取文本右边	取文本右边	返回一个文本，其中包含指定文本中从右边算起指定数量的字符。
取文本中间	取文本中间	返回一个文本，其中包含指定文本中从指定位置算起指定数量的字符。
字符	到文本((字符)整数值)	返回一个文本，其中包含有与指定字符代码相关的字符。 火山视窗示例：到文本((字符)66)，最终返回英文字母B。
取代码	(整数)取字符()	返回文本中指定位置处字符的代码。 火山视窗示例：(整数)取字符("B",0)，最终返回66.
寻找文本	寻找文本	查找当前文本中所指定文本的所处索引位置，未找到则返回-1。
倒找文本	倒找文本	逆向查找当前文本中所指定文本的所处索引位置，未找到则返回-1。
到小写	到小写	将当前文本中的所有英文字母转换为小写，返回转换后的结果文本.
到大写	到大写	将文本中的小写英文字母变换为大写，返回变换后的结果文本。
到全角	到全角	将文本中的半角字母、空格或数字变换为全角，返回变换后的结果文本。
到半角	到半角	将文本中的全角字母、空格或数字变换为半角，返回变换后的结果文本。
到文本	到文本	返回指定数据的文本形式
删首空	删首空	删除当前文本首部的所有空白字符，返回删除后的结果文本。
删尾空	删尾空	删除当前文本尾部的所有空白字符，返回删除后的结果文本。
删首尾空	删首尾空	删除当前文本首部和尾部的所有空白字符，返回删除后的结果文本。
删全部空	无	删除指定文本中所有的空白文本。
文本替换	文本替换	将指定文本的某一部分用其它的文本替换
子文本替换	子文本替换	将所指定文本中的指定内容子文本替换为另一个文本。 注：在火山视窗中，是通过参数1直接返回被替换后的内容。
取空白文本	取空白文本	返回具有指定数目半角空格的文本
取重复文本	取重复文本	将所指定文本重复指定次数，返回结果文本。
文本比较	文本比较	比较两个文本，返回比较结果。 如果返回值小于0，表示本文本小于所比较文本; 如果等于0，表示本文本等于所比较文本; 如果大于0，表示本文本大于所比较文本。
分割文本	分割文本 分割子文本	将指定文本进行分割，在火山视窗中是通过参数返回分割后的数组。 注：火山视窗中的“分割文本”，分割的是字符集，遇到任意字符都会进行分割。如果想实现和易语言中同样的效果需使用“分割子文本”即可。
指针到文本	指针到文本	根据指定指针所指向的文本数据建立并返回一个文本
文本到UTF8	文本到UTF8	将当前文本转换到UTF8字符集格式后返回
UTF8到文本	UTF8到文本	将所指定UTF8格式的文本数据转换到文本后返回
文本到UTF16	到字节集	将所指定文本转换到UTF16格式后返回
UTF16到文本	字节集到文本	将所指定的字节集数据转换到文本后返回。

十、时间操作

易语言	火山	注释
到时间	到时间	将指定文本转换为时间并返回。
增减时间	增减时间	返回一个时间，这一时间被加上或减去了一段间隔。如果改变后的时间无效，将自动靠近最近的有效时间。
取时间间隔	取时间间隔	返回一个数值，表示“时间1”减去“时间2”之后的间隔数目。注意：每个星期以星期天为第一天。
取某月天数	取某月天数	返回指定月份所包含的天数。如果给定的月份无效，返回0。
时间到文本	时间到文本	将指定时间转换为文本并返回。
取时间部分	取时间部分	返回一个包含已知时间指定部分的整数。
取年份	取年份	返回一个值为 100 到 9999 之间的整数，表示指定时间中的年份。
取月份	取月份	返回一个值为 1 到 12 之间的整数，表示指定时间中的月份。
取日	取日	返回一个值为 1 到 31 之间的整数，表示一个月中的某一日。
取星期几	取星期几	返回一个值为 1 到 7 之间的整数，表示一个星期中的某一日。星期日为 1，星期一为 2，依此类推。
取小时	取小时	返回一个值为 0 到 23 之间的整数，表示一天中的某一小时。
取分钟	取分钟	返回一个值为 0 到 59 之间的整数，表示一小时中的某一分钟。
取秒	取秒	返回一个值为 0 到 59 之间的整数，表示一分钟中的某一秒。
指定时间	指定时间	返回包含指定年、月、日、小时、分、秒的时间。如果指定了无效时间，将自动使用最相近的有效时间代替。
取现行时间	取现行时间	返回当前系统日期及时间。
置现行时间	置现行时间	设置当前系统日期及时间。
取日期	取日期	返回一个日期时间型数据的日期部分，其小时、分钟、秒被固定设置为0时0分0秒。
取时间	取时间	返回一个日期时间型数据的时间部分，其年、月、日被固定设置为2000年1月1日。

十一、数值转换

易语言	火山	注释
到数值	文本到小数	将所指定文本转换到小数并返回
数值到大写	数值到大写	将数值转换为简体或繁体的大写形式，返回转换后的文本。
数值到金额	无	将数值转换为金额的简体或繁体大写形式，返回转换后的文本。
数值到格式文本	数值到格式文本	返回一个文本，代表指定数值被格式转换后的结果。
取十六进制文本	取十六进制文本 取长整数十六进制文本	返回一个文本，代表指定数值的十六进制形式。
取八进制文本	无	返回一个文本，代表指定数值的八进制形式。
到字节	(字节)欲转换的数据	返回包含于文本内的字节值，文本中是一个适当类型的数值，支持全角书写方式。
到短整数	文本到短整数	将文本转换成短整数并返回
到整数	文本到整数	将文本转换成整数并返回
到长整数	文本到长整数	将文本转换成长整数并返回
到小数	文本到小数	将文本转换成小数并返回
十六进制	无	计算返回所指定十六进制文本常量对应的整数值。
二进制	无	计算返回所指定二进制文本常量对应的整数值。
反转整数字节序	反转整数字节序	将所指定整数的字节序反转，返回反转后的结果值。

十二、字节集操作

易语言	火山	注释
取字节集长度	取字节集长度	取字节集数据的长度
到字节集	到字节集	将指定数据转换为字节集后返回转换结果
取字节集数据	取字节集数据	取出字节集中指定位置指定数据类型的数据
取字节集左边	取字节集左边	返回一个字节集，其中包含指定字节集中从左边算起指定数量的字节。
取字节集右边	取字节集右边	返回一个字节集，其中包含指定字节集中从右边算起指定数量的字节。
取字节集中间	取字节集中间	返回一个字节集，其中包含指定字节集中从指定位置算起指定数量的字节。
寻找字节集	寻找字节集	返回一字节集在另一字节集中最先出现的位置
倒找字节集	倒找字节集	返回一字节集在另一字节集中最后出现的位置
字节集替换	字节集替换	将指定字节集的某一部分用其它的字节集替换，然后返回替换后的结果。
子字节集替换	子字节集替换	返回一个字节集，该字节集中指定的子字节集已被替换成另一子字节集，并且替换发生的次数也是被指定的。
取空白字节集	取空白字节集	返回具有特定数目 0 字节的字节集。
取重复字节集	取重复字节集	返回一个字节集，其中包含指定次数的字节集重复结果。
分割字节集	分割字节集	将指定字节集进行分割，返回分割后的一维字节集数组。
指针到字节集	指针到字节集	返回指定内存指针所指向地址处的一段数据，注意调用本命令前一定要确保所提供的内存地址段真实有效。
指针到整数	无	返回指定内存指针所指向地址处的一个整数(INT)，注意调用本命令前一定要确保所提供的内存地址段真实有效。
指针到小数	无	返回指定内存指针所指向地址处的一个小数(FLOAT)，注意调用本命令前一定要确保所提供的内存地址段真实有效。
指针到双精度小数	无	返回指定内存指针所指向地址处的一个双精度小数(DOUBLE)，注意调用本命令前一定要确保所提供的内存地址段真实有效。
取字节集内整数	无	返回字节集中所指定位置处的整数。
置字节集内整数	无	设置字节集中所指定位置处的整数值。

十三、磁盘操作

易语言	火山	注释
取磁盘总空间	取磁盘总空间	返回以 1024 字节（KB）为单位的指定磁盘全部空间。如果失败，返回-1。
取磁盘剩余空间	取磁盘剩余空间	返回以 1024 字节（KB）为单位的指定磁盘现行剩余空间。如果失败，返回-1。
取磁盘卷标	取磁盘卷标	返回指定磁盘的卷标文本
置磁盘卷标	置磁盘卷标	设置指定磁盘的卷标文本。成功返回真，失败返回假。
改变驱动器	改变驱动器	改变当前的缺省驱动器。成功返回真，失败返回假。
改变目录	改变目录	改变当前的目录，但不会改变缺省驱动器位置。成功返回真，失败返回假。
取当前目录	取当前目录	返回一个文本，用来代表当前的目录。如果失败，返回空文本。
创建目录	创建目录	创建一个新的目录。成功返回真，失败返回假。
取当前目录	取当前目录	返回一个文本，用来代表当前的目录。
删除目录	删除目录	删除一个存在的目录及其中的所有子目录和下属文件，请务必谨慎使用本命令。成功返回真，失败返回假。
复制文件	复制文件	复制一个文件到另外一个位置，成功返回真，失败返回假。
移动文件	移动文件	将文件从一个位置移动到另外一个位置。成功返回真，失败返回假。
删除文件	删除文件	删除一个文件，成功返回真，失败返回假。
文件更名	文件更名	重新命名一个文件或目录。成功返回真，失败返回假。
文件是否存在	文件是否存在	判断指定的磁盘文件是否真实存在。如存在返回真，否则返回假。
寻找文件	文件查找类	用于寻找文件，在火山视窗中需要定义变量才可以使用。
取文件时间	取文件时间	返回指定文件被创建或最后修改后的日期和时间。如果该文件不存在，将返回100年1月1日。
取文件尺寸	取文件尺寸	返回一个文件的长度，单位是字节。如果该文件不存在，将返回 -1。
取文件属性	取文件属性	返回一个文件或目录的属性。
置文件属性	置文件属性	为一个文件设置属性信息。
取临时文件名	取临时文件名	返回一个在指定目录中确定不存在的 .TMP 全路径文件名称。
读入文件	读入文件	返回一个字节集，其中包含指定文件的所有数据。
写到文件	写到文件	本命令用作将一个或数个字节集顺序写到指定文件中，文件原有内容被覆盖。成功返回真，失败返回假。

十四、文件读写

在火山视窗中需要定义“文件读写类”变量才可以使用。

易语言	火山	注释
打开文件	文件读写变量.打开文件	打开一个普通文件，以对文件进行输入或输出。
打开内存文件	无	建立一个内存文件，以计算机内存为存储介质对数据进行文件式的快速输入或输出。
关闭文件	文件读写变量.关闭文件	关闭被打开的文件
关闭所有文件	无	关闭所有现行被打开的文件
锁住文件	文件读写变量.锁住文件	在有若干个进程访问同一个文件的环境中，使用本命令拒绝其它用户对被打开文件中的某个区域进行读写访问。成功返回真，失败返回假。
解锁文件	文件读写变量.解锁文件	解除由“锁住文件”命令对文件所进行的锁定。成功返回真，失败返回假。注意：本命令调用时所提供的参数值必须与调用“锁住文件”命令时所提供的参数值完全一致。
移动读写位置	文件读写变量.移动读写位置	在被打开的文件中，设置下一个读或写操作的位置。成功返回真，失败返回假。
移到文件首	文件读写变量.移到文件首	在被打开的文件中，设置下一个读或写操作的位置到文件首。成功返回真，失败返回假。
移到文件尾	文件读写变量.移到文件尾	在被打开的文件中，设置下一个读或写操作的位置到文件尾。成功返回真，失败返回假。
读入字节集	文件读写变量.读入字节集	从文件中当前读写位置读取并返回一段字节集数据，实际读入长度(即所返回字节集的尺寸)可能会小于欲读入长度。 如果读入失败,将返回一个空字节集并且自动将当前文件读写位置移到文件尾部。
写出字节集	文件读写变量.写出字节集	写出一个字节集数据到文件中当前读写位置处，返回是否成功。
读入文本	文件读写变量.读入文本	从文件中当前读写位置读取并返回一段文本数据，实际读入长度(即返回文本的尺寸)可能会小于欲读入长度。如果该数据中存在字符值0或26(文本结束标志)，将仅返回该字符之前的数据(后续读写将跳过该字符)。如果读入失败，将返回一个空文本并且自动将当前文件读写位置移到文件尾部。 注: 在火山视窗中，文本文件的编码格式必须为UTF-16。
写出文本	文件读写变量.写出文本	本命令用作写出一段文本数据到文件中当前读写位置处。成功返回真，失败返回假。 注：在火山视窗中写出的文本编码为UTF-16。
读入一行	文件读写变量.读入一行	本命令用作从文件中当前读写位置读取并返回一行文本数据，行末的回车及换行符将被抛弃。如果读入失败，将返回一个空文本并且自动将当前文件读写位置移到文件尾部。 注: 在火山视窗中，文本文件的编码格式必须为UTF-16。
写文本行	文件读写变量.写文本行	本命令用作写出一行文本数据到文件中当前读写位置处，每行的尾部将被自动加上回车及换行符。 注：在火山视窗中写出的文本编码为UTF-16。
读入数据	文件读写变量.读入数据	从文件中当前读写位置读取并返回指定类型的数据，如果读入成功，返回真，否则将返回假并且自动将当前文件读写位置移到文件尾部。
写出数据	文件读写变量.写出数据	将所指定数据写出到文件中当前读写位置，返回是否成功。
是否在文件尾	文件读写变量.是否在文件尾	返回当前读写位置是否已经处于文件数据的尾部
取读写位置	文件读写变量.取读写位置	返回指定被打开文件的当前读/写位置，位置值从0开始。失败返回-1。
取文件长度	文件读写变量.取文件长度	返回当前被打开文件的长度，单位为字节。失败返回 -1 。
插入字节集	无	本命令用作插入一段字节集数据到文件中当前读写位置处
插入文本	无	本命令用作插入一段文本数据到文件中当前读写位置处
插入文本行	无	本命令用作插入一段文本行到文件中当前读写位置处
删除数据	无	本命令用作在文件中当前读写位置处删除一段字节数据，文件后面的数据顺序前移。
打开加密文件	无	打开一个以指定密码加密的文件，以对此文件进行快速安全访问，支持大尺寸文件。

十五、系统处理

易语言	火山	注释
运行	运行	本命令运行指定的可执行文件或者外部命令。如果成功，返回真，否则返回假。
取剪辑板文本	取剪辑板文本	返回存放于当前 Windows 系统剪辑板中的文本。如果当前剪辑板中无文本数据，将返回空文本。
置剪辑板文本	置剪辑板文本	将指定文本存放到当前 Windows 系统剪辑板中去，剪辑板中的原有内容被覆盖。成功返回真，失败返回假。
剪辑板中可有文本	剪辑板中可有文本	如果当前 Windows 系统剪辑板中有文本数据，则返回真，否则返回假。
清除剪辑板	清除剪辑板	清除当前 Windows 系统剪辑板中的所有数据
取屏幕宽度	取屏幕宽度	返回屏幕当前显示区域的宽度，单位为像素。
取屏幕高度	取屏幕高度	返回屏幕当前显示区域的高度，单位为像素。
取鼠标水平位置	取鼠标水平位置	返回鼠标指针的当前水平位置，单位为像素。
取鼠标垂直位置	取鼠标垂直位置	返回鼠标指针的当前垂直位置，单位为像素。
取颜色数	取颜色数	返回当前显示方式所提供的最大颜色显示数目
输入框	输入框	在一对话框中显示提示，等待用户输入正文并按下按钮。如果用户在确认输入后（按下“确认输入”按钮或回车键）退出，返回真，否则返回假。/p>
信息框	信息框 全局信息框	显示一个信息框等待用户点击按钮，并返回一个值告诉用户单击哪一个按钮。 如果信息框有“取消”按钮，则按下 ESC 键与单击“取消”按钮的效果相同。 注：火山视窗中的信息框依赖窗口类，全局信息框可以在任意类中调用。
鸣叫	鸣叫	通过计算机媒体设备或者喇叭发出一个声音
取启动时间	取启动时间	返回自 Windows 系统启动后到现在为止所经历过的毫秒数
置等待鼠标	鼠标等待器	本命令设置现行鼠标的形状为沙漏形，用作在即将长时间执行程序前提示操作者。 在火山视窗中需要定义“鼠标等待器”变量才可以使用。
恢复鼠标	鼠标等待器	本命令恢复现行鼠标的原有形状 在火山视窗中，当“鼠标等待器”变量被销毁时，会自动恢复鼠标。
延时	延时	暂停当前程序的运行并等待指定的时间
取文本注册项	取文本注册项	在 Windows 注册表中返回指定的文本类型注册表项值
取数值注册项	取数值注册项	在 Windows 注册表中返回指定的数值类型注册表项值
取字节集注册项	取字节集注册项	在 Windows 注册表中返回指定的字节集类型注册表项值
写注册项	写文本注册项 写数值注册项 写字节集注册项	在 Windows 注册表中保存或建立指定的注册表项
删除注册项	删除注册项	在 Windows 注册表中删除指定注册表项或注册表目录
注册项是否存在	注册项是否存在	如果指定注册表项存在，返回真，否则返回假。
取默认底色	取默认底色	取回Windows系统的默认窗口背景颜色
快照	快照	取回指定窗口或屏幕上所有现有显示内容的图片数据
读配置项	读配置项	读取指定配置文件中指定项目的文本内容
写配置项	写配置项	将指定文本内容写入指定配置项中或者删除指定的配置项或节，如果指定配置文件不存在，将会自动创建。
取配置节名	取配置节名	返回指定配置文件中所有已有节名的文本数组
取操作系统类别	取操作系统类型	返回当前操作系统的版本类型
多文件对话框	无	打开一个多文件选择对话框
取程序名称	无	返回所指定类型的程序名称
交换变量	交换变量	交换两个同类型变量的值
强制交换变量	无	强制交换两个变量内容
取运行时数据类型	无	返回所提供参数的运行时数据类型值
宏	无	在编译程序时，通过提供一系列自定义的常量数据参数来调用系统内置或者外部提供的程序接口，获得其处理结果并将其整合进编译结果中。
类自身	本对象	表示当前类对象
取最后错误	取最后错误	调用操作系统的GetLastError函数，返回该API函数被调用后的返回值。
取统一文本	文本到字节集	返回所指定文本的Unicode格式字节集
取统一文本长度	取文本长度	返回所指定文本转换到Unicode格式文本后的字符数目

十六、媒体播放

易语言	火山	注释
播放音乐	无	可以播放 .WAV、.MID 声音文件或相应格式的字节集声音数据、声音资源。
停止播放	无	停止正在播放的音乐
播放MID	无	可以自动连续播放多个 MIDI 声音文件（注意不支持 WAV ）或相应格式的字节集声音数据、声音资源。
播放MP3	无	可以自动连续播放多个 MP3 音乐文件
同步播放MP3	无	播放一次指定的MP3音乐文件，在播放过程中，会自动给指定标签组件发送反馈事件通知，以同步提供当前播放进度百分比。
暂停播放MP3	无	如果当前正在播放由“播放MP3”或“同步播放MP3”命令所指定的MP3音乐，则将其暂停。
继续播放MP3	无	如果当前由“播放MP3”或“同步播放MP3”命令所播放MP3音乐已经被暂停，则继续播放。
取MP3播放状态	无	返回当前由“播放MP3”或“同步播放MP3”命令所播放MP3音乐的播放状态

十七、程序调试

易语言	火山	注释
输出调试文本	调试输出 调试输出2 调试输出3 调试输出当前语句位置	向系统调试器内输出所指定数据的调试用文本并自动换行
暂停	编译出错	暂停当前程序运行，相当于在程序代码中设置断点。
检查	调试检查	在调试版中，当所提供的参数值为假时，程序将在此处中断执行并报错。
是否为调试版	为调试版	检查当前程序是否为调试版

十八、其它

易语言	火山	注释
载入 (窗口名字, , 真)	窗口变量.创建对话框 ()	以模态对话框的方式创建并显示本窗口。 对话框窗口创建后，鼠标只能控制对话框窗口，关闭后才可以操作其它窗口。
载入 (窗口名字, , 假)	窗口变量.创建窗口 ()	创建一个普通窗口。 在普通窗口模式下，新窗口被创建后依然可以操作其它窗口，并且在操作其它窗口时可以覆盖当前被操作的窗口。
载入 (窗口名字, 父窗口名字, 假)	窗口变量.创建弹出子窗口 (父窗口名字)	创建一个窗口并将其作为其它窗口的弹出风格子窗口。 当新窗口被创建后，依然可以操作原来的窗口，但操作原窗口时不会覆盖新窗口。
选择	选择	根据所提供参数的值，返回两部分中的其中一个。
多项选择	多项选择	从参数列表项目中选择并返回一个值
是否为空	无	返回一个逻辑值，指出在调用子程序时是否为指定参数提供了数据。 注：在火山视窗中参数可提供默认值，可通过“如果”命令直接判断其参数内容即可。
是否已创建	无	如果指定的窗口或窗口组件有效且已经被载入或创建，返回真，否则返回假。
取数据类型尺寸	取数据类型尺寸	取指定数据类型的数据尺寸
取颜色值	取颜色值	将指定的RGB颜色分量组合为颜色值返回
取事件组件	无	在易语言中是用于判断当前事件是何组件产生的。 在火山视窗中可通过事件方法的“来源对象”参数获取。
事件转移	无	在易语言中，设置将第一个组件上产生的所有事件转交由第二个同窗口同类型组件的事件处理子程序去处理，就好象此事件是在第二个组件上实际发生的一样。 在火山视窗中无需处理，因为所有相同类型的组件，都是在同一个事件方法下处理。
复制窗口组件	无	复制创建与指定窗口组件设计状态完全一致的新组件
处理事件	处理事件	暂时转让控制权，以便让 Windows 操作系统有机会处理其它的如用户键盘或鼠标输入等事件。直到操作系统处理并发送完程序队列中的所有事件后，命令才会返回。
载入图片 卸载图片	无	在火山视窗中统一使用“位图对象类”处理。
取硬盘特征字	无	返回电脑中第一个物理硬盘的物理特征字，该特征字是仅硬件相关的，也就是说与任何软件系统都无关（包括操作系统）。
取系统语言	无	返回当前系统运行时环境所支持的语言版本类型
写到内存	内存填充	将数据写出到指定的内存区域，注意调用本命令前一定要确保所提供的内存区域真实有效。
DLL命令调用转向	无	本命令用来设置下次程序中执行任意一条DLL命令时所使用的DLL库文件名和在DLL库文件中的调用命令名，此设置将覆盖该被调用DLL命令在程序设计时所提供的原始值。
取组件名称	无	返回指定窗口组件的名称
取对象类型	无	如果指定对象的类型为在支持库内定义的数据类型，则返回该数据类型的名称，否则返回空文本。
寻找组件	无	按照指定条件寻找符合要求的窗口组件，成功返回非零寻找句柄，未找到返回零。
取找到组件数目	无	返回“寻找组件”命令所找到的组件数目。
取所找到组件	无	返回“寻找组件”命令所找到的指定索引位置处的组件。
清除组件寻找句柄	无	释放“寻找组件”命令所返回的组件寻找句柄，此句柄以后不能再使用。
置入代码	置入代码	在编译后文件代码段中当前语句位置置入指定的机器指令码数据。 注：在火山视窗中只能32位程序使用。
运行控制台程序	运行控制台程序	运行指定的控制台程序(不会打开控制台窗口)，返回运行结果。
取核心库版本	无	返回核心库的当前版本号
条件宏是否存在	无	返回所指定的编译条件宏是否已经被定义

十九、数据库

火山视窗中暂无EDB数据库操作方法。

二十、网络通讯

易语言	火山	注释
取主机名	无	返回本机的主机名，用作在网络通讯中标志本机地址。
通信测试	无	测试与指定主机是否能够正常通讯。返回被测试主机的通讯响应时间。如果无法通讯或者测试失败，返回 -1。
转换为主机名	无	将指定的 IP 地址转换为其主机名
转换为IP地址	无	将指定的主机名转换为其 IP 地址

二十一、控制台操作

易语言	火山	注释
标准输出	标准输出	在标准输出设备或标准错误设备上输出指定的内容
标准输入	标准输入	在标准输入设备上请求输入最多包含2048个字符的一行文本，返回用户所输入的内容。

二十二、COM对象类

在易语言中需要定义类型为“对象”的变量。

在火山视窗中需要定义类型为“COM对象类”的变量。

易语言	火山	注释
COM变量.创建	COM变量.创建	创建指定类型的 COM 对象，本对象中的原有内容将被释放。
COM变量.获取	COM变量.获取	获取当前操作系统中已经存在的指定类型 COM 对象，本对象中的原有内容将被释放。
COM变量.清除	COM变量.清除	将本对象的内容释放并清空
COM变量.是否为空	COM变量.是否为空	返回本对象的内容是否为空
COM变量.是否相等	COM变量.是否相等	返回本对象的内容是否与指定对象的内容相等
COM变量.读文本属性("属性名",参数N……) COM变量.读文本属性("属性名")	COM变量.读属性 ("属性名",文本型, 参数N……) COM变量.读无参数属性 ("属性名",文本型)	读取并返回本对象的指定文本类型属性值，如果失败将返回空文本。
COM变量.读数值属性("属性名",参数N……) COM变量.读数值属性("属性名")	COM变量.读属性 ("属性名",小数, 参数N……) COM变量.读无参数属性 ("属性名",小数)	读取并返回本对象的指定数值类型属性值，如果失败将返回数值0。
COM变量.读逻辑属性("属性名",参数N……) COM变量.读逻辑属性("属性名")	COM变量.读属性 ("属性名",逻辑型, 参数N……) COM变量.读无参数属性 ("属性名",逻辑型)	读取并返回本对象的指定逻辑型属性值，如果失败将返回假。
COM变量.读日期属性("属性名",参数N……) COM变量.读日期属性("属性名")	COM变量.读属性 ("属性名",小数, 参数N……) COM变量.读无参数属性 ("属性名",小数)	在火山视窗中无日期时间型，都是通过小数来处理，直接读小数属性即可。
COM变量.读对象型属性 ("属性名",参数N……) COM变量.读对象型属性 ("属性名")	COM变量.读对象型属性 ("属性名",COM对象类, 参数N……) COM变量.读无参数对象型属性 ("属性名",COM对象类)	读取当前对象中的COM对象属性值
COM变量.读属性 ("属性名", 参数N……) COM变量.读属性 ("属性名")	COM变量.读属性 ("属性名",COM变体型, 参数N……) COM变量.读无参数属性 ("属性名",COM变体型)	读取当前对象中的COM变体属性值
COM变量.写属性 ("属性名", 参数N……) COM变量.写属性 ("属性名")	COM变量.写属性 ("属性名", 参数N……) COM变量.写无参数属性 ("属性名")	设置本对象指定属性的值
COM变量.方法 ("方法名", 参数N……) COM变量.方法 ("方法名")	COM变量.无返回值方法 ("方法名", 参数N……) COM变量.无参数及返回值方法 ("方法名")	执行本对象的指定方法并忽略其返回值
COM变量.通用方法 ("方法名", 参数N……) COM变量.通用方法 ("方法名")	COM变量.方法 ("方法名", COM变体型, 参数N……) COM变量.无参数方法 ("方法名", COM变体型)	执行本对象的指定方法并返回一个变体型对象值 注：在火山视窗中是通过参数返回。
COM变量.文本方法("方法名",参数N……) COM变量.文本方法("方法名")	COM变量.方法 ("方法名", 文本型, 参数N……) COM变量.无参数方法 ("方法名", 文本型)	执行本对象返回文本类型数据的方法，如果失败将返回空文本。
COM变量.数值方法("方法名",参数N……) COM变量.数值方法("方法名")	COM变量.方法 ("方法名", 小数, 参数N……) COM变量.无参数方法 ("方法名", 小数)	执行本对象返回数值类型数据的方法，如果失败将返回数值0。
COM变量.逻辑方法("方法名",参数N……) COM变量.逻辑方法("方法名")	COM变量.方法 ("方法名", 逻辑型, 参数N……) COM变量.无参数方法 ("方法名", 逻辑型)	执行本对象返回逻辑型数据的方法，如果失败将返回假。
COM变量.日期方法("方法名",参数N……) COM变量.日期方法("方法名")	COM变量.方法 ("方法名", 小数, 参数N……) COM变量.无参数方法 ("方法名", 小数)	在火山视窗中无日期时间型，都是通过小数来处理，因此读取小数方法即可。
COM变量.对象型方法("方法名",参数N……) COM变量.对象型方法("方法名")	COM变量.对象型方法 ("方法名", COM对象类,参数N……) COM变量.无参数对象型方法 ("方法名", COM对象类)	执行本对象返回对象型数据的方法
COM变量.创建图片对象	COM变量.创建图片对象	为指定图片创建对应的 COM 图片对象并填入本对象中
COM变量.创建字体对象	COM变量.创建字体对象	为指定字体数据创建对应的 COM 字体对象并填入本对象中
COM变量.取回图片	COM变量.取回图片	如果本对象为 COM 图片对象，则取回其具体图片数据。
COM变量.取回字体	COM变量.取回字体	如果本对象为 COM 字体对象，则取回其中的具体字体数据。
COM变量.取错误	COM变量.取错误	当读写对象属性/执行对象方法时，紧跟该语句后执行本方法可以检查其是否执行成功。
COM变量.查看	无	通过对话框的方式查看本对象的调用格式信息，便于编写相关程序。
COM变量.取接口	COM变量.取接口	获取本对象中的指定接口，然后将其填入所指定对象中。

二十三、COM变体型

在易语言中需要定义类型为“变体型”的变量。

在火山视窗中需要定义类型为“COM变体型”的变量。

易语言	火山	注释
变体变量.清除	变体变量.清空	将本对象的内容释放并清空
变体变量.取类型	变体变量.取类型	返回本对象中值的数据类型
变体变量.取数组成员数	变体变量.取数组成员数	如果本对象中存放的是数组数据，执行本方法将返回其成员数目。
变体变量.取文本 (索引)	变体变量.取值 (文本型, 索引)	返回本对象中或本对象数组成员中的文本数据
变体变量.取数值 (索引)	变体变量.取值 (小数, 索引)	返回本对象中或本对象数组成员中的数值数据
变体变量.取逻辑值 (索引)	变体变量.取值 (逻辑型, 索引)	返回本对象中或本对象数组成员中的逻辑值数据
变体变量.取日期 (索引)	变体变量.取值 (小数, 索引)	在火山视窗中无日期时间型，统一采用小数来处理，因此使用小数类型即可。
变体变量.取对象 (索引)	变体变量.取COM对象 (COM结果变量,索引)	返回本对象中或本对象数组成员中的COM对象型数据 注：在火山视窗中是通过参数返回。
变体变量.取变体型 (索引)	变体变量.取变体型 (COM变体结果变量,索引)	返回本对象中或本对象数组成员中的变体型数据类型数据 注：在火山视窗中是通过参数返回。
变体变量.赋值 (基本类型, 索引) 变体变量.赋值 (数组类型, 索引)	变体变量.赋值 (基本类型, 索引) 变体变量.置数组 (基本数组,首索引,成员数) 变体变量.置COM对象数组 (COM对象数组,首索引,成员数) 变体变量.置变体型数组 (变体数组,首索引,成员数)	设置本对象的内容
变体变量.创建数组	变体变量.创建数组	创建指定类型和指定成员数的空白数组
变体变量.置类型	变体变量.置类型	清除当前变体型对象中的原有内容，并改变它的数据类型。
变体变量.取字节集	变体变量.取字节集	返回本对象中或本对象数组成员中的字节集数据，如果当前数据的数据类型不为字节集型，将自动进行转换，如果转换失败将返回空字节集。 注：在火山视窗中是通过参数来返回数据。

[上一章]   [下一章]

109691180

[关键字] 循环（整数 变量起始值，整数 变量目标值，整数 循环变量，整数 变量递增值）

本命令将利用变量对循环体内的命令进行循环执行。第一次执行此命令时将使用 “变量起始值” 参数初始化 “循环变量” 参数所指定的变量。每次（包括第一次）执行到此命令处都将判断循环变量内的值是否已经到达 “变量目标值” 参数所指定的值，如已到达则跳转到循环体的下一条语句，否则执行循环体。

参数 1：变量起始值，数据类型：整数，可以被省略
定义循环变量的起始数值，如果被省略，默认值为 0。

参数 2：变量目标值，数据类型：整数，可以被省略
定义循环变量的目标数值，在循环首部如果发现循环变量值已到达此目标值时（递增值小于 0 时小于等于目标值，递增值大于 0 时大于等于目标值）将跳出循环。如果被省略，默认值为 1。

参数 3：循环变量，数据类型：整数，必须提供可写入变量，可以被省略
本整数型变量将用作控制循环执行次数，在循环尾部将自动递增或递减该变量内的数值（由变量递增值参数决定）。循环体中的用户程序可以直接取用此变量中的值，如果被省略，将自动使用内部临时变量。

参数 4：变量递增值，数据类型：整数，必须提供立即数，可以被省略
每次执行到循环尾部时都将把此值加入到循环变量中去，此值可为正数或负数，如为正数则递增，为负数则递减。如果被忽略，则默认值为 1。注意：必须为本参数提供非 0 整数立即值，以便编译器建立循环结束条件。

109691180

                    

                        

                           

                           

正在渲染火山代码...

                        

                    

                    复制代码
               

109691180

完整代码整合