agb 0.23.1

Library for Game Boy Advance Development
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

use core::fmt::Arguments;

use crate::mgba::{DebugLevel, Mgba};

#[doc(hidden)]
pub fn println(args: Arguments) {
    if let Some(mut mgba) = Mgba::new() {
        let _ = mgba.print(args, DebugLevel::Info);
    }
}

#[doc(hidden)]
pub fn eprintln(args: Arguments) {
    if let Some(mut mgba) = Mgba::new() {
        let _ = mgba.print(args, DebugLevel::Error);
    }
}

/// Works like [`std::println`](https://doc.rust-lang.org/stable/std/macro.println.html).
///
/// Prints to the standard output when running under the mgba emulator.
/// This is mainly useful for debugging, and is reasonably slow.
///
/// ```rust
/// # #![no_std]
/// # #![no_main]
/// # #[agb::doctest]
/// # fn test(_: agb::Gba) {
/// agb::println!("Hello, World!");
///
/// let variable = 5;
/// agb::println!("format {variable} argument");
/// # }
/// ```
#[macro_export]
macro_rules! println {
    ($( $x:expr ),*) => {
        $crate::print::println(format_args!($($x,)*))
    };
}

/// Works like [`std::eprintln`](https://doc.rust-lang.org/stable/std/macro.eprintln.html).
///
/// Prints to the standard output when running under the mgba emulator but with the error level internally
/// This is mainly intended for debugging, and is reasonably slow.
///
/// ```rust
/// # #![no_std]
/// # #![no_main]
/// #
/// # #[agb::doctest]
/// # fn test(_: agb::Gba) {
/// agb::eprintln!("error: Could not load save file");
/// # }
/// ```
#[macro_export]
macro_rules! eprintln {
    ($( $x:expr ),*) => {
        $crate::print::eprintln(format_args!($($x,)*))
    };
}