このシリーズの一覧はこちら
はじめに
GroovyにはJavaの標準API(JDK)を拡張したGroovy JDK(GDK)があります。大量の便利メソッドが追加されており、これを使いこなすだけでも相当のことができるようになります。このシリーズでは毎回１クラスずつ各メソッドの使用例をサンプル付きでご紹介していきたいと思います。
「今回は java.lang.String です」
String編その２では区切り系、行区切り系、改行コード系、プロセス実行系のメソッドをご紹介します。それでは早速見て行きましょう。
区切り系メソッド
行区切り系メソッド
改行コード系メソッド
プロセス実行系メソッド
String[] split() [since v1.5.0]
ホワイトスペース(" \t\n\r\f")で区切った文字列配列を返却してくれるコンビニエンスメソッドです。
これはわりと便利で、'aaa bbb ccc' のようにスペース区切りやタブ区切りの文字列を簡単にリスト化できます。
assert ['aaa', 'bbb', 'ccc'] == 'aaa bbb ccc'.split() assert ['aaa', 'bbb', 'ccc'] == 'aaa\tbbb\tccc'.split()
参照: List tokenize()
Object splitEachLine(String regex, Closure closure) [since v1.5.5]
文字列を改行で区切ってその行を指定された区切り文字(正規表現)でsplit()してからクロージャに渡します。
'''aaa->bbb ccc->ddd eee->fff'''.splitEachLine('->') { println "key:${it[0]}, value:${it[1]}" }
Object splitEachLine(Pattern pattern, Closure closure) [since v1.6.8]
Object splitEachLine(String regex, Closure closure)のPattern版。
List tokenize() [since v1.0]
ホワイトスペース(" \t\n\r\f")で区切った文字列リストを返却してくれるコンビニエンスメソッドです。
これはわりと便利で、'aaa bbb ccc' のようにスペース区切りやタブ区切りの文字列を簡単にリスト化できます。
assert ['aaa', 'bbb', 'ccc'] == 'aaa bbb ccc'.tokenize() assert ['aaa', 'bbb', 'ccc'] == 'aaa\tbbb\tccc'.tokenize()
内部的にはStringTokenizerを使っているようです。
参照: String[] split()
List tokenize(String token) [since v1.0]
Stringをセパレータとして、この文字列を分割した結果のリストを返却します。
assert 'a::b::c'.tokenize('::') == ['a', 'b', 'c']
内部的にはStringTokenizerを使っているようです。
List tokenize(Character token) [since v1.7.2]
charをセパレータとして、この文字列を分割した結果のリストを返却します。
char pathSep = ':' assert "/tmp:/usr".tokenize(pathSep) == ["/tmp", "/usr"]
内部的にはStringTokenizerを使っているようです。
List toList() [since v1.0]
文字列を1文字ずつ分割したStringのリストにして返却します。
assert 'abcde'.toList() == ['a', 'b', 'c', 'd', 'e']
このメソッドを利用して一度文字列をリストにしておけば、
リストに対してのシーケンシャルな操作が可能となるため便利です。
List readLines() [since v1.5.5]
文字列を各行ごとに分割してリストにします。
assert '''\ aaa bbb ccc'''.readLines() == ['aaa', 'bbb', 'ccc']
Object eachLine(Closure closure) [since v1.5.5]
クロージャを受け取って、各行ごとに処理をさせます。
def str = '''aaa bbb ccc '''.eachLine { println it }
出力
aaa bbb ccc
ちなみに、クロージャの第2パラメータを与えると、行番号(0から開始)が取得できます。
def str = '''aaa bbb ccc '''.eachLine { it, no -> println "$no: $it" }
Object eachLine(int firstLine, Closure closure) [since v1.5.7]
クロージャを受け取って、各行ごとに処理をさせます。firstLine数値を指定するとその数値から行番号が始まります。*1
def str = '''aaa bbb ccc '''.eachLine(10) { it, no -> println "$no: $it" }
String normalize() [since v1.6.0]
文字列中に含まれる改行コード(LF or CR/LF or CR)をLFに統一(normalize)します。
def cr = 'aaa\rbbb\rccc' def lf = 'aaa\nbbb\nccc' def crlf = 'aaa\r\nbbb\r\nccc' def normalizedCr = cr.normalize() def normalizedLf = lf.normalize() def normalizedCrLf = crlf.normalize() assert normalizedCr.count('\n') == 2 // 改行文字はLFになっている assert normalizedCr.count('\r\n') == 0 // CRLFはない assert normalizedCr.count('\r') == 0 // CRはない assert normalizedLf.count('\n') == 2 // 改行文字はLFになっている assert normalizedLf.count('\r\n') == 0 // CRLFはない assert normalizedLf.count('\r') == 0 // CRはない assert normalizedCrLf.count('\n') == 2 // 改行文字はLFになっている assert normalizedCrLf.count('\r\n') == 0 // CRLFはない assert normalizedCrLf.count('\r') == 0 // CRはない
String denormalize() [since v1.6.0]
文字列中に含まれる改行コード(LF or CR/LF or CR)をプラットフォームの改行コードに合わせて変換(denormalize)します。
def cr = 'aaa\rbbb\rccc' def lf = 'aaa\nbbb\nccc' def crlf = 'aaa\r\nbbb\r\nccc' def denormalizedCr = cr.denormalize() def denormalizedLf = lf.denormalize() def denormalizedCrLf = crlf.denormalize() // どんな改行コードの文字列でも // プラットフォームに合わせた改行コードへと変換される assert [ denormalizedCr, denormalizedLf, denormalizedCrLf ].count(denormalizedCr) == 3 // 全て同じ文字列
Process execute() [since v1.0]
文字列をコマンドと見立ててコマンドを実行します。
戻り値はProcessなので以下サンプルではinputStreamから出力された文字列を取得しています。
for *nix
println 'ls -l'.execute().in.text
for Windows
println 'dir'.execute().in.text
参考:
Groovy - Executing External Processes From Groovy
Groovy - Process Management
Process execute(String[] envp, File dir) [since v1.0]
環境変数とカレントディレクトリを指定してコマンドを実行します。
println 'env'.execute(['ABC=10'], new File('.')).in.text
*1:int型なのでマイナスでも大丈夫です。