{
"id": "fn-math-divide",
"dataComponent": "math",
"heading": {
"title": "divide",
"badges": ["Math", "PARTIAL"]
},
"synopsis": "Divides one numeric value (or array) by another, returning a float or float array. Supports partial usage and underscore placeholders.",
"codeBlocks": [
"extend(\"math\")\n\n# 1) Basic usage => single numbers\nsput( math:divide(10, 2) )\n# => 5.0 (float)\n\n# 2) Partial usage => known numerator, missing denominator\ndivBy5 = math:divide(_, 5)\nsput( divBy5(100) )\n# => 20.0\n\n# 3) If one argument is an array, element-wise division occurs:\n# All results are float arrays.\n\nsput( math:divide([10,20,30], 10) )\n# => [1.0,2.0,3.0]\n\nsput( math:divide(20, [2,5]) )\n# => [10.0,4.0]\n\n# 4) Division by zero => error or Infinity, depending on bridging.\n# Negative zeros or NaN might occur if your environment supports them.\n"
],
"notes": [
"Expects up to 2 arguments => (numerator, denominator). If either is missing or _, partial usage is returned until both are known.",
"All operations produce float or float[] results. For integer arrays, bridging typically converts them to float arrays before division.",
"Division by zero raises an error or returns Infinity, depending on your bridging logic.",
"If the arrays differ in length (for array/array division), bridging raises an error in most builds."
]
}