このページの内容

文字列関数

テキストの加工、検索、書式設定を行う関数です。

len

(text)

文字列の長さ、つまり文字数を返します。

パラメーター
text string 長さを測定する文字列
戻り値 数値
len("Hello") 5
len("") 0

left

(text, count)

文字列の先頭からN文字を返します。

パラメーター
text string 元の文字列
count number 抽出する文字数
戻り値 文字列
left("ProcessMind", 7) Process
関連項目
(text, count)

文字列の末尾からN文字を返します。

パラメーター
text string 元の文字列
count number 抽出する文字数
戻り値 文字列
right("ProcessMind", 4) Mind
関連項目

mid

(text, start, count)

文字列の中央から部分文字列を返します。開始位置は1から数え、指定した文字数を抽出します。

パラメーター
text string 元の文字列
start number 開始位置(1から数える)
count number 抽出する文字数
戻り値 文字列
mid("ProcessMind", 8, 4) Mind
mid("Hello World", 1, 5) Hello
関連項目

lower

(text)

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

パラメーター
text string 変換する文字列
戻り値 文字列
lower("HELLO") hello
関連項目

upper

(text)

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

パラメーター
text string 変換する文字列
戻り値 文字列
upper("hello") HELLO
関連項目

proper

(text)

各単語の先頭文字を大文字にして、文字列をProper Caseに変換します。

パラメーター
text string 変換する文字列
戻り値 文字列
proper("hello world") Hello World
proper("HELLO WORLD") Hello World
関連項目

trim

(text)

文字列の先頭と末尾から空白を削除します。

パラメーター
text string 空白を削除する文字列
戻り値 文字列
trim(" hello ") hello
関連項目

trimStart

(text)

文字列の先頭から空白を削除します。

パラメーター
text string 空白を削除する文字列
戻り値 文字列
trimStart(" hello") hello
関連項目

trimEnd

(text)

文字列の末尾から空白を削除します。

パラメーター
text string 空白を削除する文字列
戻り値 文字列
trimEnd("hello ") hello
関連項目

replace

(text, search, replacement)

検索文字列に一致するすべての箇所を置換文字列に置き換えます。

パラメーター
text string 元の文字列
search string 検索する文字列
replacement string 置換後の文字列
戻り値 文字列
replace("Hello World", "World", "ProcessMind") Hello ProcessMind
replace("a-b-c", "-", "_") a_b_c

concat

(text1, text2, ...?)

2つ以上の文字列を連結します。

パラメーター
text1 string 1つ目の文字列
text2 string 2つ目の文字列
... (任意) string 追加の文字列。最大6個までです。
戻り値 文字列
concat("Hello", " ", "World") Hello World
注記

文字列の連結には、+演算子も使用できます。

contains

(text, search)

ある文字列に別の文字列が含まれているかを確認します。

パラメーター
text string 検索対象の文字列
search string 検索する文字列
戻り値 ブール値
contains("ProcessMind", "Mind") true
contains("Hello", "xyz") false
関連項目

startsWith

(text, prefix)

文字列が指定した接頭辞で始まるかを確認します。

パラメーター
text string 確認する文字列
prefix string 検索する接頭辞
戻り値 ブール値
startsWith("ProcessMind", "Process") true
関連項目

endsWith

(text, suffix)

文字列が指定した接尾辞で終わるかを確認します。

パラメーター
text string 確認する文字列
suffix string 検索する接尾辞
戻り値 ブール値
endsWith("ProcessMind", "Mind") true
関連項目

indexOf

(text, search)

最初に見つかった部分文字列の位置を1から数えて返します。見つからない場合は0を返します。

パラメーター
text string 検索対象の文字列
search string 検索する文字列
戻り値 数値
indexOf("ProcessMind", "Mind") 8
indexOf("Hello", "xyz") 0
関連項目

find

(search, text)

indexOfの別名です。最初に見つかった部分文字列の位置を1から数えて返します。

パラメーター
search string 検索する文字列
text string 検索対象の文字列
戻り値 数値
find("Mind", "ProcessMind") 8
注記

indexOfとは引数の順序が逆になっている点に注意してください。

関連項目

padLeft

(text, length, char?)

文字列の左側を指定した長さになるまで埋めます。

パラメーター
text string 埋める文字列
length number 目標の長さ
char (任意) string 埋めるために使用する文字 (既定値: " "(スペース))
戻り値 文字列
padLeft("42", 5, "0") 00042
padLeft("Hi", 5) Hi
関連項目

padRight

(text, length, char?)

文字列の右側を指定した長さになるまで埋めます。

パラメーター
text string 埋める文字列
length number 目標の長さ
char (任意) string 埋めるために使用する文字 (既定値: " "(スペース))
戻り値 文字列
padRight("Hi", 5, ".") Hi...
関連項目

関連トピック