TypeScriptで関数を定義する基本構文と書き方
生徒
「TypeScriptで、自分で処理をまとめておく“関数”ってどうやって書くんですか?」
先生
「TypeScriptでは、関数という“ひとかたまりの命令”を定義して、あとから何度でも使えるようにできますよ。」
生徒
「便利そうですね!その関数って、どう書けばいいんですか?」
先生
「それでは、TypeScriptの関数の書き方を一つずつ見ていきましょう!」
1. 関数とは?
関数とは、よく使う処理をひとまとめにして「名前」をつけておく仕組みです。あとからその名前を呼び出すだけで、中に書いておいた処理を何度でも実行できます。
例えば、毎回「あいさつの文章」を表示したいときに、そのたびに同じコードを書くのは大変ですよね。そこで「あいさつ専用の関数」を作っておくと、その関数を呼ぶだけで同じ処理を簡単に使い回せます。
イメージとしては、「あいさつボタン」「計算ボタン」のようなものを、自分で作っておく感じです。ボタンに名前を付けておけば、必要なときにそのボタンを押すだけで、同じ動きをしてくれます。
function greetUser() {
console.log("こんにちは! TypeScriptの関数の世界へようこそ!");
}
greetUser(); // 関数を呼び出して実行する
上のサンプルでは、greetUserという名前の関数を用意しています。中には「あいさつの文章を表示する」という処理がまとまっています。実際に処理を動かしたいときは、下の行のようにgreetUser()と書いて「呼び出す」だけです。
このように、TypeScriptで関数を使うと「同じ処理をくり返し書かなくてよい」「あとから意味のまとまりごとに見直しやすい」といったメリットがあります。TypeScriptではJavaScriptと同じように関数を使えますが、後の章で出てくる「型(たとえば文字か数字か)」と組み合わせることで、より安全で分かりやすいコードを書けるようになります。
2. TypeScriptの基本的な関数の書き方
ここでは、TypeScriptの関数が実際にどのような形で書かれるのか、いちばん基本的なパターンを見ていきます。
まずは、「こんにちは!」というあいさつの文章を画面に表示するだけの、とてもシンプルな関数を作ってみましょう。
function greet(): void {
console.log("こんにちは!");
}
greet(); // 関数を呼び出します
このサンプルの1行目は、関数を「定義」している部分です。functionは「これから関数を作るよ」という合図となるキーワードです。そのすぐ後ろにあるgreetが関数の名前で、「あいさつする処理だな」と分かるような名前にしておくと、あとからコードを読むときに理解しやすくなります。
()(丸かっこ)の中には、本来は「関数に渡す値(引数)」を書くことがありますが、この段階では何も受け取らないので空のままにしてあります。その後ろの: voidは「この関数は値を返さないよ」という意味です。あいさつするだけで、なにか計算結果を返すわけではないので、このような書き方になります。
{ }(波かっこ)で囲まれている部分が、関数の中身です。ここには実際にやってほしい命令を書きます。今回の例では、console.log("こんにちは!");という1行だけが入っており、「こんにちは!」というメッセージをコンソールに表示します。
greet();
greet();
下のサンプルのように、同じgreet()を2回書けば、関数の中身が2回実行されます。関数は一度定義しておけば、必要なだけ何度でも呼び出せるくり返し可能な処理のセットだとイメージすると分かりやすいです。
このように、TypeScriptの基本的な関数は「キーワード」「名前」「かっこ」「中身(処理)」という4つのパーツを押さえれば怖くありません。まずは今回のようなシンプルな例から慣れていき、徐々に引数や戻り値を使った少し複雑な関数にステップアップしていきましょう。
3. 引数ありの関数を作る
ここでは、関数に「情報を渡す」と、どのように処理の内容が変わるのかを見ていきます。関数に渡す追加の情報のことを引数(ひきすう)と呼びます。引数を使うことで、同じ関数でも受け取る値によって動きを変えられるようになります。
たとえば、誰にあいさつするのかを引数で受け取り、その名前を使ってメッセージを作る関数を考えてみましょう。
function sayHello(name: string): void {
console.log("こんにちは、" + name + "さん!");
}
sayHello("たろう");
sayHello("はなこ");
この例では、name: stringと書くことで「name という引数には、文字列(string)を渡してくださいね」という約束をしています。引数は、関数が動くための材料のようなもので、料理に例えるなら「具材」を渡すイメージです。渡された具材によって、できあがる料理(表示されるメッセージ)が変わるわけです。
下の2つの呼び出し例のように、渡す名前が変われば表示される文章も変わります。引数を使うことで、関数をより柔軟に、そして再利用しやすくすることができます。
sayHello("ゆき");
sayHello("まこと");
このように、引数は「関数にとって必要な材料を外から渡すための入口」です。引数があることで、同じ関数でもさまざまな用途に対応できるようになり、プログラム全体の見通しも格段によくなります。
4. 戻り値を返す関数の書き方
関数は、単に処理を実行するだけでなく、その結果を呼び出し元へ渡すこともできます。この「関数が外に返す値」のことを戻り値と呼びます。戻り値があることで、関数を計算機のように使い、結果を次の処理に活用できるようになります。
たとえば、2つの数字を足して、その合計を返すシンプルな関数を見てみましょう。戻り値の仕組みを理解するにはとても良い例です。
function addNumbers(a: number, b: number): number {
return a + b;
}
let result = addNumbers(3, 5);
console.log("合計は: " + result);
この例のポイントは、関数名の後ろにある: numberです。これは「この関数は数字を戻り値として返しますよ」という宣言になります。書いておくことで、TypeScriptが「この関数が返すものは数字だ」と判断し、コードの safety(安全性)も高まります。
関数の中では、returnというキーワードを使って値を返します。上の例ではa + bがそのまま戻り値となり、呼び出し元のresultに数字が入る仕組みです。
let total1 = addNumbers(10, 20);
let total2 = addNumbers(7, 8);
console.log(total1); // 30
console.log(total2); // 15
このように、戻り値がある関数は「計算結果を受け取って使いたいとき」にとても役立ちます。引数と組み合わせることで、関数がさらに柔軟に働き、プログラム全体の見通しも良くなるのが特徴です。
5. 無名関数とアロー関数の書き方
関数には、名前をつけて定義する方法以外に、無名関数(名前のない関数)という書き方があります。無名関数は「ちょっとした処理を一時的に使いたいとき」や「関数をそのまま値として扱いたいとき」に便利です。
さらに、近年のJavaScriptやTypeScriptでは、無名関数をもっと簡潔に書けるアロー関数がよく使われています。見た目がスッキリして読みやすく、短い処理を書くのにとても相性が良いのが特徴です。
// アロー関数で書いたシンプルな計算処理
const multiply = (x: number, y: number): number => {
return x * y;
};
console.log(multiply(4, 3)); // 12
=>(矢印)の形をしていることから、「アロー関数」と呼ばれます。関数自体をひとつの値として扱い、const multiplyのように変数へ直接代入して使うスタイルです。
アロー関数の良い点は、見た目が簡単になるだけでなく、「関数をその場で作ってその場で使う」という書き方にとても向いていることです。特に、短い処理を手早く書きたい場面で役立ち、コード全体の読みやすさも向上します。
// 一時的に処理を渡したいときにも便利
const showMessage = (msg: string): void => {
console.log("メッセージ:", msg);
};
showMessage("学習中です!");
このように、無名関数やアロー関数を覚えておくと、「関数は名前をつけて定義するもの」という枠にとらわれず、もっと柔軟に処理を書けるようになります。コードの表現力がぐっと広がるので、ぜひ慣れていきましょう。
6. 関数の型注釈を使うメリット
TypeScriptでは、関数に「どんな値を受け取り、どんな値を返すのか」を型として書いておくことができます。これを型注釈(タイプアノテーション)といいます。型を明確にすることで、思わぬまちがいを未然に防ぎ、コードの読みやすさや安心感がぐっと高まります。
たとえば、本来「数字の足し算」をする関数に、誤って文字列を渡してしまった場合、TypeScriptはすぐにエラーとして教えてくれます。どこが間違っているのか分かりやすくなるため、初心者にとっても心強い仕組みです。
// number型を受け取ることを明示した関数
function double(value: number): number {
return value * 2;
}
console.log(double(5)); // 10
// console.log(double("5")); // エラー:文字列は使えないと警告される
このように、型注釈をつけると「この関数は数字を使うものなんだ」と一目で分かり、まちがった使い方をするときには警告してくれるため、コードの信頼性が大きく向上します。
特に、プロジェクトが大きくなるほど型の効果は大きく、後から見返したときにもスムーズに理解できるようになります。TypeScriptが選ばれる理由のひとつが、この「型が守ってくれる」安心感なのです。
7. 関数の中で別の関数を呼び出す
プログラムが少し複雑になってくると、「ひとつの関数の中で別の関数を使いたい」という場面がよく出てきます。処理を細かく分けておくことで、コードが見やすくなり、あとから修正するときもどこを直せばよいか判断しやすくなります。
たとえば「あいさつの文章を作る役目」と「それを表示する役目」を別々の関数に分けると、次のように分かりやすく整理できます。
function getGreeting(name: string): string {
return "こんにちは、" + name + "さん!";
}
function greetUser() {
let message = getGreeting("さくら"); // 別の関数を呼び出して文章を受け取る
console.log(message);
}
greetUser();
getGreetingは「好きな名前を入れるとあいさつ文を作って返す」役割の関数です。一方、greetUserはその返ってきた文章を表示する役割だけに集中しています。このように役割ごとに関数を分けておくと、コード全体の流れが自然になり、将来的に「表示方法を変えたい」「文章の作り方を変えたい」という場合も、それぞれの関数だけを修正すればよくなります。
// 別の名前でも同じ仕組みを再利用できる
console.log(getGreeting("ゆうき"));
console.log(getGreeting("みさき"));
このように、関数の中で別の関数を呼び出すことで、共通部分を何度でも再利用でき、コードがスッキリ整理されます。プログラムを組み立てるうえでとても大切な考え方なので、ぜひ意識して使ってみてください。
まとめ
TypeScript(タイプスクリプト)における関数の定義は、プログラミングの基礎の中でも特に重要な要素のひとつです。関数とは、ひとまとまりの処理に名前をつけて再利用できる仕組みであり、コードの見通しを良くしたり、同じ処理を何度も書く手間を省いたりするために欠かせません。
TypeScriptでは、JavaScriptと同じように関数を書けるだけでなく、引数や戻り値に型注釈をつけることができるのが特徴です。これにより、関数の使い方を明確にし、間違った型の値が渡された場合にもコンパイル時にエラーとして検出できます。
たとえば、「文字列型の名前を受け取ってあいさつを表示する関数」や、「2つの数値を加算して結果を返す関数」など、目的ごとに型を定義することで、安全で読みやすいコードを書くことができます。以下に、今回学んだ内容を活用したサンプルコードを紹介します。
サンプル:型付きの関数を複数定義して使い分ける
// 名前を受け取ってあいさつする関数
function sayHi(name: string): string {
return `こんにちは、${name}さん!`;
}
// 数値を受け取って倍にするアロー関数
const double = (value: number): number => {
return value * 2;
};
// 結果を表示するだけの関数(戻り値なし)
function showResult(message: string): void {
console.log(message);
}
// 使用例
let greeting = sayHi("りん");
let doubled = double(10);
showResult(greeting);
showResult("2倍の結果は: " + doubled);
こんにちは、りんさん!
2倍の結果は: 20
上記のように、関数の型注釈を活用することで、処理の目的と戻り値の型が明確になり、コードの信頼性が一気に高まります。
また、TypeScriptではアロー関数や無名関数を使って、より簡潔に記述することも可能です。開発の現場では、アロー関数が特に多く用いられ、イベント処理やコールバック関数などでも大活躍します。
さらに、関数の中で別の関数を呼び出したり、関数を変数として扱ったりすることで、柔軟な構造のコードを組み立てることができます。関数をブロックのように組み合わせていく感覚は、まさにプログラミングの醍醐味といえるでしょう。
今回の記事を通じて、「関数の基本構文」「引数と戻り値の書き方」「アロー関数の記法」「型注釈の重要性」など、TypeScriptで関数を定義する際に知っておきたいポイントを一通り学べたはずです。関数をマスターすることで、今後の開発に大きな自信が持てるようになりますよ。
生徒
「先生、関数って“まとめて使える命令”って感じで、すごく便利ですね!」
先生
「そうですね。同じ処理を何度も書かなくて済むので、コードもスッキリしますよ。」
生徒
「今回は、引数に型をつけたり、戻り値を返したり、アロー関数を使ったり、色々学べました!」
先生
「それは素晴らしいですね。TypeScriptでは、関数の型を明示することで、より安全でわかりやすいコードが書けます。実際にコードを書きながら、どんどん試していくともっと理解が深まりますよ。」
生徒
「はい!まずは小さな関数をたくさん書いて練習してみます!」
先生
「それが一番の近道です。これからのTypeScript学習も、楽しみながら進めていきましょう!」