toString
Library "toString"
Contains methods for conversion to string of int/float/bool/string/line/label/box and arrays and matrices thereof. Also contains a string wrapping function.
method getXloc(line/label/box)
returns true if line/box/label are xloc.bar_time, false otherwise
nzs(string)
Analogue of nz() but for strings. Returns "" is _s is na.
method wrap(string, wrap_width, breaker_prefix, breaker_postfix)
Wraps the string to wrap_width adding breaker_prefix to the end of each line (before "\n") and breaker_postfix to the beginning of each line (after "\n")".
method toS(<int/float> val, format)
Same as str.format() (for one argument) with additional "format" options:
- --- Number formats ---
- "number"
- "0"
- "0.0"
- "0.00"
- "0.000"
- "0.0000"
- "0.00000"
- "0.000000"
- "0.0000000"
- --- Date formats ---
- "date"
- "date : time"
- "dd.MM"
- "dd"
- --- Time formats ---
- "time"
- "HH:mm"
- "mm:ss"
- "date time"
- "date, time"
- "date,time"
method toS(<bool/ string> val, format)
Same as str.format() (for one argument) but works for bool/string
method toS(line, format)
Returns line's main data as a string. If the line is xloc.bar_time formats x values to "dd.MM.yy HH:mm:ss"
Parameters:
format (string): (string) If empty returns coordinates as "(x1, y1) - (x2, y2)". Otherwise replaces "x1", "x2", "y1", "y2" in `format` string by values. (e.g. toS(line, "x1, x2") will only return x1 and x2 separated by comma).
method toS(label, format)
Returns label's main data as a string. If the label is xloc.bar_time formats x values to "dd.MM.yy HH:mm:ss"
Parameters:
format (string): (string) If empty returns coordinates and text (if _printText) as "(x, y): text = text". Otherwise replaces "x1", "x2", "txt" in `format` string by values. (e.g. toS(label, "txt") will only return text of the label)
method toS(box, format)
Returns box's main data as a string. If the box is xloc.bar_time formats x values to "dd.MM.yy HH:mm:ss"
Parameters:
format (string): (string) If empty returns coordinates as "(x1, y1) - (x2, y2)". Otherwise replaces "x1", "x2", "y1", "y2" in `format` string by values. (e.g. toS(box, "x1, x2") will only return x1 and x2 separated by comma).
method toS(array<string>, _from, _to, _separator, _showIDs, _format, _truncate_left, _size_limit)
Like join() but with string length limit. Joins elements into readable string (length capped at _size_limit or 4000, truncating the end or beg)
Parameters:
this (string)
_from (int) - from this id of the array
_to (int) - to this id of the array
_separator (string) - add this between items
_showIDs (bool) - add id before each item. ("id: value")
_format (string) - apply format string (str.format() to each item
_truncate_left (bool) - if true cuts/truncates from the beginning, if false - cuts/truncates from the end. Default: false.
_size_limit (int) -
method toStringAr(arr, format)
Returns a string array made of original array items converted to string using toS() using `format` string. (see format options in toS description)
method toStringMx(mx, format)
Returns a string matrix made of original matrix items converted to string using toS() using `format` string. (see format options in toS description)
Contains methods for conversion to string of int/float/bool/string/line/label/box and arrays and matrices thereof. Also contains a string wrapping function.
method getXloc(line/label/box)
returns true if line/box/label are xloc.bar_time, false otherwise
nzs(string)
Analogue of nz() but for strings. Returns "" is _s is na.
method wrap(string, wrap_width, breaker_prefix, breaker_postfix)
Wraps the string to wrap_width adding breaker_prefix to the end of each line (before "\n") and breaker_postfix to the beginning of each line (after "\n")".
method toS(<int/float> val, format)
Same as str.format() (for one argument) with additional "format" options:
- --- Number formats ---
- "number"
- "0"
- "0.0"
- "0.00"
- "0.000"
- "0.0000"
- "0.00000"
- "0.000000"
- "0.0000000"
- --- Date formats ---
- "date"
- "date : time"
- "dd.MM"
- "dd"
- --- Time formats ---
- "time"
- "HH:mm"
- "mm:ss"
- "date time"
- "date, time"
- "date,time"
method toS(<bool/ string> val, format)
Same as str.format() (for one argument) but works for bool/string
method toS(line, format)
Returns line's main data as a string. If the line is xloc.bar_time formats x values to "dd.MM.yy HH:mm:ss"
Parameters:
format (string): (string) If empty returns coordinates as "(x1, y1) - (x2, y2)". Otherwise replaces "x1", "x2", "y1", "y2" in `format` string by values. (e.g. toS(line, "x1, x2") will only return x1 and x2 separated by comma).
method toS(label, format)
Returns label's main data as a string. If the label is xloc.bar_time formats x values to "dd.MM.yy HH:mm:ss"
Parameters:
format (string): (string) If empty returns coordinates and text (if _printText) as "(x, y): text = text". Otherwise replaces "x1", "x2", "txt" in `format` string by values. (e.g. toS(label, "txt") will only return text of the label)
method toS(box, format)
Returns box's main data as a string. If the box is xloc.bar_time formats x values to "dd.MM.yy HH:mm:ss"
Parameters:
format (string): (string) If empty returns coordinates as "(x1, y1) - (x2, y2)". Otherwise replaces "x1", "x2", "y1", "y2" in `format` string by values. (e.g. toS(box, "x1, x2") will only return x1 and x2 separated by comma).
method toS(array<string>, _from, _to, _separator, _showIDs, _format, _truncate_left, _size_limit)
Like join() but with string length limit. Joins elements into readable string (length capped at _size_limit or 4000, truncating the end or beg)
Parameters:
this (string)
_from (int) - from this id of the array
_to (int) - to this id of the array
_separator (string) - add this between items
_showIDs (bool) - add id before each item. ("id: value")
_format (string) - apply format string (str.format() to each item
_truncate_left (bool) - if true cuts/truncates from the beginning, if false - cuts/truncates from the end. Default: false.
_size_limit (int) -
method toStringAr(arr, format)
Returns a string array made of original array items converted to string using toS() using `format` string. (see format options in toS description)
method toStringMx(mx, format)
Returns a string matrix made of original matrix items converted to string using toS() using `format` string. (see format options in toS description)
Versionshinweise:
v2
Versionshinweise:
v3 Minor bug fixes.
Versionshinweise:
v4 Fixed toStringAr for bool. There seems to be a bug in PineScript where str.format("{0}", boolArray.get(0)) returns "1" instead of "true" or "false". So, using "str.tostring()" for bool now, and `format` argument is not functioning (does not affect the result) for toStringAr() and toS() for `bool`.