layout	title
reference	基本的な構文

基本的な構文

ここでは、基本的な構文を例とともに集めてみました。各セクションの終わりには、関連するトピックのより詳しい解説へのリンクがあります。

また、Kotlinの基本をJetBrains AcademyのフリーのKotlin Core trackで学ぶ事も出来ます。

パッケージの定義とインポート

パッケージの記述は、ソースファイルの先頭に置かなければなりません。

package my.demo

import kotlin.text.*

// ...

ディレクトリとパッケージと一致する必要はありません。ソースファイルは、ファイルシステム内の任意の場所に配置することができます。

パッケージを参照してください。

プログラムのエントリーポイント

Kotlinアプリケーションのエントリーポイントはmain関数です。

{% capture kotlin-basic-syntax-hello-world %} fun main() { println("Hello world!") } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-hello-world %}

mainの別の形式として、可変長のStringの引数を受け付けるものもあります。

{% capture kotlin-basic-syntax-hello-world-2 %} fun main(args: Array) { println(args.contentToString()) } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-hello-world-2 %}

標準出力へのプリント

printは引数を標準出力へとプリントします。

{% capture kotlin-basic-syntax-print-1 %} fun main() { //sampleStart print("Hello ") print("world!") //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-print-1 %}

printlnは引数をプリントし、その後に改行を追加します。そうする事で次にプリントしたものが次の行に出るようになります。

{% capture kotlin-basic-syntax-println-1 %} fun main() { //sampleStart println("Hello world!") println(42) //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-println-1 %}

関数の定義

2つのInt型の引数を持ち、Int型を戻り値とする関数：

{% capture kotlin-basic-syntax-return-int-1 %} //sampleStart fun sum(a: Int, b: Int): Int { return a + b } //sampleEnd

fun main() { print("3と5の合計は ") println(sum(3, 5)) } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-return-int-1 %}

関数の本体は式でも構いません。その場合の戻りの型は型推論で推測されます。

{% capture kotlin-basic-syntax-function-expression-1 %} //sampleStart fun sum(a: Int, b: Int) = a + b //sampleEnd

fun main() { println("19と23の合計は ${sum(19, 23)}") } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-function-expression-1 %}

意味のある値を返さない関数：

{% capture kotlin-basic-syntax-return-unit-1 %} //sampleStart fun printSum(a: Int, b: Int): Unit { println("$a と $b の合計は ${a + b}") } //sampleEnd

fun main() { printSum(-1, 8) } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-return-unit-1 %}

Unit型の戻り値は省略できます：

{% capture kotlin-basic-syntax-function-omit-unit %} //sampleStart fun printSum(a: Int, b: Int) { println("$a と $b の合計は ${a + b}") } //sampleEnd

fun main() { printSum(-1, 8) } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-function-omit-unit %}

関数を参照してください。

変数

読み取り専用のローカル変数はキーワードvalを用いて定義出来ます。そうして作った変数は一回しか代入できない：

