Struct Table 

#[non_exhaustive]
pub struct Table {
    pub rows: Vec<TableRow>,
    pub width: Option<HwpUnit>,
    pub caption: Option<Caption>,
    pub page_break: TablePageBreak,
    pub repeat_header: bool,
    pub cell_spacing: Option<HwpUnit>,
    pub border_fill_id: Option<u32>,
    pub inst_id: Option<ObjectId>,
}

A table: a sequence of rows, with optional width and caption.

Design Decision

No border: Option<BorderStyle> in Phase 1. Border styling is a Blueprint concern (Phase 2). Core tables are purely structural.

Examples

use hwpforge_core::table::{Table, TableCell, TablePageBreak, TableRow};
use hwpforge_core::paragraph::Paragraph;
use hwpforge_foundation::{HwpUnit, ParaShapeIndex};

let table = Table::new(vec![TableRow::new(vec![TableCell::new(
    vec![Paragraph::new(ParaShapeIndex::new(0))],
    HwpUnit::from_mm(100.0).unwrap(),
)])])
.with_page_break(TablePageBreak::Cell);
assert_eq!(table.row_count(), 1);

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

rows: Vec<TableRow>

Rows of the table.

width: Option<HwpUnit>

Optional explicit table width. None means auto-width.

caption: Option<Caption>

Optional table caption.

page_break: TablePageBreak

Page-break policy for this table.

repeat_header: bool

Whether the first row repeats across page breaks.

cell_spacing: Option<HwpUnit>

Optional explicit spacing between table cells.

border_fill_id: Option<u32>

Optional table-level border/fill reference.

inst_id: Option<ObjectId>

Wave 12p Step 2b: instance ID for cross-ref target lookup. HWP5 변환 시 Table CtrlHeader trailer 의 instance ID 가 채워지고, HWPX encoder 가 <hp:tbl id="..."> attribute 로 emit. None 이면 encoder 가 fallback 값 (예: sequential counter) 사용 허용.

Implementations

impl Table

pub fn new(rows: Vec<TableRow>) -> Self

Creates a table from rows.

Examples

use hwpforge_core::table::{Table, TableRow};

let table = Table::new(vec![TableRow::new(vec![])]);
assert_eq!(table.row_count(), 1);

pub fn with_width(self, width: HwpUnit) -> Self

Sets an explicit table width.

pub fn with_caption(self, caption: Caption) -> Self

Attaches a table caption.

pub fn with_page_break(self, page_break: TablePageBreak) -> Self

Sets the page-break policy for this table.

pub fn with_repeat_header(self, repeat_header: bool) -> Self

Controls whether the leading header block repeats across page breaks.

pub fn with_cell_spacing(self, cell_spacing: HwpUnit) -> Self

Sets the explicit spacing between cells.

pub fn with_border_fill_id(self, border_fill_id: u32) -> Self

Sets the table-level border/fill reference.

pub fn row_count(&self) -> usize

Returns the number of rows.

pub fn col_count(&self) -> usize

Returns the number of columns (from the first row).

Returns 0 if the table has no rows.

pub fn is_empty(&self) -> bool

Returns true if the table has no rows.

Trait Implementations

impl Clone for Table

fn clone(&self) -> Table

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Table

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Table

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Table

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

Formats the value using the given formatter.

impl JsonSchema for Table

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for Table

fn eq(&self, other: &Table) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Table

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Table