検索結果

Logger#log(severity, message = nil, progname = nil) -> true (54325.0)

• 2.4.0

• インスタンスメソッド

メッセージをログに記録します。

メッセージをログに記録します。

ブロックを与えた場合はブロックを評価した返り値をメッセージとしてログに記録します。
ユーザがこのメソッドを直接使うことはあまりありません。

@param severity ログレベル。Logger クラスで定義されている定数を指定します。
この値がレシーバーに設定されているレベルよりも低い場合、
メッセージは記録されません。

@param message ログに出力するメッセージを文字列か例外オブジェクトを指定します。
省略すると nil が用いられます。

@...

• Logger

Logger#log(severity, message = nil, progname = nil) { ... } -> true (54325.0)

• 2.4.0

• インスタンスメソッド

メッセージをログに記録します。

メッセージをログに記録します。

ブロックを与えた場合はブロックを評価した返り値をメッセージとしてログに記録します。
ユーザがこのメソッドを直接使うことはあまりありません。

@param severity ログレベル。Logger クラスで定義されている定数を指定します。
この値がレシーバーに設定されているレベルよりも低い場合、
メッセージは記録されません。

@param message ログに出力するメッセージを文字列か例外オブジェクトを指定します。
省略すると nil が用いられます。

@...

• Logger

logger (18217.0)

• 2.4.0

• ライブラリ

ログを記録するためのライブラリです。

ログを記録するためのライブラリです。

=== 説明

6段階のログレベルに分けてログを記録します。

: UNKNOWN
常に記録されるべき不明なエラー
: FATAL
プログラムをクラッシュさせるような制御不可能なエラー
: ERROR
制御可能なエラー
: WARN
警告
: INFO
一般的な情報
: DEBUG
低レベルの情報

全てのメッセージは必ずログレベルを持ちます。また Logger オブジェクトも同じように
ログレベルを持ちます。メッセージのログレベルが Logger オブジェクトのログレベルよりも
低い場合メッセージは記録されません。

普段は I...

• Logger
• Logger::Error
• Logger::Formatter
• Logger::LogDevice
• Logger::Severity
• Logger::ShiftingError

Logger.new(logdev, shift_age = 0, shift_size = 1048576, level: Logger::Severity::DEBUG, progname: nil, formatter: Formatter.new, datetime_format: nil, shift_period_suffix: '%Y%m%d') -> Logger (9973.0)

• 2.4.0

• 特異メソッド

Logger オブジェクトを生成します。

Logger オブジェクトを生成します。

@param logdev ログを書き込むファイル名か、 IO オブジェクト(STDOUT, STDERR など)を指定します。

@param shift_age ログファイルを保持する数か、ログファイルを切り替える頻度を指定します。
頻度には daily, weekly, monthly を文字列で指定することができます。
省略すると、ログの保存先を切り替えません。

@param shift_size shift_age を整数で指定した場合のみ有効です。
...

• Logger

Logger#close -> nil (9037.0)

• 2.4.0

• インスタンスメソッド

ログ出力に使用していた IO オブジェクトを閉じます。

ログ出力に使用していた IO オブジェクトを閉じます。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)

logger.info("test") # => I, [2019-04-16T00:40:11.837898 #2795] INFO -- : test
logger.close
logger.info("test") # => log writing failed. closed stream
//}

• Logger

絞り込み条件を変える

Logger#debug? -> bool (9037.0)

• 2.4.0

• インスタンスメソッド

現在の Logger オブジェクトが DEBUG 以上のログレベルのメッセージを記録するなら 真を返します。

現在の Logger オブジェクトが DEBUG 以上のログレベルのメッセージを記録するなら
真を返します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT, level: Logger::Severity::DEBUG)
logger.debug? # => true
logger = Logger.new(STDOUT, level: Logger::Severity::INFO)
logger.debug? # => false
//}

• Logger

Logger#add(severity, message = nil, progname = nil) -> true (9025.0)

• 2.4.0

• インスタンスメソッド

メッセージをログに記録します。

メッセージをログに記録します。

