convert

..  convert(T, x)

Convert ``x`` to a value of type ``T``.

If ``T`` is an ``Integer`` type, an :exc:`InexactError` will be raised if
``x`` is not representable by ``T``, for example if ``x`` is not
integer-valued, or is outside the range supported by ``T``.

.. doctest::

   julia> convert(Int, 3.0)
   3

   julia> convert(Int, 3.5)
   ERROR: InexactError()
    in convert at int.jl:209

If ``T`` is a :obj:`AbstractFloat` or :obj:`Rational` type, then it will return
the closest value to ``x`` representable by ``T``.

.. doctest::

   julia> x = 1/3
   0.3333333333333333

   julia> convert(Float32, x)
   0.33333334f0

   julia> convert(Rational{Int32}, x)
   1//3

   julia> convert(Rational{Int64}, x)
   6004799503160661//18014398509481984

Examples

julia> convert(Float64, 4) 
4.0

julia> convert(Int8, 'h')
104
julia> convert(Bool, 2)
true
julia> complexNumber = complex(1)
1 + 0im
julia> convert(Int8, complexNumber)
1
  1. Convert Float to Integer:

    julia> convert(Int, 3.0)
    3

    In this example, the floating-point number 3.0 is converted to an integer type (Int), resulting in the value 3.

  2. Error when conversion is not exact:

    julia> convert(Int, 3.5)
    ERROR: InexactError()
    in convert at int.jl:209

    When converting a floating-point number (3.5) to an integer type (Int), an InexactError is raised because the conversion is not exact.

  3. Convert Float to Float32 and Rational types:

    julia> x = 1/3
    0.3333333333333333
    
    julia> convert(Float32, x)
    0.33333334f0
    
    julia> convert(Rational{Int32}, x)
    1//3
    
    julia> convert(Rational{Int64}, x)
    6004799503160661//18014398509481984

    Here, x is a floating-point number, and it is converted to a Float32 type and two different Rational types (Rational{Int32} and Rational{Int64}).

See Also

base, big, bytes2hex, cconvert, complex, convert, dec, hex, hex2bytes, hex2num, oct, oftype, parse, promote, signed, unsafe_convert, unsigned, widen,

User Contributed Notes

Add a Note

The format of note supported is markdown, use triple backtick to start and end a code block.

*Required Field
Details

Checking you are not a robot: