class Shell::Glob + Shell::BuiltInCommand + Shell::Filter + Enumerable
クラスの継承リスト: Shell::Glob < Shell::BuiltInCommand < Shell::Filter < Enumerable < Object < Kernel
要約
特異メソッド
new(sh, pattern)
-
[TODO]
new(sh) -> Shell::Filter
-
Shell::Filter クラスのインスタンスを返します。 通常このメソッドを直接使う機会は少ないでしょう。
インスタンスメソッド
self + filter
-
執筆者募集
filter1 + filter2 は filter1の出力の後, filter2の出力を行う。
self < src -> self
-
srcをフィルタの入力とする。 srcが, 文字列ならばファイルを, IOオブジェクトであれ ばそれをそのまま入力とする。
- [PARAM] src:
- フィルタの入力を, 文字列もしくは,IO オブジェクトで指定します。
使用例
Shell.def_system_command("head") sh = Shell.new sh.transact { (sh.head("-n 30") < "/etc/passwd") > "ugo.txt" }
self > to -> self
-
toをフィルタの出力とする。 toが, 文字列ならばファイルに, IOオブジェクトであれ ばそれをそのまま出力とする。
- [PARAM] to:
- 出力先を指定します。文字列ならばファイルに,IOオブジェクトならばそれに出力します。
使用例
Shell.def_system_command("tail") sh = Shell.new sh.transact { (sh.tail("-n 3") < "/etc/passwd") > File.open("tail.out", "w") #(sh.tail("-n 3") < "/etc/passwd") > "tail.out" # と同じ. }
self >> to -> self
-
toをフィルタに追加する。 toが, 文字列ならばファイルに, IOオブジェクトであれば それをそのまま出力とする。
- [PARAM] to:
- 出力先を指定します。文字列ならばファイルに、IOオブジェクトならばそれに出力します。
使用例
Shell.def_system_command("tail") sh = Shell.new sh.transact { (sh.tail("-n 3") < "/etc/passwd") >> "tail.out" #(sh.tail("-n 3") < "/etc/passwd") >> File.open("tail.out", "w") # でも同じ。 }
test(command, file1, file2 = nil) -> bool | Time | Integer | nil
self[command, file1, file2 = nil] -> bool | Time | Integer | nil
-
Kernel.#test や FileTest のメソッドに処理を委譲します。
- [PARAM] command:
- 数値、またはサイズが 1 の文字列の場合は Kernel.#test に処理委譲します。 2 文字以上の文字列の場合は FileTest のメソッドとして実行します。
- [PARAM] file1:
- 文字列でファイルへのパスを指定します。
- [PARAM] file2:
- 文字列でファイルへのパスを指定します。
require 'shell' Shell.verbose = false sh = Shell.new begin sh.mkdir("foo") rescue end p sh[?e, "foo"] # => true p sh[:e, "foo"] # => true p sh["e", "foo"] # => true p sh[:exists?, "foo"] # => true p sh["exists?", "foo"] # => true
[SEE_ALSO] Kernel.#test, FileTest
active? -> true
-
[TODO]
all? -> bool
all? {|item| ... } -> bool
-
すべての要素が真である場合に true を返します。 偽である要素があれば、ただちに false を返します。
ブロックを伴う場合は、各要素に対してブロックを評価し、すべての結果 が真である場合に true を返します。ブロックが偽を返した時点で、 ただちに false を返します。
例:
# すべて正の数か? p [5, 6, 7].all? {|v| v > 0 } # => true p [5, -1, 7].all? {|v| v > 0 } # => false
any? -> bool
any? {|item| ... } -> bool
-
すべての要素が偽である場合に false を返します。 真である要素があれば、ただちに true を返します。
ブロックを伴う場合は、各要素に対してブロックを評価し、すべての結果 が偽である場合に false を返します。ブロックが真を返した時点 で、ただちに true を返します。
例:
p [1, 2, 3].any? {|v| v > 3 } # => false p [1, 2, 3].any? {|v| v > 1 } # => true
append(to, filter) -> Shell::AppendFile | Shell::AppendIO
-
[TODO]
- [PARAM] to:
- 文字列か IO を指定します。
- [PARAM] filter:
- Shell::Filter のインスタンスをしています。
atime(filename) -> Time
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] File.atime
basename(filename, suffix = "") -> String
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列を指定します。
- [PARAM] suffix:
- サフィックスを文字列で与えます。'.*' という文字列を与えた場合、'*' はワイルドカードとして働き '.' を含まない任意の文字列にマッチします。
[SEE_ALSO] File.basename
blockdev?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] FileTest.#blockdev?
cat(*files) -> Shell::Filter
-
実行すると, それらを内容とする Filter オブジェクトを返します.
- [PARAM] files:
- シェルコマンド cat に与えるファイル名を文字列で指定します。
動作例
require 'shell' Shell.def_system_command("head") sh = Shell.new sh.transact { glob("*.txt").to_a.each { |file| file.chomp! cat(file).each { |l| echo(l) | tee(file + ".tee") >> "all.tee" } } }
chardev?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] FileTest.#chardev?
check_point
finish_all_jobs
-
[TODO]
chmod(mode, *filename) -> Integer
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列を指定します。
- [PARAM] mode:
- chmod(2) と同様に整数で指定します。
[SEE_ALSO] File.chmod
chown(owner, group, *filename) -> Integer
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] owner:
- chown(2) と同様に数値で指定します。nil または -1 を指定することで、オーナーを現在の>ままにすることができます。
- [PARAM] group:
- chown(2) と同様に数値で指定します。nil または -1 を指定することで、グループを現在の>ままにすることができます。
- [PARAM] filename:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] File.chown
compare(file1, file2) -> bool
cmp(file1, file2) -> bool
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] file1:
- ファイルの名前を文字列で与えます。
- [PARAM] file2:
- 新しいファイル名を文字列で与えます。
[SEE_ALSO] File.compare
collect {|item| ... } -> [object]
map {|item| ... } -> [object]
-
各要素に対してブロックを評価した結果を全て含む配列を返します。
ブロックを省略した場合、 obj.collect {|item| item } を実行します。 これは Enumerable#to_a と同じです。
例:
# すべて 3 倍にする p [1, 2, 3].map {|n| n * 3 } # => [3, 6, 9]
concat(*jobs) -> Shell::Concat
-
[TODO]
copy(from, to) -> bool
cp(from, to) -> bool
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] from:
- ファイルの名前を文字列で与えます。
- [PARAM] to:
- 新しいファイル名を文字列で与えます。
[SEE_ALSO] File.copy
count -> Integer
count(item) -> Integer
count {|obj| ... } -> Integer
-
レシーバの要素数を返します。
引数を指定しない場合は、レシーバの要素数を返します。 このとき、レシーバが size メソッドを持っていればそちらを使用します。 レシーバが size メソッドを持っていない場合は、要素数を一つずつカウントします。
引数を一つ指定した場合は、レシーバの要素のうち引数に一致するものの 個数をカウントして返します(一致は == で判定します)。
ブロックを指定した場合は、ブロックを評価して真になった要素の個数を カウントして返します。
- [PARAM] item:
- カウント対象となる値。
例:
ary = [1, 2, 4, 2] ary.count # => 4 ary.count(2) # => 2 ary.count{|x|x%2==0} # => 3
ctime(filename) -> Time
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] File.ctime
cycle(n=nil) -> Enumerable::Enumerator
cycle(n=nil) {|obj| ... } -> object | nil
-
Enumerable オブジェクトの各要素を n 回 or 無限回(n=nil)繰り返し ブロックを呼びだします。
n に 0 もしくは負の値を渡した場合は何もしません。 繰り返しが最後まで終了した場合(つまりbreakなどで中断しなかった場合) は nil を返します。 このメソッドは内部の配列に各要素を保存しておくため、 一度 Enumerable の終端に到達した後に自分自身を変更しても このメソッドの動作に影響を与えません。
a = ["a", "b", "c"] a.cycle {|x| puts x } # print, a, b, c, a, b, c,.. forever. a.cycle(2) {|x| puts x } # print, a, b, c, a, b, c.
- [RETURN]
- ブロックを指定しなかった場合は、Enumerable::Enumerator を返します。 レシーバが空の場合は nil を返します。
delete(*filename) -> Integer
rm(*filename) -> Integer
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] File.delete
find(ifnone = nil) -> Enumerable::Enumerator
detect(ifnone = nil) -> Enumerable::Enumerator
find(ifnone = nil) {|item| ... } -> object
detect(ifnone = nil) {|item| ... } -> object
-
要素に対してブロックを評価した値が真になった最初の要素を返します。
真になる要素が見つからず、ifnone も指定されていないときは nil を返します。 真になる要素が見つからず、ifnone が指定されているときは ifnone を call した結果を返します。
- [PARAM] ifnone:
- call メソッドを持つオブジェクト (例えば Proc) を指定します。
例:
# 最初の 3 の倍数を探す p [1, 2, 3, 4, 5].find {|i| i % 3 == 0 } # => 3 p [2, 2, 2, 2, 2].find {|i| i % 3 == 0 } # => nil # ifnone の使用例 ifnone = proc { raise ArgumentError, "item not found" } p [1, 2, 3, 4, 5].find(ifnone) {|i| i % 7 == 0 } # ArgumentError: item not found
directory?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] FileTest.#directory?
dirname(filename) -> String
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] File.dirname
drop(n) -> Array
-
Enumerable オブジェクトの先頭の n 要素を捨てて、 残りの要素を配列として返します。
- [PARAM] n:
- 捨てる要素数。
a = [1, 2, 3, 4, 5, 0] a.drop(3) # => [4, 5, 0]
drop_while -> Enumerable::Enumerator
drop_while {|element| ... } -> Array
-
ブロックを評価して最初に偽となった要素の手前の要素まで捨て、 残りの要素を配列として返します。
ブロックを指定しなかった場合は、Enumerable::Enumerator を返します。
a = [1, 2, 3, 4, 5, 0] a.drop_while {|i| i < 3 } # => [3, 4, 5, 0]
each(rs = nil) {|file| ... }
-
[TODO]
each(rs = nil) -> ()
-
フィルタの一行ずつをblockに渡します。
- [PARAM] rs:
- レコードセパレーターを表す文字列を指定します。 nil ならば、Shell.record_separatorの値が使用されます。
使用例
sh = Shell.new sh.cat("/etc/passwd").each { |line| puts line }
each_cons(n) -> Enumerable::Enumerator
enum_cons(n) -> Enumerable::Enumerator
each_cons(n) {|list| ... } -> nil
enum_cons(n) {|list| ... } -> nil
-
要素を重複ありで n 要素ずつに区切り、 ブロックに渡して繰り返します。
enum_cons は 1.9.1 以降ではなくなっています。 代わりに each_cons を使ってください。
- [PARAM] n:
- ブロックに渡す要素の数です。正の整数を与えます。 要素数より大きな数を与えると、ブロックは一度も実行されません。
例:
(1..10).each_cons(3){|v| p v } # => [1, 2, 3] # [2, 3, 4] # [3, 4, 5] # [4, 5, 6] # [5, 6, 7] # [6, 7, 8] # [7, 8, 9] # [8, 9, 10]
[SEE_ALSO] Enumerable#each_slice
each_slice(n) -> Enumerable::Enumerator
enum_slice(n) -> Enumerable::Enumerator
each_slice(n) {|list| ... } -> nil
enum_slice(n) {|list| ... } -> nil
-
n 要素ずつブロックに渡して繰り返します。
要素数が n で割り切れないときは、最後の回だけ要素数が減ります。
enum_slice は 1.9.1 以降ではなくなっています。 代わりに each_slice を使ってください。
- [PARAM] n:
- 区切る要素数を示す整数です。
例:
(1..10).each_slice(3) {|a| p a} # => [1, 2, 3] # [4, 5, 6] # [7, 8, 9] # [10]
[SEE_ALSO] Enumerable#each_cons
each_with_index -> Enumerable::Enumerator
enum_with_index -> Enumerable::Enumerator
each_with_index {|item, index| ... } -> self
-
要素とそのインデックスをブロックに渡して繰り返します。
self を返します。
例:
[5, 10, 15].each_with_index do |n, idx| p [n, idx] end # => [5, 0] # [10, 1] # [15, 2]
echo(*strings) -> Shell::Filter
-
実行すると, それらを内容とする Filter オブジェクトを返します.
- [PARAM] strings:
- シェルコマンド echo に与える引数を文字列で指定します。
動作例
require 'shell' Shell.def_system_command("head") sh = Shell.new sh.transact { glob("*.txt").to_a.each { |file| file.chomp! cat(file).each { |l| echo(l) | tee(file + ".tee") >> "all.tee" } } }
to_a -> [object]
entries -> [object]
-
全ての要素を含む配列を返します。
executable?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#executable?
executable_real?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#executable_real?
exist?(file) -> bool
exists?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] FileTest.#exist? FileTest.#exists?
file?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] FileTest.#file?
find_all -> Enumerable::Enumerator
select -> Enumerable::Enumerator
find_all {|item| ... } -> [object]
select {|item| ... } -> [object]
-
各要素に対してブロックを評価した値が真であった要素を全て含む配列を 返します。真になる要素がひとつもなかった場合は空の配列を返します。
find_index -> Enumerable::Enumerator
find_index {|obj| ... } -> Integer | nil
-
要素を先頭から順にブロックに渡して評価し、最初に真になった要素のインデックスを返します。 一つも真にならなければ nil を返します。
(1..10).find_index {|i| i % 5 == 0 and i % 7 == 0 } #=> nil (1..100).find_index {|i| i % 5 == 0 and i % 7 == 0 } #=> 34
ブロックを指定しなかった場合は、Enumerable::Enumerator を返します。
find_system_command(command)
-
[TODO]
first -> object | nil
first(n) -> Array
-
Enumerable オブジェクトの最初の要素、もしくは最初の n 要素を返します。
Enumerable オブジェクトが空の場合、引数を指定しない形式では nil を返します。 引数を指定する形式では、空の配列を返します。
- [PARAM] n:
- 取得する要素数。
e = "abcd".each_byte e.first #=> 97 e.first(2) #=> [97,98] e = "".each_byte e.first #=> nil e.first(2) #=> []
foreach(path = nil, &block) -> ()
-
pathがファイルなら, File#foreach pathがディレクトリなら, Dir#foreach の動作をします。
- [PARAM] path:
- ファイルもしくはディレクトリのパスを文字列で指定します。
使用例
require 'shell' Shell.verbose = false sh = Shell.new sh.foreach("/tmp"){|f| puts f }
ftype(filename) -> String
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] File.ftype
glob(patten) -> Shell::Filter
-
実行すると, それらを内容とする Filter オブジェクトを返します.
- [PARAM] patten:
- シェルコマンド glob に与えるパターンを指定します。 パターンの書式については、Dir.[]を参照してください。
動作例
require 'shell' Shell.def_system_command("head") sh = Shell.new sh.transact { glob("*.txt").to_a.each { |file| file.chomp! cat(file).each { |l| echo(l) | tee(file + ".tee") >> "all.tee" } } }
[SEE_ALSO] Dir.[]
grep(pattern) -> [object]
grep(pattern) {|item| ... } -> [object]
-
pattern === item が成立する要素を全て含んだ配列を返します。
ブロックとともに呼び出された時には条件の成立した要素に対して それぞれブロックを評価し、その結果の配列を返します。 マッチする要素がひとつもなかった場合は空の配列を返します。
- [PARAM] pattern:
- 「===」メソッドを持つオブジェクトを指定します。
例:
['aa', 'bb', 'cc', 'dd', 'ee'].grep(/[bc]/) # => ["bb", "cc"] Array.instance_methods.grep(/gr/) # => ["group_by", "grep"]
group_by -> Enumerable::Enumerator
group_by {|obj| ... } -> Hash
-
ブロックを評価した結果をキー、対応する要素の配列を値とするハッシュを返します。
(1..6).group_by {|i| i%3} #=> {0=>[3, 6], 1=>[1, 4], 2=>[2, 5]}
grpowned?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] FileTest.#grpowned?
identical?
-
[TODO]
member?(val) -> bool
include?(val) -> bool
-
val と == の関係にある要素を含むとき真を返します。
- [PARAM] val:
- 任意のオブジェクト
inject(init = self.first) {|result, item| ... } -> object
inject(sym) -> object
inject(init, sym) -> object
reduce(init = self.first) {|result, item| ... } -> object
reduce(sym) -> object
reduce(init, sym) -> object
-
リストのたたみこみ演算を行います。
最初に初期値 init と self の最初の要素を引数にブロックを実行します。 2 回目以降のループでは、前のブロックの実行結果と self の次の要素を引数に順次ブロックを実行します。 そうして最後の要素まで繰り返し、最後のブロックの実行結果を返します。
要素が存在しない場合は init を返します。
初期値 init を省略した場合は、 最初に先頭の要素と 2 番目の要素をブロックに渡します。 また要素が 1 つしかなければブロックを実行せずに最初の要素を返します。 要素がなければブロックを実行せずに nil を返します。
- [PARAM] init:
- 最初の result の値です。任意のオブジェクトが渡せます。
- [PARAM] sym:
- ブロックの代わりに使われるメソッド名を表す Symbol オブジェクトを指定します。 実行結果に対して sym という名前のメソッドが呼ばれます。
例:
# 合計を計算する。 p [2, 3, 4, 5].inject {|result, item| result + item } #=> 14 # 自乗和を計算する。初期値をセットする必要がある。 p [2, 3, 4, 5].inject(0) {|result, item| result + item**2 } #=> 54
この式は以下のように書いても同じ結果が得られます。
result = 0 [1, 2, 3, 4, 5].each {|v| result += v } p result # => 15 p [1, 2, 3, 4, 5].inject(:+) #=> 15 p ["b", "c", "d"].inject("abbccddde", :squeeze) #=> "abcde"
input -> Shell::Filter | nil
-
現在のフィルターを返します。
input=(filter)
-
フィルターを設定します。
- [PARAM] filter:
- フィルターを指定します。
inspect -> String
-
オブジェクトを人間が読める形式に変換した文字列を返します。
[SEE_ALSO] Object#inspect
install(from, to, mode = nil, verbose = false) -> ()
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] from:
- コピー元のファイル。
- [PARAM] to:
- コピー先のファイル。
- [PARAM] mode:
- ファイルのアクセスモード。8進数で指定します。
- [PARAM] verbose:
- 真を指定すると詳細を表示します。
[SEE_ALSO] File.install
join(*item) -> String
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] item:
- 連結したいディレクトリ名やファイル名を文字列で与えます。
[SEE_ALSO] File.join
link(old, new) -> 0
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] old:
- ファイル名を表す文字列を指定します。
- [PARAM] new:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] File.link
lstat(filename) -> File::Stat
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] File.lstat
makedirs(*dirs) -> Array
mkpath(*dirs) -> Array
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] dirs:
- 作成するディレクトリを指定します。
[SEE_ALSO] File.makedirs
max -> object
-
最大の要素を返します。 全要素が互いに <=> メソッドで比較できることを仮定しています。
要素が存在しなければ nil を返します。 該当する要素が複数存在する場合、どの要素を返すかは不定です。
max {|a, b| ... } -> object
-
ブロックの評価結果で各要素の大小判定を行い、最大の要素を返します。 要素が存在しなければ nil を返します。
ブロックの値は、a > b のとき正、 a == b のとき 0、a < b のとき負の整数を、期待しています。
該当する要素が複数存在する場合、どの要素を返すかは不定です。
- [EXCEPTION] TypeError:
- ブロックが整数以外を返したときに発生します。
max_by -> Enumerable::Enumerator
max_by {|item| ... } -> object
-
各要素を順番にブロックに渡して実行し、 その評価結果を <=> で比較して、 最大であった値に対応する元の要素を返します。
要素が存在しないときは nil を返します。 該当する要素が複数存在する場合、どの要素を返すかは不定です。
Enumerable#max と Enumerable#max_by の 違いは Enumerable#sort と Enumerable#sort_by の違いと同じです。
[SEE_ALSO] Enumerable#sort_by
min -> object
-
最小の要素を返します。 全要素が互いに <=> メソッドで比較できることを仮定しています。
要素が存在しなければ nil を返します。 該当する要素が複数存在する場合、どの要素を返すかは不定です。
min {|a, b| ... } -> object
-
ブロックの評価結果で各要素の大小判定を行い、最小の要素を返します。 要素が存在しなければ nil を返します。
ブロックの値は、a > b のとき正、a == b のとき 0、 a < b のとき負の整数を、期待しています。
該当する要素が複数存在する場合、どの要素を返すかは不定です。
- [EXCEPTION] TypeError:
- ブロックが整数以外を返したときに発生します。
min_by -> Enumerable::Enumerator
min_by {|item| ... } -> object
-
各要素を順番にブロックに渡して評価し、 その評価結果を <=> で比較して、 最小であった値に対応する元の要素を返します。
要素が存在しないときは nil を返します。
該当する要素が複数存在する場合、どの要素を返すかは不定です。
Enumerable#min と Enumerable#min_by の 違いは Enumerable#sort と Enumerable#sort_by の違いと同じです。
[SEE_ALSO] Enumerable#sort_by
minmax -> [object, object]
minmax {|a, b| ... } -> [object, object]
-
Enumerable オブジェクトの各要素のうち最小の要素と最大の要素を 要素とするサイズ 2 の配列を返します。
該当する要素が複数存在する場合、どの要素を返すかは不定です。
一つ目の形式は、Enumerable オブジェクトのすべての要素が Comparable を 実装していることを仮定しています。二つ目の形式では、要素同士の比較を ブロックを用いて行います。
a = %w(albatross dog horse) a.minmax #=> ["albatross", "horse"] a.minmax{|a,b| a.length <=> b.length } #=> ["dog", "albatross"] [].minmax # => [nil, nil]
[SEE_ALSO] Enumerable#sort
minmax_by -> Enumerable::Enumerator
minmax_by {|obj| ... } -> [object, object]
-
Enumerable オブジェクトの各要素をブロックに渡して評価し、その結果を <=> で比較して 最小の要素と最大の要素を要素とするサイズ 2 の配列を返します。
該当する要素が複数存在する場合、どの要素を返すかは不定です。
Enumerable#minmax と Enumerable#minmax_by の 違いは sort と sort_by の違いと同じです。 詳細は Enumerable#sort_by を参照してください。
a = %w(albatross dog horse) a.minmax_by {|x| x.length } #=> ["dog", "albatross"] [].minmax_by{} # => [nil, nil]
[SEE_ALSO] Enumerable#sort_by
mkdir(*path) -> Array
-
Dir.mkdirと同じです。 (複数可)
- [PARAM] path:
- 作成するディレクトリ名を文字列で指定します。
- [RETURN]
- 作成するディレクトリの一覧の配列を返します。
使用例
require 'shell' Shell.verbose = false sh = Shell.new begin p sh.mkdir("foo") #=> ["foo"] rescue => err puts err end
move(from, to) -> bool
mv(from, to) -> bool
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] from:
- ファイルの名前を文字列で与えます。
- [PARAM] to:
- 新しいファイル名を文字列で与えます。
[SEE_ALSO] File.move
mtime(filename) -> Time
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] File.mtime
none? -> bool
none? {|obj| ... } -> bool
-
ブロックを指定しない場合は、 Enumerable オブジェクトのすべての 要素が偽であれば真を返します。そうでなければ偽を返します。
ブロックを指定した場合は、Enumerable オブジェクトのすべての要素を ブロックで評価した結果が、すべて偽であれば真を返します。 そうでなければ偽を返します。
%w{ant bear cat}.none? {|word| word.length == 5} #=> true %w{ant bear cat}.none? {|word| word.length >= 4} #=> false [].none? #=> true [nil].none? #=> true [nil,false].none? #=> true
notify(*opts) { ... } -> ()
-
[TODO]
one? -> bool
one? {|obj| ... } -> bool
-
ブロックを指定しない場合は、 Enumerable オブジェクトの要素のうち ちょうど一つだけが真であれば、真を返します。 そうでなければ偽を返します。
ブロックを指定した場合は、Enumerable オブジェクトの要素を ブロックで評価した結果、一つの要素だけが真であれば真を返します。 そうでなければ偽を返します。
%w{ant bear cat}.one? {|word| word.length == 4} #=> true %w{ant bear cat}.one? {|word| word.length >= 4} #=> false [ nil, true, 99 ].one? #=> false [ nil, true, false ].one? #=> true
open(path, mode) -> File | Dir
-
path がファイルなら、 File.open path がディレクトリなら、 Dir.open の動作をします。
- [PARAM] path:
- 開きたいパスを指定します。
- [PARAM] mode:
- アクセスモードを指定します。path がディレクトリの場合は無視されます。
out(dev = STDOUT, &block) -> ()
-
Shell#transact を呼び出しその結果を dev に出力します。
- [PARAM] dev:
- 出力先をIO オブジェクトなどで指定します。
- [PARAM] block:
- transact 内部で実行するシェルを指定します。
使用例:
require 'shell' Shell.def_system_command("head") sh = Shell.new File.open("out.txt", "w"){ |fp| sh.out(fp) { system("ls", "-l") | head("-n 3") } }
owned?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] FileTest.#owned?
partition -> Enumerable::Enumerator
partition {|item| ... } -> [[object], [object]]
-
各要素を、ブロックの条件を満たす要素と満たさない要素に分割します。 各要素に対してブロックを評価して、その値が真であった要素の配列と、 偽であった要素の配列の 2 つを配列に入れて返します。
例:
[10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0].partition {|i| i % 3 == 0 } #=> [[9, 6, 3, 0], [10, 8, 7, 5, 4, 2, 1]]
pipe?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列か IO オブジェクトを指定します。
[SEE_ALSO] FileTest.#pipe?
readable?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#readable?
readable_real?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#readable_real?
readlink(path) -> String
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] path:
- シンボリックリンクを表す文字列を指定します。
[SEE_ALSO] File.readlink
rehash -> {}
-
登録されているシステムコマンドの情報をクリアします。 通常、使うことはありません。
reject -> Enumerable::Enumerator
reject {|item| ... } -> [object]
-
各要素に対してブロックを評価し、 その値が偽であった要素を集めた新しい配列を返します。 条件を反転させた select です。
例:
# 偶数を除外する (奇数を集める) [1, 2, 3, 4, 5, 6].reject {|i| i % 2 == 0 } # => [1, 3, 5]
[SEE_ALSO] Enumerable#select
rename(from, to) -> 0
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] from:
- ファイルの名前を文字列で与えます。
- [PARAM] to:
- 新しいファイル名を文字列で与えます。
[SEE_ALSO] File.rename
reverse_each -> Enumerable::Enumerator
reverse_each {|element| ... } -> self
-
逆順に各要素に対してブロックを評価します。
内部で各要素を保持した配列を作ります。
safe_unlink(*filenames) -> Array
rm_f(*filenames) -> Array
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filenames:
- 削除するファイルを指定します。
[SEE_ALSO] File.safe_unlink
rmdir(*path) -> ()
-
Dir.rmdirと同じです。 (複数可)
- [PARAM] path:
- 削除するディレクトリ名を文字列で指定します。
setgid?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#setgid?
setuid?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#setuid?
size(file) -> Integer
size?(file) -> Integer | nil
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#size FileTest.#size?
socket?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#socket?
sort -> [object]
sort {|a, b| ... } -> [object]
-
全ての要素を昇順にソートした配列を生成して返します。
ブロックなしのときは <=> メソッドを要素に対して呼び、 その結果をもとにソートします。
<=> 以外でソートしたい場合は、ブロックを指定します。 この場合、ブロックの評価結果を元にソートします。 ブロックの値は、a > b のとき正、a == b のとき 0、 a < b のとき負の整数を、期待しています。 ブロックが整数以外を返したときは例外 TypeError が発生します。
Enumerable#sort は安定ではありません (unstable sort)。 安定なソートが必要な場合は Enumerable#sort_by を使って工夫する必要があります。 詳しくは Enumerable#sort_by の項目を参照してください。
※ 比較結果が同じ要素は元の順序通りに並ぶソートを 「安定なソート (stable sort)」と言います。
[SEE_ALSO] Enumerable#sort_by
sort_by -> Enumerable::Enumerator
sort_by {|item| ... } -> [object]
-
ブロックの評価結果を <=> メソッドで比較することで、self を昇 順にソートします。ソートされた配列を新たに生成して返します。
つまり、以下とほぼ同じ動作をします。
class Array def sort_by self.map {|i| [yield(i), i] }. sort {|a, b| a[0] <=> b[0] }. map {|i| i[1]} end end
Enumerable#sort と比較して sort_by が優れている点として、 比較条件が複雑な場合の速度が挙げられます。 sort_by を使わない以下の例では比較を行う度に downcase が実行されます。 従って downcase の実行速度が遅ければ sort の速度が致命的に低下します。
p ["BAR", "FOO", "bar", "foo"].sort {|a, b| a.downcase <=> b.downcase }
一方、次のように sort_by を使うと downcase の実行回数は要素数と同じです。 つまり、その部分の実行時間は O(n) のオーダーです。
p ["BAR", "FOO", "bar", "foo"].sort_by {|v| v.downcase }
以下の、実行回数の検証結果を参照してみてください。
class Integer def count $n += 1 self end end ary = [] 1.upto(1000) {|v| ary << rand(v) } $n = 0 ary.sort {|a,b| a.count <=> b.count } p $n # => 18200 $n = 0 ary.sort_by {|v| v.count } p $n # => 1000
Enumerable#sort_by は安定ではありません (unstable sort)。 ただし、sort_by を以下のように使うと安定なソートを実装できます。
i = 0 ary.sort_by {|v| [v, i += 1] }
※ 比較結果が同じ要素は元の順序通りに並ぶソートを 「安定なソート (stable sort)」と言います。
[SEE_ALSO] Enumerable#sort
split(pathname) -> [String]
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] pathname:
- パス名を表す文字列を指定します。
[SEE_ALSO] File.split
stat(filename) -> File::Stat
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] File.stat
sticky?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#sticky?
symlink(old, new) -> 0
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] old:
- ファイル名を表す文字列を指定します。
- [PARAM] new:
- シンボリックリンクを表す文字列を指定します。
[SEE_ALSO] File.symlink
symlink?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#symlink?
syscopy(from, to) -> bool
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] from:
- ファイルの名前を文字列で与えます。
- [PARAM] to:
- 新しいファイル名を文字列で与えます。
[SEE_ALSO] File.syscopy
system(command, *opts) -> Shell::SystemCommand
-
command を実行する.
- [PARAM] command:
- 実行するコマンドのパスを文字列で指定します。
- [PARAM] opts:
- command のオプションを文字列で指定します。複数可。
使用例:
require 'shell' Shell.verbose = false sh = Shell.new print sh.system("ls", "-l") Shell.def_system_command("head") sh.system("ls", "-l") | sh.head("-n 3") > STDOUT
take(n) -> Array
-
Enumerable オブジェクトの先頭から n 要素を配列として返します。
- [PARAM] n:
- 要素数を指定します。
a = [1, 2, 3, 4, 5, 0] a.take(3) # => [1, 2, 3]
take_while -> Enumerable::Enumerator
take_while {|element| ... } -> Array
-
Enumerable オブジェクトの要素を順に偽になるまでブロックで評価します。 最初に偽になった要素の手前の要素までを配列として返します。
a = [1, 2, 3, 4, 5, 0] a.take_while {|i| i < 3 } # => [1, 2]
tee(file) -> Shell::Filter
-
実行すると, それらを内容とする Filter オブジェクトを返します.
- [PARAM] file:
- シェルコマンドtee に与えるファイル名を文字列で指定します。
動作例
require 'shell' Shell.def_system_command("head") sh = Shell.new sh.transact { glob("*.txt").to_a.each { |file| file.chomp! cat(file).each { |l| echo(l) | tee(file + ".tee") >> "all.tee" } } }
to_a -> [String]
-
実行結果を文字列の配列で返します。
Shell.def_system_command("wc") sh = Shell.new puts sh.cat("/etc/passwd").to_a
to_s -> String
-
実行結果を文字列で返します。
Shell.def_system_command("wc") sh = Shell.new sh.transact { puts (cat("/etc/passwd") | wc("-l")).to_s }
transact { ... } -> object
-
ブロック中で shell を self として実行します。
例:
require 'shell' Shell.def_system_command("head") sh = Shell.new sh.transact{ system("ls", "-l") | head > STDOUT # transact の中では、 # sh.system("ls", "-l") | sh.head > STDOUT と同じとなる。 }
truncate(path, length) -> 0
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] path:
- パスを表す文字列を指定します。
- [PARAM] length:
- 変更したいサイズを整数で与えます。
[SEE_ALSO] File.truncate
unlink(path) -> self
-
path がファイルなら File.unlink、path がディレクトリなら Dir.unlink の動作をします。
- [PARAM] path:
- 削除したいパスを指定します。
[SEE_ALSO] File.unlink, Dir.unlink
utime(atime, mtime, *filename) -> Integer
-
File クラスにある同名のクラスメソッドと同じです.
- [PARAM] filename:
- ファイル名を表す文字列を指定します。
- [PARAM] atime:
- 最終アクセス時刻を Time か、起算時からの経過秒数を数値で指定します。
- [PARAM] utime:
- 更新時刻を Time か、起算時からの経過秒数を数値で指定します。
[SEE_ALSO] File.utime
wait? -> false
-
[TODO]
writable?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#writable?
writable_real?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#writable_real?
zero?(file) -> bool
-
FileTest モジュールにある同名のクラスメソッドと同じです.
- [PARAM] file:
- ファイル名を表す文字列を指定します。
[SEE_ALSO] FileTest.#zero?
zip(*lists) -> [[object]]
zip(*lists) {|v1, v2, ...| ...} -> nil
-
self と引数に渡した配列の各要素からなる配列の配列を生成して返します。 生成される配列の要素数は self の要素数と同じです。
ブロック付きで呼び出した場合は、 self と引数に渡した配列の各要素を順番にブロックに渡します。
- [PARAM] lists:
- 配列を指定します。配列でない場合は to_a メソッドにより配列に変換します。
例:
p (1..3).zip([4,5,6], [7,8,9]) # => [[1, 4, 7], [2, 5, 8], [3, 6, 9]] p (1..2).zip([:a,:b,:c], [:A,:B,:C,:D]) # => [[1, :a, :A], [2, :b, :B]] p (1..5).zip([:a,:b,:c], [:A,:B,:C,:D]) # => [[1, :a, :A], [2, :b, :B], # [3, :c, :C], [4, nil, :D], [5, nil, nil]]
例:
p [1,2,3].zip([4,5,6], [7,8,9]) {|ary| p ary } # => [1, 4, 7] # [2, 5, 8] # [3, 6, 9] # nil
self | filter -> object
-
パイプ結合を filter に対して行います。
- [PARAM] filter:
- Shell::Filter オブジェクトを指定します。
- [RETURN]
- filter を返します。
使用例
Shell.def_system_command("tail") Shell.def_system_command("head") Shell.def_system_command("wc") sh = Shell.new sh.transact { i = 1 while i <= (cat("/etc/passwd") | wc("-l")).to_s.chomp.to_i puts (cat("/etc/passwd") | head("-n #{i}") | tail("-n 1")).to_s i += 1 end }