---
source_url: https://docs.dolphindb.cn/zh/funcs/funcs_intro.html
fetched_at: 2026-05-19T09:12:21Z
category: funcs
title: 函数参考
sha1: ad802bd062508208d2ad582270c58bb29d87cff9
---

# 函数参考

## 基本语法

对于一个参数的函数，我们使用 X 作为参数。对于两个参数的函数，我们使用 X 和 Y 分别作为第一个和第二个参数。如果没有说明，X 或 Y
表示标量，向量，矩阵，字典或表的对象。我们有一些需要一个标量作为参数之一的函数，比如 [take](t/take.html), [rand](r/rand.html), [norm](n/norm.html)。对于这些情况，我们使用小写字母，比如 "a", "b". [ ] 里的内容是可选项。

一个参数的函数语法：

- 标准函数调用：

  ```dolphindb
  <function>(X)
  ```
- 将函数名放在参数 X 前时，X 两边的括号可以省略。

  ```dolphindb
  <function> X
  ```

  注：

  该用法不适于嵌套函数调用。
- 当 X 是一个对象时，X 两边的括号可以省略。

  ```dolphindb
  X.<function>()
  ```

  注：

  该用法更合适嵌套函数调用。

两个参数的函数语法：

- 标准函数调用

  ```dolphindb
  <function>(X, Y)
  ```
- 将函数名放在两个参数之间。

  ```dolphindb
  X <function> Y
  ```

  注：

  该用法不适于嵌套函数调用。
- 当 X 是一个对象时，X 两边的括号可以省略。

  ```dolphindb
  X.<function> (Y)
  ```

可以对常量和变量用面向对象的风格调用一个函数。

为了简明，我们在这章中，对所以一元和两个参数的函数，都只介绍第一种调用形式，即 `<function>(X)` 或
`<function>(Y)`。

## 函数调用示例

以下例子展示 3 种调用函数 `log` 的方法：

- 方法一：

  ```dolphindb
  log(10);
  ```

  输出返回：`2.302585`
- 方法二：

  ```dolphindb
  log 10;
  ```

  输出返回：`2.302585`
- 方法三：

  ```dolphindb
  (10).log();
  ```

  输出返回：`2.302585`。在此用法中，为了将常数
  10 视为一个对象，需要为其加一对括号。

  注：

而在以下例子中，由于 x 是一个向量对象，因此 x 两边的括号可以省略。

```dolphindb
x = 5 3 1 10;
log(x);
```

输出返回：`[1.609438,1.098612,0,2.302585]`

```dolphindb
log x
```

输出返回：`[1.609438,1.098612,0,2.302585]`

```dolphindb
x.log();
```

输出返回：`[1.609438,1.098612,0,2.302585]`

```dolphindb
(5 3 1 10).log()
```

输出返回：`[1.609438,1.098612,0,2.302585]`。在此用法中，为了将向量常数 5 3 1 10
视为一个向量对象，需要在向量常数的左右加一对括号。

提示：

大多数二元运算符/函数不要求两个参数是同样的数据类型。系统会用最佳方式转换类型。但不推荐使用不同的数据类型，因为大量的类型转换会造成性能的损耗。
