<?xml version='1.0' encoding='utf-8'?>
<pod xmlns="http://axkit.org/ns/2000/pod2xml">
<head>
	<title>名前</title>
</head>
<sect1>
<title>名前</title>
<para>
Digest::SHA1 - SHA-1アルゴリズムへのPerlインターフェース
</para>
</sect1>
<sect1>
<title>概要</title>
<verbatim><![CDATA[
# 関数形式
use Digest::SHA1  qw(sha1 sha1_hex sha1_base64);
]]></verbatim>
<verbatim><![CDATA[
$digest = sha1($data);
$digest = sha1_hex($data);
$digest = sha1_base64($data);
]]></verbatim>
<verbatim><![CDATA[
# OO形式
use Digest::SHA1;
]]></verbatim>
<verbatim><![CDATA[
$ctx = Digest::SHA1->new;
]]></verbatim>
<verbatim><![CDATA[
$ctx->add($data);
$ctx->addfile(*FILE);
]]></verbatim>
<verbatim><![CDATA[
$digest = $ctx->digest;
$digest = $ctx->hexdigest;
$digest = $ctx->b64digest;
]]></verbatim>
</sect1>
<sect1>
<title>説明</title>
<para>
<code>Digest::SHA1</code>モジュールはNIST SHA-1メッセージ・ダイジェスト・アルゴリズムを
Perlプログラムから使えるようにします。このアルゴリズムは任意の長さの
メッセージを入力として受け取り、その入力の160ビットの&quot;フィンガープリント&quot;
あるいは&quot;メッセージ・ダイジェスト&quot;を出力として生成します。
</para>
<para>
<code>Digest::SHA1</code>モジュールは簡単に使えるように手続き的なインターフェースと、
任意の長さのメッセージを扱うことができ、ファイルから直接読み込むことが
できるオブジェクト指向のインターフェースを提供しています。
</para>
<para>
バイナリのダイジェストは20バイトの長さがあります。16進ダイジェストは
40文字の長さになります。base64ダイジェクトは27文字になります。
</para>
</sect1>
<sect1>
<title>関数</title>
<para>
以下の関数が<code>Digest::SHA1</code>モジュールからエクスポートすることができます。
デフォルトでは何もエクスポートされません。
</para>
<list>
<item><itemtext>sha1($data,...)</itemtext>
<para>
この関数はすべての引数を結合し、その&quot;メッセージ&quot;のSHA-1ダイジェストを
計算し、それをバイナリ形式で返します。
</para>
</item>
<item><itemtext>sha1_hex($data,...)</itemtext>
<para>
sha1()と同じ。ただしダイジェストを16進形式で返します。
</para>
</item>
<item><itemtext>sha1_base64($data,...)</itemtext>
<para>
sha1()と同じ。ただしダイジェストをbase64にエンコードされた形式で返します。
</para>
</item>
</list>
</sect1>
<sect1>
<title>メソッド</title>
<para>
<code>Digest::SHA1</code>モジュールは標準の<code>Digest</code>00インターフェースを提供します。
コンストラクタは以下のようになります：
</para>
<list>
<item><itemtext>$sha1 = Digest-&gt;new('SHA-1')</itemtext>
</item>
<item><itemtext>$sha1 = Digest::SHA1-&gt;new</itemtext>
<para>
コンストラクタは、SHA-1メッセージ・ダイジェスト・アルゴリズムの状態を
カプセル化した新しい<code>Digest::SHA1</code>オブジェクトを返します。<link xref='Digest'>Digest</link>で
説明されているメソッドを使って、最終的にはダイジェストを依頼するデータを
オブジェクトに追加することができます。
</para>
</item>
</list>
</sect1>
<sect1>
<title>参考資料</title>
<para>
<link xref='Digest'>Digest</link>, <link xref='Digest::HMAC_SHA1'>Digest::HMAC_SHA1</link>, <link xref='Digest::MD5'>Digest::MD5</link>
</para>
<para>
<xlink uri='http://www.itl.nist.gov/fipspubs/fip180-1.htm'>http://www.itl.nist.gov/fipspubs/fip180-1.htm</xlink>
</para>
</sect1>
<sect1>
<title>著作権(COPYRIGHT)</title>
<para>
This library is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
</para>
<verbatim><![CDATA[
Copyright 1999-2001 Gisle Aas.
Copyright 1997 Uwe Hollerbach.
]]></verbatim>
</sect1>
<sect1>
<title>作者</title>
<para>
Peter C. Gutmann,
Uwe Hollerbach &lt;uh@alumni.caltech.edu&gt;,
Gisle Aas &lt;gisle@aas.no&gt;
</para>
</sect1>
</pod>
