1berry/ruby
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

[ruby/digest] [DOC] Expand Digest::SHA2 definitions for RDoc

Browse Source 
Since RDoc searches `var = rb_define_class_under(...)` statements
literally, they cannot be built by macros.

https://github.com/ruby/digest/commit/d39b684f91
This commit is contained in:
Nobuyoshi Nakada 2024-01-26 12:15:59 +09:00 committed by git
parent 81702b4b87
commit d3e6bcd37f
1 changed files with 30 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
ext/digest/sha2/sha2init.c
View File

@ -25,32 +25,50 @@ static const rb_digest_metadata_t sha##bitlen = { \
FOREACH_BITLEN(DEFINE_ALGO_METADATA) FOREACH_BITLEN(DEFINE_ALGO_METADATA)
/* /*
* Document-class: Digest::SHA256 < Digest::Base
*
* Classes for calculating message digests using the SHA-256/384/512 * Classes for calculating message digests using the SHA-256/384/512
* Secure Hash Algorithm(s) by NIST (the US' National Institute of * Secure Hash Algorithm(s) by NIST (the US' National Institute of
* Standards and Technology), described in FIPS PUB 180-2. * Standards and Technology), described in FIPS PUB 180-2.
*
* See SHA2.
*/
/*
* Document-class: Digest::SHA384 < Digest::Base
*
* Classes for calculating message digests using the SHA-256/384/512
* Secure Hash Algorithm(s) by NIST (the US' National Institute of
* Standards and Technology), described in FIPS PUB 180-2.
*
* See SHA2.
*/
/*
* Document-class: Digest::SHA512 < Digest::Base
*
* Classes for calculating message digests using the SHA-256/384/512
* Secure Hash Algorithm(s) by NIST (the US' National Institute of
* Standards and Technology), described in FIPS PUB 180-2.
*
* See SHA2.
*/ */
void void
Init_sha2(void) Init_sha2(void)
{ {
VALUE mDigest, cDigest_Base; VALUE mDigest, cDigest_Base, cDigest_SHA2;
ID id_metadata = rb_id_metadata(); ID id_metadata = rb_id_metadata();
#define DECLARE_ALGO_CLASS(bitlen) \
VALUE cDigest_SHA##bitlen;
FOREACH_BITLEN(DECLARE_ALGO_CLASS)
#if 0 #if 0
mDigest = rb_define_module("Digest"); /* let rdoc know */ mDigest = rb_define_module("Digest"); /* let rdoc know */
#endif #endif
mDigest = rb_digest_namespace(); mDigest = rb_digest_namespace();
cDigest_Base = rb_const_get(mDigest, rb_intern_const("Base")); cDigest_Base = rb_const_get(mDigest, rb_intern_const("Base"));
#define DEFINE_ALGO_CLASS(bitlen) \ cDigest_SHA2 = rb_define_class_under(mDigest, "SHA256", cDigest_Base);
cDigest_SHA##bitlen = rb_define_class_under(mDigest, "SHA" #bitlen, cDigest_Base); \ rb_ivar_set(cDigest_SHA2, id_metadata, rb_digest_make_metadata(&sha256));
\
rb_ivar_set(cDigest_SHA##bitlen, id_metadata, \
rb_digest_make_metadata(&sha##bitlen));
FOREACH_BITLEN(DEFINE_ALGO_CLASS) cDigest_SHA2 = rb_define_class_under(mDigest, "SHA384", cDigest_Base);
rb_ivar_set(cDigest_SHA2, id_metadata, rb_digest_make_metadata(&sha384));
cDigest_SHA2 = rb_define_class_under(mDigest, "SHA512", cDigest_Base);
rb_ivar_set(cDigest_SHA2, id_metadata, rb_digest_make_metadata(&sha512));
} }