{
  "id": "fn-array-nth",
  "dataComponent": "array",
  "heading": {
    "title": "nth",
    "badges": ["Array", "PARTIAL"]
  },
  "synopsis": "Retrieves the nth element of an array, supporting negative indices (counting from the end). Returns '_' if out of range. Partial usage is supported.",
  "codeBlocks": [
    "extend(\"array\")\\n\\n// Basic usage\\nsput( array:nth(0, [\"A\",\"B\",\"C\"]) )\\n// => \"A\"\\n\\nsput( array:nth(-1, [\"A\",\"B\",\"C\"]) )\\n// => \"C\"\\n\\n// If out of range => returns '_'\\n\\n// Partial usage\\ngetThird = array:nth(2)\\nsput( getThird([10,20,30,40]) )\\n// => 30\\n\\nmyPartial = array:nth(_, [5,6,7,8])\\nsput( myPartial(-2) )\\n// => 7"
  ],
  "notes": [
    "The first argument is an integer index. Negative indices count from the end, e.g. -1 => last element.",
    "The second argument is the array. Must be int[], str[], or bool[].",
    "If the index is out of range, returns '_'. If any argument is missing, you get a partial function requiring the missing parameter."
  ]
}
