Skip to main content

Convert text to number

Sophie avatar
Written by Sophie
Updated over a week ago

Definition and Usage

Convert a text representation of a number to a variable that contains a numeric value. This command transforms string values containing only numeric characters into actual numeric values that can be used in calculations and other numeric operations.


Parameter Values

Input parameters

Parameter

Description

Possible Values

Required

Options / Notes

Text to convert

Enter a string or text variable that contains only a numeric value for conversion to a numeric variable. Space will be ignored, and non-numeric text will report an exception

Any text string containing numeric values

Yes

Non-numeric characters will cause an exception

Error handling

Parameter Name

Description

Throw error & stop

When an error occurs, the action will trigger an error and stop the execution of the entire app.

Retry command

If an error occurs, the action will retry the command in an attempt to resolve the issue and continue the process.

Ignore error & continue

When an error occurs, the action will be ignored, and the workflow will continue without interruption.

Variables produced

Store the value into a new variable. The output variable will contain the numeric value converted from the input text.


Using Variables in Conditions

When you see {x} or a variable icon in the interface, it indicates that you can insert previously created variables into this parameter. You can use variables to:

  • Pass dynamic text values that need to be converted to numbers

  • Store the resulting numeric value for use in calculations, comparisons, or other numeric operations

  • Ensure that variable types match the expected input/output requirements


Notes

  • The input text must contain only numeric characters (and optional spaces which will be ignored)

  • Decimal points and negative signs are accepted as part of valid numeric values

  • If the text contains any non-numeric characters (letters, special symbols), the command will throw an exception

  • This command is useful when extracting numbers from text sources, such as web pages, documents, or user inputs

  • The resulting numeric variable can be used in mathematical operations that require number data types

Did this answer your question?