Skip to main content
Version: Next

len

Function​

  len — the type-dependent length of a value

Synopsis​

len(v: record|array|set|map|type|bytes|string|ip|net|error) -> int64

Description​

The len function returns the length of its argument val. The semantics of this length depend on the value's type.

Supported types include:

  • record
  • array
  • set
  • map
  • error
  • bytes
  • string
  • ip
  • net
  • type

Example:​

Take the length of various types:

echo '[1,2,3] |["hello"]| {a:1,b:2} "hello" 10.0.0.1 1' |
  super -z -c 'yield {this,len:len(this)}' -

=>

{this:[1,2,3],len:3}
{this:|["hello"]|,len:1}
{this:{a:1,b:2},len:2}
{this:"hello",len:5}
{this:10.0.0.1,len:4}
{this:1,len:error({message:"len: bad type",on:1})}