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 // Deprecated: use the interface in crypto/hash.h instead. 24 // TODO(https://issues.chromium.org/issues/374310081): Delete these. 25 26 static const size_t kSHA256Length = 32; // Length in bytes of a SHA-256 hash. 27 28 // Computes the SHA-256 hash of |input|. 29 CRYPTO_EXPORT std::array<uint8_t, kSHA256Length> SHA256Hash( 30 base::span<const uint8_t> input); 31 32 // Convenience version of the above that returns the result in a 32-byte 33 // string. 34 CRYPTO_EXPORT std::string SHA256HashString(std::string_view str); 35 36 // Computes the SHA-256 hash of the input string 'str' and stores the first 37 // 'len' bytes of the hash in the output buffer 'output'. If 'len' > 32, 38 // only 32 bytes (the full hash) are stored in the 'output' buffer. 39 CRYPTO_EXPORT void SHA256HashString(std::string_view str, 40 void* output, 41 size_t len); 42 43 } // namespace crypto 44 45 #endif // CRYPTO_SHA2_H_ 46