为什么 Piston text() 需要对字形缓存的可变引用?

Why does Piston text() require a mutable reference to the glyph cache?

我很好奇为什么 text() 需要 mutable 借用字形缓存:

cache: &mut C

我的理解是字形缓存表示从字体文件加载的静态字符(字形)。为什么这些需要能够被底层图形系统改变?

因为如果您按照 Text 的代码一直往下看,它会 appears that it loads each character on demand on a per-font-size basis。如果你要求它提供一个它没有缓存的大小的字符,它会加载它——这需要一个可变引用来修改它的内部状态。真的,这是它使用 entry API 的第一部分 - 这需要一个可变引用:fn entry(&mut self, key: K) -> Entry<K, V>

尽管有问题的代码:

impl<'a> graphics::character::CharacterCache for GlyphCache<'a> {
    type Texture = Texture;

    fn character(&mut self, size: FontSize, ch: char) -> &Character {
        match {
            match self.data.entry(size) { // <----- BAM!
                Vacant(entry) => entry.insert(HashMap::new()), 
                Occupied(entry) => entry.into_mut(),
            }
        }.contains_key(&ch) {
            true => &self.data[&size][&ch],
            false => { self.load_character(size, ch); &self.data[&size][&ch] }
            // ^^^^ BAM!
        }
    }
}