ブロックを与えた場合はブロックを評価した返り値をメッセージとしてログに記録します。
ユーザがこのメソッドを直接使うことはあまりありません。

@param severity ログレベル。Logger クラスで定義されている定数を指定します。
この値がレシーバーに設定されているレベルよりも低い場合、
メッセージは記録されません。

@param message ログに出力するメッセージを文字列か例外オブジェクトを指定します。
省略すると nil が用いられます。

@...

• Logger

Logger#add(severity, message = nil, progname = nil) { ... } -> true (9025.0)

• 2.4.0

• インスタンスメソッド

メッセージをログに記録します。

メッセージをログに記録します。

ブロックを与えた場合はブロックを評価した返り値をメッセージとしてログに記録します。
ユーザがこのメソッドを直接使うことはあまりありません。

@param severity ログレベル。Logger クラスで定義されている定数を指定します。
この値がレシーバーに設定されているレベルよりも低い場合、
メッセージは記録されません。

@param message ログに出力するメッセージを文字列か例外オブジェクトを指定します。
省略すると nil が用いられます。

@...

• Logger

Logger#<<(msg) -> Integer | nil (9019.0)

• 2.4.0

• インスタンスメソッド

ログを出力します。

ログを出力します。

@param msg ログに出力するメッセージ。

//emlist[例][ruby]{
require 'logger'
logger = Logger.new(STDOUT)

logger << "add message"

# => add message
//}

• Logger

Logger#datetime_format -> String | nil (9019.0)

• 2.4.0

• インスタンスメソッド

ログに記録する時の日付のフォーマットです。

ログに記録する時の日付のフォーマットです。

デフォルトでは nil ですが、この値が nil の場合は日付のフォーマットとして
"%Y-%m-%dT%H:%M:%S.%06d " を使用します。

なお、"%06d" には Time#strftime ではなく、単に Time#usec の
値を String#% でフォーマットしたものが入ります。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)

logger.datetime_format # => nil
logger.debug("test")
lo...

• Logger

絞り込み条件を変える

Logger#datetime_format=(format) (9019.0)

• 2.4.0

• インスタンスメソッド

ログに記録する時の日付のフォーマットをセットします。

ログに記録する時の日付のフォーマットをセットします。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)

logger.datetime_format # => nil
logger.debug("test")
logger.datetime_format = '%Y/%m/%dT%H:%M:%S.%06d' # => "%Y/%m/%dT%H:%M:%S.%06d"
logger.datetime_format # => "%Y/%m/%dT%H:%M:%S.%06d"
logger.debug("test"...

• Logger

Logger#error(progname = nil) -> true (9019.0)

• 2.4.0

• インスタンスメソッド

ERROR 情報を出力します。

ERROR 情報を出力します。

ブロックを与えなかった場合は、progname をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして
ログを出力します。

引数とブロックを同時に与えた場合は、progname をプログラム名、ブロックを評価した
結果をメッセージとしてログを出力します。

@param progname ブロックを与えない場合は、メッセージとして文字列または例外オブジェクトを指定します。
ブロックを与えた場合は、プログラム名を文字列として与えます。

//emlist[例][ruby]{
r...

• Logger

Logger#error(progname = nil) { ... } -> true (9019.0)

• 2.4.0

• インスタンスメソッド

ERROR 情報を出力します。

ERROR 情報を出力します。

ブロックを与えなかった場合は、progname をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして
ログを出力します。

引数とブロックを同時に与えた場合は、progname をプログラム名、ブロックを評価した
結果をメッセージとしてログを出力します。

@param progname ブロックを与えない場合は、メッセージとして文字列または例外オブジェクトを指定します。
ブロックを与えた場合は、プログラム名を文字列として与えます。

//emlist[例][ruby]{
r...

• Logger

Logger#error? -> bool (9019.0)

• 2.4.0

• インスタンスメソッド

現在の Logger オブジェクトが ERROR 以上のログレベルのメッセージを記録するなら 真を返します。

現在の Logger オブジェクトが ERROR 以上のログレベルのメッセージを記録するなら
真を返します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)
logger.error? # => true
logger.level = Logger::Severity::FATAL
logger.error? # => false
//}

• Logger

