행 조작
행의 삽입, 삭제, 복제 및 높이/가시성/아웃라인/스타일 설정을 다룹니다. 모든 행 번호는 1부터 시작합니다.
insert_rows(sheet, start_row, count) / insertRows(sheet, startRow, count)
지정한 행 번호부터 빈 행을 삽입합니다. Comment가 마지막 행을 넘어가게 되면 workbook을 변경하지 않고 오류를 반환합니다.
Rust:
wb.insert_rows("Sheet1", 3, 2)?; // 3rd row onwards, insert 2 rowsTypeScript:
wb.insertRows("Sheet1", 3, 2);remove_row(sheet, row) / removeRow(sheet, row)
행을 삭제합니다. 아래쪽 행이 위로 이동합니다. 삭제된 행을 가리키는 formula reference는 #REF!가 되고, 그 행을 포함하던 range는 축소됩니다. Merge, data validation, conditional format, hyperlink, comment, page break도 같은 방식으로 축소되거나 제거됩니다. Table의 header 행, totals 행, 마지막 data 행을 삭제하면 workbook을 변경하지 않고 오류를 반환합니다.
Rust:
wb.remove_row("Sheet1", 5)?;TypeScript:
wb.removeRow("Sheet1", 5);duplicate_row(sheet, row) / duplicateRow(sheet, row)
지정한 행을 바로 아래에 복제합니다. 복제되는 행의 shared formula는 일반 formula로 기록됩니다.
Rust:
wb.duplicate_row("Sheet1", 2)?;TypeScript:
wb.duplicateRow("Sheet1", 2);set_row_height / get_row_height
행 높이를 포인트 단위로 설정하거나 조회합니다.
Rust:
wb.set_row_height("Sheet1", 1, 30.0)?;
let height: Option<f64> = wb.get_row_height("Sheet1", 1)?;TypeScript:
wb.setRowHeight("Sheet1", 1, 30);
const height: number | null = wb.getRowHeight("Sheet1", 1);set_row_visible / get_row_visible
행의 표시/숨김을 설정하거나 조회합니다.
Rust:
wb.set_row_visible("Sheet1", 3, false)?; // hide
let visible: bool = wb.get_row_visible("Sheet1", 3)?;TypeScript:
wb.setRowVisible("Sheet1", 3, false);
const visible: boolean = wb.getRowVisible("Sheet1", 3);set_row_outline_level / get_row_outline_level
행의 아웃라인(그룹) 수준을 설정하거나 조회합니다. 범위는 0-7입니다.
Rust:
wb.set_row_outline_level("Sheet1", 2, 1)?;
let level: u8 = wb.get_row_outline_level("Sheet1", 2)?;TypeScript:
wb.setRowOutlineLevel("Sheet1", 2, 1);
const level: number = wb.getRowOutlineLevel("Sheet1", 2);set_row_style / get_row_style
행 전체에 스타일 ID를 적용하거나 조회합니다.
Rust:
let style_id = wb.add_style(&style)?;
wb.set_row_style("Sheet1", 1, style_id)?;
let sid: u32 = wb.get_row_style("Sheet1", 1)?;TypeScript:
const styleId = wb.addStyle({ font: { bold: true } });
wb.setRowStyle("Sheet1", 1, styleId);
const sid: number = wb.getRowStyle("Sheet1", 1);열 조작
열의 너비, 가시성, 삽입, 삭제 및 아웃라인/스타일 설정을 다룹니다. 열은 문자열("A", "B", "AA" 등)로 지정합니다.
set_col_width / get_col_width
열 너비를 문자 단위로 설정하거나 조회합니다.
Rust:
wb.set_col_width("Sheet1", "A", 20.0)?;
let width: Option<f64> = wb.get_col_width("Sheet1", "A")?;TypeScript:
wb.setColWidth("Sheet1", "A", 20);
const width: number | null = wb.getColWidth("Sheet1", "A");set_col_visible / get_col_visible
열의 표시/숨김을 설정하거나 조회합니다.
Rust:
wb.set_col_visible("Sheet1", "B", false)?;
let visible: bool = wb.get_col_visible("Sheet1", "B")?;TypeScript:
wb.setColVisible("Sheet1", "B", false);
const visible: boolean = wb.getColVisible("Sheet1", "B");insert_cols(sheet, col, count) / insertCols(sheet, col, count)
지정한 열부터 빈 열을 삽입합니다. Comment가 마지막 열을 넘어가게 되면 workbook을 변경하지 않고 오류를 반환합니다.
Rust:
wb.insert_cols("Sheet1", "C", 3)?;TypeScript:
wb.insertCols("Sheet1", "C", 3);remove_col(sheet, col) / removeCol(sheet, col)
열을 삭제합니다. 오른쪽 열이 왼쪽으로 이동합니다. remove_row와 마찬가지로 삭제된 열을 가리키는 formula reference는 #REF!가 되고, 그 열을 포함하던 range는 축소됩니다. Table 안의 열은 table에서도 제거되며, table의 마지막 열을 삭제하면 workbook을 변경하지 않고 오류를 반환합니다.
Rust:
wb.remove_col("Sheet1", "B")?;TypeScript:
wb.removeCol("Sheet1", "B");set_col_outline_level / get_col_outline_level
열의 아웃라인(그룹) 수준을 설정하거나 조회합니다. 범위는 0-7입니다.
Rust:
wb.set_col_outline_level("Sheet1", "A", 2)?;
let level: u8 = wb.get_col_outline_level("Sheet1", "A")?;TypeScript:
wb.setColOutlineLevel("Sheet1", "A", 2);
const level: number = wb.getColOutlineLevel("Sheet1", "A");set_col_style / get_col_style
열 전체에 스타일 ID를 적용하거나 조회합니다.
Rust:
wb.set_col_style("Sheet1", "A", style_id)?;
let sid: u32 = wb.get_col_style("Sheet1", "A")?;TypeScript:
wb.setColStyle("Sheet1", "A", styleId);
const sid: number = wb.getColStyle("Sheet1", "A");행/열 반복자
시트의 모든 행 또는 열 데이터를 한 번에 조회합니다. 데이터가 있는 행/열만 포함됩니다.
get_rows(sheet) / getRows(sheet)
시트의 모든 행과 셀 데이터를 반환합니다.
Rust:
let rows = wb.get_rows("Sheet1")?;
// Vec<(u32, Vec<(String, CellValue)>)>
// (row_number, [(column_name, value), ...])
for (row_num, cells) in &rows {
for (col, val) in cells {
println!("Row {}, Col {}: {}", row_num, col, val);
}
}TypeScript:
const rows: JsRowData[] = wb.getRows("Sheet1");
for (const row of rows) {
console.log(`Row ${row.row}:`);
for (const cell of row.cells) {
console.log(` ${cell.column}: ${cell.valueType} = ${cell.value}`);
}
}JsRowData 구조:
interface JsRowData {
row: number; // 1-based row number
cells: JsRowCell[];
}
interface JsRowCell {
column: string; // "A", "B", "AA" ...
valueType: string; // "string" | "number" | "boolean" | "date" | "empty" | "error" | "formula"
value?: string; // 문자열, 오류, 수식(식) 셀의 텍스트
numberValue?: number; // 숫자 셀, 또는 날짜 셀의 Excel serial
boolValue?: boolean; // 불리언 셀
formula?: FormulaValue; // 수식 셀의 식과 캐시된 결과
}getRows는 숫자, 불리언, 날짜 셀에 value를 설정하지 않습니다. getCols와 openSheetReader는 날짜 셀의 value에 ISO 날짜 텍스트도 설정합니다. 시트에 수식 셀이 있으면 getRows와 getRowsIterator는 formula 객체를 행 버퍼와 함께 limits.maxOutputBytes에 포함해 계산합니다.
get_cols(sheet) / getCols(sheet)
시트의 모든 열과 셀 데이터를 반환합니다.
Rust:
let cols = wb.get_cols("Sheet1")?;
// Vec<(String, Vec<(u32, CellValue)>)>
// (column_name, [(row_number, value), ...])TypeScript:
const cols: JsColData[] = wb.getCols("Sheet1");
for (const col of cols) {
console.log(`Column ${col.column}:`);
for (const cell of col.cells) {
console.log(` Row ${cell.row}: ${cell.valueType} = ${cell.value}`);
}
}JsColData 구조:
interface JsColData {
column: string; // "A", "B", "AA" ...
cells: JsColCell[];
}
interface JsColCell {
row: number; // 1-based row number
valueType: string; // "string" | "number" | "boolean" | "date" | "empty" | "error" | "formula"
value?: string;
numberValue?: number;
boolValue?: boolean;
formula?: FormulaValue;
}