mirror of
https://github.com/sunface/rust-by-practice.git
synced 2025-06-23 12:39:42 +00:00
deploy
This commit is contained in:
sunface
487
generics-traits/advanced-traits.html
Normal file
487
generics-traits/advanced-traits.html
Normal file
@ -0,0 +1,487 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="light sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Advanced Traits - Rust By Practice</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta name="description" content="Learn Rust with Example, Exercise and real Practice, written with ❤️ by https://course.rs team">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="../favicon.svg">
|
||||
<link rel="shortcut icon" href="../favicon.png">
|
||||
<link rel="stylesheet" href="../css/variables.css">
|
||||
<link rel="stylesheet" href="../css/general.css">
|
||||
<link rel="stylesheet" href="../css/chrome.css">
|
||||
<link rel="stylesheet" href="../css/print.css" media="print">
|
||||
|
||||
<!-- Fonts -->
|
||||
<link rel="stylesheet" href="../FontAwesome/css/font-awesome.css">
|
||||
<link rel="stylesheet" href="../fonts/fonts.css">
|
||||
|
||||
<!-- Highlight.js Stylesheets -->
|
||||
<link rel="stylesheet" id="highlight-css" href="../highlight.css">
|
||||
<link rel="stylesheet" id="tomorrow-night-css" href="../tomorrow-night.css">
|
||||
<link rel="stylesheet" id="ayu-highlight-css" href="../ayu-highlight.css">
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="../theme/style1.css">
|
||||
|
||||
|
||||
<!-- Provide site root and default themes to javascript -->
|
||||
<script>
|
||||
const path_to_root = "../";
|
||||
const default_light_theme = "light";
|
||||
const default_dark_theme = "navy";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="../toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script>
|
||||
try {
|
||||
let theme = localStorage.getItem('mdbook-theme');
|
||||
let sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
|
||||
if (theme.startsWith('"') && theme.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-theme', theme.slice(1, theme.length - 1));
|
||||
}
|
||||
|
||||
if (sidebar.startsWith('"') && sidebar.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-sidebar', sidebar.slice(1, sidebar.length - 1));
|
||||
}
|
||||
} catch (e) { }
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script>
|
||||
const default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? default_dark_theme : default_light_theme;
|
||||
let theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('light')
|
||||
html.classList.add(theme);
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script>
|
||||
let sidebar = null;
|
||||
const sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="../toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="default_theme">Auto</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
</ul>
|
||||
<button id="search-toggle" class="icon-button" type="button" title="Search. (Shortkey: s)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="S" aria-controls="searchbar">
|
||||
<i class="fa fa-search"></i>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Rust By Practice</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="../print.html" title="Print this book" aria-label="Print this book">
|
||||
<i id="print-button" class="fa fa-print"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice" title="Git repository" aria-label="Git repository">
|
||||
<i id="git-repository-button" class="fa fa-github"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice/edit/master/en/src/generics-traits/advanced-traits.md" title="Suggest an edit" aria-label="Suggest an edit">
|
||||
<i id="git-edit-button" class="fa fa-edit"></i>
|
||||
</a>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="search-wrapper" class="hidden">
|
||||
<form id="searchbar-outer" class="searchbar-outer">
|
||||
<input type="search" id="searchbar" name="searchbar" placeholder="Search this book ..." aria-controls="searchresults-outer" aria-describedby="searchresults-header">
|
||||
</form>
|
||||
<div id="searchresults-outer" class="searchresults-outer hidden">
|
||||
<div id="searchresults-header" class="searchresults-header"></div>
|
||||
<ul id="searchresults">
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
link.setAttribute('tabIndex', sidebar === 'visible' ? 0 : -1);
|
||||
});
|
||||
</script>
|
||||
|
||||
<div id="content" class="content">
|
||||
<main>
|
||||
<h1 id="advance-traits"><a class="header" href="#advance-traits">Advance Traits</a></h1>
|
||||
<h2 id="associated-types"><a class="header" href="#associated-types">Associated types</a></h2>
|
||||
<p>The use of "Associated types" improves the overall readability of code by moving inner types locally into a trait as output types. For example :</p>
|
||||
<pre><pre class="playground"><code class="language-rust edition2021"><span class="boring">#![allow(unused)]
|
||||
</span><span class="boring">fn main() {
|
||||
</span>pub trait CacheableItem: Clone + Default + fmt::Debug + Decodable + Encodable {
|
||||
type Address: AsRef<[u8]> + Clone + fmt::Debug + Eq + Hash;
|
||||
fn is_null(&self) -> bool;
|
||||
}
|
||||
<span class="boring">}</span></code></pre></pre>
|
||||
<p>Using of <code>Address</code> is much more clearer and convenient than <code>AsRef<[u8]> + Clone + fmt::Debug + Eq + Hash</code>.</p>
|
||||
<ol>
|
||||
<li>🌟🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
struct Container(i32, i32);
|
||||
|
||||
// USING associated types to re-implement trait Contains.
|
||||
// trait Contains {
|
||||
// type A;
|
||||
// type B;
|
||||
|
||||
trait Contains<A, B> {
|
||||
fn contains(&self, _: &A, _: &B) -> bool;
|
||||
fn first(&self) -> i32;
|
||||
fn last(&self) -> i32;
|
||||
}
|
||||
|
||||
impl Contains<i32, i32> for Container {
|
||||
fn contains(&self, number_1: &i32, number_2: &i32) -> bool {
|
||||
(&self.0 == number_1) && (&self.1 == number_2)
|
||||
}
|
||||
// Grab the first number.
|
||||
fn first(&self) -> i32 { self.0 }
|
||||
|
||||
// Grab the last number.
|
||||
fn last(&self) -> i32 { self.1 }
|
||||
}
|
||||
|
||||
fn difference<A, B, C: Contains<A, B>>(container: &C) -> i32 {
|
||||
container.last() - container.first()
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let number_1 = 3;
|
||||
let number_2 = 10;
|
||||
|
||||
let container = Container(number_1, number_2);
|
||||
|
||||
println!("Does container contain {} and {}: {}",
|
||||
&number_1, &number_2,
|
||||
container.contains(&number_1, &number_2));
|
||||
println!("First number: {}", container.first());
|
||||
println!("Last number: {}", container.last());
|
||||
|
||||
println!("The difference is: {}", difference(&container));
|
||||
}</code></pre></pre>
|
||||
<h2 id="default-generic-type-parameters"><a class="header" href="#default-generic-type-parameters">Default Generic Type Parameters</a></h2>
|
||||
<p>When we use generic type parameters, we can specify a default concrete type for the generic type. This eliminates the need for implementors of the trait to specify a concrete type if the default type works.</p>
|
||||
<ol start="2">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
use std::ops::Sub;
|
||||
|
||||
#[derive(Debug, PartialEq)]
|
||||
struct Point<T> {
|
||||
x: T,
|
||||
y: T,
|
||||
}
|
||||
|
||||
// FILL in the blank in three ways: two of them use the default generic parameters, the other one not.
|
||||
// Notice that the implementation uses the associated type `Output`.
|
||||
impl __ {
|
||||
type Output = Self;
|
||||
|
||||
fn sub(self, other: Self) -> Self::Output {
|
||||
Point {
|
||||
x: self.x - other.x,
|
||||
y: self.y - other.y,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
assert_eq!(Point { x: 2, y: 3 } - Point { x: 1, y: 0 },
|
||||
Point { x: 1, y: 3 });
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<h2 id="fully-qualified-syntax"><a class="header" href="#fully-qualified-syntax">Fully Qualified Syntax</a></h2>
|
||||
<p>Nothing in Rust prevents a trait from having a method with the same name as another trait’s method, nor does Rust prevent you from implementing both traits on one type. It’s also possible to implement a method directly on the type with the same name as methods from traits.</p>
|
||||
<p>When calling methods with the same name, we have to use Fully Qualified Syntax.</p>
|
||||
<h4 id="example"><a class="header" href="#example">Example</a></h4>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">trait UsernameWidget {
|
||||
// Get the selected username out of this widget
|
||||
fn get(&self) -> String;
|
||||
}
|
||||
|
||||
trait AgeWidget {
|
||||
// Get the selected age out of this widget
|
||||
fn get(&self) -> u8;
|
||||
}
|
||||
|
||||
// A form with both a UsernameWidget and an AgeWidget.
|
||||
struct Form {
|
||||
username: String,
|
||||
age: u8,
|
||||
}
|
||||
|
||||
impl UsernameWidget for Form {
|
||||
fn get(&self) -> String {
|
||||
self.username.clone()
|
||||
}
|
||||
}
|
||||
|
||||
impl AgeWidget for Form {
|
||||
fn get(&self) -> u8 {
|
||||
self.age
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let form = Form{
|
||||
username: "rustacean".to_owned(),
|
||||
age: 28,
|
||||
};
|
||||
|
||||
// If you uncomment this line, you'll get an error saying
|
||||
// "multiple `get` found". Because, after all, there are multiple methods
|
||||
// named `get`.
|
||||
// println!("{}", form.get());
|
||||
|
||||
let username = UsernameWidget::get(&form);
|
||||
assert_eq!("rustacean".to_owned(), username);
|
||||
let age = AgeWidget::get(&form); // You can also use `<Form as AgeWidget>::get`
|
||||
assert_eq!(28, age);
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<h4 id="exercise"><a class="header" href="#exercise">Exercise</a></h4>
|
||||
<ol start="3">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">trait Pilot {
|
||||
fn fly(&self) -> String;
|
||||
}
|
||||
|
||||
trait Wizard {
|
||||
fn fly(&self) -> String;
|
||||
}
|
||||
|
||||
struct Human;
|
||||
|
||||
impl Pilot for Human {
|
||||
fn fly(&self) -> String {
|
||||
String::from("This is your captain speaking.")
|
||||
}
|
||||
}
|
||||
|
||||
impl Wizard for Human {
|
||||
fn fly(&self) -> String {
|
||||
String::from("Up!")
|
||||
}
|
||||
}
|
||||
|
||||
impl Human {
|
||||
fn fly(&self) -> String {
|
||||
String::from("*waving arms furiously*")
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let person = Human;
|
||||
|
||||
assert_eq!(__, "This is your captain speaking.");
|
||||
assert_eq!(__, "Up!");
|
||||
|
||||
assert_eq!(__, "*waving arms furiously*");
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<h2 id="supertraits"><a class="header" href="#supertraits">Supertraits</a></h2>
|
||||
<p>Sometimes, you might need one trait to use another trait’s functionality( like the "inheritance" in other languages ). In this case, you need to rely on the dependent trait also being implemented. The trait you rely on is a <code>supertrait</code> of the trait you’re implementing.</p>
|
||||
<ol start="4">
|
||||
<li>🌟🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
trait Person {
|
||||
fn name(&self) -> String;
|
||||
}
|
||||
|
||||
// Person is a supertrait of Student.
|
||||
// Implementing Student requires you to also impl Person.
|
||||
trait Student: Person {
|
||||
fn university(&self) -> String;
|
||||
}
|
||||
|
||||
trait Programmer {
|
||||
fn fav_language(&self) -> String;
|
||||
}
|
||||
|
||||
// CompSciStudent (computer science student) is a subtrait of both Programmer
|
||||
// and Student. Implementing CompSciStudent requires you to impl both supertraits.
|
||||
trait CompSciStudent: Programmer + Student {
|
||||
fn git_username(&self) -> String;
|
||||
}
|
||||
|
||||
fn comp_sci_student_greeting(student: &dyn CompSciStudent) -> String {
|
||||
format!(
|
||||
"My name is {} and I attend {}. My favorite language is {}. My Git username is {}",
|
||||
student.name(),
|
||||
student.university(),
|
||||
student.fav_language(),
|
||||
student.git_username()
|
||||
)
|
||||
}
|
||||
|
||||
struct CSStudent {
|
||||
name: String,
|
||||
university: String,
|
||||
fav_language: String,
|
||||
git_username: String
|
||||
}
|
||||
|
||||
// IMPLEMENT the necessary traits for CSStudent to make the code work
|
||||
impl ...
|
||||
|
||||
fn main() {
|
||||
let student = CSStudent {
|
||||
name: "Sunfei".to_string(),
|
||||
university: "XXX".to_string(),
|
||||
fav_language: "Rust".to_string(),
|
||||
git_username: "sunface".to_string()
|
||||
};
|
||||
|
||||
// FILL in the blank
|
||||
println!("{}", comp_sci_student_greeting(__));
|
||||
}</code></pre></pre>
|
||||
<h2 id="orphan-rules"><a class="header" href="#orphan-rules">Orphan Rules</a></h2>
|
||||
<p>We can’t implement external traits on external types. For example, we can’t implement the <code>Display</code> trait on <code>Vec<T></code> within our own crate, because <code>Display</code> and <code>Vec<T></code> are defined in the standard library and aren’t local to our crate.</p>
|
||||
<p>This restriction is often called the orphan rule, so named because the parent type is not present. This rule ensures that other people’s code can’t break your code and vice versa.</p>
|
||||
<p>It’s possible to get around this restriction using the newtype pattern, which involves creating a new type in a tuple struct.</p>
|
||||
<ol start="5">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">use std::fmt;
|
||||
|
||||
// DEFINE a newtype `Pretty` here
|
||||
|
||||
|
||||
impl fmt::Display for Pretty {
|
||||
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
||||
write!(f, "\"{}\"", self.0.clone() + ", world")
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let w = Pretty("hello".to_string());
|
||||
println!("w = {}", w);
|
||||
}</code></pre></pre>
|
||||
<blockquote>
|
||||
<p>You can find the solutions <a href="https://github.com/sunface/rust-by-practice">here</a>(under the solutions path), but only use it when you need it :)</p>
|
||||
</blockquote>
|
||||
|
||||
</main>
|
||||
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
<a rel="prev" href="../generics-traits/trait-object.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../collections/intro.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
<div style="clear: both"></div>
|
||||
</nav>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
<a rel="prev" href="../generics-traits/trait-object.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../collections/intro.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
<script src="../ace.js"></script>
|
||||
<script src="../editor.js"></script>
|
||||
<script src="../mode-rust.js"></script>
|
||||
<script src="../theme-dawn.js"></script>
|
||||
<script src="../theme-tomorrow_night.js"></script>
|
||||
|
||||
<script src="../elasticlunr.min.js"></script>
|
||||
<script src="../mark.min.js"></script>
|
||||
<script src="../searcher.js"></script>
|
||||
|
||||
<script src="../clipboard.min.js"></script>
|
||||
<script src="../highlight.js"></script>
|
||||
<script src="../book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
<script src="../assets/custom3.js"></script>
|
||||
<script src="../assets/lang1.js"></script>
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
359
generics-traits/const-generics.html
Normal file
359
generics-traits/const-generics.html
Normal file
@ -0,0 +1,359 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="light sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Const Generics - Rust By Practice</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta name="description" content="Learn Rust with Example, Exercise and real Practice, written with ❤️ by https://course.rs team">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="../favicon.svg">
|
||||
<link rel="shortcut icon" href="../favicon.png">
|
||||
<link rel="stylesheet" href="../css/variables.css">
|
||||
<link rel="stylesheet" href="../css/general.css">
|
||||
<link rel="stylesheet" href="../css/chrome.css">
|
||||
<link rel="stylesheet" href="../css/print.css" media="print">
|
||||
|
||||
<!-- Fonts -->
|
||||
<link rel="stylesheet" href="../FontAwesome/css/font-awesome.css">
|
||||
<link rel="stylesheet" href="../fonts/fonts.css">
|
||||
|
||||
<!-- Highlight.js Stylesheets -->
|
||||
<link rel="stylesheet" id="highlight-css" href="../highlight.css">
|
||||
<link rel="stylesheet" id="tomorrow-night-css" href="../tomorrow-night.css">
|
||||
<link rel="stylesheet" id="ayu-highlight-css" href="../ayu-highlight.css">
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="../theme/style1.css">
|
||||
|
||||
|
||||
<!-- Provide site root and default themes to javascript -->
|
||||
<script>
|
||||
const path_to_root = "../";
|
||||
const default_light_theme = "light";
|
||||
const default_dark_theme = "navy";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="../toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script>
|
||||
try {
|
||||
let theme = localStorage.getItem('mdbook-theme');
|
||||
let sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
|
||||
if (theme.startsWith('"') && theme.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-theme', theme.slice(1, theme.length - 1));
|
||||
}
|
||||
|
||||
if (sidebar.startsWith('"') && sidebar.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-sidebar', sidebar.slice(1, sidebar.length - 1));
|
||||
}
|
||||
} catch (e) { }
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script>
|
||||
const default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? default_dark_theme : default_light_theme;
|
||||
let theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('light')
|
||||
html.classList.add(theme);
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script>
|
||||
let sidebar = null;
|
||||
const sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="../toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="default_theme">Auto</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
</ul>
|
||||
<button id="search-toggle" class="icon-button" type="button" title="Search. (Shortkey: s)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="S" aria-controls="searchbar">
|
||||
<i class="fa fa-search"></i>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Rust By Practice</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="../print.html" title="Print this book" aria-label="Print this book">
|
||||
<i id="print-button" class="fa fa-print"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice" title="Git repository" aria-label="Git repository">
|
||||
<i id="git-repository-button" class="fa fa-github"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice/edit/master/en/src/generics-traits/const-generics.md" title="Suggest an edit" aria-label="Suggest an edit">
|
||||
<i id="git-edit-button" class="fa fa-edit"></i>
|
||||
</a>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="search-wrapper" class="hidden">
|
||||
<form id="searchbar-outer" class="searchbar-outer">
|
||||
<input type="search" id="searchbar" name="searchbar" placeholder="Search this book ..." aria-controls="searchresults-outer" aria-describedby="searchresults-header">
|
||||
</form>
|
||||
<div id="searchresults-outer" class="searchresults-outer hidden">
|
||||
<div id="searchresults-header" class="searchresults-header"></div>
|
||||
<ul id="searchresults">
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
link.setAttribute('tabIndex', sidebar === 'visible' ? 0 : -1);
|
||||
});
|
||||
</script>
|
||||
|
||||
<div id="content" class="content">
|
||||
<main>
|
||||
<h1 id="const-generics"><a class="header" href="#const-generics">Const Generics</a></h1>
|
||||
<p>Const generics are generic arguments that range over constant values, rather than types or lifetimes. This allows, for instance, types to be parameterized by integers. In fact, there has been one example of const generic types since early on in Rust's development: the array types [T; N], for some type T and N: usize. However, there has previously been no way to abstract over arrays of an arbitrary size: if you wanted to implement a trait for arrays of any size, you would have to do so manually for each possible value. For a long time, even the standard library methods for arrays were limited to arrays of length at most 32 due to this problem.</p>
|
||||
<h2 id="examples"><a class="header" href="#examples">Examples</a></h2>
|
||||
<ol>
|
||||
<li>Here's an example of a type and implementation making use of const generics: a type wrapping a pair of arrays of the same size.</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">struct ArrayPair<T, const N: usize> {
|
||||
left: [T; N],
|
||||
right: [T; N],
|
||||
}
|
||||
|
||||
impl<T: Debug, const N: usize> Debug for ArrayPair<T, N> {
|
||||
// ...
|
||||
}</code></pre></pre>
|
||||
<ol start="2">
|
||||
<li>Currently, const parameters may only be instantiated by const arguments of the following forms:</li>
|
||||
</ol>
|
||||
<ul>
|
||||
<li>A standalone const parameter.</li>
|
||||
<li>A literal (i.e. an integer, bool, or character).</li>
|
||||
<li>A concrete constant expression (enclosed by {}), involving no generic parameters.</li>
|
||||
</ul>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">fn foo<const N: usize>() {}
|
||||
|
||||
fn bar<T, const M: usize>() {
|
||||
foo::<M>(); // Okay: `M` is a const parameter
|
||||
foo::<2021>(); // Okay: `2021` is a literal
|
||||
foo::<{20 * 100 + 20 * 10 + 1}>(); // Okay: const expression contains no generic parameters
|
||||
|
||||
foo::<{ M + 1 }>(); // Error: const expression contains the generic parameter `M`
|
||||
foo::<{ std::mem::size_of::<T>() }>(); // Error: const expression contains the generic parameter `T`
|
||||
|
||||
let _: [u8; M]; // Okay: `M` is a const parameter
|
||||
let _: [u8; std::mem::size_of::<T>()]; // Error: const expression contains the generic parameter `T`
|
||||
}
|
||||
|
||||
fn main() {}</code></pre></pre>
|
||||
<ol start="3">
|
||||
<li>Const generics can also let us avoid some runtime checks.</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust edition2021">/// A region of memory containing at least `N` `T`s.
|
||||
pub struct MinSlice<T, const N: usize> {
|
||||
/// The bounded region of memory. Exactly `N` `T`s.
|
||||
pub head: [T; N],
|
||||
/// Zero or more remaining `T`s after the `N` in the bounded region.
|
||||
pub tail: [T],
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let slice: &[u8] = b"Hello, world";
|
||||
let reference: Option<&u8> = slice.get(6);
|
||||
// We know this value is `Some(b' ')`,
|
||||
// but the compiler can't know that.
|
||||
assert!(reference.is_some());
|
||||
|
||||
let slice: &[u8] = b"Hello, world";
|
||||
// Length check is performed when we construct a MinSlice,
|
||||
// and it's known at compile time to be of length 12.
|
||||
// If the `unwrap()` succeeds, no more checks are needed
|
||||
// throughout the `MinSlice`'s lifetime.
|
||||
let minslice = MinSlice::<u8, 12>::from_slice(slice).unwrap();
|
||||
let value: u8 = minslice.head[6];
|
||||
assert_eq!(value, b' ')
|
||||
}</code></pre></pre>
|
||||
<h2 id="exercises"><a class="header" href="#exercises">Exercises</a></h2>
|
||||
<ol>
|
||||
<li>🌟🌟 <code><T, const N: usize></code> is part of the struct type, it means <code>Array<i32, 3></code> and <code>Array<i32, 4></code> are different types.</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">struct Array<T, const N: usize> {
|
||||
data : [T; N]
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let arrays = [
|
||||
Array{
|
||||
data: [1, 2, 3],
|
||||
},
|
||||
Array {
|
||||
data: [1.0, 2.0, 3.0],
|
||||
},
|
||||
Array {
|
||||
data: [1, 2]
|
||||
}
|
||||
];
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<ol start="2">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Fill in the blanks to make it work.
|
||||
fn print_array<__>(__) {
|
||||
println!("{:?}", arr);
|
||||
}
|
||||
fn main() {
|
||||
let arr = [1, 2, 3];
|
||||
print_array(arr);
|
||||
|
||||
let arr = ["hello", "world"];
|
||||
print_array(arr);
|
||||
}</code></pre></pre>
|
||||
<ol start="3">
|
||||
<li>🌟🌟🌟 Sometimes we want to limit the size of a variable, e.g when using in embedding environments, then <code>const expressions</code> will fit your needs.</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">#![allow(incomplete_features)]
|
||||
#![feature(generic_const_exprs)]
|
||||
|
||||
fn check_size<T>(val: T)
|
||||
where
|
||||
Assert<{ core::mem::size_of::<T>() < 768 }>: IsTrue,
|
||||
{
|
||||
//...
|
||||
}
|
||||
|
||||
// Fix the errors in main.
|
||||
fn main() {
|
||||
check_size([0u8; 767]);
|
||||
check_size([0i32; 191]);
|
||||
check_size(["hello你好"; __]); // Size of &str ?
|
||||
check_size([(); __].map(|_| "hello你好".to_string())); // Size of String?
|
||||
check_size(['中'; __]); // Size of char ?
|
||||
|
||||
println!("Success!");
|
||||
}
|
||||
|
||||
|
||||
|
||||
pub enum Assert<const CHECK: bool> {}
|
||||
|
||||
pub trait IsTrue {}
|
||||
|
||||
impl IsTrue for Assert<true> {}</code></pre></pre>
|
||||
<blockquote>
|
||||
<p>You can find the solutions <a href="https://github.com/sunface/rust-by-practice/blob/master/solutions/generics-traits/const-generics.md">here</a>(under the solutions path), but only use it when you need it :)</p>
|
||||
</blockquote>
|
||||
|
||||
</main>
|
||||
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
<a rel="prev" href="../generics-traits/generics.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../generics-traits/traits.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
<div style="clear: both"></div>
|
||||
</nav>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
<a rel="prev" href="../generics-traits/generics.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../generics-traits/traits.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
<script src="../ace.js"></script>
|
||||
<script src="../editor.js"></script>
|
||||
<script src="../mode-rust.js"></script>
|
||||
<script src="../theme-dawn.js"></script>
|
||||
<script src="../theme-tomorrow_night.js"></script>
|
||||
|
||||
<script src="../elasticlunr.min.js"></script>
|
||||
<script src="../mark.min.js"></script>
|
||||
<script src="../searcher.js"></script>
|
||||
|
||||
<script src="../clipboard.min.js"></script>
|
||||
<script src="../highlight.js"></script>
|
||||
<script src="../book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
<script src="../assets/custom3.js"></script>
|
||||
<script src="../assets/lang1.js"></script>
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
369
generics-traits/generics.html
Normal file
369
generics-traits/generics.html
Normal file
@ -0,0 +1,369 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="light sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Generics - Rust By Practice</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta name="description" content="Learn Rust with Example, Exercise and real Practice, written with ❤️ by https://course.rs team">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="../favicon.svg">
|
||||
<link rel="shortcut icon" href="../favicon.png">
|
||||
<link rel="stylesheet" href="../css/variables.css">
|
||||
<link rel="stylesheet" href="../css/general.css">
|
||||
<link rel="stylesheet" href="../css/chrome.css">
|
||||
<link rel="stylesheet" href="../css/print.css" media="print">
|
||||
|
||||
<!-- Fonts -->
|
||||
<link rel="stylesheet" href="../FontAwesome/css/font-awesome.css">
|
||||
<link rel="stylesheet" href="../fonts/fonts.css">
|
||||
|
||||
<!-- Highlight.js Stylesheets -->
|
||||
<link rel="stylesheet" id="highlight-css" href="../highlight.css">
|
||||
<link rel="stylesheet" id="tomorrow-night-css" href="../tomorrow-night.css">
|
||||
<link rel="stylesheet" id="ayu-highlight-css" href="../ayu-highlight.css">
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="../theme/style1.css">
|
||||
|
||||
|
||||
<!-- Provide site root and default themes to javascript -->
|
||||
<script>
|
||||
const path_to_root = "../";
|
||||
const default_light_theme = "light";
|
||||
const default_dark_theme = "navy";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="../toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script>
|
||||
try {
|
||||
let theme = localStorage.getItem('mdbook-theme');
|
||||
let sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
|
||||
if (theme.startsWith('"') && theme.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-theme', theme.slice(1, theme.length - 1));
|
||||
}
|
||||
|
||||
if (sidebar.startsWith('"') && sidebar.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-sidebar', sidebar.slice(1, sidebar.length - 1));
|
||||
}
|
||||
} catch (e) { }
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script>
|
||||
const default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? default_dark_theme : default_light_theme;
|
||||
let theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('light')
|
||||
html.classList.add(theme);
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script>
|
||||
let sidebar = null;
|
||||
const sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="../toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="default_theme">Auto</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
</ul>
|
||||
<button id="search-toggle" class="icon-button" type="button" title="Search. (Shortkey: s)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="S" aria-controls="searchbar">
|
||||
<i class="fa fa-search"></i>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Rust By Practice</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="../print.html" title="Print this book" aria-label="Print this book">
|
||||
<i id="print-button" class="fa fa-print"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice" title="Git repository" aria-label="Git repository">
|
||||
<i id="git-repository-button" class="fa fa-github"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice/edit/master/en/src/generics-traits/generics.md" title="Suggest an edit" aria-label="Suggest an edit">
|
||||
<i id="git-edit-button" class="fa fa-edit"></i>
|
||||
</a>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="search-wrapper" class="hidden">
|
||||
<form id="searchbar-outer" class="searchbar-outer">
|
||||
<input type="search" id="searchbar" name="searchbar" placeholder="Search this book ..." aria-controls="searchresults-outer" aria-describedby="searchresults-header">
|
||||
</form>
|
||||
<div id="searchresults-outer" class="searchresults-outer hidden">
|
||||
<div id="searchresults-header" class="searchresults-header"></div>
|
||||
<ul id="searchresults">
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
link.setAttribute('tabIndex', sidebar === 'visible' ? 0 : -1);
|
||||
});
|
||||
</script>
|
||||
|
||||
<div id="content" class="content">
|
||||
<main>
|
||||
<h1 id="generics"><a class="header" href="#generics">Generics</a></h1>
|
||||
<h3 id="functions"><a class="header" href="#functions">Functions</a></h3>
|
||||
<ol>
|
||||
<li>🌟🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Fill in the blanks to make it work
|
||||
struct A; // Concrete type `A`.
|
||||
struct S(A); // Concrete type `S`.
|
||||
struct SGen<T>(T); // Generic type `SGen`.
|
||||
|
||||
fn reg_fn(_s: S) {}
|
||||
|
||||
fn gen_spec_t(_s: SGen<A>) {}
|
||||
|
||||
fn gen_spec_i32(_s: SGen<i32>) {}
|
||||
|
||||
fn generic<T>(_s: SGen<T>) {}
|
||||
|
||||
fn main() {
|
||||
// Using the non-generic functions
|
||||
reg_fn(__); // Concrete type.
|
||||
gen_spec_t(__); // Implicitly specified type parameter `A`.
|
||||
gen_spec_i32(__); // Implicitly specified type parameter `i32`.
|
||||
|
||||
// Explicitly specified type parameter `char` to `generic()`.
|
||||
generic::<char>(__);
|
||||
|
||||
// Implicitly specified type parameter `char` to `generic()`.
|
||||
generic(__);
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<ol start="2">
|
||||
<li>🌟🌟 A function call with explicitly specified type parameters looks like: <code>fun::<A, B, ...>()</code>.</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Implement the generic function below.
|
||||
fn sum
|
||||
|
||||
fn main() {
|
||||
assert_eq!(5, sum(2i8, 3i8));
|
||||
assert_eq!(50, sum(20, 30));
|
||||
assert_eq!(2.46, sum(1.23, 1.23));
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<h3 id="struct-and-impl"><a class="header" href="#struct-and-impl">Struct and <code>impl</code></a></h3>
|
||||
<ol start="3">
|
||||
<li>🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Implement struct Point to make it work.
|
||||
|
||||
|
||||
fn main() {
|
||||
let integer = Point { x: 5, y: 10 };
|
||||
let float = Point { x: 1.0, y: 4.0 };
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<ol start="4">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Modify this struct to make the code work
|
||||
struct Point<T> {
|
||||
x: T,
|
||||
y: T,
|
||||
}
|
||||
|
||||
fn main() {
|
||||
// DON'T modify this code.
|
||||
let p = Point{x: 5, y : "hello".to_string()};
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<ol start="5">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Add generic for Val to make the code work, DON'T modify the code in `main`.
|
||||
struct Val {
|
||||
val: f64,
|
||||
}
|
||||
|
||||
impl Val {
|
||||
fn value(&self) -> &f64 {
|
||||
&self.val
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
fn main() {
|
||||
let x = Val{ val: 3.0 };
|
||||
let y = Val{ val: "hello".to_string()};
|
||||
println!("{}, {}", x.value(), y.value());
|
||||
}</code></pre></pre>
|
||||
<h3 id="method"><a class="header" href="#method">Method</a></h3>
|
||||
<ol start="6">
|
||||
<li>🌟🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">struct Point<T, U> {
|
||||
x: T,
|
||||
y: U,
|
||||
}
|
||||
|
||||
impl<T, U> Point<T, U> {
|
||||
// Implement mixup to make it work, DON'T modify other code.
|
||||
fn mixup
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let p1 = Point { x: 5, y: 10 };
|
||||
let p2 = Point { x: "Hello", y: '中'};
|
||||
|
||||
let p3 = p1.mixup(p2);
|
||||
|
||||
assert_eq!(p3.x, 5);
|
||||
assert_eq!(p3.y, '中');
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<ol start="7">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Fix the errors to make the code work.
|
||||
struct Point<T> {
|
||||
x: T,
|
||||
y: T,
|
||||
}
|
||||
|
||||
impl Point<f32> {
|
||||
fn distance_from_origin(&self) -> f32 {
|
||||
(self.x.powi(2) + self.y.powi(2)).sqrt()
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let p = Point{x: 5, y: 10};
|
||||
println!("{}",p.distance_from_origin());
|
||||
}</code></pre></pre>
|
||||
<blockquote>
|
||||
<p>You can find the solutions <a href="https://github.com/sunface/rust-by-practice/blob/master/solutions/generics-traits/generics.md">here</a>(under the solutions path), but only use it when you need it</p>
|
||||
</blockquote>
|
||||
|
||||
</main>
|
||||
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
<a rel="prev" href="../generics-traits/intro.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../generics-traits/const-generics.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
<div style="clear: both"></div>
|
||||
</nav>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
<a rel="prev" href="../generics-traits/intro.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../generics-traits/const-generics.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
<script src="../ace.js"></script>
|
||||
<script src="../editor.js"></script>
|
||||
<script src="../mode-rust.js"></script>
|
||||
<script src="../theme-dawn.js"></script>
|
||||
<script src="../theme-tomorrow_night.js"></script>
|
||||
|
||||
<script src="../elasticlunr.min.js"></script>
|
||||
<script src="../mark.min.js"></script>
|
||||
<script src="../searcher.js"></script>
|
||||
|
||||
<script src="../clipboard.min.js"></script>
|
||||
<script src="../highlight.js"></script>
|
||||
<script src="../book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
<script src="../assets/custom3.js"></script>
|
||||
<script src="../assets/lang1.js"></script>
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
229
generics-traits/intro.html
Normal file
229
generics-traits/intro.html
Normal file
@ -0,0 +1,229 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="light sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Generics and Traits - Rust By Practice</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta name="description" content="Learn Rust with Example, Exercise and real Practice, written with ❤️ by https://course.rs team">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="../favicon.svg">
|
||||
<link rel="shortcut icon" href="../favicon.png">
|
||||
<link rel="stylesheet" href="../css/variables.css">
|
||||
<link rel="stylesheet" href="../css/general.css">
|
||||
<link rel="stylesheet" href="../css/chrome.css">
|
||||
<link rel="stylesheet" href="../css/print.css" media="print">
|
||||
|
||||
<!-- Fonts -->
|
||||
<link rel="stylesheet" href="../FontAwesome/css/font-awesome.css">
|
||||
<link rel="stylesheet" href="../fonts/fonts.css">
|
||||
|
||||
<!-- Highlight.js Stylesheets -->
|
||||
<link rel="stylesheet" id="highlight-css" href="../highlight.css">
|
||||
<link rel="stylesheet" id="tomorrow-night-css" href="../tomorrow-night.css">
|
||||
<link rel="stylesheet" id="ayu-highlight-css" href="../ayu-highlight.css">
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="../theme/style1.css">
|
||||
|
||||
|
||||
<!-- Provide site root and default themes to javascript -->
|
||||
<script>
|
||||
const path_to_root = "../";
|
||||
const default_light_theme = "light";
|
||||
const default_dark_theme = "navy";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="../toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script>
|
||||
try {
|
||||
let theme = localStorage.getItem('mdbook-theme');
|
||||
let sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
|
||||
if (theme.startsWith('"') && theme.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-theme', theme.slice(1, theme.length - 1));
|
||||
}
|
||||
|
||||
if (sidebar.startsWith('"') && sidebar.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-sidebar', sidebar.slice(1, sidebar.length - 1));
|
||||
}
|
||||
} catch (e) { }
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script>
|
||||
const default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? default_dark_theme : default_light_theme;
|
||||
let theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('light')
|
||||
html.classList.add(theme);
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script>
|
||||
let sidebar = null;
|
||||
const sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="../toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="default_theme">Auto</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
</ul>
|
||||
<button id="search-toggle" class="icon-button" type="button" title="Search. (Shortkey: s)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="S" aria-controls="searchbar">
|
||||
<i class="fa fa-search"></i>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Rust By Practice</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="../print.html" title="Print this book" aria-label="Print this book">
|
||||
<i id="print-button" class="fa fa-print"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice" title="Git repository" aria-label="Git repository">
|
||||
<i id="git-repository-button" class="fa fa-github"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice/edit/master/en/src/generics-traits/intro.md" title="Suggest an edit" aria-label="Suggest an edit">
|
||||
<i id="git-edit-button" class="fa fa-edit"></i>
|
||||
</a>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="search-wrapper" class="hidden">
|
||||
<form id="searchbar-outer" class="searchbar-outer">
|
||||
<input type="search" id="searchbar" name="searchbar" placeholder="Search this book ..." aria-controls="searchresults-outer" aria-describedby="searchresults-header">
|
||||
</form>
|
||||
<div id="searchresults-outer" class="searchresults-outer hidden">
|
||||
<div id="searchresults-header" class="searchresults-header"></div>
|
||||
<ul id="searchresults">
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
link.setAttribute('tabIndex', sidebar === 'visible' ? 0 : -1);
|
||||
});
|
||||
</script>
|
||||
|
||||
<div id="content" class="content">
|
||||
<main>
|
||||
<h1 id="generics-and-traits"><a class="header" href="#generics-and-traits">Generics and Traits</a></h1>
|
||||
<p>Learning resources:</p>
|
||||
<ul>
|
||||
<li>English: <a href="https://doc.rust-lang.org/book/ch10-00-generics.html">Rust Book 10.1, 10.2</a></li>
|
||||
<li>简体中文: <a href="https://course.rs/basic/trait/intro.html">Rust语言圣经 - 模式匹配</a></li>
|
||||
</ul>
|
||||
|
||||
</main>
|
||||
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
<a rel="prev" href="../method.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../generics-traits/generics.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
<div style="clear: both"></div>
|
||||
</nav>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
<a rel="prev" href="../method.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../generics-traits/generics.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
<script src="../ace.js"></script>
|
||||
<script src="../editor.js"></script>
|
||||
<script src="../mode-rust.js"></script>
|
||||
<script src="../theme-dawn.js"></script>
|
||||
<script src="../theme-tomorrow_night.js"></script>
|
||||
|
||||
<script src="../elasticlunr.min.js"></script>
|
||||
<script src="../mark.min.js"></script>
|
||||
<script src="../searcher.js"></script>
|
||||
|
||||
<script src="../clipboard.min.js"></script>
|
||||
<script src="../highlight.js"></script>
|
||||
<script src="../book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
<script src="../assets/custom3.js"></script>
|
||||
<script src="../assets/lang1.js"></script>
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
442
generics-traits/trait-object.html
Normal file
442
generics-traits/trait-object.html
Normal file
@ -0,0 +1,442 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="light sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Trait Object - Rust By Practice</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta name="description" content="Learn Rust with Example, Exercise and real Practice, written with ❤️ by https://course.rs team">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="../favicon.svg">
|
||||
<link rel="shortcut icon" href="../favicon.png">
|
||||
<link rel="stylesheet" href="../css/variables.css">
|
||||
<link rel="stylesheet" href="../css/general.css">
|
||||
<link rel="stylesheet" href="../css/chrome.css">
|
||||
<link rel="stylesheet" href="../css/print.css" media="print">
|
||||
|
||||
<!-- Fonts -->
|
||||
<link rel="stylesheet" href="../FontAwesome/css/font-awesome.css">
|
||||
<link rel="stylesheet" href="../fonts/fonts.css">
|
||||
|
||||
<!-- Highlight.js Stylesheets -->
|
||||
<link rel="stylesheet" id="highlight-css" href="../highlight.css">
|
||||
<link rel="stylesheet" id="tomorrow-night-css" href="../tomorrow-night.css">
|
||||
<link rel="stylesheet" id="ayu-highlight-css" href="../ayu-highlight.css">
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="../theme/style1.css">
|
||||
|
||||
|
||||
<!-- Provide site root and default themes to javascript -->
|
||||
<script>
|
||||
const path_to_root = "../";
|
||||
const default_light_theme = "light";
|
||||
const default_dark_theme = "navy";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="../toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script>
|
||||
try {
|
||||
let theme = localStorage.getItem('mdbook-theme');
|
||||
let sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
|
||||
if (theme.startsWith('"') && theme.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-theme', theme.slice(1, theme.length - 1));
|
||||
}
|
||||
|
||||
if (sidebar.startsWith('"') && sidebar.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-sidebar', sidebar.slice(1, sidebar.length - 1));
|
||||
}
|
||||
} catch (e) { }
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script>
|
||||
const default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? default_dark_theme : default_light_theme;
|
||||
let theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('light')
|
||||
html.classList.add(theme);
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script>
|
||||
let sidebar = null;
|
||||
const sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="../toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="default_theme">Auto</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
</ul>
|
||||
<button id="search-toggle" class="icon-button" type="button" title="Search. (Shortkey: s)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="S" aria-controls="searchbar">
|
||||
<i class="fa fa-search"></i>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Rust By Practice</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="../print.html" title="Print this book" aria-label="Print this book">
|
||||
<i id="print-button" class="fa fa-print"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice" title="Git repository" aria-label="Git repository">
|
||||
<i id="git-repository-button" class="fa fa-github"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice/edit/master/en/src/generics-traits/trait-object.md" title="Suggest an edit" aria-label="Suggest an edit">
|
||||
<i id="git-edit-button" class="fa fa-edit"></i>
|
||||
</a>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="search-wrapper" class="hidden">
|
||||
<form id="searchbar-outer" class="searchbar-outer">
|
||||
<input type="search" id="searchbar" name="searchbar" placeholder="Search this book ..." aria-controls="searchresults-outer" aria-describedby="searchresults-header">
|
||||
</form>
|
||||
<div id="searchresults-outer" class="searchresults-outer hidden">
|
||||
<div id="searchresults-header" class="searchresults-header"></div>
|
||||
<ul id="searchresults">
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
link.setAttribute('tabIndex', sidebar === 'visible' ? 0 : -1);
|
||||
});
|
||||
</script>
|
||||
|
||||
<div id="content" class="content">
|
||||
<main>
|
||||
<h1 id="trait-object"><a class="header" href="#trait-object">Trait Object</a></h1>
|
||||
<p>In <a href="https://practice.rs/generics-traits/traits.html#returning-types-that-implement-traits">traits chapter</a> we have seen that we can't use <code>impl Trait</code> when returning multiple types.</p>
|
||||
<p>Another limitation of arrays is that they can only store elements of one type. Using enums is not a bad solution when we have a fixed set of types at compile time, but trait objects would be more flexible and powerful.</p>
|
||||
<h2 id="returning-traits-with-dyn"><a class="header" href="#returning-traits-with-dyn">Returning Traits with dyn</a></h2>
|
||||
<p>The Rust compiler needs to know how much space a function's return type requires. Because the different implementations of a trait probably uses different amounts of memory, functions need to either return a concrete type or the same type when using <code>impl Trait</code>, or return a trait object with <code>dyn</code>.</p>
|
||||
<ol>
|
||||
<li>🌟🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
trait Bird {
|
||||
fn quack(&self) -> String;
|
||||
}
|
||||
|
||||
struct Duck;
|
||||
impl Duck {
|
||||
fn swim(&self) {
|
||||
println!("Look, the duck is swimming")
|
||||
}
|
||||
}
|
||||
struct Swan;
|
||||
impl Swan {
|
||||
fn fly(&self) {
|
||||
println!("Look, the duck.. oh sorry, the swan is flying")
|
||||
}
|
||||
}
|
||||
|
||||
impl Bird for Duck {
|
||||
fn quack(&self) -> String{
|
||||
"duck duck".to_string()
|
||||
}
|
||||
}
|
||||
|
||||
impl Bird for Swan {
|
||||
fn quack(&self) -> String{
|
||||
"swan swan".to_string()
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
// FILL in the blank.
|
||||
let duck = __;
|
||||
duck.swim();
|
||||
|
||||
let bird = hatch_a_bird(2);
|
||||
// This bird has forgotten how to swim, so below line will cause an error.
|
||||
// bird.swim();
|
||||
// But it can quak.
|
||||
assert_eq!(bird.quack(), "duck duck");
|
||||
|
||||
let bird = hatch_a_bird(1);
|
||||
// This bird has forgotten how to fly, so below line will cause an error.
|
||||
// bird.fly();
|
||||
// But it can quak too.
|
||||
assert_eq!(bird.quack(), "swan swan");
|
||||
|
||||
println!("Success!");
|
||||
}
|
||||
|
||||
// IMPLEMENT this function.
|
||||
fn hatch_a_bird...
|
||||
</code></pre></pre>
|
||||
<h2 id="array-with-trait-objects"><a class="header" href="#array-with-trait-objects">Array with trait objects</a></h2>
|
||||
<ol start="2">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">trait Bird {
|
||||
fn quack(&self);
|
||||
}
|
||||
|
||||
struct Duck;
|
||||
impl Duck {
|
||||
fn fly(&self) {
|
||||
println!("Look, the duck is flying")
|
||||
}
|
||||
}
|
||||
struct Swan;
|
||||
impl Swan {
|
||||
fn fly(&self) {
|
||||
println!("Look, the duck.. oh sorry, the swan is flying")
|
||||
}
|
||||
}
|
||||
|
||||
impl Bird for Duck {
|
||||
fn quack(&self) {
|
||||
println!("{}", "duck duck");
|
||||
}
|
||||
}
|
||||
|
||||
impl Bird for Swan {
|
||||
fn quack(&self) {
|
||||
println!("{}", "swan swan");
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
// FILL in the blank to make the code work.
|
||||
let birds __;
|
||||
|
||||
for bird in birds {
|
||||
bird.quack();
|
||||
// When duck and swan turn into Birds, they all forgot how to fly, only remember how to quack.
|
||||
// So, the code below will cause an error.
|
||||
// bird.fly();
|
||||
}
|
||||
}</code></pre></pre>
|
||||
<h2 id="dyn-and-boxdyn"><a class="header" href="#dyn-and-boxdyn"><code>&dyn</code> and <code>Box<dyn></code></a></h2>
|
||||
<ol start="3">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// FILL in the blanks.
|
||||
trait Draw {
|
||||
fn draw(&self) -> String;
|
||||
}
|
||||
|
||||
impl Draw for u8 {
|
||||
fn draw(&self) -> String {
|
||||
format!("u8: {}", *self)
|
||||
}
|
||||
}
|
||||
|
||||
impl Draw for f64 {
|
||||
fn draw(&self) -> String {
|
||||
format!("f64: {}", *self)
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let x = 1.1f64;
|
||||
let y = 8u8;
|
||||
|
||||
// Draw x.
|
||||
draw_with_box(__);
|
||||
|
||||
// Draw y.
|
||||
draw_with_ref(&y);
|
||||
|
||||
println!("Success!");
|
||||
}
|
||||
|
||||
fn draw_with_box(x: Box<dyn Draw>) {
|
||||
x.draw();
|
||||
}
|
||||
|
||||
fn draw_with_ref(x: __) {
|
||||
x.draw();
|
||||
}</code></pre></pre>
|
||||
<h2 id="static-and-dynamic-dispatch"><a class="header" href="#static-and-dynamic-dispatch">Static and Dynamic dispatch</a></h2>
|
||||
<p>When we use trait bounds on generics, the compiler generates nongeneric implementations of functions and methods for each concrete type that we use in place of a generic type parameter. The code that results from monomorphization is doing static dispatch, which is when the compiler knows what method you’re calling at compile time.</p>
|
||||
<p>When we use trait objects, Rust must use dynamic dispatch. The compiler doesn’t know all the types that might be used with the code that is using trait objects, so it doesn’t know which method implemented on which type to call. Instead, at runtime, Rust uses the pointers inside the trait object to know which method to call. There is a runtime cost when this lookup happens that doesn’t occur with static dispatch. Dynamic dispatch also prevents the compiler from choosing to inline a method’s code, which in turn prevents some optimizations.</p>
|
||||
<p>However, we do get extra flexibility when using dynamic dispatch.</p>
|
||||
<ol start="4">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
trait Foo {
|
||||
fn method(&self) -> String;
|
||||
}
|
||||
|
||||
impl Foo for u8 {
|
||||
fn method(&self) -> String { format!("u8: {}", *self) }
|
||||
}
|
||||
|
||||
impl Foo for String {
|
||||
fn method(&self) -> String { format!("string: {}", *self) }
|
||||
}
|
||||
|
||||
// IMPLEMENT below with generics.
|
||||
fn static_dispatch...
|
||||
|
||||
// Implement below with trait objects.
|
||||
fn dynamic_dispatch...
|
||||
|
||||
fn main() {
|
||||
let x = 5u8;
|
||||
let y = "Hello".to_string();
|
||||
|
||||
static_dispatch(x);
|
||||
dynamic_dispatch(&y);
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<h2 id="object-safe"><a class="header" href="#object-safe">Object safe</a></h2>
|
||||
<p>You can only make object-safe traits into trait objects. A trait is object safe if all the methods defined in the trait have the following properties:</p>
|
||||
<ul>
|
||||
<li>The return type isn’t <code>Self</code>.</li>
|
||||
<li>There are no generic type parameters.</li>
|
||||
</ul>
|
||||
<ol start="5">
|
||||
<li>🌟🌟🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Use at least two approaches to make it work.
|
||||
// DON'T add/remove any code line.
|
||||
trait MyTrait {
|
||||
fn f(&self) -> Self;
|
||||
}
|
||||
|
||||
impl MyTrait for u32 {
|
||||
fn f(&self) -> Self { 42 }
|
||||
}
|
||||
|
||||
impl MyTrait for String {
|
||||
fn f(&self) -> Self { self.clone() }
|
||||
}
|
||||
|
||||
fn my_function(x: Box<dyn MyTrait>) {
|
||||
x.f()
|
||||
}
|
||||
|
||||
fn main() {
|
||||
my_function(Box::new(13_u32));
|
||||
my_function(Box::new(String::from("abc")));
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<blockquote>
|
||||
<p>You can find the solutions <a href="https://github.com/sunface/rust-by-practice/blob/master/solutions/generics-traits/trait-object.md">here</a>(under the solutions path), but only use it when you need it :)</p>
|
||||
</blockquote>
|
||||
|
||||
</main>
|
||||
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
<a rel="prev" href="../generics-traits/traits.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../generics-traits/advanced-traits.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
<div style="clear: both"></div>
|
||||
</nav>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
<a rel="prev" href="../generics-traits/traits.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../generics-traits/advanced-traits.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
<script src="../ace.js"></script>
|
||||
<script src="../editor.js"></script>
|
||||
<script src="../mode-rust.js"></script>
|
||||
<script src="../theme-dawn.js"></script>
|
||||
<script src="../theme-tomorrow_night.js"></script>
|
||||
|
||||
<script src="../elasticlunr.min.js"></script>
|
||||
<script src="../mark.min.js"></script>
|
||||
<script src="../searcher.js"></script>
|
||||
|
||||
<script src="../clipboard.min.js"></script>
|
||||
<script src="../highlight.js"></script>
|
||||
<script src="../book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
<script src="../assets/custom3.js"></script>
|
||||
<script src="../assets/lang1.js"></script>
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
678
generics-traits/traits.html
Normal file
678
generics-traits/traits.html
Normal file
@ -0,0 +1,678 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="light sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Traits - Rust By Practice</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta name="description" content="Learn Rust with Example, Exercise and real Practice, written with ❤️ by https://course.rs team">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="../favicon.svg">
|
||||
<link rel="shortcut icon" href="../favicon.png">
|
||||
<link rel="stylesheet" href="../css/variables.css">
|
||||
<link rel="stylesheet" href="../css/general.css">
|
||||
<link rel="stylesheet" href="../css/chrome.css">
|
||||
<link rel="stylesheet" href="../css/print.css" media="print">
|
||||
|
||||
<!-- Fonts -->
|
||||
<link rel="stylesheet" href="../FontAwesome/css/font-awesome.css">
|
||||
<link rel="stylesheet" href="../fonts/fonts.css">
|
||||
|
||||
<!-- Highlight.js Stylesheets -->
|
||||
<link rel="stylesheet" id="highlight-css" href="../highlight.css">
|
||||
<link rel="stylesheet" id="tomorrow-night-css" href="../tomorrow-night.css">
|
||||
<link rel="stylesheet" id="ayu-highlight-css" href="../ayu-highlight.css">
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="../theme/style1.css">
|
||||
|
||||
|
||||
<!-- Provide site root and default themes to javascript -->
|
||||
<script>
|
||||
const path_to_root = "../";
|
||||
const default_light_theme = "light";
|
||||
const default_dark_theme = "navy";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="../toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script>
|
||||
try {
|
||||
let theme = localStorage.getItem('mdbook-theme');
|
||||
let sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
|
||||
if (theme.startsWith('"') && theme.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-theme', theme.slice(1, theme.length - 1));
|
||||
}
|
||||
|
||||
if (sidebar.startsWith('"') && sidebar.endsWith('"')) {
|
||||
localStorage.setItem('mdbook-sidebar', sidebar.slice(1, sidebar.length - 1));
|
||||
}
|
||||
} catch (e) { }
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script>
|
||||
const default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? default_dark_theme : default_light_theme;
|
||||
let theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('light')
|
||||
html.classList.add(theme);
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script>
|
||||
let sidebar = null;
|
||||
const sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="../toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="default_theme">Auto</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
</ul>
|
||||
<button id="search-toggle" class="icon-button" type="button" title="Search. (Shortkey: s)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="S" aria-controls="searchbar">
|
||||
<i class="fa fa-search"></i>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Rust By Practice</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="../print.html" title="Print this book" aria-label="Print this book">
|
||||
<i id="print-button" class="fa fa-print"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice" title="Git repository" aria-label="Git repository">
|
||||
<i id="git-repository-button" class="fa fa-github"></i>
|
||||
</a>
|
||||
<a href="https://github.com/sunface/rust-by-practice/edit/master/en/src/generics-traits/traits.md" title="Suggest an edit" aria-label="Suggest an edit">
|
||||
<i id="git-edit-button" class="fa fa-edit"></i>
|
||||
</a>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="search-wrapper" class="hidden">
|
||||
<form id="searchbar-outer" class="searchbar-outer">
|
||||
<input type="search" id="searchbar" name="searchbar" placeholder="Search this book ..." aria-controls="searchresults-outer" aria-describedby="searchresults-header">
|
||||
</form>
|
||||
<div id="searchresults-outer" class="searchresults-outer hidden">
|
||||
<div id="searchresults-header" class="searchresults-header"></div>
|
||||
<ul id="searchresults">
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
link.setAttribute('tabIndex', sidebar === 'visible' ? 0 : -1);
|
||||
});
|
||||
</script>
|
||||
|
||||
<div id="content" class="content">
|
||||
<main>
|
||||
<h1 id="traits"><a class="header" href="#traits">Traits</a></h1>
|
||||
<p>A trait tells the Rust compiler about functionality a particular type has and can share with other types. We can use traits to define shared behavior in an abstract way. We can use trait bounds to specify that a generic type can be any type that has certain behavior.</p>
|
||||
<blockquote>
|
||||
<p>Note: Traits are similar to interfaces in other languages, although with some differences.</p>
|
||||
</blockquote>
|
||||
<h2 id="examples"><a class="header" href="#examples">Examples</a></h2>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
struct Sheep { naked: bool, name: String }
|
||||
|
||||
trait Animal {
|
||||
// Associated function signature; `Self` refers to the implementor type.
|
||||
fn new(name: String) -> Self;
|
||||
|
||||
// Method signatures; these will return a string.
|
||||
fn name(&self) -> String;
|
||||
|
||||
fn noise(&self) -> String;
|
||||
|
||||
// Traits can provide default method definitions.
|
||||
fn talk(&self) {
|
||||
println!("{} says {}", self.name(), self.noise());
|
||||
}
|
||||
}
|
||||
|
||||
impl Sheep {
|
||||
fn is_naked(&self) -> bool {
|
||||
self.naked
|
||||
}
|
||||
|
||||
fn shear(&mut self) {
|
||||
if self.is_naked() {
|
||||
// Implementor methods can use the implementor's trait methods.
|
||||
println!("{} is already naked...", self.name());
|
||||
} else {
|
||||
println!("{} gets a haircut!", self.name);
|
||||
|
||||
self.naked = true;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Implement the `Animal` trait for `Sheep`.
|
||||
impl Animal for Sheep {
|
||||
// `Self` is the implementor type: `Sheep`.
|
||||
fn new(name: String) -> Sheep {
|
||||
Sheep { name: name, naked: false }
|
||||
}
|
||||
|
||||
fn name(&self) -> String {
|
||||
self.name.clone()
|
||||
}
|
||||
|
||||
fn noise(&self) -> String {
|
||||
if self.is_naked() {
|
||||
"baaaaah?".to_string()
|
||||
} else {
|
||||
"baaaaah!".to_string()
|
||||
}
|
||||
}
|
||||
|
||||
// Default trait methods can be overridden.
|
||||
fn talk(&self) {
|
||||
// For example, we can add some quiet contemplation.
|
||||
println!("{} pauses briefly... {}", self.name, self.noise());
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
// Type annotation is necessary in this case.
|
||||
let mut dolly: Sheep = Animal::new("Dolly".to_string());
|
||||
// TODO ^ Try removing the type annotations.
|
||||
|
||||
dolly.talk();
|
||||
dolly.shear();
|
||||
dolly.talk();
|
||||
}</code></pre></pre>
|
||||
<h2 id="exercises"><a class="header" href="#exercises">Exercises</a></h2>
|
||||
<ol>
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Fill in the two impl blocks to make the code work.
|
||||
// DON'T modify the code in `main`.
|
||||
trait Hello {
|
||||
fn say_hi(&self) -> String {
|
||||
String::from("hi")
|
||||
}
|
||||
|
||||
fn say_something(&self) -> String;
|
||||
}
|
||||
|
||||
struct Student {}
|
||||
impl Hello for Student {
|
||||
}
|
||||
struct Teacher {}
|
||||
impl Hello for Teacher {
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let s = Student {};
|
||||
assert_eq!(s.say_hi(), "hi");
|
||||
assert_eq!(s.say_something(), "I'm a good student");
|
||||
|
||||
let t = Teacher {};
|
||||
assert_eq!(t.say_hi(), "Hi, I'm your new teacher");
|
||||
assert_eq!(t.say_something(), "I'm not a bad teacher");
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<h3 id="derive"><a class="header" href="#derive">Derive</a></h3>
|
||||
<p>The compiler is capable of providing basic implementations for some traits via
|
||||
the <code>#[derive]</code> attribute. For more info, please visit <a href="https://doc.rust-lang.org/book/appendix-03-derivable-traits.html">here</a>.</p>
|
||||
<ol start="2">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// `Centimeters`, a tuple struct that can be compared
|
||||
#[derive(PartialEq, PartialOrd)]
|
||||
struct Centimeters(f64);
|
||||
|
||||
// `Inches`, a tuple struct that can be printed
|
||||
#[derive(Debug)]
|
||||
struct Inches(i32);
|
||||
|
||||
impl Inches {
|
||||
fn to_centimeters(&self) -> Centimeters {
|
||||
let &Inches(inches) = self;
|
||||
|
||||
Centimeters(inches as f64 * 2.54)
|
||||
}
|
||||
}
|
||||
|
||||
// ADD some attributes to make the code work!
|
||||
// DON'T modify other code!
|
||||
struct Seconds(i32);
|
||||
|
||||
fn main() {
|
||||
let _one_second = Seconds(1);
|
||||
|
||||
println!("One second looks like: {:?}", _one_second);
|
||||
let _this_is_true = (_one_second == _one_second);
|
||||
let _this_is_false = (_one_second > _one_second);
|
||||
|
||||
let foot = Inches(12);
|
||||
|
||||
println!("One foot equals {:?}", foot);
|
||||
|
||||
let meter = Centimeters(100.0);
|
||||
|
||||
let cmp =
|
||||
if foot.to_centimeters() < meter {
|
||||
"smaller"
|
||||
} else {
|
||||
"bigger"
|
||||
};
|
||||
|
||||
println!("One foot is {} than one meter.", cmp);
|
||||
}</code></pre></pre>
|
||||
<h3 id="operator"><a class="header" href="#operator">Operator</a></h3>
|
||||
<p>In Rust, many of the operators can be overloaded via traits. That is, some operators can be used to accomplish different tasks based on their input arguments. This is possible because operators are syntactic sugar for method calls. For example, the + operator in a + b calls the add method (as in a.add(b)). This add method is part of the Add trait. Hence, the + operator can be used by any implementor of the Add trait.</p>
|
||||
<ol start="3">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
use std::ops;
|
||||
|
||||
// Implement fn multiply to make the code work.
|
||||
// As mentioned above, `+` needs `T` to implement `std::ops::Add` Trait.
|
||||
// So, what about `*`? You can find the answer here: https://doc.rust-lang.org/core/ops/
|
||||
fn multiply
|
||||
|
||||
fn main() {
|
||||
assert_eq!(6, multiply(2u8, 3u8));
|
||||
assert_eq!(5.0, multiply(1.0, 5.0));
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<ol start="4">
|
||||
<li>🌟🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Fix the errors, DON'T modify the code in `main`.
|
||||
use std::ops;
|
||||
|
||||
struct Foo;
|
||||
struct Bar;
|
||||
|
||||
struct FooBar;
|
||||
|
||||
struct BarFoo;
|
||||
|
||||
// The `std::ops::Add` trait is used to specify the functionality of `+`.
|
||||
// Here, we make `Add<Bar>` - the trait for addition with a RHS of type `Bar`.
|
||||
// The following block implements the operation: Foo + Bar = FooBar
|
||||
impl ops::Add<Bar> for Foo {
|
||||
type Output = FooBar;
|
||||
|
||||
fn add(self, _rhs: Bar) -> FooBar {
|
||||
FooBar
|
||||
}
|
||||
}
|
||||
|
||||
impl ops::Sub<Foo> for Bar {
|
||||
type Output = BarFoo;
|
||||
|
||||
fn sub(self, _rhs: Foo) -> BarFoo {
|
||||
BarFoo
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
// DON'T modify the code below.
|
||||
// You need to derive some trait for FooBar to make it comparable.
|
||||
assert_eq!(Foo + Bar, FooBar);
|
||||
assert_eq!(Foo - Bar, BarFoo);
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<h3 id="use-trait-as-function-parameters"><a class="header" href="#use-trait-as-function-parameters">Use trait as function parameters</a></h3>
|
||||
<p>Instead of a concrete type for the item parameter, we specify the impl keyword and the trait name. This parameter accepts any type that implements the specified trait.</p>
|
||||
<ol start="5">
|
||||
<li>🌟🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Implement `fn summary` to make the code work.
|
||||
// Fix the errors without removing any code line
|
||||
trait Summary {
|
||||
fn summarize(&self) -> String;
|
||||
}
|
||||
|
||||
#[derive(Debug)]
|
||||
struct Post {
|
||||
title: String,
|
||||
author: String,
|
||||
content: String,
|
||||
}
|
||||
|
||||
impl Summary for Post {
|
||||
fn summarize(&self) -> String {
|
||||
format!("The author of post {} is {}", self.title, self.author)
|
||||
}
|
||||
}
|
||||
|
||||
#[derive(Debug)]
|
||||
struct Weibo {
|
||||
username: String,
|
||||
content: String,
|
||||
}
|
||||
|
||||
impl Summary for Weibo {
|
||||
fn summarize(&self) -> String {
|
||||
format!("{} published a weibo {}", self.username, self.content)
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let post = Post {
|
||||
title: "Popular Rust".to_string(),
|
||||
author: "Sunface".to_string(),
|
||||
content: "Rust is awesome!".to_string(),
|
||||
};
|
||||
let weibo = Weibo {
|
||||
username: "sunface".to_string(),
|
||||
content: "Weibo seems to be worse than Tweet".to_string(),
|
||||
};
|
||||
|
||||
summary(post);
|
||||
summary(weibo);
|
||||
|
||||
println!("{:?}", post);
|
||||
println!("{:?}", weibo);
|
||||
}
|
||||
|
||||
// Implement `fn summary` below.
|
||||
</code></pre></pre>
|
||||
<h3 id="returning-types-that-implement-traits"><a class="header" href="#returning-types-that-implement-traits">Returning Types that Implement Traits</a></h3>
|
||||
<p>We can also use the impl Trait syntax in the return position to return a value of some type that implements a trait.</p>
|
||||
<p>However, you can only use impl Trait if you’re returning a single type, use Trait Objects instead when you really need to return several types.</p>
|
||||
<ol start="6">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
struct Sheep {}
|
||||
struct Cow {}
|
||||
|
||||
trait Animal {
|
||||
fn noise(&self) -> String;
|
||||
}
|
||||
|
||||
impl Animal for Sheep {
|
||||
fn noise(&self) -> String {
|
||||
"baaaaah!".to_string()
|
||||
}
|
||||
}
|
||||
|
||||
impl Animal for Cow {
|
||||
fn noise(&self) -> String {
|
||||
"moooooo!".to_string()
|
||||
}
|
||||
}
|
||||
|
||||
// Returns some struct that implements Animal, but we don't know which one at compile time.
|
||||
// FIX the errors here, you can make a fake random, or you can use trait object.
|
||||
fn random_animal(random_number: f64) -> impl Animal {
|
||||
if random_number < 0.5 {
|
||||
Sheep {}
|
||||
} else {
|
||||
Cow {}
|
||||
}
|
||||
}
|
||||
|
||||
fn main() {
|
||||
let random_number = 0.234;
|
||||
let animal = random_animal(random_number);
|
||||
println!("You've randomly chosen an animal, and it says {}", animal.noise());
|
||||
}</code></pre></pre>
|
||||
<h3 id="trait-bound"><a class="header" href="#trait-bound">Trait bound</a></h3>
|
||||
<p>The <code>impl Trait</code> syntax works for straightforward cases but is actually syntax sugar for a longer form, which is called a trait bound.</p>
|
||||
<p>When working with generics, the type parameters often must use traits as bounds to stipulate what functionality a type implements.</p>
|
||||
<ol start="7">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">fn main() {
|
||||
assert_eq!(sum(1, 2), 3);
|
||||
}
|
||||
|
||||
// Implement `fn sum` with trait bound in two ways.
|
||||
fn sum<T>(x: T, y: T) -> T {
|
||||
x + y
|
||||
}</code></pre></pre>
|
||||
<ol start="8">
|
||||
<li>🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// FIX the errors.
|
||||
struct Pair<T> {
|
||||
x: T,
|
||||
y: T,
|
||||
}
|
||||
|
||||
impl<T> Pair<T> {
|
||||
fn new(x: T, y: T) -> Self {
|
||||
Self {
|
||||
x,
|
||||
y,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl<T: std::fmt::Debug + PartialOrd> Pair<T> {
|
||||
fn cmp_display(&self) {
|
||||
if self.x >= self.y {
|
||||
println!("The largest member is x = {:?}", self.x);
|
||||
} else {
|
||||
println!("The largest member is y = {:?}", self.y);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
struct Unit(i32);
|
||||
|
||||
fn main() {
|
||||
let pair = Pair{
|
||||
x: Unit(1),
|
||||
y: Unit(3)
|
||||
};
|
||||
|
||||
pair.cmp_display();
|
||||
}</code></pre></pre>
|
||||
<ol start="9">
|
||||
<li>🌟🌟🌟</li>
|
||||
</ol>
|
||||
<pre><pre class="playground"><code class="language-rust editable edition2021">
|
||||
// Fill in the blanks to make it work
|
||||
fn example1() {
|
||||
// `T: Trait` is the commonly used way.
|
||||
// `T: Fn(u32) -> u32` specifies that we can only pass a closure to `T`.
|
||||
struct Cacher<T: Fn(u32) -> u32> {
|
||||
calculation: T,
|
||||
value: Option<u32>,
|
||||
}
|
||||
|
||||
impl<T: Fn(u32) -> u32> Cacher<T> {
|
||||
fn new(calculation: T) -> Cacher<T> {
|
||||
Cacher {
|
||||
calculation,
|
||||
value: None,
|
||||
}
|
||||
}
|
||||
|
||||
fn value(&mut self, arg: u32) -> u32 {
|
||||
match self.value {
|
||||
Some(v) => v,
|
||||
None => {
|
||||
let v = (self.calculation)(arg);
|
||||
self.value = Some(v);
|
||||
v
|
||||
},
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
let mut cacher = Cacher::new(|x| x+1);
|
||||
assert_eq!(cacher.value(10), __);
|
||||
assert_eq!(cacher.value(15), __);
|
||||
}
|
||||
|
||||
|
||||
fn example2() {
|
||||
// We can also use `where` to construct `T`
|
||||
struct Cacher<T>
|
||||
where T: Fn(u32) -> u32,
|
||||
{
|
||||
calculation: T,
|
||||
value: Option<u32>,
|
||||
}
|
||||
|
||||
impl<T> Cacher<T>
|
||||
where T: Fn(u32) -> u32,
|
||||
{
|
||||
fn new(calculation: T) -> Cacher<T> {
|
||||
Cacher {
|
||||
calculation,
|
||||
value: None,
|
||||
}
|
||||
}
|
||||
|
||||
fn value(&mut self, arg: u32) -> u32 {
|
||||
match self.value {
|
||||
Some(v) => v,
|
||||
None => {
|
||||
let v = (self.calculation)(arg);
|
||||
self.value = Some(v);
|
||||
v
|
||||
},
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
let mut cacher = Cacher::new(|x| x+1);
|
||||
assert_eq!(cacher.value(20), __);
|
||||
assert_eq!(cacher.value(25), __);
|
||||
}
|
||||
|
||||
|
||||
|
||||
fn main() {
|
||||
example1();
|
||||
example2();
|
||||
|
||||
println!("Success!");
|
||||
}</code></pre></pre>
|
||||
<blockquote>
|
||||
<p>You can find the solutions <a href="https://github.com/sunface/rust-by-practice/blob/master/solutions/generics-traits/traits.md">here</a>(under the solutions path), but only use it when you need it :)</p>
|
||||
</blockquote>
|
||||
|
||||
</main>
|
||||
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
<a rel="prev" href="../generics-traits/const-generics.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../generics-traits/trait-object.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
<div style="clear: both"></div>
|
||||
</nav>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
<a rel="prev" href="../generics-traits/const-generics.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next prefetch" href="../generics-traits/trait-object.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
<script src="../ace.js"></script>
|
||||
<script src="../editor.js"></script>
|
||||
<script src="../mode-rust.js"></script>
|
||||
<script src="../theme-dawn.js"></script>
|
||||
<script src="../theme-tomorrow_night.js"></script>
|
||||
|
||||
<script src="../elasticlunr.min.js"></script>
|
||||
<script src="../mark.min.js"></script>
|
||||
<script src="../searcher.js"></script>
|
||||
|
||||
<script src="../clipboard.min.js"></script>
|
||||
<script src="../highlight.js"></script>
|
||||
<script src="../book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
<script src="../assets/custom3.js"></script>
|
||||
<script src="../assets/lang1.js"></script>
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user