Logger#fatal(progname = nil) -> true (9019.0)

• 2.4.0

• インスタンスメソッド

FATAL 情報を出力します。

FATAL 情報を出力します。

ブロックを与えなかった場合は、progname をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして
ログを出力します。

引数とブロックを同時に与えた場合は、progname をプログラム名、ブロックを評価した
結果をメッセージとしてログを出力します。

@param progname ブロックを与えない場合は、メッセージとして文字列または例外オブジェクトを指定します。
ブロックを与えた場合は、プログラム名を文字列として与えます。

//emlist[例][ruby]{
r...

• Logger

絞り込み条件を変える

Logger#fatal(progname = nil) { ... } -> true (9019.0)

• 2.4.0

• インスタンスメソッド

FATAL 情報を出力します。

FATAL 情報を出力します。

ブロックを与えなかった場合は、progname をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして
ログを出力します。

引数とブロックを同時に与えた場合は、progname をプログラム名、ブロックを評価した
結果をメッセージとしてログを出力します。

@param progname ブロックを与えない場合は、メッセージとして文字列または例外オブジェクトを指定します。
ブロックを与えた場合は、プログラム名を文字列として与えます。

//emlist[例][ruby]{
r...

• Logger

Logger#fatal? -> bool (9019.0)

• 2.4.0

• インスタンスメソッド

現在の Logger オブジェクトが FATAL 以上のログレベルのメッセージを記録するなら 真を返します。

現在の Logger オブジェクトが FATAL 以上のログレベルのメッセージを記録するなら
真を返します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT, level: Logger::Severity::FATAL)
logger.fatal? # => true
logger.level = 5
logger.fatal? # => false
//}

• Logger

Logger#formatter -> String (9019.0)

• 2.4.0

• インスタンスメソッド

ログを出力する際に使用するフォーマッターを取得します。

ログを出力する際に使用するフォーマッターを取得します。

このメソッドの返り値が持つ call メソッドは 4 つの引数 (severity, time, program name, message) を受けとります。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)
logger.formatter # => nil
logger.info("test")
# => I, [2019-05-09T22:13:56.509159 #13912] INFO -- : test

ltsv_formatter =...

• Logger

Logger#info(progname = nil) -> true (9019.0)

• 2.4.0

• インスタンスメソッド

INFO 情報を出力します。

INFO 情報を出力します。

ブロックを与えなかった場合は、progname をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして
ログを出力します。

引数とブロックを同時に与えた場合は、progname をプログラム名、ブロックを評価した
結果をメッセージとしてログを出力します。

@param progname ブロックを与えない場合は、メッセージとして文字列または例外オブジェクトを指定します。
ブロックを与えた場合は、プログラム名を文字列として与えます。

//emlist[例][ruby]{
re...

• Logger

Logger#info(progname = nil) { ... } -> true (9019.0)

• 2.4.0

• インスタンスメソッド

INFO 情報を出力します。

INFO 情報を出力します。

ブロックを与えなかった場合は、progname をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして
ログを出力します。

引数とブロックを同時に与えた場合は、progname をプログラム名、ブロックを評価した
結果をメッセージとしてログを出力します。

@param progname ブロックを与えない場合は、メッセージとして文字列または例外オブジェクトを指定します。
ブロックを与えた場合は、プログラム名を文字列として与えます。

//emlist[例][ruby]{
re...

• Logger

絞り込み条件を変える

Logger#info? -> bool (9019.0)

• 2.4.0

• インスタンスメソッド

現在の Logger オブジェクトが INFO 以上のログレベルのメッセージを記録するなら 真を返します。

現在の Logger オブジェクトが INFO 以上のログレベルのメッセージを記録するなら
真を返します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)
logger.info? # => true
logger.level = Logger::Severity::ERROR
logger.info? # => false
//}

• Logger

Logger#level -> Integer (9019.0)

• 2.4.0

• インスタンスメソッド

レシーバにセットされているログレベルを取得します。

レシーバにセットされているログレベルを取得します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)
logger.level # => 0
logger.level = Logger::Severity::ERROR
logger.level # => 3
//}

• Logger

