sha3.h

Functions

	Name
int	wc_InitSha3_224(wc_Sha3 * sha3, void * heap, int devId) この関数はSHA3-224を初期化します。これはwc_Sha3_224Hashによって自動的に呼び出されます。
int	wc_Sha3_224_Update(wc_Sha3 * sha, const byte * data, word32 len) 長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。
int	wc_Sha3_224_Final(wc_Sha3 * sha3, byte * hash) データのハッシュ化を完了します。結果はhashに格納されます。sha3構造体の状態をリセットします。
void	wc_Sha3_224_Free(wc_Sha3 * ) wc_Sha3構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。
int	wc_Sha3_224_GetHash(wc_Sha3 * sha3, byte * hash) ハッシュデータを取得します。結果はhashに格納されます。sha3構造体の状態をリセットしません。
int	wc_Sha3_224_Copy(wc_Sha3 * sha3, wc_Sha3 * dst) ハッシュの状態をコピーします。
int	wc_InitSha3_256(wc_Sha3 * sha3, void * heap, int devId) この関数はSHA3-256を初期化します。これはwc_Sha3_256Hashによって自動的に呼び出されます。
int	wc_Sha3_256_Update(wc_Sha3 * sha, const byte * data, word32 len) 長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。
int	wc_Sha3_256_Final(wc_Sha3 * sha3, byte * hash) データのハッシュ化を完了します。結果はhashに格納されます。sha3構造体の状態をリセットします。
void	wc_Sha3_256_Free(wc_Sha3 * ) wc_Sha3構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。
int	wc_Sha3_256_GetHash(wc_Sha3 * sha3, byte * hash) ハッシュデータを取得します。結果はhashに格納されます。sha3構造体の状態をリセットしません。
int	wc_Sha3_256_Copy(wc_Sha3 * sha3, wc_Sha3 * dst) ハッシュの状態をコピーします。
int	wc_InitSha3_384(wc_Sha3 * sha3, void * heap, int devId) この関数はSHA3-384を初期化します。これはwc_Sha3_384Hashによって自動的に呼び出されます。
int	wc_Sha3_384_Update(wc_Sha3 * sha, const byte * data, word32 len) 長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。
int	wc_Sha3_384_Final(wc_Sha3 * sha3, byte * hash) データのハッシュ化を完了します。結果はhashに格納されます。sha3構造体の状態をリセットします。
void	wc_Sha3_384_Free(wc_Sha3 * ) wc_Sha3構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。
int	wc_Sha3_384_GetHash(wc_Sha3 * sha3, byte * hash) ハッシュデータを取得します。結果はhashに格納されます。sha3構造体の状態をリセットしません。
int	wc_Sha3_384_Copy(wc_Sha3 * sha3, wc_Sha3 * dst) ハッシュの状態をコピーします。
int	wc_InitSha3_512(wc_Sha3 * sha3, void * heap, int devId) この関数はSHA3-512を初期化します。これはwc_Sha3_512Hashによって自動的に呼び出されます。
int	wc_Sha3_512_Update(wc_Sha3 * sha, const byte * data, word32 len) 長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。
int	wc_Sha3_512_Final(wc_Sha3 * sha3, byte * hash) データのハッシュ化を完了します。結果はhashに格納されます。sha3構造体の状態をリセットします。
void	wc_Sha3_512_Free(wc_Sha3 * ) wc_Sha3構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。
int	wc_Sha3_512_GetHash(wc_Sha3 * sha3, byte * hash) ハッシュデータを取得します。結果はhashに格納されます。sha3構造体の状態をリセットしません。
int	wc_Sha3_512_Copy(wc_Sha3 * sha3, wc_Sha3 * dst) ハッシュの状態をコピーします。
int	wc_InitShake128(wc_Shake * shake, void * heap, int devId) この関数はSHAKE-128を初期化します。これはwc_Shake128Hashによって自動的に呼び出されます。
int	wc_Shake128_Update(wc_Shake * sha, const byte * data, word32 len) 長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。
int	wc_Shake128_Final(wc_Shake * shake, byte * hash) データのハッシュ化を完了します。結果はhashに格納されます。shake構造体の状態をリセットします。
int	wc_Shake128_Absorb(wc_Shake * sha, const byte * data, word32 len) 長さlenの提供されたバイト配列を吸収するために呼び出されます。段階的に呼び出すことはできません。
int	wc_Shake128_SqueezeBlocks(wc_Shake * shake, byte * out, word32 blockCnt) さらに多くのデータブロックを絞り出します。結果はoutに格納されます。段階的に呼び出すことができます。
void	wc_Shake128_Free(wc_Shake * ) wc_Shake構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。
int	wc_Shake128_GetHash(wc_Shake * shake, byte * hash) ハッシュデータを取得します。結果はhashに格納されます。shake構造体の状態をリセットしません。
int	wc_Shake128_Copy(wc_Shake * shake, wc_Shake * dst) ハッシュの状態をコピーします。
int	wc_InitShake256(wc_Shake * shake, void * heap, int devId) この関数はSHAKE-256を初期化します。これはwc_Shake256Hashによって自動的に呼び出されます。
int	wc_Shake256_Update(wc_Shake * sha, const byte * data, word32 len) 長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。
int	wc_Shake256_Final(wc_Shake * shake, byte * hash, word32 hashLen) データのハッシュ化を完了します。結果はhashに格納されます。shake構造体の状態をリセットします。
int	wc_Shake256_Absorb(wc_Shake * sha, const byte * data, word32 len) 長さlenの提供されたバイト配列を吸収するために呼び出されます。段階的に呼び出すことはできません。
int	wc_Shake256_SqueezeBlocks(wc_Shake * shake, byte * out, word32 blockCnt) さらに多くのデータブロックを絞り出します。結果はoutに格納されます。段階的に呼び出すことができます。
void	wc_Shake256_Free(wc_Shake * ) wc_Shake構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。
int	wc_Shake256_GetHash(wc_Shake * shake, byte * hash) ハッシュデータを取得します。結果はhashに格納されます。shake構造体の状態をリセットしません。
int	wc_Shake256_Copy(wc_Shake * shake, wc_Shake * dst) ハッシュの状態をコピーします。

