Skip to content

행 조작 ​

행의 삽입, 삭제, 복제 및 높이/가시성/아웃라인/스타일 설정을 다룹니다. 모든 행 번호는 1부터 시작합니다.

insert_rows(sheet, start_row, count) / insertRows(sheet, startRow, count) ​

지정한 행 번호부터 빈 행을 삽입합니다. Comment가 마지막 행을 넘어가게 되면 workbook을 변경하지 않고 오류를 반환합니다.

Rust:

rust
wb.insert_rows("Sheet1", 3, 2)?; // 3rd row onwards, insert 2 rows

TypeScript:

typescript
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:

rust
wb.remove_row("Sheet1", 5)?;

TypeScript:

typescript
wb.removeRow("Sheet1", 5);

duplicate_row(sheet, row) / duplicateRow(sheet, row) ​

지정한 행을 바로 아래에 복제합니다. 복제되는 행의 shared formula는 일반 formula로 기록됩니다.

Rust:

rust
wb.duplicate_row("Sheet1", 2)?;

TypeScript:

typescript
wb.duplicateRow("Sheet1", 2);

set_row_height / get_row_height ​

행 높이를 포인트 단위로 설정하거나 조회합니다.

Rust:

rust
wb.set_row_height("Sheet1", 1, 30.0)?;
let height: Option<f64> = wb.get_row_height("Sheet1", 1)?;

TypeScript:

typescript
wb.setRowHeight("Sheet1", 1, 30);
const height: number | null = wb.getRowHeight("Sheet1", 1);

set_row_visible / get_row_visible ​

행의 표시/숨김을 설정하거나 조회합니다.

Rust:

rust
wb.set_row_visible("Sheet1", 3, false)?; // hide
let visible: bool = wb.get_row_visible("Sheet1", 3)?;

TypeScript:

typescript
wb.setRowVisible("Sheet1", 3, false);
const visible: boolean = wb.getRowVisible("Sheet1", 3);

set_row_outline_level / get_row_outline_level ​

행의 아웃라인(그룹) 수준을 설정하거나 조회합니다. 범위는 0-7입니다.

Rust:

rust
wb.set_row_outline_level("Sheet1", 2, 1)?;
let level: u8 = wb.get_row_outline_level("Sheet1", 2)?;

TypeScript:

typescript
wb.setRowOutlineLevel("Sheet1", 2, 1);
const level: number = wb.getRowOutlineLevel("Sheet1", 2);

set_row_style / get_row_style ​

행 전체에 스타일 ID를 적용하거나 조회합니다.

Rust:

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:

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:

rust
wb.set_col_width("Sheet1", "A", 20.0)?;
let width: Option<f64> = wb.get_col_width("Sheet1", "A")?;

TypeScript:

typescript
wb.setColWidth("Sheet1", "A", 20);
const width: number | null = wb.getColWidth("Sheet1", "A");

set_col_visible / get_col_visible ​

열의 표시/숨김을 설정하거나 조회합니다.

Rust:

rust
wb.set_col_visible("Sheet1", "B", false)?;
let visible: bool = wb.get_col_visible("Sheet1", "B")?;

TypeScript:

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:

rust
wb.insert_cols("Sheet1", "C", 3)?;

TypeScript:

typescript
wb.insertCols("Sheet1", "C", 3);

remove_col(sheet, col) / removeCol(sheet, col) ​

열을 삭제합니다. 오른쪽 열이 왼쪽으로 이동합니다. remove_row와 마찬가지로 삭제된 열을 가리키는 formula reference는 #REF!가 되고, 그 열을 포함하던 range는 축소됩니다. Table 안의 열은 table에서도 제거되며, table의 마지막 열을 삭제하면 workbook을 변경하지 않고 오류를 반환합니다.

Rust:

rust
wb.remove_col("Sheet1", "B")?;

TypeScript:

typescript
wb.removeCol("Sheet1", "B");

set_col_outline_level / get_col_outline_level ​

열의 아웃라인(그룹) 수준을 설정하거나 조회합니다. 범위는 0-7입니다.

Rust:

rust
wb.set_col_outline_level("Sheet1", "A", 2)?;
let level: u8 = wb.get_col_outline_level("Sheet1", "A")?;

TypeScript:

typescript
wb.setColOutlineLevel("Sheet1", "A", 2);
const level: number = wb.getColOutlineLevel("Sheet1", "A");

set_col_style / get_col_style ​

열 전체에 스타일 ID를 적용하거나 조회합니다.

Rust:

rust
wb.set_col_style("Sheet1", "A", style_id)?;
let sid: u32 = wb.get_col_style("Sheet1", "A")?;

TypeScript:

typescript
wb.setColStyle("Sheet1", "A", styleId);
const sid: number = wb.getColStyle("Sheet1", "A");

행/열 반복자 ​

시트의 모든 행 또는 열 데이터를 한 번에 조회합니다. 데이터가 있는 행/열만 포함됩니다.

get_rows(sheet) / getRows(sheet) ​

시트의 모든 행과 셀 데이터를 반환합니다.

Rust:

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:

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 구조:

typescript
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:

rust
let cols = wb.get_cols("Sheet1")?;
// Vec<(String, Vec<(u32, CellValue)>)>
// (column_name, [(row_number, value), ...])

TypeScript:

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 구조:

typescript
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;
}

MIT / Apache-2.0 라이선스로 배포됩니다.