Gecko [ www.corporacionhdm.com.pe ]

Name	Size	Permission	Date
arithmetic	[ DIR ]	drwxr-xr-x	2025-04-16 09:00
attr	[ DIR ]	drwxr-xr-x	2025-04-16 09:00
compiler_is	[ DIR ]	drwxr-xr-x	2025-04-16 09:00
core	[ DIR ]	drwxr-xr-x	2025-04-16 09:00
encoding	[ DIR ]	drwxr-xr-x	2025-04-16 09:00
has	[ DIR ]	drwxr-xr-x	2025-04-16 09:00
intern	[ DIR ]	drwxr-xr-x	2025-04-16 09:00
abi.h	1.55 KB	-rw-r--r--	2025-03-20 13:38
anyargs.h	36.38 KB	-rw-r--r--	2025-03-20 13:38
arithmetic.h	2.07 KB	-rw-r--r--	2025-03-20 13:38
assume.h	3.17 KB	-rw-r--r--	2025-03-20 13:38
cast.h	2.28 KB	-rw-r--r--	2025-03-20 13:38
compiler_is.h	2.06 KB	-rw-r--r--	2025-03-20 13:38
compiler_since.h	2.72 KB	-rw-r--r--	2025-03-20 13:38
config.h	4.77 KB	-rw-r--r--	2025-03-20 13:38
constant_p.h	1.85 KB	-rw-r--r--	2025-03-20 13:38
core.h	1.83 KB	-rw-r--r--	2025-03-20 13:38
ctype.h	22.56 KB	-rw-r--r--	2025-03-20 13:38
dllexport.h	3.04 KB	-rw-r--r--	2025-03-20 13:38
dosish.h	3.16 KB	-rw-r--r--	2025-03-20 13:38
error.h	20.92 KB	-rw-r--r--	2025-03-20 13:38
eval.h	18.2 KB	-rw-r--r--	2025-03-20 13:38
event.h	6.21 KB	-rw-r--r--	2025-03-20 13:38
fl_type.h	32.88 KB	-rw-r--r--	2025-03-20 13:38
gc.h	28.07 KB	-rw-r--r--	2025-03-20 13:38
glob.h	4.98 KB	-rw-r--r--	2025-03-20 13:38
globals.h	9.77 KB	-rw-r--r--	2025-03-20 13:38
interpreter.h	9.45 KB	-rw-r--r--	2025-03-20 13:38
iterator.h	18.19 KB	-rw-r--r--	2025-03-20 13:38
memory.h	23.36 KB	-rw-r--r--	2025-03-20 13:38
method.h	7.08 KB	-rw-r--r--	2025-03-20 13:38
module.h	7.11 KB	-rw-r--r--	2025-03-20 13:38
newobj.h	6.09 KB	-rw-r--r--	2025-03-20 13:38
scan_args.h	18.48 KB	-rw-r--r--	2025-03-20 13:38
special_consts.h	11.95 KB	-rw-r--r--	2025-03-20 13:38
static_assert.h	3.21 KB	-rw-r--r--	2025-03-20 13:38
stdalign.h	4.58 KB	-rw-r--r--	2025-03-20 13:38
stdbool.h	1.92 KB	-rw-r--r--	2025-03-20 13:38
stdckdint.h	2.68 KB	-rw-r--r--	2025-03-20 13:38
symbol.h	13.28 KB	-rw-r--r--	2025-03-20 13:38
value.h	4.26 KB	-rw-r--r--	2025-03-20 13:38
value_type.h	14.21 KB	-rw-r--r--	2025-03-20 13:38
variable.h	11.81 KB	-rw-r--r--	2025-03-20 13:38
warning_push.h	4.91 KB	-rw-r--r--	2025-03-20 13:38
xmalloc.h	14.18 KB	-rw-r--r--	2025-03-20 13:38

Rename

#ifndef RBIMPL_MODULE_H                              /*-*-C++-*-vi:se ft=cpp:*/
#define RBIMPL_MODULE_H
/**
 * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
 *             modify this file, provided that  the conditions mentioned in the
 *             file COPYING are met.  Consult the file for details.
 * @warning    Symbols   prefixed  with   either  `RBIMPL`   or  `rbimpl`   are
 *             implementation details.   Don't take  them as canon.  They could
 *             rapidly appear then vanish.  The name (path) of this header file
 *             is also an  implementation detail.  Do not expect  it to persist
 *             at the place it is now.  Developers are free to move it anywhere
 *             anytime at will.
 * @note       To  ruby-core:  remember  that   this  header  can  be  possibly
 *             recursively included  from extension  libraries written  in C++.
 *             Do not  expect for  instance `__VA_ARGS__` is  always available.
 *             We assume C99  for ruby itself but we don't  assume languages of
 *             extension libraries.  They could be written in C++98.
 * @brief      Creation and modification of Ruby modules.
 */
#include "ruby/internal/dllexport.h"
#include "ruby/internal/value.h"

/**
 * @defgroup  class  Classes and their hierarchy.
 *
 * @par Terminology
 *   - class: same as in Ruby.
 *   - singleton class: class for a particular object.
 *   - eigenclass: = singleton class
 *   - metaclass: class of a class.  Metaclass is a kind of singleton class.
 *   - metametaclass: class of a metaclass.
 *   - meta^(n)-class: class of a meta^(n-1)-class.
 *   - attached object: A singleton class knows its unique instance.
 *     The instance is called the attached object for the singleton class.
 * @{
 */

