技術リファレンス

以下の文字列操作関数が利用できます。

関数名	引数	説明	例
Len	Len(s)	文字列の長さ(バイト数)を返す。sが配列やObjectの場合は要素数を返す。	Len("abc012漢字") → 11
Contains	Contains(s, substr)	sの中にsubstrが含まれているかBoolで返す	Contains("abc012漢字", "漢字") → true
RuneCount	RuneCount(s)	sの文字列の文字数を返す	RuneCount("abc012漢字") → 8
HasPrefix	HasPrefix(s, prefix)	sがprefixで始まるかBoolで返す	HasPrefix("https://www.asteria.com/", "https://") → true
HasSuffix	HasSuffix(s, suffix)	sがsuffixで終わるかBoolで返す
FirstIndex	FirstIndex(s, substr)	sの中で最初に現れるsubstrの位置を返す。ない場合は-1	FirstIndex("abc012漢字", "漢字") → 6
Join	Join(a, sep)	aの配列要素をsepを挟んで1つの文字列にする。	Join(["abc","def"], "-") → "abc-def"
LastIndex	LastIndex(s, substr)	sの中で最後に現れるsubstrの位置を返す。ない場合は-1
Repeat	Repeat(s, count)	sをcount回繰り返した文字列を返す	Repeat("abc012漢字", 3) → "abc012漢字abc012漢字abc012漢字"
Replace	Replace(s, old, new[, n])	sの中でold文字列をnew文字列にn回目まで置換する。nが0より小さい時は全て(デフォルトは-1)。
Split	Split(s, sep[, n])	sをsepで最大n個の要素に区切り配列で返す。nが0より小さい時は全て(デフォルトは-1)	Split("a,b,c", ",") → ["a", "b", "c"]
ToLower	ToLower(s)	sを小文字に変換する
ToUpper	ToUpper(s)	sを大文字に変換する
Trim	Trim(s[, cutset])	sの頭と最後のcutsetに含まれる文字を除いた文字列を返す。cutsetはデフォルトはスペース文字	Trim(" abc ") → "abc"
TrimLeft	TrimLeft(s[, cutset])	sの頭cutsetに含まれる文字を除いた文字列を返す。cutsetはデフォルトはスペース文字
TrimRight	TrimRight(s[, cutset])	sの最後のcutsetに含まれる文字を除いた文字列を返す。cutsetはデフォルトはスペース文字
TrimPrefix	TrimPrefix(s, prefix)	sがprefixではじまっていたら、それを取り除いた文字列を返す。始めっていない場合はsをそのまま返す	TrimPrefix("https://www.asteria.com", "https://") → "www.asteria.com"
TrimSuffix	TrimSuffix(s, suffix)	sがsuffixでおわっていたら、それを取り除いた文字列を返す。終わっていない場合はsをそのまま返す
Left	Left(s, len)	sの先頭からlen文字数を取り出す。lenは漢字などの文字も1文字と数える
Right	Right(s, len)	sの末尾からlen文字数を取り出す。lenは漢字などの文字も1文字と数える
Mid	Mid(s, start, len)	sのstart位置からlen文字数を取り出す。startは先頭の位置を1とし、漢字などの文字も1文字とみなし位置を指定します。lenは漢字などの文字も1文字と数える
Substring	Substring(s, start[, end])	sのstart位置からend位置までの文字列を取り出す。start/endは先頭の位置を0とし、漢字などの文字も1文字とみなし位置を指定する
Slice	Slice(s[, start[, end]])	sのstart位置からend位置までの文字列を取り出す。start/endは先頭の位置を0とし、漢字などの文字も1文字とみなし位置を指定する。start/endに負の値を指定した場合は末尾から位置指定とみなす
IFS	IFS (条件1, 値1[, 条件2, 値2, ...])	条件を1から順に評価し合致した値を返す。条件にtrueと指定すると必ず合致するので、最後の条件にtrueを指定すると、それ以外すべてという条件を指定できます。	IFS (ToFloat(cv.Payload) >= 10, "10以上です", true, "10未満です"

書式付の文字列を整形し文字列を返します。書式は%に続いて変換指定子とオプションでフラグ、幅、精度で指定できます。

変換指定子	説明
%b	整数2進数
%d	整数10進数
%x %X	16進数
%e %E	浮動小数、科学的表記法
%f %F	浮動小数、指数のない表記
%g %G	浮動小数、指数が大きい場合は%e、それ以外が%f
%s	文字列
%%	%そのものの文字

フラグ	説明
+	符号つき
-	左寄せ
0	幅未満のときはスペースではなく0を埋める

幅、精度	説明
%f	デフォルトの幅と精度
%9f	幅9
%.2f	精度2
%9.2f	幅9、精度2

例

Sprintf("メッセージ件数: %d", ToInt(cv.Payload))

Sprintf("浮動小数の小数点第二位まで: %.2f", cv.Payload)

以下の正規表現関数が利用できます。

関数名	引数	説明	例
RegExpMatch	RegexMatch(re, s)	正規表現reとsがマッチするかBoolで返す	RegexMatch("G.*o", "Gravio HubKit") → true
RegExpFind	RegexFind(re, s)	正規表現reとsがマッチした最初の文字列を返す	RegexFind("i.", "Gravio HubKit") → "io"
RegExpFindSubmatch	RegexFindSubmatch(re, s)	正規表現reとsがマッチした最初の文字列と括弧で囲まれた部分式があれば配列で返す	RegexFindSubmatch("(G.*o) (H.*t)", "Gravio HubKit") → ["Gravio HubKit", "Gravio", "HubKit"]
RegExpFindAll	RegexFindAll(re, s[, n])	正規表現reとsがマッチした全ての文字列を配列で返す	RegexFindAll("i.", "Gravio HubKit") → ["io", "it"]
RegExpReplace	RegexReplace(re, s, repl)	正規表現reとsがマッチしたreplに置換した文字列を返す。replでは$1のような部分式を使用できる。
UUID	UUID([sep])	UUID文字列を返す。sepはセパレータ(デフォルトは空文字列)

JSONPath()の使用例を解説します。

センサーデータ（cv.Payload）やトリガー条件で実行するアクションの引数（tv.Data）がJSON形式の場合にJSONPath()を使用して値を参照することができます。

サンプルデータ

{ "store": {
  "book": [
    { "category": "reference",
      "author": "Nigel Rees",
      "title": "Sayings of the Century",
      "price": 8.95
    },
    { "category": "fiction",
      "author": "Evelyn Waugh",
      "title": "Sword of Honour",
      "price": 12.99
    },
    { "category": "fiction",
      "author": "Herman Melville",
      "title": "Moby Dick",
      "isbn": "0-553-21311-3",
      "price": 8.99
    },
    { "category": "fiction",
      "author": "J. R. R. Tolkien",
      "title": "The Lord of the Rings",
      "isbn": "0-395-19395-8",
      "price": 22.99
    }
  ],
  "bicycle": {
    "color": "red",
    "price": 19.95
  }
}
}

                
                
例えば store → bicycle → color を参照する場合には
                
cv.Payload.store.bicycle.color
                
と記述することができますがJSONPath()を使用した場合には
                
JSONPath("$.store.bicycle.color", cv.Payload)
                
と記述することもできます。
                
                
JSONPathの第一引数 path
                

                    

                        
path
説明
                    
                    

                        
$
ルート オブジェクト/エレメント
                        
@
カレント オブジェクト/エレメント
                        
. or []
子オペレーター
                        
..
再帰下降
                        
＊
ワイルドカード
                        
[]
添え字演算子 （ネイティブの配列演算子）
                        
[,]
ユニオン演算子（代替名または配列インデックスをセットとして使用できます）
                        
[start:end:step]
配列スライス演算子
                        
?()
フィルタ（スクリプト）式
                        
()
基盤となるスクリプトエンジンを使用したスクリプト式
                    
                
                
                
JSONPathの第一引数 path の例
                

                    

                        
例
説明
                    
                    

                        
$.store.book[*].author
store内のbook配列のすべての author
                        
$..author
すべてのauthor
                        
$.store.*
store内のbook配列とbicycle
                        
$.store..price
store内のすべてのprice
                        
$..book[2]
3番目のbook
                        
$..book[(@.length-1)]
$..book[-1:]
最後のbook
                        
$..book[0,1]
$..book[:2]
book配列の最初の2つのbook
                        
$..book[?(@.isbn)]
book配列のすべてのisbn
                        
$..book[?(@.price<10)]
book配列のpriceが10より小さいもの
                        
$..*
すべてのノード/エレメント
                    
                
                
                
JSONPathの詳細は引用元の こちらを参照してください。