Ruby Pathname類用法及代碼示例

Pathname 代表文件係統上文件或目錄的名稱，但不代表文件本身。

路徑名取決於操作係統：Unix、Windows 等。該庫適用於本地操作係統的路徑名，但實驗性支持非 Unix 路徑名。

Pathname 可以是相對的或絕對的。直到您嘗試引用該文件時，該文件是否存在才重要。

Pathname 是不可變的。它沒有破壞性更新的方法。

此類的目標是以比標準 Ruby 提供的更簡潔的方式操作文件路徑信息。下麵的示例演示了差異。

File 、 FileTest 的所有函數以及 Dir 和 FileUtils 的一些函數都包含在內，這並不奇怪。它本質上是所有這些的門麵，甚至更多。

例子

示例 1：使用 Pathname

require 'pathname'
pn = Pathname.new("/usr/bin/ruby")
size = pn.size              # 27662
isdir = pn.directory?       # false
dir  = pn.dirname           # Pathname:/usr/bin
base = pn.basename          # Pathname:ruby
dir, base = pn.split        # [Pathname:/usr/bin, Pathname:ruby]
data = pn.read
pn.open { |f| _ }
pn.each_line { |line| _ }

示例 2：使用標準 Ruby

pn = "/usr/bin/ruby"
size = File.size(pn)        # 27662
isdir = File.directory?(pn) # false
dir  = File.dirname(pn)     # "/usr/bin"
base = File.basename(pn)    # "ruby"
dir, base = File.split(pn)  # ["/usr/bin", "ruby"]
data = File.read(pn)
File.open(pn) { |f| _ }
File.foreach(pn) { |line| _ }

示例 3：特殊函數

p1 = Pathname.new("/usr/lib")   # Pathname:/usr/lib
p2 = p1 + "ruby/1.8"            # Pathname:/usr/lib/ruby/1.8
p3 = p1.parent                  # Pathname:/usr
p4 = p2.relative_path_from(p3)  # Pathname:lib/ruby/1.8
pwd = Pathname.pwd              # Pathname:/home/gavin
pwd.absolute?                   # true
p5 = Pathname.new "."           # Pathname:.
p5 = p5 + "music/../articles"   # Pathname:music/../articles
p5.cleanpath                    # Pathname:articles
p5.realpath                     # Pathname:/home/gavin/articles
p5.children                     # [Pathname:/home/gavin/articles/linux, ...]

函數分解

核心方法

這些方法有效地操縱了 String ，因為這就是路徑。除了 mountpoint? 、 children 、 each_child 、 realdirpath 和 realpath 之外，這些都不能訪問文件係統。

• +

• Pathname.join

• parent

• root?

• Pathname.absolute?

• Pathname.relative?

• relative_path_from

• Pathname.each_filename

• cleanpath

• realpath

• realdirpath

• Pathname.children

• Pathname.each_child

• mountpoint?

File 狀態謂詞方法

這些方法是 FileTest 的外觀：

• blockdev?

• chardev?

• directory?

• executable?

• executable_real?

• exist?

• file?

• grpowned?

• owned?

• pipe?

• readable?

• world_readable?

• readable_real?

• setgid?

• setuid?

• size

• size?

• socket?

• sticky?

• symlink?

• writable?

• world_writable?

• writable_real?

• zero?

File 屬性和操作方法

這些方法是 File 的外觀：

• atime

• birthtime

• ctime

• mtime

• chmod(mode)

• lchmod(mode)

• chown(owner, group)

• lchown(owner, group)

• fnmatch (模式，*args)

• fnmatch? (模式，*args)

• ftype

• make_link(old)

• open (*args, █)

• readlink

• rename(to)

• stat

• lstat

• make_symlink(old)

• truncate(length)

• utime(atime, mtime)

• basename(*args)

• dirname

• extname

• expand_path(*args)

• split

目錄方法

這些方法是 Dir 的外觀：

• Pathname.glob

• Pathname.getwd / Pathname.pwd

• rmdir

• Pathname.entries

• each_entry (&塊)

• mkdir(*args)

• opendir(*args)

IO

這些方法是 IO 的門麵：

• each_line (*args, █)

• read(*args)

• binread(*args)

• readlines(*args)

• sysopen(*args)

• write(*args)

• binwrite(*args)

實用程序

這些方法是 Find 、 FileUtils 和其他方法的混合：

• find (&塊)

• mkpath

• rmtree

• unlink / delete

Method 文檔

如上節所示， Pathname 中的大多數方法都是門麵。這些方法的文檔通常隻是說，例如，“請參閱 FileTest.writable? ”，因為無論如何您都應該熟悉原始方法，並且其文檔(例如通過 ri )將包含更多信息。在某些情況下，將進行簡要說明。