p-string

string モジュールは文字列操作のためのユーティリティ関数を提供します。

use p-string as s

クエリ

len[str]

文字列の長さを返します。

use p-string as s
s.len[///hello///]  -- 5

contains[str; sub]

str が sub を含んでいれば true を返します。

use p-string as s
s.contains[///hello world///; ///world///]  -- true

startswith[str; prefix]

str が prefix で始まれば true を返します。

endswith[str; suffix]

str が suffix で終われば true を返します。

use p-string as s
s.startswith[///hello///; ///he///]  -- true
s.endswith[///hello///; ///lo///]    -- true

indexof[str; sub]

str 内で最初に sub が出現するインデックスを返します。見つからない場合は -1。

use p-string as s
s.indexof[///hello///; ///ll///]  -- 2
s.indexof[///hello///; ///xyz///] -- -1

count[str; sub]

str 内の sub の重複しない出現回数を返します。

use p-string as s
s.count[///banana///; ///an///]  -- 2

変換

upper[str]

文字列を大文字に変換して返します。

lower[str]

文字列を小文字に変換して返します。

use p-string as s
s.upper[///hello///]  -- "HELLO"
s.lower[///HELLO///]  -- "hello"

capitalize[str]

文字列の最初の文字を大文字にして返します。

title[str]

各単語の最初の文字を大文字にして返します。

use p-string as s
s.capitalize[///hello world///]  -- "Hello world"
s.title[///hello world///]       -- "Hello World"

trim[str]

両端の空白を除去します。

trimstart[str]

先頭の空白を除去します。

trimend[str]

末尾の空白を除去します。

use p-string as s
s.trim[///  hello  ///]       -- "hello"
s.trimstart[///  hello  ///]  -- "hello  "
s.trimend[///  hello  ///]    -- "  hello"

reverse[str]

文字列を反転して返します。

use p-string as s
s.reverse[///hello///]  -- "olleh"

repeat[str; n]

文字列を n 回繰り返して返します。

use p-string as s
s.repeat[///ab///; 3]  -- "ababab"

replace[str; old; new]

old のすべての出現を new に置換します。

replacefirst[str; old; new]

old の最初の出現を new に置換します。

use p-string as s
s.replace[///aabaa///; ///a///; ///x///]       -- "xxbxx"
s.replacefirst[///aabaa///; ///a///; ///x///]   -- "xabaa"

padstart[str; len; fill]

文字列の先頭を len に達するまでパディングします。fill 文字のデフォルトはスペースです。

padend[str; len; fill]

文字列の末尾を len に達するまでパディングします。fill 文字のデフォルトはスペースです。

use p-string as s
s.padstart[///42///; 5; ///0///]  -- "00042"
s.padend[///hi///; 5; ///.///]    -- "hi..."

分割 / 結合

split[str; sep]

文字列を sep で分割し、配列を返します。

lines[str]

文字列を改行で分割します。

words[str]

文字列を空白で分割し、空のセグメントを無視します。

join[arr; sep]

文字列の配列を sep で結合します。

chars[str]

個々の文字の配列を返します。

use p-string as s
s.split[///a,b,c///; ///,///]   -- ["a", "b", "c"]
s.words[///hello  world///]     -- ["hello", "world"]
s.join[[///a///; ///b///]; ///-///]  -- "a-b"
s.chars[///hi///]               -- ["h", "i"]

スライス

slice[str; start; end]

start から end（排他的）までの部分文字列を返します。

charat[str; i]

インデックス i の文字を返します。

codeat[str; i]

インデックス i のUnicodeコードポイントを返します。

fromcode[code]

指定されたUnicodeコードポイントの文字を返します。

use p-string as s
s.slice[///hello///; 1; 3]   -- "el"
s.charat[///hello///; 0]     -- "h"
s.codeat[///A///; 0]         -- 65
s.fromcode[65]               -- "A"