Count

Name	Mandatory	Description	Default	Type
⬅️ Input		The input of this shard is ignored.		Any
Output ➡️		Outputs the count of characters, elements, or key-value pairs in the specified variable. If the variable type does not match, it outputs 0.		Int
Name	No	The name of the variable.	``	StringVar(Any)
Key	No	The key of the value to read from the table (parameter applicable only if the target variable is a table).	none	Any
Global	No	If the variable is available to all of the wires in the same mesh.	false	Bool

This shard counts the sequence, string, table, or audio variable specified in the Name parameter. If the variable specified is a string, it will count the number of characters. If the variable specified is a sequence, it will count the number of elements. If the variable specified is a table, it will count the number of key-value pairs. If the variable specified is audio, it will count the number of samples (per channel). If the variable is left empty and instead an input is provided, the input will be counted instead.

Details

If the variable to count is a table, the Key parameter identifies which key to target. The value in the key specified still needs to be a countable value.

Since variables may be locally scoped (created with Global: false; exists only for current wire) or globally scoped (created with Global: true; exists for all wires of that mesh), both parameters Global and Name are used in combination to identify the correct variable to count.

Examples

Code

// counting in locally scoped variables
"Shards" >= string
Count(Name: string) | Log     // no. of characters => 6 

[10 20 30] >= sequence
Count(sequence) | Log         // no. of elements => 3        

{k1: 11 k2: 22} >= table
Count(table) | Log           // no. of key-value pairs => 2

12345 >= number
Count(number) | Log          // zero count for numbers => 0

// counting in same-name local and global variables
"Local Shards" >= stringvar    // create a local variable   
"Global Shards" | Set(stringvar Global: true)  // create global variable   

Count(stringvar) | Log        // characters in local var => 12
Count(stringvar Global: true) | Log  // characters in global var => 13

[info] Set - Warning: setting an already exposed variable "stringvar", use Update to avoid this warning.
[info] [sample-wire] 6
[info] [sample-wire] 3
[info] [sample-wire] 2
[info] [sample-wire] 0
[info] [sample-wire] 12
[info] [sample-wire] 13

 

---