src/user-defined-types/const.md
constConstants are evaluated at compile time and their values are inlined wherever they are used:
<!-- mdbook-xgettext: skip --># // Copyright 2024 Google LLC
# // SPDX-License-Identifier: Apache-2.0
#
const DIGEST_SIZE: usize = 3;
const FILL_VALUE: u8 = calculate_fill_value();
const fn calculate_fill_value() -> u8 {
if DIGEST_SIZE < 10 { 42 } else { 13 }
}
fn compute_digest(text: &str) -> [u8; DIGEST_SIZE] {
let mut digest = [FILL_VALUE; DIGEST_SIZE];
for (idx, &b) in text.as_bytes().iter().enumerate() {
digest[idx % DIGEST_SIZE] = digest[idx % DIGEST_SIZE].wrapping_add(b);
}
digest
}
fn main() {
let digest = compute_digest("Hello");
println!("digest: {digest:?}");
}
Only functions marked const can be called at compile time to generate const
values. const functions can however be called at runtime.
const behaves semantically similar to C++'s constexpr