{
  "category": "Logical functions",
  "display_name": "OR",
  "entry_kind": "built_in_function",
  "eval_api": {
    "method": "POST",
    "url": "https://handbook.dnacalc.com/api/eval"
  },
  "function_id": "FUNC.OR",
  "implementation_state": {
    "answer_bank": {
      "excel_builds": [
        "20430"
      ],
      "larger_numeric": 0,
      "last_bit": 0,
      "matched": 1212,
      "other_mismatch": 0,
      "refused": 0,
      "rows": 1212,
      "unread": 0,
      "worst_ulp": 0
    },
    "detail": "Recorded: 1,212 in the answer bank and 35 workbook cells.",
    "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87",
    "in_catalogue": true,
    "state": "matches",
    "state_label": "Matches every recorded Excel answer",
    "summary": "Matches all 1,247 recorded answers",
    "workbook_corpus": {
      "cells": 35,
      "matched": 35
    }
  },
  "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/logical.rs#L99-L99",
        "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/logical.rs#L150-L156"
      ],
      "repository": "https://github.com/DnaCalc/DnaCalc",
      "shared_code": [
        "catalogue/aggregate::reader",
        "catalogue/aggregate::read_reference",
        "catalogue/logical::logicals",
        "catalogue/logical::decide",
        "catalogue/logical::tally",
        "catalogue/logical::direct",
        "catalogue/logical::held",
        "catalogue/logical::not_callable"
      ],
      "source": "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/logical.rs#L99-L99",
      "state": "matches",
      "suite": null,
      "summary": "Matches all 1,247 recorded answers"
    }
  ],
  "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.OR.json",
  "name": "OR",
  "notes": [],
  "schema": "efh.function-reference/v1",
  "section_order": [
    "what-it-does",
    "try-it",
    "quirks",
    "how-to-implement",
    "version-differences",
    "alternatives"
  ],
  "sections": {
    "alternatives": "\n[AND](FUNC.AND.md) requires every considered value to be true. [XOR](FUNC.XOR.md) tests whether\nan odd number are true. Use [IF](FUNC.IF.md) to select between calculations. For elementwise\nlogic in an array, ordinary comparisons or MAP may express the intended shape more directly.\n\n\n",
    "how-to-implement": "\nTrack both an accumulated truth value and whether any eligible item has been seen. Classify\ndirect arguments and referenced or array-contained values according to their distinct coercion\nrules. Fold eligible values into the accumulator, preserving the required error behaviour.\nAfter a successful scan, return `#VALUE!` if none were eligible, otherwise return the logical\naccumulator.\n\nShare the item classifier with AND and XOR so that blank, text and error policies cannot drift.\nA fast exit on TRUE is valid only if it preserves argument evaluation and error ordering for the\ntarget Excel build. Test that separately from the truth table.\n\n\n",
    "quirks": "\nMicrosoft documents that text and empty cells in a referenced range or array are ignored. If\nthere is no logical or numeric value to consider, OR returns `#VALUE!`. An all-ignored scan is\ndifferent from considering one or more false values.\n\nDo not assume OR is a programming-language short-circuit operator. A true value does not by\nitself establish that an error or an expensive expression elsewhere in the call is skipped.\nText supplied directly as an argument also needs its own coercion checks; the rule about text\nin a range is not a universal rule about text.\n\n\n",
    "sources": "\n- [Microsoft: OR function](https://support.microsoft.com/en-us/excel/functions/or-function).\n- [Coercion and lifting](../model/02-coercion-and-lifting.md).\n\n",
    "try-it": "\nTry `=OR(FALSE,2>1)`, `=OR(0,0)` and `=OR({0;1;0})`. A range example needs actual input cells:\nenter B2 and B3 in the input-cell editor, then calculate `=OR(B2:B3)`.\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,212 |\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.OR.json).",
    "what-it-does": "\n`OR(logical1, [logical2], …)` returns TRUE if at least one considered value is true, otherwise\nFALSE. It accepts up to 255 arguments. Numeric zero is false; other numeric values are true.\n\n`=OR(FALSE,2>1)` returns TRUE. An array or range is scanned as a collection of values and the\nresult is one logical value, rather than a separate result for every position.\n\n\n"
  },
  "signature": {
    "display": "OR(logical1, [logical2], ...)",
    "parameters": [
      {
        "description": null,
        "name": "logical1",
        "optional": false,
        "repeats": false
      },
      {
        "description": null,
        "name": "logical2",
        "optional": true,
        "repeats": true
      }
    ],
    "trailing_repeats": true
  },
  "sources": {
    "metadata": {
      "admission": {
        "label": "implemented",
        "reason": null
      },
      "arity": {
        "max": 255,
        "min": 1
      },
      "category": "Logical functions",
      "classification": {
        "arg_preparation_profile": "ValuesOnlyPreAdapter",
        "coercion_lift_profile": "Custom",
        "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 at least one argument is TRUE",
        "short_source": "dna-calc-own"
      },
      "docs": {
        "english_description": "Returns TRUE if any argument is TRUE",
        "microsoft_url": "https://support.microsoft.com/en-us/office/or-function-7d17ad14-8700-4281-b308-00b131e22af0"
      },
      "entry_kind": "built_in_function",
      "localized_family_names": null,
      "localized_names": [
        {
          "locale": "ar-SA",
          "name": "أو"
        },
        {
          "locale": "bg-BG",
          "name": "ИЛИ"
        },
        {
          "locale": "cs-CZ",
          "name": "NEBO"
        },
        {
          "locale": "da-DK",
          "name": "ELLER"
        },
        {
          "locale": "de-DE",
          "name": "ODER"
        },
        {
          "locale": "el-GR",
          "name": "Ή"
        },
        {
          "locale": "en-AU",
          "name": "OR"
        },
        {
          "locale": "en-GB",
          "name": "OR"
        },
        {
          "locale": "en-US",
          "name": "OR"
        },
        {
          "locale": "es-ES",
          "name": "O bien"
        },
        {
          "locale": "et-EE",
          "name": "VÕI"
        },
        {
          "locale": "fi-FI",
          "name": "TAI"
        },
        {
          "locale": "fr-FR",
          "name": "OU"
        },
        {
          "locale": "he-IL",
          "name": "או"
        },
        {
          "locale": "hr-HR",
          "name": "ILI"
        },
        {
          "locale": "hu-HU",
          "name": "VAGY"
        },
        {
          "locale": "id-ID",
          "name": "ATAU"
        },
        {
          "locale": "it-IT",
          "name": "OPPURE"
        },
        {
          "locale": "ja-JP",
          "name": "または"
        },
        {
          "locale": "ko-KR",
          "name": "또는"
        },
        {
          "locale": "lt-LT",
          "name": "ARBA"
        },
        {
          "locale": "lv-LV",
          "name": "VAI"
        },
        {
          "locale": "nb-NO",
          "name": "ELLER"
        },
        {
          "locale": "nl-NL",
          "name": "OF"
        },
        {
          "locale": "pl-PL",
          "name": "LUB"
        },
        {
          "locale": "pt-BR",
          "name": "OU"
        },
        {
          "locale": "pt-PT",
          "name": "OU"
        },
        {
          "locale": "ro-RO",
          "name": "SAU"
        },
        {
          "locale": "ru-RU",
          "name": "ИЛИ"
        },
        {
          "locale": "sk-SK",
          "name": "ALEBO"
        },
        {
          "locale": "sl-SI",
          "name": "ALI"
        },
        {
          "locale": "sr-Latn-RS",
          "name": "ILI"
        },
        {
          "locale": "sv-SE",
          "name": "ELLER"
        },
        {
          "locale": "th-TH",
          "name": "หรือ"
        },
        {
          "locale": "tr-TR",
          "name": "VEYA"
        },
        {
          "locale": "uk-UA",
          "name": "АБО"
        },
        {
          "locale": "vi-VN",
          "name": "HOẶC"
        },
        {
          "locale": "zh-CN",
          "name": "或"
        },
        {
          "locale": "zh-HK",
          "name": "或者"
        },
        {
          "locale": "zh-TW",
          "name": "或者"
        }
      ],
      "signature": {
        "display": "OR(logical1, [logical2], ...)",
        "parameters": [
          {
            "description": null,
            "name": "logical1",
            "optional": false,
            "repeats": false
          },
          {
            "description": null,
            "name": "logical2",
            "optional": true,
            "repeats": true
          }
        ],
        "trailing_repeats": true
      },
      "surface_name": "OR",
      "version_marker": null,
      "xlcall": {
        "code": "37",
        "symbol": "xlfOr"
      }
    },
    "microsoft": "https://support.microsoft.com/en-us/office/or-function-7d17ad14-8700-4281-b308-00b131e22af0"
  },
  "try_it": {
    "formula": "=OR(FALSE,2>1)"
  },
  "url": "https://handbook.dnacalc.com/functions/OR.html",
  "variants": [],
  "versions": [
    {
      "behaviour": "1,212 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.OR.json"
      ]
    }
  ]
}