Go言語の文字列操作：Split、Join、Contains、Replaceなど

Goの文字列は変更できないバイトの並びで、通常はUTF-8のテキストです。演算子は文字列そのものに対して使え（+、==、<、インデックス、スライス）、それ以外はすべて標準の strings パッケージにあります。

package main

import (
	"fmt"
	"strings"
)

func main() {
	csv := "apple,banana,cherry"

	parts := strings.Split(csv, ",")
	fmt.Println(parts, len(parts))

	fmt.Println(strings.Join(parts, " | "))
	fmt.Println(strings.Contains(csv, "nan"))
	fmt.Println(strings.ReplaceAll(csv, ",", ";"))
	fmt.Println(strings.ToUpper(parts[0]))
	fmt.Println(strings.TrimSpace("   padded   ") + "!")
}

文字列を分割する

package main

import (
	"fmt"
	"strings"
)

func main() {
	fmt.Printf("%q\n", strings.Split("a,b,,c", ","))
	fmt.Printf("%q\n", strings.Split("", ","))
	fmt.Printf("%q\n", strings.Fields("  one  two\tthree\n"))
	fmt.Printf("%q\n", strings.SplitN("k=v=x", "=", 2))
	fmt.Printf("%q\n", strings.Split("go", ""))

	key, value, found := strings.Cut("timeout=30s", "=")
	fmt.Println(key, value, found)
}

Split("", ",") はつまずきやすいケースです。空の入力に対して、長さ0ではなく長さ1のスライスが返ります。ユーザー入力を分割するときは、Fields を使うか先に s == "" をチェックすれば、存在しない空の要素を避けられます。

strings.Cut は、key=value や user@host のようなペアを分けるのに最もすっきりした方法です。Go 1.24では、スライスを作らずに要素を1つずつ返すイテレータ版の strings.SplitSeq と strings.FieldsSeq も追加されました。

検索する

EqualFold 以外の検索はすべて大文字小文字を区別します。区別せずに検索するには、両方を小文字にするか、文字列全体の比較なら EqualFold を使います。

変形する

package main

import (
	"fmt"
	"strings"
)

func main() {
	s := "  Hello, Gopher!  "

	fmt.Printf("%q\n", strings.TrimSpace(s))
	fmt.Printf("%q\n", strings.Trim("--go--", "-"))
	fmt.Printf("%q\n", strings.TrimPrefix("v1.2.3", "v"))
	fmt.Printf("%q\n", strings.TrimSuffix("report.pdf", ".pdf"))
	fmt.Printf("%q\n", strings.TrimLeft("xxhixx", "x"))

	fmt.Println(strings.ToLower("MiXeD"), strings.ToUpper("mixed"))
	fmt.Println(strings.Replace("a-b-c-d", "-", "+", 2))
	fmt.Println(strings.ReplaceAll("a-b-c-d", "-", ""))
	fmt.Println(strings.Repeat("=", 20))
}

罠が1つあります。Trim、TrimLeft、TrimRight が受け取るのは接頭辞ではなく 文字の集合 です。strings.TrimLeft("abcab", "ab") は先頭の a と b をすべて取り除き、"cab" を返します。決まった接頭辞や接尾辞を取り除くには、TrimPrefix と TrimSuffix を使います。

連結とstrings.Builder

+ は文字列をつなぎ、fmt.Sprintf は値を整形して1つの文字列にします。文字列は変更できないので、どちらも毎回新しい文字列を確保します。数回の操作なら問題ありませんが、ループの中では遅くなります。+= のたびに、それまでに作ったものすべてがコピーされるからです。代わりに strings.Builder を使います。

package main

import (
	"fmt"
	"strings"
)

func main() {
	var b strings.Builder
	for i := 1; i <= 5; i++ {
		fmt.Fprintf(&b, "row %d", i)
		if i < 5 {
			b.WriteString(", ")
		}
	}
	fmt.Println(b.String())
	fmt.Println("length:", b.Len())

	// joining a slice is simpler still
	names := []string{"Ana", "Ben", "Chen"}
	fmt.Println("Hello " + strings.Join(names, ", "))
}

ゼロ値の strings.Builder はすぐに使えます。io.Writer を実装しているので、fmt.Fprintf で直接書き込めます。結果のおおよその大きさがわかっているなら、先に b.Grow(n) を呼びます。書き込んだ後の Builder はコピーせず、ポインタで渡してください。

複数行の文字列と生文字列

Goの文字列リテラルには2種類あります。

package main

import "fmt"

func main() {
	interpreted := "line one\nline two\ttabbed \"quoted\""
	raw := `C:\Users\ana\notes.txt
second line, \n stays literal`

	fmt.Println(interpreted)
	fmt.Println(raw)

	query := `
SELECT id, name
FROM users
WHERE active = true`
	fmt.Println(query)
}

ダブルクォートの文字列はエスケープ（\n、\t、\"、\\、\u00e9）を処理し、1行に収める必要があります。バッククォートの生文字列は改行も含めてすべてをそのまま扱うので、複数行の文字列、正規表現、JSON、Windowsのパスを書くのに使います。生文字列にバッククォートは入れられず、中のキャリッジリターンは取り除かれます。上のクエリは改行で始まっていることに注意してください。リテラルは開きバッククォートの直後から始まるからです。

長さ、インデックス、部分文字列

len(s) は バイト 数です。s[i] は バイト で、s[i:j] はバイト位置による部分文字列です。

package main

import (
	"fmt"
	"unicode/utf8"
)

func main() {
	s := "naïve café"

	fmt.Println(len(s), utf8.RuneCountInString(s))
	fmt.Println(s[0], string(s[0]))
	fmt.Println(s[:5]) // first 5 bytes
	fmt.Println(s[6:]) // from byte 6 to the end

	r := []rune(s)
	fmt.Println(string(r[:5])) // first 5 characters
}

ï と é はそれぞれ2バイトを使うので、この文字列は12バイトで10文字です。位置が strings.Index などから得たもの（文字の境界にあるバイトオフセット）であれば、バイト単位のスライスは安全です。「最初のn文字」を取り出すには、先に []rune に変換します。日本語のように1文字が3バイトになるテキストでは特に重要です。UTF-8の詳細はルーンとバイトのページで説明しています。

文字列は変更できない

バイトをその場で変更することはできません。s[0] = 'H' はコンパイルエラーになります（cannot assign to s[0] (neither addressable nor a map index expression)）。strings の関数はすべて新しい文字列を返します。編集するには、[]byte か []rune に変換してスライスを変更し、元に戻します。

b := []byte("hello")
b[0] = 'H'
s := string(b) // "Hello"

変更できないからこそ、部分文字列は安価です。s[2:5] はコピーせずに s とメモリを共有します。その裏返しとして、巨大な文字列の小さな部分文字列が、巨大な文字列全体をメモリに残し続けます。大きな入力の短い一部を保持するときは strings.Clone（Go 1.20）を使います。

文字列を比較する

== と != は内容を比較し、< と > はバイトごとに比較します。ASCIIならアルファベット順です。strings.Compare もありますがあまり必要になりません。[]string に対する slices.Sort は < を使います。英語以外のテキストをロケールに沿って並べるには、golang.org/x/text/collate を使います。

他の型から変換する

数値は strconv.Itoa、strconv.FormatFloat、fmt.Sprintf で文字列になり、文字列は strconv.Atoi と strconv.ParseFloat で数値になります。string(42) と書いてはいけません。コードポイント42の文字 "*" になります。型変換のページに完全な表があります。

query := `SELECT id, name
FROM users
WHERE active = true`