Ruby 內建函式

由於Kernel模組被Object類包含，因此它的方法在Ruby程式的任何地方都可用。它們可以在沒有接收者的情況下被呼叫（函式形式）。因此，它們通常被稱為函式。

此處提供完整的內建函式列表以供參考 -

序號	方法及描述
1	abort 終止程式。如果引發異常（即$！不為nil），則顯示其錯誤訊息。
2	Array( obj) 使用to_ary或to_a將obj轉換為陣列後返回obj。
3	at_exit {...} 註冊一個塊，以便在程式退出時執行。類似於END語句，但END語句僅註冊一次塊。
4	autoload( classname, file) 註冊一個類classname，以便在第一次使用時從檔案載入。classname可以是字串或符號。
5	binding 返回當前變數和方法繫結。返回的Binding物件可以作為第二個引數傳遞給eval方法。
6	block_given? 如果方法是用塊呼叫的，則返回true。
7	callcc {\| c\|...} 將Continuation物件c傳遞給塊並執行塊。callcc可用於全域性退出或迴圈構造。
8	caller([ n]) 以file:line形式的字串陣列的形式返回當前執行堆疊。如果指定了n，則從第n級開始返回堆疊條目。
9	catch( tag) {...} 捕獲在執行其塊期間由throw呼叫的非本地退出。
10	chomp([ rs = $/]) 返回變數$_的值，並刪除結尾的換行符，並將結果賦值回$_。換行符字串的值可以使用rs指定。
11	chomp!([ rs = $/]) 從$_中刪除換行符，就地修改字串。
12	chop 返回$_的值，並刪除其最後一個字元（一個位元組），並將結果賦值回$_。
13	chop! 從$_中刪除最後一個字元，就地修改字串。
14	eval( str[, scope[, file, line]]) 將str作為Ruby程式碼執行。可以使用scope指定執行繫結的範圍。可以使用file和line指定要編譯的程式碼的檔名和行號。
15	exec( cmd[, arg...]) 透過執行命令cmd替換當前程序。如果指定了多個引數，則命令將不帶shell擴充套件執行。
16	exit([ result = 0]) 退出程式，result作為返回的狀態程式碼。
17	exit!([ result = 0]) 終止程式，繞過退出處理（例如ensure等）。
18	fail(...) 參見raise(...)
19	Float( obj) 將obj轉換為浮點數後返回obj。數值物件直接轉換；nil轉換為0.0；字串在考慮0x、0b基數字首的情況下進行轉換。其餘使用obj.to_f轉換。
20	fork fork {...} 建立子程序。在子程序中返回nil，在父程序中返回子程序的ID（整數）。如果指定了塊，則在子程序中執行。
21	format( fmt[, arg...]) 參見sprintf。
22	gets([ rs = $/]) 讀取命令列中指定的檔名或標準輸入中的一行。可以使用rs顯式指定記錄分隔符字串。
23	global_variables 返回全域性變數名稱的陣列。
24	gsub( x, y) gsub( x) {...} 將$_中所有與x匹配的字串替換為y。如果指定了塊，則匹配的字串將替換為塊的結果。修改後的結果分配給$_。
25	gsub!( x, y) gsub!( x) {...} 執行與gsub相同的替換，但字串就地更改。
26	Integer( obj) 將obj轉換為整數後返回obj。數值物件直接轉換；nil轉換為0；字串在考慮0x、0b基數字首的情況下進行轉換。其餘使用obj.to_i轉換。
27	lambda {\| x\|...} proc {\| x\|...} lambda proc 將塊轉換為Proc物件。如果沒有指定塊，則轉換與呼叫方法關聯的塊。
28	load( file[, private = false]) 從file載入Ruby程式。與require不同，它不載入擴充套件庫。如果private為true，則程式載入到匿名模組中，從而保護呼叫程式的名稱空間。
29	local_variables 返回區域性變數名稱的陣列。
30	loop {...} 重複一段程式碼。
31	open( path[, mode = "r"]) open( path[, mode = "r"]) {\| f\|...} 開啟一個file。如果指定了塊，則使用作為引數傳遞的開啟流執行塊。塊退出時，檔案會自動關閉。如果path以管道\|開頭，則以下字串作為命令執行，並返回與該程序關聯的流。
32	p( obj) 使用其inspect方法顯示obj（通常用於除錯）。
33	print([ arg...]) 將arg列印到$defout。如果沒有指定引數，則列印$_的值。
34	printf( fmt[, arg...]) 使用sprintf根據fmt格式化arg，並將結果列印到$defout。有關格式規範的詳細資訊，請參閱sprintf。
35	proc {\| x\|...} proc 參見lamda。
36	putc( c) 將一個字元列印到預設輸出（$defout）。
37	puts([ str]) 將字串列印到預設輸出（$defout）。如果字串不以換行符結尾，則將換行符追加到字串。
38	raise(...) fail(...) 引發異常。如果沒有指定異常類，則假定為RuntimeError。在rescue子句中不帶引數呼叫raise會重新引發異常。在rescue子句之外這樣做會引發無訊息的RuntimeError。fail是raise的過時名稱。
39	rand([ max = 0]) 生成一個大於或等於0且小於max的偽隨機數。如果未指定max或將其設定為0，則返回一個浮點數形式的隨機數，該數大於或等於0且小於1。srand可用於初始化偽隨機流。
40	readline([ rs = $/]) 等效於gets，除了在讀取EOF時引發EOFError異常。
41	readlines([ rs = $/]) 返回一個字串陣列，其中包含作為命令列引數指定的檔名或標準輸入的內容。
42	require( lib) 在第一次呼叫時載入庫（包括擴充套件庫）lib。require不會載入同一個庫多次。如果在lib中未指定副檔名，則require嘗試向其新增.rb、.so等。
43	scan( re) scan( re) {\|x\|...} 等效於$_.scan。
44	select( reads[, writes = nil[, excepts = nil[, timeout = nil]]]) 檢查三種類型的IO物件（輸入、輸出和異常）的狀態更改，這些物件作為IO物件的陣列傳遞。對於不需要檢查的引數，傳遞nil。返回一個包含三個元素的陣列，其中包含狀態發生變化的IO物件的陣列。在超時時返回nil。
45	set_trace_func( proc) 設定跟蹤處理程式。proc可以是字串或proc物件。set_trace_func由偵錯程式和分析器使用。
46	sleep([ sec]) 暫停程式執行sec秒。如果未指定sec，則程式將無限期暫停。
47	split([ sep[, max]]) 等效於$_.split。
48	sprintf( fmt[, arg...]) format( fmt[, arg...]) 返回一個字串，其中arg根據fmt進行格式化。格式規範基本上與C程式語言中sprintf的格式規範相同。fmt中的轉換說明符（%後跟轉換欄位說明符）將替換為相應引數的格式化字串。下一節將列出轉換欄位列表。
49	srand([ seed]) 初始化一個隨機數陣列。如果未指定seed，則使用時間和其他系統資訊初始化種子。
50	String( obj) 使用obj.to_s將obj轉換為字串後返回obj。
51	syscall( sys[, arg...]) 呼叫由數字sys指定的作業系統呼叫函式。sys的數字和含義與系統相關。
52	system( cmd[, arg...]) 將cmd作為對命令列的呼叫執行。如果指定了多個引數，則命令將不帶shell擴充套件直接執行。如果返回狀態為0（成功），則返回true。
53	sub( x, y) sub( x) {...} 將$_中第一個與x匹配的字串替換為y。如果指定了塊，則匹配的字串將替換為塊的結果。修改後的結果分配給$_。
54	sub!( x, y) sub!( x) {...} 執行與sub相同的替換，但字串就地更改。
55	test( test, f1[, f2]) 執行由字元test指定的各種檔案測試。為了提高可讀性，您應該使用File類方法（例如File::readable?）而不是此函式。下一節將列出引數列表。
56	throw( tag[, value = nil]) 跳轉到使用符號或字串tag等待的catch函式。value是要由catch使用的返回值。
57	trace_var( var, cmd) trace_var( var) {...} 設定全域性變數的跟蹤。變數名稱指定為符號。cmd可以是字串或Proc物件。
58	trap( sig, cmd) trap( sig) {...} 設定訊號處理程式。sig 可以是字串（例如 SIGUSR1）或整數。訊號名稱中的 SIG 可以省略。EXIT 訊號或訊號編號 0 的訊號處理程式在程序終止之前被呼叫。
59	untrace_var( var[, cmd]) 移除全域性變數的跟蹤。如果指定了cmd，則僅移除該命令。