RBIMPL_SYMBOL_EXPORT_BEGIN()

RBIMPL_ATTR_NONNULL(())
/**
 * Defines a top-level class.
 *
 * @param[in]  name           Name of the class.
 * @param[in]  super          A class from which the new class will derive.
 * @exception  rb_eTypeError  The constant name `name` is already taken but the
 *                            constant is not a class.
 * @exception  rb_eTypeError  The class  is already  defined but the  class can
 *                            not  be reopened  because its  superclass is  not
 *                            `super`.
 * @exception  rb_eArgError   `super` is NULL.
 * @return     The created class.
 * @post       Top-level constant named `name` refers the returned class.
 * @note       If a class named `name` is already defined and its superclass is
 *             `super`, the function just returns the defined class.
 * @note       The GC does not collect nor move classes returned by this
 *             function. They are immortal.
 *
 * @internal
 *
 * There are classes without names, but you  can't pass NULL here.  You have to
 * use other ways to create one.
 */
VALUE rb_define_class(const char *name, VALUE super);

RBIMPL_ATTR_NONNULL(())
/**
 * Defines a top-level module.
 *
 * @param[in]  name           Name of the module.
 * @exception  rb_eTypeError  The constant name `name` is already taken but the
 *                            constant is not a module.
 * @return     The created module.
 * @post       Top-level constant named `name` refers the returned module.
 * @note       The GC does not collect nor move modules returned by this
 *             function. They are immortal.
 *
 * @internal
 *
 * There are modules without names, but you  can't pass NULL here.  You have to
 * use other ways to create one.
 */
VALUE rb_define_module(const char *name);

RBIMPL_ATTR_NONNULL(())
/**
 * Defines a class under the namespace of `outer`.
 *
 * @param[out]  outer          A class which contains the new class.
 * @param[in]   name           Name of the new class
 * @param[in]   super          A class from which the new class will derive.
 *                             0 means ::rb_cObject.
 * @exception   rb_eTypeError  The constant  name `name`  is already  taken but
 *                             the constant is not a class.
 * @exception   rb_eTypeError  The class  is already defined but  the class can
 *                             not be  reopened because  its superclass  is not
 *                             `super`.
 * @exception   rb_eArgError   `super` is NULL.
 * @return      The created class.
 * @post        `outer::name` refers the returned class.
 * @note        If a class  named `name` is already defined  and its superclass
 *              is `super`, the function just returns the defined class.
 * @note        The GC does not collect nor move classes returned by this
 *              function. They are immortal.
 */
VALUE rb_define_class_under(VALUE outer, const char *name, VALUE super);

RBIMPL_ATTR_NONNULL(())
/**
 * Defines a module under the namespace of `outer`.
 *
 * @param[out]  outer          A class which contains the new module.
 * @param[in]   name           Name of the new module
 * @exception   rb_eTypeError  The constant  name `name`  is already  taken but
 *                             the constant is not a class.
 * @return      The created module.
 * @post        `outer::name` refers the returned module.
 * @note        The GC does not collect nor move modules returned by this
 *              function. They are immortal.
 */
VALUE rb_define_module_under(VALUE outer, const char *name);

/**
 * Includes a module to a class.
 *
 * @param[out]  klass         Inclusion destination.
 * @param[in]   module        Inclusion source.
 * @exception   rb_eArgError  Cyclic inclusion.
 *
 * @internal
 *
 * :FIXME: @shyouhei suspects this function  lacks assertion that the arguments
 * being modules...  Could silently SEGV if non-module was passed?
 */
void rb_include_module(VALUE klass, VALUE module);

/**
 * Extend the object with the module.
 *
 * @warning     This    is   the    same    as   `Module#extend_object`,    not
 *              `Object#extend`!  These  two methods are very  similar, but not
 *              identical.  The difference is the hook.  `Module#extend_object`
 *              does not invoke `Module#extended`, while `Object#extend` does.
 * @param[out]  obj  Object to extend.
 * @param[in]   mod  Module of extension.
 */
void rb_extend_object(VALUE obj, VALUE mod);

/**
 * Identical to rb_include_module(), except it  "prepends" the passed module to
 * the klass,  instead of  includes.  This affects  how `super`  resolves.  For
 * instance:
 *
 * ```ruby
 * class  Q;                def foo;      "<q/>"       end end
 * module W;                def foo; "<w>#{super}</w>" end end
 * class  E < Q; include W; def foo; "<e>#{super}</e>" end end
 * class  R < Q; prepend W; def foo; "<r>#{super}</r>" end end
 *
 * E.new.foo # => "<e><w><q/></w></e>"
 * r.new.foo # => "<W><r><q/></r></w>"
 * ```
 *
 * @param[out]  klass         Target class to modify.
 * @param[in]   module        Module to prepend.
 * @exception   rb_eArgError  Cyclic inclusion.
 */
void rb_prepend_module(VALUE klass, VALUE module);

/** @} */

RBIMPL_SYMBOL_EXPORT_END()

#endif /* RBIMPL_MODULE_H */