Edit File by line

#ifndef RUBY_VERSION_H /*-*-C++-*-vi:se ft=cpp:*/

[0] Fix | Delete

#define RUBY_VERSION_H 1

[1] Fix | Delete

/**

[2] Fix | Delete

* @file

[3] Fix | Delete

* @author $Author$

[4] Fix | Delete

* @date Wed May 13 12:56:56 JST 2009

[5] Fix | Delete

[6] Fix | Delete

[7] Fix | Delete

[8] Fix | Delete

* @copyright This file is a part of the programming language Ruby.

[9] Fix | Delete

* Permission is hereby granted, to either redistribute and/or

[10] Fix | Delete

* modify this file, provided that the conditions mentioned in the

[11] Fix | Delete

* file COPYING are met. Consult the file for details.

[12] Fix | Delete

[13] Fix | Delete

* This file contains only

[14] Fix | Delete

* - never-changeable information, and

[15] Fix | Delete

* - interfaces accessible from extension libraries.

[16] Fix | Delete

[17] Fix | Delete

* Never try to check RUBY_VERSION_CODE etc in extension libraries,

[18] Fix | Delete

* check the features with mkmf.rb instead.

[19] Fix | Delete

[20] Fix | Delete

[21] Fix | Delete

/**

[22] Fix | Delete

* @name The origin.

[23] Fix | Delete

[24] Fix | Delete

* These information never change. Just written here to remember.

[25] Fix | Delete

[26] Fix | Delete

* @{

[27] Fix | Delete

[28] Fix | Delete

[29] Fix | Delete

/** Author of this project. */

[30] Fix | Delete

#define RUBY_AUTHOR "Yukihiro Matsumoto"

[31] Fix | Delete

[32] Fix | Delete

/** Ruby's birth year. */

[33] Fix | Delete

#define RUBY_BIRTH_YEAR 1993

[34] Fix | Delete

[35] Fix | Delete

/** Ruby's birth month. */

[36] Fix | Delete

#define RUBY_BIRTH_MONTH 2

[37] Fix | Delete

[38] Fix | Delete

/** Ruby's birth day. */

[39] Fix | Delete

#define RUBY_BIRTH_DAY 24

[40] Fix | Delete

[41] Fix | Delete

/** @} */

[42] Fix | Delete

[43] Fix | Delete

/**

[44] Fix | Delete

* @name The API version.

[45] Fix | Delete

[46] Fix | Delete

* API version is different from binary version. These numbers are for API

[47] Fix | Delete

* stability. When you have distinct API versions x and y, you cannot expect

[48] Fix | Delete

* codes targeted to x also works for y.

[49] Fix | Delete

[50] Fix | Delete

* However let us repeat here that it's a BAD idea to check

[51] Fix | Delete

* #RUBY_API_VERSION_CODE form extension libraries. Different API versions are

[52] Fix | Delete

* just different. There is no such thing like upper compatibility.

[53] Fix | Delete

[54] Fix | Delete

* @{

[55] Fix | Delete

[56] Fix | Delete

[57] Fix | Delete

/**

[58] Fix | Delete

* Major version. This digit changes sometimes for various reasons, but that

[59] Fix | Delete

* doesn't mean a total rewrite. Practically when it comes to API versioning,

[60] Fix | Delete

* major and minor version changes are equally catastrophic.

[61] Fix | Delete

[62] Fix | Delete

#define RUBY_API_VERSION_MAJOR 3

[63] Fix | Delete

[64] Fix | Delete

/**

[65] Fix | Delete

* Minor version. As of writing this version changes annually. Greater

[66] Fix | Delete

* version doesn't mean "better"; they just mean years passed.

[67] Fix | Delete

[68] Fix | Delete

#define RUBY_API_VERSION_MINOR 1

[69] Fix | Delete

[70] Fix | Delete

/**

[71] Fix | Delete

* Teeny version. This digit is kind of reserved these days. Kept 0 for the

[72] Fix | Delete

* entire 2.x era. Waiting for future uses.

[73] Fix | Delete

[74] Fix | Delete

#define RUBY_API_VERSION_TEENY 0

[75] Fix | Delete

[76] Fix | Delete

/**

[77] Fix | Delete

* This macro is API versions encoded into a C integer.

[78] Fix | Delete

[79] Fix | Delete

* @note Use mkmf.

[80] Fix | Delete

* @note Don't rely on it.

[81] Fix | Delete

[82] Fix | Delete

#define RUBY_API_VERSION_CODE (RUBY_API_VERSION_MAJOR*10000+RUBY_API_VERSION_MINOR*100+RUBY_API_VERSION_TEENY)

[83] Fix | Delete

[84] Fix | Delete

/** @} */