數字函式

以下是與數字相關的內建函式列表。它們應按如下方式使用：

即時演示

#!/usr/bin/ruby

num = 12.40
puts num.floor      # 12
puts num + 10       # 22.40
puts num.integer?   # false  as num is a float.

這將產生以下結果：

12
22.4
false

假設，n 是一個數字：

序號	方法及描述
1	n + num n - num *n num n / num** 執行算術運算：加法、減法、乘法和除法。
2	n % num 返回 n 的模。
3	n num** 指數運算。
4	n.abs 返回 n 的絕對值。
5	n.ceil 返回大於或等於 n 的最小整數。
6	n.coerce( num) 返回一個數組，其中包含 num 和 n，兩者都可能轉換為允許它們相互運算的型別。用於數值運算子中的自動型別轉換。
7	n.divmod( num) 返回一個數組，其中包含將 n 除以 num 得到的商和餘數。
8	n.floor 返回小於或等於 n 的最大整數。
9	n.integer? 如果 n 是整數，則返回 true。
10	n.modulo( num) 返回透過將 n 除以 num 並使用floor對商進行舍入得到的模。
11	n.nonzero? 如果 n 不為零，則返回 n，否則返回 nil。
12	n.remainder( num) 返回透過將n除以num並從商中刪除小數得到的餘數。結果和n始終具有相同的符號。
13	n.round 返回四捨五入到最接近整數的 n。
14	n.truncate 返回 n 作為整數，並刪除小數。
15	n.zero? 如果 n 為 0，則返回零。
16	n & num n \| num n ^ num 按位運算：AND、OR、XOR 和反轉。
17	n << num n >> num 按位左移和右移。
18	n[num] 返回從最低有效位開始的第num位的數值，即 n[0]。
19	n.chr 返回一個包含字元程式碼n對應字元的字串。
20	n.next n.succ 返回緊隨 n 之後的下一個整數。等價於 n + 1。
21	n.size 返回n的機器表示中的位元組數。
22	n.step( upto, step) {\|n\| ...} 從n迭代到upto，每次遞增step。
23	n.times {\|n\| ...} 迭代塊n次。
24	n.to_f 將n轉換為浮點數。浮點數轉換可能會丟失精度資訊。
25	n.to_int 轉換為整數後返回n。

