R: Coerce to 'numeric', not Loosing Dimensions

asNumeric {gmp} | R Documentation

## Coerce to 'numeric', not Loosing Dimensions

### Description

a number-like object is coerced to type (typeof) `"numeric"`, keeping `dim` (and maybe `dimnames`) when present.

### Usage

    asNumeric(x)

### Arguments

`x` | a “number-like” object, e.g., big integer (`bigz`), or `mpfr`, notably including matrices and arrays of such numbers.

### Value

an R object of type (`typeof`) `"numeric"`, a `matrix` or `array` if `x` had non-NULL dimension `dim()`.

### Methods

`signature(x = "ANY")`

  the default method, which is the identity for `numeric` array.

`signature(x = "bigq")`

  the method for big rationals.

`signature(x = "bigq")`

  the method for big integers.

Note that package Rmpfr provides methods for its own number-like objects.

### Author(s)

Martin Maechler

### See Also

`as.numeric` coerces to both `"numeric"` and to a `vector`, whereas `asNumeric()` should keep `dim` (and other) attributes.

### Examples

    m <- matrix(1:6, 2,3)
    stopifnot(identical(m, asNumeric(m)))# remains matrix

    (M <- as.bigz(m) / 5) ##-> "bigq" matrix
    asNumeric(M) # numeric matrix
    stopifnot(all.equal(asNumeric(M), m/5))

[Package gmp version 0.5-13.2 Index]