[85] Fix | Delete

[86] Fix | Delete

#ifdef RUBY_EXTERN

[87] Fix | Delete

/* Internal note: this file could be included from verconf.mk _before_

[88] Fix | Delete

* generating config.h, on Windows. The #ifdef above is to trick such

[89] Fix | Delete

* situation. */

[90] Fix | Delete

RBIMPL_SYMBOL_EXPORT_BEGIN()

[91] Fix | Delete

[92] Fix | Delete

/**

[93] Fix | Delete

* @name Interfaces from extension libraries.

[94] Fix | Delete

[95] Fix | Delete

* Before using these infos, think thrice whether they are really

[96] Fix | Delete

* necessary or not, and if the answer was yes, think twice a week

[97] Fix | Delete

* later again.

[98] Fix | Delete

[99] Fix | Delete

* @{

[100] Fix | Delete

[101] Fix | Delete

[102] Fix | Delete

/** API versions, in { major, minor, teeny } order. */

[103] Fix | Delete

RUBY_EXTERN const int ruby_api_version[3];

[104] Fix | Delete

[105] Fix | Delete

/**

[106] Fix | Delete

* Stringised version.

[107] Fix | Delete

[108] Fix | Delete

* @note This is the runtime version, not the API version. For instance it

[109] Fix | Delete

* was `"2.5.9"` when ::ruby_api_version was `{ 2, 5, 0 }`.

[110] Fix | Delete

[111] Fix | Delete

RUBY_EXTERN const char ruby_version[];

[112] Fix | Delete

[113] Fix | Delete

/** Date of release, in a C string. */

[114] Fix | Delete

RUBY_EXTERN const char ruby_release_date[];

[115] Fix | Delete

[116] Fix | Delete

/**

[117] Fix | Delete

* Target platform identifier, in a C string.

[118] Fix | Delete

[119] Fix | Delete

* @note Seasoned UNIX programmers should beware that this "platform

[120] Fix | Delete

* identifier" is our invention; not always identical to so-called

[121] Fix | Delete

* target triplets that GNU systems use. For instance on @shyouhei's

[122] Fix | Delete

* machine, ::ruby_platform is `"x64_64-linux"` while its target triplet

[123] Fix | Delete

* is `x86_64-pc-linux-gnu`.

[124] Fix | Delete

* @note Note also that we support Windows.

[125] Fix | Delete

[126] Fix | Delete

RUBY_EXTERN const char ruby_platform[];

[127] Fix | Delete

[128] Fix | Delete

/**

[129] Fix | Delete

* This is a monotonic increasing integer that describes specific "patch"

[130] Fix | Delete

* level. You can know the exact changeset your binary is running by this info

[131] Fix | Delete

* (and ::ruby_version), unless this is -1. -1 means there is no release yet

[132] Fix | Delete

* for the version; ruby is actively developed. 0 means the initial GA version.

[133] Fix | Delete

[134] Fix | Delete

RUBY_EXTERN const int ruby_patchlevel;

[135] Fix | Delete

[136] Fix | Delete

/**

[137] Fix | Delete

* This is what `ruby -v` prints to the standard error. Something like:

[138] Fix | Delete

* `"ruby 2.5.9p229 (2021-04-05 revision 67829) [x86_64-linux]"`

[139] Fix | Delete

[140] Fix | Delete

RUBY_EXTERN const char ruby_description[];

[141] Fix | Delete

[142] Fix | Delete

/** Copyright notice. */

[143] Fix | Delete

RUBY_EXTERN const char ruby_copyright[];

[144] Fix | Delete

[145] Fix | Delete

/**

[146] Fix | Delete

* This is just `"ruby"` for us. But different implementations can have

[147] Fix | Delete

* different strings here.

[148] Fix | Delete

[149] Fix | Delete

RUBY_EXTERN const char ruby_engine[];

[150] Fix | Delete

[151] Fix | Delete

/** @} */

[152] Fix | Delete

[153] Fix | Delete

RBIMPL_SYMBOL_EXPORT_END()

[154] Fix | Delete

#endif

[155] Fix | Delete

[156] Fix | Delete

#endif

[157] Fix | Delete

[158] Fix | Delete