模块 Find

Find 模块支持对一组文件路径进行自顶向下的遍历。

例如，要统计你主目录下所有文件的大小总和，并忽略“dot”目录（例如 $HOME/.ssh）中的任何内容：

require 'find'

total_size = 0

Find.find(ENV["HOME"]) do |path|
  if FileTest.directory?(path)
    if File.basename(path).start_with?('.')
      Find.prune       # Don't look any further into this directory.
    else
      next
    end
  else
    total_size += FileTest.size(path)
  end
end

常量

VERSION

公共类方法

find(*paths, ignore_error: true) { |path| ... } 点击切换源代码

使用作为参数列出的每个文件和目录的名称调用关联的块，然后在它们的子目录中递归调用，依此类推。

如果没有给出块，则返回一个枚举器。

有关示例，请参见 Find 模块文档。

# File find.rb, line 40
def find(*paths, ignore_error: true) # :yield: path
  block_given? or return enum_for(__method__, *paths, ignore_error: ignore_error)

  fs_encoding = Encoding.find("filesystem")

  paths.collect!{|d| raise Errno::ENOENT, d unless File.exist?(d); d.dup}.each do |path|
    path = path.to_path if path.respond_to? :to_path
    enc = path.encoding == Encoding::US_ASCII ? fs_encoding : path.encoding
    ps = [path]
    while file = ps.shift
      catch(:prune) do
        yield file.dup
        begin
          s = File.lstat(file)
        rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR, Errno::ELOOP, Errno::ENAMETOOLONG, Errno::EINVAL
          raise unless ignore_error
          next
        end
        if s.directory? then
          begin
            fs = Dir.children(file, encoding: enc)
          rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR, Errno::ELOOP, Errno::ENAMETOOLONG, Errno::EINVAL
            raise unless ignore_error
            next
          end
          fs.sort!
          fs.reverse_each {|f|
            f = File.join(file, f)
            ps.unshift f
          }
        end
      end
    end
  end
  nil
end

prune() 点击切换源代码

跳过当前文件或目录，使用下一个条目重新开始循环。如果当前文件是目录，则不会递归进入该目录。仅在与 Find::find 关联的块内有意义。

有关示例，请参见 Find 模块文档。

# File find.rb, line 85
def prune
  throw :prune
end

私有实例方法

find(*paths, ignore_error: true) { |path| ... } 点击切换源代码

使用作为参数列出的每个文件和目录的名称调用关联的块，然后在它们的子目录中递归调用，依此类推。

如果没有给出块，则返回一个枚举器。

有关示例，请参见 Find 模块文档。

# File find.rb, line 40
def find(*paths, ignore_error: true) # :yield: path
  block_given? or return enum_for(__method__, *paths, ignore_error: ignore_error)

  fs_encoding = Encoding.find("filesystem")

  paths.collect!{|d| raise Errno::ENOENT, d unless File.exist?(d); d.dup}.each do |path|
    path = path.to_path if path.respond_to? :to_path
    enc = path.encoding == Encoding::US_ASCII ? fs_encoding : path.encoding
    ps = [path]
    while file = ps.shift
      catch(:prune) do
        yield file.dup
        begin
          s = File.lstat(file)
        rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR, Errno::ELOOP, Errno::ENAMETOOLONG, Errno::EINVAL
          raise unless ignore_error
          next
        end
        if s.directory? then
          begin
            fs = Dir.children(file, encoding: enc)
          rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR, Errno::ELOOP, Errno::ENAMETOOLONG, Errno::EINVAL
            raise unless ignore_error
            next
          end
          fs.sort!
          fs.reverse_each {|f|
            f = File.join(file, f)
            ps.unshift f
          }
        end
      end
    end
  end
  nil
end

prune() 点击切换源代码

跳过当前文件或目录，使用下一个条目重新开始循环。如果当前文件是目录，则不会递归进入该目录。仅在与 Find::find 关联的块内有意义。

有关示例，请参见 Find 模块文档。

# File find.rb, line 85
def prune
  throw :prune
end