Swift

【Swift】わかりやすいプログラムを目指す!コメントの使い方

【Swift】わかりやすいプログラムを目指す!コメントの使い方_サムネ

こんにちは、コンジ(@pippi_kon)です。

この記事は、主にプログラミング言語「Swift」の初心者向けに、iPhoneアプリを作るための情報を記載しています。

今回は、プログラムをわかりやすくするコメントについてご紹介します。

コメントとは

プログラムの説明文

コメントとは、プログラム内に書けるメモや説明文のことです。

コメントはプログラム実行時に無視されるため処理に影響を与えることはありません

ですが、コメントはとても重要です。

 

プログラムが長くなってくると、どこでどのような処理が行われているかがわかりにくくなってきます。

1行ずつ順番に解読していくのは疲れますし非効率です。

そんな時に活躍するのがコメント

コメントで「ここはこんな処理をしてるよ」と説明文をつけておけばプログラムを読みやすくなります

 

チーム開発では必須

プログラムを他人と共有する時にも非常に有効です。

人が書いたプログラムって基本的に読みにくいですよね。

なぜなら、自分のコーディングスタイルと違うから。

なので、コメントを書いて「ここではこんなことをしているよ」という処理の内容を書いてあげると親切です。

 

さらに、既存のプログラムコードを使用しないようにする(退避)する場合にも便利です。

プログラムコードで不要になった部分があるけど、あとでまた復活させるかもしれないので消したくない…

そんな時はプログラムをコメント化して(コメントアウトという)実行されないようにしましょう

 

コメントは諸刃の剣

コメントはとても便利なものだと言ってきましたが、実は諸刃の剣でもあります。

なぜならコメントに間違いが書いてあるおそれがあるからです。

単に間違っているパターンもあれば、プログラム改修によって処理が変わったパターンもあります。

コメントに書いてあることだけを信じてプログラムを作成するとバグを作り込んでしまうおそれがあります。

プログラム追加・修正する際は、あくまでコメントは参考程度にし、プログラムの前後関係は必ず確認しましょう

 


書式

コメントは2種類の記述方法があります。

書式1

// 1行コメント

 

書式2

/* 複数行コメント */

 

使い方

以下の2パターンの使い方についてご紹介します。

  1. 1行コメント
  2. 複数行コメント

なお、いずれのパターンもSingle View Appプロジェクトを作成した直後の状態を前提としています。

【Swift】基本的なプロジェクト(Single View App)の作成方法iPhoneアプリを作成する際にまず行う「基本的なプロジェクトの作成方法」についてご紹介します。...

(1)1行コメント

1行コメントはその名の通り1行だけコメント文を記述できるものです。

2つの半角スラッシュ(//)からその行の終わりまで」がコメントになります。

サンプルプログラム

 

実行結果

1行コメントの実行結果

このようにConsoleに表示されます。

定数のnameとageにコメントをつけましたが処理に影響はありません。

また、コメント化されたprint文は実行されません。

 

全プログラムコード

 

(2)複数行コメント

複数行コメントはその名の通り複数行のコメント文を記述できるものです。

/*から*/まで」がコメントになります。

「/」は半角スラッシュ、「*」は半角アスタリスクです。

なお、複数行コメントで1行だけコメントすることもできます。

サンプルプログラム

 

実行結果

複数行コメントの実行結果

このようにConsoleに表示されます。

 

全プログラムコード

 


最後に

今回は、プログラムをわかりやすくするコメントについてご紹介しました。

コメントはプログラミングをする上では欠かすことのできない重要な機能の一つです。

コメントの便利な点
  • 処理の説明ができる
  • プログラム内にメモ書きできる
  • プログラムコードを退避できる

 

ただし、コメント内容は正しく書かないとバグを作り込むきっかけになってしまうので注意しましょう。

初心者向け!Swift入門にオススメの参考書_サムネ
【2020年版】初心者向け!Swift入門にオススメの参考書『Swift初心者にオススメしたいSwiftプログラミング参考書』をご紹介します。...
無料体験あり!初心者におすすめの人気プログラミングスクール3選_サムネ
無料体験あり!初心者におすすめの人気プログラミングスクール3選『プログラミングを学ぶことができる人気のプログラミングスクール』についてご紹介します。...
ABOUT ME
コンジ
コンジ
自分のやりたいことでお金を稼げる生活に憧れて脱サラ。 アプリ開発やブログ運営をしながらのんびり暮らしています。