Digest::Base
class Digest::Base
Parent:Digest::Class
这个抽象类提供了用C编写的消息摘要实现类的通用接口。
在C中编写摘要子类
Digest :: Base提供了用C编写的消息摘要类的通用接口。这些类必须提供一个rb_digest_metadata_t类型的结构:
typedef int (*rb_digest_hash_init_func_t)(void *
typedef void (*rb_digest_hash_update_func_t)(void *, unsigned char *, size_t
typedef int (*rb_digest_hash_finish_func_t)(void *, unsigned char *
typedef struct {
int api_version;
size_t digest_len;
size_t block_len;
size_t ctx_size;
rb_digest_hash_init_func_t init_func;
rb_digest_hash_update_func_t update_func;
rb_digest_hash_finish_func_t finish_func;
} rb_digest_metadata_t;
这个结构必须被设置为一个名为实例变量metadata
(名称前没有+ @ +)。举例来说:
static const rb_digest_metadata_t sha1 = {
RUBY_DIGEST_API_VERSION,
SHA1_DIGEST_LENGTH,
SHA1_BLOCK_LENGTH,
sizeof(SHA1_CTX),
(rb_digest_hash_init_func_t)SHA1_Init,
(rb_digest_hash_update_func_t)SHA1_Update,
(rb_digest_hash_finish_func_t)SHA1_Finish,
};
rb_ivar_set(cDigest_SHA1, rb_intern("metadata"),
Data_Wrap_Struct(0, 0, 0, (void *)&sha1)
公共实例方法
digest_base << string → digest_base Show source
使用给定的字符串
更新摘要并返回self
。
static VALUE
rb_digest_base_update(VALUE self, VALUE str)
{
rb_digest_metadata_t *algo;
void *pctx;
algo = get_digest_base_metadata(rb_obj_class(self)
TypedData_Get_Struct(self, void, &digest_type, pctx
StringValue(str
algo->update_func(pctx, (unsigned char *)RSTRING_PTR(str), RSTRING_LEN(str)
RB_GC_GUARD(str
return self;
}
block_length → Integer Show source
以字节为单位返回摘要的块长度。
static VALUE
rb_digest_base_block_length(VALUE self)
{
rb_digest_metadata_t *algo;
algo = get_digest_base_metadata(rb_obj_class(self)
return INT2NUM(algo->block_len
}
digest_length → Integer Show source
以字节为单位返回散列值的长度。
static VALUE
rb_digest_base_digest_length(VALUE self)
{
rb_digest_metadata_t *algo;
algo = get_digest_base_metadata(rb_obj_class(self)
return INT2NUM(algo->digest_len
}
reset → digest_base Show source
将摘要重置为其初始状态并返回self
。
static VALUE
rb_digest_base_reset(VALUE self)
{
rb_digest_metadata_t *algo;
void *pctx;
algo = get_digest_base_metadata(rb_obj_class(self)
TypedData_Get_Struct(self, void, &digest_type, pctx
algo_init(algo, pctx
return self;
}
update(string) → digest_base Show source
使用给定的字符串
更新摘要并返回self
。
static VALUE
rb_digest_base_update(VALUE self, VALUE str)
{
rb_digest_metadata_t *algo;
void *pctx;
algo = get_digest_base_metadata(rb_obj_class(self)
TypedData_Get_Struct(self, void, &digest_type, pctx
StringValue(str
algo->update_func(pctx, (unsigned char *)RSTRING_PTR(str), RSTRING_LEN(str)
RB_GC_GUARD(str
return self;
}