std::log10(std::valarray)

template< class T >
valarray<T> log10( const valarray<T>& va );

Para cada elemento en va calcula el logaritmo común (base 10) del valor del elemento.

Parámetros

Valor de retorno

Arreglo de valores que contiene los logaritmos comunes de los valores en va .

Notas

Se utiliza la función no calificada (log10) para realizar el cálculo. Si dicha función no está disponible, se utiliza std::log10 debido a la búsqueda dependiente de argumentos.

La función puede implementarse con un tipo de retorno diferente de std::valarray. En este caso, el tipo de reemplazo tiene las siguientes propiedades:

• Se proporcionan todas las funciones miembro const de std::valarray.
• std::valarray, std::slice_array, std::gslice_array, std::mask_array y std::indirect_array se pueden construir a partir del tipo de reemplazo.
• Para cada función que tome un const std::valarray<T>& excepto begin() y end()(desde C++11), se agregarán funciones idénticas que tomen los tipos de reemplazo;
• Para cada función que tome dos argumentos const std::valarray<T>&, se agregarán funciones idénticas que tomen cada combinación de const std::valarray<T>& y tipos de reemplazo.
• El tipo de retorno no añade más de dos niveles de anidamiento de plantilla sobre el tipo de argumento más profundamente anidado.

Implementación posible

template<class T>
valarray<T> log10(const valarray<T>& va)
{
    valarray<T> other = va;
    for (T& i : other)
        i = log10(i);
    return other; // se puede devolver un objeto proxy
}

Ejemplo

#include <cmath>
#include <iomanip>
#include <iostream>
#include <valarray>
void show(char const* title, const std::valarray<float>& va)
{
    std::cout << title << " : " << std::right;
    for (float x : va)
        std::cout << std::setw(6) << x;
    std::cout << '\n';
}
int main()
{
    const std::valarray<float> n{-2.f, -1.f, 0.f, 1.f, 2.f, 3.f, INFINITY};
    const std::valarray<float> pow10{std::pow(10.f, n)};
    const std::valarray<float> log10_pow10{std::log10(pow10)};
    show("n      ", n);
    show("10ⁿ    ", pow10);
    show("lg(10ⁿ)", log10_pow10);
}

n       :     -2    -1     0     1     2     3   inf
10ⁿ     :   0.01   0.1     1    10   100  1000   inf
lg(10ⁿ) :     -2    -1     0     1     2     3   inf

Véase también