elixcee 0.10.1

Emulate and execute Excel VBA macros at high speed — without Microsoft Excel
Documentation
# elixcee — Function & VBA Coverage Reference

Complete reference for VBA syntax and worksheet functions supported by elixcee.
Each worksheet function shows the minimum Excel version in which it was introduced as a built-in.

---

## Version Legend

| Label | Minimum Excel Version |
|---|---|
| Classic | Excel 2003 and earlier (always built-in) |
| 2007 | Excel 2007+ |
| 2010 | Excel 2010+ |
| 2013 | Excel 2013+ |
| 2019 | Excel 2019+ |
| 365/2021 | Microsoft 365 / Excel 2021+ |
| 2024/365 | Excel 2024 / Microsoft 365 (latest channel) |

---

## VBA Syntax

| Syntax | Example | Status |
|---|---|---|
| Sub / End Sub | `Sub MySub() ... End Sub` | Done |
| Variable assignment | `a = 10` | Done |
| Cell write | `Cells(1, 1).Value = a` | Done |
| Cell read | `x = Cells(1, 1).Value` | Done |
| Comment | `' comment` | Done |
| Application.Calculation | `Application.Calculation = xlCalculationAutomatic` | Done |
| Arithmetic expressions | `Cells(1, 1).Value = a + 1` | Done |
| For loop | `For i = 1 To N ... Next i` | Done |
| For loop (step) | `For i = 10 To 1 Step -2` | Done |
| If / Else | `If x > 0 Then ... Else ... End If` | Done |
| Single-line If | `If x > 0 Then y = 1 Else y = 2` | Done |
| Do While loop | `Do While x > 0 ... Loop` | Done |
| Select Case | `Select Case x ... End Select` | Done |
| While / Wend | `While x > 0 ... Wend` | Done |
| For Each | `For Each item In collection` | Done |
| With block (sheet) | `With Sheets("Sheet1") ... End With` | Done |
| With block (UDT) | `With p ... .Field = val ... End With` | Done |
| On Error Resume Next | `On Error Resume Next` | Done |
| On Error GoTo label | `On Error GoTo ErrH` | Done |
| Err.Number / Err.Description | Read the number/description of the most recent caught error | Done |
| Err.Clear | Reset `Err.Number` to 0 and `Err.Description` to `""` | Done |
| Err.Raise | `Err.Raise Number[, Source][, Description]``Source` is parsed (so `Description` in the 3rd slot is never misread) but not modeled as a readable property | Done |
| Function / Call | `Function Foo() ... End Function` | Done |
| Exit For / Exit Sub | `Exit For`, `Exit Sub` | Done |
| Array / ReDim | `Dim arr(10)`, `Dim arr(2 To 8)`, `Dim arr()` (dynamic, sized later via `ReDim`), `ReDim arr(n)` | Done |
| Erase | `Erase arr` — resets a fixed-size array's elements to `Empty` in place; comma-separated `Erase a, b` isn't parsed | Done |
| Option Base | `Option Base 1` — sets the default array lower bound (for declarators without an explicit `lo To hi`) | Done |
| Multi-declarator Dim | `Dim a As Integer, b As Range` | Done |
| Const | `Const PI = 3.14` | Done |
| Type ... End Type | User-defined types (UDT) | Done |
| Nested UDT | Field of type UDT (`p.Addr.Street`) | Done |
| Array of UDT | `Dim arr(10) As MyType` | Done |
| Named ranges | `Range("A1:B3").Name = "MyData"` | Done |
| Debug.Print | `Debug.Print x` | Done (no-op) |
| Option Explicit | `Option Explicit` | Done (ignored) |

### Application Object

| Property / Method | Behavior |
|---|---|
| `Application.Calculation = xlCalculationManual` | **Active** — disables auto-recalculation |
| `Application.Calculation = xlCalculationAutomatic` | **Active** — re-evaluates all formula cells |
| `Application.ScreenUpdating = False/True` | **No-op** (no screen) |
| `Application.EnableEvents = False/True` | **No-op** (no events) |
| `Application.DisplayAlerts = False/True` | **No-op** (no dialogs) |
| `Application.StatusBar = "..."` / `False` | **No-op** (no UI) |
| `Application.Cursor = xlWait` / `xlDefault` | **No-op** (no UI) |
| `Application.CutCopyMode = False` | **No-op** (no clipboard) |

---

## Worksheet Functions

### Arithmetic & Statistical

