Ruby 2.1.0 リファレンスマニュアル > ライブラリ一覧 > psychライブラリ > Psychモジュール

module Psych

クラスの継承リスト: Psych

要約

yaml のバックエンドのためのモジュールです。

特異メソッド

dump(o, options = {}) -> String

dump(o, io, options = {}) -> ()

Ruby のオブジェクト o を YAML ドキュメントに変換します。

io に IO オブジェクトを指定した場合は、変換されたドキュメントがその IO に書き込まれます。指定しなかった場合は変換されたドキュメントが文字列としてメソッドの返り値となります。

options で出力に関するオプションを以下の指定できます。

:version: YAML document に付加するバージョンを [major, minor] という配列、もしくは文字列で指定します
:header: 出力にヘッダを付けるかどうかを真偽値で指定します
:indentation: インデントのレベルを 1 から 9 までの整数で指定します
:canonical: 出力の style が canonical であるかどうかを真偽値で指定します
:line_width: 「好ましい」行幅を整数値で指定します

[PARAM] o:: 変換するオブジェクト
[PARAM] io:: 出力先
[PARAM] options:: 出力オプション

例

# Dump an array, get back a YAML string
Psych.dump(['a', 'b'])  # => "---\n- a\n- b\n"

# Dump an array to an IO object
Psych.dump(['a', 'b'], StringIO.new)  # => #<StringIO:0x000001009d0890>

# Dump an array with indentation set
Psych.dump(['a', ['b']], :indentation => 3) # => "---\n- a\n-  - b\n"

# Dump an array to an IO with indentation set
Psych.dump(['a', ['b']], StringIO.new, :indentation => 3)

dump_stream(*objects) -> String

オブジェクト列を YAML ドキュメント列に変換します。

[PARAM] objects:: 変換対象のオブジェクト列

例

Psych.dump_stream("foo\n  ", {}) # => "--- ! \"foo\\n  \"\n--- {}\n"

libyaml_version -> [Integer, Integer, Integer]

libyaml のバージョンを返します。

[major, minor patch-level] という 3 つの整数からなる配列を返します。

[SEE_ALSO] Psych::LIBYAML_VERSION

load(yaml, filename = nil) -> object

YAML ドキュメントを Ruby のデータ構造(オブジェクト)に変換します。

入力に複数のドキュメントが含まれている場合は、先頭のものを変換して返します。

filename はパース中に発生した例外のメッセージに用います。

[PARAM] yaml:: YAML ドキュメント(文字列 or IO オブジェクト)
[PARAM] filename:: 例外メッセージのためのファイル名
[EXCEPTION] Psych::SyntaxError:: YAMLドキュメントに文法エラーが発見されたときに発生します

[SEE_ALSO] Psych.parse

例

Psych.load("--- a")           # => 'a'
Psych.load("---\n - a\n - b") # => ['a', 'b']

begin
  Psych.load("--- `", "file.txt")
rescue Psych::SyntaxError => ex
  p ex.file    # => 'file.txt'
  p ex.message # => "(file.txt): found character that cannot start any token while scanning for the next token at line 1 column 5"
end

load_documents(yaml) -> [object]

load_documents(yaml) {|obj| ... } -> ()

複数の YAML ドキュメントを含むデータを Ruby のオブジェクトに変換します。このメソッドは deprecated です。Psych.load_stream を代わりに使ってください。

[PARAM] yaml:: YAML ドキュメント(文字列 or IO オブジェクト)
[EXCEPTION] Psych::SyntaxError:: YAMLドキュメントに文法エラーが発見されたときに発生します

load_file(filename) -> object

filename で指定したファイルを YAML ドキュメントとして Ruby のオブジェクトに変換します。

[PARAM] filename:: ファイル名
[EXCEPTION] Psych::SyntaxError:: YAMLドキュメントに文法エラーが発見されたときに発生します

load_stream(yaml, filename=nil) -> [object]

load_stream(yaml, filename=nil) {|obj| ... } -> ()

複数の YAML ドキュメントを含むデータを Ruby のオブジェクトに変換します。

ブロックなしの場合はオブジェクトの配列を返します。

Psych.load_stream("--- foo\n...\n--- bar\n...") # => ['foo', 'bar']

ブロックありの場合は各オブジェクト引数としてそのブロックを呼び出します。

list = []
Psych.load_stream("--- foo\n...\n--- bar\n...") do |ruby|
  list << ruby
end
list # => ['foo', 'bar']

filename はパース中に発生した例外のメッセージに用います。

[PARAM] yaml:: YAML ドキュメント(文字列 or IO オブジェクト)
[PARAM] filename:: 例外メッセージのためのファイル名
[EXCEPTION] Psych::SyntaxError:: YAMLドキュメントに文法エラーが発見されたときに発生します

parse(yaml, filename = nil) -> Psych::Nodes::Document

YAML ドキュメントをパースし、YAML の AST を返します。

入力に複数のドキュメントが含まれている場合は、先頭のものを AST に変換して返します。

filename はパース中に発生した例外のメッセージに用います。

AST については Psych::Nodes を参照してください。

[PARAM] yaml:: YAML ドキュメント(文字列 or IO オブジェクト)
[PARAM] filename:: 例外メッセージのためのファイル名
[EXCEPTION] Psych::SyntaxError:: YAMLドキュメントに文法エラーが発見されたときに発生します

[SEE_ALSO] Psych.load

例

Psych.parse("---\n - a\n - b") # => #<Psych::Nodes::Document:...>

begin
  Psych.parse("--- `", "file.txt")
rescue Psych::SyntaxError => ex
  p ex.file    # => 'file.txt'
  p ex.message # => "(file.txt): found character that cannot start any token while scanning for the next token at line 1 column 5"
end

parse_file(filename) -> Psych::Nodes::Document

filename で指定したファイルをパースして YAML の AST を返します。

[PARAM] filename:: パースするファイルの名前
[EXCEPTION] Psych::SyntaxError:: YAMLドキュメントに文法エラーが発見されたときに発生します

parse_stream(yaml) -> Psych::Nodes::Stream

parse_stream(yaml) {|node| ... } -> ()

YAML ドキュメントをパースします。 yaml が複数の YAML ドキュメントを含む場合を取り扱うことができます。

ブロックなしの場合は YAML の AST (すべての YAML ドキュメントを保持した Psych::Nodes::Stream オブジェクト)を返します。

ブロック付きの場合は、そのブロックに最初の YAML ドキュメントの Psych::Nodes::Document オブジェクトが渡されます。この場合の返り値には意味がありません。

[SEE_ALSO] Psych::Nodes

例

Psych.parse_stream("---\n - a\n - b") # => #<Psych::Nodes::Stream:0x00>

parser -> Psych::Parser

デフォルトで使われるのパーサを返します。

to_json(o) -> String

Ruby のオブジェクト o を JSON の文字列に変換します。

[PARAM] o:: 変換対象となるオブジェクト

定数

LIBYAML_VERSION -> String: libyaml のバージョン。
VERSION -> String: Psych のバージョン。

module Psych

module Psych

要約

目次

特異メソッド

例

例

例

例

例

定数