{{alias}}( str, [options,] clbk[, thisArg] ) Invokes a function for each character in a string. When invoked, the provided function is provided three arguments: - value: character. - index: starting character index. - str: input string. Parameters ---------- str: string Input string over which to iterate. options: Object (optional) Options. options.mode: string (optional) Type of characters over which to iterate. The following modes are supported: - grapheme: grapheme clusters. Appropriate for strings containing visual characters which can span multiple Unicode code points (e.g., emoji). - code_point: Unicode code points. Appropriate for strings containing visual characters which are comprised of more than one Unicode code unit (e.g., ideographic symbols and punctuation and mathematical alphanumerics). - code_unit': UTF-16 code units. Appropriate for strings containing visual characters drawn from the basic multilingual plane (BMP) (e.g., common characters, such as those from the Latin, Greek, and Cyrillic alphabets). Default: 'grapheme'. clbk: Function The function to invoke for each character in the input string. thisArg: any (optional) Execution context. Returns ------- out: string Input string. Examples -------- > var n = 0; > function fcn() { n += 1; }; > {{alias}}( 'hello world!', fcn ); > n 12 See Also --------