crypto/sha2.h

   1 // Copyright 2012 The Chromium Authors
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CRYPTO_SHA2_H_
   6 #define CRYPTO_SHA2_H_
   7
   8 #include <stddef.h>
   9
  10 #include <array>
  11 #include <string>
  12 #include <string_view>
  13
  14 #include "base/containers/span.h"
  15 #include "crypto/crypto_export.h"
  16
  17 namespace crypto {
  18
  19 // These functions perform SHA-256 operations.
  20 //
  21 // Functions for SHA-384 and SHA-512 can be added when the need arises.
  22
  23 static const size_t kSHA256Length = 32;  // Length in bytes of a SHA-256 hash.
  24
  25 // Computes the SHA-256 hash of |input|.
  26 CRYPTO_EXPORT std::array<uint8_t, kSHA256Length> SHA256Hash(
  27     base::span<const uint8_t> input);
  28
  29 // Convenience version of the above that returns the result in a 32-byte
  30 // string.
  31 CRYPTO_EXPORT std::string SHA256HashString(std::string_view str);
  32
  33 // Computes the SHA-256 hash of the input string 'str' and stores the first
  34 // 'len' bytes of the hash in the output buffer 'output'.  If 'len' > 32,
  35 // only 32 bytes (the full hash) are stored in the 'output' buffer.
  36 CRYPTO_EXPORT void SHA256HashString(std::string_view str,
  37                                     void* output,
  38                                     size_t len);
  39
  40 }  // namespace crypto
  41
  42 #endif  // CRYPTO_SHA2_H_