Logger#level=(level) (9019.0)

• 2.4.0

• インスタンスメソッド

Logger オブジェクトのログレベルを設定します。ログレベルがこれより低いメッセージは 出力されません。

Logger オブジェクトのログレベルを設定します。ログレベルがこれより低いメッセージは
出力されません。

@param level ログレベルを指定します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)
logger.level # => 0
logger.level = Logger::Severity::ERROR # => 3
logger.level # => 3
//}

• Logger

Logger#progname -> String (9019.0)

• 2.4.0

• インスタンスメソッド

ログに出力するプログラム名を取得します。

ログに出力するプログラム名を取得します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)
logger.progname # => nil
logger.progname = "MyProgName"
logger.progname # => "MyProgName"
//}

• Logger

Logger#progname=(name) (9019.0)

• 2.4.0

• インスタンスメソッド

ログに出力するプログラム名を設定します。

ログに出力するプログラム名を設定します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)
logger.progname # => nil
logger.progname = "MyProgName" # => "MyProgName"
logger.progname # => "MyProgName"
logger.info("info1") # =...

• Logger

絞り込み条件を変える

Logger#sev_threshold -> Integer (9019.0)

• 2.4.0

• インスタンスメソッド

レシーバにセットされているログレベルを取得します。

レシーバにセットされているログレベルを取得します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)
logger.level # => 0
logger.level = Logger::Severity::ERROR
logger.level # => 3
//}

• Logger

Logger#sev_threshold=(level) (9019.0)

• 2.4.0

• インスタンスメソッド

Logger オブジェクトのログレベルを設定します。ログレベルがこれより低いメッセージは 出力されません。

Logger オブジェクトのログレベルを設定します。ログレベルがこれより低いメッセージは
出力されません。

@param level ログレベルを指定します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)
logger.level # => 0
logger.level = Logger::Severity::ERROR # => 3
logger.level # => 3
//}

• Logger

Logger#unknown(progname = nil) -> true (9019.0)

• 2.4.0

• インスタンスメソッド

UNKNOWN 情報を出力します。

UNKNOWN 情報を出力します。

ブロックを与えなかった場合は、progname をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして
ログを出力します。

引数とブロックを同時に与えた場合は、progname をプログラム名、ブロックを評価した
結果をメッセージとしてログを出力します。

@param progname ブロックを与えない場合は、メッセージとして文字列または例外オブジェクトを指定します。
ブロックを与えた場合は、プログラム名を文字列として与えます。

//emlist[例][ruby]{...

• Logger

Logger#unknown(progname = nil) { ... } -> true (9019.0)

• 2.4.0

• インスタンスメソッド

UNKNOWN 情報を出力します。

UNKNOWN 情報を出力します。

ブロックを与えなかった場合は、progname をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして
ログを出力します。

引数とブロックを同時に与えた場合は、progname をプログラム名、ブロックを評価した
結果をメッセージとしてログを出力します。

@param progname ブロックを与えない場合は、メッセージとして文字列または例外オブジェクトを指定します。
ブロックを与えた場合は、プログラム名を文字列として与えます。

//emlist[例][ruby]{...

• Logger

Logger#warn(progname = nil) -> true (9019.0)

• 2.4.0

• インスタンスメソッド

WARN 情報を出力します。

WARN 情報を出力します。

ブロックを与えなかった場合は、progname をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして
ログを出力します。

引数とブロックを同時に与えた場合は、progname をプログラム名、ブロックを評価した
結果をメッセージとしてログを出力します。

@param progname ブロックを与えない場合は、メッセージとして文字列または例外オブジェクトを指定します。
ブロックを与えた場合は、プログラム名を文字列として与えます。

//emlist[例][ruby]{
re...

• Logger

絞り込み条件を変える

Logger#warn(progname = nil) { ... } -> true (9019.0)

• 2.4.0

• インスタンスメソッド

WARN 情報を出力します。

WARN 情報を出力します。

ブロックを与えなかった場合は、progname をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして
ログを出力します。

引数とブロックを同時に与えた場合は、progname をプログラム名、ブロックを評価した
結果をメッセージとしてログを出力します。

