Struct rustdx::tcp::stock::Kline

pub struct Kline<'d> {
    pub send: Box<[u8]>,
    pub market: u16,
    pub code: &'d str,
    pub category: u16,
    pub start: u16,
    pub count: u16,
    pub response: Vec<u8>,
    pub data: Vec<KlineData<'d>>,
}

查询股票日线。对应于 pytdx 中的 hq.get_security_bars、GetSecurityBarsCmd。

注意

只修改字段并不会更改待发送字节的内容。 如果你需要修改查询条件，请使用相应的方法。 比如修改股票代码调用 Kline::code，修改查询数量调用 Kline::count。

Fields

send: Box<[u8]>

market: u16

code: &'d str

category: u16

start: u16

count: u16

response: Vec<u8>

data: Vec<KlineData<'d>>

Implementations

impl<'d> Kline<'d>

pub fn new( market: u16, code: &'d str, category: u16, start: u16, count: u16 ) -> Self

0 代表深市；1 代表沪市。

panic

当 code 的字节长度不是 6 时，程序会 panic。

pub fn market(&mut self, market: u16) -> &mut Self

修改市场。

pub fn code(&mut self, code: &'d str) -> &mut Self

修改股票。当代码不正确时，不能正常得到响应。

panic

当 code 的字节长度不是 6 时，程序会 panic。

pub fn category(&mut self, category: u16) -> &mut Self

修改 K 线类型。

pub fn start(&mut self, start: u16) -> &mut Self

修改起始位置。

pub fn count(&mut self, count: u16) -> &mut Self

修改查询数量。

注意：此方法调用了 Vec::resize_with

1. 如果此次修改的查询数量大于修改前的查询数量， 则 data 字段除了保持已有的数据，还会会增加默认值。
2. 如果此次修改的查询数量小于或等于修改前的查询数量， 则 data 字段截断已有的数据。
3. 无论以上哪种情况，目的都是保证查询数量与 data 字段的 Vec 长度一致。

Trait Implementations

impl<'d> Clone for Kline<'d>

fn clone(&self) -> Kline<'d>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'d> Debug for Kline<'d>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'d> Default for Kline<'d>

为了对应 Kline::SEND 的含义，以下默认值值得注意：

1. category 默认为 9 （日线）；
2. code 默认为 000001；
3. count 默认为 3；
4. KlineData.dt.hour 默认小时数为 15。

fn default() -> Self

Returns the “default value” for a type.

impl<'a> Tdx for Kline<'a>

const SEND: &'static [u8] = _

#sz000001# 最近三天日线的请求字节。长度为 38。

struct.pack("<HIHHHH6sHHHHIIH", bytes) # python 中的解读方式

type Item = [KlineData<'a>]

const TAG: &'static str = "日线"

描述此次 tcp 连接的用途，目前用于记录日志。

fn send(&mut self) -> &[u8]

真正发送的字节。

fn parse(&mut self, v: Vec<u8>)

解析响应的字节。

fn result(&self) -> &Self::Item

解析后的结果。可以是引用，也可以是 owned type 。

const LEN: usize = _

发送的字节的长度。每种请求所发送的字节长度是已知的。默认为 Tdx::SEND 的长度。

fn recv(&mut self, tcp: &mut Tcp) -> Result<Vec<u8>>

得到响应的字节。响应的字节长度无法预测。

fn recv_parsed(&mut self, tcp: &mut Tcp) -> Result<&Self::Item>

得到和解析响应的字节，并返回解析的数据。