Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
int
Rust
提交
ecce58c6
R
Rust
项目概览
int
/
Rust
大约 1 年 前同步成功
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
R
Rust
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
ecce58c6
编写于
7月 26, 2014
作者:
B
bors
浏览文件
操作
浏览文件
下载
差异文件
auto merge of #15762 : nham/rust/ringbuf_docs, r=alexcrichton
This adds examples for get(), get_mut(), swap(), iter() and mut_iter()
上级
d4dfb7d8
ebe80971
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
66 addition
and
0 deletion
+66
-0
src/libcollections/ringbuf.rs
src/libcollections/ringbuf.rs
+66
-0
未找到文件。
src/libcollections/ringbuf.rs
浏览文件 @
ecce58c6
...
...
@@ -133,6 +133,18 @@ pub fn with_capacity(n: uint) -> RingBuf<T> {
/// Retrieve an element in the RingBuf by index
///
/// Fails if there is no element with the given index
///
/// # Example
///
/// ```rust
/// use std::collections::RingBuf;
///
/// let mut buf = RingBuf::new();
/// buf.push(3i);
/// buf.push(4);
/// buf.push(5);
/// assert_eq!(buf.get(1), &4);
/// ```
pub
fn
get
<
'a
>
(
&
'a
self
,
i
:
uint
)
->
&
'a
T
{
let
idx
=
self
.raw_index
(
i
);
match
*
self
.elts
.get
(
idx
)
{
...
...
@@ -144,6 +156,19 @@ pub fn get<'a>(&'a self, i: uint) -> &'a T {
/// Retrieve an element in the RingBuf by index
///
/// Fails if there is no element with the given index
///
/// # Example
///
/// ```rust
/// use std::collections::RingBuf;
///
/// let mut buf = RingBuf::new();
/// buf.push(3i);
/// buf.push(4);
/// buf.push(5);
/// *buf.get_mut(1) = 7;
/// assert_eq!(buf.get(1), &7);
/// ```
pub
fn
get_mut
<
'a
>
(
&
'a
mut
self
,
i
:
uint
)
->
&
'a
mut
T
{
let
idx
=
self
.raw_index
(
i
);
match
*
self
.elts
.get_mut
(
idx
)
{
...
...
@@ -157,6 +182,20 @@ pub fn get_mut<'a>(&'a mut self, i: uint) -> &'a mut T {
/// `i` and `j` may be equal.
///
/// Fails if there is no element with the given index
///
/// # Example
///
/// ```rust
/// use std::collections::RingBuf;
///
/// let mut buf = RingBuf::new();
/// buf.push(3i);
/// buf.push(4);
/// buf.push(5);
/// buf.swap(0, 2);
/// assert_eq!(buf.get(0), &5);
/// assert_eq!(buf.get(2), &3);
/// ```
pub
fn
swap
(
&
mut
self
,
i
:
uint
,
j
:
uint
)
{
assert
!
(
i
<
self
.len
());
assert
!
(
j
<
self
.len
());
...
...
@@ -196,11 +235,38 @@ pub fn reserve(&mut self, n: uint) {
}
/// Front-to-back iterator.
///
/// # Example
///
/// ```rust
/// use std::collections::RingBuf;
///
/// let mut buf = RingBuf::new();
/// buf.push(5i);
/// buf.push(3);
/// buf.push(4);
/// assert_eq!(buf.iter().collect::<Vec<&int>>().as_slice(), &[&5, &3, &4]);
/// ```
pub
fn
iter
<
'a
>
(
&
'a
self
)
->
Items
<
'a
,
T
>
{
Items
{
index
:
0
,
rindex
:
self
.nelts
,
lo
:
self
.lo
,
elts
:
self
.elts
.as_slice
()}
}
/// Front-to-back iterator which returns mutable values.
///
/// # Example
///
/// ```rust
/// use std::collections::RingBuf;
///
/// let mut buf = RingBuf::new();
/// buf.push(5i);
/// buf.push(3);
/// buf.push(4);
/// for num in buf.mut_iter() {
/// *num = *num - 2;
/// }
/// assert_eq!(buf.mut_iter().collect::<Vec<&mut int>>().as_slice(), &[&mut 3, &mut 1, &mut 2]);
/// ```
pub
fn
mut_iter
<
'a
>
(
&
'a
mut
self
)
->
MutItems
<
'a
,
T
>
{
let
start_index
=
raw_index
(
self
.lo
,
self
.elts
.len
(),
0
);
let
end_index
=
raw_index
(
self
.lo
,
self
.elts
.len
(),
self
.nelts
);
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录