cell.rs

//! セルの値と、A1 の形の参照

use crate::error::Error;


/// セルに入っているもの
#[derive(Debug, Clone, PartialEq)]
pub enum Value {
    /// 何も入っていない
    Empty,
    /// 数。日付も数で入っている。日付かどうかは書式で決まる
    Number(f64),
    /// 文字
    Text(String),
    /// 真偽
    Boolean(bool),
    /// #N/A や #DIV/0! のようなエラー
    Error(String),
}


impl Value {
    /// 数として読む。数でなければ None
    pub fn number(&self) -> Option<f64> {
        match self {
            Value::Number(value) => Some(*value),
            _ => None,
        }
    }

    /// 文字として読む。文字でなければ None
    pub fn text(&self) -> Option<&str> {
        match self {
            Value::Text(value) => Some(value),
            _ => None,
        }
    }

    /// 何も入っていないか
    pub fn is_empty(&self) -> bool {
        *self == Value::Empty
    }
}


impl From<f64> for Value {
    fn from(value: f64) -> Value {
        Value::Number(value)
    }
}


impl From<i64> for Value {
    fn from(value: i64) -> Value {
        Value::Number(value as f64)
    }
}


impl From<i32> for Value {
    fn from(value: i32) -> Value {
        Value::Number(value as f64)
    }
}


impl From<bool> for Value {
    fn from(value: bool) -> Value {
        Value::Boolean(value)
    }
}


impl From<&str> for Value {
    fn from(value: &str) -> Value {
        Value::Text(value.to_string())
    }
}


impl From<String> for Value {
    fn from(value: String) -> Value {
        Value::Text(value)
    }
}


/// セル 1 つ
#[derive(Debug, Clone, PartialEq)]
pub struct Cell {
    /// 列。1 から始まる
    pub column: u32,
    /// 書式の番号。styles.xml の cellXfs での位置
    pub style: u32,
    /// 入っているもの
    pub value: Value,
    /// 数式。ないときは空。`=` は含まない
    pub formula: String,
}


impl Cell {
    /// 書式を指定しないセル
    pub fn new(column: u32, value: Value) -> Cell {
        Cell {column, style: 0, value, formula: String::new()}
    }

    /// 書式を指定するセル
    pub fn styled(column: u32, value: Value, style: u32) -> Cell {
        Cell {column, style, value, formula: String::new()}
    }
}


/// 行 1 つ。値の入っているセルだけが、列の順に並ぶ
#[derive(Debug, Clone, Default)]
pub struct Row {
    /// 行番号。1 から始まる
    pub number: u32,
    /// この行のセル
    pub cell: Vec<Cell>,
}


impl Row {
    /// 列で引く。そのセルがなければ None
    pub fn at(&self, column: u32) -> Option<&Cell> {
        // 列の順に並んでいるので、二分で引ける
        match self.cell.binary_search_by(|one| one.column.cmp(&column)) {
            Ok(index) => Some(&self.cell[index]),
            Err(_) => None,
        }
    }
}


/// A1 の形の参照から列を読む。1 から始まる。読めなければ 0
pub fn column_of(reference: &str) -> u32 {
    let mut result = 0;

    for value in reference.bytes() {
        if !value.is_ascii_alphabetic() {
            break;
        }

        result = result * 26 + (value.to_ascii_uppercase() - b'A' + 1) as u32;
    }

    result
}


/// A1 の形の参照から行を読む。1 から始まる。読めなければ 0
pub fn row_of(reference: &str) -> u32 {
    let mut result = 0;
    let mut found = false;

    for value in reference.bytes() {
        if value.is_ascii_digit() {
            result = result * 10 + (value - b'0') as u32;
            found = true;
            continue;
        }

        if found {
            break;
        }
    }

    result
}


/// 列の番号を A、B、… AA の形に直す
pub fn letter_of(column: u32) -> String {
    if column == 0 {
        return String::new();
    }

    let mut rest = column;
    let mut result = Vec::new();

    while rest > 0 {
        let step = (rest - 1) % 26;
        result.push(b'A' + step as u8);
        rest = (rest - 1) / 26;
    }

    result.reverse();
    String::from_utf8(result).unwrap_or_default()
}


/// 列と行の番号を A1 の形に直す
pub fn name_of(column: u32, row: u32) -> String {
    format!("{}{}", letter_of(column), row)
}


/// 列の番号が Excel の上限に収まっているか確かめる
pub fn check(column: u32, row: u32) -> Result<(), Error> {
    if column < 1 || column > 16384 {
        return Err(Error::new(format!("列 {column} は 1 から 16384 の外です")));
    }

    if row < 1 || row > 1048576 {
        return Err(Error::new(format!("行 {row} は 1 から 1048576 の外です")));
    }

    Ok(())
}