| Function | Description | Excel |
|---|---|---|
| `SUM` | Sum of a range | Classic |
| `AVERAGE` | Average of a range | Classic |
| `MIN` / `MAX` | Minimum / Maximum value | Classic |
| `COUNT` / `COUNTA` | Count of numeric / non-empty cells | Classic |
| `PRODUCT` | Product of all values | Classic |
| `MEDIAN` | Median value | Classic |
| `LARGE` / `SMALL` | Kth largest / smallest | Classic |
| `RANK` | Rank of a number | Classic |
| `ROUND` / `ROUNDUP` / `ROUNDDOWN` | Rounding functions | Classic |
| `INT` | Floor (toward negative infinity) | Classic |
| `TRUNC` | Truncate toward zero | Classic |
| `MOD` | Modulo | Classic |
| `RAND` | Random float 0–1 | Classic |
| `RANDBETWEEN` | Random integer in range | Classic |
| `SUMPRODUCT` | Sum of element-wise products | Classic |
| `COMBIN` | Number of combinations C(n, k) | Classic |
| `COUNTIF` / `SUMIF` / `AVERAGEIF` | Conditional count / sum / average | 2007 |
| `COUNTIFS` / `SUMIFS` / `AVERAGEIFS` | Multi-criteria count / sum / average | 2007 |
| `SUBTOTAL` | Aggregate with selectable function (1–6, 9, 101–106, 109) | Classic |
| `AGGREGATE` | Extended subtotal (1–6, 9, 12–16) | 2010 |
| `PERCENTILE` / `PERCENTILE.INC` | Percentile (inclusive) | Classic / 2010 |
| `PERCENTRANK` / `PERCENTRANK.INC` | Percent rank | Classic / 2010 |
| `MODE.MULT` | Most frequent value | 2010 |
| `MINIFS` / `MAXIFS` | Conditional min / max | 2019 |

### Financial

| Function | Description | Excel |
|---|---|---|
| `PMT`     | Periodic payment for a loan (`rate, nper, pv, [fv], [type]`) | Classic |
| `FACT`    | Factorial n! | Classic |
| `PERMUT`  | Permutations P(n, k) | Classic |
| `GCD`     | Greatest common divisor (varargs) | Classic |
| `LCM`     | Least common multiple (varargs) | Classic |
| `QUOTIENT` | Integer division (truncated quotient) | Classic |
| `SIGN`    | Sign of a number (−1, 0, or 1) | Classic |
| `FV`   | Future value of an investment | Classic |
| `PV`   | Present value of an investment | Classic |
| `NPER` | Number of periods for an annuity | Classic |
| `RATE` | Interest rate per period (Newton-Raphson) | Classic |
| `IPMT` | Interest portion of a periodic payment | Classic |
| `PPMT` | Principal portion of a periodic payment | Classic |
| `NPV`  | Net present value (regular cash flows) | Classic |
| `IRR`  | Internal rate of return (regular cash flows) | Classic |
| `MIRR` | Modified internal rate of return | Classic |
| `XNPV` | Net present value (irregular cash flows, date-weighted) | Classic |
| `XIRR` | Internal rate of return (irregular cash flows) | Classic |

### Statistical

| Function | Description | Excel |
|---|---|---|
| `STDEV` / `STDEV.S` | Sample standard deviation | Classic / 2010 |
| `STDEVP` / `STDEV.P` | Population standard deviation | Classic / 2010 |
| `VAR` / `VAR.S` | Sample variance | Classic / 2010 |
| `VARP` / `VAR.P` | Population variance | Classic / 2010 |
| `CORREL` | Pearson correlation coefficient | Classic |
| `COVARIANCE.S` / `COVAR` | Sample covariance | Classic / 2010 |
| `COVARIANCE.P` | Population covariance | 2010 |
| `NORM.DIST` / `NORMDIST` | Normal distribution CDF or PDF | 2010 / Classic |
| `NORM.INV` / `NORMINV` | Inverse normal distribution | 2010 / Classic |
| `T.DIST` | Student's t-distribution CDF or PDF | 2010 |

### Math & Trigonometry

| Function | Description | Excel |
|---|---|---|
| `ABS` | Absolute value | Classic |
| `SQRT` | Square root | Classic |
| `POWER` | Base raised to an exponent | Classic |
| `EXP` | e raised to a power | Classic |
| `LN` | Natural logarithm | Classic |
| `LOG` / `LOG10` | Logarithm (any base / base 10) | Classic |
| `PI` | Value of π | Classic |
| `SIN` / `COS` / `TAN` | Sine / cosine / tangent | Classic |
| `ASIN` / `ACOS` / `ATAN` / `ATAN2` | Inverse trig functions | Classic |
| `DEGREES` / `RADIANS` | Angle conversion | Classic |
| `FLOOR` / `CEILING` | Round down / up to nearest integer | Classic |
| `FLOOR.MATH` / `CEILING.MATH` | Round down / up to nearest multiple | 2013 |
| `MROUND` | Round to nearest multiple | Classic |

### Logical

