{ "category": "Information functions", "display_name": "ISNONTEXT", "entry_kind": "built_in_function", "eval_api": { "method": "POST", "url": "https://handbook.dnacalc.com/api/eval" }, "function_id": "FUNC.ISNONTEXT", "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 10 workbook cells.", "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87", "in_catalogue": true, "state": "matches", "state_label": "Matches every recorded Excel answer", "summary": "Matches all 1,237 recorded answers", "workbook_corpus": { "cells": 10, "matched": 10 } }, "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#L98-L98", "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/information.rs#L220-L228" ], "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#L98-L98", "state": "matches", "suite": null, "summary": "Matches all 1,237 recorded answers" } ], "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.ISNONTEXT.json", "name": "ISNONTEXT", "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- **`ISTEXT`** is the exact complement, and the two should always be thought of as one function\n with a sign. If you find yourself writing `NOT(ISTEXT(x))`, write `ISNONTEXT(x)`; if you find\n yourself writing `NOT(ISNONTEXT(x))`, write `ISTEXT(x)`.\n- **`ISBLANK`** overlaps but is far narrower: `ISBLANK` is `TRUE` only for `Empty`, whereas\n `ISNONTEXT` is `TRUE` for `Empty` *and* five other kinds. `ISNONTEXT` is not a blank test,\n despite the parenthetical that makes it look like one.\n- **`ISNUMBER`** is what people usually mean when they reach for `ISNONTEXT`. If the question is\n \"is this a usable number?\", `ISNUMBER` is the predicate; `ISNONTEXT` will happily say `TRUE`\n about `#DIV/0!`.\n- **`T(value)`** returns the empty string for exactly the values `ISNONTEXT` calls `TRUE`.\n- **`TYPE`** distinguishes what `ISNONTEXT` lumps together: `1` number, `4` logical, `16` error,\n `64` array. If you need to know *which* non-text thing you have, `TYPE` is the function.\n\n\n", "how-to-implement": "\n### Notes for implementers\n\n\n1. **Derive it from `ISTEXT`.** One predicate, one negation. Writing `ISNONTEXT` independently\n guarantees an eventual divergence on some kind added later — and the divergence will be\n silent, because both functions return a plausible boolean either way.\n2. **Include `Empty` on the `TRUE` side deliberately**, with the Microsoft parenthetical cited in\n the code comment. It looks like a bug to anyone reading the implementation cold, and someone\n will eventually \"fix\" it.\n3. **Errors must reach the kernel**, or `ISNONTEXT` will forward the error instead of returning\n `TRUE`.\n4. **Reference arguments.** `ISNONTEXT` sees values, not references, so the `Reference` row above\n is reachable only through a path that hands the function an unresolved reference — which\n values-only preparation is supposed to prevent. If it happens, something upstream is wrong.\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- **A blank cell is `TRUE`.** Documented by Microsoft in the function table itself, so this is\n not an inference.\n- **The zero-length string is `FALSE`**, because it is `Text`. `ISNONTEXT(\"\")` and\n `ISNONTEXT()` therefore disagree — the pair is a compact way to distinguish\n `Empty` from `Text(\"\")` without using `ISBLANK`.\n- **Errors are `TRUE` and do not propagate.** `ISNONTEXT` is one of the declared per-family\n exceptions to the propagation discipline in\n [coercion and lifting](../model/02-coercion-and-lifting.md). An error input is classified, not\n forwarded — which means `ISNONTEXT(#VALUE!)` is the `Logical` `TRUE`, not `#VALUE!`.\n- **Arrays** are classified elementwise into a same-shaped mask.\n\n\n\n### Errors\n\nMicrosoft's IS-functions page documents no error return for `ISNONTEXT`.\n\n\n", "sources": "- Microsoft, \"IS functions\" —\n .\n Read for this page: the `ISNONTEXT` row including its blank-cell parenthetical, verbatim, and\n the non-conversion remark.\n- Handbook, [the value universe](../model/01-value-universe.md) — the kind inventory this\n function negates over.\n- Handbook, [coercion and lifting](../model/02-coercion-and-lifting.md) — the inspection\n functions' exemption from error propagation.\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.ISNONTEXT.json).", "what-it-does": "\n`ISNONTEXT(value)` returns `TRUE` when the value it receives does **not** have kind `Text`, and\n`FALSE` when it does.\n\nMicrosoft states it as \"Value refers to any item that is not text\", and adds a parenthetical\nthat carries more weight than its size suggests: \"(Note that this function returns TRUE if the\nvalue refers to a blank cell.)\"\n\nThat note is the page. `ISNONTEXT` is a negation, so it inherits everything the `Text` kind\nexcludes:\n\n| Value kind | `ISNONTEXT` |\n|---|---|\n| `Number` (including dates, times, currency) | `TRUE` |\n| `Logical` | `TRUE` |\n| `Error` (any code, including `#N/A`) | `TRUE` |\n| `Empty` — a blank cell | `TRUE` |\n| `Reference` | `TRUE` |\n| `Text` (including the zero-length string) | `FALSE` |\n\nThe trap is reading `ISNONTEXT` as \"has a proper value in it\". It does not mean that. It is\n`TRUE` for a blank cell and `TRUE` for `#REF!`, which are two of the least value-bearing things\na cell can hold.\n\n\n\n### Arguments\n\n\n`value` — required, exactly one.\n\nNot converted. Microsoft's remark: \"The value arguments of the IS functions are not converted.\"\nSince `ISNONTEXT` is defined by negating a kind test, non-conversion means the negation is over\nthe *kind* delivered, not over any parse attempt.\n\n" }, "signature": { "display": "ISNONTEXT(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 when the value is anything but text", "short_source": "dna-calc-own" }, "docs": { "english_description": "Returns TRUE if the value is not text", "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": "ISNONTEXT(value)", "parameters": [ { "description": null, "name": "value", "optional": false, "repeats": false } ], "trailing_repeats": false }, "surface_name": "ISNONTEXT", "version_marker": null, "xlcall": { "code": "190", "symbol": "xlfIsnontext" } }, "microsoft": "https://support.microsoft.com/en-us/office/is-functions-0f2d7971-6019-40a0-a171-f2d869135665" }, "try_it": { "formula": "=ISNONTEXT(\"\")" }, "url": "https://handbook.dnacalc.com/functions/ISNONTEXT.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.ISNONTEXT.json" ] } ] }