Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.
libnotcurses-sys
is a low-level Rust wrapper for the
notcurses C library
It is built with several layers of zero-overhead abstractions over the C functions and pointers accessed through FFI.
It adds greater safety and type correctness over the underlying C library API, while trying to remain very close to it.
It offers the choice of using it more like Rust and/or more like C.
notcurses : C library
libnotcurses-sys ← : C⇄Rust bridge library *(you are here)*
notcurses-rs : Rust library
like Rust
Where you use the more safely wrapped types, with its methods and constructors,
and error handling with the NcResult
enum:
use *;
The Drop
trait is not implemented for any wrapping type in this library.
This means you still have to manually call the stop()
method for Nc
and NcDirect
objects, and the destroy()
method for the rest of types that
allocate, (like NcPlane
, NcMenu
…) at the end of their scope, since the
But they do implement methods and use NcResult
as the return type,
for handling errors in the way we are used to in Rust.
For the types that don't allocate, most are based on primitives like i32
,
u32
, u64
… without a name in the C library. In Rust they are type aliased
(e.g.: NcChannel
, NcChannelPair
, NcRgb
, NcColor
…), to
leverage type checking, and they implement methods through traits
(e.g. NcChannelMethods
must be in scope to use the NcChannel
methods.
even more like Rust
The WIP sister crate
notcurses
will eventually
offer a closer to Rust, higher-level, safer, and simpler API, and make it
easier to interoperate with the rest of the Rust ecosystem.
like C
You can access the imported, or reimplemented C API functions directly, and use it in a very similar way as the C library is used.
It requires the use of unsafe, since most functions are wrapped directly
by bindgen
marked as such.
Error handling is done this way by checking the returned NcIntResult
,
or in case of receiving a pointer, by comparing it to null_mut()
.
Example
use ;
use exit;
use c_api::*;