浮點數函式

以下是專門用於浮點數的 Ruby 內建函式列表。假設我們有一個浮點數f：

序號	方法及描述
1	Float::induced_from(num) 返回將num轉換為浮點數的結果。
2	f.finite? 如果f不是無窮大且 f.nan 為假，則返回 true。
3	f.infinite? 如果f為正無窮大，則返回 1；如果為負無窮大，則返回 -1；否則返回 nil。
4	f.nan? 如果f不是有效的 IEEE 浮點數，則返回 true。

數學函式

以下是 Ruby 內建數學函式列表：

序號	方法及描述
1	atan2( x, y) 計算反正切。
2	cos( x) 計算 x 的餘弦。
3	exp( x) 計算指數函式（e 的 x 次冪）。
4	frexp( x) 返回一個包含 x 的標準化分數和指數的兩個元素陣列。
5	ldexp( x, exp) 返回 x 乘以 2 的 exp 次冪的值。
6	log( x) 計算 x 的自然對數。
7	log10( x) 計算 x 的以 10 為底的對數。
8	sin( x) 計算 x 的正弦。
9	sqrt( x) 返回 x 的平方根。x 必須為正數。
10	tan( x) 計算 x 的正切。

轉換欄位說明符

函式sprintf( fmt[, arg...]) 和 format( fmt[, arg...])返回一個字串，其中 arg 根據 fmt 進行格式化。格式化規範與 C 程式語言中 sprintf 的格式化規範基本相同。fmt中的轉換說明符（% 後跟轉換欄位說明符）將被相應引數的格式化字串替換。