Functions Documentation

function wc_InitSha3_224

int wc_InitSha3_224(
    wc_Sha3 * sha3,
    void * heap,
    int devId
)

この関数はSHA3-224を初期化します。これはwc_Sha3_224Hashによって自動的に呼び出されます。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ

See:

• wc_Sha3_224Hash
• wc_Sha3_224_Update
• wc_Sha3_224_Final

Return: 0 初期化に成功した場合に返されます

Example

wc_Sha3 sha3[1];
if ((ret = wc_InitSha3_224(sha3, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitSha3_224 failed");
}
else {
    wc_Sha3_224_Update(sha3, data, len);
    wc_Sha3_224_Final(sha3, hash);
}

function wc_Sha3_224_Update

int wc_Sha3_224_Update(
    wc_Sha3 * sha,
    const byte * data,
    word32 len
)

長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• data ハッシュ化されるデータ
• len ハッシュ化されるデータの長さ

See:

• wc_Sha3_224Hash
• wc_Sha3_224_Final
• wc_InitSha3_224

Return: 0 ダイジェストへのデータの追加に成功した場合に返されます。

Example

wc_Sha3 sha3[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_224(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_224 failed");
}
else {
    wc_Sha3_224_Update(sha3, data, len);
    wc_Sha3_224_Final(sha3, hash);
}

function wc_Sha3_224_Final

int wc_Sha3_224_Final(
    wc_Sha3 * sha3,
    byte * hash
)

データのハッシュ化を完了します。結果はhashに格納されます。sha3構造体の状態をリセットします。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Sha3_224Hash
• wc_Sha3_224_GetHash
• wc_InitSha3_224

Return: 0 完了に成功した場合に返されます。

Example

wc_Sha3 sha3[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_224(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_224 failed");
}
else {
   wc_Sha3_224_Update(sha3, data, len);
   wc_Sha3_224_Final(sha3, hash);
}

function wc_Sha3_224_Free

void wc_Sha3_224_Free(
    wc_Sha3 * 
)

wc_Sha3構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。

Parameters:

• sha3 解放されるsha3構造体へのポインタ。

See:

• wc_InitSha3_224
• wc_Sha3_224_Update
• wc_Sha3_224_Final

Return: none 戻り値なし。

Example

wc_Sha3 sha3;
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_224(&sha3, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitSha3_224 failed");
}
else {
    wc_Sha3_224_Update(&sha3, data, len);
    wc_Sha3_224_Final(&sha3, hash);
    wc_Sha3_224_Free(&sha3);
}

function wc_Sha3_224_GetHash

int wc_Sha3_224_GetHash(
    wc_Sha3 * sha3,
    byte * hash
)

ハッシュデータを取得します。結果はhashに格納されます。sha3構造体の状態をリセットしません。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Sha3_224Hash
• wc_Sha3_224_Final
• wc_InitSha3_224
• wc_Sha3_224_Copy

Return: 0 ハッシュのコピーに成功した場合に返されます。

Example

wc_Sha3 sha3[1];
if ((ret = wc_InitSha3_224(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_224 failed");
}
else {
   wc_Sha3_224_Update(sha3, data, len);
   wc_Sha3_224_GetHash(sha3, hash);
}

function wc_Sha3_224_Copy

int wc_Sha3_224_Copy(
    wc_Sha3 * sha3,
    wc_Sha3 * dst
)

ハッシュの状態をコピーします。

Parameters:

• sha3 コピーするsha3構造体へのポインタ
• dst コピー先のsha3構造体へのポインタ

See:

• wc_Sha3_224Hash
• wc_Sha3_224_Final
• wc_InitSha3_224
• wc_Sha3_224_GetHash

Return: 0 コピーに成功した場合に返されます。

Example

wc_Sha3 sha3[1];
wc_Sha3 sha3_dup[1];
if ((ret = wc_InitSha3_224(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_224 failed");
}
else {
   wc_Sha3_224_Update(sha3, data, len);
   wc_Sha3_224_Copy(sha3, sha3_dup);
}

function wc_InitSha3_256

int wc_InitSha3_256(
    wc_Sha3 * sha3,
    void * heap,
    int devId
)

この関数はSHA3-256を初期化します。これはwc_Sha3_256Hashによって自動的に呼び出されます。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ

See:

• wc_Sha3_256Hash
• wc_Sha3_256_Update
• wc_Sha3_256_Final

Return: 0 初期化に成功した場合に返されます

Example

wc_Sha3 sha3[1];
if ((ret = wc_InitSha3_256(sha3, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitSha3_256 failed");
}
else {
    wc_Sha3_256_Update(sha3, data, len);
    wc_Sha3_256_Final(sha3, hash);
}

function wc_Sha3_256_Update

int wc_Sha3_256_Update(
    wc_Sha3 * sha,
    const byte * data,
    word32 len
)

長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• data ハッシュ化されるデータ
• len ハッシュ化されるデータの長さ

See:

• wc_Sha3_256Hash
• wc_Sha3_256_Final
• wc_InitSha3_256

Return: 0 ダイジェストへのデータの追加に成功した場合に返されます。

Example

wc_Sha3 sha3[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_256(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_256 failed");
}
else {
    wc_Sha3_256_Update(sha3, data, len);
    wc_Sha3_256_Final(sha3, hash);
}

function wc_Sha3_256_Final

int wc_Sha3_256_Final(
    wc_Sha3 * sha3,
    byte * hash
)

データのハッシュ化を完了します。結果はhashに格納されます。sha3構造体の状態をリセットします。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Sha3_256Hash
• wc_Sha3_256_GetHash
• wc_InitSha3_256

Return: 0 完了に成功した場合に返されます。

Example

wc_Sha3 sha3[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_256(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_256 failed");
}
else {
   wc_Sha3_256_Update(sha3, data, len);
   wc_Sha3_256_Final(sha3, hash);
}

function wc_Sha3_256_Free

void wc_Sha3_256_Free(
    wc_Sha3 * 
)

wc_Sha3構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。

Parameters:

• sha3 解放されるsha3構造体へのポインタ。

See:

• wc_InitSha3_256
• wc_Sha3_256_Update
• wc_Sha3_256_Final

Return: none 戻り値なし。

Example

wc_Sha3 sha3;
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_256(&sha3, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitSha3_256 failed");
}
else {
    wc_Sha3_256_Update(&sha3, data, len);
    wc_Sha3_256_Final(&sha3, hash);
    wc_Sha3_256_Free(&sha3);
}

function wc_Sha3_256_GetHash

int wc_Sha3_256_GetHash(
    wc_Sha3 * sha3,
    byte * hash
)

ハッシュデータを取得します。結果はhashに格納されます。sha3構造体の状態をリセットしません。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Sha3_256Hash
• wc_Sha3_256_Final
• wc_InitSha3_256
• wc_Sha3_256_Copy

Return: 0 ハッシュのコピーに成功した場合に返されます。

Example

wc_Sha3 sha3[1];
if ((ret = wc_InitSha3_256(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_256 failed");
}
else {
   wc_Sha3_256_Update(sha3, data, len);
   wc_Sha3_256_GetHash(sha3, hash);
}

function wc_Sha3_256_Copy

int wc_Sha3_256_Copy(
    wc_Sha3 * sha3,
    wc_Sha3 * dst
)

ハッシュの状態をコピーします。

Parameters:

• sha3 コピーするsha3構造体へのポインタ
• dst コピー先のsha3構造体へのポインタ

See:

• wc_Sha3_256Hash
• wc_Sha3_256_Final
• wc_InitSha3_256
• wc_Sha3_256_GetHash

Return: 0 コピーに成功した場合に返されます。

Example

wc_Sha3 sha3[1];
wc_Sha3 sha3_dup[1];
if ((ret = wc_InitSha3_256(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_256 failed");
}
else {
   wc_Sha3_256_Update(sha3, data, len);
   wc_Sha3_256_Copy(sha3, sha3_dup);
}

function wc_InitSha3_384

int wc_InitSha3_384(
    wc_Sha3 * sha3,
    void * heap,
    int devId
)

この関数はSHA3-384を初期化します。これはwc_Sha3_384Hashによって自動的に呼び出されます。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ

See:

• wc_Sha3_384Hash
• wc_Sha3_384_Update
• wc_Sha3_384_Final

Return: 0 初期化に成功した場合に返されます

Example

wc_Sha3 sha3[1];
if ((ret = wc_InitSha3_384(sha3, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitSha3_384 failed");
}
else {
    wc_Sha3_384_Update(sha3, data, len);
    wc_Sha3_384_Final(sha3, hash);
}

function wc_Sha3_384_Update

int wc_Sha3_384_Update(
    wc_Sha3 * sha,
    const byte * data,
    word32 len
)

長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• data ハッシュ化されるデータ
• len ハッシュ化されるデータの長さ

See:

• wc_Sha3_384Hash
• wc_Sha3_384_Final
• wc_InitSha3_384

Return: 0 ダイジェストへのデータの追加に成功した場合に返されます。

Example

wc_Sha3 sha3[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_384(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_384 failed");
}
else {
    wc_Sha3_384_Update(sha3, data, len);
    wc_Sha3_384_Final(sha3, hash);
}

function wc_Sha3_384_Final

int wc_Sha3_384_Final(
    wc_Sha3 * sha3,
    byte * hash
)

データのハッシュ化を完了します。結果はhashに格納されます。sha3構造体の状態をリセットします。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Sha3_384Hash
• wc_Sha3_384_GetHash
• wc_InitSha3_384

Return: 0 完了に成功した場合に返されます。

Example

wc_Sha3 sha3[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_384(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_384 failed");
}
else {
   wc_Sha3_384_Update(sha3, data, len);
   wc_Sha3_384_Final(sha3, hash);
}

function wc_Sha3_384_Free

void wc_Sha3_384_Free(
    wc_Sha3 * 
)

wc_Sha3構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。

Parameters:

• sha3 解放されるsha3構造体へのポインタ。

See:

• wc_InitSha3_384
• wc_Sha3_384_Update
• wc_Sha3_384_Final

Return: none 戻り値なし。

Example

wc_Sha3 sha3;
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_384(&sha3, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitSha3_384 failed");
}
else {
    wc_Sha3_384_Update(&sha3, data, len);
    wc_Sha3_384_Final(&sha3, hash);
    wc_Sha3_384_Free(&sha3);
}

function wc_Sha3_384_GetHash

int wc_Sha3_384_GetHash(
    wc_Sha3 * sha3,
    byte * hash
)

ハッシュデータを取得します。結果はhashに格納されます。sha3構造体の状態をリセットしません。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Sha3_384Hash
• wc_Sha3_384_Final
• wc_InitSha3_384
• wc_Sha3_384_Copy

Return: 0 ハッシュのコピーに成功した場合に返されます。

Example

wc_Sha3 sha3[1];
if ((ret = wc_InitSha3_384(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_38384ailed");
}
else {
   wc_Sha3_384_Update(sha3, data, len);
   wc_Sha3_384_GetHash(sha3, hash);
}

function wc_Sha3_384_Copy

int wc_Sha3_384_Copy(
    wc_Sha3 * sha3,
    wc_Sha3 * dst
)

ハッシュの状態をコピーします。

Parameters:

• sha3 コピーするsha3構造体へのポインタ
• dst コピー先のsha3構造体へのポインタ

See:

• wc_Sha3_384Hash
• wc_Sha3_384_Final
• wc_InitSha3_384
• wc_Sha3_384_GetHash

Return: 0 コピーに成功した場合に返されます。

Example

wc_Sha3 sha3[1];
wc_Sha3 sha3_dup[1];
if ((ret = wc_InitSha3_384(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_384 failed");
}
else {
   wc_Sha3_384_Update(sha3, data, len);
   wc_Sha3_384_Copy(sha3, sha3_dup);
}

function wc_InitSha3_512

int wc_InitSha3_512(
    wc_Sha3 * sha3,
    void * heap,
    int devId
)

この関数はSHA3-512を初期化します。これはwc_Sha3_512Hashによって自動的に呼び出されます。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ

See:

• wc_Sha3_512Hash
• wc_Sha3_512_Update
• wc_Sha3_512_Final

Return: 0 初期化に成功した場合に返されます

Example

wc_Sha3 sha3[1];
if ((ret = wc_InitSha3_512(sha3, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitSha3_512 failed");
}
else {
    wc_Sha3_512_Update(sha3, data, len);
    wc_Sha3_512_Final(sha3, hash);
}

function wc_Sha3_512_Update

int wc_Sha3_512_Update(
    wc_Sha3 * sha,
    const byte * data,
    word32 len
)

長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• data ハッシュ化されるデータ
• len ハッシュ化されるデータの長さ

See:

• wc_Sha3_512Hash
• wc_Sha3_512_Final
• wc_InitSha3_512

Return: 0 ダイジェストへのデータの追加に成功した場合に返されます。

Example

wc_Sha3 sha3[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_512(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_512 failed");
}
else {
    wc_Sha3_512_Update(sha3, data, len);
    wc_Sha3_512_Final(sha3, hash);
}

function wc_Sha3_512_Final

int wc_Sha3_512_Final(
    wc_Sha3 * sha3,
    byte * hash
)

データのハッシュ化を完了します。結果はhashに格納されます。sha3構造体の状態をリセットします。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Sha3_512Hash
• wc_Sha3_512_GetHash
• wc_InitSha3_512

Return: 0 完了に成功した場合に返されます。

Example

wc_Sha3 sha3[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_512(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_512 failed");
}
else {
   wc_Sha3_512_Update(sha3, data, len);
   wc_Sha3_512_Final(sha3, hash);
}

function wc_Sha3_512_Free

void wc_Sha3_512_Free(
    wc_Sha3 * 
)

wc_Sha3構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。

Parameters:

• sha3 解放されるsha3構造体へのポインタ。

See:

• wc_InitSha3_512
• wc_Sha3_512_Update
• wc_Sha3_512_Final

Return: none 戻り値なし。

Example

wc_Sha3 sha3;
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitSha3_512(&sha3, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitSha3_512 failed");
}
else {
    wc_Sha3_512_Update(&sha3, data, len);
    wc_Sha3_512_Final(&sha3, hash);
    wc_Sha3_512_Free(&sha3);
}

function wc_Sha3_512_GetHash

int wc_Sha3_512_GetHash(
    wc_Sha3 * sha3,
    byte * hash
)

ハッシュデータを取得します。結果はhashに格納されます。sha3構造体の状態をリセットしません。

Parameters:

• sha3 暗号化に使用するsha3構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Sha3_512Hash
• wc_Sha3_512_Final
• wc_InitSha3_512
• wc_Sha3_512_Copy

Return: 0 ハッシュのコピーに成功した場合に返されます。

Example

wc_Sha3 sha3[1];
if ((ret = wc_InitSha3_512(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_512 failed");
}
else {
   wc_Sha3_512_Update(sha3, data, len);
   wc_Sha3_512_GetHash(sha3, hash);
}

function wc_Sha3_512_Copy

int wc_Sha3_512_Copy(
    wc_Sha3 * sha3,
    wc_Sha3 * dst
)

ハッシュの状態をコピーします。

Parameters:

• sha3 コピーするsha3構造体へのポインタ
• dst コピー先のsha3構造体へのポインタ

See:

• wc_Sha3_512Hash
• wc_Sha3_512_Final
• wc_InitSha3_512
• wc_Sha3_512_GetHash

Return: 0 コピーに成功した場合に返されます。

Example

wc_Sha3 sha3[1];
wc_Sha3 sha3_dup[1];
if ((ret = wc_InitSha3_512(sha3, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitSha3_512 failed");
}
else {
   wc_Sha3_512_Update(sha3, data, len);
   wc_Sha3_512_Copy(sha3, sha3_dup);
}

function wc_InitShake128

int wc_InitShake128(
    wc_Shake * shake,
    void * heap,
    int devId
)

この関数はSHAKE-128を初期化します。これはwc_Shake128Hashによって自動的に呼び出されます。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ

See:

• wc_Shake128Hash
• wc_Shake128_Update
• wc_Shake128_Final

Return: 0 初期化に成功した場合に返されます

Example

wc_Shake shake[1];
if ((ret = wc_InitShake128(shake, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitShake128 failed");
}
else {
    wc_Shake128_Update(shake, data, len);
    wc_Shake128_Final(shake, hash);
}

function wc_Shake128_Update

int wc_Shake128_Update(
    wc_Shake * sha,
    const byte * data,
    word32 len
)

長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ
• data ハッシュ化されるデータ
• len ハッシュ化されるデータの長さ

See:

• wc_Shake128Hash
• wc_Shake128_Final
• wc_InitShake128

Return: 0 ダイジェストへのデータの追加に成功した場合に返されます。

Example

wc_Shake shake[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitShake128(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake128 failed");
}
else {
    wc_Shake128_Update(shake, data, len);
    wc_Shake128_Final(shake, hash);
}

function wc_Shake128_Final

int wc_Shake128_Final(
    wc_Shake * shake,
    byte * hash
)

データのハッシュ化を完了します。結果はhashに格納されます。shake構造体の状態をリセットします。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Shake128Hash
• wc_Shake128_GetHash
• wc_InitShake128

Return: 0 完了に成功した場合に返されます。

Example

wc_Shake shake[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitShake128(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake128 failed");
}
else {
   wc_Shake128_Update(shake, data, len);
   wc_Shake128_Final(shake, hash);
}

function wc_Shake128_Absorb

int wc_Shake128_Absorb(
    wc_Shake * sha,
    const byte * data,
    word32 len
)

長さlenの提供されたバイト配列を吸収するために呼び出されます。段階的に呼び出すことはできません。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ
• data 吸収されるデータ
• len 吸収されるデータの長さ

See:

• wc_Shake128_SqueezeBlocks
• wc_InitShake128

Return: 0 データの吸収に成功した場合に返されます。

Example

wc_Shake shake[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);
byte out[2 * WC_SHA3_128_BLOCK_SIZE];
int blocks = 2;

if ((ret = wc_InitShake128(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake128 failed");
}
else {
   wc_Shake128_Absorb(shake, data, len);
   wc_Shake128_SqueezeBlocks(shake, out, blocks);
}

function wc_Shake128_SqueezeBlocks

int wc_Shake128_SqueezeBlocks(
    wc_Shake * shake,
    byte * out,
    word32 blockCnt
)

さらに多くのデータブロックを絞り出します。結果はoutに格納されます。段階的に呼び出すことができます。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ
• hash 出力を保持するバイト配列。
• blocks 絞り出すブロックの数。各ブロックはWC_SHA3_128_BLOCK_SIZEバイトの長さです。

See:

• wc_Shake128_Absorb
• wc_InitShake128

Return: 0 絞り出しに成功した場合に返されます。

Example

wc_Shake shake[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);
byte out[2 * WC_SHA3_128_BLOCK_SIZE];
int blocks = 2;

if ((ret = wc_InitShake128(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake128 failed");
}
else {
   wc_Shake128_Absorb(shake, data, len);
   wc_Shake128_SqueezeBlocks(shake, out, blocks);
}

function wc_Shake128_Free

void wc_Shake128_Free(
    wc_Shake * 
)

wc_Shake構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。

Parameters:

• shake 解放されるshake構造体へのポインタ。

See:

• wc_InitShake128
• wc_Shake128_Update
• wc_Shake128_Final

Return: none 戻り値なし。

Example

wc_Shake shake;
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitShake128(&shake, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitShake128 failed");
}
else {
    wc_Shake128_Update(&shake, data, len);
    wc_Shake128_Final(&shake, hash);
    wc_Shake128_Free(&shake);
}

function wc_Shake128_GetHash

int wc_Shake128_GetHash(
    wc_Shake * shake,
    byte * hash
)

ハッシュデータを取得します。結果はhashに格納されます。shake構造体の状態をリセットしません。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Shake128Hash
• wc_Shake128_Final
• wc_InitShake128
• wc_Shake128_Copy

Return: 0 ハッシュのコピーに成功した場合に返されます。

Example

wc_Shake shake[1];
if ((ret = wc_InitShake128(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake128 failed");
}
else {
   wc_Shake128_Update(shake, data, len);
   wc_Shake128_GetHash(shake, hash);
}

function wc_Shake128_Copy

int wc_Shake128_Copy(
    wc_Shake * shake,
    wc_Shake * dst
)

ハッシュの状態をコピーします。

Parameters:

• shake コピーするshake構造体へのポインタ
• dst コピー先のshake構造体へのポインタ

See:

• wc_Shake128Hash
• wc_Shake128_Final
• wc_InitShake128
• wc_Shake128_GetHash

Return: 0 コピーに成功した場合に返されます。

Example

wc_Shake shake[1];
wc_Shake shake_dup[1];
if ((ret = wc_InitShake128(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake128 failed");
}
else {
   wc_Shake128_Update(shake, data, len);
   wc_Shake128_Copy(shake, shake_dup);
}

function wc_InitShake256

int wc_InitShake256(
    wc_Shake * shake,
    void * heap,
    int devId
)

この関数はSHAKE-256を初期化します。これはwc_Shake256Hashによって自動的に呼び出されます。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ

See:

• wc_Shake256Hash
• wc_Shake256_Update
• wc_Shake256_Final

Return: 0 初期化に成功した場合に返されます

Example

wc_Shake shake[1];
if ((ret = wc_InitShake256(shake, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitShake256 failed");
}
else {
    wc_Shake256_Update(shake, data, len);
    wc_Shake256_Final(shake, hash, sizeof(hash));
}

function wc_Shake256_Update

int wc_Shake256_Update(
    wc_Shake * sha,
    const byte * data,
    word32 len
)

長さlenのバイト配列を継続的にハッシュ化するために呼び出すことができます。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ
• data ハッシュ化されるデータ
• len ハッシュ化されるデータの長さ

See:

• wc_Shake256Hash
• wc_Shake256_Final
• wc_InitShake256

Return: 0 ダイジェストへのデータの追加に成功した場合に返されます。

Example

wc_Shake shake[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitShake256(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake256 failed");
}
else {
    wc_Shake256_Update(shake, data, len);
    wc_Shake256_Final(shake, hash, sizeof(hash));
}

function wc_Shake256_Final

int wc_Shake256_Final(
    wc_Shake * shake,
    byte * hash,
    word32 hashLen
)

データのハッシュ化を完了します。結果はhashに格納されます。shake構造体の状態をリセットします。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。
• hashLen ハッシュのサイズ（バイト単位）。

See:

• wc_Shake256Hash
• wc_Shake256_GetHash
• wc_InitShake256

Return: 0 完了に成功した場合に返されます。

Example

wc_Shake shake[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitShake256(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake256 failed");
}
else {
   wc_Shake256_Update(shake, data, len);
   wc_Shake256_Final(shake, hash, sizeof(hash));
}

function wc_Shake256_Absorb

int wc_Shake256_Absorb(
    wc_Shake * sha,
    const byte * data,
    word32 len
)

長さlenの提供されたバイト配列を吸収するために呼び出されます。段階的に呼び出すことはできません。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ
• data 吸収されるデータ
• len 吸収されるデータの長さ

See:

• wc_Shake256_SqueezeBlocks
• wc_InitShake256

Return: 0 データの吸収に成功した場合に返されます。

Example

wc_Shake shake[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);
byte out[2 * WC_SHA3_256_BLOCK_SIZE];
int blocks = 2;

if ((ret = wc_InitShake256(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake256 failed");
}
else {
   wc_Shake256_Absorb(shake, data, len);
   wc_Shake256_SqueezeBlocks(shake, out, blocks);
}

function wc_Shake256_SqueezeBlocks

int wc_Shake256_SqueezeBlocks(
    wc_Shake * shake,
    byte * out,
    word32 blockCnt
)

さらに多くのデータブロックを絞り出します。結果はoutに格納されます。段階的に呼び出すことができます。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ
• hash 出力を保持するバイト配列。
• blocks 絞り出すブロックの数。各ブロックはWC_SHA3_256_BLOCK_SIZEバイトの長さです。

See:

• wc_Shake256_Absorb
• wc_InitShake256

Return: 0 絞り出しに成功した場合に返されます。

Example

wc_Shake shake[1];
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);
byte out[2 * WC_SHA3_256_BLOCK_SIZE];
int blocks = 2;

if ((ret = wc_InitShake256(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake256 failed");
}
else {
   wc_Shake256_Absorb(shake, data, len);
   wc_Shake256_SqueezeBlocks(shake, out, blocks);
}

function wc_Shake256_Free

void wc_Shake256_Free(
    wc_Shake * 
)

wc_Shake構造体をリセットします。注：これはWOLFSSL_TI_HASHが定義されている場合のみサポートされます。

Parameters:

• shake 解放されるshake構造体へのポインタ。

See:

• wc_InitShake256
• wc_Shake256_Update
• wc_Shake256_Final

Return: none 戻り値なし。

Example

wc_Shake shake;
byte data[] = { ハッシュ化されるデータ };
word32 len = sizeof(data);

if ((ret = wc_InitShake256(&shake, NULL, INVALID_DEVID)) != 0) {
    WOLFSSL_MSG("wc_InitShake256 failed");
}
else {
    wc_Shake256_Update(&shake, data, len);
    wc_Shake256_Final(&shake, hash, sizeof(hash));
    wc_Shake256_Free(&shake);
}

function wc_Shake256_GetHash

int wc_Shake256_GetHash(
    wc_Shake * shake,
    byte * hash
)

ハッシュデータを取得します。結果はhashに格納されます。shake構造体の状態をリセットしません。

Parameters:

• shake 暗号化に使用するshake構造体へのポインタ
• hash ハッシュ値を保持するバイト配列。

See:

• wc_Shake256Hash
• wc_Shake256_Final
• wc_InitShake256
• wc_Shake256_Copy

Return: 0 ハッシュのコピーに成功した場合に返されます。

Example

wc_Shake shake[1];
if ((ret = wc_InitShake256(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake256 failed");
}
else {
   wc_Shake256_Update(shake, data, len);
   wc_Shake256_GetHash(shake, hash);
}

function wc_Shake256_Copy

int wc_Shake256_Copy(
    wc_Shake * shake,
    wc_Shake * dst
)

ハッシュの状態をコピーします。

Parameters:

• shake コピーするshake構造体へのポインタ
• dst コピー先のshake構造体へのポインタ

See:

• wc_Shake256Hash
• wc_Shake256_Final
• wc_InitShake256
• wc_Shake256_GetHash

Return: 0 コピーに成功した場合に返されます。

Example

wc_Shake shake[1];
wc_Shake shake_dup[1];
if ((ret = wc_InitShake256(shake, NULL, INVALID_DEVID)) != 0) {
   WOLFSSL_MSG("wc_InitShake256 failed");
}
else {
   wc_Shake256_Update(shake, data, len);
   wc_Shake256_Copy(shake, shake_dup);
}

Source code

int wc_InitSha3_224(wc_Sha3* sha3, void* heap, int devId);

int wc_Sha3_224_Update(wc_Sha3* sha, const byte* data, word32 len);

int wc_Sha3_224_Final(wc_Sha3* sha3, byte* hash);

void wc_Sha3_224_Free(wc_Sha3*);

int wc_Sha3_224_GetHash(wc_Sha3* sha3, byte* hash);

int wc_Sha3_224_Copy(wc_Sha3* sha3, wc_Sha3* dst);

int wc_InitSha3_256(wc_Sha3* sha3, void* heap, int devId);

int wc_Sha3_256_Update(wc_Sha3* sha, const byte* data, word32 len);

int wc_Sha3_256_Final(wc_Sha3* sha3, byte* hash);

void wc_Sha3_256_Free(wc_Sha3*);

int wc_Sha3_256_GetHash(wc_Sha3* sha3, byte* hash);

int wc_Sha3_256_Copy(wc_Sha3* sha3, wc_Sha3* dst);

int wc_InitSha3_384(wc_Sha3* sha3, void* heap, int devId);

int wc_Sha3_384_Update(wc_Sha3* sha, const byte* data, word32 len);

int wc_Sha3_384_Final(wc_Sha3* sha3, byte* hash);

void wc_Sha3_384_Free(wc_Sha3*);

int wc_Sha3_384_GetHash(wc_Sha3* sha3, byte* hash);

int wc_Sha3_384_Copy(wc_Sha3* sha3, wc_Sha3* dst);

int wc_InitSha3_512(wc_Sha3* sha3, void* heap, int devId);

int wc_Sha3_512_Update(wc_Sha3* sha, const byte* data, word32 len);

int wc_Sha3_512_Final(wc_Sha3* sha3, byte* hash);

void wc_Sha3_512_Free(wc_Sha3*);

int wc_Sha3_512_GetHash(wc_Sha3* sha3, byte* hash);

int wc_Sha3_512_Copy(wc_Sha3* sha3, wc_Sha3* dst);

int wc_InitShake128(wc_Shake* shake, void* heap, int devId);

int wc_Shake128_Update(wc_Shake* sha, const byte* data, word32 len);

int wc_Shake128_Final(wc_Shake* shake, byte* hash);

int wc_Shake128_Absorb(wc_Shake* sha, const byte* data, word32 len);

int wc_Shake128_SqueezeBlocks(wc_Shake* shake, byte* out, word32 blockCnt);

void wc_Shake128_Free(wc_Shake*);

int wc_Shake128_GetHash(wc_Shake* shake, byte* hash);

int wc_Shake128_Copy(wc_Shake* shake, wc_Shake* dst);

int wc_InitShake256(wc_Shake* shake, void* heap, int devId);

int wc_Shake256_Update(wc_Shake* sha, const byte* data, word32 len);

int wc_Shake256_Final(wc_Shake* shake, byte* hash, word32 hashLen);

int wc_Shake256_Absorb(wc_Shake* sha, const byte* data, word32 len);

int wc_Shake256_SqueezeBlocks(wc_Shake* shake, byte* out, word32 blockCnt);

void wc_Shake256_Free(wc_Shake*);

int wc_Shake256_GetHash(wc_Shake* shake, byte* hash);

int wc_Shake256_Copy(wc_Shake* shake, wc_Shake* dst);

---

Updated on 2025-12-12 at 03:08:17 +0000