169 lines
8.5 KiB
Go
169 lines
8.5 KiB
Go
// Copyright 2016 - 2021 The excelize Authors. All rights reserved. Use of
|
|
// this source code is governed by a BSD-style license that can be found in
|
|
// the LICENSE file.
|
|
//
|
|
// Package excelize providing a set of functions that allow you to write to
|
|
// and read from XLSX / XLSM / XLTM files. Supports reading and writing
|
|
// spreadsheet documents generated by Microsoft Excel™ 2007 and later. Supports
|
|
// complex components by high compatibility, and provided streaming API for
|
|
// generating or reading data from a worksheet with huge amounts of data. This
|
|
// library needs Go version 1.15 or later.
|
|
|
|
package excelize
|
|
|
|
import (
|
|
"errors"
|
|
"fmt"
|
|
)
|
|
|
|
// newInvalidColumnNameError defined the error message on receiving the invalid column name.
|
|
func newInvalidColumnNameError(col string) error {
|
|
return fmt.Errorf("invalid column name %q", col)
|
|
}
|
|
|
|
// newInvalidRowNumberError defined the error message on receiving the invalid row number.
|
|
func newInvalidRowNumberError(row int) error {
|
|
return fmt.Errorf("invalid row number %d", row)
|
|
}
|
|
|
|
// newInvalidCellNameError defined the error message on receiving the invalid cell name.
|
|
func newInvalidCellNameError(cell string) error {
|
|
return fmt.Errorf("invalid cell name %q", cell)
|
|
}
|
|
|
|
// newInvalidExcelDateError defined the error message on receiving the data with negative values.
|
|
func newInvalidExcelDateError(dateValue float64) error {
|
|
return fmt.Errorf("invalid date value %f, negative values are not supported", dateValue)
|
|
}
|
|
|
|
// newUnsupportChartType defined the error message on receiving the chart type are unsupported.
|
|
func newUnsupportChartType(chartType string) error {
|
|
return fmt.Errorf("unsupported chart type %s", chartType)
|
|
}
|
|
|
|
// newUnzipSizeLimitError defined the error message on unzip size exceeds the limit.
|
|
func newUnzipSizeLimitError(unzipSizeLimit int64) error {
|
|
return fmt.Errorf("unzip size exceeds the %d bytes limit", unzipSizeLimit)
|
|
}
|
|
|
|
// newInvalidStyleID defined the error message on receiving the invalid style ID.
|
|
func newInvalidStyleID(styleID int) error {
|
|
return fmt.Errorf("invalid style ID %d, negative values are not supported", styleID)
|
|
}
|
|
|
|
// newFieldLengthError defined the error message on receiving the field length overflow.
|
|
func newFieldLengthError(name string) error {
|
|
return fmt.Errorf("field %s must be less or equal than 255 characters", name)
|
|
}
|
|
|
|
// newCellNameToCoordinatesError defined the error message on converts
|
|
// alphanumeric cell name to coordinates.
|
|
func newCellNameToCoordinatesError(cell string, err error) error {
|
|
return fmt.Errorf("cannot convert cell %q to coordinates: %v", cell, err)
|
|
}
|
|
|
|
var (
|
|
// ErrStreamSetColWidth defined the error message on set column width in
|
|
// stream writing mode.
|
|
ErrStreamSetColWidth = errors.New("must call the SetColWidth function before the SetRow function")
|
|
// ErrColumnNumber defined the error message on receive an invalid column
|
|
// number.
|
|
ErrColumnNumber = errors.New("column number exceeds maximum limit")
|
|
// ErrColumnWidth defined the error message on receive an invalid column
|
|
// width.
|
|
ErrColumnWidth = fmt.Errorf("the width of the column must be smaller than or equal to %d characters", MaxColumnWidth)
|
|
// ErrOutlineLevel defined the error message on receive an invalid outline
|
|
// level number.
|
|
ErrOutlineLevel = errors.New("invalid outline level")
|
|
// ErrCoordinates defined the error message on invalid coordinates tuples
|
|
// length.
|
|
ErrCoordinates = errors.New("coordinates length must be 4")
|
|
// ErrExistsWorksheet defined the error message on given worksheet already
|
|
// exists.
|
|
ErrExistsWorksheet = errors.New("the same name worksheet already exists")
|
|
// ErrTotalSheetHyperlinks defined the error message on hyperlinks count
|
|
// overflow.
|
|
ErrTotalSheetHyperlinks = errors.New("over maximum limit hyperlinks in a worksheet")
|
|
// ErrInvalidFormula defined the error message on receive an invalid
|
|
// formula.
|
|
ErrInvalidFormula = errors.New("formula not valid")
|
|
// ErrAddVBAProject defined the error message on add the VBA project in
|
|
// the workbook.
|
|
ErrAddVBAProject = errors.New("unsupported VBA project extension")
|
|
// ErrMaxRows defined the error message on receive a row number exceeds maximum limit.
|
|
ErrMaxRows = errors.New("row number exceeds maximum limit")
|
|
// ErrMaxRowHeight defined the error message on receive an invalid row
|
|
// height.
|
|
ErrMaxRowHeight = errors.New("the height of the row must be smaller than or equal to 409 points")
|
|
// ErrImgExt defined the error message on receive an unsupported image
|
|
// extension.
|
|
ErrImgExt = errors.New("unsupported image extension")
|
|
// ErrMaxFileNameLength defined the error message on receive the file name
|
|
// length overflow.
|
|
ErrMaxFileNameLength = errors.New("file name length exceeds maximum limit")
|
|
// ErrEncrypt defined the error message on encryption spreadsheet.
|
|
ErrEncrypt = errors.New("not support encryption currently")
|
|
// ErrUnknownEncryptMechanism defined the error message on unsupport
|
|
// encryption mechanism.
|
|
ErrUnknownEncryptMechanism = errors.New("unknown encryption mechanism")
|
|
// ErrUnsupportEncryptMechanism defined the error message on unsupport
|
|
// encryption mechanism.
|
|
ErrUnsupportEncryptMechanism = errors.New("unsupport encryption mechanism")
|
|
// ErrParameterRequired defined the error message on receive the empty
|
|
// parameter.
|
|
ErrParameterRequired = errors.New("parameter is required")
|
|
// ErrParameterInvalid defined the error message on receive the invalid
|
|
// parameter.
|
|
ErrParameterInvalid = errors.New("parameter is invalid")
|
|
// ErrDefinedNameScope defined the error message on not found defined name
|
|
// in the given scope.
|
|
ErrDefinedNameScope = errors.New("no defined name on the scope")
|
|
// ErrDefinedNameduplicate defined the error message on the same name
|
|
// already exists on the scope.
|
|
ErrDefinedNameduplicate = errors.New("the same name already exists on the scope")
|
|
// ErrCustomNumFmt defined the error message on receive the empty custom number format.
|
|
ErrCustomNumFmt = errors.New("custom number format can not be empty")
|
|
// ErrFontLength defined the error message on the length of the font
|
|
// family name overflow.
|
|
ErrFontLength = errors.New("the length of the font family name must be smaller than or equal to 31")
|
|
// ErrFontSize defined the error message on the size of the font is invalid.
|
|
ErrFontSize = errors.New("font size must be between 1 and 409 points")
|
|
// ErrSheetIdx defined the error message on receive the invalid worksheet
|
|
// index.
|
|
ErrSheetIdx = errors.New("invalid worksheet index")
|
|
// ErrGroupSheets defined the error message on group sheets.
|
|
ErrGroupSheets = errors.New("group worksheet must contain an active worksheet")
|
|
// ErrDataValidationFormulaLenth defined the error message for receiving a
|
|
// data validation formula length that exceeds the limit.
|
|
ErrDataValidationFormulaLenth = errors.New("data validation must be 0-255 characters")
|
|
// ErrDataValidationRange defined the error message on set decimal range
|
|
// exceeds limit.
|
|
ErrDataValidationRange = errors.New("data validation range exceeds limit")
|
|
// ErrCellCharsLength defined the error message for receiving a cell
|
|
// characters length that exceeds the limit.
|
|
ErrCellCharsLength = fmt.Errorf("cell value must be 0-%d characters", TotalCellChars)
|
|
// ErrOptionsUnzipSizeLimit defined the error message for receiving
|
|
// invalid UnzipSizeLimit and UnzipXMLSizeLimit.
|
|
ErrOptionsUnzipSizeLimit = errors.New("the value of UnzipSizeLimit should be greater than or equal to UnzipXMLSizeLimit")
|
|
// ErrSave defined the error message for saving file.
|
|
ErrSave = errors.New("no path defined for file, consider File.WriteTo or File.Write")
|
|
// ErrAttrValBool defined the error message on marshal and unmarshal
|
|
// boolean type XML attribute.
|
|
ErrAttrValBool = errors.New("unexpected child of attrValBool")
|
|
// ErrSparklineType defined the error message on receive the invalid
|
|
// sparkline Type parameters.
|
|
ErrSparklineType = errors.New("parameter 'Type' must be 'line', 'column' or 'win_loss'")
|
|
// ErrSparklineLocation defined the error message on missing Location
|
|
// parameters
|
|
ErrSparklineLocation = errors.New("parameter 'Location' is required")
|
|
// ErrSparklineRange defined the error message on missing sparkline Range
|
|
// parameters
|
|
ErrSparklineRange = errors.New("parameter 'Range' is required")
|
|
// ErrSparkline defined the error message on receive the invalid sparkline
|
|
// parameters.
|
|
ErrSparkline = errors.New("must have the same number of 'Location' and 'Range' parameters")
|
|
// ErrSparklineStyle defined the error message on receive the invalid
|
|
// sparkline Style parameters.
|
|
ErrSparklineStyle = errors.New("parameter 'Style' must betweent 0-35")
|
|
)
|