| Function | Description | Excel |
|---|---|---|
| `IF` | Conditional value | Classic |
| `AND` / `OR` / `NOT` | Logical operators | Classic |
| `IFERROR` | Fallback on error | 2007 |
| `XOR` | Exclusive OR | 2013 |
| `IFS` | Multi-condition branch | 2019 |
| `SWITCH` | Switch/case | 2019 |

### Text

| Function | Description | Excel |
|---|---|---|
| `LEFT` / `RIGHT` / `MID` | Extract characters | Classic |
| `LEFTB` / `RIGHTB` / `MIDB` | Extract by DBCS bytes | Classic |
| `LEN` / `LENB` | Character / byte count | Classic |
| `UPPER` / `LOWER` / `PROPER` | Case conversion | Classic |
| `TRIM` | Remove extra spaces | Classic |
| `FIND` | Case-sensitive position search | Classic |
| `SEARCH` | Case-insensitive wildcard search | Classic |
| `SUBSTITUTE` | Replace by value | Classic |
| `REPLACE` | Replace by position | Classic |
| `CONCATENATE` | Concatenate strings (legacy) | Classic |
| `TEXT` | Format number as string | Classic |
| `VALUE` | Parse string to number | Classic |
| `EXACT` | Case-sensitive equality | Classic |
| `CHAR` | Character from code point | Classic |
| `CODE` | Code point of first character | Classic |
| `ASC` | Full-width → half-width (DBCS) | Classic |
| `JIS` | Half-width → full-width (DBCS) | Classic |
| `UNICHAR` | Character from Unicode code point | 2013 |
| `UNICODE` | Unicode code point of first character | 2013 |
| `CONCAT` | Concatenate strings / ranges | 2019 |
| `TEXTJOIN` | Join with delimiter | 2019 |
| `TEXTSPLIT` | Split text into an array by a delimiter | 2024/365 |
| `TEXTBEFORE` | Extract text before the Nth occurrence of a delimiter | 2024/365 |
| `TEXTAFTER` | Extract text after the Nth occurrence of a delimiter | 2024/365 |
| `VALUETOTEXT` | Convert any value to its text representation | 2024/365 |
| `REPT` | Repeat a text string N times | Classic |
| `NUMBERVALUE` | Parse number with locale-specific decimal/group separators | 2013 |

### Date & Time

| Function | Description | Excel |
|---|---|---|
| `DATE` | Create date serial (Excel epoch) | Classic |
| `TODAY` / `NOW` | Today's date / current datetime | Classic |
| `YEAR` / `MONTH` / `DAY` | Extract date parts | Classic |
| `WEEKDAY` | Day of week (1–3 return types) | Classic |
| `DATEDIF` | Difference in Y / M / D / MD / YM / YD | Classic |
| `DATEVALUE` | Parse "YYYY/MM/DD" or "YYYY-MM-DD" | Classic |
| `TIME` | Create time serial | Classic |
| `TIMEVALUE` | Parse "HH:MM:SS" | Classic |
| `HOUR` / `MINUTE` / `SECOND` | Extract time parts | Classic |
| `EOMONTH` | Last day of month N months from start | 2007 |
| `EDATE` | Date N months from start | 2007 |
| `NETWORKDAYS` | Workdays between dates (Sat+Sun weekend) | 2007 |
| `WORKDAY` | Date N workdays away (Sat+Sun weekend) | 2007 |
| `NETWORKDAYS.INTL` | Workdays with custom weekend | 2010 |
| `WORKDAY.INTL` | Date N workdays away with custom weekend | 2010 |
| `DAYS` | Days between two dates | 2013 |
| `WEEKNUM` | Week number in a year (types 1/2/11-17/21) | Classic |
| `ISOWEEKNUM` | ISO 8601 week number | 2013 |

### Lookup & Reference

| Function | Description | Excel |
|---|---|---|
| `VLOOKUP` / `HLOOKUP` | Vertical / horizontal lookup | Classic |
| `INDEX` | Value at row/column offset | Classic |
| `MATCH` | Position of a value | Classic |
| `CHOOSE` | Choose from list by index | Classic |
| `INDIRECT` | Evaluate a cell reference from a string | Classic |
| `OFFSET` | Cell reference shifted by rows/cols | Classic |
| `ADDRESS` | Cell address as string (e.g. `"$A$1"`) | Classic |
| `COUNTBLANK` | Count blank cells in a range | Classic |
| `ROW` / `COLUMN` | Row / column number of reference | Classic |
| `LOOKUP` | Sorted vector lookup | Classic |
| `TRANSPOSE` | Transpose rows and columns | Classic |
| `XLOOKUP` | Flexible lookup (exact, next-larger, next-smaller) | 365/2021 |
| `XMATCH` | Extended MATCH with mode/search options | 365/2021 |

