std::log10(std::valarray)

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

Pour chaque élément de va calcule le logarithme commun (base 10) de la valeur de l'élément.

Paramètres

Valeur de retour

Tableau de valeurs contenant les logarithmes décimaux des valeurs dans va .

Notes

Une fonction non qualifiée (log10) est utilisée pour effectuer le calcul. Si cette fonction n'est pas disponible, std::log10 est utilisée en raison de la recherche dépendante des arguments.

La fonction peut être implémentée avec un type de retour différent de std::valarray. Dans ce cas, le type de remplacement possède les propriétés suivantes :

• Toutes les const fonctions membres de std::valarray sont fournies.
• std::valarray, std::slice_array, std::gslice_array, std::mask_array et std::indirect_array peuvent être construites à partir du type de remplacement.
• Pour chaque fonction prenant un const std::valarray<T>& sauf begin() et end()(depuis C++11), des fonctions identiques prenant les types de remplacement doivent être ajoutées ;
• Pour chaque fonction prenant deux const std::valarray<T>& arguments, des fonctions identiques prenant chaque combinaison de const std::valarray<T>& et des types de remplacement doivent être ajoutées.
• Le type de retour n'ajoute pas plus de deux niveaux d'imbrication de templates par rapport au type d'argument le plus profondément imbriqué.

Implémentation possible

template<class T>
valarray<T> log10(const valarray<T>& va)
{
    valarray<T> other = va;
    for (T& i : other)
        i = log10(i);
    return other; // un objet proxy peut être retourné
}

Exemple

#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

Voir aussi