Motoko プログラミング入門: パラメータを渡してキャニスターを実行する

このページは、DFINITY の Motoko Language のチュートリアルを日本語で解説しています。

Pass text arguments

実際に使ったソースコードはGitHubからダウンロードできます。

はじめての方は先にこちらをご覧ください。

5 ステップではじめる Motoko プログラミング入門

実行環境

• dfx: 0.8.4
• macOS: 11.5.2
• npm version: 8.1.3
• 任意のターミナル
• 任意のテキストエディタ

ターミナルとテキストエディタは好きなソフトウェアを使えば大丈夫です。

はじめは Mac 標準のターミナルでよいと思います。テキストエディタは筆者は Visual Studio Code を使っています。

プロジェクトの作成

新しいプロジェクトを作ります。

dfx new location_hello
cd location_hello

コーディング

src/location_hello/main.mo

actor {
  public func location(city : Text) : async Text {
    return "Hello, " # city # "!";
  };
};

location()という関数を定義します。 location()は city という Text の引数を取り、Text を返します。

実行環境の起動

dfx start

ビルド＆デプロイ

dfx deploy

実行

dfx canister call location_hello location "San Francisco"

出力
("Hello, San Francisco!")

dfx canister call location_hello location Paris

出力
("Hello, Paris!")

dfx canister call location_hello location '("San Francisco and Paris")'

出力
("Hello, San Francisco and Paris!")

location_hello の location 関数に、複数の都市名を渡してみましょう。

dfx canister call location_hello location '("San Francisco","Paris","Rome")'

複数の都市名を渡しても、この location()関数は、city1 つしか受け取らないので、最初の引数だけが使われます。

出力
("Hello, San Francisco!")

実行環境の停止

終わったらローカル PC 上の実行環境を停止します。

dfx stop