1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. This file may not be copied, modified, or distributed
// except according to those terms.
use crate::sys;
use std::ffi::CStr;
/// A destination for streaming data output. By default, this is
/// a string stream, but it can be redirected to a file.
#[derive(Debug)]
pub struct SBStream {
/// The underlying raw `SBStreamRef`.
pub raw: sys::SBStreamRef,
}
impl SBStream {
/// Construct a new `SBStream`.
pub fn new() -> SBStream {
SBStream::wrap(unsafe { sys::CreateSBStream() })
}
/// Construct a new `SBStream`.
pub(crate) fn wrap(raw: sys::SBStreamRef) -> SBStream {
SBStream { raw }
}
/// Construct a new `Some(SBStream)` or `None`.
#[allow(dead_code)]
pub(crate) fn maybe_wrap(raw: sys::SBStreamRef) -> Option<SBStream> {
if unsafe { sys::SBStreamIsValid(raw) } {
Some(SBStream { raw })
} else {
None
}
}
/// Check whether or not this is a valid `SBStream` value.
pub fn is_valid(&self) -> bool {
unsafe { sys::SBStreamIsValid(self.raw) }
}
/// If the stream is directed to a file, forget about the file and
/// if the ownership of the file was transferred to this object,
/// close the file. If the stream is backed by a local cache, clear
/// this cache.
pub fn clear(&self) {
unsafe { sys::SBStreamClear(self.raw) }
}
/// If this stream is not redirected to a file, this retrieves the
/// locally cached data.
pub fn data(&self) -> &str {
unsafe {
match CStr::from_ptr(sys::SBStreamGetData(self.raw)).to_str() {
Ok(s) => s,
_ => panic!("Invalid string?"),
}
}
}
/// If this stream is not redirected to a file, this retrieves the
/// length of the locally cached data.
pub fn len(&self) -> usize {
unsafe { sys::SBStreamGetSize(self.raw) }
}
/// Is this stream empty?
pub fn is_empty(&self) -> bool {
self.len() == 0
}
}
impl Default for SBStream {
fn default() -> SBStream {
SBStream::new()
}
}
impl Drop for SBStream {
fn drop(&mut self) {
unsafe { sys::DisposeSBStream(self.raw) };
}
}
unsafe impl Send for SBStream {}
unsafe impl Sync for SBStream {}