41 lines
804 B
Markdown
41 lines
804 B
Markdown
---
|
|
layout: "functions"
|
|
page_title: "log - Functions - Configuration Language"
|
|
sidebar_current: "docs-funcs-numeric-log"
|
|
description: |-
|
|
The log function returns the logarithm of a given number in a given base.
|
|
---
|
|
|
|
# `log` Function
|
|
|
|
-> **Note:** This page is about Terraform 0.12 and later. For Terraform 0.11 and
|
|
earlier, see
|
|
[0.11 Configuration Language: Interpolation Syntax](../../configuration-0-11/interpolation.html).
|
|
|
|
`log` returns the logarithm of a given number in a given base.
|
|
|
|
```hcl
|
|
log(number, base)
|
|
```
|
|
|
|
## Examples
|
|
|
|
```
|
|
> log(50, 10)
|
|
1.6989700043360185
|
|
> log(16, 2)
|
|
4
|
|
```
|
|
|
|
`log` and `ceil` can be used together to find the minimum number of binary
|
|
digits required to represent a given number of distinct values:
|
|
|
|
```
|
|
> ceil(log(15, 2))
|
|
4
|
|
> ceil(log(16, 2))
|
|
4
|
|
> ceil(log(17, 2))
|
|
5
|
|
```
|