narust-158 0.3.1

A Rust reimplementation of OpenNARS 1.5.8
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

//! 🎯复刻OpenNARS `nars.io.InputChannel`
//!

use super::Channel;
use navm::cmd::Cmd;

/// 模拟`InputChannel`
/// * 🆕✨采用「返回NAVM指令」的形式
///   * 💭【2024-05-13 00:55:15】此举相当于在编程上统一了IO模型
///
/// # 📄OpenNARS
///
/// An interface to be implemented in all input channels
/// to get the input for the next moment from an input channel
pub trait InputChannel: Channel {
    /// 模拟`InputChannel.nextInput`
    /// * ⚠️看似「不可变」，实际上**有副作用**
    ///   * 📝OpenNARS中的实现[`ExperienceReader`]持有推理器引用，会由此改变推理器
    ///   * ❓【2024-05-13 00:01:07】后续是否要改变这种模式
    /// * 🆕🚩鉴于OpenNARS中「请求输入」的作用，现消去其对推理器的副作用
    ///   * 📌对推理器的「输入呈递」从「自推理器（循环）引用直接传递」改为「函数返回值」
    ///   * 📌这个「呈递的输入」以「[NAVM指令](navm::cmd::Cmd)数组」的形式给出
    /// * 🆕引入新的「推理器」参数（只读），
    ///   * 🎯以便后续在「解析生成NAVM指令」时结合「推理器状态」与「记忆区」
    /// * ❌因为避免「对象不安全」，不再提供对「推理器」的引用
    ///   * 📄可参照[`super::OutputChannel`]
    ///
    /// # 📄OpenNARS
    ///
    /// @return value indicating whether the reasoner should run
    fn next_input(&mut self /* , reasoner: &Self::Reasoner */) -> (bool, Vec<Cmd>);
}