序號	說明符 & 描述
1	b 二進位制整數
2	c 單個字元
3	d,i 十進位制整數
4	e 指數表示法（例如，2.44e6）
5	E 指數表示法（例如，2.44E6）
6	f 浮點數（例如，2.44）
7	g 如果指數小於 -4，則使用 %e，否則使用 %f
8	G 如果指數小於 -4，則使用 %E，否則使用 %f
9	o 八進位制整數
10	s 字串或使用 to_s 轉換的任何物件
11	u 無符號十進位制整數
12.	x 十六進位制整數（例如，39ff）
13	X 十六進位制整數（例如，39FF）

Ruby 的 format 支援以下轉換說明符：

以下是用法示例：

即時演示

#!/usr/bin/ruby

str = sprintf("%s\n", "abc")   # => "abc\n" (simplest form)
puts str 

str = sprintf("d=%d", 42)      # => "d=42" (decimal output)
puts str 

str = sprintf("%04x", 255)     # => "00ff" (width 4, zero padded)
puts str 

str = sprintf("%8s", "hello")  # => " hello" (space padded)
puts str 

str = sprintf("%.2s", "hello") # => "he" (trimmed by precision)
puts str

這將產生以下結果：

abc
d = 42
00ff
   hello
he

測試函式引數

函式test( test, f1[, f2])執行由字元test指定的以下檔案測試之一。為了提高可讀性，您應該使用 File 類方法（例如，File::readable?）而不是此函式。

以下是帶一個引數的檔案測試：

序號	引數 & 描述
1	?r f1 是否可被呼叫者的有效 uid 讀取？
2	?w f1 是否可被呼叫者的有效 uid 寫入？
3	?x f1 是否可被呼叫者的有效 uid 執行？
4	?o f1 是否歸呼叫者的有效 uid 所有？
5	?R f1 是否可被呼叫者的真實 uid 讀取？
6	?W f1 是否可被呼叫者的真實 uid 寫入？
7	?X f1 是否可被呼叫者的真實 uid 執行？
8	?O f1 是否歸呼叫者的真實 uid 所有？
9	?e f1 是否存在？
10	?z f1 的長度是否為零？
11	?s f1 的檔案大小（如果為 0 則為 nil）
12	?f f1 是否為普通檔案？
13	?d f1 是否為目錄？
14	?l f1 是否為符號連結？
15	?p f1 是否為命名管道 (FIFO)？
16	?S f1 是否為套接字？
17	?b f1 是否為塊裝置？
18	?c f1 是否為字元裝置？
19	?u f1 是否設定了 setuid 位？
20	?g f1 是否設定了 setgid 位？
21	?k f1 是否設定了粘滯位？
22	?M f1 的上次修改時間。
23	?A f1 的上次訪問時間。
24	?C f1 的上次 inode 更改時間。

帶兩個引數的檔案測試如下：

序號	引數 & 描述
1	?= f1 和 f2 的修改時間是否相等？
2	?> f1 的修改時間是否比 f2 新？
3	?< f1 的修改時間是否比 f2 舊？
4	?- f1 是否是 f2 的硬連結？

以下是用法示例。假設 main.rb 存在並具有讀、寫許可權，但沒有執行許可權：

即時演示

#!/usr/bin/ruby

puts test(?r, "main.rb" )   # => true
puts test(?w, "main.rb" )   # => true
puts test(?x, "main.rb" )   # => false

這將產生以下結果：

true
false
false

列印頁面