{ "category": "Information functions", "display_name": "ISERR", "entry_kind": "built_in_function", "eval_api": { "method": "POST", "url": "https://handbook.dnacalc.com/api/eval" }, "function_id": "FUNC.ISERR", "implementation_state": { "answer_bank": { "excel_builds": [ "20430" ], "larger_numeric": 0, "last_bit": 0, "matched": 1227, "other_mismatch": 0, "refused": 0, "rows": 1227, "unread": 0, "worst_ulp": 0 }, "detail": "Recorded: 1,227 in the answer bank and 21 workbook cells.", "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87", "in_catalogue": true, "state": "matches", "state_label": "Matches every recorded Excel answer", "summary": "Matches all 1,248 recorded answers", "workbook_corpus": { "cells": 21, "matched": 21 } }, "implementations": [ { "commit": "9e1884369a678158dd82d3d74188daf986995e87", "flavour": "excel-compatibility-candidate", "language": "Rust", "name": "CalcFunc", "own_code": [ "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/information.rs#L93-L93", "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/information.rs#L165-L178" ], "repository": "https://github.com/DnaCalc/DnaCalc", "shared_code": [ "catalogue/aggregate::reader", "catalogue/aggregate::read_reference", "catalogue/information::unary", "catalogue/information::scalar", "catalogue/information::known", "catalogue/information::predicate", "catalogue/information::each", "catalogue/information::n", "catalogue/information::n_of", "catalogue/information::referenced" ], "source": "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/information.rs#L93-L93", "state": "matches", "suite": null, "summary": "Matches all 1,248 recorded answers" } ], "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.ISERR.json", "name": "ISERR", "notes": [], "schema": "efh.function-reference/v1", "section_order": [ "what-it-does", "try-it", "quirks", "how-to-implement", "version-differences", "alternatives" ], "sections": { "alternatives": "\n### Relationships\n\n\n`ISERR` exists only in contrast, so the contrast is the section:\n\n| Input | `ISERR` | `ISERROR` | `ISNA` |\n|---|---|---|---|\n| `#N/A` | `FALSE` | `TRUE` | `TRUE` |\n| `#VALUE!`, `#DIV/0!`, `#REF!`, `#NAME?`, `#NUM!`, `#NULL!` | `TRUE` | `TRUE` | `FALSE` |\n| anything that is not an error | `FALSE` | `FALSE` | `FALSE` |\n\n- **Choosing between `ISERR` and `ISERROR`** is a semantic decision, not a style one. Wrapping a\n lookup in `IFERROR` or `ISERROR` converts \"not found\" into whatever fallback you supplied,\n which is often exactly wrong: a missing customer becomes a zero, and the zero is then summed.\n `ISERR` (or `IFNA`, or `ISNA`) keeps \"not found\" visible.\n- **`IFNA(x, y)`** is the modern branch form for the `#N/A`-only case; there is no built-in\n `IFERR` that corresponds to `ISERR`, so `IF(ISERR(x), y, x)` remains the idiom when you\n genuinely want \"handle faults, let `#N/A` through\" — at the cost of evaluating `x` twice.\n- **`ERROR.TYPE`** gives the code number instead of a two-way split; `ERROR.TYPE(v) <> 7` is\n another way to write the `ISERR` condition, though it errors rather than returning `FALSE` on\n non-error input.\n- **`NA()`** is the function that manufactures the value `ISERR` is defined to ignore.\n\n\n", "how-to-implement": "\n### Notes for implementers\n\n\n1. **Implement the exclusion at the code level, not by string comparison of a rendered error.**\n Error display text is localized in some surfaces; the code is not.\n2. **Test `ISERR` and `ISERROR` against the same error corpus in the same run.** The two\n functions differ by exactly one row, and a bug that gets `#N/A` wrong in one of them is\n invisible if the two are tested separately with different inputs.\n3. **The error must reach the kernel.** A dispatch layer that short-circuits on error inputs\n makes `ISERR` return the error instead of a `Logical`. The propagation exception has to be\n declared at the function.\n4. **When adding a new error code to an engine, `ISERR` needs a deliberate decision, not a\n default.** Any code that is not `#N/A` falls into `ISERR`'s `TRUE` half automatically under\n the kind-membership reading — which may or may not be what Excel does for the transient\n placeholder codes.\n\n\n", "quirks": "\n### Result and edge cases\n\n\nReturns a `Logical`, or an array of `Logical` when the argument is an array.\n\n- **`#N/A` is `FALSE`.** This is not an edge case, it is the definition, and it is the single\n fact readers come to this page for.\n- **Errors do not propagate.** `ISERR` is one of the declared per-family exceptions to error\n propagation ([coercion and lifting](../model/02-coercion-and-lifting.md)): an error argument\n is classified, not forwarded.\n- **Arrays** are classified elementwise; the result is an array of the same shape.\n- **`Empty`, `Text`, `Number`, `Logical`, `Reference`** are all `FALSE`.\n- **Extended error codes.** Whether `ISERR` answers `TRUE` for `#SPILL!`, `#CALC!`, `#FIELD!`,\n `#BLOCKED!` or `#CONNECT!` is **not established here**. The exclusion is written against\n `#N/A` alone, so the kind-membership reading predicts `TRUE` for all of them, but that\n prediction has not been measured and Microsoft's sentence — which enumerates only the legacy\n seven for `ISERROR` — does not address it.\n\n\n\n### Errors\n\nMicrosoft's IS-functions page documents no error return for `ISERR`.\n\n\n", "sources": "- Microsoft, \"IS functions\" —\n .\n Read for this page: the `ISERR` row (\"any error value except #N/A\"), the `ISERROR` row, and\n the non-conversion remark.\n- Microsoft, \"ERROR.TYPE function\" —\n .\n Read for the code table, which assigns 7 to `#N/A` and 8 to `#GETTING_DATA`.\n- Handbook, [the value universe](../model/01-value-universe.md) — the `Error` kind and the\n legacy/extended split.\n- Handbook, [coercion and lifting](../model/02-coercion-and-lifting.md) — the propagation\n discipline and its declared exceptions.\n\n\n", "version-differences": "The recorded environments below distinguish a reading from a same-input comparison. Counts describe captured inputs in each environment; overlapping captures and comparisons are not totals of unique worksheet calls.\n\n| Excel 16.0 build | Platform and CPU | Captured inputs |\n|---|---|---:|\n| 20430 | Windows, 64-bit, CPU not recorded | 1,227 |\n\nThe record contains no same-input comparison between these environments. Reading different inputs on different builds does not establish either a version change or cross-build agreement.\n\n[Recorded environments and comparison details](https://github.com/DnaCalc/ExcelFunctionsHandbook/blob/5dc75391aa5125ccc5abdb095da85950980d6fd8/content/evidence/environments/FUNC.ISERR.json).", "what-it-does": "\n`ISERR(value)` returns `TRUE` when the value it receives has kind `Error` **and** its code is\nnot `#N/A`. Everything else — including `#N/A` itself — is `FALSE`.\n\nMicrosoft states it as \"Value refers to any error value except #N/A.\" It is the only member of\nthe IS family whose definition is a set difference rather than a kind membership, and that\nsingle exclusion is the whole reason the function is in the product.\n\nThe exclusion encodes a semantic distinction Excel makes everywhere else too: `#N/A` means\n*the value is not available* — a legitimate, expected outcome of a lookup that found nothing —\nwhile the other error codes mean *this formula is wrong*. `ISERR` is the predicate that asks\n\"is something broken?\" without treating a legitimately absent value as breakage.\n\nFormally, over the `Error` kind:\n\n```\nISERR(v) = ISERROR(v) AND NOT ISNA(v)\nISERROR(v) = ISERR(v) OR ISNA(v)\n```\n\nand `ISERR`, `ISNA` partition the error kind into two disjoint halves.\n\n\n\n### Arguments\n\n\n`value` — required, exactly one.\n\nNot converted. Microsoft's IS-functions remark is explicit: \"The value arguments of the IS\nfunctions are not converted.\" A cell containing the *text* `#N/A` (entered as text, or produced\nby `TEXT`/`&`) is `Text`, not `Error`, and `ISERR` returns `FALSE` for it — as does `ISERROR`,\nand as does `ISNA`. If a workbook is behaving as though its errors were invisible to these\npredicates, the first thing to check is whether they are errors at all or strings that look\nlike them.\n\n" }, "signature": { "display": "ISERR(value)", "parameters": [ { "description": null, "name": "value", "optional": false, "repeats": false } ], "trailing_repeats": false }, "sources": { "metadata": { "admission": { "label": "implemented", "reason": null }, "arity": { "max": 1, "min": 1 }, "category": "Information functions", "classification": { "arg_preparation_profile": "ValuesOnlyPreAdapter", "coercion_lift_profile": "None", "determinism_class": "Deterministic", "error_collapse_profile": "None", "fec_dependency_profile": "None", "host_interaction_class": "None", "kernel_signature_class": "Custom", "rich_value_usage": "RichBlind", "surface_fec_dependency_profile": "RefOnly", "thread_safety_class": "SafePure", "volatility_class": "NonVolatile" }, "descriptions": { "long": null, "short": "TRUE for any error value other than #N/A", "short_source": "dna-calc-own" }, "docs": { "english_description": "Returns TRUE if the value is any error value except #N/A", "microsoft_url": "https://support.microsoft.com/en-us/office/is-functions-0f2d7971-6019-40a0-a171-f2d869135665" }, "entry_kind": "built_in_function", "localized_family_names": [ { "locale": "ar-SA", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "bg-BG", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "cs-CZ", "names": [ "ISODD", "JE.CHYBA", "JE.CHYBHODN", "JE.ČISLO", "JE.LOGHODN", "JE.NEDEF", "JE.NETEXT", "JE.ODKAZ", "JE.PRÁZDNÉ", "JE.TEXT" ] }, { "locale": "da-DK", "names": [ "ER.FEJL", "ER.FJL", "ER.IKKE.TEKST", "ER.IKKE.TILGÆNGELIG", "ER.LOGISK", "ER.REFERENCE", "ER.TAL", "ER.TEKST", "ER.TOM", "ER.ULIGE" ] }, { "locale": "de-DE", "names": [ "ISODD", "ISTBEZUG", "ISTFEHL", "ISTFEHLER", "ISTKTEXT", "ISTLEER", "ISTLOG", "ISTNV", "ISTTEXT", "ISTZAHL" ] }, { "locale": "el-GR", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "en-AU", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "en-GB", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "en-US", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "es-ES", "names": [ "ES.IMPAR", "ESBLANCO", "ESERR", "ESERROR", "ESLOGICO", "ESNOD", "ESNOTEXTO", "ESNUMERO", "ESREF", "ESTEXTO" ] }, { "locale": "et-EE", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "fi-FI", "names": [ "ONEI_TEKSTI", "ONLUKU", "ONPARITON", "ONPUUTTUU", "ONTEKSTI", "ONTOTUUS", "ONTYHJÄ", "ONVIITT", "ONVIRH", "ONVIRHE" ] }, { "locale": "fr-FR", "names": [ "EST.IMPAIR", "ESTERR", "ESTERREUR", "ESTLOGIQUE", "ESTNA", "ESTNONTEXTE", "ESTNUM", "ESTREF", "ESTTEXTE", "ESTVIDE" ] }, { "locale": "he-IL", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "hr-HR", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "hu-HU", "names": [ "HIBA.E", "HIBÁS", "HIVATKOZÁS", "LOGIKAI", "NEM.SZÖVEG", "NINCS", "PÁRATLANE", "SZÁM", "SZÖVEG.E", "ÜRES" ] }, { "locale": "id-ID", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "it-IT", "names": [ "ISODD", "VAL.ERR", "VAL.ERRORE", "VAL.LOGICO", "VAL.NON.DISP", "VAL.NON.TESTO", "VAL.NUMERO", "VAL.RIF", "VAL.TESTO", "VAL.VUOTO" ] }, { "locale": "ja-JP", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "ko-KR", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "lt-LT", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "lv-LV", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "nb-NO", "names": [ "ERF", "ERFEIL", "ERIKKETEKST", "ERIT", "ERLOGISK", "ERREF", "ERTALL", "ERTEKST", "ERTOM", "ISODD" ] }, { "locale": "nl-NL", "names": [ "IS.ONEVEN", "ISFOUT", "ISFOUT2", "ISGEENTEKST", "ISGETAL", "ISLEEG", "ISLOGISCH", "ISNB", "ISTEKST", "ISVERWIJZING" ] }, { "locale": "pl-PL", "names": [ "CZY.ADR", "CZY.BŁ", "CZY.BŁĄD", "CZY.BRAK", "CZY.LICZBA", "CZY.LOGICZNA", "CZY.NIE.TEKST", "CZY.NIEPARZYSTE", "CZY.PUSTA", "CZY.TEKST" ] }, { "locale": "pt-BR", "names": [ "É.NÃO.DISP", "É.NÃO.TEXTO", "ÉCÉL.VAZIA", "ÉERRO", "ÉERROS", "ÉLÓGICO", "ÉNÚMERO", "ÉREF", "ÉTEXTO", "ISODD" ] }, { "locale": "pt-PT", "names": [ "É.CÉL.VAZIA", "É.ERRO", "É.ERROS", "É.LÓGICO", "É.NÃO.DISP", "É.NÃO.TEXTO", "É.NÚM", "É.REF", "É.TEXTO", "ÉÍMPAR" ] }, { "locale": "ro-RO", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "ru-RU", "names": [ "ЕЛОГИЧ", "ЕНД", "ЕНЕТЕКСТ", "ЕНЕЧЁТ", "ЕОШ", "ЕОШИБКА", "ЕПУСТО", "ЕССЫЛКА", "ЕТЕКСТ", "ЕЧИСЛО" ] }, { "locale": "sk-SK", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "sl-SI", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "sr-Latn-RS", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "sv-SE", "names": [ "ÄREJTEXT", "ÄRF", "ÄRFEL", "ÄRLOGISK", "ÄRSAKNAD", "ÄRTAL", "ÄRTEXT", "ÄRTOM", "ÄRTOM", "ÄRUDDA" ] }, { "locale": "th-TH", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "tr-TR", "names": [ "EBOŞSA", "EHATA", "EHATALIYSA", "EMANTIKSALSA", "EMETİNDEĞİLSE", "EMETİNSE", "EREFSE", "ESAYIYSA", "EYOKSA", "TEKMİ işlevi" ] }, { "locale": "uk-UA", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "vi-VN", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "zh-CN", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "zh-HK", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] }, { "locale": "zh-TW", "names": [ "ISBLANK", "ISERR", "ISERROR", "ISLOGICAL", "ISNA", "ISNONTEXT", "ISNUMBER", "ISODD", "ISREF", "ISTEXT" ] } ], "localized_names": [], "signature": { "display": "ISERR(value)", "parameters": [ { "description": null, "name": "value", "optional": false, "repeats": false } ], "trailing_repeats": false }, "surface_name": "ISERR", "version_marker": null, "xlcall": { "code": "126", "symbol": "xlfIserr" } }, "microsoft": "https://support.microsoft.com/en-us/office/is-functions-0f2d7971-6019-40a0-a171-f2d869135665" }, "try_it": { "formula": "=ISERR(1)" }, "url": "https://handbook.dnacalc.com/functions/ISERR.html", "variants": [], "versions": [ { "behaviour": "1,227 captured inputs are indexed for this environment. Capture dates: 2026-09-29 to 2026-09-29. This is a reading count, not a comparison with another build.", "excel_build": "16.0 build 20430", "platform": "Windows, 64-bit, CPU not recorded", "sources": [ "https://github.com/DnaCalc/ExcelFunctionsHandbook/blob/5dc75391aa5125ccc5abdb095da85950980d6fd8/content/evidence/environments/FUNC.ISERR.json" ] } ] }