图书馆例程（ Library Routines）

优质

小牛编辑

191浏览

2023-12-01

提供了大量的库例程。有些内置在解释器， ex.exe, exw.exe or exu 。其他的是用Euphoria编写的，你必须在euphoria\include目录中包含一个.e文件才能使用它们。

要指出可以传入和返回的对象类型，使用以下前缀 -

预定义类型

除了使用这些类型声明变量之外，您还可以像普通函数一样调用它们，以便测试值是否是某种类型。

compare	−	compare two objects
equal	−	测试两个对象是否相同
find	−	在序列中查找对象 - 从元素编号1开始搜索
find_from	−	在序列中查找对象 - 从任何元素编号开始搜索
match	−	找到一个序列作为另一个序列的切片 - 从元素编号1开始搜索
match_from	−	找到一个序列作为另一个序列的切片 - 从任何元素编号开始搜索
sort	−	将序列的元素按升序排序
custom_sort	−	根据您提供的比较函数对序列的元素进行排序

这些例程可以应用于单个原子或值序列。

sqrt	−	计算对象的平方根
rand	−	generate random numbers
sin	−	计算角度的正弦值
arcsin	−	用给定的正弦值计算角度
cos	−	计算角度的余弦值
arccos	−	用给定的余弦计算角度
tan	−	计算角度的正切
arctan	−	计算数字的反正切
log	−	calculate the natural logarithm
floor	−	向下舍入到最接近的整数
remainder	−	计算一个数除以另一个时的余数
power	−	计算一个提升到一个幂的数字
PI	−	数学值PI（3.14159 ......）

这些例程将数字视为二进制位的集合，并且对数字的二进制表示中的相应位执行逻辑运算。

没有用于向左或向右移位的例程，但是您可以通过乘以或除以2的幂来实现相同的效果。

要在文件或设备上进行输入或输出，必须先打开文件或设备，然后使用下面的例程读取或写入，然后关闭文件或设备。 open()将为您提供一个文件号，用作其他I/O例程的第一个参数。某些文件/设备会自动为您打开（作为文本文件） -

open	−	打开文件或设备
close	−	关闭文件或设备
flush	−	将缓冲的数据清除到文件或设备
lock_file	−	锁定文件或设备
unlock_file	−	解锁文件或设备
print	−	在一行上打印一个Euphoria对象，用大括号和逗号{,,}来显示结构
pretty_print	−	使用多行和适当的缩进以可读的形式打印Euphoria对象
？ X	−	shorthand for print(1, x)
sprint	−	将打印的Euphoria对象作为字符串序列返回
printf	−	格式化打印到文件或设备
sprintf	−	格式化的打印作为字符串序列返回
puts	−	将字符串序列输出到文件或设备
getc	−	从文件或设备中读取下一个字符
gets	−	从文件或设备中读取下一行
get_bytes	−	从文件或设备中读取下n个字节
prompt_string	−	提示用户输入字符串
get_key	−	检查用户按下的键，不要等待
wait_key	−	等待用户按一个键
get	−	从文件中读取任何Euphoria对象的表示
prompt_number	−	提示用户输入一个数字
value	−	从字符串中读取任何Euphoria对象的表示
seek	−	移动到打开文件中的任何字节位置
where	−	报告打开文件中的当前字节位置
current_dir	−	返回当前目录的名称
chdir	−	切换到新的当前目录
dir	−	返回目录中所有文件的完整信息
walk_dir	−	递归遍历目录中的所有文件
allow_break	−	允许control-c/control-Break终止你的程序
check_break	−	检查用户是否按下了control-c或control-Break

在Windows XP上，如果希望DOS鼠标在（非全屏）窗口中工作，则必须在DOS窗口的属性中禁用QuickEdit模式。

machine_func	−	具有返回值的专门内部操作
machine_proc	−	专门的内部操作，没有返回值

trace	−	动态打开或关闭跟踪
profile	−	动态打开或关闭分析

以下例程允许您在屏幕上显示信息。在DOS中，PC屏幕可以放置在许多图形模式之一中。

以下例程适用于所有文本和像素图形模式。

clear_screen	−	clear the screen
position	−	设置光标线和列
get_position	−	返回光标行和列
graphics_mode	−	选择一个新的像素图形或文本模式（DOS32）
video_config	−	返回当前模式的参数
scroll	−	向上或向下滚动文本
wrap	−	控制线包裹在屏幕的右边缘
text_color	−	设置前景文字颜色
bk_color	−	设置背景颜色
palette	−	更改一个颜色编号的颜色（DOS32）
all_palette	−	更改所有颜色编号的颜色（DOS32）
get_all_palette	−	获取所有颜色的调色板值（DOS32）
read_bitmap	−	读取位图（.bmp）文件并返回调色板和2-D像素序列
save_bitmap	−	在给定调色板和2维像素序列的情况下创建位图（.bmp）文件
get_active_page	−	返回当前正在写入的页面（DOS32）
set_active_page	−	更改当前正在写入的页面（DOS32）
get_display_page	−	返回当前正在显示的页面（DOS32）
set_display_page	−	更改当前显示的页面（DOS32）
sound	−	在PC扬声器上发出声音（DOS32）

以下例程仅在模式下以文本形式工作

以下例程仅适用于像素图形模式（DOS32）