# AggregateCommand.strLenBytes(value: Expression): Object

支持端：小程序 2.7.4, 云函数 0.8.1, Web

聚合操作符。计算并返回指定字符串中 utf-8 编码的字节数量。

# 参数

# value: Expression

表达式

# 返回值

# Object

# API 说明

strLenBytes 的语法如下：

db.command.aggregate.strLenBytes(<表达式>)

只要表达式可以被解析成字符串，那么它就是有效表达式。

# 示例代码

假设集合 students 的记录如下：

{ "name": "dongyuanxin", "nickname": "心谭" }

借助 strLenBytes 计算 name 字段和 nickname 字段对应值的字节长度：

const $ = db.command.aggregate
db
  .collection('students')
  .aggregate()
  .project({
    _id: 0,
    nameLength: $.strLenBytes('$name'),
    nicknameLength: $.strLenBytes('$nickname')
  })
  .end()

返回结果如下：

{ "nameLength": 11, "nicknameLength": 6 }