sw23.github.io

{
  "type": "object",
  "properties": {
    "value": {
      "type": [
        "number",
        "string"
      ],
      "description": "The value to convert. Accepts a number, hex string (read as an integer, e.g. \"0xFF\" is 255), or keyword. Exactly one of \"value\" and \"bits\" is required."
    },
    "bits": {
      "type": "string",
      "description": "The source as a bit pattern in the input format, binary (e.g. \"0011110000000000\") or hex with 0x prefix (e.g. \"0x3C00\"), read as decode_bits reads it and converted exactly as given. Use it to convert an exact encoding such as a NaN with a sign and payload. Exactly one of \"value\" and \"bits\" is required."
    },
    "inputFormat": {
      "type": [
        "string",
        "object"
      ],
      "description": "Source format preset key or custom format object."
    },
    "outputFormat": {
      "type": [
        "string",
        "object"
      ],
      "description": "Target format preset key or custom format object."
    },
    "roundingMode": {
      "type": "string",
      "description": "Rounding mode for encoding into the output format; the source operand is built with the input format's defaults. Options: \"tiesToEven\" (default, IEEE 754), \"tiesToAway\", \"towardZero\", \"towardPositive\", \"towardNegative\".",
      "enum": [
        "tiesToEven",
        "tiesToAway",
        "towardZero",
        "towardPositive",
        "towardNegative"
      ]
    },
    "overflowMode": {
      "type": "string",
      "description": "What an out-of-range output magnitude becomes; the source operand is built with the input format's defaults. \"overflow\" produces Infinity (or NaN when the format has no Infinity); \"saturate\" clamps to the largest finite value. Omit to use the per-format default. IEEE 754 §7.4 directed rounding still clamps finite overflow regardless.",
      "enum": [
        "saturate",
        "overflow"
      ]
    },
    "nanMode": {
      "type": "string",
      "description": "What a NaN source operand becomes; it has no effect on any other input. \"canonical\" gives the output format's canonical quiet NaN. \"preserve\" keeps the sign and as many high-order payload bits as fit, and quiets the result (IEEE 754-2019 §6.2.3). Default \"canonical\". Only a \"bits\" source has a payload to keep.",
      "enum": [
        "canonical",
        "preserve"
      ]
    }
  },
  "required": [
    "inputFormat",
    "outputFormat"
  ]
}