Sha256: 8fa81f8412a4bdcd03ea4fe04fca9c8431a77590e0163dd21f6d01d9ba6c5085

Contents?: true

Size: 1.54 KB

Versions: 24

Compression:

Stored size: 1.54 KB

Contents

# <!-- rdoc-file=error.c -->
# The Warning module contains a single method named #warn, and the module
# extends itself, making Warning.warn available. Warning.warn is called for all
# warnings issued by Ruby. By default, warnings are printed to $stderr.
#
# Changing the behavior of Warning.warn is useful to customize how warnings are
# handled by Ruby, for instance by filtering some warnings, and/or outputting
# warnings somewhere other than $stderr.
#
# If you want to change the behavior of Warning.warn you should use
# +Warning.extend(MyNewModuleWithWarnMethod)+ and you can use `super` to get the
# default behavior of printing the warning to $stderr.
#
# Example:
#     module MyWarningFilter
#       def warn(message, category: nil, **kwargs)
#         if /some warning I want to ignore/.match?(message)
#           # ignore
#         else
#           super
#         end
#       end
#     end
#     Warning.extend MyWarningFilter
#
# You should never redefine Warning#warn (the instance method), as that will
# then no longer provide a way to use the default behavior.
#
# The `warning` gem provides convenient ways to customize Warning.warn.
#
module Warning
  # <!--
  #   rdoc-file=error.c
  #   - warn(msg, category: nil)  -> nil
  # -->
  # Writes warning message `msg` to $stderr. This method is called by Ruby for all
  # emitted warnings. A `category` may be included with the warning.
  #
  # See the documentation of the Warning module for how to customize this.
  #
  def self?.warn: (String message, ?category: :deprecated | :experimental | nil) -> nil
end

Version data entries

24 entries across 24 versions & 2 rubygems

Version Path
getargv-0.3.3-universal-darwin vendor/bundle/ruby/3.3.0/gems/rbs-2.8.4/core/warning.rbs
rbs-3.2.0.pre.1 core/warning.rbs
rbs-3.1.3 core/warning.rbs
rbs-3.1.2 core/warning.rbs
rbs-3.1.1 core/warning.rbs
rbs-3.1.0 core/warning.rbs
rbs-3.0.4 core/warning.rbs
rbs-3.0.3 core/warning.rbs
rbs-3.0.2 core/warning.rbs
rbs-3.0.1 core/warning.rbs
rbs-3.0.0 core/warning.rbs
rbs-3.0.0.dev.3 core/warning.rbs
rbs-3.0.0.dev.2 core/warning.rbs
rbs-2.8.4 core/warning.rbs
rbs-2.8.3 core/warning.rbs
rbs-3.0.0.dev.1 core/warning.rbs
rbs-2.8.2 core/warning.rbs
rbs-2.8.1 core/warning.rbs
rbs-2.8.0 core/warning.rbs
rbs-2.8.0.pre.1 core/warning.rbs