Description
Parse arrayJson as a JSON array and validate a nonnegative index.
JSON distinguishes null, strings, numbers, Booleans, arrays, and objects. Parsing a token produces a value whose type can differ from its apparent textual spelling.
Parse arrayJson as a JSON array and validate a nonnegative index.
When to use this tool
Use JSON Array Hole Vs Null Label when you need one bounded JSON value classification or wrapper operation.
How to use the tool and how it works
- Enter arrayJson, index. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read status. Use the output convention below.
Parse arrayJson as a JSON array and validate a nonnegative index. Return absent-index beyond its length, explicit-null for literal null, and present-value otherwise.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| arrayJson | JSON text containing an array; JSON has no sparse array holes. | Required. Text; maximum UTF-16 length 8192. |
| index | Position under the zero-based or one-based convention stated above. | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| status | absent-index for an index beyond the array; explicit-null for a present null; present-value otherwise. | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"arrayJson": "[1,null,3]",
"index": 1
},
"output": {
"status": "explicit-null"
}
}Limitations and assumptions
- Valid JSON arrays cannot encode sparse JavaScript holes; this compares absence with explicit values and does not inspect an in-memory sparse array.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Use a full document parser and the consuming schema when complete validation or exact numeric preservation is required.
References
Similar or alternative tools
- List Empty Sentinel Label
Parse itemsJson as a JSON array, count its entries, and label empty-list or nonempty-list.
- Event Indicator Missingness Label
Return missing when observed is false.