std::log10(std::valarray)

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

Для каждого элемента в va вычисляет десятичный логарифм значения этого элемента.

Параметры

Возвращаемое значение

Массив значений, содержащий десятичные логарифмы значений в va.

Примечания

Для выполнения вычисления используется функция без квалификатора (log10). Если такая функция недоступна, используется std::log10 благодаря поиску, зависящему от аргументов.

Функция может быть реализована с типом возвращаемого значения, отличным от std::valarray. В этом случае тип-замена обладает следующими свойствами:

• Предоставляются все функции-члены const типа std::valarray.
• Из типа-замены могут быть сконструированы std::valarray, std::slice_array, std::gslice_array, std::mask_array и std::indirect_array.
• Для каждой функции, принимающей аргумент типа conststd::valarray<T>& за исключением begin() и end()(начиная с C++11), должны быть добавлены идентичные функции, принимающие типы-замены;
• Для каждой функции, принимающей два аргумента типа conststd::valarray<T>&, должны быть добавлены идентичные функции, принимающие все возможные комбинации типов conststd::valarray<T>& и типов-замен;
• Тип возвращаемого значения не должен иметь более двух уровней вложенности шаблонов по сравнению с типом самого глубоко вложенного аргумента.

Возможная реализация

template<class T>
valarray<T> log10(const valarray<T>& va)
{
    valarray<T> other = va;
    for (T& i : other)
        i = log10(i);

    return other; // proxy object may be returned
}

Пример

#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

См. также