### Information

| Function | Description | Excel |
|---|---|---|
| `ISBLANK` | Is the value empty? | Classic |
| `ISERROR` / `ISERR` | Is the value an error? | Classic |
| `ISNA` | Is the value #N/A? | Classic |
| `ISNUMBER` | Is the value numeric? | Classic |
| `ISTEXT` | Is the value a string? | Classic |
| `ISLOGICAL` | Is the value a boolean? | Classic |
| `ISNONTEXT` | Is the value not a string? | Classic |
| `N` | Convert a value to a number | Classic |
| `NA` | Generate an #N/A error value | Classic |
| `TYPE` | Return numeric type code (1=num, 2=text, 4=bool, 16=error, 64=array) | Classic |
| `ERROR.TYPE` | Return numeric code of an error (#NULL!=1 … #N/A=7) | Classic |
| `FORMULATEXT` | Return formula of a cell as text | 2013 |
| `CELL` | Return cell metadata (address, row, col, type, contents, width, …) | Classic |

### Array / Spill Functions

| Function | Description | Excel |
|---|---|---|
| `FILTER` | Filter array by boolean condition | 365/2021 |
| `UNIQUE` | Unique values from a range | 365/2021 |
| `SORT` | Sort a range or array | 365/2021 |
| `SORTBY` | Sort by one or more external arrays | 365/2021 |
| `SEQUENCE` | Generate a sequence of numbers | 365/2021 |
| `RANDARRAY` | Generate a random number array | 365/2021 |
| `TOCOL` | Convert range/array to a single column | 2024/365 |
| `TOROW` | Convert range/array to a single row | 2024/365 |
| `WRAPCOLS` | Wrap 1D array into multiple columns | 2024/365 |
| `WRAPROWS` | Wrap 1D array into multiple rows | 2024/365 |
| `TAKE` | Take first (or last) N elements from an array | 2024/365 |
| `DROP` | Drop first (or last) N elements from an array | 2024/365 |
| `VSTACK` | Stack arrays vertically (concatenate) | 2024/365 |
| `HSTACK` | Stack arrays horizontally (concatenate) | 2024/365 |
| `CHOOSECOLS` | Select specific columns by 1-based index | 2024/365 |
| `CHOOSEROWS` | Select specific rows by 1-based index | 2024/365 |

### Lambda & Higher-Order Functions

| Function | Description | Excel |
|---|---|---|
| `LET` | Assign named variables within a formula | 365/2021 |
| `LAMBDA` | Define an anonymous function | 365/2021 |
| `MAP` | Apply LAMBDA to each element | 365/2021 |
| `REDUCE` | Reduce array to a single value via LAMBDA | 365/2021 |
| `SCAN` | Cumulative reduce (returns all partial results) | 365/2021 |
| `BYROW` | Apply LAMBDA to each row | 365/2021 |
| `BYCOL` | Apply LAMBDA to each column | 365/2021 |

### Database

| Function | Description | Excel |
|---|---|---|
| `DGET`     | Extract a single value from a database matching criteria | Classic |
| `DSUM`     | Sum values in a filtered database column | Classic |
| `DAVERAGE` | Average values in a filtered database column | Classic |
| `DCOUNT`   | Count numeric values in a filtered database column | Classic |
| `DCOUNTA`  | Count all values in a filtered database column | Classic |
| `DMAX`     | Maximum value in a filtered database column | Classic |
| `DMIN`     | Minimum value in a filtered database column | Classic |

---

## Criteria Syntax (COUNTIF / SUMIF / SUMIFS / etc.)

| Criteria | Example | Meaning |
|---|---|---|
| Number | `10` | Exact numeric match |
| String | `"apple"` | Case-insensitive string match |
| Comparison | `">5"`, `"<=10"`, `"<>"` | Numeric comparison |
| Wildcard | `"a*"`, `"?bc"` | `*` = any chars, `?` = one char |

---

## Not Yet Supported

### Excluded (out of scope)

| Function | Reason |
|---|---|
| `IMAGE(source, ...)` | Fetches images from URLs — not applicable in a headless VBA emulator |
| `GROUPBY(row_fields, values, function, ...)` | Complex pivot-style aggregation; requires a multi-dimensional grouping engine |
| `TRIMRANGE(range)` | Trims empty rows/cols from the edges of a range; low usage frequency |

### Text

| Function | Description | Excel |
|---|---|---|
| `PHONETIC` | Extract phonetic (furigana) characters | Classic |
| `BAHTTEXT` | Format number as Thai Baht text | Classic |


### Dynamic Array

| Function | Description | Excel |
|---|---|---|
| `MAKEARRAY` | Generate an array by calling a LAMBDA for each element | 2024/365 |