ruby/warning.rb

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

54 строки
1.5 KiB
Ruby
Исходник Обычный вид История

2019-12-10 14:22:42 +03:00
# encoding: utf-8
2020-01-02 06:12:05 +03:00
# frozen-string-literal: true
2019-12-10 14:22:42 +03:00
module Kernel
2019-12-13 14:51:58 +03:00
module_function
2019-12-10 14:22:42 +03:00
# call-seq:
2020-12-08 13:32:33 +03:00
# warn(*msgs, uplevel: nil, category: nil) -> nil
2019-12-10 14:22:42 +03:00
#
# If warnings have been disabled (for example with the
# <code>-W0</code> flag), does nothing. Otherwise,
# converts each of the messages to strings, appends a newline
# character to the string if the string does not end in a newline,
# and calls Warning.warn with the string.
#
# warn("warning 1", "warning 2")
#
2023-01-01 08:33:06 +03:00
# <em>produces:</em>
2019-12-10 14:22:42 +03:00
#
# warning 1
# warning 2
#
# If the <code>uplevel</code> keyword argument is given, the string will
# be prepended with information for the given caller frame in
# the same format used by the <code>rb_warn</code> C function.
#
# # In baz.rb
# def foo
# warn("invalid call to foo", uplevel: 1)
# end
#
# def bar
# foo
# end
#
# bar
#
2023-01-01 08:33:06 +03:00
# <em>produces:</em>
2019-12-10 14:22:42 +03:00
#
# baz.rb:6: warning: invalid call to foo
#
# If <code>category</code> keyword argument is given, passes the category
# to <code>Warning.warn</code>. The category given must be be one of the
# following categories:
#
# :deprecated :: Used for warning for deprecated functionality that may
# be removed in the future.
# :experimental :: Used for experimental features that may change in
# future releases.
def warn(*msgs, uplevel: nil, category: nil)
Primitive.rb_warn_m(msgs, uplevel, category)
2019-12-10 14:22:42 +03:00
end
end