{% capture kotlin-basic-syntax-val %} fun main() { //sampleStart val a: Int = 1 // 即座の代入 val b = 2 // Int型が推論される val c: Int // 初期値が与えられない場合、型指定が必要 c = 3 // あとから代入 //sampleEnd println("a = $a, b = $b, c = $c") } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-val %}

再代入可能な変数を作るためには、varキーワードを使います。

{% capture kotlin-basic-syntax-var %} fun main() { //sampleStart var x = 5 // Int型が推論される x += 1 //sampleEnd println("x = $x") } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-var %}

変数をトップレベルで定義する事も出来ます。

{% capture kotlin-basic-syntax-variable-top-level %} //sampleStart val PI = 3.14 var x = 0

fun incrementX() { x += 1 } //sampleEnd

fun main() { println("x = $x; PI = $PI") incrementX() println("incrementX()") println("x = $x; PI = $PI") } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-variable-top-level %}

プロパティとフィールドも参照してください。

クラスとインスタンスの作成

クラスを定義するには、classキーワードを使います。

class Shape

クラスのプロパティは宣言や本体の所に並べる事が出来ます。

class Rectangle(var height: Double, var length: Double) {
    var perimeter = (height + length) * 2 
}

クラスの宣言に並べられたパラメータによるデフォルトのコンストラクタが自動的に生成されて使う事が出来ます。

{% capture kotlin-basic-syntax-class-constructor %} class Rectangle(var height: Double, var length: Double) { var perimeter = (height + length) * 2 } fun main() { //sampleStart val rectangle = Rectangle(5.0, 2.0) println("外周は ${rectangle.perimeter}") //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-class-constructor %}

クラスの継承はコロン(:)で宣言出来ます。クラスはデフォルトではfinalです。クラスを継承出来るようにするためには、openで印をつけます。

open class Shape

class Rectangle(var height: Double, var length: Double): Shape() {
    var perimeter = (height + length) * 2 
}

クラスとobject式と宣言を参照ください。

文字列テンプレートの使用

{% capture kotlin-basic-syntax-string-templates %} fun main() { //sampleStart var a = 1 // テンプレートの中にシンプルに名前だけのケース:（訳：aは$aです） val s1 = "a is $a"

a = 2
// 任意の式をテンプレートに入れる:（訳：aは$aだったが、今は$aです）
val s2 = "${s1.replace("is", "was")}, but now is $a"

//sampleEnd println(s2) } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-string-templates %}

詳細は文字列テンプレートを参照してください。

条件式

{% capture kotlin-basic-syntax-conditional-expressions %} //sampleStart fun maxOf(a: Int, b: Int): Int { if (a > b) { return a } else { return b } } //sampleEnd

fun main() { println("0 と 42 で大きい方は ${maxOf(0, 42)}") } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-conditional-expressions %}

Kotlinでは、ifを式としても使用出来ます。

{% capture kotlin-basic-syntax-expressions %} //sampleStart fun maxOf(a: Int, b: Int) = if (a > b) a else b //sampleEnd

fun main() { println("0 と 42 で大きい方は ${maxOf(0, 42)}") } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-expressions %}

if式を参照してください。

forループ

{% capture kotlin-basic-syntax-for-loop %} fun main() { //sampleStart val items = listOf("apple", "banana", "kiwifruit") for (item in items) { println(item) } //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-for-loop %}

または

{% capture kotlin-basic-syntax-for-loop-indices %} fun main() { //sampleStart val items = listOf("apple", "banana", "kiwifruit") for (index in items.indices) { println("$index 番目の要素は ${items[index]}") } //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-for-loop-indices %}

forループを参照してください。

whileループ

{% capture kotlin-basic-syntax-while-loop %} fun main() { //sampleStart val items = listOf("apple", "banana", "kiwifruit") var index = 0 while (index < items.size) { println("$index 番目の要素は ${items[index]}") index++ } //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-while-loop %}

whileループを参照してください。

when式

{% capture kotlin-basic-syntax-when-expression %} //sampleStart fun describe(obj: Any): String = when (obj) { 1 -> "One" "Hello" -> "挨拶" is Long -> "Long" !is String -> "文字列では無い" else -> "Unknown" } //sampleEnd

fun main() { println(describe(1)) println(describe("Hello")) println(describe(1000L)) println(describe(2)) println(describe("other")) }

{% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-when-expression %}

when式を参照してください。

範囲(Range)

in演算子を使用すると、数が範囲内にあるかどうかを確認できます：

{% capture kotlin-basic-syntax-range-in %} fun main() { //sampleStart val x = 10 val y = 9 if (x in 1..y+1) { println("範囲内です") } //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-range-in %}

数が範囲外であるかどうかを確認します：

{% capture kotlin-basic-syntax-out-of-range %} fun main() { //sampleStart val list = listOf("a", "b", "c")

if (-1 !in 0..list.lastIndex) {
    println("-1 は範囲外")
}
if (list.size !in list.indices) {
    println("listのsizeも、有効なインデックスの範囲外です")
}

//sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-out-of-range %}

範囲内で反復処理：

{% capture kotlin-basic-syntax-iterate-range %} fun main() { //sampleStart for (x in 1..5) { print(x) } //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-iterate-range %}

等差数列の上を反復処理する例：

{% capture kotlin-basic-syntax-iterate-progression %} fun main() { //sampleStart for (x in 1..10 step 2) { print(x) } println() for (x in 9 downTo 0 step 3) { print(x) } //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-iterate-progression %}

範囲を参照してください。

コレクション

コレクション内で反復処理：

{% capture kotlin-basic-syntax-iterate-collection %} fun main() { val items = listOf("apple", "banana", "kiwifruit") //sampleStart for (item in items) { println(item) } //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-iterate-collection %}

コレクションがあるオブジェクトを含むかをin演算子で調べる：

{% capture kotlin-basic-syntax-collection-in %} fun main() { val items = setOf("apple", "banana", "kiwifruit") //sampleStart when { "orange" in items -> println("ジューシー") "apple" in items -> println("りんごでもいいよ") } //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-collection-in %}

コレクションをフィルタしたりマップするのにラムダ式を使用します：

{% capture kotlin-basic-syntax-collection-filter-map %} fun main() { //sampleStart val fruits = listOf("banana", "avocado", "apple", "kiwifruit") fruits .filter { it.startsWith("a") } .sortedBy { it } .map { it.uppercase() } .forEach { println(it) } //sampleEnd } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-collection-filter-map %}

コレクション概要を参照してください。

Nullableな値とnullチェック

参照がnull値を取り得る場合、明示的にnullableとしてマークする必要があります。 Nullableな型は?が最後にあるものです。

strが整数を保持していない場合はnullを返します：

fun parseInt(str: String): Int? {
  // ...
}

nullableを返す関数を使用：

{% capture kotlin-basic-syntax-function-nullable-value %} fun parseInt(str: String): Int? { return str.toIntOrNull() }

//sampleStart fun printProduct(arg1: String, arg2: String) { val x = parseInt(arg1) val y = parseInt(arg2)

// `x`, `y`はnullが入っていることがあるので、`x * y`はエラーを引き起こす
if (x != null && y != null) {
    // xとyは、nullチェックの後、自動的に非nullable型へキャストされる
    println(x * y)
}
else {
    println("'$arg1' か '$arg2' は数値では無い")
}

} //sampleEnd

fun main() { printProduct("6", "7") printProduct("a", "7") printProduct("a", "b") } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-function-nullable-value %}

または

{% capture kotlin-basic-syntax-function-null-check %} fun parseInt(str: String): Int? { return str.toIntOrNull() }

fun printProduct(arg1: String, arg2: String) { val x = parseInt(arg1) val y = parseInt(arg2)

//sampleStart // ... if (x == null) { println("arg1の数値のフォーマットが誤りです: '$arg1'") return } if (y == null) { println("arg2の数値のフォーマットが誤りです: '$arg2'") return }

// xとyは、nullチェックの後、自動的に非nullable型へキャストされる
println(x * y)

//sampleEnd }

fun main() { printProduct("6", "7") printProduct("a", "7") printProduct("99", "b") } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-function-null-check %}

Nullセーフティを参照してください。

型チェックと自動キャスト

is演算子は、ある式がある型のインスタンスであるかのチェックを行います。読み取り専用のローカル変数やプロパティが特定の型であるかチェックされている場合は、明示的にキャストする必要はありません：

{% capture kotlin-basic-syntax-is-operator %} //sampleStart fun getStringLength(obj: Any): Int? { if (obj is String) { // obj はこのブランチ内では自動的にStringへキャストされる return obj.length }

// `obj` は型チェックが行われたブランチ外では、まだ`Any`型である
return null

} //sampleEnd

fun main() { fun printLength(obj: Any) { println("'$obj'の長さを取得。結果: ${getStringLength(obj) ?: "エラー: オブジェクトは文字列ではありません"} ") } printLength("Incomprehensibilities") printLength(1000) printLength(listOf(Any())) } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-is-operator %}

または

{% capture kotlin-basic-syntax-is-operator-expression %} //sampleStart fun getStringLength(obj: Any): Int? { if (obj !is String) return null

// `obj` はこのブランチ内では自動的に`String`へキャストされる
return obj.length

} //sampleEnd

fun main() { fun printLength(obj: Any) { println("'$obj'の長さを取得。結果: ${getStringLength(obj) ?: "エラー: オブジェクトは文字列ではありません"} ") } printLength("Incomprehensibilities") printLength(1000) printLength(listOf(Any())) } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-is-operator-expression %}

あるいは

{% capture kotlin-basic-syntax-is-operator-logic %} //sampleStart fun getStringLength(obj: Any): Int? { // obj は&&の右側では自動的にStringへキャストされる if (obj is String && obj.length > 0) { return obj.length }

return null

} //sampleEnd

fun main() { fun printLength(obj: Any) { println("'$obj'の長さを取得。結果: ${getStringLength(obj) ?: "エラー: オブジェクトは文字列ではありません"} ") } printLength("Incomprehensibilities") printLength("") printLength(1000) } {% endcapture %} {% include kotlin_quote.html body=kotlin-basic-syntax-is-operator-logic %}

クラスと型のキャストを参照してください。

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

basic-syntax.md

basic-syntax.md

基本的な構文

パッケージの定義とインポート

プログラムのエントリーポイント

標準出力へのプリント

関数の定義

変数

クラスとインスタンスの作成

コメント

文字列テンプレートの使用

条件式

forループ

whileループ

when式

範囲(Range)

コレクション

Nullableな値とnullチェック

型チェックと自動キャスト

Files

basic-syntax.md

Latest commit

History

basic-syntax.md

File metadata and controls

基本的な構文

パッケージの定義とインポート

プログラムのエントリーポイント

標準出力へのプリント

関数の定義

変数

クラスとインスタンスの作成

コメント

文字列テンプレートの使用

条件式

forループ

whileループ

when式

範囲(Range)

コレクション

Nullableな値とnullチェック

型チェックと自動キャスト