.. _auto_text_cast:

*CAST A NUMBER*
===============

Casts a scalar text value to a numeric type (integer or float). Use this worker when a downstream step requires a strongly-typed number but the pipeline carries the value as a string.

When to use
-----------

Classification: **process**.

Tagged: ``cast``, ``float``, ``integer``, ``numeric``, ``scalar``, ``text``, ``type_conversion``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Text To Cast
     - texttocast
     - scalar
     - —
     - 
     - The scalar text value to be cast (e.g. "42" or "3.14"); leave blank if the value will be wired in dynamically at runtime.
   * - Cast Type
     - casttype
     - string
     - integer
     - 
     - Target numeric type for the cast — choose "integer" to truncate to a whole number or "float" to preserve decimal precision; defaults to "integer".

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - text_cast_output_1
     - text_cast_output_1
     - scalar
     - The input value re-emitted as a typed scalar of the requested numeric kind (integer or float).

Disciplines
-----------

- data.dataset.transform

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>text_cast</code>. Schema hash: <code>7a669c2033cc</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>