str.format #
フォーマット文字列には、リテラルテキストと、フォーマットされる値ごとに波括弧 {} で囲まれた1つのプレースホルダーを含めることができます。各プレースホルダーは、置き換えられる必須引数の (0から始まる) インデックスと、オプションのフォーマット指定子で構成されます。インデックスは、str.format の引数リストにおける引数の位置を表します。
str.format(formatString, arg0, arg1, ...) -> string
str.format(formatString, arg0, arg1, ...) -> series[string]
戻り値 #
フォーマットされた文字列。
引数 #
formatString (series[string]) | フォーマット文字列。 |
arg0, arg1, … (const integer, float, string, bool, na, series[integer], series[float], series[string], series[bool], series[na], array[series[integer]], array[series[float]], array[series[string]], array[series[bool]]) | フォーマットする値。 |
例 #
// 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 integer
str.length(string) → integer
str.length(string) → series[integer]
戻り値 #
ソース文字列の文字数。
引数 #
string (series[string]) | ソース文字列 |
str.replace_all #
ソース文字列にターゲット文字列が出現する度に置換文字列で置き換えられます。
str.replace_all(source, target, replacement) → 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]) | 各部分文字列を区切る文字列。 |