str.format #
フォーマット文字列には、リテラルテキストと、フォーマットされる値ごとに波括弧 {} で囲まれた1つのプレースホルダーを含めることができます。各プレースホルダーは、置き換えられる必須引数の (0から始まる) インデックスと、オプションのフォーマット指定子で構成されます。インデックスは、str.format の引数リストにおける引数の位置を表します。
str.format(formatString, arg0, arg1, ...) → simple string
str.format(formatString, arg0, arg1, ...) → series string
戻り値 #
フォーマットされた文字列。
引数 #
formatString (series string) | フォーマット文字列。 |
arg0, arg1, … (series int/float/bool/string/na/int[]/float[]/bool[]/string[]) | フォーマットする値。 |
例 #
// The format specifier inside the curly braces accepts certain modifiers:
// - Specify the number of decimals to display:
str.format("{0,number,#.#}", 1.34) // returns: 1.3
// - Round a float value to an integer:
str.format("{0,number,integer}", 1.34) // returns: 1
// - Display a number in currency:
str.format("{0,number,currency}", 1.34) // returns: $1.34
// - Display a number as a percentage:
str.format("{0,number,percent}", 0.5) // returns: 50%
// EXAMPLES WITH SEVERAL ARGUMENTS
// returns: Number 1 is not equal to 4
str.format("Number {0} is not {1} to {2}", 1, "equal", 4)
// returns: 1.34 != 1.3
str.format("{0} != {0, number, #.#}", 1.34)
// returns: 1 is equal to 1, but 2 is equal to 2
str.format("{0, number, integer} is equal to 1, but {1, number, integer} is equal to 2", 1.34, 1.52)
// returns: The cash turnover amounted to $1,340,000.00
str.format("The cash turnover amounted to {0, number, currency}", 1340000)
// returns: Expected return is 10% - 20%
str.format("Expected return is {0, number, percent} - {1, number, percent}", 0.1, 0.2)
備考 #
引用符で囲まれていないパターン内の波括弧は、バランスが取れていなければなりません。例えば、“ab {0} de” と “ab ‘}’ de” は有効なパターンですが、“ab {0'}' de”, “ab } de” や “''{''” は有効なパターンではありません。
str.length #
文字列の文字数を整数で返します。
str.length(string) → const int
str.length(string) → simple int
str.length(string) → series int
戻り値 #
ソース文字列の文字数。
引数 #
string (series string) | ソース文字列 |
str.replace_all #
ソース文字列にターゲット文字列が出現する度に置換文字列で置き換えられます。
str.replace_all(source, target, replacement) → simple string
str.replace_all(source, target, replacement) → series string
戻り値 #
処理された文字列。
引数 #
source (series string) | ソース文字列 |
target (series string) | 置換される文字列 |
replacement (series string) | ターゲット文字列が出現する度に置換する文字列 |
str.split #
文字列を部分文字列の配列に分割してその配列IDを返します。
str.split(string, separator) → string[]
戻り値 #
文字列配列のID。
引数 #
string (series string) | ソース文字列 |
separator (series string) | 各部分文字列を区切る文字列。 |
str.tonumber #
有効な数字を含む場合には文字列のfloatバージョン、それ以外の場合には na。
str.tonumber(string) → series float
戻り値 #
有効な数字を含む場合には文字列のfloatバージョン、それ以外の場合には na。
引数 #
string (series string) | int または float の文字列表現。 |
str.tostring #
The string representation of the value
argument.
str.tostring(value) → series string
str.tostring(value, format) → series string
str.tostring(value) → simple string
str.tostring(value, format) → simple string
戻り値 #
The string representation of the value
argument. ,If the value
argument is a string, it is returned as is. ,When the value
is na, the function returns the string “NaN”.
引数 #
value (series int/float/bool/string/int[]/float[]/bool[]/string[]) | Value or array ID whose elements are converted to a string. |
format (series string) | Format string. Accepts these format.* constants: format.mintick, format.percent, format.volume. Optional. The default value is ‘#.##########’. |
備考 #
The formatting of float values will also round those values when necessary, e.g. str.tostring(3.99, ‘#') will return “4”.
ゼロパディングして表示するには、'#’ の代わりに ‘0’ を使用します。例.'#.000'。
format.mintick を使用する場合、値は syminfo.mintick で割り切れる最も近い数に丸められ、余りを取り除かれます。文字列は末尾にゼロパディングして返されます。
x引数が文字列の場合、同じ文字列の値が返されます。
Bool型の引数は、true または false が返されます。
x が na の場合、この関数は “NaN” を返します。