row.go

package xlsx

import (
	"fmt"
)

// Row represents a single Row in the current Sheet.
type Row struct {
	Hidden       bool         // Hidden determines whether this Row is hidden or not.
	Sheet        *Sheet       // Sheet is a reference back to the Sheet that this Row is within.
	height       float64      // Height is the current height of the Row in PostScript Points
	outlineLevel uint8        // OutlineLevel contains the outline level of this Row.  Used for collapsing.
	isCustom     bool         // isCustom is a flag that is set to true when the Row has been modified
	customHeight bool         // customHeight is a flag to let the writer know that this row has a custom height
	num          int          // Num hold the positional number of the Row in the Sheet
	cellStoreRow CellStoreRow // A reference to the underlying CellStoreRow which handles persistence of the cells
}

// GetCoordinate returns the y coordinate of the row (the row number). This number is zero based, i.e. the Excel CellID "A1" is in Row 0, not Row 1.
func (r *Row) GetCoordinate() int {
	return r.num
}

// setHeight internally sets the "height" value for a row along with letting
// the row object know that there is a custom height for this row
func (r *Row) setHeight(ht float64) {
	r.cellStoreRow.Updatable()
	r.height = ht
	r.customHeight = true
}

// SetHeight sets the height of the Row in PostScript points
func (r *Row) SetHeight(ht float64) {
	r.setHeight(ht)
	r.isCustom = true
}

const cmToPs = 28.3464567

// SetHeightCM sets the height of the Row in centimetres, inherently converting it to PostScript points.
func (r *Row) SetHeightCM(ht float64) {
	r.setHeight(ht * cmToPs) // Convert CM to postscript points
	r.isCustom = true
}

// GetHeight returns the height of the Row in PostScript points.
func (r *Row) GetHeight() float64 {
	return r.height
}

// SetOutlineLevel sets the outline level of the Row (used for collapsing rows)
func (r *Row) SetOutlineLevel(outlineLevel uint8) {
	r.cellStoreRow.Updatable()
	r.outlineLevel = outlineLevel
	if r.Sheet != nil {
		if r.outlineLevel > r.Sheet.SheetFormat.OutlineLevelRow {
			r.Sheet.SheetFormat.OutlineLevelRow = outlineLevel
		}
	}
	r.isCustom = true
}

// GetOutlineLevel returns the outline level of the Row.
func (r *Row) GetOutlineLevel() uint8 {
	return r.outlineLevel
}

// AddCell adds a new Cell to the end of the Row
func (r *Row) AddCell() *Cell {
	r.cellStoreRow.Updatable()
	r.isCustom = true
	cell := r.cellStoreRow.AddCell()
	if cell.num > r.Sheet.MaxCol-1 {
		r.Sheet.MaxCol = cell.num + 1
	}
	return cell
}

// PushCell adds a predefiend cell to the end of the Row
func (r *Row) PushCell(c *Cell) {
	r.cellStoreRow.Updatable()
	r.isCustom = true
	r.cellStoreRow.PushCell(c)
}

func (r *Row) makeCellKey(colIdx int) string {
	return fmt.Sprintf("%s:%06d:%06d", r.Sheet.Name, r.num, colIdx)
}

func (r *Row) key() string {
	return r.makeCellKeyRowPrefix()
}

func (r *Row) makeCellKeyRowPrefix() string {
	return fmt.Sprintf("%s:%06d", r.Sheet.Name, r.num)
}

// GetCell returns the Cell at a given column index, creating it if it doesn't exist.
func (r *Row) GetCell(colIdx int) *Cell {
	return r.cellStoreRow.GetCell(colIdx)
}

// cellVisitorFlags contains flags that can be set by CellVisitorOption implementations to modify the behaviour of ForEachCell.
type cellVisitorFlags struct {
	// skipEmptyCells indicates if we should skip nil cells.
	skipEmptyCells bool
}

// CellVisitorOption is an option for [Row.ForEachCell].
//
// Available options: [SkipEmptyCells].
type CellVisitorOption func(flags *cellVisitorFlags)

// SkipEmptyCells can be passed as an option to [Row.ForEachCell] in
// order to make it skip over empty cells in the sheet.
func SkipEmptyCells(flags *cellVisitorFlags) {
	flags.skipEmptyCells = true
}

// ForEachCell will call the provided [CellVisitorFunc] for each
// currently defined cell in the Row.  Optionally you may pass one or
// more [CellVisitorOption] to affect how ForEachCell operates.  For
// example you may wish to pass [SkipEmptyCells] to only visit cells
// which are populated.
func (r *Row) ForEachCell(cvf CellVisitorFunc, option ...CellVisitorOption) error {
	return r.cellStoreRow.ForEachCell(cvf, option...)
}