@param progname ブロックを与えない場合は、メッセージとして文字列または例外オブジェクトを指定します。
ブロックを与えた場合は、プログラム名を文字列として与えます。

//emlist[例][ruby]{
re...

• Logger

Logger#warn? -> bool (9019.0)

• 2.4.0

• インスタンスメソッド

現在の Logger オブジェクトが WARN 以上のログレベルのメッセージを記録するなら 真を返します。

現在の Logger オブジェクトが WARN 以上のログレベルのメッセージを記録するなら
真を返します。

//emlist[例][ruby]{
require 'logger'

logger = Logger.new(STDOUT)
logger.warn? # => true
logger.level = Logger::Severity::ERROR
logger.warn? # => false
//}

• Logger

Kernel.#spawn(env, program, *args, options={}) -> Integer (487.0)

• 2.4.0

• モジュール関数

引数を外部コマンドとして実行しますが、生成した 子プロセスの終了を待ち合わせません。生成した子プロセスのプロセスIDを返します。

引数を外部コマンドとして実行しますが、生成した
子プロセスの終了を待ち合わせません。生成した子プロセスのプロセスIDを返します。

env に Hash を渡すことで、exec(2) で子プロセス内で
ファイルを実行する前に環境変数を変更することができます。
Hash のキーは環境変数名文字列、Hash の値に設定する値とします。
nil とすることで環境変数が削除(unsetenv(3))されます。
//emlist[例][ruby]{
# FOO を BAR にして BAZ を削除する
pid = spawn({"FOO"=>"BAR", "BAZ"=>nil}, command)
//...

• IO
• Kernel

Kernel.#spawn(program, *args) -> Integer (487.0)

• 2.4.0

• モジュール関数

引数を外部コマンドとして実行しますが、生成した 子プロセスの終了を待ち合わせません。生成した子プロセスのプロセスIDを返します。

引数を外部コマンドとして実行しますが、生成した
子プロセスの終了を待ち合わせません。生成した子プロセスのプロセスIDを返します。

env に Hash を渡すことで、exec(2) で子プロセス内で
ファイルを実行する前に環境変数を変更することができます。
Hash のキーは環境変数名文字列、Hash の値に設定する値とします。
nil とすることで環境変数が削除(unsetenv(3))されます。
//emlist[例][ruby]{
# FOO を BAR にして BAZ を削除する
pid = spawn({"FOO"=>"BAR", "BAZ"=>nil}, command)
//...

• IO
• Kernel

Kernel.#spawn(command, options={}) -> Integer (82.0)

• 2.4.0

• モジュール関数

引数を外部コマンドとして実行しますが、生成した 子プロセスの終了を待ち合わせません。生成した子プロセスのプロセスIDを返します。

引数を外部コマンドとして実行しますが、生成した
子プロセスの終了を待ち合わせません。生成した子プロセスのプロセスIDを返します。


=== 引数の解釈

この形式では command が shell のメタ文字
//emlist{
* ? {} [] <> () ~ & | \ $ ; ' ` " \n
//}
を含む場合、shell 経由で実行されます。
そうでなければインタプリタから直接実行されます。


@param command コマンドを文字列で指定します。
@param env 更新する環境変数を表す Hash
@param options オプションパラメータ Hash...

• Kernel

絞り込み条件を変える

Kernel.#spawn(env, command, options={}) -> Integer (82.0)

• 2.4.0

• モジュール関数

引数を外部コマンドとして実行しますが、生成した 子プロセスの終了を待ち合わせません。生成した子プロセスのプロセスIDを返します。

引数を外部コマンドとして実行しますが、生成した
子プロセスの終了を待ち合わせません。生成した子プロセスのプロセスIDを返します。


=== 引数の解釈

この形式では command が shell のメタ文字
//emlist{
* ? {} [] <> () ~ & | \ $ ; ' ` " \n
//}
を含む場合、shell 経由で実行されます。
そうでなければインタプリタから直接実行されます。


@param command コマンドを文字列で指定します。
@param env 更新する環境変数を表す Hash
@param options オプションパラメータ Hash...

• Kernel