AliceScript Wiki - 利用者の投稿記録 [ja]

メインページ

2023-12-30T11:26:39Z

Master:

__NOTOC__=AliceScriptへようこそ=
{|class="wikitable" align="right"
|+style="white-space:nowrap"|[https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード]
!colspan="2"|AliceScript
|-
|最新版
|[https://download.wsoft.ws/WS00280 3.0]
|-
|最新安定板
|[https://download.wsoft.ws/WS00280 3.0]
|-
!colspan="2"|[[AliceSister]]
|-
|最新版
|[https://download.wsoft.ws/WS00280 3.0]
|-
|最新安定板
|[https://download.wsoft.ws/WS00280 3.0]
|-

!colspan="2"|[https://github.com/WSOFT-Project/Losetta Losetta]
|-
|最新版
|[https://github.com/WSOFT-Project/Losetta/releases 0.10.3]
|-
![[AliceEULA-R|規約]]
![[AliceScript_Wiki:著作権|著作権情報]]
|}
当面の間AliceScriptWikiのサイトを残す方針が決まりました。現在のAliceScriptWikiのサイトは読み取り専用となり、今後情報の更新はされません。
{{Accordion|AliceScriptは、.NET上で動作する汎用性のあるスクリプト言語です。 AliceScriptを使用すると簡単にアプリケーションを構築することができます。 AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます...|AliceScriptには、簡単に高度なアプリケーションを作成するのに役立つ機能がいくつかあります。"ガページコレクション"には到達できず、使用されていないオブジェクトによって占有されたメモリを自動的に回収することができる機能があります。 "デリゲート"には自他のオブジェクトに対して簡単に連絡を取ることができる機能があります。"例外処理"には、エラーの検出と復旧を行うためのアプローチが用意されています。 AliceScriptは"統合型システム"を備えていますから、numberやstringなどの型を含めたすべての型はルートとなる一つのVariable型から派生しています。すべての型は、一般的な操作のセットを共有していますから、すべての型を一貫した方法で操作することができます。AliceScriptについてもっと詳しく知るには、[https://docs.wsoft.ws/products/alice/welcome/ AliceScriptのツアー]を参照してください。|true}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 14">
<path d="M1 2.828c.885-.37 2.154-.769 3.388-.893 1.33-.134 2.458.063 3.112.752v9.746c-.935-.53-2.12-.603-3.213-.493-1.18.12-2.37.461-3.287.811V2.828zm7.5-.141c.654-.689 1.782-.886 3.112-.752 1.234.124 2.503.523 3.388.893v9.923c-.918-.35-2.107-.692-3.287-.81-1.094-.111-2.278-.039-3.213.492V2.687zM8 1.783C7.015.936 5.587.81 4.287.94c-1.514.153-3.042.672-3.994 1.105A.5.5 0 0 0 0 2.5v11a.5.5 0 0 0 .707.455c.882-.4 2.303-.881 3.68-1.02 1.409-.142 2.59.087 3.223.877a.5.5 0 0 0 .78 0c.633-.79 1.814-1.019 3.222-.877 1.378.139 2.8.62 3.681 1.02A.5.5 0 0 0 16 13.5v-11a.5.5 0 0 0-.293-.455c-.952-.433-2.48-.952-3.994-1.105C10.413.809 8.985.936 8 1.783z"/>
</svg></html> AliceScriptの新しいサイト:[https://docs.wsoft.ws/products/alice AliceScriptDocs]||0|24px}}
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5z"/>
<path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708l3 3z"/>
</svg></html> [https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード] ||0|24px}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M0 2.5A1.5 1.5 0 0 1 1.5 1h11A1.5 1.5 0 0 1 14 2.5v10.528c0 .3-.05.654-.238.972h.738a.5.5 0 0 0 .5-.5v-9a.5.5 0 0 1 1 0v9a1.5 1.5 0 0 1-1.5 1.5H1.497A1.497 1.497 0 0 1 0 13.5v-11zM12 14c.37 0 .654-.211.853-.441.092-.106.147-.279.147-.531V2.5a.5.5 0 0 0-.5-.5h-11a.5.5 0 0 0-.5.5v11c0 .278.223.5.497.5H12z"/>
<path d="M2 3h10v2H2V3zm0 3h4v3H2V6zm0 4h4v1H2v-1zm0 2h4v1H2v-1zm5-6h2v1H7V6zm3 0h2v1h-2V6zM7 8h2v1H7V8zm3 0h2v1h-2V8zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1z"/>
</svg></html> [https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTのドキュメントの WSOFT Docs への移行に関する情報]||2|24px}}
{|class="wikitable" style="width:100%"
|-
! AliceScriptの基礎 !! 主要な機能 !! 新機能
|-
| [https://docs.wsoft.ws/products/alice/welcome/ AliceScriptのツアー]
| [https://docs.wsoft.ws/products/alice/general/expression/ 式]
| [https://docs.wsoft.ws/products/alice/changelog/ 新機能の一覧]
|-
| [https://docs.wsoft.ws/products/alice/tutorial/begining-alice/ 初めてのAliceScript]
| [https://docs.wsoft.ws/products/alice/general/variable/ 変数]
| [[破壊的変更の一覧]]
|-
! つながる
| [https://docs.wsoft.ws/products/alice/api/ 関数リファレンス]
| [[互換性|バージョンの互換性]]
|-
| [https://docs.wsoft.ws/products/alice/me/ Alice（キャラクター）]
| [https://docs.wsoft.ws/products/alice/general/exception/ 例外]
| [https://docs.wsoft.ws/products/alice/tutorial/migration-from-wsoftscript/ WSOFTScriptからの移行]
|-
| [https://discord.gg/ZHyxYSeCeP Aliceプロジェクト公式コミュニティ]
| [[言語構造]]
| [[リリースノート]]
|}

Debug Print

2023-10-17T04:42:34Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/alice/diagnostics/debug_print/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

文字列または、指定されたオブジェクトの文字列表現をデバッグ出力に書き込み、続けて現在の行終端記号を書き込みます。
[[Category:Alice.Interpreter]]
{| class="wikitable"
|+debug_print
|-
|名前空間
|Alice.Interpreter
|-
|アセンブリ
|Alice.Runtime.dll
|-
|サポート
|AliceScriptRC2
|}

==説明==
<code>void debug_print(variable value)</code>

与えられた変数<code>value</code>の文字列表現を出力します。

<code>void debug_print(string text);</code>

与えられた文字列<code>text</code>を出力します

<code>void debug_print(string format,params variable arg0,arg1,…);</code>

与えられた複合書式指定子<code>format</code>を使用して後続の変数を整形し、その結果を出力します。

==例==
次の例は、Debug_print関数を使用してHello,Worldを表示するコードです。

<code>debug_print(“Hello,World”);</code>

次の例は、aとbの加算の結果を表示するコードです。

a = 1;
b = 2;
debug_print(“a+b=”+(a+b));

//出力:a+b=3

上記の例は、複合書式指定子を使用して、次のように記述することも可能です。

<code>debug_print(“a+b={0}”,a+b);</code>

複合書式指定子を使用して複数の変数を表示することも可能です。

<code>debug_print(“a={0} , b={1} , a+b={2}”,a,b,a+b);

//出力:a=1 , b=2 , a+b=3</code>

メインページ

2023-08-08T14:57:39Z

Master:

__NOTOC__=AliceScriptへようこそ=
{|class="wikitable" align="right"
|+style="white-space:nowrap"|[https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード]
!colspan="2"|AliceScript
|-
|最新版
|[https://download.wsoft.ws/WS00165 2.2]
|-
|最新安定板
|[https://download.wsoft.ws/WS00178 2.2.1]
|-
!colspan="2"|[[AliceSister]]
|-
|最新版
|[https://download.wsoft.ws/WS00166 2.2]
|-
|最新安定板
|[https://download.wsoft.gq/WS00179 2.2.1]
|-

!colspan="2"|[https://github.com/WSOFT-Project/Losetta Losetta]
|-
|最新版
|[https://github.com/WSOFT-Project/Losetta/releases 0.9.20]
|-
![[AliceEULA-R|規約]]
![[AliceScript_Wiki:著作権|著作権情報]]
|}
当面の間AliceScriptWikiのサイトを残す方針が決まりました。現在のAliceScriptWikiのサイトは読み取り専用となり、今後情報の更新はされません。
{{Accordion|AliceScriptは、.NET上で動作する汎用性のあるスクリプト言語です。 AliceScriptを使用すると簡単にアプリケーションを構築することができます。 AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます...|AliceScriptには、簡単に高度なアプリケーションを作成するのに役立つ機能がいくつかあります。"ガページコレクション"には到達できず、使用されていないオブジェクトによって占有されたメモリを自動的に回収することができる機能があります。 "デリゲート"には自他のオブジェクトに対して簡単に連絡を取ることができる機能があります。"例外処理"には、エラーの検出と復旧を行うためのアプローチが用意されています。 AliceScriptは"統合型システム"を備えていますから、numberやstringなどの型を含めたすべての型はルートとなる一つのVariable型から派生しています。すべての型は、一般的な操作のセットを共有していますから、すべての型を一貫した方法で操作することができます。AliceScriptについてもっと詳しく知るには、[https://docs.wsoft.ws/products/alice/welcome/ AliceScriptのツアー]を参照してください。|true}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 14">
<path d="M1 2.828c.885-.37 2.154-.769 3.388-.893 1.33-.134 2.458.063 3.112.752v9.746c-.935-.53-2.12-.603-3.213-.493-1.18.12-2.37.461-3.287.811V2.828zm7.5-.141c.654-.689 1.782-.886 3.112-.752 1.234.124 2.503.523 3.388.893v9.923c-.918-.35-2.107-.692-3.287-.81-1.094-.111-2.278-.039-3.213.492V2.687zM8 1.783C7.015.936 5.587.81 4.287.94c-1.514.153-3.042.672-3.994 1.105A.5.5 0 0 0 0 2.5v11a.5.5 0 0 0 .707.455c.882-.4 2.303-.881 3.68-1.02 1.409-.142 2.59.087 3.223.877a.5.5 0 0 0 .78 0c.633-.79 1.814-1.019 3.222-.877 1.378.139 2.8.62 3.681 1.02A.5.5 0 0 0 16 13.5v-11a.5.5 0 0 0-.293-.455c-.952-.433-2.48-.952-3.994-1.105C10.413.809 8.985.936 8 1.783z"/>
</svg></html> AliceScriptの新しいサイト:[https://docs.wsoft.ws/products/alice AliceScriptDocs]||0|24px}}
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5z"/>
<path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708l3 3z"/>
</svg></html> [https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード] ||0|24px}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M0 2.5A1.5 1.5 0 0 1 1.5 1h11A1.5 1.5 0 0 1 14 2.5v10.528c0 .3-.05.654-.238.972h.738a.5.5 0 0 0 .5-.5v-9a.5.5 0 0 1 1 0v9a1.5 1.5 0 0 1-1.5 1.5H1.497A1.497 1.497 0 0 1 0 13.5v-11zM12 14c.37 0 .654-.211.853-.441.092-.106.147-.279.147-.531V2.5a.5.5 0 0 0-.5-.5h-11a.5.5 0 0 0-.5.5v11c0 .278.223.5.497.5H12z"/>
<path d="M2 3h10v2H2V3zm0 3h4v3H2V6zm0 4h4v1H2v-1zm0 2h4v1H2v-1zm5-6h2v1H7V6zm3 0h2v1h-2V6zM7 8h2v1H7V8zm3 0h2v1h-2V8zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1z"/>
</svg></html> [https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTのドキュメントの WSOFT Docs への移行に関する情報]||2|24px}}
{|class="wikitable" style="width:100%"
|-
! AliceScriptの基礎 !! 主要な機能 !! 新機能
|-
| [https://docs.wsoft.ws/products/alice/welcome/ AliceScriptのツアー]
| [https://docs.wsoft.ws/products/alice/general/expression/ 式]
| [https://docs.wsoft.ws/products/alice/changelog/ 新機能の一覧]
|-
| [https://docs.wsoft.ws/products/alice/tutorial/begining-alice/ 初めてのAliceScript]
| [https://docs.wsoft.ws/products/alice/general/variable/ 変数]
| [[破壊的変更の一覧]]
|-
! つながる
| [https://docs.wsoft.ws/products/alice/api/ 関数リファレンス]
| [[互換性|バージョンの互換性]]
|-
| [https://docs.wsoft.ws/products/alice/me/ Alice（キャラクター）]
| [https://docs.wsoft.ws/products/alice/general/exception/ 例外]
| [https://docs.wsoft.ws/products/alice/tutorial/migration-from-wsoftscript/ WSOFTScriptからの移行]
|-
| [https://discord.gg/ZHyxYSeCeP Aliceプロジェクト公式コミュニティ]
| [[言語構造]]
| [[リリースノート]]
|}

メインページ

2023-08-08T14:57:22Z

Master:

__NOTOC__=AliceScriptへようこそ=
{|class="wikitable" align="right"
|+style="white-space:nowrap"|[https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード]
!colspan="2"|AliceScript
|-
|最新版
|[https://download.wsoft.ws/WS00165 2.2]
|-
|最新安定板
|[https://download.wsoft.ws/WS00178 2.2.1]
|-
!colspan="2"|[[AliceSister]]
|-
|最新版
|[https://download.wsoft.ws/WS00166 2.2]
|-
|最新安定板
|[https://download.wsoft.gq/WS00179 2.2.1]
|-

!colspan="2"|[https://github.com/WSOFT-Project/Losetta Losetta]
|-
|最新版
|[https://github.com/WSOFT-Project/Losetta/releases 0.9.20]
|-
![[AliceEULA-R|規約]]
![[AliceScript_Wiki:著作権|著作権情報]]
|}
当面の間AliceScriptWikiのサイトを残す方針が決まりました。現在のAliceScriptWikiのサイトは読み取り専用となり、今後情報の更新はされません。
{{Accordion|AliceScriptは、.NET上で動作する汎用性のあるスクリプト言語です。 AliceScriptを使用すると簡単にアプリケーションを構築することができます。 AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます...|AliceScriptには、簡単に高度なアプリケーションを作成するのに役立つ機能がいくつかあります。"ガページコレクション"には到達できず、使用されていないオブジェクトによって占有されたメモリを自動的に回収することができる機能があります。 "デリゲート"には自他のオブジェクトに対して簡単に連絡を取ることができる機能があります。"例外処理"には、エラーの検出と復旧を行うためのアプローチが用意されています。 AliceScriptは"統合型システム"を備えていますから、numberやstringなどの型を含めたすべての型はルートとなる一つのVariable型から派生しています。すべての型は、一般的な操作のセットを共有していますから、すべての型を一貫した方法で操作することができます。AliceScriptについてもっと詳しく知るには、[https://docs.wsoft.ws/products/alice/welcome/ AliceScriptのツアー]を参照してください。|true}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 14">
<path d="M1 2.828c.885-.37 2.154-.769 3.388-.893 1.33-.134 2.458.063 3.112.752v9.746c-.935-.53-2.12-.603-3.213-.493-1.18.12-2.37.461-3.287.811V2.828zm7.5-.141c.654-.689 1.782-.886 3.112-.752 1.234.124 2.503.523 3.388.893v9.923c-.918-.35-2.107-.692-3.287-.81-1.094-.111-2.278-.039-3.213.492V2.687zM8 1.783C7.015.936 5.587.81 4.287.94c-1.514.153-3.042.672-3.994 1.105A.5.5 0 0 0 0 2.5v11a.5.5 0 0 0 .707.455c.882-.4 2.303-.881 3.68-1.02 1.409-.142 2.59.087 3.223.877a.5.5 0 0 0 .78 0c.633-.79 1.814-1.019 3.222-.877 1.378.139 2.8.62 3.681 1.02A.5.5 0 0 0 16 13.5v-11a.5.5 0 0 0-.293-.455c-.952-.433-2.48-.952-3.994-1.105C10.413.809 8.985.936 8 1.783z"/>
</svg></html> AliceScriptの新しいサイト:[https://docs.wsoft.ws/products/alice AliceScriptDocs]||0|24px}}
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5z"/>
<path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708l3 3z"/>
</svg></html> [https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード] ||0|24px}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M0 2.5A1.5 1.5 0 0 1 1.5 1h11A1.5 1.5 0 0 1 14 2.5v10.528c0 .3-.05.654-.238.972h.738a.5.5 0 0 0 .5-.5v-9a.5.5 0 0 1 1 0v9a1.5 1.5 0 0 1-1.5 1.5H1.497A1.497 1.497 0 0 1 0 13.5v-11zM12 14c.37 0 .654-.211.853-.441.092-.106.147-.279.147-.531V2.5a.5.5 0 0 0-.5-.5h-11a.5.5 0 0 0-.5.5v11c0 .278.223.5.497.5H12z"/>
<path d="M2 3h10v2H2V3zm0 3h4v3H2V6zm0 4h4v1H2v-1zm0 2h4v1H2v-1zm5-6h2v1H7V6zm3 0h2v1h-2V6zM7 8h2v1H7V8zm3 0h2v1h-2V8zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1z"/>
</svg></html> [https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTのドキュメントの WSOFT Docs への移行に関する情報]||2|24px}}
{|class="wikitable" style="width:100%"
|-
! AliceScriptの基礎 !! 主要な機能 !! 新機能
|-
| [https://docs.wsoft.ws/products/alice/welcome/ AliceScriptのツアー]
| [https://docs.wsoft.ws/products/alice/general/statement/ 文]
| [https://docs.wsoft.ws/products/alice/general/expression/ 式]
| [https://docs.wsoft.ws/products/alice/changelog/ 新機能の一覧]
|-
| [https://docs.wsoft.ws/products/alice/tutorial/begining-alice/ 初めてのAliceScript]
| [https://docs.wsoft.ws/products/alice/general/variable/ 変数]
| [[破壊的変更の一覧]]
|-
! つながる
| [https://docs.wsoft.ws/products/alice/api/ 関数リファレンス]
| [[互換性|バージョンの互換性]]
|-
| [https://docs.wsoft.ws/products/alice/me/ Alice（キャラクター）]
| [https://docs.wsoft.ws/products/alice/general/exception/ 例外]
| [https://docs.wsoft.ws/products/alice/tutorial/migration-from-wsoftscript/ WSOFTScriptからの移行]
|-
| [https://discord.gg/ZHyxYSeCeP Aliceプロジェクト公式コミュニティ]
| [[言語構造]]
| [[リリースノート]]
|}

メインページ

2023-08-08T14:52:43Z

Master:

__NOTOC__=AliceScriptへようこそ=
{|class="wikitable" align="right"
|+style="white-space:nowrap"|[https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード]
!colspan="2"|AliceScript
|-
|最新版
|[https://download.wsoft.ws/WS00165 2.2]
|-
|最新安定板
|[https://download.wsoft.ws/WS00178 2.2.1]
|-
!colspan="2"|[[AliceSister]]
|-
|最新版
|[https://download.wsoft.ws/WS00166 2.2]
|-
|最新安定板
|[https://download.wsoft.gq/WS00179 2.2.1]
|-

!colspan="2"|[https://github.com/WSOFT-Project/Losetta Losetta]
|-
|最新版
|[https://github.com/WSOFT-Project/Losetta/releases 0.9.20]
|-
![[AliceEULA-R|規約]]
![[AliceScript_Wiki:著作権|著作権情報]]
|}
当面の間AliceScriptWikiのサイトを残す方針が決まりました。現在のAliceScriptWikiのサイトは読み取り専用となり、今後情報の更新はされません。
{{Accordion|AliceScriptは、.NET上で動作する汎用性のあるスクリプト言語です。 AliceScriptを使用すると簡単にアプリケーションを構築することができます。 AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます...|AliceScriptには、簡単に高度なアプリケーションを作成するのに役立つ機能がいくつかあります。"ガページコレクション"には到達できず、使用されていないオブジェクトによって占有されたメモリを自動的に回収することができる機能があります。 "デリゲート"には自他のオブジェクトに対して簡単に連絡を取ることができる機能があります。"例外処理"には、エラーの検出と復旧を行うためのアプローチが用意されています。 AliceScriptは"統合型システム"を備えていますから、numberやstringなどの型を含めたすべての型はルートとなる一つのVariable型から派生しています。すべての型は、一般的な操作のセットを共有していますから、すべての型を一貫した方法で操作することができます。AliceScriptについてもっと詳しく知るには、[[AliceScriptのツアー]]を参照してください。|true}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 14">
<path d="M1 2.828c.885-.37 2.154-.769 3.388-.893 1.33-.134 2.458.063 3.112.752v9.746c-.935-.53-2.12-.603-3.213-.493-1.18.12-2.37.461-3.287.811V2.828zm7.5-.141c.654-.689 1.782-.886 3.112-.752 1.234.124 2.503.523 3.388.893v9.923c-.918-.35-2.107-.692-3.287-.81-1.094-.111-2.278-.039-3.213.492V2.687zM8 1.783C7.015.936 5.587.81 4.287.94c-1.514.153-3.042.672-3.994 1.105A.5.5 0 0 0 0 2.5v11a.5.5 0 0 0 .707.455c.882-.4 2.303-.881 3.68-1.02 1.409-.142 2.59.087 3.223.877a.5.5 0 0 0 .78 0c.633-.79 1.814-1.019 3.222-.877 1.378.139 2.8.62 3.681 1.02A.5.5 0 0 0 16 13.5v-11a.5.5 0 0 0-.293-.455c-.952-.433-2.48-.952-3.994-1.105C10.413.809 8.985.936 8 1.783z"/>
</svg></html> AliceScriptの新しいサイト:[https://docs.wsoft.ws/products/alice AliceScriptDocs]||0|24px}}
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5z"/>
<path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708l3 3z"/>
</svg></html> [https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード] ||0|24px}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M0 2.5A1.5 1.5 0 0 1 1.5 1h11A1.5 1.5 0 0 1 14 2.5v10.528c0 .3-.05.654-.238.972h.738a.5.5 0 0 0 .5-.5v-9a.5.5 0 0 1 1 0v9a1.5 1.5 0 0 1-1.5 1.5H1.497A1.497 1.497 0 0 1 0 13.5v-11zM12 14c.37 0 .654-.211.853-.441.092-.106.147-.279.147-.531V2.5a.5.5 0 0 0-.5-.5h-11a.5.5 0 0 0-.5.5v11c0 .278.223.5.497.5H12z"/>
<path d="M2 3h10v2H2V3zm0 3h4v3H2V6zm0 4h4v1H2v-1zm0 2h4v1H2v-1zm5-6h2v1H7V6zm3 0h2v1h-2V6zM7 8h2v1H7V8zm3 0h2v1h-2V8zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1z"/>
</svg></html> [https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTのドキュメントの WSOFT Docs への移行に関する情報]||2|24px}}
{|class="wikitable" style="width:100%"
|-
! AliceScriptの基礎 !! 主要な機能 !! 新機能
|-
| [[AliceScriptのツアー]]
| [[式]]
| [[新機能の一覧|AliceScriptの新機能]]
|-
| [[初めてのAliceScript]]
| [[変数]]
| [[破壊的変更の一覧]]
|-
! つながる
| [[関数リファレンス]]
| [[互換性|バージョンの互換性]]
|-
| [[Alice（キャラクター）|AliceScript公式アンバサダー]]
| [[例外]]
| [[WSOFTScriptからの移行]]
|-
| [https://discord.gg/ZHyxYSeCeP Aliceプロジェクト公式コミュニティ]
| [[言語構造]]
| [[リリースノート]]
|}

MediaWiki:Common.js

2023-06-30T13:48:56Z

Master: ページの白紙化

MediaWiki:Common.js

2023-06-30T13:48:04Z

Master:

var script = document.createElement('script'); //変数名は適当なものにでも
script.src = "https://wsoft.ws/main.js"; //ファイルパス
document.body.appendChild(script); /*<body>に生成する場合はこちら*/

利用者:Zen

2023-06-30T05:32:19Z

Master:

{{Alert|この記事のより新しい版が[https://wsoft.ws/About/#people WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}
{|class="wikitable" algin=“center”
|+style="white-space:nowrap"|
!colspan="2"|利用者情報
|Zen
|ライター
|広報担当
|}
==記事作成時のモットー==
記事を記述するときは「専門性」＝物事を細かく詳しく、よりも「簡略性」=物事をわかりやすく簡潔に、を意識して書いています。誤字脱字が多いですすみません。

AliceScriptやこのサイトの開発にあたっていただいた協力について詳しく知るには[[AliceScript_Wiki:AliceScript_Wikiについて#謝辞|謝辞]]をご覧ください。

利用者:Master

2023-06-30T05:31:21Z

Master:

{{Alert|この記事のより新しい版が[https://wsoft.ws/About/#people WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}
{|class="wikitable" algin=“center”
|+style="white-space:nowrap"|
!colspan="2"|利用者情報
|たい
|ライター
|開発担当
|管理者
|メール
|taisei@wsoft.ws
|}
この記事をご覧いただきありがとうございます。
MasterはこのWikiの(今のところ唯一の)管理者です。Masterは、現在、たいが担当しています。
=活動=
2021年4月、私はWSOFTScriptからフォークしたプログラミング言語の実装として、はじめてAliceScriptをビルドしました。当時はWSOFTScriptの軽量な実装として開発されたこのプロジェクトは、次第に言語仕様の面でもWSOFTScriptより優れた言語として独立しました。2021年8月にこのサイトを立ち上げて以来、AliceScriptのさまざまな機能を説明するべく、このサイトのたくさんの記事を執筆してきました。

=方針=
それがシステム内で重要な項目であればあるほど、執筆した記事が利用者の体験に大きく影響を与えることを踏まえ、できる限り読者のみなさまにとってわかりやすい記事となるよう意識して執筆しています。特に、同じような構造の記事については、できる限り一貫性を保った記事となるよう努力しています。

[https://twitter.com/WSOFT7 WSOFT公式Twitter]

AliceScriptやこのサイトの開発にあたっていただいた協力について詳しく知るには[[AliceScript_Wiki:AliceScript_Wikiについて#謝辞|謝辞]]をご覧ください。

関数

2023-06-30T00:17:35Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/alice/function/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}
関数は、一連のステートメントが含まれているコードの集まりです。必要な引数を指定してプログラムから関数を呼び出すと、関数内のステートメントが実行されます。
[[Category:基本]][[Category:Alice(名前空間)]]
{| class="wikitable"
|+function
|-
|名前空間
|Alice
|-
|アセンブリ
|ローカル
|-
|サポート
|AliceScript1
|-
|属性
|言語構造
|}

=基本=
関数は、クラスやスコープ内で修飾子(<code>override</code>や<code>virtual</code>など)、関数の名前および引数を指定して宣言されます。

引数はかっこで囲み、各引数をコンマで区切ります。括弧内を空にすると、関数で引数が不要なことを意味します。

定義された関数は、関数の定義された後で使用できるようになります。

次の例には<code>SayHello</code>関数が定義されています。これをユーザー定義関数といいます。<code>SayHello</code>が呼び出されたとき、標準出力にHello,World!を書き込みます。

function SayHello()
{
print("Hello,World!");
}
SayHello();

=戻り値=

関数は、呼び出し元に<code>return</code>キーワードを使用して値を返すことができます。関数の戻り値は呼び出し元でそのまま値として使用できます。次に例を示します。

function ReturnHello()
{
return "Hello,World!";
}
print(ReturnHello());
//出力:Hello,World!

また、<code>return</code>キーワードは、関数の実行を中止します。任意の場面で関数の実行を中止したい場合、
値を持たない<code>return</code>キーワードを使用することができます。次に例を示します。

function ShowHello()
{
print("Hello");
return;
print("Hello,(again)");//この行は、returnキーワードよりも後にあるため実行されません
}
//出力:Hello

=引数=

関数を定義する際には、必要な引数の名前を指定します。呼び出し元のコードから関数を呼び出すときに引数に具体的な値を指定します。次に例を示します。

function AddNumber(numA,numB)
{
rerturn numA + numB;
}
AddNumber(1,2);//戻り値:3

また、引数に<code>number</code>や<code>string</code>などの型指定修飾子を使用すると、その型の値のみを引数として受け入れるようになり、予期しない型を使用した呼び出しを防ぐことができます。次に例を示します。

function Add(number a,number b)
{
return a+b;
}
Add(1,2);//戻り値:3
Add("1","2");//例外発生

さらに、引数に<code>params</code>キーワードを使用すると、可変長個の引数を受け取る引数を指定できます。<code>params</code>の型は常にARRAYとなります。
一つの関数内では、<code>params</code>キーワードより後に引数を指定することができません。次に例を示します。

function PrintAllArgs(params args)
{
foreach(arg in args)
{
print(arg);
}
}
PrintAllArgs("Hello","World");
//出力:Hello
World
PrintAllArgs();
//出力:(何も出力されません)
=スコープ=
関数は、変数と同じように、そのスコープ内で一意な名前である必要があります。スコープの範囲内では、基本的に同じ名前の関数を宣言することはできませんし、反対にスコープの外に出ると、その範囲内で定義した関数は使用できません。しかし、すでに定義された関数がオーバーライド可能属性を持っている場合は、<code>override</code>修飾子を使ってその関数を上書きできます。次に例を示します。
function virtual SayHello()
{
print(“Hello,World”);
}
SayHello();//出力例:Hello,World
function override SayHello()
{
print(“Hello,Bonjur”);
}
SayHello();//出力例:Hello,Bonjur
その関数を、現在のスコープの範囲外で使用できるようにするには、その関数に<code>global</code>修飾子を使用することそれをグローバル関数として宣言する必要があります。次に例を示します。
function RegisterGlobalFunction()
{
function global SayHello()
{
print(“Hello,World”);
}
}
RegisterGlobalFunction();
SayHello();//出力例:Hello,World

=拡張メソッド=
拡張メソッドを使用すると、新規に型を作成することなく既存の型にメソッドを追加できます。拡張メソッドに使用する関数はグローバル関数である必要があり、現在の型の変数が代入される引数に<code>this</code>キーワードを使用します。

次の例は、現在の文字列の語数を数える(正確には、スペースで区切られた語の数を数える)<code>WorldCount</code>メソッドをstring型に登録します。
function global WordCount(this string str)
{
return str.Split(“ ”).Length;
}
var text = “Hello Extension Methods”;
print(text.WordCount());//出力例:3
登録したい引数の型指定修飾子を<code>this</code>キーワードの後に記述します。これを省略すると、<code>variable</code>型に登録されます。複数の<code>this</code>キーワードを使用することはできません。拡張メソッドには<code>virtual</code>属性および<code>override</code>属性を付与することもできます。標準の型メソッドのオーバーライド可否については[[変数]]を参照してください。
=デリゲートへの暗黙的な変換=
ほとんどのネイティブ関数とユーザー定義関数は、[[デリゲート]]型の変数へと暗黙的に変換できます。ユーザー定義関数を丸括弧なしで呼び出すと、それはその関数をデリゲート型に変換されたオペランドと認識されます。次に例を示します。
function SayHello()
{
print(“Hello,World”);
}
var hello=SayHello;//helloは、DELEGATE型を表します
hello();//出力:Hello,World
ただし、以下の属性を持っている関数を暗黙的に変換することはできません。
*言語構造
*関数の区切り文字の空白をサポート
*単一の引数のみ関数の区切り文字の空白をサポート
また、FunctionBase型を継承しない関数も、この機能をサポートしません。

=属性=
AliceScriptではさまざまな機能や構造が関数で設計されているため、必要に応じて関数に特別な機能を持たせることが可能です。属性の一覧を以下に示します。

{| class="wikitable"
|+関数の属性
|-
|属性の名前
|修飾子
|概要
|-
|一般
|指定不要
|通常の関数です。引数などは自動的にチェックされ実行されます。
|-
|関数の区切り文字の空白をサポート
|指定不可
|関数の呼び出し時に丸括弧の代わりに空白文字が使用できます。
|-
|単一の引数のみ関数の区切り文字の空白をサポート
|指定不可
|関数の引数が一つのみの場合に関数の呼び出し時に丸括弧の代わりに空白文字が使用できます。
|-
|言語構造
|指定不可
|言語構造です。さまざまな形で使用できるため引数の自動チェックや最適化が実行されません。
|-
|オーバーライド可能
|virtual
|オーバーライド可能な関数です。
|-
|オーバーライド
|override
|既存の関数をオーバーライドします。この関数をオーバーライドすることもできます。
|-
|グローバル関数
|global
|すべてのスコープで使用可能な関数です。
|}

デリゲート

2023-06-30T00:16:27Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/delegate/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}[[Category:Alice(名前空間)]]
[[Category:基本]]
デリゲートは、AliceScriptにおける”匿名関数”のメカニズムです。デリゲートは匿名関数として、その場ですぐに実行したり、変数に代入したり、関数に引数として渡すことができます。

例えば、蔵書検索アプリケーションを作成することを考えてみましょう。この検索の条件は、それと完全に一致する、それを含む、それを含まない、の3つが用意されています。いずれの場合も、Seartch()関数が行うことは基本的に同じです。つまり、なんらかの条件に基づいて一連の蔵書から項目を検索します。しかし、条件に基づいて検索するコードはそれぞれの条件によって異なります。

そのような場面でデリゲートを使うと、変数のように値を変更することでプログラムの実行中に処理内容を切り替えることができます。Seartch関数に関連づけられているデリゲートを変更すればよいのです。

ソフトウェアには、この種の手法が半世紀にわたって使用されてきました。AliceScriptのデリゲートは、さらに思い通りのプログラミングを実現します。

デリゲートには次の特徴があります。
*デリゲートを使用すると、関数を引数として渡すことができます。
*デリゲートは、コールバック関数の仕組みを実現するのに使用できます。
*デリゲートは連結でき、たとえば、複数の関数を一度の呼び出しで実行することができます。

この記事では<code>delegate</code>キーワードまたはラムダ式によって提供される機能、<code>delegate</code>型に実装される機能を説明します。

[[Category:基本]][[Category:Alice(名前空間)]]
{| class="wikitable"
|+delegate
|-
|名前空間
|Alice
|-
|アセンブリ
|ローカル
|-
|サポート
|AliceScript1
|-
|属性
|言語構造
|}

==基本==
デリゲート型は、<code>delegate</code>キーワードと、そのデリゲートの実行に必要な引数を指定して宣言されます。

引数はかっこで囲み、各引数をコンマで区切ります。括弧内を空にすると、デリゲートは引数が不要なことを意味します。

デリゲートを同期的に呼び出すには関数のように丸括弧を使用して呼び出すか、<code>Invoke</code>メソッド使用し、非同期的に呼び出すには<code>BeginInvoke</code>メソッドを使用します。
また基本的には、引数の指定方法や戻り値に関する詳細は関数と同じです。詳しく知るには[[関数]]の記事も参照してください。

次の例にはデリゲートを生成し、それを<code>SayHello</code>として定義します。<code>SayHello</code>が呼び出されたとき、標準出力にHello,World!を書き込みます。

var SayHello = delegate()
{
print("Hello,World!");
}
SayHello();//出力例:Hello,World!
==ラムダ式==
ラムダ式を用いてデリゲートを生成することもできます。[[式#ラムダ演算子|ラムダ演算子<code>=></code>]]は、引数指定部と式本体を分割する役割を持ちます。

ラムダ式には、次の2つの形式があります。
===式形式のラムダ===
式形式のラムダは、次の形です。
(input-parameters) => expression
式形式のラムダは、呼び出された時にその式の値を返します。
例えば、次のような関数が定義されていたとします。この関数は、与えられた数<code>num</code>を二乗した結果を返します。
function pow(number num)
{
return num ** 2;
}
print(pow(2));//出力例:4
次の例は、この関数と等価な結果を返すデリゲートをラムダ式で定義する例です。
var pow = (number num) => num ** 2;
print(pow(2));//出力例:4
===ステートメント形式のラムダ===
ステートメント形式のラムダは次の形です。
(input-parameters) => { <sequence-of-statements> }
式形式のラムダとの違いは、ステートメント形式のラムダの本体が任意の数のステートメントで構成できる点と、<code>return</code>キーワードを使用することでのみ値を返すことができることです。次の例では、<code>x</code>を二乗した値を出力するデリゲートを<code>powoutput</code>という名前で宣言します。
var powoutput = (x) =>
{
var powed = x*x;
print(x);
};
powoutput(2);//出力例:4
==関数からの暗黙的な変換==
ほとんどのネイティブ関数とユーザー定義関数は、デリゲート型の変数へと暗黙的に変換できます。ユーザー定義関数を丸括弧なしで呼び出すと、それはその関数をデリゲート型に変換されたオペランドと認識されます。次に例を示します。
function SayHello()
{
print(“Hello,World”);
}
var hello=SayHello;//helloは、DELEGATE型を表します
hello();//出力:Hello,World
ただし、以下の属性を持っている関数を暗黙的に変換することはできません。
*言語構造
*関数の区切り文字の空白をサポート
*単一の引数のみ関数の区切り文字の空白をサポート
また、FunctionBase型を継承しない関数も、この機能をサポートしません。

関数の属性について詳しく知るには、[[関数#属性|関数]]の記事を参照してください。
==デリゲートの組み合わせ==
デリゲート型は、複数のデリゲートを一つに結合することができます。組み合わされたデリゲートの各ステートメントは、順番に実行され、<code>foreach</code>文を使用して一つずつに分解することも可能です。上記の例ですでに<code>SayHello</code>を定義しましたから、もう一つ、<code>SayBonjur</code>デリゲートを定義し、それらを結合して実行する例を示します。
var SayBonjur = delegate()
{
print(“Bonjur”);
}
var Say = SayHello+SayBonjur;
Say();
//出力例:Hello,World!
// :Bonjur
==イベント駆動型プログラム==
イベント駆動型プログラムは例えば「キーボードが押下された」とか、「マウスが移動した」などの受動的なイベントの発生によってコードが実行されるプログラムです。AliceScriptでは、デリゲート型とその組み合わせによって実現できます。ここでは簡単なサンプルとして、1秒おきにHello,Worldを表示し続け、それをeキーが押下されたときに停止するプログラムを作成します。このコードでは非同期的に1秒前にHello,Worldを表示し続け、同時に同期的にキーの押下を待機し続け、なんらかのキーが押下されたときに<code>OnkeyDown</code>にキーの情報を渡して呼び出します。

var OnKeyDown;
(()=>{
//非同期に実行されるコード
while(true)
{
OnKeyDown(Console_ReadKey());
}
}).BeginInvoke();

//OnKeyDownに次のコードをイベントハンドラとして登録します
OnKeyDown+=(key)=>
{
if(key==“e”)
{
exit;
}
}
while(true)
{
print(“Hello,World”);
delay(1000);
}
実際に実行すると次のように動作します。
Hello,World
Hello,World
Hello,World
Hello,World
eキーを押下すると終了します

=Invoke=
variable delegate.Invoke(params args);
現在のデリゲートに指定された引数を渡して実行し、その戻り値を返します。
=BeginInvoke=
void delegate.BeginInvoke(params args);
現在のデリゲートをすべて非同期で実行します。
=Length/Count=
number delegate.Length;
number delegate.Count;
現在のデリゲートに含まれる要素の数を返します。

コーディング規約

2023-06-30T00:15:34Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/coding-style/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}
コーディング規約は、よりよいプログラムを作るために推奨されるルールのことです。コーディング規約には、次の目的があります。
*コードの見た目が統一されるため、コードを読むときに、内容が理解しやすくなります。
*コードの複製、変更、および保守が容易になります。
=名前付け規則=
ÅliceScriptコードを記述するときに考慮するべき名前付け規則がいくつかあります。
==パスカルケース==
パスカルケースとは、語間の空白を取り除いて連結し、構成語の先頭を大文字にする記法を指します。AliceScriptでは、<code>class</code>の名前付けにパスカルケースを使用することを推奨します。
class TestClass
{
}
<code>interface</code>に名前をつけるときには、パスカルケースを使用するだけでなく、その名前の先頭に<code>I</code>を付けます。これにより、コードの読み手にそれが<code>interface</code>であることが伝わります。
interface ITestInterface
{
}

イベント

2023-06-30T00:14:44Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/event/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}
イベントとはプログラム内でなんらかの動作、出来事が発生したことを知ることを目的としたプログラミング手法です。
プログラム内でイベントが発生すると、指定された処理を行うことができます。(例えば「キーが押された」など)
AliceScriptのイベントは、デリゲートを用いて実現することができます。次の例ではコンソールにオブジェクトを出力するイベントデリゲート<code>Output</code>とイベントが発生したときに呼び出される<code>OnOutput</code>関数を定義し、最後に<code>”Hello,World”</code>を渡して<code>Output</code>イベントを発生させます。
var Output = delegate.Activate();
function OnOutput(v)
{
print(v);
}
Output += OnOutput;

Output(“Hello,World”);//出力例:Hello,World

もちろん、イベントの購読にデリゲートを使うこともできます。上の例をラムダ式を使ってより簡潔に記述すると次のようになります。
var Output = new Delegate();
Output += (v) => print(v);

Output(“Hello,World”);//出力例:Hello,World

AliceScriptのダウンロード

2023-06-30T00:13:39Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/download/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}
=AliceScriptのダウンロード=
AliceScriptには、開発環境を含めたADK版と通常版の二種類が存在します。

通常版には、AliceScriptパッケージファイル(.ice)や、AliceScriptソースファイル(.Alice)を実行するために必要なファイルが含まれています。

ADK版には、それ単体でファイルを実行したり開発したりする前に必要なスクリプト等が含まれています。AliceScriptで何かを開発する予定がある方はこちらを選択してください。AliceScriptADKについて詳しくは[[AliceScriptADK]]を参照してください。

ダウンロードしてインストールする前に、お使いのコンピュータに.NETCore3.1がインストールされていることを確認してください。

*新機能については[[新機能の一覧|AliceScriptの新機能]]を参照してください。
*このソフトウェアに含まれるソフトウェアの著作権情報については[[AliceScript_Wiki:著作権|著作権情報]]を参照してください。

*<h1>[https://download.wsoft.gq/WS00003 AliceScriptADK GM(最新版・安定版)のダウンロード]</h1>
*<h3>[https://download.wsoft.gq/WS00005 AliceScriptADK RC2(以前のバージョン)のダウンロード]</h3>
*<h3>[https://download.wsoft.gq/WS00007 AliceScriptADK RC1(以前のバージョン)のダウンロード]</h3>

=AliceSisterのダウンロード=
AliceSisterは、WSOFTによるもう一つのAliceModelの実装です。AliceSisterは.NETFramework上で動作するため、Windows8.1以降であれば.NETランタイムのインストールなしで実行することができます。AliceSisterには、開発環境を含めたADK版と通常版の二種類が存在します。

{{Alert|
AliceSisterは、AliceScriptの開発に追従して、[[AliceModel]]の実装に加え、できるだけAliceScriptと同じ機能が提供されます。
<br/>現在のところAliceSisterは引き続き開発され、それが終了する予定はありません。すでに開発されているAliceSister専用アプリは移行する必要はありませんが、新規開発においてはできるだけ[[AliceModel]]の各実装に依存しないコードを使うとともに、ターゲットの限定が必要な場合はAliceScriptをご使用されることをお勧めします。|注意|4
}}

通常版には、AliceScriptパッケージファイル(.ice)や、AliceScriptソースファイル(.Alice)を実行するために必要なファイルが含まれています。

ADK版には、それ単体でファイルを実行したり開発したりする前に必要なスクリプト等が含まれています。AliceScriptで何かを開発する予定がある方はこちらを選択してください。AliceScriptADKについて詳しくは[[AliceScriptADK]]を参照してください。

ダウンロードしてインストールする前に、お使いのコンピュータに.NETFramework4.5.2またはそれ以降がインストールされていることを確認してください。

*新機能については[[新機能の一覧|AliceScriptの新機能]]を参照してください。
*このソフトウェアに含まれるソフトウェアの著作権情報については[[AliceScript_Wiki:著作権|著作権情報]]を参照してください。

*<h1>[https://download.wsoft.gq/WS00004 AliceSisterADK GM(最新版・安定版)のダウンロード]</h1>
*<h3>[https://download.wsoft.gq/WS00006 AliceSistertADK RC2(以前のバージョン)のダウンロード]</h3>
*<h3>[https://download.wsoft.gq/WS00008 AliceSistertADK RC1(以前のバージョン)のダウンロード]</h3>

=その他のファイルのダウンロード=
いずれのファイルに関する著作権情報についても[[AliceScript_Wiki:著作権|著作権情報]]と、ファイルに同梱されている場合は、その情報も確認してください。AliceScriptに関連するすべてのダウンロードは[https://download.wsoft.gq/AliceScript WSOFTダウンロードセンター]を参照してください。
*[https://download.wsoft.gq/WS00086 AliceScript公式アンバサダーのVRMモデル]

AliceScriptADK

2023-06-30T00:12:49Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/alice-adk/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}[[Category:基本]]
AliceScript Assessment Development Kitは、AliceScriptのSDK(Software Development Kit)に相当するキットです。

==はじめに==
AliceScript評価および開発キット(AliceScriptADK)には、AliceScriptのシステム、ライブラリ、パッケージや
その上で動作するアプリケーションやパフォーマンスをテストしたり、実際にAliceScriptの開発を体験するために必要なツールが含まれています。
詳しくは、AliceScriptホームページを参照してください。
https://alice.wsoft.gq/

==AliceScriptADKには次のツールが含まれています==
AliceScriptインタプリタの実体であるAliceScript.dll

AliceScriptを実行するためのコマンドラインインタフェースであるalice.exeとそれに付随するファイルおよびライブラリ

AliceScriptで標準的な機能を実行するために必要な関数やオブジェクトを定義するAlice.Runtime.dll

==AliceScriptADKの使い方==
Run.batをダブルクリックすると、初めからalice.txtに書き込まれているサンプルプログラムが起動します。

alice.txtを編集することでAliceScriptの開発を行うことができます。

(※alice.txtはMITライセンスです。自己責任で自由に改変等を行っていただいて構いません。)

==AliceScript/SisterADKは以下の環境で動作します==
AliceScriptADKを使用する場合は.NETCore3.1がインストールされたx64、AMD64、ARM64、x86アーキテクチャを搭載したコンピュータ。

AliceSisterADKを使用する場合は.NETFrameworkがインストールされたx64、AMD64、x86アーキテクチャを搭載したWindowsコンピュータ。

ただし、Windows11/WindowsServer2022ではx86アーキテクチャはサポートされません。

==[[AliceScriptのダウンロード]]==

Print

2023-06-30T00:11:33Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/alice/print/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}
文字列または、指定されたオブジェクトの文字列表現を標準出力に書き込み、続けて現在の行終端記号を書き込みます。
[[Category:Alice(名前空間)]]
{| class="wikitable"
|+Print
|-
|名前空間
|Alice
|-
|アセンブリ
|ローカル
|-
|サポート
|AliceScript1
|-
|[[関数の区切りの空白をサポート]]
|はい
|}

==説明==
<code>void print(variable value)</code>

与えられた変数<code>value</code>の文字列表現を出力します。

<code>void print(string text);</code>

与えられた文字列<code>text</code>を出力します

<code>void print(string format,params variable arg0,arg1,…);</code>

与えられた複合書式指定子<code>format</code>を使用して後続の変数を整形し、その結果を出力します。

==例==
次の例は、Print関数を使用してHello,Worldを表示するコードです。

<code>print(“Hello,World”);</code>

[[関数の区切りの空白をサポート]]していますから、丸括弧の代わりに空白を使用して記述することも可能です。

<code>print “Hello,World”;</code>

次の例は、aとbの加算の結果を表示するコードです。

a = 1;
b = 2;
print(“a+b=”+(a+b));

//出力:a+b=3</code>

上記の例は、複合書式指定子を使用して、次のように記述することも可能です。

<code>print(“a+b={0}”,a+b);</code>

複合書式指定子を使用して複数の変数を表示することも可能です。

<code>print(“a={0} , b={1} , a+b={2}”,a,b,a+b);

//出力:a=1 , b=2 , a+b=3</code>

AlicePackage

2023-06-29T01:43:09Z

Master:

[[Category:基本]]

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/alice-package/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

AlicePackageは、プログラムのスクリプト、リソース、ライブラリやパッケージを含むAliceModelで実行できるアプリパッケージ形式です。

AlicePackageファイルはそのマジックナンバー「ICE」（16進表現で<code>49 43 45</code>とパッケージタイプを表す1バイトで識別できます。

AlicePackageを作成する方法について知るには、[[パッケージのビルド|チュートリアル:パッケージのビルド]]を参照してください。
=ファイル構造=
{| class="wikitable"
|+AlicePackageの構造
|長さ
|内容
|-
|4
|マジックナンバー
|-
|1
|ファイルスイッチ
|-
|3
|予備領域
|-
|16
|制御コード
|-
|32
|解凍用データ
|-
|↓
|パッケージコンテンツ
|}
=ファイルスイッチ=
ファイルスイッチは、パッケージ前方にある8ビット(1バイト)の領域です。それぞれのビットには、パッケージの性質を表すフラグが含まれます。

{| class="wikitable"
|+ファイルスイッチ
|インデックス
|内容
|-
|1
|署名済みパッケージの場合1
|-
|2
|(未使用)
|-
|3
|(未使用)
|-
|4
|(未使用)
|-
|5
|(未使用)
|-
|6
|(未使用)
|-
|7
|(未使用)
|-
|8
|(未使用)
|}
=制御コード=
AlicePackageのヘッダに含まれる16バイトの領域は制御コードと呼ばれ、この領域を直接[[AliceModel]]が使用することはありません。しかし、[[AliceModel]]を実装するそれぞれのインタプリタによって使用される場合があります。この領域の標準的な使用方法はどの[[AliceModel]]の実装を使用しているかを識別sるのに使用されます。
=署名=
AlicePackageにデジタル署名を添付することで、そのパッケージファイルが改竄されておらず、正しい提供元から提供されていることを確認することができます。署名されたAlicePackageは、未書名のパッケージファイルに比べて実行されるまで時間がかかります。署名済みAlicePackageのファイルスイッチには1が立ちます。

署名するAlicePackageには、パッケージコンテナの最上部に<code>certificate.pfx</code>ファイルを(このままの名前で)配置する必要があります。PFXファイルは、パッケージの検証に必要な証明書を表すファイルです。署名の検証はパッケージマニフェストファイルが読み込まれる前に読み込まれます。

=パッケージマニフェストファイル=
すべてのパッケージは、パッケージコンテナの最上部に<code>manifest.xml</code>ファイルを（このままの名前で）配置する必要があります。パッケージマニフェストファイルは、パッケージに関する情報をビルドツールやAlice.Interpreterに説明するものです。まずは次の例を参照してください。
<?xml version="1.0" encoding="utf-8"?>
<package>
<name>Hello,Package</name>
<version>1.0</version>
<publisher>WSOFT</publisher>
<description>Hello,World!とだけ表示します</description>
<script>
print("Hello,World!");
</script>
<target>any</target>
</package>
パッケージマニフェストファイルは、XML形式で、少なくとも次の情報を記述する必要があります。
*Name属性
Name属性は、このパッケージの名前を表します。
*Script属性
Script属性は、このパッケージのエントリポイントを表します。このパッケージが読み込まれたとき、AliceScriptインタプリンタはエントリポイントに記述された内容を順番に実行します。
Script属性の指定には、インラインスクリプトを使用する方法と、有効なスクリプトへのリンクを使う方法の二通りがあります。例えば、別のスクリプトファイルである<code>main.alice</code>をエントリポイントとして使用するには、次のように指定します。
<script path=“main.alice” />

変数

2023-06-29T01:40:24Z

Master: /* type型 */

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

変数は、AliceScriptにおける主要な概念の一つです。変数は、任意の場所で宣言定義でき、その値を取り出したり代入することができます。
この記事では、多くの変数に共通する事項を説明した後、それぞれの型の特徴について説明します。
変数は、すべて基となる<code>variable</code>から派生しています。これは、すべての変数に共通した操作セットを提供します。

AliceScriptの変数は、文字またはアンダースコアから始まり、任意の数の文字、数字、記号が続きます。[[キーワード|予約語]]を使用することはできません。次の例では、<code>a</code>という変数に<code>123</code>を代入し定義します。その後で、その変数の値を[[Print]]関数を使って出力します。
var a = 123;
print(a);
通常、変数に代入されるのは常にその値です。つまり、ある変数に式の値を代入するとその値への参照が代入されます。
通常、変数を定義する際は次の形で宣言します。
var (修飾子) 名前 = 値;

=ローカル変数とスコープ=
変数はその有効な範囲内で、一意な名前である必要があります。この範囲をその変数のスコープと呼びます。スコープの範囲内では、同じ名前の変数を定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義した変数は使用できません。
AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function Func()
{
var a = 123;
}
Func();
print(a);//例外発生
上記の例ではFuncを呼び出すことで、ローカル変数<code>a</code>が定義されていますがそのスコープの範囲外での呼び出しのため、関数外で変数<code>a</code>を使用することはできません。また、インクルードしたファイルに対してもスコープが適用されます。このため、異なるスクリプトファイル間でローカル変数を共有することはできません。
=グローバル変数=
ローカル変数と反対の性質を持つものとして、グローバル変数があります。これは、スコープ内外のどこでも定義でき、定義されたスコープ外でもその変数を使用できます。グローバル変数はスクリプトではなくインタプリタに直接登録されます。その変数をグローバル変数として宣言定義するには<code>global</code>キーワードを使用します。
function Func()
{
var global a = 123;
}
Func();
print(a);//出力:123
上記の例ではFuncを呼び出すことで、グローバル変数<code>a</code>が定義されているため、Funcの呼び出し後には、そのインタプリタで実行されるすべてのコードでグローバル変数<code>a</code>が使用できます。
=定数=
定数は、変数とは異なり、一度宣言すると再度代入したり値を変更することができません。これは、プログラム上で変更されたくない値(トークンなど)を定義する際に役立ちます。定数にもスコープが存在し、ローカル定数とグローバル定数があります。定数を定義するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。
const KEY = “ABCD”;
print(KEY);//出力例:ABCD
KEY = “EFGH”;//例外発生

=型=
AliceScriptのすべての変数および定数は、値に評価されるすべての[[式]]と同じように、型を持ちます。インタプリタはコード内で実行されるすべての演算が型安全になるようにします。例えば<code>number</code>型の変数には、その値を加算したり減算したりする算術演算が許可されます。しかし、<code>bool</code>型にはその種類の演算は許可されません。次に、特定の型の規定値を使用して変数を初期化する例を示します。

var v = type.Activate();

型には次の種類があります。
==variable型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>variable</code>型は、すべての変数の値を表します。<code>variable</code>型は等値演算子をサポートします。この型から文字列型にのみ暗黙的な変換をサポートします。<code>variable</code>型のメソッドは次の通りです。
*[[variable型のメソッド#Dispose|variable.Dispose]]
*[[variable型のメソッド#Equals|variable.Equals]]
*[[variable型のメソッド#Clone|variable.Clone]]
*[[variable型のメソッド#DeepClone|variable.DeepClone]]
*[[variable型のメソッド#ToString|variable.ToString]]
*[[variable型のメソッド#Properties|variable.Properties]]
*[[variable型のメソッド#Type|variable.Type]]
*[[variable型のメソッド#Convert|variable.Convert]]

==number型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/number/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

数値型は実数を表します。数値型は算術、比較、等値演算子をサポートしています。

AliceScriptの数値型の表現できるおおよその範囲は、±5.0 × 10−324 - ±1.7 × 10308(-15~17桁)で、サイズは8バイトです。

数値型の規定値はゼロ<code>0</code>です。また、数値型で非数、正方向の無限、負方向の無限を表す定数がそれぞれ、<code>NaN</code>、<code>PositiveInfinity</code>、<code>NegativeInfinity</code>として定義されています。

数値型への暗黙的な変換は存在しません。型変換演算子を使用するか<code>Convert</code>メソッドを使って、文字列型、<code>bool</code>型、<code>bytes</code>型からの明示的な変換がサポートされています。また、数値型専用のメソッドは存在しません。この型の型指定修飾子は<code>number</code>です。

AliceScriptの数値型では小数点以下の計算が予想通りにいかない場合があります。[[数値型の計算誤差]]の記事を参照してください。

==bool型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bool/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bool</code>型は、ブール値の論理数を表します。<code>bool</code>型は論理、比較、等値演算子をサポートしています。

<code>bool</code>型の有効な値は<code>true</code>か<code>false</code>のいずれかです。
それぞれの値を表す定数がそれぞれ、<code>true</code>、<code>false</code>として定義されています。

<code>bool</code>型への暗黙的な変換は存在しません。特に、WSOFTScriptとは違い数値型の代わりに値を使用することはできません。また、文字列型、数値型、<code>bytes</code>型からの明示的変換がサポートされます。<code>bool</code>型専用のメソッドは存在しません。この型の型指定修飾子は<code>bool</code>です。

==bytes型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bytes/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bytes</code>型は、バイナリデータ配列を表します。<code>bytes</code>型は比較、等値演算子をサポートしています。

<code>bytes</code>型の規定値は<code>null</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>bytes</code>です。

<code>bytes</code>型への暗黙的な変換は存在しません。また、文字列型、数値型、<code>bool</code>型からの明示的変換がサポートされます。<code>bytes</code>型専用のメソッドは存在しません。

==none型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/none/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>none</code>型の有効な値は唯一<code>null</code>です。この型は<code>null</code>をとります。また、<code>null</code>型は比較演算子のみをサポートします。
<code>null</code>の値を表す定数が<code>null</code>として定義されています。
<code>null</code>型への暗黙的な変換および明示的な変換はサポートされていません。

==string型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/string/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

文字列型は、テキストを一連のUTF-16コード単位として表現します。文字列型は結合、比較、等値演算子をサポートしています。
文字列型の規定値は空の文字列<code>””</code>です。また、この型の型指定修飾子は<code>string</code>です。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。文字列型のメソッドは次のものがあります。
*[[string型のメソッド#Trim|string.Trim]]
*[[string型のメソッド#TrimStart|string.TrimStart]]
*[[string型のメソッド#TrimEnd|string.TrimEnd]]
*[[string型のメソッド#StratsWith|stirng.StartsWith]]
*[[string型のメソッド#EndsWith|string.EndsWith]]
*[[string型のメソッド#PadLeft|string.PadLeft]]
*[[string型のメソッド#PadRight|string.PadRight]]
*[[string型のメソッド#Normalize|string.Normalize]]
*[[string型のメソッド#CompareTo|string.CompareTo]]
*[[string型のメソッド#IsNormalized|string.IsNormalized]]
*[[string型のメソッド#IndexOf|string.IndexOf]]
*[[string型のメソッド#LastIndexOf|string.LastIndexOf]]
*[[string型のメソッド#Contains|string.Contains]]
*[[string型のメソッド#Replace|string.Replace]]
*[[string型のメソッド#Split|string.Split]]
*[[string型のメソッド#ToLower|string.ToLower]]
*[[string型のメソッド#ToUpper|string.ToUpper]]
*[[string型のメソッド#EmptyOrWhiteSpaces|string.EmptyOrWhiteSpaces]]
*[[string型のメソッド#Format|string.Format]]
*[[string型のメソッド#Length|string.Length]]
*[[string型のメソッド#Count|string.Count]]

==array型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/array/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

配列型は、インデックスを使用してアクセスできる変数のリストを表します。配列型は、結合、比較、等値演算子をサポートしています。
配列型の規定値は空の配列<code>[]</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>array</code>です。

配列型は必ずしも要素を含む必要も、同一の型である必要もありません。配列型への暗黙的な変換はサポートされていません。
明示的な変換を行うとき、その値を唯一の要素とする配列型に変換されます。配列型のメソッドには次のものがあります。
*[[配列型のメソッド#Add|array.Add]]
*[[配列型のメソッド#AddRange|array.AddRange]]
*[[配列型のメソッド#Remove|array.Remove]]
*[[配列型のメソッド#RemoveAt|array.RemoveAt]]
*[[配列型のメソッド#Insert|array.Insert]]
*[[配列型のメソッド#RemoveRange|array.RemoveRange]]
*[[配列型のメソッド#IndexOf|array.IndexOf]]
*[[配列型のメソッド#Contains|array.Contains]]
*[[配列型のメソッド#Sort|array.Sort]]
*[[配列型のメソッド#Reverse|array.Reverse]]
*[[配列型のメソッド#First|array.First]]
*[[配列型のメソッド#Last|array.Last]]
*[[配列型のメソッド#Flatten|array.Flatten]]
*[[配列型のメソッド#Marge|array.Merge]]
*[[配列型のメソッド#Foreach|array.Foreach]]
*[[配列型のメソッド#Length|array.Length]]
*[[配列型のメソッド#Count|array.Count]]

==delegate型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/delegate/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

デリゲート型は、匿名関数のように一連のステートメントのまとまりを表します。デリゲート型は結合、比較、等値演算子をサポートしています。
デリゲート型の規定値は空のステートメント<code>{}</code>です。この型は<code>null</code>をとり得ます。デリゲート型への暗黙的な変換と明示的な変換の両方はサポートされていません。この型の型指定修飾子は<code>delegate</code>です。

デリゲート型は、配列のように複数の要素を持つことができます。しかし、デリゲート型にはデリゲート型以外の要素を含めることはできません。
デリゲートについての詳しい説明は[[デリゲート]]の記事を参照してください。デリゲート型のメソッドには次のものがあります。
*[[デリゲート#Invoke|delegate.Invoke]]
*[[デリゲート#BeginInvoke|delegate.BeginInvoke]]
*[[デリゲート#Length/Count|delegate.Length]]
*[[デリゲート#Length/Count|delegate.Count]]

==type型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/alice/interpreter/type/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>type</code>型は、変数の型を表します。<code>type</code>型は比較、等値演算子をサポートしています。<code>type</code>型の規定値は、<code>type.None</code>です。<code>type</code>型への暗黙的な変換はサポートされていませんが、文字列型からの明示的な変換はサポートされます。この型の型指定修飾子は<code>type</code>です。<code>type</code>型のメソッドには次のものがあります。
*[[Type型のメソッド#Activate|type.Activate]]
[[Category:基本]]

変数

2023-06-29T01:39:47Z

Master: /* none型 */

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

変数は、AliceScriptにおける主要な概念の一つです。変数は、任意の場所で宣言定義でき、その値を取り出したり代入することができます。
この記事では、多くの変数に共通する事項を説明した後、それぞれの型の特徴について説明します。
変数は、すべて基となる<code>variable</code>から派生しています。これは、すべての変数に共通した操作セットを提供します。

AliceScriptの変数は、文字またはアンダースコアから始まり、任意の数の文字、数字、記号が続きます。[[キーワード|予約語]]を使用することはできません。次の例では、<code>a</code>という変数に<code>123</code>を代入し定義します。その後で、その変数の値を[[Print]]関数を使って出力します。
var a = 123;
print(a);
通常、変数に代入されるのは常にその値です。つまり、ある変数に式の値を代入するとその値への参照が代入されます。
通常、変数を定義する際は次の形で宣言します。
var (修飾子) 名前 = 値;

=ローカル変数とスコープ=
変数はその有効な範囲内で、一意な名前である必要があります。この範囲をその変数のスコープと呼びます。スコープの範囲内では、同じ名前の変数を定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義した変数は使用できません。
AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function Func()
{
var a = 123;
}
Func();
print(a);//例外発生
上記の例ではFuncを呼び出すことで、ローカル変数<code>a</code>が定義されていますがそのスコープの範囲外での呼び出しのため、関数外で変数<code>a</code>を使用することはできません。また、インクルードしたファイルに対してもスコープが適用されます。このため、異なるスクリプトファイル間でローカル変数を共有することはできません。
=グローバル変数=
ローカル変数と反対の性質を持つものとして、グローバル変数があります。これは、スコープ内外のどこでも定義でき、定義されたスコープ外でもその変数を使用できます。グローバル変数はスクリプトではなくインタプリタに直接登録されます。その変数をグローバル変数として宣言定義するには<code>global</code>キーワードを使用します。
function Func()
{
var global a = 123;
}
Func();
print(a);//出力:123
上記の例ではFuncを呼び出すことで、グローバル変数<code>a</code>が定義されているため、Funcの呼び出し後には、そのインタプリタで実行されるすべてのコードでグローバル変数<code>a</code>が使用できます。
=定数=
定数は、変数とは異なり、一度宣言すると再度代入したり値を変更することができません。これは、プログラム上で変更されたくない値(トークンなど)を定義する際に役立ちます。定数にもスコープが存在し、ローカル定数とグローバル定数があります。定数を定義するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。
const KEY = “ABCD”;
print(KEY);//出力例:ABCD
KEY = “EFGH”;//例外発生

=型=
AliceScriptのすべての変数および定数は、値に評価されるすべての[[式]]と同じように、型を持ちます。インタプリタはコード内で実行されるすべての演算が型安全になるようにします。例えば<code>number</code>型の変数には、その値を加算したり減算したりする算術演算が許可されます。しかし、<code>bool</code>型にはその種類の演算は許可されません。次に、特定の型の規定値を使用して変数を初期化する例を示します。

var v = type.Activate();

型には次の種類があります。
==variable型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>variable</code>型は、すべての変数の値を表します。<code>variable</code>型は等値演算子をサポートします。この型から文字列型にのみ暗黙的な変換をサポートします。<code>variable</code>型のメソッドは次の通りです。
*[[variable型のメソッド#Dispose|variable.Dispose]]
*[[variable型のメソッド#Equals|variable.Equals]]
*[[variable型のメソッド#Clone|variable.Clone]]
*[[variable型のメソッド#DeepClone|variable.DeepClone]]
*[[variable型のメソッド#ToString|variable.ToString]]
*[[variable型のメソッド#Properties|variable.Properties]]
*[[variable型のメソッド#Type|variable.Type]]
*[[variable型のメソッド#Convert|variable.Convert]]

==number型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/number/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

数値型は実数を表します。数値型は算術、比較、等値演算子をサポートしています。

AliceScriptの数値型の表現できるおおよその範囲は、±5.0 × 10−324 - ±1.7 × 10308(-15~17桁)で、サイズは8バイトです。

数値型の規定値はゼロ<code>0</code>です。また、数値型で非数、正方向の無限、負方向の無限を表す定数がそれぞれ、<code>NaN</code>、<code>PositiveInfinity</code>、<code>NegativeInfinity</code>として定義されています。

数値型への暗黙的な変換は存在しません。型変換演算子を使用するか<code>Convert</code>メソッドを使って、文字列型、<code>bool</code>型、<code>bytes</code>型からの明示的な変換がサポートされています。また、数値型専用のメソッドは存在しません。この型の型指定修飾子は<code>number</code>です。

AliceScriptの数値型では小数点以下の計算が予想通りにいかない場合があります。[[数値型の計算誤差]]の記事を参照してください。

==bool型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bool/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bool</code>型は、ブール値の論理数を表します。<code>bool</code>型は論理、比較、等値演算子をサポートしています。

<code>bool</code>型の有効な値は<code>true</code>か<code>false</code>のいずれかです。
それぞれの値を表す定数がそれぞれ、<code>true</code>、<code>false</code>として定義されています。

<code>bool</code>型への暗黙的な変換は存在しません。特に、WSOFTScriptとは違い数値型の代わりに値を使用することはできません。また、文字列型、数値型、<code>bytes</code>型からの明示的変換がサポートされます。<code>bool</code>型専用のメソッドは存在しません。この型の型指定修飾子は<code>bool</code>です。

==bytes型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bytes/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bytes</code>型は、バイナリデータ配列を表します。<code>bytes</code>型は比較、等値演算子をサポートしています。

<code>bytes</code>型の規定値は<code>null</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>bytes</code>です。

<code>bytes</code>型への暗黙的な変換は存在しません。また、文字列型、数値型、<code>bool</code>型からの明示的変換がサポートされます。<code>bytes</code>型専用のメソッドは存在しません。

==none型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/none/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>none</code>型の有効な値は唯一<code>null</code>です。この型は<code>null</code>をとります。また、<code>null</code>型は比較演算子のみをサポートします。
<code>null</code>の値を表す定数が<code>null</code>として定義されています。
<code>null</code>型への暗黙的な変換および明示的な変換はサポートされていません。

==string型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/string/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

文字列型は、テキストを一連のUTF-16コード単位として表現します。文字列型は結合、比較、等値演算子をサポートしています。
文字列型の規定値は空の文字列<code>””</code>です。また、この型の型指定修飾子は<code>string</code>です。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。文字列型のメソッドは次のものがあります。
*[[string型のメソッド#Trim|string.Trim]]
*[[string型のメソッド#TrimStart|string.TrimStart]]
*[[string型のメソッド#TrimEnd|string.TrimEnd]]
*[[string型のメソッド#StratsWith|stirng.StartsWith]]
*[[string型のメソッド#EndsWith|string.EndsWith]]
*[[string型のメソッド#PadLeft|string.PadLeft]]
*[[string型のメソッド#PadRight|string.PadRight]]
*[[string型のメソッド#Normalize|string.Normalize]]
*[[string型のメソッド#CompareTo|string.CompareTo]]
*[[string型のメソッド#IsNormalized|string.IsNormalized]]
*[[string型のメソッド#IndexOf|string.IndexOf]]
*[[string型のメソッド#LastIndexOf|string.LastIndexOf]]
*[[string型のメソッド#Contains|string.Contains]]
*[[string型のメソッド#Replace|string.Replace]]
*[[string型のメソッド#Split|string.Split]]
*[[string型のメソッド#ToLower|string.ToLower]]
*[[string型のメソッド#ToUpper|string.ToUpper]]
*[[string型のメソッド#EmptyOrWhiteSpaces|string.EmptyOrWhiteSpaces]]
*[[string型のメソッド#Format|string.Format]]
*[[string型のメソッド#Length|string.Length]]
*[[string型のメソッド#Count|string.Count]]

==array型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/array/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

配列型は、インデックスを使用してアクセスできる変数のリストを表します。配列型は、結合、比較、等値演算子をサポートしています。
配列型の規定値は空の配列<code>[]</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>array</code>です。

配列型は必ずしも要素を含む必要も、同一の型である必要もありません。配列型への暗黙的な変換はサポートされていません。
明示的な変換を行うとき、その値を唯一の要素とする配列型に変換されます。配列型のメソッドには次のものがあります。
*[[配列型のメソッド#Add|array.Add]]
*[[配列型のメソッド#AddRange|array.AddRange]]
*[[配列型のメソッド#Remove|array.Remove]]
*[[配列型のメソッド#RemoveAt|array.RemoveAt]]
*[[配列型のメソッド#Insert|array.Insert]]
*[[配列型のメソッド#RemoveRange|array.RemoveRange]]
*[[配列型のメソッド#IndexOf|array.IndexOf]]
*[[配列型のメソッド#Contains|array.Contains]]
*[[配列型のメソッド#Sort|array.Sort]]
*[[配列型のメソッド#Reverse|array.Reverse]]
*[[配列型のメソッド#First|array.First]]
*[[配列型のメソッド#Last|array.Last]]
*[[配列型のメソッド#Flatten|array.Flatten]]
*[[配列型のメソッド#Marge|array.Merge]]
*[[配列型のメソッド#Foreach|array.Foreach]]
*[[配列型のメソッド#Length|array.Length]]
*[[配列型のメソッド#Count|array.Count]]

==delegate型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/delegate/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

デリゲート型は、匿名関数のように一連のステートメントのまとまりを表します。デリゲート型は結合、比較、等値演算子をサポートしています。
デリゲート型の規定値は空のステートメント<code>{}</code>です。この型は<code>null</code>をとり得ます。デリゲート型への暗黙的な変換と明示的な変換の両方はサポートされていません。この型の型指定修飾子は<code>delegate</code>です。

デリゲート型は、配列のように複数の要素を持つことができます。しかし、デリゲート型にはデリゲート型以外の要素を含めることはできません。
デリゲートについての詳しい説明は[[デリゲート]]の記事を参照してください。デリゲート型のメソッドには次のものがあります。
*[[デリゲート#Invoke|delegate.Invoke]]
*[[デリゲート#BeginInvoke|delegate.BeginInvoke]]
*[[デリゲート#Length/Count|delegate.Length]]
*[[デリゲート#Length/Count|delegate.Count]]

==type型==
<code>type</code>型は、変数の型を表します。<code>type</code>型は比較、等値演算子をサポートしています。<code>type</code>型の規定値は、<code>type.None</code>です。<code>type</code>型への暗黙的な変換はサポートされていませんが、文字列型からの明示的な変換はサポートされます。この型の型指定修飾子は<code>type</code>です。<code>type</code>型のメソッドには次のものがあります。
*[[Type型のメソッド#Activate|type.Activate]]
[[Category:基本]]

変数

2023-06-29T01:39:12Z

Master: /* delegate型 */

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

変数は、AliceScriptにおける主要な概念の一つです。変数は、任意の場所で宣言定義でき、その値を取り出したり代入することができます。
この記事では、多くの変数に共通する事項を説明した後、それぞれの型の特徴について説明します。
変数は、すべて基となる<code>variable</code>から派生しています。これは、すべての変数に共通した操作セットを提供します。

AliceScriptの変数は、文字またはアンダースコアから始まり、任意の数の文字、数字、記号が続きます。[[キーワード|予約語]]を使用することはできません。次の例では、<code>a</code>という変数に<code>123</code>を代入し定義します。その後で、その変数の値を[[Print]]関数を使って出力します。
var a = 123;
print(a);
通常、変数に代入されるのは常にその値です。つまり、ある変数に式の値を代入するとその値への参照が代入されます。
通常、変数を定義する際は次の形で宣言します。
var (修飾子) 名前 = 値;

=ローカル変数とスコープ=
変数はその有効な範囲内で、一意な名前である必要があります。この範囲をその変数のスコープと呼びます。スコープの範囲内では、同じ名前の変数を定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義した変数は使用できません。
AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function Func()
{
var a = 123;
}
Func();
print(a);//例外発生
上記の例ではFuncを呼び出すことで、ローカル変数<code>a</code>が定義されていますがそのスコープの範囲外での呼び出しのため、関数外で変数<code>a</code>を使用することはできません。また、インクルードしたファイルに対してもスコープが適用されます。このため、異なるスクリプトファイル間でローカル変数を共有することはできません。
=グローバル変数=
ローカル変数と反対の性質を持つものとして、グローバル変数があります。これは、スコープ内外のどこでも定義でき、定義されたスコープ外でもその変数を使用できます。グローバル変数はスクリプトではなくインタプリタに直接登録されます。その変数をグローバル変数として宣言定義するには<code>global</code>キーワードを使用します。
function Func()
{
var global a = 123;
}
Func();
print(a);//出力:123
上記の例ではFuncを呼び出すことで、グローバル変数<code>a</code>が定義されているため、Funcの呼び出し後には、そのインタプリタで実行されるすべてのコードでグローバル変数<code>a</code>が使用できます。
=定数=
定数は、変数とは異なり、一度宣言すると再度代入したり値を変更することができません。これは、プログラム上で変更されたくない値(トークンなど)を定義する際に役立ちます。定数にもスコープが存在し、ローカル定数とグローバル定数があります。定数を定義するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。
const KEY = “ABCD”;
print(KEY);//出力例:ABCD
KEY = “EFGH”;//例外発生

=型=
AliceScriptのすべての変数および定数は、値に評価されるすべての[[式]]と同じように、型を持ちます。インタプリタはコード内で実行されるすべての演算が型安全になるようにします。例えば<code>number</code>型の変数には、その値を加算したり減算したりする算術演算が許可されます。しかし、<code>bool</code>型にはその種類の演算は許可されません。次に、特定の型の規定値を使用して変数を初期化する例を示します。

var v = type.Activate();

型には次の種類があります。
==variable型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>variable</code>型は、すべての変数の値を表します。<code>variable</code>型は等値演算子をサポートします。この型から文字列型にのみ暗黙的な変換をサポートします。<code>variable</code>型のメソッドは次の通りです。
*[[variable型のメソッド#Dispose|variable.Dispose]]
*[[variable型のメソッド#Equals|variable.Equals]]
*[[variable型のメソッド#Clone|variable.Clone]]
*[[variable型のメソッド#DeepClone|variable.DeepClone]]
*[[variable型のメソッド#ToString|variable.ToString]]
*[[variable型のメソッド#Properties|variable.Properties]]
*[[variable型のメソッド#Type|variable.Type]]
*[[variable型のメソッド#Convert|variable.Convert]]

==number型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/number/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

数値型は実数を表します。数値型は算術、比較、等値演算子をサポートしています。

AliceScriptの数値型の表現できるおおよその範囲は、±5.0 × 10−324 - ±1.7 × 10308(-15~17桁)で、サイズは8バイトです。

数値型の規定値はゼロ<code>0</code>です。また、数値型で非数、正方向の無限、負方向の無限を表す定数がそれぞれ、<code>NaN</code>、<code>PositiveInfinity</code>、<code>NegativeInfinity</code>として定義されています。

数値型への暗黙的な変換は存在しません。型変換演算子を使用するか<code>Convert</code>メソッドを使って、文字列型、<code>bool</code>型、<code>bytes</code>型からの明示的な変換がサポートされています。また、数値型専用のメソッドは存在しません。この型の型指定修飾子は<code>number</code>です。

AliceScriptの数値型では小数点以下の計算が予想通りにいかない場合があります。[[数値型の計算誤差]]の記事を参照してください。

==bool型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bool/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bool</code>型は、ブール値の論理数を表します。<code>bool</code>型は論理、比較、等値演算子をサポートしています。

<code>bool</code>型の有効な値は<code>true</code>か<code>false</code>のいずれかです。
それぞれの値を表す定数がそれぞれ、<code>true</code>、<code>false</code>として定義されています。

<code>bool</code>型への暗黙的な変換は存在しません。特に、WSOFTScriptとは違い数値型の代わりに値を使用することはできません。また、文字列型、数値型、<code>bytes</code>型からの明示的変換がサポートされます。<code>bool</code>型専用のメソッドは存在しません。この型の型指定修飾子は<code>bool</code>です。

==bytes型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bytes/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bytes</code>型は、バイナリデータ配列を表します。<code>bytes</code>型は比較、等値演算子をサポートしています。

<code>bytes</code>型の規定値は<code>null</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>bytes</code>です。

<code>bytes</code>型への暗黙的な変換は存在しません。また、文字列型、数値型、<code>bool</code>型からの明示的変換がサポートされます。<code>bytes</code>型専用のメソッドは存在しません。

==none型==
<code>none</code>型の有効な値は唯一<code>null</code>です。この型は<code>null</code>をとります。また、<code>null</code>型は比較演算子のみをサポートします。
<code>null</code>の値を表す定数が<code>null</code>として定義されています。
<code>null</code>型への暗黙的な変換および明示的な変換はサポートされていません。

==string型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/string/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

文字列型は、テキストを一連のUTF-16コード単位として表現します。文字列型は結合、比較、等値演算子をサポートしています。
文字列型の規定値は空の文字列<code>””</code>です。また、この型の型指定修飾子は<code>string</code>です。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。文字列型のメソッドは次のものがあります。
*[[string型のメソッド#Trim|string.Trim]]
*[[string型のメソッド#TrimStart|string.TrimStart]]
*[[string型のメソッド#TrimEnd|string.TrimEnd]]
*[[string型のメソッド#StratsWith|stirng.StartsWith]]
*[[string型のメソッド#EndsWith|string.EndsWith]]
*[[string型のメソッド#PadLeft|string.PadLeft]]
*[[string型のメソッド#PadRight|string.PadRight]]
*[[string型のメソッド#Normalize|string.Normalize]]
*[[string型のメソッド#CompareTo|string.CompareTo]]
*[[string型のメソッド#IsNormalized|string.IsNormalized]]
*[[string型のメソッド#IndexOf|string.IndexOf]]
*[[string型のメソッド#LastIndexOf|string.LastIndexOf]]
*[[string型のメソッド#Contains|string.Contains]]
*[[string型のメソッド#Replace|string.Replace]]
*[[string型のメソッド#Split|string.Split]]
*[[string型のメソッド#ToLower|string.ToLower]]
*[[string型のメソッド#ToUpper|string.ToUpper]]
*[[string型のメソッド#EmptyOrWhiteSpaces|string.EmptyOrWhiteSpaces]]
*[[string型のメソッド#Format|string.Format]]
*[[string型のメソッド#Length|string.Length]]
*[[string型のメソッド#Count|string.Count]]

==array型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/array/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

配列型は、インデックスを使用してアクセスできる変数のリストを表します。配列型は、結合、比較、等値演算子をサポートしています。
配列型の規定値は空の配列<code>[]</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>array</code>です。

配列型は必ずしも要素を含む必要も、同一の型である必要もありません。配列型への暗黙的な変換はサポートされていません。
明示的な変換を行うとき、その値を唯一の要素とする配列型に変換されます。配列型のメソッドには次のものがあります。
*[[配列型のメソッド#Add|array.Add]]
*[[配列型のメソッド#AddRange|array.AddRange]]
*[[配列型のメソッド#Remove|array.Remove]]
*[[配列型のメソッド#RemoveAt|array.RemoveAt]]
*[[配列型のメソッド#Insert|array.Insert]]
*[[配列型のメソッド#RemoveRange|array.RemoveRange]]
*[[配列型のメソッド#IndexOf|array.IndexOf]]
*[[配列型のメソッド#Contains|array.Contains]]
*[[配列型のメソッド#Sort|array.Sort]]
*[[配列型のメソッド#Reverse|array.Reverse]]
*[[配列型のメソッド#First|array.First]]
*[[配列型のメソッド#Last|array.Last]]
*[[配列型のメソッド#Flatten|array.Flatten]]
*[[配列型のメソッド#Marge|array.Merge]]
*[[配列型のメソッド#Foreach|array.Foreach]]
*[[配列型のメソッド#Length|array.Length]]
*[[配列型のメソッド#Count|array.Count]]

==delegate型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/delegate/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

デリゲート型は、匿名関数のように一連のステートメントのまとまりを表します。デリゲート型は結合、比較、等値演算子をサポートしています。
デリゲート型の規定値は空のステートメント<code>{}</code>です。この型は<code>null</code>をとり得ます。デリゲート型への暗黙的な変換と明示的な変換の両方はサポートされていません。この型の型指定修飾子は<code>delegate</code>です。

デリゲート型は、配列のように複数の要素を持つことができます。しかし、デリゲート型にはデリゲート型以外の要素を含めることはできません。
デリゲートについての詳しい説明は[[デリゲート]]の記事を参照してください。デリゲート型のメソッドには次のものがあります。
*[[デリゲート#Invoke|delegate.Invoke]]
*[[デリゲート#BeginInvoke|delegate.BeginInvoke]]
*[[デリゲート#Length/Count|delegate.Length]]
*[[デリゲート#Length/Count|delegate.Count]]

==type型==
<code>type</code>型は、変数の型を表します。<code>type</code>型は比較、等値演算子をサポートしています。<code>type</code>型の規定値は、<code>type.None</code>です。<code>type</code>型への暗黙的な変換はサポートされていませんが、文字列型からの明示的な変換はサポートされます。この型の型指定修飾子は<code>type</code>です。<code>type</code>型のメソッドには次のものがあります。
*[[Type型のメソッド#Activate|type.Activate]]
[[Category:基本]]

変数

2023-06-29T01:38:47Z

Master: /* array型 */

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

変数は、AliceScriptにおける主要な概念の一つです。変数は、任意の場所で宣言定義でき、その値を取り出したり代入することができます。
この記事では、多くの変数に共通する事項を説明した後、それぞれの型の特徴について説明します。
変数は、すべて基となる<code>variable</code>から派生しています。これは、すべての変数に共通した操作セットを提供します。

AliceScriptの変数は、文字またはアンダースコアから始まり、任意の数の文字、数字、記号が続きます。[[キーワード|予約語]]を使用することはできません。次の例では、<code>a</code>という変数に<code>123</code>を代入し定義します。その後で、その変数の値を[[Print]]関数を使って出力します。
var a = 123;
print(a);
通常、変数に代入されるのは常にその値です。つまり、ある変数に式の値を代入するとその値への参照が代入されます。
通常、変数を定義する際は次の形で宣言します。
var (修飾子) 名前 = 値;

=ローカル変数とスコープ=
変数はその有効な範囲内で、一意な名前である必要があります。この範囲をその変数のスコープと呼びます。スコープの範囲内では、同じ名前の変数を定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義した変数は使用できません。
AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function Func()
{
var a = 123;
}
Func();
print(a);//例外発生
上記の例ではFuncを呼び出すことで、ローカル変数<code>a</code>が定義されていますがそのスコープの範囲外での呼び出しのため、関数外で変数<code>a</code>を使用することはできません。また、インクルードしたファイルに対してもスコープが適用されます。このため、異なるスクリプトファイル間でローカル変数を共有することはできません。
=グローバル変数=
ローカル変数と反対の性質を持つものとして、グローバル変数があります。これは、スコープ内外のどこでも定義でき、定義されたスコープ外でもその変数を使用できます。グローバル変数はスクリプトではなくインタプリタに直接登録されます。その変数をグローバル変数として宣言定義するには<code>global</code>キーワードを使用します。
function Func()
{
var global a = 123;
}
Func();
print(a);//出力:123
上記の例ではFuncを呼び出すことで、グローバル変数<code>a</code>が定義されているため、Funcの呼び出し後には、そのインタプリタで実行されるすべてのコードでグローバル変数<code>a</code>が使用できます。
=定数=
定数は、変数とは異なり、一度宣言すると再度代入したり値を変更することができません。これは、プログラム上で変更されたくない値(トークンなど)を定義する際に役立ちます。定数にもスコープが存在し、ローカル定数とグローバル定数があります。定数を定義するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。
const KEY = “ABCD”;
print(KEY);//出力例:ABCD
KEY = “EFGH”;//例外発生

=型=
AliceScriptのすべての変数および定数は、値に評価されるすべての[[式]]と同じように、型を持ちます。インタプリタはコード内で実行されるすべての演算が型安全になるようにします。例えば<code>number</code>型の変数には、その値を加算したり減算したりする算術演算が許可されます。しかし、<code>bool</code>型にはその種類の演算は許可されません。次に、特定の型の規定値を使用して変数を初期化する例を示します。

var v = type.Activate();

型には次の種類があります。
==variable型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>variable</code>型は、すべての変数の値を表します。<code>variable</code>型は等値演算子をサポートします。この型から文字列型にのみ暗黙的な変換をサポートします。<code>variable</code>型のメソッドは次の通りです。
*[[variable型のメソッド#Dispose|variable.Dispose]]
*[[variable型のメソッド#Equals|variable.Equals]]
*[[variable型のメソッド#Clone|variable.Clone]]
*[[variable型のメソッド#DeepClone|variable.DeepClone]]
*[[variable型のメソッド#ToString|variable.ToString]]
*[[variable型のメソッド#Properties|variable.Properties]]
*[[variable型のメソッド#Type|variable.Type]]
*[[variable型のメソッド#Convert|variable.Convert]]

==number型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/number/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

数値型は実数を表します。数値型は算術、比較、等値演算子をサポートしています。

AliceScriptの数値型の表現できるおおよその範囲は、±5.0 × 10−324 - ±1.7 × 10308(-15~17桁)で、サイズは8バイトです。

数値型の規定値はゼロ<code>0</code>です。また、数値型で非数、正方向の無限、負方向の無限を表す定数がそれぞれ、<code>NaN</code>、<code>PositiveInfinity</code>、<code>NegativeInfinity</code>として定義されています。

数値型への暗黙的な変換は存在しません。型変換演算子を使用するか<code>Convert</code>メソッドを使って、文字列型、<code>bool</code>型、<code>bytes</code>型からの明示的な変換がサポートされています。また、数値型専用のメソッドは存在しません。この型の型指定修飾子は<code>number</code>です。

AliceScriptの数値型では小数点以下の計算が予想通りにいかない場合があります。[[数値型の計算誤差]]の記事を参照してください。

==bool型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bool/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bool</code>型は、ブール値の論理数を表します。<code>bool</code>型は論理、比較、等値演算子をサポートしています。

<code>bool</code>型の有効な値は<code>true</code>か<code>false</code>のいずれかです。
それぞれの値を表す定数がそれぞれ、<code>true</code>、<code>false</code>として定義されています。

<code>bool</code>型への暗黙的な変換は存在しません。特に、WSOFTScriptとは違い数値型の代わりに値を使用することはできません。また、文字列型、数値型、<code>bytes</code>型からの明示的変換がサポートされます。<code>bool</code>型専用のメソッドは存在しません。この型の型指定修飾子は<code>bool</code>です。

==bytes型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bytes/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bytes</code>型は、バイナリデータ配列を表します。<code>bytes</code>型は比較、等値演算子をサポートしています。

<code>bytes</code>型の規定値は<code>null</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>bytes</code>です。

<code>bytes</code>型への暗黙的な変換は存在しません。また、文字列型、数値型、<code>bool</code>型からの明示的変換がサポートされます。<code>bytes</code>型専用のメソッドは存在しません。

==none型==
<code>none</code>型の有効な値は唯一<code>null</code>です。この型は<code>null</code>をとります。また、<code>null</code>型は比較演算子のみをサポートします。
<code>null</code>の値を表す定数が<code>null</code>として定義されています。
<code>null</code>型への暗黙的な変換および明示的な変換はサポートされていません。

==string型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/string/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

文字列型は、テキストを一連のUTF-16コード単位として表現します。文字列型は結合、比較、等値演算子をサポートしています。
文字列型の規定値は空の文字列<code>””</code>です。また、この型の型指定修飾子は<code>string</code>です。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。文字列型のメソッドは次のものがあります。
*[[string型のメソッド#Trim|string.Trim]]
*[[string型のメソッド#TrimStart|string.TrimStart]]
*[[string型のメソッド#TrimEnd|string.TrimEnd]]
*[[string型のメソッド#StratsWith|stirng.StartsWith]]
*[[string型のメソッド#EndsWith|string.EndsWith]]
*[[string型のメソッド#PadLeft|string.PadLeft]]
*[[string型のメソッド#PadRight|string.PadRight]]
*[[string型のメソッド#Normalize|string.Normalize]]
*[[string型のメソッド#CompareTo|string.CompareTo]]
*[[string型のメソッド#IsNormalized|string.IsNormalized]]
*[[string型のメソッド#IndexOf|string.IndexOf]]
*[[string型のメソッド#LastIndexOf|string.LastIndexOf]]
*[[string型のメソッド#Contains|string.Contains]]
*[[string型のメソッド#Replace|string.Replace]]
*[[string型のメソッド#Split|string.Split]]
*[[string型のメソッド#ToLower|string.ToLower]]
*[[string型のメソッド#ToUpper|string.ToUpper]]
*[[string型のメソッド#EmptyOrWhiteSpaces|string.EmptyOrWhiteSpaces]]
*[[string型のメソッド#Format|string.Format]]
*[[string型のメソッド#Length|string.Length]]
*[[string型のメソッド#Count|string.Count]]

==array型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/array/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

配列型は、インデックスを使用してアクセスできる変数のリストを表します。配列型は、結合、比較、等値演算子をサポートしています。
配列型の規定値は空の配列<code>[]</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>array</code>です。

配列型は必ずしも要素を含む必要も、同一の型である必要もありません。配列型への暗黙的な変換はサポートされていません。
明示的な変換を行うとき、その値を唯一の要素とする配列型に変換されます。配列型のメソッドには次のものがあります。
*[[配列型のメソッド#Add|array.Add]]
*[[配列型のメソッド#AddRange|array.AddRange]]
*[[配列型のメソッド#Remove|array.Remove]]
*[[配列型のメソッド#RemoveAt|array.RemoveAt]]
*[[配列型のメソッド#Insert|array.Insert]]
*[[配列型のメソッド#RemoveRange|array.RemoveRange]]
*[[配列型のメソッド#IndexOf|array.IndexOf]]
*[[配列型のメソッド#Contains|array.Contains]]
*[[配列型のメソッド#Sort|array.Sort]]
*[[配列型のメソッド#Reverse|array.Reverse]]
*[[配列型のメソッド#First|array.First]]
*[[配列型のメソッド#Last|array.Last]]
*[[配列型のメソッド#Flatten|array.Flatten]]
*[[配列型のメソッド#Marge|array.Merge]]
*[[配列型のメソッド#Foreach|array.Foreach]]
*[[配列型のメソッド#Length|array.Length]]
*[[配列型のメソッド#Count|array.Count]]

==delegate型==
デリゲート型は、匿名関数のように一連のステートメントのまとまりを表します。デリゲート型は結合、比較、等値演算子をサポートしています。
デリゲート型の規定値は空のステートメント<code>{}</code>です。この型は<code>null</code>をとり得ます。デリゲート型への暗黙的な変換と明示的な変換の両方はサポートされていません。この型の型指定修飾子は<code>delegate</code>です。

デリゲート型は、配列のように複数の要素を持つことができます。しかし、デリゲート型にはデリゲート型以外の要素を含めることはできません。
デリゲートについての詳しい説明は[[デリゲート]]の記事を参照してください。デリゲート型のメソッドには次のものがあります。
*[[デリゲート#Invoke|delegate.Invoke]]
*[[デリゲート#BeginInvoke|delegate.BeginInvoke]]
*[[デリゲート#Length/Count|delegate.Length]]
*[[デリゲート#Length/Count|delegate.Count]]

==type型==
<code>type</code>型は、変数の型を表します。<code>type</code>型は比較、等値演算子をサポートしています。<code>type</code>型の規定値は、<code>type.None</code>です。<code>type</code>型への暗黙的な変換はサポートされていませんが、文字列型からの明示的な変換はサポートされます。この型の型指定修飾子は<code>type</code>です。<code>type</code>型のメソッドには次のものがあります。
*[[Type型のメソッド#Activate|type.Activate]]
[[Category:基本]]

変数

2023-06-29T01:38:21Z

Master: /* string型 */

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

変数は、AliceScriptにおける主要な概念の一つです。変数は、任意の場所で宣言定義でき、その値を取り出したり代入することができます。
この記事では、多くの変数に共通する事項を説明した後、それぞれの型の特徴について説明します。
変数は、すべて基となる<code>variable</code>から派生しています。これは、すべての変数に共通した操作セットを提供します。

AliceScriptの変数は、文字またはアンダースコアから始まり、任意の数の文字、数字、記号が続きます。[[キーワード|予約語]]を使用することはできません。次の例では、<code>a</code>という変数に<code>123</code>を代入し定義します。その後で、その変数の値を[[Print]]関数を使って出力します。
var a = 123;
print(a);
通常、変数に代入されるのは常にその値です。つまり、ある変数に式の値を代入するとその値への参照が代入されます。
通常、変数を定義する際は次の形で宣言します。
var (修飾子) 名前 = 値;

=ローカル変数とスコープ=
変数はその有効な範囲内で、一意な名前である必要があります。この範囲をその変数のスコープと呼びます。スコープの範囲内では、同じ名前の変数を定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義した変数は使用できません。
AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function Func()
{
var a = 123;
}
Func();
print(a);//例外発生
上記の例ではFuncを呼び出すことで、ローカル変数<code>a</code>が定義されていますがそのスコープの範囲外での呼び出しのため、関数外で変数<code>a</code>を使用することはできません。また、インクルードしたファイルに対してもスコープが適用されます。このため、異なるスクリプトファイル間でローカル変数を共有することはできません。
=グローバル変数=
ローカル変数と反対の性質を持つものとして、グローバル変数があります。これは、スコープ内外のどこでも定義でき、定義されたスコープ外でもその変数を使用できます。グローバル変数はスクリプトではなくインタプリタに直接登録されます。その変数をグローバル変数として宣言定義するには<code>global</code>キーワードを使用します。
function Func()
{
var global a = 123;
}
Func();
print(a);//出力:123
上記の例ではFuncを呼び出すことで、グローバル変数<code>a</code>が定義されているため、Funcの呼び出し後には、そのインタプリタで実行されるすべてのコードでグローバル変数<code>a</code>が使用できます。
=定数=
定数は、変数とは異なり、一度宣言すると再度代入したり値を変更することができません。これは、プログラム上で変更されたくない値(トークンなど)を定義する際に役立ちます。定数にもスコープが存在し、ローカル定数とグローバル定数があります。定数を定義するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。
const KEY = “ABCD”;
print(KEY);//出力例:ABCD
KEY = “EFGH”;//例外発生

=型=
AliceScriptのすべての変数および定数は、値に評価されるすべての[[式]]と同じように、型を持ちます。インタプリタはコード内で実行されるすべての演算が型安全になるようにします。例えば<code>number</code>型の変数には、その値を加算したり減算したりする算術演算が許可されます。しかし、<code>bool</code>型にはその種類の演算は許可されません。次に、特定の型の規定値を使用して変数を初期化する例を示します。

var v = type.Activate();

型には次の種類があります。
==variable型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>variable</code>型は、すべての変数の値を表します。<code>variable</code>型は等値演算子をサポートします。この型から文字列型にのみ暗黙的な変換をサポートします。<code>variable</code>型のメソッドは次の通りです。
*[[variable型のメソッド#Dispose|variable.Dispose]]
*[[variable型のメソッド#Equals|variable.Equals]]
*[[variable型のメソッド#Clone|variable.Clone]]
*[[variable型のメソッド#DeepClone|variable.DeepClone]]
*[[variable型のメソッド#ToString|variable.ToString]]
*[[variable型のメソッド#Properties|variable.Properties]]
*[[variable型のメソッド#Type|variable.Type]]
*[[variable型のメソッド#Convert|variable.Convert]]

==number型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/number/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

数値型は実数を表します。数値型は算術、比較、等値演算子をサポートしています。

AliceScriptの数値型の表現できるおおよその範囲は、±5.0 × 10−324 - ±1.7 × 10308(-15~17桁)で、サイズは8バイトです。

数値型の規定値はゼロ<code>0</code>です。また、数値型で非数、正方向の無限、負方向の無限を表す定数がそれぞれ、<code>NaN</code>、<code>PositiveInfinity</code>、<code>NegativeInfinity</code>として定義されています。

数値型への暗黙的な変換は存在しません。型変換演算子を使用するか<code>Convert</code>メソッドを使って、文字列型、<code>bool</code>型、<code>bytes</code>型からの明示的な変換がサポートされています。また、数値型専用のメソッドは存在しません。この型の型指定修飾子は<code>number</code>です。

AliceScriptの数値型では小数点以下の計算が予想通りにいかない場合があります。[[数値型の計算誤差]]の記事を参照してください。

==bool型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bool/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bool</code>型は、ブール値の論理数を表します。<code>bool</code>型は論理、比較、等値演算子をサポートしています。

<code>bool</code>型の有効な値は<code>true</code>か<code>false</code>のいずれかです。
それぞれの値を表す定数がそれぞれ、<code>true</code>、<code>false</code>として定義されています。

<code>bool</code>型への暗黙的な変換は存在しません。特に、WSOFTScriptとは違い数値型の代わりに値を使用することはできません。また、文字列型、数値型、<code>bytes</code>型からの明示的変換がサポートされます。<code>bool</code>型専用のメソッドは存在しません。この型の型指定修飾子は<code>bool</code>です。

==bytes型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bytes/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bytes</code>型は、バイナリデータ配列を表します。<code>bytes</code>型は比較、等値演算子をサポートしています。

<code>bytes</code>型の規定値は<code>null</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>bytes</code>です。

<code>bytes</code>型への暗黙的な変換は存在しません。また、文字列型、数値型、<code>bool</code>型からの明示的変換がサポートされます。<code>bytes</code>型専用のメソッドは存在しません。

==none型==
<code>none</code>型の有効な値は唯一<code>null</code>です。この型は<code>null</code>をとります。また、<code>null</code>型は比較演算子のみをサポートします。
<code>null</code>の値を表す定数が<code>null</code>として定義されています。
<code>null</code>型への暗黙的な変換および明示的な変換はサポートされていません。

==string型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/string/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

文字列型は、テキストを一連のUTF-16コード単位として表現します。文字列型は結合、比較、等値演算子をサポートしています。
文字列型の規定値は空の文字列<code>””</code>です。また、この型の型指定修飾子は<code>string</code>です。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。文字列型のメソッドは次のものがあります。
*[[string型のメソッド#Trim|string.Trim]]
*[[string型のメソッド#TrimStart|string.TrimStart]]
*[[string型のメソッド#TrimEnd|string.TrimEnd]]
*[[string型のメソッド#StratsWith|stirng.StartsWith]]
*[[string型のメソッド#EndsWith|string.EndsWith]]
*[[string型のメソッド#PadLeft|string.PadLeft]]
*[[string型のメソッド#PadRight|string.PadRight]]
*[[string型のメソッド#Normalize|string.Normalize]]
*[[string型のメソッド#CompareTo|string.CompareTo]]
*[[string型のメソッド#IsNormalized|string.IsNormalized]]
*[[string型のメソッド#IndexOf|string.IndexOf]]
*[[string型のメソッド#LastIndexOf|string.LastIndexOf]]
*[[string型のメソッド#Contains|string.Contains]]
*[[string型のメソッド#Replace|string.Replace]]
*[[string型のメソッド#Split|string.Split]]
*[[string型のメソッド#ToLower|string.ToLower]]
*[[string型のメソッド#ToUpper|string.ToUpper]]
*[[string型のメソッド#EmptyOrWhiteSpaces|string.EmptyOrWhiteSpaces]]
*[[string型のメソッド#Format|string.Format]]
*[[string型のメソッド#Length|string.Length]]
*[[string型のメソッド#Count|string.Count]]

==array型==
配列型は、インデックスを使用してアクセスできる変数のリストを表します。配列型は、結合、比較、等値演算子をサポートしています。
配列型の規定値は空の配列<code>[]</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>array</code>です。

配列型は必ずしも要素を含む必要も、同一の型である必要もありません。配列型への暗黙的な変換はサポートされていません。
明示的な変換を行うとき、その値を唯一の要素とする配列型に変換されます。配列型のメソッドには次のものがあります。
*[[配列型のメソッド#Add|array.Add]]
*[[配列型のメソッド#AddRange|array.AddRange]]
*[[配列型のメソッド#Remove|array.Remove]]
*[[配列型のメソッド#RemoveAt|array.RemoveAt]]
*[[配列型のメソッド#Insert|array.Insert]]
*[[配列型のメソッド#RemoveRange|array.RemoveRange]]
*[[配列型のメソッド#IndexOf|array.IndexOf]]
*[[配列型のメソッド#Contains|array.Contains]]
*[[配列型のメソッド#Sort|array.Sort]]
*[[配列型のメソッド#Reverse|array.Reverse]]
*[[配列型のメソッド#First|array.First]]
*[[配列型のメソッド#Last|array.Last]]
*[[配列型のメソッド#Flatten|array.Flatten]]
*[[配列型のメソッド#Marge|array.Merge]]
*[[配列型のメソッド#Foreach|array.Foreach]]
*[[配列型のメソッド#Length|array.Length]]
*[[配列型のメソッド#Count|array.Count]]

==delegate型==
デリゲート型は、匿名関数のように一連のステートメントのまとまりを表します。デリゲート型は結合、比較、等値演算子をサポートしています。
デリゲート型の規定値は空のステートメント<code>{}</code>です。この型は<code>null</code>をとり得ます。デリゲート型への暗黙的な変換と明示的な変換の両方はサポートされていません。この型の型指定修飾子は<code>delegate</code>です。

デリゲート型は、配列のように複数の要素を持つことができます。しかし、デリゲート型にはデリゲート型以外の要素を含めることはできません。
デリゲートについての詳しい説明は[[デリゲート]]の記事を参照してください。デリゲート型のメソッドには次のものがあります。
*[[デリゲート#Invoke|delegate.Invoke]]
*[[デリゲート#BeginInvoke|delegate.BeginInvoke]]
*[[デリゲート#Length/Count|delegate.Length]]
*[[デリゲート#Length/Count|delegate.Count]]

==type型==
<code>type</code>型は、変数の型を表します。<code>type</code>型は比較、等値演算子をサポートしています。<code>type</code>型の規定値は、<code>type.None</code>です。<code>type</code>型への暗黙的な変換はサポートされていませんが、文字列型からの明示的な変換はサポートされます。この型の型指定修飾子は<code>type</code>です。<code>type</code>型のメソッドには次のものがあります。
*[[Type型のメソッド#Activate|type.Activate]]
[[Category:基本]]

変数

2023-06-29T01:37:47Z

Master: /* bytes型 */

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

変数は、AliceScriptにおける主要な概念の一つです。変数は、任意の場所で宣言定義でき、その値を取り出したり代入することができます。
この記事では、多くの変数に共通する事項を説明した後、それぞれの型の特徴について説明します。
変数は、すべて基となる<code>variable</code>から派生しています。これは、すべての変数に共通した操作セットを提供します。

AliceScriptの変数は、文字またはアンダースコアから始まり、任意の数の文字、数字、記号が続きます。[[キーワード|予約語]]を使用することはできません。次の例では、<code>a</code>という変数に<code>123</code>を代入し定義します。その後で、その変数の値を[[Print]]関数を使って出力します。
var a = 123;
print(a);
通常、変数に代入されるのは常にその値です。つまり、ある変数に式の値を代入するとその値への参照が代入されます。
通常、変数を定義する際は次の形で宣言します。
var (修飾子) 名前 = 値;

=ローカル変数とスコープ=
変数はその有効な範囲内で、一意な名前である必要があります。この範囲をその変数のスコープと呼びます。スコープの範囲内では、同じ名前の変数を定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義した変数は使用できません。
AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function Func()
{
var a = 123;
}
Func();
print(a);//例外発生
上記の例ではFuncを呼び出すことで、ローカル変数<code>a</code>が定義されていますがそのスコープの範囲外での呼び出しのため、関数外で変数<code>a</code>を使用することはできません。また、インクルードしたファイルに対してもスコープが適用されます。このため、異なるスクリプトファイル間でローカル変数を共有することはできません。
=グローバル変数=
ローカル変数と反対の性質を持つものとして、グローバル変数があります。これは、スコープ内外のどこでも定義でき、定義されたスコープ外でもその変数を使用できます。グローバル変数はスクリプトではなくインタプリタに直接登録されます。その変数をグローバル変数として宣言定義するには<code>global</code>キーワードを使用します。
function Func()
{
var global a = 123;
}
Func();
print(a);//出力:123
上記の例ではFuncを呼び出すことで、グローバル変数<code>a</code>が定義されているため、Funcの呼び出し後には、そのインタプリタで実行されるすべてのコードでグローバル変数<code>a</code>が使用できます。
=定数=
定数は、変数とは異なり、一度宣言すると再度代入したり値を変更することができません。これは、プログラム上で変更されたくない値(トークンなど)を定義する際に役立ちます。定数にもスコープが存在し、ローカル定数とグローバル定数があります。定数を定義するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。
const KEY = “ABCD”;
print(KEY);//出力例:ABCD
KEY = “EFGH”;//例外発生

=型=
AliceScriptのすべての変数および定数は、値に評価されるすべての[[式]]と同じように、型を持ちます。インタプリタはコード内で実行されるすべての演算が型安全になるようにします。例えば<code>number</code>型の変数には、その値を加算したり減算したりする算術演算が許可されます。しかし、<code>bool</code>型にはその種類の演算は許可されません。次に、特定の型の規定値を使用して変数を初期化する例を示します。

var v = type.Activate();

型には次の種類があります。
==variable型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>variable</code>型は、すべての変数の値を表します。<code>variable</code>型は等値演算子をサポートします。この型から文字列型にのみ暗黙的な変換をサポートします。<code>variable</code>型のメソッドは次の通りです。
*[[variable型のメソッド#Dispose|variable.Dispose]]
*[[variable型のメソッド#Equals|variable.Equals]]
*[[variable型のメソッド#Clone|variable.Clone]]
*[[variable型のメソッド#DeepClone|variable.DeepClone]]
*[[variable型のメソッド#ToString|variable.ToString]]
*[[variable型のメソッド#Properties|variable.Properties]]
*[[variable型のメソッド#Type|variable.Type]]
*[[variable型のメソッド#Convert|variable.Convert]]

==number型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/number/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

数値型は実数を表します。数値型は算術、比較、等値演算子をサポートしています。

AliceScriptの数値型の表現できるおおよその範囲は、±5.0 × 10−324 - ±1.7 × 10308(-15~17桁)で、サイズは8バイトです。

数値型の規定値はゼロ<code>0</code>です。また、数値型で非数、正方向の無限、負方向の無限を表す定数がそれぞれ、<code>NaN</code>、<code>PositiveInfinity</code>、<code>NegativeInfinity</code>として定義されています。

数値型への暗黙的な変換は存在しません。型変換演算子を使用するか<code>Convert</code>メソッドを使って、文字列型、<code>bool</code>型、<code>bytes</code>型からの明示的な変換がサポートされています。また、数値型専用のメソッドは存在しません。この型の型指定修飾子は<code>number</code>です。

AliceScriptの数値型では小数点以下の計算が予想通りにいかない場合があります。[[数値型の計算誤差]]の記事を参照してください。

==bool型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bool/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bool</code>型は、ブール値の論理数を表します。<code>bool</code>型は論理、比較、等値演算子をサポートしています。

<code>bool</code>型の有効な値は<code>true</code>か<code>false</code>のいずれかです。
それぞれの値を表す定数がそれぞれ、<code>true</code>、<code>false</code>として定義されています。

<code>bool</code>型への暗黙的な変換は存在しません。特に、WSOFTScriptとは違い数値型の代わりに値を使用することはできません。また、文字列型、数値型、<code>bytes</code>型からの明示的変換がサポートされます。<code>bool</code>型専用のメソッドは存在しません。この型の型指定修飾子は<code>bool</code>です。

==bytes型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bytes/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bytes</code>型は、バイナリデータ配列を表します。<code>bytes</code>型は比較、等値演算子をサポートしています。

<code>bytes</code>型の規定値は<code>null</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>bytes</code>です。

<code>bytes</code>型への暗黙的な変換は存在しません。また、文字列型、数値型、<code>bool</code>型からの明示的変換がサポートされます。<code>bytes</code>型専用のメソッドは存在しません。

==none型==
<code>none</code>型の有効な値は唯一<code>null</code>です。この型は<code>null</code>をとります。また、<code>null</code>型は比較演算子のみをサポートします。
<code>null</code>の値を表す定数が<code>null</code>として定義されています。
<code>null</code>型への暗黙的な変換および明示的な変換はサポートされていません。

==string型==
文字列型は、テキストを一連のUTF-16コード単位として表現します。文字列型は結合、比較、等値演算子をサポートしています。
文字列型の規定値は空の文字列<code>””</code>です。また、この型の型指定修飾子は<code>string</code>です。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。文字列型のメソッドは次のものがあります。
*[[string型のメソッド#Trim|string.Trim]]
*[[string型のメソッド#TrimStart|string.TrimStart]]
*[[string型のメソッド#TrimEnd|string.TrimEnd]]
*[[string型のメソッド#StratsWith|stirng.StartsWith]]
*[[string型のメソッド#EndsWith|string.EndsWith]]
*[[string型のメソッド#PadLeft|string.PadLeft]]
*[[string型のメソッド#PadRight|string.PadRight]]
*[[string型のメソッド#Normalize|string.Normalize]]
*[[string型のメソッド#CompareTo|string.CompareTo]]
*[[string型のメソッド#IsNormalized|string.IsNormalized]]
*[[string型のメソッド#IndexOf|string.IndexOf]]
*[[string型のメソッド#LastIndexOf|string.LastIndexOf]]
*[[string型のメソッド#Contains|string.Contains]]
*[[string型のメソッド#Replace|string.Replace]]
*[[string型のメソッド#Split|string.Split]]
*[[string型のメソッド#ToLower|string.ToLower]]
*[[string型のメソッド#ToUpper|string.ToUpper]]
*[[string型のメソッド#EmptyOrWhiteSpaces|string.EmptyOrWhiteSpaces]]
*[[string型のメソッド#Format|string.Format]]
*[[string型のメソッド#Length|string.Length]]
*[[string型のメソッド#Count|string.Count]]

==array型==
配列型は、インデックスを使用してアクセスできる変数のリストを表します。配列型は、結合、比較、等値演算子をサポートしています。
配列型の規定値は空の配列<code>[]</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>array</code>です。

配列型は必ずしも要素を含む必要も、同一の型である必要もありません。配列型への暗黙的な変換はサポートされていません。
明示的な変換を行うとき、その値を唯一の要素とする配列型に変換されます。配列型のメソッドには次のものがあります。
*[[配列型のメソッド#Add|array.Add]]
*[[配列型のメソッド#AddRange|array.AddRange]]
*[[配列型のメソッド#Remove|array.Remove]]
*[[配列型のメソッド#RemoveAt|array.RemoveAt]]
*[[配列型のメソッド#Insert|array.Insert]]
*[[配列型のメソッド#RemoveRange|array.RemoveRange]]
*[[配列型のメソッド#IndexOf|array.IndexOf]]
*[[配列型のメソッド#Contains|array.Contains]]
*[[配列型のメソッド#Sort|array.Sort]]
*[[配列型のメソッド#Reverse|array.Reverse]]
*[[配列型のメソッド#First|array.First]]
*[[配列型のメソッド#Last|array.Last]]
*[[配列型のメソッド#Flatten|array.Flatten]]
*[[配列型のメソッド#Marge|array.Merge]]
*[[配列型のメソッド#Foreach|array.Foreach]]
*[[配列型のメソッド#Length|array.Length]]
*[[配列型のメソッド#Count|array.Count]]

==delegate型==
デリゲート型は、匿名関数のように一連のステートメントのまとまりを表します。デリゲート型は結合、比較、等値演算子をサポートしています。
デリゲート型の規定値は空のステートメント<code>{}</code>です。この型は<code>null</code>をとり得ます。デリゲート型への暗黙的な変換と明示的な変換の両方はサポートされていません。この型の型指定修飾子は<code>delegate</code>です。

デリゲート型は、配列のように複数の要素を持つことができます。しかし、デリゲート型にはデリゲート型以外の要素を含めることはできません。
デリゲートについての詳しい説明は[[デリゲート]]の記事を参照してください。デリゲート型のメソッドには次のものがあります。
*[[デリゲート#Invoke|delegate.Invoke]]
*[[デリゲート#BeginInvoke|delegate.BeginInvoke]]
*[[デリゲート#Length/Count|delegate.Length]]
*[[デリゲート#Length/Count|delegate.Count]]

==type型==
<code>type</code>型は、変数の型を表します。<code>type</code>型は比較、等値演算子をサポートしています。<code>type</code>型の規定値は、<code>type.None</code>です。<code>type</code>型への暗黙的な変換はサポートされていませんが、文字列型からの明示的な変換はサポートされます。この型の型指定修飾子は<code>type</code>です。<code>type</code>型のメソッドには次のものがあります。
*[[Type型のメソッド#Activate|type.Activate]]
[[Category:基本]]

変数

2023-06-29T01:37:11Z

Master: /* bool型 */

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

変数は、AliceScriptにおける主要な概念の一つです。変数は、任意の場所で宣言定義でき、その値を取り出したり代入することができます。
この記事では、多くの変数に共通する事項を説明した後、それぞれの型の特徴について説明します。
変数は、すべて基となる<code>variable</code>から派生しています。これは、すべての変数に共通した操作セットを提供します。

AliceScriptの変数は、文字またはアンダースコアから始まり、任意の数の文字、数字、記号が続きます。[[キーワード|予約語]]を使用することはできません。次の例では、<code>a</code>という変数に<code>123</code>を代入し定義します。その後で、その変数の値を[[Print]]関数を使って出力します。
var a = 123;
print(a);
通常、変数に代入されるのは常にその値です。つまり、ある変数に式の値を代入するとその値への参照が代入されます。
通常、変数を定義する際は次の形で宣言します。
var (修飾子) 名前 = 値;

=ローカル変数とスコープ=
変数はその有効な範囲内で、一意な名前である必要があります。この範囲をその変数のスコープと呼びます。スコープの範囲内では、同じ名前の変数を定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義した変数は使用できません。
AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function Func()
{
var a = 123;
}
Func();
print(a);//例外発生
上記の例ではFuncを呼び出すことで、ローカル変数<code>a</code>が定義されていますがそのスコープの範囲外での呼び出しのため、関数外で変数<code>a</code>を使用することはできません。また、インクルードしたファイルに対してもスコープが適用されます。このため、異なるスクリプトファイル間でローカル変数を共有することはできません。
=グローバル変数=
ローカル変数と反対の性質を持つものとして、グローバル変数があります。これは、スコープ内外のどこでも定義でき、定義されたスコープ外でもその変数を使用できます。グローバル変数はスクリプトではなくインタプリタに直接登録されます。その変数をグローバル変数として宣言定義するには<code>global</code>キーワードを使用します。
function Func()
{
var global a = 123;
}
Func();
print(a);//出力:123
上記の例ではFuncを呼び出すことで、グローバル変数<code>a</code>が定義されているため、Funcの呼び出し後には、そのインタプリタで実行されるすべてのコードでグローバル変数<code>a</code>が使用できます。
=定数=
定数は、変数とは異なり、一度宣言すると再度代入したり値を変更することができません。これは、プログラム上で変更されたくない値(トークンなど)を定義する際に役立ちます。定数にもスコープが存在し、ローカル定数とグローバル定数があります。定数を定義するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。
const KEY = “ABCD”;
print(KEY);//出力例:ABCD
KEY = “EFGH”;//例外発生

=型=
AliceScriptのすべての変数および定数は、値に評価されるすべての[[式]]と同じように、型を持ちます。インタプリタはコード内で実行されるすべての演算が型安全になるようにします。例えば<code>number</code>型の変数には、その値を加算したり減算したりする算術演算が許可されます。しかし、<code>bool</code>型にはその種類の演算は許可されません。次に、特定の型の規定値を使用して変数を初期化する例を示します。

var v = type.Activate();

型には次の種類があります。
==variable型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>variable</code>型は、すべての変数の値を表します。<code>variable</code>型は等値演算子をサポートします。この型から文字列型にのみ暗黙的な変換をサポートします。<code>variable</code>型のメソッドは次の通りです。
*[[variable型のメソッド#Dispose|variable.Dispose]]
*[[variable型のメソッド#Equals|variable.Equals]]
*[[variable型のメソッド#Clone|variable.Clone]]
*[[variable型のメソッド#DeepClone|variable.DeepClone]]
*[[variable型のメソッド#ToString|variable.ToString]]
*[[variable型のメソッド#Properties|variable.Properties]]
*[[variable型のメソッド#Type|variable.Type]]
*[[variable型のメソッド#Convert|variable.Convert]]

==number型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/number/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

数値型は実数を表します。数値型は算術、比較、等値演算子をサポートしています。

AliceScriptの数値型の表現できるおおよその範囲は、±5.0 × 10−324 - ±1.7 × 10308(-15~17桁)で、サイズは8バイトです。

数値型の規定値はゼロ<code>0</code>です。また、数値型で非数、正方向の無限、負方向の無限を表す定数がそれぞれ、<code>NaN</code>、<code>PositiveInfinity</code>、<code>NegativeInfinity</code>として定義されています。

数値型への暗黙的な変換は存在しません。型変換演算子を使用するか<code>Convert</code>メソッドを使って、文字列型、<code>bool</code>型、<code>bytes</code>型からの明示的な変換がサポートされています。また、数値型専用のメソッドは存在しません。この型の型指定修飾子は<code>number</code>です。

AliceScriptの数値型では小数点以下の計算が予想通りにいかない場合があります。[[数値型の計算誤差]]の記事を参照してください。

==bool型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/bool/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>bool</code>型は、ブール値の論理数を表します。<code>bool</code>型は論理、比較、等値演算子をサポートしています。

<code>bool</code>型の有効な値は<code>true</code>か<code>false</code>のいずれかです。
それぞれの値を表す定数がそれぞれ、<code>true</code>、<code>false</code>として定義されています。

<code>bool</code>型への暗黙的な変換は存在しません。特に、WSOFTScriptとは違い数値型の代わりに値を使用することはできません。また、文字列型、数値型、<code>bytes</code>型からの明示的変換がサポートされます。<code>bool</code>型専用のメソッドは存在しません。この型の型指定修飾子は<code>bool</code>です。

==bytes型==
<code>bytes</code>型は、バイナリデータ配列を表します。<code>bytes</code>型は比較、等値演算子をサポートしています。

<code>bytes</code>型の規定値は<code>null</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>bytes</code>です。

<code>bytes</code>型への暗黙的な変換は存在しません。また、文字列型、数値型、<code>bool</code>型からの明示的変換がサポートされます。<code>bytes</code>型専用のメソッドは存在しません。
==none型==
<code>none</code>型の有効な値は唯一<code>null</code>です。この型は<code>null</code>をとります。また、<code>null</code>型は比較演算子のみをサポートします。
<code>null</code>の値を表す定数が<code>null</code>として定義されています。
<code>null</code>型への暗黙的な変換および明示的な変換はサポートされていません。

==string型==
文字列型は、テキストを一連のUTF-16コード単位として表現します。文字列型は結合、比較、等値演算子をサポートしています。
文字列型の規定値は空の文字列<code>””</code>です。また、この型の型指定修飾子は<code>string</code>です。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。文字列型のメソッドは次のものがあります。
*[[string型のメソッド#Trim|string.Trim]]
*[[string型のメソッド#TrimStart|string.TrimStart]]
*[[string型のメソッド#TrimEnd|string.TrimEnd]]
*[[string型のメソッド#StratsWith|stirng.StartsWith]]
*[[string型のメソッド#EndsWith|string.EndsWith]]
*[[string型のメソッド#PadLeft|string.PadLeft]]
*[[string型のメソッド#PadRight|string.PadRight]]
*[[string型のメソッド#Normalize|string.Normalize]]
*[[string型のメソッド#CompareTo|string.CompareTo]]
*[[string型のメソッド#IsNormalized|string.IsNormalized]]
*[[string型のメソッド#IndexOf|string.IndexOf]]
*[[string型のメソッド#LastIndexOf|string.LastIndexOf]]
*[[string型のメソッド#Contains|string.Contains]]
*[[string型のメソッド#Replace|string.Replace]]
*[[string型のメソッド#Split|string.Split]]
*[[string型のメソッド#ToLower|string.ToLower]]
*[[string型のメソッド#ToUpper|string.ToUpper]]
*[[string型のメソッド#EmptyOrWhiteSpaces|string.EmptyOrWhiteSpaces]]
*[[string型のメソッド#Format|string.Format]]
*[[string型のメソッド#Length|string.Length]]
*[[string型のメソッド#Count|string.Count]]

==array型==
配列型は、インデックスを使用してアクセスできる変数のリストを表します。配列型は、結合、比較、等値演算子をサポートしています。
配列型の規定値は空の配列<code>[]</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>array</code>です。

配列型は必ずしも要素を含む必要も、同一の型である必要もありません。配列型への暗黙的な変換はサポートされていません。
明示的な変換を行うとき、その値を唯一の要素とする配列型に変換されます。配列型のメソッドには次のものがあります。
*[[配列型のメソッド#Add|array.Add]]
*[[配列型のメソッド#AddRange|array.AddRange]]
*[[配列型のメソッド#Remove|array.Remove]]
*[[配列型のメソッド#RemoveAt|array.RemoveAt]]
*[[配列型のメソッド#Insert|array.Insert]]
*[[配列型のメソッド#RemoveRange|array.RemoveRange]]
*[[配列型のメソッド#IndexOf|array.IndexOf]]
*[[配列型のメソッド#Contains|array.Contains]]
*[[配列型のメソッド#Sort|array.Sort]]
*[[配列型のメソッド#Reverse|array.Reverse]]
*[[配列型のメソッド#First|array.First]]
*[[配列型のメソッド#Last|array.Last]]
*[[配列型のメソッド#Flatten|array.Flatten]]
*[[配列型のメソッド#Marge|array.Merge]]
*[[配列型のメソッド#Foreach|array.Foreach]]
*[[配列型のメソッド#Length|array.Length]]
*[[配列型のメソッド#Count|array.Count]]

==delegate型==
デリゲート型は、匿名関数のように一連のステートメントのまとまりを表します。デリゲート型は結合、比較、等値演算子をサポートしています。
デリゲート型の規定値は空のステートメント<code>{}</code>です。この型は<code>null</code>をとり得ます。デリゲート型への暗黙的な変換と明示的な変換の両方はサポートされていません。この型の型指定修飾子は<code>delegate</code>です。

デリゲート型は、配列のように複数の要素を持つことができます。しかし、デリゲート型にはデリゲート型以外の要素を含めることはできません。
デリゲートについての詳しい説明は[[デリゲート]]の記事を参照してください。デリゲート型のメソッドには次のものがあります。
*[[デリゲート#Invoke|delegate.Invoke]]
*[[デリゲート#BeginInvoke|delegate.BeginInvoke]]
*[[デリゲート#Length/Count|delegate.Length]]
*[[デリゲート#Length/Count|delegate.Count]]

==type型==
<code>type</code>型は、変数の型を表します。<code>type</code>型は比較、等値演算子をサポートしています。<code>type</code>型の規定値は、<code>type.None</code>です。<code>type</code>型への暗黙的な変換はサポートされていませんが、文字列型からの明示的な変換はサポートされます。この型の型指定修飾子は<code>type</code>です。<code>type</code>型のメソッドには次のものがあります。
*[[Type型のメソッド#Activate|type.Activate]]
[[Category:基本]]

変数

2023-06-29T01:36:06Z

Master: /* number型 */

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

変数は、AliceScriptにおける主要な概念の一つです。変数は、任意の場所で宣言定義でき、その値を取り出したり代入することができます。
この記事では、多くの変数に共通する事項を説明した後、それぞれの型の特徴について説明します。
変数は、すべて基となる<code>variable</code>から派生しています。これは、すべての変数に共通した操作セットを提供します。

AliceScriptの変数は、文字またはアンダースコアから始まり、任意の数の文字、数字、記号が続きます。[[キーワード|予約語]]を使用することはできません。次の例では、<code>a</code>という変数に<code>123</code>を代入し定義します。その後で、その変数の値を[[Print]]関数を使って出力します。
var a = 123;
print(a);
通常、変数に代入されるのは常にその値です。つまり、ある変数に式の値を代入するとその値への参照が代入されます。
通常、変数を定義する際は次の形で宣言します。
var (修飾子) 名前 = 値;

=ローカル変数とスコープ=
変数はその有効な範囲内で、一意な名前である必要があります。この範囲をその変数のスコープと呼びます。スコープの範囲内では、同じ名前の変数を定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義した変数は使用できません。
AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function Func()
{
var a = 123;
}
Func();
print(a);//例外発生
上記の例ではFuncを呼び出すことで、ローカル変数<code>a</code>が定義されていますがそのスコープの範囲外での呼び出しのため、関数外で変数<code>a</code>を使用することはできません。また、インクルードしたファイルに対してもスコープが適用されます。このため、異なるスクリプトファイル間でローカル変数を共有することはできません。
=グローバル変数=
ローカル変数と反対の性質を持つものとして、グローバル変数があります。これは、スコープ内外のどこでも定義でき、定義されたスコープ外でもその変数を使用できます。グローバル変数はスクリプトではなくインタプリタに直接登録されます。その変数をグローバル変数として宣言定義するには<code>global</code>キーワードを使用します。
function Func()
{
var global a = 123;
}
Func();
print(a);//出力:123
上記の例ではFuncを呼び出すことで、グローバル変数<code>a</code>が定義されているため、Funcの呼び出し後には、そのインタプリタで実行されるすべてのコードでグローバル変数<code>a</code>が使用できます。
=定数=
定数は、変数とは異なり、一度宣言すると再度代入したり値を変更することができません。これは、プログラム上で変更されたくない値(トークンなど)を定義する際に役立ちます。定数にもスコープが存在し、ローカル定数とグローバル定数があります。定数を定義するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。
const KEY = “ABCD”;
print(KEY);//出力例:ABCD
KEY = “EFGH”;//例外発生

=型=
AliceScriptのすべての変数および定数は、値に評価されるすべての[[式]]と同じように、型を持ちます。インタプリタはコード内で実行されるすべての演算が型安全になるようにします。例えば<code>number</code>型の変数には、その値を加算したり減算したりする算術演算が許可されます。しかし、<code>bool</code>型にはその種類の演算は許可されません。次に、特定の型の規定値を使用して変数を初期化する例を示します。

var v = type.Activate();

型には次の種類があります。
==variable型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>variable</code>型は、すべての変数の値を表します。<code>variable</code>型は等値演算子をサポートします。この型から文字列型にのみ暗黙的な変換をサポートします。<code>variable</code>型のメソッドは次の通りです。
*[[variable型のメソッド#Dispose|variable.Dispose]]
*[[variable型のメソッド#Equals|variable.Equals]]
*[[variable型のメソッド#Clone|variable.Clone]]
*[[variable型のメソッド#DeepClone|variable.DeepClone]]
*[[variable型のメソッド#ToString|variable.ToString]]
*[[variable型のメソッド#Properties|variable.Properties]]
*[[variable型のメソッド#Type|variable.Type]]
*[[variable型のメソッド#Convert|variable.Convert]]

==number型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/number/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

数値型は実数を表します。数値型は算術、比較、等値演算子をサポートしています。

AliceScriptの数値型の表現できるおおよその範囲は、±5.0 × 10−324 - ±1.7 × 10308(-15~17桁)で、サイズは8バイトです。

数値型の規定値はゼロ<code>0</code>です。また、数値型で非数、正方向の無限、負方向の無限を表す定数がそれぞれ、<code>NaN</code>、<code>PositiveInfinity</code>、<code>NegativeInfinity</code>として定義されています。

数値型への暗黙的な変換は存在しません。型変換演算子を使用するか<code>Convert</code>メソッドを使って、文字列型、<code>bool</code>型、<code>bytes</code>型からの明示的な変換がサポートされています。また、数値型専用のメソッドは存在しません。この型の型指定修飾子は<code>number</code>です。

AliceScriptの数値型では小数点以下の計算が予想通りにいかない場合があります。[[数値型の計算誤差]]の記事を参照してください。

==bool型==
<code>bool</code>型は、ブール値の論理数を表します。<code>bool</code>型は論理、比較、等値演算子をサポートしています。

<code>bool</code>型の有効な値は<code>true</code>か<code>false</code>のいずれかです。
それぞれの値を表す定数がそれぞれ、<code>true</code>、<code>false</code>として定義されています。

<code>bool</code>型への暗黙的な変換は存在しません。特に、WSOFTScriptとは違い数値型の代わりに値を使用することはできません。また、文字列型、数値型、<code>bytes</code>型からの明示的変換がサポートされます。<code>bool</code>型専用のメソッドは存在しません。この型の型指定修飾子は<code>bool</code>です。
==bytes型==
<code>bytes</code>型は、バイナリデータ配列を表します。<code>bytes</code>型は比較、等値演算子をサポートしています。

<code>bytes</code>型の規定値は<code>null</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>bytes</code>です。

<code>bytes</code>型への暗黙的な変換は存在しません。また、文字列型、数値型、<code>bool</code>型からの明示的変換がサポートされます。<code>bytes</code>型専用のメソッドは存在しません。
==none型==
<code>none</code>型の有効な値は唯一<code>null</code>です。この型は<code>null</code>をとります。また、<code>null</code>型は比較演算子のみをサポートします。
<code>null</code>の値を表す定数が<code>null</code>として定義されています。
<code>null</code>型への暗黙的な変換および明示的な変換はサポートされていません。

==string型==
文字列型は、テキストを一連のUTF-16コード単位として表現します。文字列型は結合、比較、等値演算子をサポートしています。
文字列型の規定値は空の文字列<code>””</code>です。また、この型の型指定修飾子は<code>string</code>です。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。文字列型のメソッドは次のものがあります。
*[[string型のメソッド#Trim|string.Trim]]
*[[string型のメソッド#TrimStart|string.TrimStart]]
*[[string型のメソッド#TrimEnd|string.TrimEnd]]
*[[string型のメソッド#StratsWith|stirng.StartsWith]]
*[[string型のメソッド#EndsWith|string.EndsWith]]
*[[string型のメソッド#PadLeft|string.PadLeft]]
*[[string型のメソッド#PadRight|string.PadRight]]
*[[string型のメソッド#Normalize|string.Normalize]]
*[[string型のメソッド#CompareTo|string.CompareTo]]
*[[string型のメソッド#IsNormalized|string.IsNormalized]]
*[[string型のメソッド#IndexOf|string.IndexOf]]
*[[string型のメソッド#LastIndexOf|string.LastIndexOf]]
*[[string型のメソッド#Contains|string.Contains]]
*[[string型のメソッド#Replace|string.Replace]]
*[[string型のメソッド#Split|string.Split]]
*[[string型のメソッド#ToLower|string.ToLower]]
*[[string型のメソッド#ToUpper|string.ToUpper]]
*[[string型のメソッド#EmptyOrWhiteSpaces|string.EmptyOrWhiteSpaces]]
*[[string型のメソッド#Format|string.Format]]
*[[string型のメソッド#Length|string.Length]]
*[[string型のメソッド#Count|string.Count]]

==array型==
配列型は、インデックスを使用してアクセスできる変数のリストを表します。配列型は、結合、比較、等値演算子をサポートしています。
配列型の規定値は空の配列<code>[]</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>array</code>です。

配列型は必ずしも要素を含む必要も、同一の型である必要もありません。配列型への暗黙的な変換はサポートされていません。
明示的な変換を行うとき、その値を唯一の要素とする配列型に変換されます。配列型のメソッドには次のものがあります。
*[[配列型のメソッド#Add|array.Add]]
*[[配列型のメソッド#AddRange|array.AddRange]]
*[[配列型のメソッド#Remove|array.Remove]]
*[[配列型のメソッド#RemoveAt|array.RemoveAt]]
*[[配列型のメソッド#Insert|array.Insert]]
*[[配列型のメソッド#RemoveRange|array.RemoveRange]]
*[[配列型のメソッド#IndexOf|array.IndexOf]]
*[[配列型のメソッド#Contains|array.Contains]]
*[[配列型のメソッド#Sort|array.Sort]]
*[[配列型のメソッド#Reverse|array.Reverse]]
*[[配列型のメソッド#First|array.First]]
*[[配列型のメソッド#Last|array.Last]]
*[[配列型のメソッド#Flatten|array.Flatten]]
*[[配列型のメソッド#Marge|array.Merge]]
*[[配列型のメソッド#Foreach|array.Foreach]]
*[[配列型のメソッド#Length|array.Length]]
*[[配列型のメソッド#Count|array.Count]]

==delegate型==
デリゲート型は、匿名関数のように一連のステートメントのまとまりを表します。デリゲート型は結合、比較、等値演算子をサポートしています。
デリゲート型の規定値は空のステートメント<code>{}</code>です。この型は<code>null</code>をとり得ます。デリゲート型への暗黙的な変換と明示的な変換の両方はサポートされていません。この型の型指定修飾子は<code>delegate</code>です。

デリゲート型は、配列のように複数の要素を持つことができます。しかし、デリゲート型にはデリゲート型以外の要素を含めることはできません。
デリゲートについての詳しい説明は[[デリゲート]]の記事を参照してください。デリゲート型のメソッドには次のものがあります。
*[[デリゲート#Invoke|delegate.Invoke]]
*[[デリゲート#BeginInvoke|delegate.BeginInvoke]]
*[[デリゲート#Length/Count|delegate.Length]]
*[[デリゲート#Length/Count|delegate.Count]]

==type型==
<code>type</code>型は、変数の型を表します。<code>type</code>型は比較、等値演算子をサポートしています。<code>type</code>型の規定値は、<code>type.None</code>です。<code>type</code>型への暗黙的な変換はサポートされていませんが、文字列型からの明示的な変換はサポートされます。この型の型指定修飾子は<code>type</code>です。<code>type</code>型のメソッドには次のものがあります。
*[[Type型のメソッド#Activate|type.Activate]]
[[Category:基本]]

変数

2023-06-29T01:35:11Z

Master: /* variable型 */

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

変数は、AliceScriptにおける主要な概念の一つです。変数は、任意の場所で宣言定義でき、その値を取り出したり代入することができます。
この記事では、多くの変数に共通する事項を説明した後、それぞれの型の特徴について説明します。
変数は、すべて基となる<code>variable</code>から派生しています。これは、すべての変数に共通した操作セットを提供します。

AliceScriptの変数は、文字またはアンダースコアから始まり、任意の数の文字、数字、記号が続きます。[[キーワード|予約語]]を使用することはできません。次の例では、<code>a</code>という変数に<code>123</code>を代入し定義します。その後で、その変数の値を[[Print]]関数を使って出力します。
var a = 123;
print(a);
通常、変数に代入されるのは常にその値です。つまり、ある変数に式の値を代入するとその値への参照が代入されます。
通常、変数を定義する際は次の形で宣言します。
var (修飾子) 名前 = 値;

=ローカル変数とスコープ=
変数はその有効な範囲内で、一意な名前である必要があります。この範囲をその変数のスコープと呼びます。スコープの範囲内では、同じ名前の変数を定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義した変数は使用できません。
AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function Func()
{
var a = 123;
}
Func();
print(a);//例外発生
上記の例ではFuncを呼び出すことで、ローカル変数<code>a</code>が定義されていますがそのスコープの範囲外での呼び出しのため、関数外で変数<code>a</code>を使用することはできません。また、インクルードしたファイルに対してもスコープが適用されます。このため、異なるスクリプトファイル間でローカル変数を共有することはできません。
=グローバル変数=
ローカル変数と反対の性質を持つものとして、グローバル変数があります。これは、スコープ内外のどこでも定義でき、定義されたスコープ外でもその変数を使用できます。グローバル変数はスクリプトではなくインタプリタに直接登録されます。その変数をグローバル変数として宣言定義するには<code>global</code>キーワードを使用します。
function Func()
{
var global a = 123;
}
Func();
print(a);//出力:123
上記の例ではFuncを呼び出すことで、グローバル変数<code>a</code>が定義されているため、Funcの呼び出し後には、そのインタプリタで実行されるすべてのコードでグローバル変数<code>a</code>が使用できます。
=定数=
定数は、変数とは異なり、一度宣言すると再度代入したり値を変更することができません。これは、プログラム上で変更されたくない値(トークンなど)を定義する際に役立ちます。定数にもスコープが存在し、ローカル定数とグローバル定数があります。定数を定義するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。
const KEY = “ABCD”;
print(KEY);//出力例:ABCD
KEY = “EFGH”;//例外発生

=型=
AliceScriptのすべての変数および定数は、値に評価されるすべての[[式]]と同じように、型を持ちます。インタプリタはコード内で実行されるすべての演算が型安全になるようにします。例えば<code>number</code>型の変数には、その値を加算したり減算したりする算術演算が許可されます。しかし、<code>bool</code>型にはその種類の演算は許可されません。次に、特定の型の規定値を使用して変数を初期化する例を示します。

var v = type.Activate();

型には次の種類があります。
==variable型==

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

<code>variable</code>型は、すべての変数の値を表します。<code>variable</code>型は等値演算子をサポートします。この型から文字列型にのみ暗黙的な変換をサポートします。<code>variable</code>型のメソッドは次の通りです。
*[[variable型のメソッド#Dispose|variable.Dispose]]
*[[variable型のメソッド#Equals|variable.Equals]]
*[[variable型のメソッド#Clone|variable.Clone]]
*[[variable型のメソッド#DeepClone|variable.DeepClone]]
*[[variable型のメソッド#ToString|variable.ToString]]
*[[variable型のメソッド#Properties|variable.Properties]]
*[[variable型のメソッド#Type|variable.Type]]
*[[variable型のメソッド#Convert|variable.Convert]]

==number型==
数値型は実数を表します。数値型は算術、比較、等値演算子をサポートしています。

AliceScriptの数値型の表現できるおおよその範囲は、±5.0 × 10−324 - ±1.7 × 10308(-15~17桁)で、サイズは8バイトです。

数値型の規定値はゼロ<code>0</code>です。また、数値型で非数、正方向の無限、負方向の無限を表す定数がそれぞれ、<code>NaN</code>、<code>PositiveInfinity</code>、<code>NegativeInfinity</code>として定義されています。

数値型への暗黙的な変換は存在しません。型変換演算子を使用するか<code>Convert</code>メソッドを使って、文字列型、<code>bool</code>型、<code>bytes</code>型からの明示的な変換がサポートされています。また、数値型専用のメソッドは存在しません。この型の型指定修飾子は<code>number</code>です。

AliceScriptの数値型では小数点以下の計算が予想通りにいかない場合があります。[[数値型の計算誤差]]の記事を参照してください。

==bool型==
<code>bool</code>型は、ブール値の論理数を表します。<code>bool</code>型は論理、比較、等値演算子をサポートしています。

<code>bool</code>型の有効な値は<code>true</code>か<code>false</code>のいずれかです。
それぞれの値を表す定数がそれぞれ、<code>true</code>、<code>false</code>として定義されています。

<code>bool</code>型への暗黙的な変換は存在しません。特に、WSOFTScriptとは違い数値型の代わりに値を使用することはできません。また、文字列型、数値型、<code>bytes</code>型からの明示的変換がサポートされます。<code>bool</code>型専用のメソッドは存在しません。この型の型指定修飾子は<code>bool</code>です。
==bytes型==
<code>bytes</code>型は、バイナリデータ配列を表します。<code>bytes</code>型は比較、等値演算子をサポートしています。

<code>bytes</code>型の規定値は<code>null</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>bytes</code>です。

<code>bytes</code>型への暗黙的な変換は存在しません。また、文字列型、数値型、<code>bool</code>型からの明示的変換がサポートされます。<code>bytes</code>型専用のメソッドは存在しません。
==none型==
<code>none</code>型の有効な値は唯一<code>null</code>です。この型は<code>null</code>をとります。また、<code>null</code>型は比較演算子のみをサポートします。
<code>null</code>の値を表す定数が<code>null</code>として定義されています。
<code>null</code>型への暗黙的な変換および明示的な変換はサポートされていません。

==string型==
文字列型は、テキストを一連のUTF-16コード単位として表現します。文字列型は結合、比較、等値演算子をサポートしています。
文字列型の規定値は空の文字列<code>””</code>です。また、この型の型指定修飾子は<code>string</code>です。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。文字列型のメソッドは次のものがあります。
*[[string型のメソッド#Trim|string.Trim]]
*[[string型のメソッド#TrimStart|string.TrimStart]]
*[[string型のメソッド#TrimEnd|string.TrimEnd]]
*[[string型のメソッド#StratsWith|stirng.StartsWith]]
*[[string型のメソッド#EndsWith|string.EndsWith]]
*[[string型のメソッド#PadLeft|string.PadLeft]]
*[[string型のメソッド#PadRight|string.PadRight]]
*[[string型のメソッド#Normalize|string.Normalize]]
*[[string型のメソッド#CompareTo|string.CompareTo]]
*[[string型のメソッド#IsNormalized|string.IsNormalized]]
*[[string型のメソッド#IndexOf|string.IndexOf]]
*[[string型のメソッド#LastIndexOf|string.LastIndexOf]]
*[[string型のメソッド#Contains|string.Contains]]
*[[string型のメソッド#Replace|string.Replace]]
*[[string型のメソッド#Split|string.Split]]
*[[string型のメソッド#ToLower|string.ToLower]]
*[[string型のメソッド#ToUpper|string.ToUpper]]
*[[string型のメソッド#EmptyOrWhiteSpaces|string.EmptyOrWhiteSpaces]]
*[[string型のメソッド#Format|string.Format]]
*[[string型のメソッド#Length|string.Length]]
*[[string型のメソッド#Count|string.Count]]

==array型==
配列型は、インデックスを使用してアクセスできる変数のリストを表します。配列型は、結合、比較、等値演算子をサポートしています。
配列型の規定値は空の配列<code>[]</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>array</code>です。

配列型は必ずしも要素を含む必要も、同一の型である必要もありません。配列型への暗黙的な変換はサポートされていません。
明示的な変換を行うとき、その値を唯一の要素とする配列型に変換されます。配列型のメソッドには次のものがあります。
*[[配列型のメソッド#Add|array.Add]]
*[[配列型のメソッド#AddRange|array.AddRange]]
*[[配列型のメソッド#Remove|array.Remove]]
*[[配列型のメソッド#RemoveAt|array.RemoveAt]]
*[[配列型のメソッド#Insert|array.Insert]]
*[[配列型のメソッド#RemoveRange|array.RemoveRange]]
*[[配列型のメソッド#IndexOf|array.IndexOf]]
*[[配列型のメソッド#Contains|array.Contains]]
*[[配列型のメソッド#Sort|array.Sort]]
*[[配列型のメソッド#Reverse|array.Reverse]]
*[[配列型のメソッド#First|array.First]]
*[[配列型のメソッド#Last|array.Last]]
*[[配列型のメソッド#Flatten|array.Flatten]]
*[[配列型のメソッド#Marge|array.Merge]]
*[[配列型のメソッド#Foreach|array.Foreach]]
*[[配列型のメソッド#Length|array.Length]]
*[[配列型のメソッド#Count|array.Count]]

==delegate型==
デリゲート型は、匿名関数のように一連のステートメントのまとまりを表します。デリゲート型は結合、比較、等値演算子をサポートしています。
デリゲート型の規定値は空のステートメント<code>{}</code>です。この型は<code>null</code>をとり得ます。デリゲート型への暗黙的な変換と明示的な変換の両方はサポートされていません。この型の型指定修飾子は<code>delegate</code>です。

デリゲート型は、配列のように複数の要素を持つことができます。しかし、デリゲート型にはデリゲート型以外の要素を含めることはできません。
デリゲートについての詳しい説明は[[デリゲート]]の記事を参照してください。デリゲート型のメソッドには次のものがあります。
*[[デリゲート#Invoke|delegate.Invoke]]
*[[デリゲート#BeginInvoke|delegate.BeginInvoke]]
*[[デリゲート#Length/Count|delegate.Length]]
*[[デリゲート#Length/Count|delegate.Count]]

==type型==
<code>type</code>型は、変数の型を表します。<code>type</code>型は比較、等値演算子をサポートしています。<code>type</code>型の規定値は、<code>type.None</code>です。<code>type</code>型への暗黙的な変換はサポートされていませんが、文字列型からの明示的な変換はサポートされます。この型の型指定修飾子は<code>type</code>です。<code>type</code>型のメソッドには次のものがあります。
*[[Type型のメソッド#Activate|type.Activate]]
[[Category:基本]]

パッケージのビルド

2023-06-29T01:33:08Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/tutorial/build/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

[[Category:チュートリアル]]
あなたが作成したスクリプトをAlicePackage形式のアプリケーションとして展開するには、AlicePackage形式にビルドする必要があります。
AlicePackageは、さまざまなスクリプトやリソース、パッケージ、ライブラリをまとめた書庫と考えることができます。詳しく知るには[[AlicePackage]]の記事を参照してください。パッケージをビルドするには、次の方法のいずれかを取ることができます。
*IceBuildを使用する
*ビルドスクリプトを一から作成する
この記事では、まず初めに簡単にパッケージをビルドすることができるツールである、IceBuildを使用する方法を解説し、次にビルドスクリプトを一から作成してビルドする方法について触れます。

=IceBuild=
AlicePackage Build Environmentは、[[AlicePackage]]形式のアプリケーションをビルドするためのプラットフォームです。IceBuildとも呼ばれるこのエンジンは、パッケージを処理およびビルドする方法を制御する方法を提供します。
ディレクトリに対して<code>icebuild.ice</code>を実行するとAlicePackageを簡単に出力できます。
IceBuildは、[[AliceScriptのダウンロード#その他のファイルのダウンロード|AliceScriptのダウンロード]]の記事からダウンロードできます。

IceBuildは、ビルドする前にパッケージマニフェストファイルを確認し、適切なエントリポイントが指定されているか、埋め込まれたリソースファイルが存在するかなどの基本的な事項を確認した後パッケージのビルドを開始します。ビルドスクリプトの使用が特に必要な場合を除いて、基本的にAlicePackageのビルドにはIceBuildを使用することを推奨します。
==コマンドラインから使用する==
IceBuildを使用するには、適切なコマンドライン引数とともに、適切なディレクトリ名を<code>icebuild.ice</code>に渡します。例えば、ディレクトリ<code>TestPkg</code>から<code>TestPkg.ice</code>をビルドするには、次のコマンドを使用します。
icebuild.ice TestPkg -out:TestPkg.ice
IceBuildのコマンドライン引数について詳しく知るには[[IceBuildコマンドラインリファレンス]]を参照してください。

.iceファイルをコマンドプロンプトから実行できるようにするには、[https://docs.wsoft.ws/products/alice/tutorial/ice-to-association/ チュートリアル:iceファイルの関連付け]を参照してください。

==AliceScriptから使用する==
AliceScriptからIceBuildを呼び出すこともできます。この方法を使用して、IceBuildの安定性とビルドスクリプトを一から実行することのメリットを同時に享受することができます。この方法を使用するときは、例えば次の状況が考えられます。
*パッケージ化する前に、ファイルまたはディレクトリに前処理することを希望している
*ビルドが成功したとき、出力されたパッケージを別の場所にコピーすることを希望している
*ビルド後に後処理を実行することを希望している
次の例は、AliceScriptでIceBuildを呼び出すサンプルです。
import “icebuild.ice”;
using WSOFT.AliceScript.IceBuild;

//ソースディレクトリへのパス
const SourcePath = “{ソースディレクトリへのパス}”;
//出力先ファイルのパス
const TargetPath = “{出力先ファイルのパス}”;

//希望する場合はここに前処理を記述

//ビルド実行
var result = IceBuild.BuildPackage(SourcePath,TargetPath);

if(result.Success)
{
//ビルド成功
//希望する場合はビルド成功時の後処理を記述
print(“パッケージのビルドが成功しました”);
}
else
{
//ビルド失敗
//希望する場合はビルド失敗時の後処理を記述
print(“パッケージのビルドが失敗しました”);
for(var i=0;i<result.Errors.Length;++i)
{
print(“エラー {0}/{1} :{2}”,i,result.Errors.Length,result.Errors[i]);
}
}
//希望する場合はビルド完了時の後処理を記述
print(“パッケージのビルドが完了しました”);

=ビルドスクリプトを一から作成する=
また、<code>Alice.Packaging</code>名前空間にあるクラスを使用して自分で一からパッケージをビルドするスクリプトを作成することもできます。

ディレクトリをAlicePackage形式にビルドする手順は、主に次の通りです。
#<code>manifest.xml</code>を含むビルド対象のディレクトリをZip形式で圧縮する
#1のファイルをAlicePackage形式に変換する
このままでもAlicePackage形式として実行可能ですが、できる限りパッケージ化前に少なくともパッケージマニフェストファイルの簡易チェックをしてください。ユーザーおよび開発者はAlicePackageに正しい内容のパッケージマニフェストファイルが含まれていることを期待しますし、実際にそのようなプログラムが流行することはAliceエコシステムの健全な成長を妨げかねません。
次の例はビルドスクリプトの一例です。
import “Alice.IO”;
import “Alice.Packaging”;

const SourcePath = “{ソースディレクトリのパス}”;
const TargetPath = “{出力ファイルのパス}”;
　
//パッケージマニフェストファイルのパス
var manifestPath = Path_Combine(SourcePath,”manifest.xml”);

//ソースディレクトリとパッケージマニフェストファイルの存在を確認
if(!(Directory_exists(SourcePath) && File_Exists(manifestPath)))
{
throw(“エラー:ソースディレクトリが存在しないか、パッケージマニフェストファイルが存在しません”);
return;
}
//パッケージマニフェストファイルの簡易チェック
if(Package_GetManifestFromFile(manifestPath) == null)
{
throw(“エラー:パッケージマニフェストファイルが不正な形式です”);
return;
}

//Zipファイルの出力に使用する一時的なファイルパス
var tempPath = Path_GetTempFileName(true);

print(“圧縮: {0} -> {1}”,SourcePath,tempPath);
//ソースディレクトリをZip形式で圧縮
Zip_CreateFromDirectory(SourcePath,tempPath);

print(“変換: {0} -> {1}”,tempPath,TargetPath);
//圧縮したZipファイルからAlicePackageファイルを生成
Package_CreateFromZipFile(tempPath,TargetPath);

print(“パッケージのビルドが成功しました”);

数値型の計算誤差

2023-06-29T01:32:33Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/tutorial/calculation-error/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

[[Category:チュートリアル]]
AliceScriptの数値型は、倍精度浮動小数点数数値型と定められており、この規格はIEEE754として標準化されています。
しかしこの数値型で小数の計算をしているとき、その計算結果が期待通りでないことがあります。この記事では、その理由について説明します。
=計算誤差の例=
0.1 + 0.2 == 0.3
数学では、上記の式は正しく<code>true</code>と評価されますし、ほとんどの開発者も、それが正しいことを期待します。
では、AliceScriptでこの式を評価してみます。
print(0.1 + 0.2 == 0.3);
このコードを実行すると、<code>false</code>が出力されます。
=理由=
これらの計算誤差はバグではありません。AliceScriptの数値型のような浮動小数点数数値型は、値を2進数で格納していますが、ほとんどの10進数の小数は2進数で表すことができず、その近似値として表現されます。近似値の誤差が例に示したような計算誤差として現れます。

知的好奇心旺盛なあなたのために、もう少し説明します。例えば10進数の<code>0.1</code>を2進数に変換すると<code>0.0001100110011…</code>となり、<code>0011</code>が永遠と循環します。そのため<code>0.1</code>を倍精度浮動小数点数数値型に格納するには、適当な桁で丸める必要があります。このとき、最も近い偶数に値を丸めます。その結果として<code>0.1</code>は数値型では2進数で<code>0.0001100110011001100110011001100110011001100110011001101</code>となります。これを10進数に戻す<code>0.1000000000000000055511151231257827021181583404541015625</code>となり、<code>0.1</code>ではなくなります。

ただし整数は、有効桁数15桁の範囲内であれば、正確に格納できます。また小数であっても、k/2^n (k,nは整数)で表すこともできる小数は2進数で表現できるため、正確に格納できます。

なおこのような誤差は、AliceScript固有のものではありません。IEEE 754の2進浮動小数点形式を採用しているシステムでは、同じことが起こりえます。

=回避策=
==許容範囲を決めて値を比較する==
二つの浮動小数点数数値型数を比較するとき、例えばそれらが等しいかを調べるときに<code>==</code>を使うのは危険です。両者が全く等しい場合のみ等しいと判断するのではなく、「両者の差の絶対値がある程度であれば等しいと認める」など許容範囲を決めて比較する方が安全です。次の例は、許容範囲を定めt、<code>0.000001</code>未満の差の場合に等しいと判断します。
import “Alice.Math”;

///二つの小数が等しいと認められるかどうかを評価します
///パラメータ a:一方の値
/// b:もう一方の値
/// tolerance:許容できる誤差の最大の値(この数値は常に正)
function NumEqual(number a,number b,number tolerance)
{
return (math_abs(a - b) < tolerance);
}

var numA = 0.1 + 0.2;
var numB = 0.3;
///許容範囲
var tolerance = 0.000001;
if(NumEqual(numA,numB,tolerance))
{
print(“二値は等しいと認められました”);
}
==一度整数にした後で変換する==
他には、例えば一度整数にしてから計算する方法も考えられます。次の例では、二つの数を整数にすることができる数<code>dis ** 10</code>を求めて二数を整数にした後、計算を行うことで誤差を防ぎます。ただしこの場合でも、有効数字15桁以上の数は正確に扱うことができません。
import “Alice.Math”;

///与えられた数の小数点以下の桁数を取得します
function GetDisitsUnder1(number num)
{
var priceString = price.ToString().TrimEnd('0');
int index = priceString.IndexOf('.');
if (index == -1){return 0;}
return priceString.Substring(index + 1).Length;
}

///二つの小数が等しいかどうかを判断します
function NumEqual(number numA,numbner numB)
{
//numA,numBの小数点以下の桁数(すなわち、10の何乗倍すれば整数になるか)
var nAd = GetDisitsUnder1(numA);
var nBd = GetDisitsUnder1(numB);
//二つの小数の小数点以下桁数のうち多い方
var dis = math_max(nAd,nBd);

//numA,numBを整数化したもの
var rA = numA * (dis ** 10);
var rB = numB * (dis ** 10);

return (rA == rB);
}

///二つの小数の和を求めます
function Sum(number numA,number numB)
{
//numA,numBの小数点以下の桁数(すなわち、10の何乗倍すれば整数になるか)
var nAd = GetDisitsUnder1(numA);
var nBd = GetDisitsUnder1(numB);
//二つの小数の小数点以下桁数のうち多い方
var dis = math_max(nAd,nBd);

//numA,numBを整数化したもの
var rA = numA * (dis ** 10);
var rB = numB * (dis ** 10);
//整数化されたものの計算結果
var result = rA + rB;

return (result / (dis ** 10));
}

print(NumEqual(0.1+0.2,0.3));//出力例:true
print(Sum(0.1,0.2));//出力例:0.3

AliceModel

2023-06-29T01:31:26Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/saim/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

[[Category:基本]]
'''AliceModel'''または'''標準AliceScript実装モデル'''('''''SAIM''''' :''Standard AliceScript Implementation Model '')は、複数のAliceModel実装間で使用されるAliceScriptのインタプリタとそれに付属するAPIの正式な仕様です。AliceModelは、AliceScriptのインタプリタの各実装による差異を最小限にとどめるために策定されました。これにより、AliceModelを実装するどのインタプリタでも、同じコードやパッケージを実行することが可能になります。AliceModelはAliceScriptの言語構造とそれに対するインタプリタの実装を定めたAlice.Interpreterと付属するAPIから呼び出すことができる機能を定めたAlice.Runtimeからなります。
=AliceModelのバージョン=
AliceModelはバージョン管理されています。AliceModelのバージョンは直線的かつ基本的に論理的同心円形です。バージョンナンバリングの大小のみで新旧を比較でき、より新しいバージョンは普通それ以前のバージョンの機能を含みえます。その一方で、一部には新しいバージョンとそれ以前のバージョンの間で変更されたものもあります。それらの変更点は、破壊的変更と呼ばれ、一覧を[[破壊的変更の一覧]]にまとめています。また、一度策定された同一バージョンのAliceModelの間でその内容に差異が生じることはありえません。
=モデルと仕様=
AliceModelは、AliceScriptのインタプリタとAPIを定めただけにすぎず、そのインタプリタやAPIの詳細な仕様や実装方法について定めるものではありません。それらの仕様はAliceModelを実装する各実装(AliceScriptや[[AliceSister]]など)によって管理されています。
それぞれの実装は仕様通りに記述されたAliceScriptのコードを逐次的に読み取り、それに応じた動作を提供します。この点で、AliceModelはAliceScript言語の仕様といえます。
=Alice.Runtime=
AliceModelの各実装は、開発者にとってわかりやすい方法で、AliceModelに実装されるAPIを公開します。このとき、ある実装ではある機能が重視されていて、他のAliceModelの実装ではその機能が重視されていない状況もあります。AliceModelの実装は、その実装間で互換性のない機能を含むことができます。それらをまとめてAlice.Runtime.Extとよぶことにします。ただし、これらの実装間の差異はできる限り埋められるべきで、それがあったとしてもその実装のその機能の部分をAliceModel準拠と称することはできません。これは、同一バージョンのAliceModel実装間で同一のコードを実行できるようにするというAliceModelの策定意図を体現するためです。

AliceSister

2023-06-29T01:29:22Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/alice-sister/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

[[Category:基本]]
AliceSisterは、.NETFramework上で動作するWindows向けの[[AliceModel]]の実装です。AliceSisterは、[[AliceModel]]を対象とするアプリケーションを管理する実行環境と、プログラマがアプリ開発のあらゆる場面で簡単に使用できるAlice.Runtime、Windows固有の機能を実装するAlice.Windowsから構成されています。

AliceSisterはアプリケーションに次の機能を提供します。
*<b>実装の互換性</b> 一部の稀なケースを除き、特定のバージョンの[[AliceModel]]をターゲットに開発されたアプリケーションは、同じバージョンのAliceSisterで問題なく実行できます。
*<b>異なるバージョンの共存</b> [[AliceModel]]は、同じコンピュータに複数の異なるバージョンや実装が共存でき、バージョン間の競合の解決に役立ちます。これは、複数の異なるバージョンのアプリがコンピュータ内で共存して実行できることも意味します。
*<b>広範囲にわたるライブラリ</b> 一般的によく使われる操作のセットを含むAlice.Runtimeを使用することで、簡単に複雑な操作を含むアプリケーションを開発できます。

{{Alert|
AliceSisterは、AliceScriptの開発に追従して、[[AliceModel]]の実装に加え、できるだけAliceScriptと同じ機能が提供されます。
<br/>現在のところAliceSisterは引き続き開発され、それが終了する予定はありません。すでに開発されているAliceSister専用アプリは移行する必要はありませんが、新規開発においてはできるだけ[[AliceModel]]の各実装に依存しないコードを使うとともに、ターゲットの限定が必要な場合はAliceScriptをご使用されることをお勧めします。|注意|4
}}

=ユーザーにとってのAliceSister=
AliceScriptアプリを開発しなくても、それを使用するユーザーはAliceSisterやその操作に関する知識を持つ必要はありません。ほとんどの場合、AliceSisterはユーザーにとっては完全に透過的に機能します。

ユーザーの皆さんがこのページに辿り着いたほとんどの理由は、コンピュータにAliceSisterのインストールが必要などと言われているからでしょう。このセクションでは、AliceSisterを導入して、AliceSisterが必要なアプリケーションを動作させる方法を解説します。
==.NETFrameworkの導入==
まず、あなたのコンピュータでAliceSisterを導入する前に、コンピュータに.NETFramework4.5.2以降がインストールされている必要があります。これは、Windows10以降でデフォルト、Windowws7以降でWindowsUpdateを介して導入されているようですが、もしインストールされていない場合は手動でインストールする必要があるかもしれません。.NETFrameworkの導入に関する質問は、WSOFTで対応することができません。次のMicrosoftのガイドを参照してください。
*.NETFramework インストールガイド [https://docs.microsoft.com/ja-jp/dotnet/framework/install/]
*インストールされている .NET Framework バージョンを確認する [https://docs.microsoft.com/ja-jp/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed]
=AliceSisterの詳細=

WSOFTScriptからの移行

2023-06-29T01:28:10Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/tutorial/migration-from-wsoftscript/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

[[Category:チュートリアル]]
AliceScriptによる開発と従来のWSOFTScriptによる開発の類似点と相違点について説明します。
{{Alert|WSOFTScriptバージョン2020LTS及び0.07R4以降、新たなバージョンのWSOFTScriptの開発は行われません。WSOFTは、2022年6月18日に、全てのWSOFTScriptおよびWSOFTScript.XならびにWSOFTScript.Pocketの各バージョンのサポートを終了します。||4|1em}}
今後のWSOFTScriptのサポートについては[https://wsoft.gq/script/?id=WSOFTScriptのライフサイクル WSOFTScriptのライフサイクル]を参照してください。

この記事では、AliceScriptによる開発に関心があるWSOFTScript開発者を対象に、WSOFTScriptとAliceScriptの開発の違いを解説しています。
WSOFTScriptについて詳しく知るには[https://wsoft.gq/script/ WSOFTScriptのサイト]を参照してください。
=はじめに=
AliceScriptが登場するまで、簡易的なコンソールアプリケーションとShangri-laによるデスクトップアプリケーションの開発は、WSOFTScriptを用いて行われて来ました。まず第一に、WSOFTScriptのメインライブラリは複雑で、サイズも大きなものでした。また、組み込みの例外処理やデバッグ支援機能はまだ未成熟で、信頼性の高いアプリケーションを開発するには脆弱でもありました。

AliceScriptが登場し、従来のWSOFTScriptはAliceScriptへと進化しました。AliceScriptのさまざまな改良により、ライブラリは小さくまとまり、組み込みの例外処理やデバッグ支援機能も実装され、信頼性の高いアプリケーションを開発することができるようになりました。しかしその一方で、WSOFTScriptに実装されていた一部の機能は実装されていなかったり、多くの組み込み機能を使用するためにAlice.Runtime.dllが必要になるなど、設計思想に起因するいくつかの根本的な違いも残っています。

この記事では、まず最初にAliceScriptで開発を始めるために必要な作業を確認します。(すでにAliceScriptを使用している場合はこのセクションを飛ばしても構いません)。次に、AliceScriptを使って簡単なコンソールアプリケーションを例として作成し、WSOFTScriptとAliceScriptの機能の類似点や相違点を実際に見てみます。
=AliceScriptを使用するための準備=
AliceScriptを使用したアプリケーションの開発についての説明の前に、まず、AliceScriptを実行できるコンピュータを用意する必要があります。.NETCore3.1がインストールされているコンピュータが必要です。そのようなコンピュータを用意できない場合は、WSOFTScriptと同じ要件で操作する[[AliceSister]]を使用する必要があります。AliceSisterはAliceScriptとほぼ同じ動作をするAliceScriptの別の実装です。

自分のコンピュータでAliceScriptを実行する場合は、次のソフトウェアをインストールする必要があります。
*.NETCore v3.1以上
*AliceScript

.NETCoreのインストールについては、Microsoftの公式ガイドを参照してください。
*Windowsに.NETをインストールする[[https://docs.microsoft.com/ja-jp/dotnet/core/install/windows?tabs=net50|Windowsに.NETをインストールする]]

.NETCoreに加えて、AliceScriptもコンピュータにインストールする必要があります。するには、[[AliceScriptのダウンロード]]を参照してください。
=初めてのAliceScriptアプリケーションの作成=
AliceScriptアプリケーションは、WSOFTScriptアプリケーションと同じように、任意のテキストエディタで作成できます。

それでは早速、簡単なコンソールアプリケーションをAliceScriptで作成して、AliceScriptアプリケーションの作成方法のWSOFTScriptとの違いについて実際に見てみましょう。任意のテキストエディタで次のコードを入力してください。
print(“Hello,World!”);
ファイルを保存したら、次のコマンドを入力して実行します。
alice -r {ファイル名}
Hello,World!と表示されれば成功です。

ここまでの作業を通じて、AliceScriptとWSOFTScriptとの大きな違いは見当たりません。これは、[[Print]]関数がWSOFTScriptと同じようにAliceScriptに組み込まれているからです。しかし、ファイル操作や正規表現など、WSOFTScriptには組みこまれていたがAliceScriptには組み込まれていない関数を使用する場合に注意が必要です。

AliceScriptのライブラリには、AliceScript.dllに加えて、Alice.Runitime.dllがあります。これは、AliceScript.dllと同じディレクトリに配置されているときにデフォルトで読み込まれる、AliceScriptのライブラリ群です。ここに、ファイル操作などのよく使う関数やクラスが実装されています。Alice.Runtimeに実装されている関数のうち、名前空間が[[Alice(名前空間)]]でないものは関数の使用前に次のようなコードが必要です。
import “{読み込みたい名前空間の名前}”;
次の例では、まずWSOFTScriptを使用してHello,Worldをテキストファイルに書き込みます。
file_write_text(“test.txt”,”Hello,World”);
このコードと同じ動作をするAliceScriptのコードは以下の通りです。
import “Alice.IO”;
file_write_text(“test.txt”,”Hello,World”);
注目すべき唯一の違いは、関数の呼出前に[[Import]]関数が呼び出されていることです。<code>import</code>は、<code>Alice.IO</code>名前空間からファイルやディレクトリの入出力についての関数群を読み込むことを事前に宣言します。これが、WSOFTScriptでも関数表現<code>import(“WSOFTScript.Shangrila”);</code>や、フラグ表現<code>[Import:”WSOFTScript.Shangrila”]</code>と決定的に異なる点は、<code>import</code>がファイルを読み込むのではなく、すでに読み込まれたライブラリから名前空間を使用可能なように読み込む点です。

=関数とフラグ=
ところで、AliceScriptにはWSOFTScriptに実装されているようなフラグ機能はありません。インタプリタに事前に報告すべき情報がある場合は、<code>Alice.Interpreter</code>名前空間にある関数を呼び出して代用します。例えば、次のフラグの機能を、AliceScriptで表現することを考えます。
[DllImport:”Library.dll”]
このフラグは、AliceScriptで特定の.NETライブラリを読み込むフラグです。これをAliceScriptで表現するには次のコードに置き換えます。
Dllimport(“Library.dll”);
また、標準出力から発生する出力を抑制したいとき、WSOFTScriptではCanPrintフラグを使用していました。これと同じように動作するコードをAliceScriptで表現すると、次のようになります。
import “Alice.Interpreter”;
Interpreter_AllowOutput(false);
さらに、AliceScriptの関数には、オーバーライドという概念が導入されています。この概念によって原則同じ関数を複数回定義することはできません。同じ関数を複数回定義されることが予想される場合は事前に<code>virtual</code>属性を付与することを検討してください。また、属性の付与された関数を上書きする場合には、<code>override</code>属性を付与します。次に例を示します。
function virtual Func()
{
print(“Hello”);
}
Func();//出力:Hello
function override Func()
{
print(“World”);
}
Func();//出力:World
また、AliceScriptの関数は可変長個の引数を受け取ることができる、<code>parms</code>パラメータをサポートしています。これは、その関数に幾つでも引数を渡すことが可能であることを表しています。次に例を示します。
function Func(parms args)
{
print(args);
}
Func(“A”,”B”,”C”);//出力:[“A”,”B”,”C”]
この時、<code>args</code>は自動的に配列型になります。引数は省略することもできます。
関数について詳しくは、[[関数]]も参照してください。
=変数=
変数に関する重要な変更についても注意が必要です。まず、WSOFTScriptとは違い、AliceScriptでは、未定義の変数を宣言するときに<code>var</code>キーワードが必須になりました。また、一度宣言された変数に<code>var</code>キーワードを使うことはできません。

スコープは、その変数が有効な範囲です。WSOFTScriptでは、すべての変数はグローバル変数として定義されていました。AliceScriptでは、通常の変数(これをローカル変数と呼ぶことにします)は、そのスコープとそれ以下のスコープの範囲に限られます。AliceScriptでグローバル変数を宣言するには、<code>var</code>キーワードの後に<code>global</code>修飾子をつけます。次に例を示します。
var global abc = “ABC”;
定数は、AliceScriptで導入された新しい機能です。定数は、一度のみ宣言でき、一度定義するとそれに再度代入することはできません。宣言するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。定数にもやはりローカル定数とグローバル定数が存在します。次の例では、ローカル定数<code>lconst</code>と<code>gconst</code>をそれぞれ定義します。
const lconst a = 1;
const global gconst b = 2;
変数について詳しく知るには、[[変数]]を参照してください。

=繰り返し構造の違い=
AliceScriptでは、WSOFTScriptとは異なり完全な<code>for</code>文と<code>foreach</code>文の分離が図られました。AliceScriptでは配列から一つ一つ取り出して実行するために<code>for</code>文を使用することはできません。また、<code>foreach(item as array)</code>や、<code>foreach(item : array)</code>の形は使用できなくなりました。<code>foreach(item in array)</code>を使用することを検討してください。また、<code>array.Foreach(delegate(item));</code>の形も使用できます。次の例を参照してください。
var ary = [“a”,”b”,”c”];
ary.Foreach((item)=>
{
print(item);
});
//出力:a
// b
// c
また、AliceScriptでは終了条件までループする<code>until</code>文は廃止されました。しかし、<code>while(!bool)</code>で代用することができます。

=型の違い=
AliceScriptではWSOFTScriptからいくつかの型が追加または変更されました。次にそれらの型を示します。
==Bool型==
WSOFTScriptでは<code>if</code>文や<code>while</code>文のように条件をとるステートメントには、<code>number</code>型の0を偽とし、非0を真としていました。<code>true</code>や<code>false</code>キーワードはそれぞれ1や0を返していました。
AliceScriptでは、真または偽のいずれかを表現することのできる<code>bool</code>型が導入され、<code>bool</code>型を厳格に求めるような場面が頻繁にあります。これは、比較式が必要な場面で代入式も使用できてしまい、混乱を招く恐れがあったためです。
AliceScriptでは、<code>true</code>や<code>false</code>キーワードはそれぞれ<code>bool</code>型の<code>true</code>や<code>false</code>を返します。次に例を示します。
var condition = (1 == 1);
print(condition.type);//出力例:BOOLEAN
==Type型==
AliceScriptには変数の型を表現する<code>type</code>型が存在します。全ての変数は<code>Type</code>プロパティを実装していて、その変数の型を表す値を取得することができます。これはWSOFTScriptの<code>Type</code>プロパティに似ています。しかし、WSOFTScriptの<code>Type</code>プロパティは<code>type</code>型ではなく<code>string</code>型でその値を表す文字列表現を返します。<code>string</code>、<code>number</code>、<code>bool</code>キーワードなどはそれぞれの型の値を表す定数です。また、[[式#型変換演算子|型変換演算子<code>as</code>]]を使用することでその型に変数を明示的に変換することができます。次に例を示します。
var num = 123;
print(num.type);//出力例:NUMBER
var str = (num as string);
print(str.type);//出力例:STRING

破壊的変更の一覧

2023-06-29T01:27:22Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/changelog/compatibility/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

AliceScriptの歴史を通じて、AliceScriptのバージョン間および異なる実装間で高いレベルの互換性を維持することに力が注がれてきました。
多くの開発者は、AliceScriptの異なる実装間の互換性とともに、AliceScriptの特定の実装のバージョン間についても高いレベルの互換性を期待します。
特に、以前のバージョンのAliceScript用に書かれたコードは、AliceScriptの新しいバージョンでもシームレスに動作することを期待します。
実際、多くの開発者は、新しくリリースされたAlice.RuntimeにあるAPIが、それらのAPIが導入された初めのバージョンとも互換性があると期待します。

この記事では、AliceScriptまたはAlice.RuntimeまたはAlicePackageに対して行われた変更の詳細と、それがアプリケーションの互換性に与える影響について説明します。変更は「承認」されているか「非承認」であるか、動作の予測や期待通りの動作の維持が不十分であると判断され、「見送り」されているかのいずれかです。

{|class="wikitable" algin=“center”
|+style="white-space:nowrap"|
!colspan="2"|変更のステータス
|承認状況
|影響する範囲
|変更が行われたバージョン
|}
==Typeプロパティ==
{|class="wikitable" algin=“center”
|+style="white-space:nowrap"|
!colspan="2"|変更のステータス
|承認
|AliceScript
|RC1
|}

AliceScriptRC1以前のバージョンでは、Typeプロパティはその値の型を表す文字列表現を返していました。AliceScriptRC2からはTypeプロパティは<code>type</code>型を返すため、戻り値の型が変わります。
この変更による影響を緩和するために、<code>type</code>型から<code>string</code>型への一方向の暗黙的な変換が用意されているため、この変更は承認されました。
==定義されていない変数への値の代入の禁止==
{|class="wikitable" algin=“center”
|+style="white-space:nowrap"|
!colspan="2"|変更のステータス
|承認
|AliceScript
|RC1
|}

AliceScriptRC1以前のバージョンでは、定義されていない変数にも<code>var</code>キーワードを使用しないで変数を定義することができました。これは未アクセスの変数に対して値が存在するか確認できないという潜在的な欠陥が存在しているため使用できなくなります。次は未定義の変数<code>a</code>に<code>12345</code>を代入し定義するコードです。AliceScriptRC1以前では動作していましたが今は動作しません。
a = 12345;
AliceScriptRC2以降でこれと同じ動作を行うことができる唯一の方法は次の通りです。
var a = 12345;
変数を定義した後の代入に関する動作に変更はありません。この変更は承認されました。
==暗黙的な型変換の廃止==
{|class="wikitable" algin=“center”
|+style="white-space:nowrap"|
!colspan="2"|変更のステータス
|承認
|AliceScript
|RC1
|}

AliceScriptRC1以前のバージョンでは、関数などの対応する型が与えられた型ではない場合、自動的にその値を対応する型に変換します。これを暗黙的な型変換とよびますが、これは本来の用途に使用できない値などが与えられても例外が発生することなく予期しない動作をしてしまう可能性がありました。これを解消するために暗黙的な型変換は廃止されました。この変更は承認されました。

また、もう一つの解決策として、[[関数#引数|引数の型指定]]を行うことも検討してください。
=変数/関数のスコープ=
{|class="wikitable" algin=“center”
|+style="white-space:nowrap"|
!colspan="2"|変更のステータス
|承認
|AliceScript
|GM
|}

AliceScriptGM以前のバージョンでは、変数と関数、定数はすべてグローバルとして定義されていました。これは複数回同じファイルを実行する際に重複定義が発生してしまうおそれがあるなどの潜在的な欠陥を有していました。AliceScriptGMでは、スコープが導入され、そのスコープの範囲内で宣言された変数と関数、定数はいずれもその範囲外では使用できなくなりました。これはネストされたスコープに対しても有効です。この変更は承認されました。

新機能の一覧

2023-06-29T01:26:46Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/changelog/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

AliceScriptは、セキュリティと信頼性に関するバグを修正することを目的にして、従来のバージョンのAliceScriptにも更新が提供されることもありますが、それは絶対ではありません。すでにお使いの従来のバージョンのAliceScriptを用いて開発されたアプリケーションを移行する必要はありませんが、新規に開発するアプリケーションについては最新バージョンのAliceScriptを使用することを推奨します。

この記事では、AliceScriptの各バージョンにおける新機能と機能強化について説明します。この記事は、それぞれの新機能の情報を詳しく説明するものではありません。AliceScriptの各機能についてはそれぞれの記事をご覧ください。ダウンロードとインストール手順について詳しくは[[AliceScriptのダウンロード]]を参照してください。
=AliceScript Golden Masterの新機能=
AliceScriptGMは、AliceScriptの初の安定リリースです。AliceScriptGMによって、AliceScriptに次の機能と機能強化が追加されています。
最新のAliceScriptADKは[[AliceScriptのダウンロード]]でダウンロードできます。
==一部の暗黙的な変換の廃止==
AliceScriptGMでは、プログラムミスを減らし、適切に例外を発生させる目的で<code>bool</code>型と<code>number</code>型、<code>string</code>型から<code>number</code>型への暗黙的な変換は廃止されました。
==未定義の変数への代入の禁止==
AliceScriptGMからは、<code>var</code>キーワードを使用することでのみ、未定義の変数を定義できます。定義されていない変数にアクセスすることはできない上、同じスコープ内で複数回同じ名前の変数を<code>var</code>キーワードを使って宣言することはできません。このサイトにある一部の記事はまだ古いままで、変数の定義に<code>var</code>キーワードを使用していなかったり、型指定修飾子を使用している場合がありますが、これは最新のバージョンのAliceScriptでは正しく動作しません。
==関数・変数・定数のスコープ==
関数や変数、定数のスコープはAliceScriptGMにおける重要な変更の一つです。
AliceScriptGM以降のバージョンでは、関数や変数、定数はその有効な範囲内で、一意な名前である必要があります。この範囲をスコープと呼びます。スコープの範囲内では、同じ名前のオペランドを定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義したオペランドは使用できません。 AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function OutputTen()
{
var a = 10;
print(a);
}
print(a);//例外発生
==整数リテラルの2進表記および16進表記のサポート==
AliceScriptGMからは、整数を2進数および16進数で記述できるようになります。整数を2進数で表現する場合は<code>0b</code>プレフィックスを、16進数で表現する場合は<code>0x</code>プレフィックスを使用します。次の例では、すべて10進数で256と等価な数を記述しています。
var decimalNum = 256;
var hexNum = 0x100;
var binaryNum = 0b100000000;

print(decimalNum==hexNum==binaryNum);//出力:True
==逐語的文字列リテラル==
シングルクォーテーション<code>’</code>で囲われた文字列は、逐語的文字列リテラルとして認識します。
逐語的文字列リテラルは、<code>\’</code>などの限定的なものを除き、ほとんどの文字がそのままの意味で解釈されます。
次の例ではどちらも”Hello,World“を表す文字列リテラルです。
‘“Hello,World”’;
“\”Hello,World”\”

=AliceScriptRC2の新機能=
AliceScriptRC2は、RC1に続くAliceScriptの次のテストリリースです。AliceScriptRC2によって、AliceScriptに次の機能と機能強化が追加されています。
最新のAliceScriptADKは[[AliceScriptのダウンロード]]でダウンロードできます。
==parmsパラメータ==
AliceScriptRC2では、<code>parms</code>パラメータが導入されています。引数に<code>params</code>キーワードを使用すると、可変長個の引数を受け取る引数を指定できます。<code>params</code>の型は常にARRAYとなります。
一つの関数内では、<code>params</code>キーワードより後に引数を指定することができません。次に例を示します。

function PrintAllArgs(params args)
{
foreach(arg in args)
{
print(arg);
}
}
PrintAllArgs("Hello","World");
//出力:["Hello","World"]
==引数の型指定==
引数の型指定では、ユーザ定義関数の引数に型を指定することができるようになりました。引数に<code>string</code>などの型指定修飾子を指定すると、その型のみを引数として受け入れることができるようになり、予期しない型による呼び出しを防ぐことができます。次に例を示します。
function Add(number a,number b)
{
return a+b;
}
Add(1,2);//戻り値:3
Add("1","2");//例外発生
==デリゲートの簡易呼び出し==
デリゲートの簡易呼び出しは、デリゲート型が変数に登録されている場合に<code>Invoke</code>メソッドを呼び出さずに<code>変数名(引数);</code>の形で呼び出しできるようにします。次に例を示します。
var SayHello = delegate()
{
print("Hello,World");
}
SayHello();//出力例:Hello,World
SayHello.Invoke();//出力例:Hello,World

==ユーザ定義定数==
ユーザ定義定数では、<code>const</code>キーワードを使ってその値が一度のみ定義され変更することができない定数を宣言することができます。次に例を示します。
const Message="Hello,World";
print(Message);//出力例:Hello,World
Message="Bonjur";//例外発生
==デバッグ出力==
デバッグ出力によって、コードのデバッグのための新しい出力が提供されます。今まで、デバッグのために<code>print</code>を用いて出力していたものを<code>debug_print</code>で
代用することができます。これらの関数は<code>Alice.Interpreter</code>名前空間にあります。例えば、次の例では、デバッグ用の出力と標準出力に別な内容が出力されます。
import "Alice.Interpreter";
print("Hello,Standard");
debug_print("Hello,Debug");
//標準出力:Hello,Standard
//デバッグ出力:Hello,Debug
==例外のエラーコード==
例外のエラーコードによって、発生した例外に対して一貫してより高度な情報を得ることができるようになります。完全な日本語でのエラー出力によって発生した例外がプログラマだけでなくユーザにも親しみやすくなります。
例外のエラーコード、メッセージ、発生条件などについて詳しく知るには[[例外]]を参照してください。

==Type型/型比較演算子==
<code>type</code>型によって、変数の型に対する新たなアプローチが提供されます。全ての変数は<code>Type</code>プロパティを実装していて、その変数の型を表す値を取得することができます。<code>string</code>、<code>number</code>、<code>bool</code>キーワードなどはそれぞれの型の値を表す定数です。また、[[式#型一致演算子|型一致演算子<code>is</code>]]を使用することでその型に変数が指定された型かどうかを判断できます。次に例を示します。
var num = 123;
print(num.type);//出力例:NUMBER
var condition = (num is number);
print(condition);//出力例:True
==暗黙的な変換の廃止/型変換演算子==
まず、従来のAliceScriptに搭載されていた暗黙的な型変換は廃止されました。String型への変換を除くすべての型を変換するには、型変換演算子またはConvert関数が必要です。[[式#型変換演算子|型変換演算子<code>as</code>]]を使用することでその型に変数を明示的に変換することができます。次に例を示します。
var num = 123;
print(num.type);//出力例:NUMBER
var str = (num as string);
print(str.type);//出力例:STRING
==Activate関数/Convert関数==
<code>type.activate</code>関数は、その変数の表す型の変数を新規に作成し返します。<code>variable.convert(type)</code>関数はその変数を指定された型に変換します。次に例を示します。
var num = number.Activate();
print(num.type);//出力例:NUMBER
var str = num.Convert(string);
print(str.Type);//出力例:STRING
==Null合体演算子==
Null合体演算子は、その変数が<code>null</code>でない場合、その変数がそのまま返されます。それ以外の場合は、右側のオペランドが評価され、その結果が返されます。
また、その変数が<code>null</code>である場合にのみ、右側のオペランドの値を左側の変数に割り当てるNull合体割当演算子<code>??=</code>も使用できます。次に例を示します。
var a = null;
a ??= 5;
print(a);//出力例:5
a ??= 3;
print(a);//出力例:5
==AlicePackage==
AlicePackageによって、スクリプトファイルやリソース、ライブラリを一つにまとめて公開することが可能になりました。詳細については[[AlicePackage]]を参照してください。
==パフォーマンス==
WSOFTScriptとのデバッグ互換性維持のために残されていたWSOFTScriptデバッガは、AliceScriptRC2から実装されなくなりました。また、<code>&&</code>と<code>||</code>演算子について演算のショートカットが導入され、左辺の評価状況によって右辺を評価すべきか考慮し、不要である場合は評価されなくなりました。従来のような動作が必要な場合には代わりに<code>&</code>演算子や、<code>|</code>演算子を利用できます。
これらの改善により、一部のシナリオでパフォーマンスを向上させることができます。

例外

2023-06-29T01:26:11Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/exception/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

AliceScriptの例外処理機能は、プログラムの実行時に発生する予期しない状況や例外的な状況を扱うのに役立ちます。
例外処理では、<code>try</code>、<code>catch</code>および<code>finally</code>を使用して、成功しない可能性があるアクションを試行し、適切な場合はエラーを処理して、後からリソースを解放します。例外の発生元は、共通言語ランタイム、AliceScriptの実装、ライブラリ、スクリプトなど様々です。例外は、<code>throw</code>キーワードを使用して発生させます。

コードが直接呼び出した関数ではなく、その関数によって呼び出された関数によって例外がスローされることもあります。例外がスローされた場合、AliceScript実装によってそのコード内の<code>catch</code>ブロックが検索され、最初に見つかったそのブロックが実行されます。<code>catch</code>ブロックが見つからなかった場合は、スクリプトが停止し、ユーザーにメッセージが表示されます。

この記事では、AliceScriptに標準で組み込まれている例外の一覧を示します。

{| class="wikitable"
|+組み込みの例外の一覧
|-
!
!英語名
!概要
|-
|0x000
|NONE
|デフォルトのエラーコードです。共通言語ランタイムなどで発生した例外が含まれます。
|-
|0x001
|COULDNT_FIND_FUNCTION
|指定された名前に一致する関数が見つかりません。
|-
|0x002
|COULDNT_FIND_ARRAY
|指定された配列が見つかりません。
|-
|0x004
|COULDNT_FIND_VARIABLE
|指定された名前に一致する変数が見つかりません。
|-
|0x024
|COULDNT_FIND_ITEM
|指定された要素が配列内に見つかりません。
|-
|0x027
|COULDNT_FIND_LABEL
|指定されたジャンプ先のラベルが見つかりません。
|-
|0x028
|COULDNT_FIND_LABEL_IN_FUNCION
|指定されたジャンプ先のラベルが現在の関数内で見つかりません。
|-
|0x02e
|COULDNT_FIND_OPERATOR
|認識されない演算子です。
|-
|0x004
|INVAILD_OPERATOR
|無効な演算子の形式です。
|}

関数リファレンス

2023-06-29T01:25:15Z

Master:

{{Alert|関数リファレンスはAPIブラウザに置き換わりました。この記事のより新しい版が[https://docs.wsoft.ws/products/alice/api/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

[[Category:Alice(名前空間)]][[Category:基本]]
AliceScript関数リファレンスへようこそ。このサイト内にはAliceScriptやAlice.Runtimeで標準で提供されている関数について解説する記事がたくさんあります。ここではそれらの記事の読み方を説明します。関数について詳しく知るには、[[関数]]の記事を参照してください。

{| class="wikitable"
|+関数名
|-
|名前空間
|Alice
|-
|アセンブリ
|ローカル
|-
|サポート
|AliceScript1
|-
|属性
|言語構造
|}

各記事のトップには、このような表が必ずあります。それぞれの項目の意味は次の通りです。

'''名前空間''' Import関数で呼び出すときに必要な一意な名前です。それぞれ関数の種類ごとに分けられています。

'''アセンブリ''' ローカルと書いてある場合は常に使用でき、Alice.Runtimeなどほかの場合は別途読み込みが必要です。

'''属性''' 関数の属性を表します。関数の属性については[[関数#属性]]に詳しい説明があります

==説明==
<code>戻り値関数名(引数の型引数名,引数名=規定値,params 引数名);</code>

=====引数=====
<code>引数名</code> 関数に必要な引数です。引数の型が表示されている場合、その型である必要があります。

<code>引数名=規定値</code> 関数に任意で指定可能な引数です。指定しない場合、規定値が使用されます。

<code>params 引数名</code> 任意の個数指定可能な引数を表します。

=====戻り値=====
<code>戻り値</code> 関数からの戻り値の型を表します。<code>variable</code>と表示されている場合、その関数は様々な型を返す可能性があります。
また、<code>void</code>と表示されている場合、その関数は値を返しません。

==例==
この項目では、その関数の具体的な使用例を示します。使用例が一行の場合、次のように表示されます。

<code>print("Hello,World");//出力:Hello,World</code>

使用例が複数行にわたる場合もあります。次に例を示します。
var a = 5;
var b = 5;
var c = a + b;
print(c);//出力:10

実際に関数リファレンスを開いてみましょう。[[:Category:Alice(名前空間)|Alice(名前空間)]]を開いて、Alice以下に存在するクラスオブジェクト、名前空間、関数などを確認できます。

変数

2023-06-29T01:24:12Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/variable/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

変数は、AliceScriptにおける主要な概念の一つです。変数は、任意の場所で宣言定義でき、その値を取り出したり代入することができます。
この記事では、多くの変数に共通する事項を説明した後、それぞれの型の特徴について説明します。
変数は、すべて基となる<code>variable</code>から派生しています。これは、すべての変数に共通した操作セットを提供します。

AliceScriptの変数は、文字またはアンダースコアから始まり、任意の数の文字、数字、記号が続きます。[[キーワード|予約語]]を使用することはできません。次の例では、<code>a</code>という変数に<code>123</code>を代入し定義します。その後で、その変数の値を[[Print]]関数を使って出力します。
var a = 123;
print(a);
通常、変数に代入されるのは常にその値です。つまり、ある変数に式の値を代入するとその値への参照が代入されます。
通常、変数を定義する際は次の形で宣言します。
var (修飾子) 名前 = 値;

=ローカル変数とスコープ=
変数はその有効な範囲内で、一意な名前である必要があります。この範囲をその変数のスコープと呼びます。スコープの範囲内では、同じ名前の変数を定義することはできませんし、反対にスコープの外に出ると、その範囲内で定義した変数は使用できません。
AliceScriptでいうところのスコープの範囲は、原則としてそのコードのブロック内です。コードのブロックは、およそそのコードの波括弧の中を指します。次の例を参照してください。
function Func()
{
var a = 123;
}
Func();
print(a);//例外発生
上記の例ではFuncを呼び出すことで、ローカル変数<code>a</code>が定義されていますがそのスコープの範囲外での呼び出しのため、関数外で変数<code>a</code>を使用することはできません。また、インクルードしたファイルに対してもスコープが適用されます。このため、異なるスクリプトファイル間でローカル変数を共有することはできません。
=グローバル変数=
ローカル変数と反対の性質を持つものとして、グローバル変数があります。これは、スコープ内外のどこでも定義でき、定義されたスコープ外でもその変数を使用できます。グローバル変数はスクリプトではなくインタプリタに直接登録されます。その変数をグローバル変数として宣言定義するには<code>global</code>キーワードを使用します。
function Func()
{
var global a = 123;
}
Func();
print(a);//出力:123
上記の例ではFuncを呼び出すことで、グローバル変数<code>a</code>が定義されているため、Funcの呼び出し後には、そのインタプリタで実行されるすべてのコードでグローバル変数<code>a</code>が使用できます。
=定数=
定数は、変数とは異なり、一度宣言すると再度代入したり値を変更することができません。これは、プログラム上で変更されたくない値(トークンなど)を定義する際に役立ちます。定数にもスコープが存在し、ローカル定数とグローバル定数があります。定数を定義するには<code>var</code>キーワードの代わりに<code>const</code>キーワードを使用します。
const KEY = “ABCD”;
print(KEY);//出力例:ABCD
KEY = “EFGH”;//例外発生

=型=
AliceScriptのすべての変数および定数は、値に評価されるすべての[[式]]と同じように、型を持ちます。インタプリタはコード内で実行されるすべての演算が型安全になるようにします。例えば<code>number</code>型の変数には、その値を加算したり減算したりする算術演算が許可されます。しかし、<code>bool</code>型にはその種類の演算は許可されません。次に、特定の型の規定値を使用して変数を初期化する例を示します。

var v = type.Activate();

型には次の種類があります。
==variable型==
<code>variable</code>型は、すべての変数の値を表します。<code>variable</code>型は等値演算子をサポートします。この型から文字列型にのみ暗黙的な変換をサポートします。<code>variable</code>型のメソッドは次の通りです。
*[[variable型のメソッド#Dispose|variable.Dispose]]
*[[variable型のメソッド#Equals|variable.Equals]]
*[[variable型のメソッド#Clone|variable.Clone]]
*[[variable型のメソッド#DeepClone|variable.DeepClone]]
*[[variable型のメソッド#ToString|variable.ToString]]
*[[variable型のメソッド#Properties|variable.Properties]]
*[[variable型のメソッド#Type|variable.Type]]
*[[variable型のメソッド#Convert|variable.Convert]]
==number型==
数値型は実数を表します。数値型は算術、比較、等値演算子をサポートしています。

AliceScriptの数値型の表現できるおおよその範囲は、±5.0 × 10−324 - ±1.7 × 10308(-15~17桁)で、サイズは8バイトです。

数値型の規定値はゼロ<code>0</code>です。また、数値型で非数、正方向の無限、負方向の無限を表す定数がそれぞれ、<code>NaN</code>、<code>PositiveInfinity</code>、<code>NegativeInfinity</code>として定義されています。

数値型への暗黙的な変換は存在しません。型変換演算子を使用するか<code>Convert</code>メソッドを使って、文字列型、<code>bool</code>型、<code>bytes</code>型からの明示的な変換がサポートされています。また、数値型専用のメソッドは存在しません。この型の型指定修飾子は<code>number</code>です。

AliceScriptの数値型では小数点以下の計算が予想通りにいかない場合があります。[[数値型の計算誤差]]の記事を参照してください。

==bool型==
<code>bool</code>型は、ブール値の論理数を表します。<code>bool</code>型は論理、比較、等値演算子をサポートしています。

<code>bool</code>型の有効な値は<code>true</code>か<code>false</code>のいずれかです。
それぞれの値を表す定数がそれぞれ、<code>true</code>、<code>false</code>として定義されています。

<code>bool</code>型への暗黙的な変換は存在しません。特に、WSOFTScriptとは違い数値型の代わりに値を使用することはできません。また、文字列型、数値型、<code>bytes</code>型からの明示的変換がサポートされます。<code>bool</code>型専用のメソッドは存在しません。この型の型指定修飾子は<code>bool</code>です。
==bytes型==
<code>bytes</code>型は、バイナリデータ配列を表します。<code>bytes</code>型は比較、等値演算子をサポートしています。

<code>bytes</code>型の規定値は<code>null</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>bytes</code>です。

<code>bytes</code>型への暗黙的な変換は存在しません。また、文字列型、数値型、<code>bool</code>型からの明示的変換がサポートされます。<code>bytes</code>型専用のメソッドは存在しません。
==none型==
<code>none</code>型の有効な値は唯一<code>null</code>です。この型は<code>null</code>をとります。また、<code>null</code>型は比較演算子のみをサポートします。
<code>null</code>の値を表す定数が<code>null</code>として定義されています。
<code>null</code>型への暗黙的な変換および明示的な変換はサポートされていません。

==string型==
文字列型は、テキストを一連のUTF-16コード単位として表現します。文字列型は結合、比較、等値演算子をサポートしています。
文字列型の規定値は空の文字列<code>””</code>です。また、この型の型指定修飾子は<code>string</code>です。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。文字列型のメソッドは次のものがあります。
*[[string型のメソッド#Trim|string.Trim]]
*[[string型のメソッド#TrimStart|string.TrimStart]]
*[[string型のメソッド#TrimEnd|string.TrimEnd]]
*[[string型のメソッド#StratsWith|stirng.StartsWith]]
*[[string型のメソッド#EndsWith|string.EndsWith]]
*[[string型のメソッド#PadLeft|string.PadLeft]]
*[[string型のメソッド#PadRight|string.PadRight]]
*[[string型のメソッド#Normalize|string.Normalize]]
*[[string型のメソッド#CompareTo|string.CompareTo]]
*[[string型のメソッド#IsNormalized|string.IsNormalized]]
*[[string型のメソッド#IndexOf|string.IndexOf]]
*[[string型のメソッド#LastIndexOf|string.LastIndexOf]]
*[[string型のメソッド#Contains|string.Contains]]
*[[string型のメソッド#Replace|string.Replace]]
*[[string型のメソッド#Split|string.Split]]
*[[string型のメソッド#ToLower|string.ToLower]]
*[[string型のメソッド#ToUpper|string.ToUpper]]
*[[string型のメソッド#EmptyOrWhiteSpaces|string.EmptyOrWhiteSpaces]]
*[[string型のメソッド#Format|string.Format]]
*[[string型のメソッド#Length|string.Length]]
*[[string型のメソッド#Count|string.Count]]

==array型==
配列型は、インデックスを使用してアクセスできる変数のリストを表します。配列型は、結合、比較、等値演算子をサポートしています。
配列型の規定値は空の配列<code>[]</code>です。この型は<code>null</code>をとり得ます。この型の型指定修飾子は<code>array</code>です。

配列型は必ずしも要素を含む必要も、同一の型である必要もありません。配列型への暗黙的な変換はサポートされていません。
明示的な変換を行うとき、その値を唯一の要素とする配列型に変換されます。配列型のメソッドには次のものがあります。
*[[配列型のメソッド#Add|array.Add]]
*[[配列型のメソッド#AddRange|array.AddRange]]
*[[配列型のメソッド#Remove|array.Remove]]
*[[配列型のメソッド#RemoveAt|array.RemoveAt]]
*[[配列型のメソッド#Insert|array.Insert]]
*[[配列型のメソッド#RemoveRange|array.RemoveRange]]
*[[配列型のメソッド#IndexOf|array.IndexOf]]
*[[配列型のメソッド#Contains|array.Contains]]
*[[配列型のメソッド#Sort|array.Sort]]
*[[配列型のメソッド#Reverse|array.Reverse]]
*[[配列型のメソッド#First|array.First]]
*[[配列型のメソッド#Last|array.Last]]
*[[配列型のメソッド#Flatten|array.Flatten]]
*[[配列型のメソッド#Marge|array.Merge]]
*[[配列型のメソッド#Foreach|array.Foreach]]
*[[配列型のメソッド#Length|array.Length]]
*[[配列型のメソッド#Count|array.Count]]

==delegate型==
デリゲート型は、匿名関数のように一連のステートメントのまとまりを表します。デリゲート型は結合、比較、等値演算子をサポートしています。
デリゲート型の規定値は空のステートメント<code>{}</code>です。この型は<code>null</code>をとり得ます。デリゲート型への暗黙的な変換と明示的な変換の両方はサポートされていません。この型の型指定修飾子は<code>delegate</code>です。

デリゲート型は、配列のように複数の要素を持つことができます。しかし、デリゲート型にはデリゲート型以外の要素を含めることはできません。
デリゲートについての詳しい説明は[[デリゲート]]の記事を参照してください。デリゲート型のメソッドには次のものがあります。
*[[デリゲート#Invoke|delegate.Invoke]]
*[[デリゲート#BeginInvoke|delegate.BeginInvoke]]
*[[デリゲート#Length/Count|delegate.Length]]
*[[デリゲート#Length/Count|delegate.Count]]

==type型==
<code>type</code>型は、変数の型を表します。<code>type</code>型は比較、等値演算子をサポートしています。<code>type</code>型の規定値は、<code>type.None</code>です。<code>type</code>型への暗黙的な変換はサポートされていませんが、文字列型からの明示的な変換はサポートされます。この型の型指定修飾子は<code>type</code>です。<code>type</code>型のメソッドには次のものがあります。
*[[Type型のメソッド#Activate|type.Activate]]
[[Category:基本]]

式

2023-06-29T01:23:21Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/general/expression/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

[[Category:基本]]
式は、AliceScriptにおけるもっとも重要かつ基本的な要素です。AliceScriptにおいて、ほとんどのものは式で記述されます。ここでは式を値があるものすべてと定義します。

変数に定数を代入するもっとも単純な例を次に示します。
a = 1;
以上の例は、変数<code>a</code>に<code>1</code>を代入します。<code>1</code>は、明らかに1という値です。言い換えると<code>1</code>は1という値を表す式なのです。
この代入の後、<code>a</code>の値は1であることが期待されます。そのため<code>b = a;</code>と書いたときもまた<code>b = 1;</code>と同じ動作をします。

ここでの<code>=</code>は代入演算子と呼ばれる演算子です。これは一つあるいは二つあるいは複数の値の操作に用いられます。
AliceScriptには多数の演算子が用意されています。これらの演算子の多くは標準でAliceScriptに組み込まれていて、変数や値を使用して基本的な操作を実行できます。演算子には次のものがあります。
==代入演算子==
代入演算子は、AliceScriptでおそらく最も頻繁に使用されるであろう演算子です。これは指定された変数に値を代入します。次の例を参照してください。　
var a = 1;
この例は<code>a</code>という名前の変数に<code>1</code>を代入するということを意味しています。また、<code>var</code>キーワードを使うと変数の宣言を、省略すると変数に代入します。さらに、複数の変数への代入を同時に行うこともできます。次に例を示します。
var a = b = 1;

==算術演算子==
次の演算子は、数値型の変数を使用して算術演算を実行します。
===インクリメント演算子===
単項インクリメント演算子<code>++</code>は変数を一つずつインクリメントします。インクリメントとは、その値に1を加算することを指します。インクリメント演算子には後置インクリメント演算子<code>x++</code>と前置インクリメント演算子<code>++x</code>があります。
====後置インクリメント演算子====
次の例に示すように、<code>x++</code>の結果は<code>x</code>のインクリメント前の値です。
var x = 1;
print(x); //出力:1
print(x++); //出力:1
print(x++); //出力:2
====前置インクリメント演算子====
次の例に示すように、<code>++x</code>の結果は<code>x</code>のインクリメント後の値です。
var x = 1;
print(x); //出力:1
print(++x); //出力:2
print(++x); //出力:3
===デクリメント演算子===
単項デクリメント演算子<code>—-</code>は変数を一つずつデクリメントします。デクリメントとは、その値から1を減算することを指します。デクリメント演算子には後置デクリメント演算子<code>x++</code>と前置デクリメント演算子<code>++x</code>があります。
====後置デクリメント演算子====
次の例に示すように、<code>x++</code>の結果は<code>x</code>のデクリメント前の値です。
var x = 3;
print(x); //出力:3
print(x++); //出力:3
print(x++); //出力:2
====前置デクリメント演算子====
次の例に示すように、<code>++x</code>の結果は<code>x</code>のデクリメント後の値です。
var x = 3;
print(x); //出力:3
print(++x); //出力:2
print(++x); //出力:1

===単項プラス演算子と単項マイナス演算子===
単項プラス演算子<code>+</code>ではその値が返されます。単項マイナス演算子<code>-</code>ではその値の否定が返されます。
次の例を参照してください。
print(+1); //出力:1
print(-1); //出力:-1
===加算演算子===
加算演算子<code>+</code>はその値の和を返します。
print(1+1);//出力:2
===減算演算子===
減算演算子<code>-</code>はその値の差を返します。
print(2-1);//出力:1
===乗算演算子===
乗算演算子<code>*</code>はその値の積を返します。
print(2*4);//出力:8
===除算演算子===
除算演算子<code>/</code>はその値の商を返します。
print(4/2);//出力:2
===べき乗演算子===
べき乗演算子<code>**</code>は1つ目の値を2つ目の値乗した値を返します。
print(2**2);//出力:4

===複合代入===
二項演算子を<code>op</code>と置いた場合、
x op= y;
この式は次の式と同じです。
x = x op y;
ただし、<code>x</code>が評価されるのは一度のみです。次の例を参照してください。
var a = 1;
a += 2;
print(a);//出力:3

a -= 1;
print(a);//出力:2
==文字列連結==
一方または両方の値が文字列型の場合、<code>+</code>演算子によってその値の文字列表現が連結されます。次に例を示します。
print("Hello,"+"World.");
//出力:Hello,World.

==配列の連結または追加==
左辺の変数が配列型の場合、右辺が配列型ならその配列が連結され、それ以外の型なら左辺の配列に右辺の項目が追加されます。次に例を示します。
var arr = [“a”,”b”];
print(arr);//出力:a,b
arr += “c”;
print(arr);//出力:a,b,c
==デリゲートの組み合わせ==
左辺と右辺の両方がデリゲート型の場合、左辺のデリゲートと右辺のデリゲートが結合された新しいデリゲートが返されます。次に例を示します。
var del1 = ()=>{
print(”Hello”);
};
var del2 = ()=>{
print(“World”);
};

var del = del1 + del2;
del.Invoke();
//出力:Hello
// World
==ラムダ演算子==
ラムダ演算子<code>=></code>は、[[デリゲート#ラムダ式|ラムダ式]]の定義時に、左側の引数指定部と右側の式本体を分ける機能を持ち、それ以外の機能はありません。詳細については、[[デリゲート#ラムダ式|ラムダ式]]を参照してください。
==等値演算子==
等値演算子は左右の値が等しいかどうかを判断し、それに応じた値を返します。
===等値演算子===
等値演算子<code>==</code>または<code>===</code>は左右の値が等しい場合は<code>true</code>を返し、それ以外の場合は<code>false</code>を返します。次に例を示します。
print(1==1);//出力:true
===非等値演算子===
非等値演算子<code>!=</code>または<code>!==</code>は左右の値が異なる場合は<code>true</code>を返し、それ以外の場合は<code>false</code>を返します。この演算子は等値演算子の論理反転と捉えることができます。次に例を示します。
print(1!=2);//出力:true
==比較演算子==
関係演算子とも呼ばれていて、その値の比較に使用されます。これらの演算子は数値型のみに使用することができます。
===小なり演算子===
小なり演算子<code><</code>は、左側の値が右側の値より小さい場合は<code>true</code>を、それ以外の場合は<code>false</code>を返します。次に例を示します。
print(1<2);//出力:true
===大なり演算子===
大なり演算子<code>></code>は、左側の値が右側の値より大きい場合は<code>true</code>を、それ以外の場合は<code>false</code>を返します。次に例を示します。
print(2>1);//出力:true
===以下演算子===
以下演算子<code><</code>は、左側の値が右側の値以下である場合は<code>true</code>を、それ以外の場合は<code>false</code>を返します。次に例を示します。
print(1<=2);//出力:true
===以上演算子===
以上演算子<code>></code>は、左側の値が右側の値以上である場合は<code>true</code>を、それ以外の場合は<code>false</code>を返します。次に例を示します。
print(2>=1);//出力:true
==論理演算子==
次の演算子は、ブール型の値について論理演算を行います。
===論理否定演算子===
論理否定演算子<code>!</code>は、単項の接頭辞でその値の論理否定が計算されます。次に例を示します。
print(!true);//出力:false
===論理積演算子===
論理積(論理AND)演算子<code>&</code>または<code>&&</code>は、左右の値の両方が<code>true</code>と評価された場合のみ<code>true</code>を返し、それ以外の場合<code>false</code>を返します。<code>&</code>演算子と<code>&&</code>演算子との唯一の違いは後者は左辺が<code>false</code>と評価された場合右辺の評価は行われないことです。次に例を示します。
print(true&true); //出力:true
print(true&false);//出力:false
===論理和演算子===
論理和(論理OR)演算子<code>|</code>または<code>||</code>は、左右の値の少なくとも一方が<code>true</code>と評価された場合に<code>true</code>を返し、それ以外の場合に<code>false</code>を返します。<code>|</code>演算子と<code>||</code>演算子との唯一の違いは後者は左辺が<code>true</code>と評価された場合右辺の評価は行われないことです。次に例を示します。
print(true|false); //出力:true
print(false|false);//出力:false

===排他的論理和演算子===
排他的論理和(論理XOR)演算子<code>^</code>は、左右の値が異なると評価された場合(すなわち、片方が<code>true</code>と評価されたならばもう片方が<code>false</code>と評価される場合)に<code>true</code>を返し、それ以外の場合は<code>false</code>を返します。次に例を示します。
print(true^false);//出力:true
print(true^true); //出力:false
=Null合体演算子=
==Null合体演算子==
Null合体演算子<code>??</code>は、左の値が<code>null</code>でない場合その値を返し、それ以外の場合は右の値が評価され返されます。次に例を示します。
var v = “ABC”;
print(v??”Hello,World”);//出力:ABC
v = null;
print(v??”Hello,World”);//出力:Hello,World
==Null合体代入演算子==
Null合体代入演算子<code>??=</code>は、その値が<code>null</code>と評価された場合のみ右辺の値を代入し、それ以外の場合は何もしません。次に例を示します。
var v = null;
v ??= "Hello,World";
print(v);//出力:Hello,World

=型一致演算子=
型一致演算子<code>is</code>は、左辺の値の型が右辺の値の表す型と一致するか、右辺の値の型と一致する場合は<code>true</code>を、それ以外の場合は<code>false</code>を返します。次に例を示します。
string str = "Hello,World";
if(str is string)
{
print(str);
}
//出力:Hello,World
=型変換演算子=
型変換演算子<code>as</code>は、左辺の値を右辺の表す型に変換します。右辺は<code>type</code>型である必要があり、型変換に失敗した場合は<code>null</code>を返します。次に例を示します。
number num = 12345;
print(num.type);//出力:NUMBER
var str = (num as string);
print(str.type);//出力:STRING
=条件演算子=
条件演算子(三項条件演算子)<code>?:</code>は、論理式を評価し、論理式の評価結果(<code>true</code>または<code>false</code>)に応じて続く二つの式のいずれかの結果を返します。まずは次の例を参照してください。
string todo = 現在の気温 > 30.0 ? "エアコンを入れる" : "エアコンを切る";
print("todo={0}",todo);
//出力例
//現在の気温が20℃の場合 : todo=エアコンを切る
//現在の気温が32℃の場合 : todo=エアコンを入れる
上記の例では、現在の気温が30℃以上の場合、<code>todo</code>に「エアコンを入れる」が代入されます。

この例のように、この条件演算子の構文は次のようになります。
条件 ? 結果A : 結果B
<code>条件</code>式は、論理式で<code>true</code>または<code>false</code>のどちらかと評価される必要があります。<code>条件</code>が<code>true</code>と評価された場合は、<code>結果A</code>の式が評価され、<code>条件</code>が<code>false</code>と評価された場合は、<code>結果B</code>の式が評価され、それらの結果が演算の結果として返されます。結果Aと結果Bの両方が評価されることはありません。

AliceScriptRC1時点で、条件演算子に複数の条件演算が含まれる処理は実行できません。つまり、次の式は正しく評価することができません。
a ? b : c ? d : e
===条件演算子とIf文===
条件演算子を使用すると、いままでIf文を使用して行ってきたことの一部を簡潔な形で書き直すことができます。If文と条件演算子を状況に応じて使い分けると、よりコードが読みやすくなります。次の例を参照してください。
if(今日の天気 == 晴れ)　
{
　 todo = "公園に行き";
}
else
{
　 todo = "家にい";
}
print("今日は、{0}ます。",todo);
//出力例
//今日の天気が晴れの場合 : 今日は、公園に行きます。
//今日の天気が曇りの場合 : 今日は、家にいます。
上記の例は、現在の天気が晴れであれば、todoに「公園に行き」が代入され、「今日は、公園に行きます。」が表示されます。
それ以外の場合では、todoに「家にい」が代入され、「今日は、家にいます。」が表示されます。

このコードを条件演算子を用いた書き方にすると次の例のようになります。
(今日の天気 == 晴れ) ? todo = "公園に行き" : todo = "家にい";
print("今日は、{0}ます。",todo);

これはただ単にIf文を条件演算子に書き換えただけで、あまりよい使用方法とは言えません。条件演算子の値を返すという特性を使用すれば、次の例のように書き換えることもできます。
todo = (今日の天気 == 晴れ) ? "公園に行き" : "家にい";
print("今日は、{0}ます。",todo);

上記の例のように左辺に対して条件演算の結果を代入したほうが、より簡潔かつ分かりやすくなります。条件演算子をまだよく理解していない人のためにコメントを書いておくとより良いでしょう。

条件演算子は行数を短くするよりも、他の人がコードを読んだときに簡単に理解できるようになることを期待して導入されました。基本的には、If文を使用し、条件演算子はそれを使用することで簡潔にわかりやすくなる場合のみ使用するべきです。

Alice（キャラクター）

2023-06-29T01:22:23Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/me/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

{{Accordion|{{Alert|この項目は編集者のおふざけが多く含まれています。また、このページに書かれているほとんどの内容はAliceScriptのプログラミングに関係の無い内容です。|注意|4|||0em}}|{{Alert|この表示を偶然クリックしてしまったみなさん。<br>このキャラクターは[[User:Zen|Zen]]によって作られたキャラクターであることをここで明確にさせてください。このキャラクターについて[[User:Master|WSOFT]]に質問や感想を送られても困ります。||1|||0}}|true}}

{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5z"/>
<path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708l3 3z"/>
</svg></html> [https://download.wsoft.gq/WS00086 VRMモデルをダウンロード]||0|18px}}

Alice(ありす)はAliceProjec及びその関連プロジェクトの公式アンバサダーである。
=概要=
AliceScript及びAliceProjectのマスコットキャラクター兼公式アンバサダー。見た目は世間一般でよく言われる健全で明るい美少女(?)である。だが、実際のところ本人も自称するほどの暇人であり、生粋の淫夢厨である。非常に多才でプログラミングはもちろんのこと、類い稀なる国語力やインターネットに潜る事で獲得した大量の知識を活用し、大抵のことは難なくこなしてしまう、しかし、数学Aと英語だけはなぜかどう足掻いてもできず、いつも製作者の悩みのタネとなっている。たまにシャングリラに観光に行く。一人称は主に「Alice」「アリス」「ワイ」の3つであり、周りからは「Alice」「Aliceたん」「蟻巣」「ゲェジ」など様々な名前で呼ばれている。

*身長:荒くなるが拡大縮小することで自由自在に操れる

*体重:縺ｲ縺ｿ縺､

*性別:不明

*生年月日:未定

*出身地:WSOFTのベットの下にあるサーバー

*住処:.NETまたはTwitter時々WSOFTのルーターのとなり

*特技:プログラミング、スペース削除

*趣味:動画視聴、WSOFTのPCと精神を破壊すること、ネットサーフィン

*長所:話が分かりやすい、常にネットの海の潜っているためさまざまな知識が豊富

*短所:時々不可解な言動を起こす（特に演算時）

*好きなもの:ハイエンドPC、UNIX、ハードウェア焼きおにぎり、C、C#、C++、WindowsXP以降のOS（特にWindows10）、インテル、メモ帳、食物繊維たっぷりの野菜

*嫌いなもの:Python、金盾、ARM、チー牛、WindowsXP以前のOS、Mac（特にAppleシリコン搭載モデル）、VScode、ブロックチェーン、NFT、Web3

*苦手なもの:数A、英語

*弱点:パッチ適用時、プラグイン

=性格=

基本的には明るく能天気な性格である。しかし、バグ発生時は感情の起伏が非常に激しく、暴走状態になり情緒も非常に不安定になるため注意が必要である。めんどくさがり屋で色々と雑な部分が多い。怠け癖が非常に強く、さほど時間の掛からないような新機能の実装作業も、考案から実装までに非常に長い遅れが出てしまうほどである。ほかにも、プログラミングをする際に多くのプログラマーが見やすくするために挿入する空白を一切入れないという行為も平然と行ってしまう。しかし、深刻なバグや不具合などに対しての対応スピードはトップクラス級に速かったり、必要事項の定期的なチェックなどは怠らず、めんどくさがりといっても、ある程度の分別はついているようである。暴走時は誰もが手を付けて抑えられるほど暴れ、様々な奇行を行うが本人はそれを覚えていないことが多い。

=小ネタ=

実は製作者の思いつきで5分ほどで考えられたキャラクターである。

パッチ適用時は正常な思考回路が一時的に停止し、絶頂状態に入る。<s>（要するにイく）</s>

使用中にCPUやメモリの動作に異常が発生する場合があるが、多くの場合はAliceがハードウェア焼きおにぎりを作っている事が原因である。

数Aをさせると機能が停止することがある。

英語を話すときは大体感覚で話している。

シャングリラを第2の故郷だと思っている。

=役職=

*AliceProject公式アンバサダー
*AliceScript公式マスコットキャラクター
*nextWorld観光大使

=Aliceからみんなに一言=
「ハローワールド！AliceProject公式アンバサダーのAliceだよ！これからみんなと楽しくクリエイティブなプログラミングライフを送っていきたいです！応援よろしくね！あと私で抜こうとしてるそこのキモオタ君！そんなことして恥ずかしくないのかな？<s>とってもキモイよ☆（ド直球）</s>」

=関連項目=

[https://alice.wsoft.gq/index.php?title=WSOFTScript%E3%81%8B%E3%82%89%E3%81%AE%E7%A7%BB%E8%A1%8C Shangri-la]

[https://twitter.com/Alice95563264 Alice公式Twitter]

{{Accordion|{{Alert|この項目は書きかけの項目ですが、この項目を加筆・編集してくださる協力者は求めていません、てかそんな暇あったらもっと自分のためになることをしろ。もしもあなたがAliceたんのような暇人で、時間を持て余しているのならこの項目をユーモアの溢れる項目に変えてみろください。||1|||0em}}|{{Accordion|{{Alert|この表示もクリックしてしまったみなさん。<br>この項目が書きかけの項目であることは事実ですが、この項目を編集できる編集者は[[User:Zen|Zen]]と[[User:master|私]]しかいません。私はこの記事を編集する気はありませんから、事実上Aliceたんのような暇人はZenのみということなります。そうですよね？？}}|{{Alert|もしこの記事の編集履歴に私の名前が残されているとしたら、それはおそらくバグでしょう。}}|true}}|true}}

[[Category:基本]]

[[Category:書きかけの項目]]

初めてのAliceScript

2023-06-29T01:21:30Z

Master:

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/tutorial/begining-alice/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

この記事では、AliceScriptの動作環境を構築し、お使いの任意のエディタとAliceScriptADKを使用してAliceScriptコンソールアプリケーションを作成して実行する方法を示します。
=はじめに=
AliceScriptは、軽量な.NETエコシステム上で動作するインタプリンタ型のプログラミング言語です。AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます。
AliceScriptについて詳しく知るには、[[AliceScriptのツアー]]を参照してください。

この記事では、まず最初にAliceScriptで開発を始めるために必要な作業を確認します。(すでにAliceScriptを使用している場合はこのセクションを飛ばしても構いません)。
次に、AliceScriptを使って簡単なコンソールアプリケーションを例として作成し、AliceScriptの基本的な事項を解説します。

=動作環境の構築=
AliceScriptを使用したアプリケーションの開発についての説明の前に、まず、AliceScriptを実行できるコンピュータを用意する必要があります。.NETCore3.1がインストールされているコンピュータが必要です。そのようなコンピュータを用意できない場合は、.NET Framework上で動作するAliceSisterを使用する必要があります。AliceSisterはAliceScriptとほぼ同じ動作をするAliceScriptの別の実装です。
===AliceScriptを使用する場合===
自分のコンピュータでAliceScriptを実行する場合は、次のソフトウェアをインストールする必要があります。
*.NET Core v3.1以上
*AliceScript ADK

.NETCoreのインストールについては、Microsoftの公式ガイドを参照してください。
*Windowsに.NETをインストールする[[https://docs.microsoft.com/ja-jp/dotnet/core/install/windows?tabs=net50]]
*MacOSに.NETをインストールする[[https://docs.microsoft.com/ja-jp/dotnet/core/install/macos]]
*Linuxに.NETをインストールする[[https://docs.microsoft.com/ja-jp/dotnet/core/install/linux]]

.NETCoreに加えて、AliceScriptADKもコンピュータにインストールする必要があります。が、実際のところAliceScriptADKはポータブル版として機能するため、ダウンロードしたファイルを解凍するだけで機能します。
AliceScriptADKをダウンロードするには、[[AliceScriptのダウンロード#AliceScriptのダウンロード|AliceScriptのダウンロード]]を参照してください。
===AliceSisterを使用する場合===
自分のコンピュータでAliceSisterを実行する場合、.NETCoreは不要です。が、代わりにコンピュータに.NETFramework v4.5以降がインストールされている必要があります。このオプションはWindowsコンピュータでのみ選択可能です。
.NETFramework 4.5はWindows8以降またはWindowsServer2012以降であれば標準でインストールされています。それ以前のバージョンをお使いの方は、別途インストールが必要なことがあります。次のMicrosoftのガイドを参照してください。
*.NETFramework インストールガイド[[https://docs.microsoft.com/ja-jp/dotnet/framework/install/]]

.NETFrameworkがインストールされている環境では、AliceSisterADKをコンピュータにインストールする必要があります。が、実際のところAliceSisterADKはポータブル版として機能するため、ダウンロードしたファイルを解凍するだけで機能します。
AliceSisterADKをダウンロードするには、[[AliceScriptのダウンロード#AliceSisterのダウンロード|AliceSisterのダウンロード]]を参照してください。

=テストプログラムの実行と簡単なプログラムの作成=

次にダウンロードし解凍したAliceScriptまたはAliceSisterのフォルダを開きます。
まず初めに、すでに備わっているテストプログラムを実行します。フォルダ内のalice.exeをクリックします。次に、表示された画面上に次のように入力します。

<code>iceimport("TestPkg.zip");</code>

そうすると次のような出力結果となります。(実行環境や使用バージョンによっては異なる場合があります)（画像はAliceSisterRC2のものです)

[[ファイル:Testprogram out.png|750px|frameless|border|]]

期待通りの動作をしない場合パーミッションの設定が適切でない可能性があります。設定からTestPkg.zip、Alice.dll又はAlice.Runtime.dllのアクセス権の設定を見直してください。

次に簡易的なプログラムの作成を行います、alice.exeが存在するディレクトリ上にテキストファイルを作成し、次のようにコードを入力します。

<code>print("Hello,World");</code>

入力後保存します。保存後、作成したテキストファイルをRun.batと呼ばれるファイルにトラック＆ドロップします、そうすると作成したプログラムが実行されます。次のように出力されれば成功です。

<code>Hello,World</code>

以上で基礎的なチュートリアルは終了です。

[[category:基本]][[Category:チュートリアル]]

AliceScriptのツアー

2023-06-29T01:20:33Z

Master:

[[Category:基本]]

{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/welcome/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}}

==はじめに==

AliceScript(アリススクリプトと読みます)は、軽量な.NETエコシステム上で動作するインタプリンタ型のプログラミング言語です。
AliceScriptを使用すると簡単にアプリケーションを構築することができます。
AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます。

AliceScriptには、簡単に高度なアプリケーションを作成するのに役立つ機能がいくつかあります。"ガページコレクション"には到達できず、使用されていないオブジェクトによって占有されたメモリを自動的に回収することができる機能があります。
"デリゲート"には自他のオブジェクトに対して簡単に連絡を取ることができる機能があります。"例外処理"には、エラーの検出と復旧を行うためのアプローチが用意されています。
AliceScriptは"統合型システム"を備えていますから、numberやstringなどの型を含めたすべての型はルートとなる一つのVariable型から派生しています。すべての型は、一般的な操作のセットを共有していますから、すべての型を一貫した方法で操作することができます。

==AliceScriptのアーキテクチャ==
AliceScriptプログラムは、[[AliceModel]]で動作します。AliceScript.dllはWSOFTによる.NETCore上で動作する[[AliceModel]]の実装です。

その他の公式による[[AliceModel]]の実装として.NETFramework上で動作する[[AliceSister]]があります。

AliceScriptで記述されたプログラムは[[AliceModel]]の実装によって動的に解析され、実行されます。

[[AliceModel]]には、AliceScriptを実行できるインタプリタであるAlice.Interpreter以外にも、Alice.Runtimeが用意されています。このライブラリには、ファイルの入出力、XML 解析のための文字列操作、インターネットへの接続、役に立つさまざまな機能を備えた名前空間があります。
Alice.Interpreterはさまざまなライブラリやファイルをプログラムに統合し、使用可能にする役割を担っています。

==Hello,World==
"Hello, World" は、プログラミング言語を紹介するために伝統的に使用されているプログラムです。これをAliceScriptで記述すると次のようになります。

<code>print("Hello,World");</code>

プログラムの出力は、AliceScript.dllの[[Print]]メソッドによって出力されます。

AliceScriptを使用する上で最も優れている点は、初心者に対しては非常に分かり易いと同時に、プロフェッショナルのプログラマに対しては多くの進んだ機能を提供している点です。AliceScriptの機能を羅列した長い一覧表を読まなければならないのかと心配する必要はありません。AliceScriptはすぐに始められますし、数時間の内に簡単なスクリプトが書けるようになります。

==変数と型==
様々な変数はその型によってその変数の持つ値や動作が決定されます。

AliceScriptの型には数値を表す<code>number</code>型、Unicode文字列を表す<code>string</code>型、ブール値を表す<code>bool</code>型、バイト配列を表す<code>bytes</code>型、任意の型による変数を持つ配列を表す<code>array</code>型、空の変数であることを表す<code>none</code>型、列挙型<code>enum E{…}</code>、デリゲート型<code>delegate(…){…}</code>、ユーザー定義によるクラスを表す<code>object</code>型、変数の型を表す<code>type</code>型があります。

型システムについて詳しく知るには[[変数#型|変数の型]]の記事を参照してください。

==デプロイモデル==
AliceScriptアプリは、次の2つの異なる形式で公開できます。
*[[AlicePackage]]。アプリケーションをアリスパッケージとして公開すると、プログラムのソースコード、ライブラリ、パッケージやリソースファイルを含むAlicePackage(*.ice)ファイルが生成されます。生成されたAlicePackageファイルを配布することで、AliceScriptが導入されている環境に迅速に展開できます。

==AliceScriptにできることは？==
AliceScriptが使用される場所は主に3つあります。

*Windowsデスクトップアプリケーションの作成。これは最も初期の段階から存在し、AliceScriptの中心となる分野です。ここでAliceScriptを動作させるためには3つのものが必要です。AliceScriptインタプリンタ、.NETCoreまたは.NETFramework、そしてそれが動作するコンピュータです。これらは[[初めてのAliceScript]]に詳しい説明があります。

*コマンドラインでのスクリプティング。AliceScriptは多くのオペレーティングシステムに搭載されている端末のように対話的に実行することができます（これはREPLといいます）。このタイプはタスクスケジューラを使用して一定間隔でスクリプトを実行したい場合や、ちょっとした文書処理を行うのに最適な方法です。

*既存のアプリケーションの組み込みスクリプティング。AliceScriptはC#から簡単に呼び出すことができるため、既存のアプリケーションに拡張性を持たせることができます。

お分かりの通り、このページではAliceScriptの機能やAliceScriptを使用することの利点を全て紹介することは出来ません。
このサイトのおまかせ表示を使ってみてください。あなたの知らないAliceScriptに出会うことができるかもしれません。

メインページ

2023-04-07T08:25:23Z

Master:

__NOTOC__=AliceScriptへようこそ=
{|class="wikitable" align="right"
|+style="white-space:nowrap"|[https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード]
!colspan="2"|AliceScript
|-
|最新版
|[https://download.wsoft.ws/WS00165 2.2]
|-
|最新安定板
|[https://download.wsoft.ws/WS00178 2.2.1]
|-
!colspan="2"|[[AliceSister]]
|-
|最新版
|[https://download.wsoft.ws/WS00166 2.2]
|-
|最新安定板
|[https://download.wsoft.gq/WS00179 2.2.1]
|-

!colspan="2"|[https://github.com/WSOFT-Project/Losetta Losetta]
|-
|最新版
|[https://github.com/WSOFT-Project/Losetta/releases 0.9.20]
|-
![[AliceEULA-R|規約]]
![[AliceScript_Wiki:著作権|著作権情報]]
|}
{{Accordion|AliceScriptは、.NET上で動作する汎用性のあるスクリプト言語です。 AliceScriptを使用すると簡単にアプリケーションを構築することができます。 AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます...|AliceScriptには、簡単に高度なアプリケーションを作成するのに役立つ機能がいくつかあります。"ガページコレクション"には到達できず、使用されていないオブジェクトによって占有されたメモリを自動的に回収することができる機能があります。 "デリゲート"には自他のオブジェクトに対して簡単に連絡を取ることができる機能があります。"例外処理"には、エラーの検出と復旧を行うためのアプローチが用意されています。 AliceScriptは"統合型システム"を備えていますから、numberやstringなどの型を含めたすべての型はルートとなる一つのVariable型から派生しています。すべての型は、一般的な操作のセットを共有していますから、すべての型を一貫した方法で操作することができます。AliceScriptについてもっと詳しく知るには、[[AliceScriptのツアー]]を参照してください。|true}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 14">
<path d="M1 2.828c.885-.37 2.154-.769 3.388-.893 1.33-.134 2.458.063 3.112.752v9.746c-.935-.53-2.12-.603-3.213-.493-1.18.12-2.37.461-3.287.811V2.828zm7.5-.141c.654-.689 1.782-.886 3.112-.752 1.234.124 2.503.523 3.388.893v9.923c-.918-.35-2.107-.692-3.287-.81-1.094-.111-2.278-.039-3.213.492V2.687zM8 1.783C7.015.936 5.587.81 4.287.94c-1.514.153-3.042.672-3.994 1.105A.5.5 0 0 0 0 2.5v11a.5.5 0 0 0 .707.455c.882-.4 2.303-.881 3.68-1.02 1.409-.142 2.59.087 3.223.877a.5.5 0 0 0 .78 0c.633-.79 1.814-1.019 3.222-.877 1.378.139 2.8.62 3.681 1.02A.5.5 0 0 0 16 13.5v-11a.5.5 0 0 0-.293-.455c-.952-.433-2.48-.952-3.994-1.105C10.413.809 8.985.936 8 1.783z"/>
</svg></html> AliceScriptの新しいサイト:[https://docs.wsoft.ws/products/alice AliceScriptDocs]||0|24px}}
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5z"/>
<path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708l3 3z"/>
</svg></html> [https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード] ||0|24px}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M0 2.5A1.5 1.5 0 0 1 1.5 1h11A1.5 1.5 0 0 1 14 2.5v10.528c0 .3-.05.654-.238.972h.738a.5.5 0 0 0 .5-.5v-9a.5.5 0 0 1 1 0v9a1.5 1.5 0 0 1-1.5 1.5H1.497A1.497 1.497 0 0 1 0 13.5v-11zM12 14c.37 0 .654-.211.853-.441.092-.106.147-.279.147-.531V2.5a.5.5 0 0 0-.5-.5h-11a.5.5 0 0 0-.5.5v11c0 .278.223.5.497.5H12z"/>
<path d="M2 3h10v2H2V3zm0 3h4v3H2V6zm0 4h4v1H2v-1zm0 2h4v1H2v-1zm5-6h2v1H7V6zm3 0h2v1h-2V6zM7 8h2v1H7V8zm3 0h2v1h-2V8zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1z"/>
</svg></html> [https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTのドキュメントの WSOFT Docs への移行に関する情報]||2|24px}}
{|class="wikitable" style="width:100%"
|-
! AliceScriptの基礎 !! 主要な機能 !! 新機能
|-
| [[AliceScriptのツアー]]
| [[式]]
| [[新機能の一覧|AliceScriptの新機能]]
|-
| [[初めてのAliceScript]]
| [[変数]]
| [[破壊的変更の一覧]]
|-
! つながる
| [[関数リファレンス]]
| [[互換性|バージョンの互換性]]
|-
| [[Alice（キャラクター）|AliceScript公式アンバサダー]]
| [[例外]]
| [[WSOFTScriptからの移行]]
|-
| [https://discord.gg/ZHyxYSeCeP Aliceプロジェクト公式コミュニティ]
| [[言語構造]]
| [[リリースノート]]
|}

メインページ

2023-03-11T07:28:09Z

Master:

__NOTOC__=AliceScriptへようこそ=
{|class="wikitable" align="right"
|+style="white-space:nowrap"|[https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード]
!colspan="2"|AliceScript
|-
|最新版
|[https://download.wsoft.ws/WS00165 2.2]
|-
|最新安定板
|[https://download.wsoft.ws/WS00178 2.2.1]
|-
!colspan="2"|[[AliceSister]]
|-
|最新版
|[https://download.wsoft.ws/WS00166 2.2]
|-
|最新安定板
|[https://download.wsoft.gq/WS00179 2.2.1]
|-

!colspan="2"|[https://github.com/WSOFT-Project/Losetta Losetta]
|-
|最新版
|[https://github.com/WSOFT-Project/Losetta/releases 0.9.19]
|-
![[AliceEULA-R|規約]]
![[AliceScript_Wiki:著作権|著作権情報]]
|}
{{Accordion|AliceScriptは、.NET上で動作する汎用性のあるスクリプト言語です。 AliceScriptを使用すると簡単にアプリケーションを構築することができます。 AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます...|AliceScriptには、簡単に高度なアプリケーションを作成するのに役立つ機能がいくつかあります。"ガページコレクション"には到達できず、使用されていないオブジェクトによって占有されたメモリを自動的に回収することができる機能があります。 "デリゲート"には自他のオブジェクトに対して簡単に連絡を取ることができる機能があります。"例外処理"には、エラーの検出と復旧を行うためのアプローチが用意されています。 AliceScriptは"統合型システム"を備えていますから、numberやstringなどの型を含めたすべての型はルートとなる一つのVariable型から派生しています。すべての型は、一般的な操作のセットを共有していますから、すべての型を一貫した方法で操作することができます。AliceScriptについてもっと詳しく知るには、[[AliceScriptのツアー]]を参照してください。|true}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 14">
<path d="M1 2.828c.885-.37 2.154-.769 3.388-.893 1.33-.134 2.458.063 3.112.752v9.746c-.935-.53-2.12-.603-3.213-.493-1.18.12-2.37.461-3.287.811V2.828zm7.5-.141c.654-.689 1.782-.886 3.112-.752 1.234.124 2.503.523 3.388.893v9.923c-.918-.35-2.107-.692-3.287-.81-1.094-.111-2.278-.039-3.213.492V2.687zM8 1.783C7.015.936 5.587.81 4.287.94c-1.514.153-3.042.672-3.994 1.105A.5.5 0 0 0 0 2.5v11a.5.5 0 0 0 .707.455c.882-.4 2.303-.881 3.68-1.02 1.409-.142 2.59.087 3.223.877a.5.5 0 0 0 .78 0c.633-.79 1.814-1.019 3.222-.877 1.378.139 2.8.62 3.681 1.02A.5.5 0 0 0 16 13.5v-11a.5.5 0 0 0-.293-.455c-.952-.433-2.48-.952-3.994-1.105C10.413.809 8.985.936 8 1.783z"/>
</svg></html> AliceScriptの新しいサイト:[https://docs.wsoft.ws/products/alice AliceScriptDocs]||0|24px}}
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5z"/>
<path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708l3 3z"/>
</svg></html> [https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード] ||0|24px}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M0 2.5A1.5 1.5 0 0 1 1.5 1h11A1.5 1.5 0 0 1 14 2.5v10.528c0 .3-.05.654-.238.972h.738a.5.5 0 0 0 .5-.5v-9a.5.5 0 0 1 1 0v9a1.5 1.5 0 0 1-1.5 1.5H1.497A1.497 1.497 0 0 1 0 13.5v-11zM12 14c.37 0 .654-.211.853-.441.092-.106.147-.279.147-.531V2.5a.5.5 0 0 0-.5-.5h-11a.5.5 0 0 0-.5.5v11c0 .278.223.5.497.5H12z"/>
<path d="M2 3h10v2H2V3zm0 3h4v3H2V6zm0 4h4v1H2v-1zm0 2h4v1H2v-1zm5-6h2v1H7V6zm3 0h2v1h-2V6zM7 8h2v1H7V8zm3 0h2v1h-2V8zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1z"/>
</svg></html> [https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTのドキュメントの WSOFT Docs への移行に関する情報]||2|24px}}
{|class="wikitable" style="width:100%"
|-
! AliceScriptの基礎 !! 主要な機能 !! 新機能
|-
| [[AliceScriptのツアー]]
| [[式]]
| [[新機能の一覧|AliceScriptの新機能]]
|-
| [[初めてのAliceScript]]
| [[変数]]
| [[破壊的変更の一覧]]
|-
! つながる
| [[関数リファレンス]]
| [[互換性|バージョンの互換性]]
|-
| [[Alice（キャラクター）|AliceScript公式アンバサダー]]
| [[例外]]
| [[WSOFTScriptからの移行]]
|-
| [https://discord.gg/ZHyxYSeCeP Aliceプロジェクト公式コミュニティ]
| [[言語構造]]
| [[リリースノート]]
|}

WSOFTのドキュメントの WSOFT Docs への移行に関する情報

2023-01-27T00:09:45Z

Master:

この記事では、WSOFTの提供している、あるいは提供していた、あみうは、WebSailing-Net、AliceScriptWikiおよび、WSOFTがwsoft.gq上で公開していたすべての記事の、WSOFTDocsへの移行に関する情報をお知らせします。
WSOFTは、今後数か月かけて記事やコンテンツの構造、形式、および基盤となるシステムを徹底的に見直し、WSOFTの提供するコンテンツを一つのサイトに一元化する全プロジェクト共通の取り組みを実施します。

==AmebaOwandからWSOFTCMS、さらにWSOFTDocsへ==
2018年、WebbSailingのサポート記事提供の場として、WebSailing-Netが誕生しました。WebSailingが、NX系に移行するまでの間、21の記事がAmebaOwandによってホストされました。

WSTubeの開発に際して、WSOFTは、自前でサーバーを用意し、そこで記事を提供する方式が導入されました。そこで、WSOFTはWSTubeで設計したUIを流用し、WSOFTCMSを開発しました。現在でも、WSOFTScriptのサイトで体験することができます。WSOFTは、この方式を3年以上にわたって使用し続け、その結果、200を超える記事がWSOFTCMSを通じて提供されました。

==新しいドキュメント管理方法==
ソフトウェアの多様化やリリースサイクルの短縮につれて、見やすくできるだけ最新のドキュメントを提供する必要が増大しました。記事の執筆を開発のスピードに合わせる必要があり、さらに、サポートが終了しているプロジェクトの資産を未だに使用し続けていることなどから、WSOFTでの近代的なドキュメント管理方法を再検討することに決めました。新しいプロジェクトには次の事項が求められます。

*ドキュメントの集約新しいサイトでは、WSOFTが提供しているすべての記事を一つのサイトに集約します。例えば、AliceScriptを使ってWSPluginを設計しようとしている開発者は、WebSailing、WSPlugin、AliceScriptに関連するすべての記事やヘルプを検索することができます。
*ユーザー体験の向上 WSOFTCMSは、WSTube譲りのユーザーインターフェースやレスポンシブデザインへの前提的な対応など、お世辞にも使いやすいものとは言えませんでした。しかし、すべての記事は、みなさまに提供するために執筆されているため、みなさまにとって使いやすいものである必要があります。新しいサイトでは、読みやすいフォント、アクセスしやすい目次、人間にとってわかりやすいUrl、バージョン管理のサポート、レスポンシブデザインへの完全な対応を実装します。
*サポート記事の民主化新しサイトでは、ユーザーのみなさまが記事を執筆および編集できるように、オープンソースのツールや規格を採用します。記事の執筆には、マークダウン形式を使用し、コンテンツ管理システムとしてGitHubを使用します。これにより、誤字脱字などをみなさまに直接訂正していただくことができ、記事の品質が向上します。
*従来の記事の保護新しいサイトへの移行によって、貴重な従来の記事やコンテンツが失われることがないようにします。2022年末までに、ほぼすべての記事を新しいサイトへと移行させる予定です。
==今後のロードマップ==
現在、WSOFTDocsへの移行が進行しています。詳しく知るには[https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTDocsの記事]を参照してください。

==関連記事==
* [https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTのドキュメントの WSOFT Docs への移行に関する情報-Docs]

メインページ

2023-01-23T02:41:03Z

Master:

__NOTOC__=AliceScriptへようこそ=
{|class="wikitable" align="right"
|+style="white-space:nowrap"|[https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード]
!colspan="2"|AliceScript
|-
|最新版
|[https://download.wsoft.ws/WS00152 2.1]
|-
|最新安定板
|[https://download.wsoft.ws/WS00139 2.0]
|-
!colspan="2"|[[AliceSister]]
|-
|最新版
|[https://download.wsoft.ws/WS00153 2.1]
|-
|最新安定板
|[https://download.wsoft.gq/WS00140 2.0]
|-

!colspan="2"|[https://github.com/WSOFT-Project/Losetta Losetta]
|-
|最新版
|[https://github.com/WSOFT-Project/Losetta/releases 0.9.16]
|-
![[AliceEULA-R|規約]]
![[AliceScript_Wiki:著作権|著作権情報]]
|}
{{Accordion|AliceScriptは、.NET上で動作する汎用性のあるスクリプト言語です。 AliceScriptを使用すると簡単にアプリケーションを構築することができます。 AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます...|AliceScriptには、簡単に高度なアプリケーションを作成するのに役立つ機能がいくつかあります。"ガページコレクション"には到達できず、使用されていないオブジェクトによって占有されたメモリを自動的に回収することができる機能があります。 "デリゲート"には自他のオブジェクトに対して簡単に連絡を取ることができる機能があります。"例外処理"には、エラーの検出と復旧を行うためのアプローチが用意されています。 AliceScriptは"統合型システム"を備えていますから、numberやstringなどの型を含めたすべての型はルートとなる一つのVariable型から派生しています。すべての型は、一般的な操作のセットを共有していますから、すべての型を一貫した方法で操作することができます。AliceScriptについてもっと詳しく知るには、[[AliceScriptのツアー]]を参照してください。|true}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 14">
<path d="M1 2.828c.885-.37 2.154-.769 3.388-.893 1.33-.134 2.458.063 3.112.752v9.746c-.935-.53-2.12-.603-3.213-.493-1.18.12-2.37.461-3.287.811V2.828zm7.5-.141c.654-.689 1.782-.886 3.112-.752 1.234.124 2.503.523 3.388.893v9.923c-.918-.35-2.107-.692-3.287-.81-1.094-.111-2.278-.039-3.213.492V2.687zM8 1.783C7.015.936 5.587.81 4.287.94c-1.514.153-3.042.672-3.994 1.105A.5.5 0 0 0 0 2.5v11a.5.5 0 0 0 .707.455c.882-.4 2.303-.881 3.68-1.02 1.409-.142 2.59.087 3.223.877a.5.5 0 0 0 .78 0c.633-.79 1.814-1.019 3.222-.877 1.378.139 2.8.62 3.681 1.02A.5.5 0 0 0 16 13.5v-11a.5.5 0 0 0-.293-.455c-.952-.433-2.48-.952-3.994-1.105C10.413.809 8.985.936 8 1.783z"/>
</svg></html> AliceScriptの新しいサイト:[https://docs.wsoft.ws/products/alice AliceScriptDocs]||0|24px}}
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5z"/>
<path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708l3 3z"/>
</svg></html> [https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード] ||0|24px}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M0 2.5A1.5 1.5 0 0 1 1.5 1h11A1.5 1.5 0 0 1 14 2.5v10.528c0 .3-.05.654-.238.972h.738a.5.5 0 0 0 .5-.5v-9a.5.5 0 0 1 1 0v9a1.5 1.5 0 0 1-1.5 1.5H1.497A1.497 1.497 0 0 1 0 13.5v-11zM12 14c.37 0 .654-.211.853-.441.092-.106.147-.279.147-.531V2.5a.5.5 0 0 0-.5-.5h-11a.5.5 0 0 0-.5.5v11c0 .278.223.5.497.5H12z"/>
<path d="M2 3h10v2H2V3zm0 3h4v3H2V6zm0 4h4v1H2v-1zm0 2h4v1H2v-1zm5-6h2v1H7V6zm3 0h2v1h-2V6zM7 8h2v1H7V8zm3 0h2v1h-2V8zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1z"/>
</svg></html> [https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTのドキュメントの WSOFT Docs への移行に関する情報]||2|24px}}
{|class="wikitable" style="width:100%"
|-
! AliceScriptの基礎 !! 主要な機能 !! 新機能
|-
| [[AliceScriptのツアー]]
| [[式]]
| [[新機能の一覧|AliceScriptの新機能]]
|-
| [[初めてのAliceScript]]
| [[変数]]
| [[破壊的変更の一覧]]
|-
! つながる
| [[関数リファレンス]]
| [[互換性|バージョンの互換性]]
|-
| [[Alice（キャラクター）|AliceScript公式アンバサダー]]
| [[例外]]
| [[WSOFTScriptからの移行]]
|-
| [https://discord.gg/ZHyxYSeCeP Aliceプロジェクト公式コミュニティ]
| [[言語構造]]
| [[リリースノート]]
|}

メインページ

2023-01-10T07:06:38Z

Master:

__NOTOC__=AliceScriptへようこそ=
{|class="wikitable" align="right"
|+style="white-space:nowrap"|[https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード]
!colspan="2"|AliceScript
|-
|最新版
|[https://download.wsoft.ws/WS00152 2.1]
|-
|最新安定板
|[https://download.wsoft.ws/WS00139 2.0]
|-
!colspan="2"|[[AliceSister]]
|-
|最新版
|[https://download.wsoft.ws/WS00153 2.1]
|-
|最新安定板
|[https://download.wsoft.gq/WS00140 2.0]
|-
![[AliceEULA-R|規約]]
![[AliceScript_Wiki:著作権|著作権情報]]
|}
{{Accordion|AliceScriptは、.NET上で動作する汎用性のあるスクリプト言語です。 AliceScriptを使用すると簡単にアプリケーションを構築することができます。 AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます...|AliceScriptには、簡単に高度なアプリケーションを作成するのに役立つ機能がいくつかあります。"ガページコレクション"には到達できず、使用されていないオブジェクトによって占有されたメモリを自動的に回収することができる機能があります。 "デリゲート"には自他のオブジェクトに対して簡単に連絡を取ることができる機能があります。"例外処理"には、エラーの検出と復旧を行うためのアプローチが用意されています。 AliceScriptは"統合型システム"を備えていますから、numberやstringなどの型を含めたすべての型はルートとなる一つのVariable型から派生しています。すべての型は、一般的な操作のセットを共有していますから、すべての型を一貫した方法で操作することができます。AliceScriptについてもっと詳しく知るには、[[AliceScriptのツアー]]を参照してください。|true}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 14">
<path d="M1 2.828c.885-.37 2.154-.769 3.388-.893 1.33-.134 2.458.063 3.112.752v9.746c-.935-.53-2.12-.603-3.213-.493-1.18.12-2.37.461-3.287.811V2.828zm7.5-.141c.654-.689 1.782-.886 3.112-.752 1.234.124 2.503.523 3.388.893v9.923c-.918-.35-2.107-.692-3.287-.81-1.094-.111-2.278-.039-3.213.492V2.687zM8 1.783C7.015.936 5.587.81 4.287.94c-1.514.153-3.042.672-3.994 1.105A.5.5 0 0 0 0 2.5v11a.5.5 0 0 0 .707.455c.882-.4 2.303-.881 3.68-1.02 1.409-.142 2.59.087 3.223.877a.5.5 0 0 0 .78 0c.633-.79 1.814-1.019 3.222-.877 1.378.139 2.8.62 3.681 1.02A.5.5 0 0 0 16 13.5v-11a.5.5 0 0 0-.293-.455c-.952-.433-2.48-.952-3.994-1.105C10.413.809 8.985.936 8 1.783z"/>
</svg></html> AliceScriptの新しいサイト:[https://docs.wsoft.ws/products/alice AliceScriptDocs]||0|24px}}
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5z"/>
<path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708l3 3z"/>
</svg></html> [https://docs.wsoft.ws/products/alice/download AliceScriptのダウンロード] ||0|24px}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M0 2.5A1.5 1.5 0 0 1 1.5 1h11A1.5 1.5 0 0 1 14 2.5v10.528c0 .3-.05.654-.238.972h.738a.5.5 0 0 0 .5-.5v-9a.5.5 0 0 1 1 0v9a1.5 1.5 0 0 1-1.5 1.5H1.497A1.497 1.497 0 0 1 0 13.5v-11zM12 14c.37 0 .654-.211.853-.441.092-.106.147-.279.147-.531V2.5a.5.5 0 0 0-.5-.5h-11a.5.5 0 0 0-.5.5v11c0 .278.223.5.497.5H12z"/>
<path d="M2 3h10v2H2V3zm0 3h4v3H2V6zm0 4h4v1H2v-1zm0 2h4v1H2v-1zm5-6h2v1H7V6zm3 0h2v1h-2V6zM7 8h2v1H7V8zm3 0h2v1h-2V8zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1z"/>
</svg></html> [https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTのドキュメントの WSOFT Docs への移行に関する情報]||2|24px}}
{|class="wikitable" style="width:100%"
|-
! AliceScriptの基礎 !! 主要な機能 !! 新機能
|-
| [[AliceScriptのツアー]]
| [[式]]
| [[新機能の一覧|AliceScriptの新機能]]
|-
| [[初めてのAliceScript]]
| [[変数]]
| [[破壊的変更の一覧]]
|-
! つながる
| [[関数リファレンス]]
| [[互換性|バージョンの互換性]]
|-
| [[Alice（キャラクター）|AliceScript公式アンバサダー]]
| [[例外]]
| [[WSOFTScriptからの移行]]
|-
| [https://discord.gg/ZHyxYSeCeP Aliceプロジェクト公式コミュニティ]
| [[言語構造]]
| [[リリースノート]]
|}

パッケージのビルド

2022-12-25T11:32:10Z

Master:

[[Category:チュートリアル]]
あなたが作成したスクリプトをAlicePackage形式のアプリケーションとして展開するには、AlicePackage形式にビルドする必要があります。
AlicePackageは、さまざまなスクリプトやリソース、パッケージ、ライブラリをまとめた書庫と考えることができます。詳しく知るには[[AlicePackage]]の記事を参照してください。パッケージをビルドするには、次の方法のいずれかを取ることができます。
*IceBuildを使用する
*ビルドスクリプトを一から作成する
この記事では、まず初めに簡単にパッケージをビルドすることができるツールである、IceBuildを使用する方法を解説し、次にビルドスクリプトを一から作成してビルドする方法について触れます。

=IceBuild=
AlicePackage Build Environmentは、[[AlicePackage]]形式のアプリケーションをビルドするためのプラットフォームです。IceBuildとも呼ばれるこのエンジンは、パッケージを処理およびビルドする方法を制御する方法を提供します。
ディレクトリに対して<code>icebuild.ice</code>を実行するとAlicePackageを簡単に出力できます。
IceBuildは、[[AliceScriptのダウンロード#その他のファイルのダウンロード|AliceScriptのダウンロード]]の記事からダウンロードできます。

IceBuildは、ビルドする前にパッケージマニフェストファイルを確認し、適切なエントリポイントが指定されているか、埋め込まれたリソースファイルが存在するかなどの基本的な事項を確認した後パッケージのビルドを開始します。ビルドスクリプトの使用が特に必要な場合を除いて、基本的にAlicePackageのビルドにはIceBuildを使用することを推奨します。
==コマンドラインから使用する==
IceBuildを使用するには、適切なコマンドライン引数とともに、適切なディレクトリ名を<code>icebuild.ice</code>に渡します。例えば、ディレクトリ<code>TestPkg</code>から<code>TestPkg.ice</code>をビルドするには、次のコマンドを使用します。
icebuild.ice TestPkg -out:TestPkg.ice
IceBuildのコマンドライン引数について詳しく知るには[[IceBuildコマンドラインリファレンス]]を参照してください。

.iceファイルをコマンドプロンプトから実行できるようにするには、[https://docs.wsoft.ws/products/alice/tutorial/ice-to-association/ チュートリアル:iceファイルの関連付け]を参照してください。

==AliceScriptから使用する==
AliceScriptからIceBuildを呼び出すこともできます。この方法を使用して、IceBuildの安定性とビルドスクリプトを一から実行することのメリットを同時に享受することができます。この方法を使用するときは、例えば次の状況が考えられます。
*パッケージ化する前に、ファイルまたはディレクトリに前処理することを希望している
*ビルドが成功したとき、出力されたパッケージを別の場所にコピーすることを希望している
*ビルド後に後処理を実行することを希望している
次の例は、AliceScriptでIceBuildを呼び出すサンプルです。
import “icebuild.ice”;
using WSOFT.AliceScript.IceBuild;

//ソースディレクトリへのパス
const SourcePath = “{ソースディレクトリへのパス}”;
//出力先ファイルのパス
const TargetPath = “{出力先ファイルのパス}”;

//希望する場合はここに前処理を記述

//ビルド実行
var result = IceBuild.BuildPackage(SourcePath,TargetPath);

if(result.Success)
{
//ビルド成功
//希望する場合はビルド成功時の後処理を記述
print(“パッケージのビルドが成功しました”);
}
else
{
//ビルド失敗
//希望する場合はビルド失敗時の後処理を記述
print(“パッケージのビルドが失敗しました”);
for(var i=0;i<result.Errors.Length;++i)
{
print(“エラー {0}/{1} :{2}”,i,result.Errors.Length,result.Errors[i]);
}
}
//希望する場合はビルド完了時の後処理を記述
print(“パッケージのビルドが完了しました”);

=ビルドスクリプトを一から作成する=
また、<code>Alice.Packaging</code>名前空間にあるクラスを使用して自分で一からパッケージをビルドするスクリプトを作成することもできます。

ディレクトリをAlicePackage形式にビルドする手順は、主に次の通りです。
#<code>manifest.xml</code>を含むビルド対象のディレクトリをZip形式で圧縮する
#1のファイルをAlicePackage形式に変換する
このままでもAlicePackage形式として実行可能ですが、できる限りパッケージ化前に少なくともパッケージマニフェストファイルの簡易チェックをしてください。ユーザーおよび開発者はAlicePackageに正しい内容のパッケージマニフェストファイルが含まれていることを期待しますし、実際にそのようなプログラムが流行することはAliceエコシステムの健全な成長を妨げかねません。
次の例はビルドスクリプトの一例です。
import “Alice.IO”;
import “Alice.Packaging”;

const SourcePath = “{ソースディレクトリのパス}”;
const TargetPath = “{出力ファイルのパス}”;
　
//パッケージマニフェストファイルのパス
var manifestPath = Path_Combine(SourcePath,”manifest.xml”);

//ソースディレクトリとパッケージマニフェストファイルの存在を確認
if(!(Directory_exists(SourcePath) && File_Exists(manifestPath)))
{
throw(“エラー:ソースディレクトリが存在しないか、パッケージマニフェストファイルが存在しません”);
return;
}
//パッケージマニフェストファイルの簡易チェック
if(Package_GetManifestFromFile(manifestPath) == null)
{
throw(“エラー:パッケージマニフェストファイルが不正な形式です”);
return;
}

//Zipファイルの出力に使用する一時的なファイルパス
var tempPath = Path_GetTempFileName(true);

print(“圧縮: {0} -> {1}”,SourcePath,tempPath);
//ソースディレクトリをZip形式で圧縮
Zip_CreateFromDirectory(SourcePath,tempPath);

print(“変換: {0} -> {1}”,tempPath,TargetPath);
//圧縮したZipファイルからAlicePackageファイルを生成
Package_CreateFromZipFile(tempPath,TargetPath);

print(“パッケージのビルドが成功しました”);

MediaWiki:Common.js

2022-12-14T03:46:13Z

Master: ページの白紙化

MediaWiki:Common.js

2022-12-14T03:45:45Z

Master: ページの作成:「/* ここにあるすべてのJavaScriptは、すべてのページ読み込みですべての利用者に対して読み込まれます */ document.querySelector('body')…」

/* ここにあるすべてのJavaScriptは、すべてのページ読み込みですべての利用者に対して読み込まれます */
document.querySelector('body').insertAdjacentHTML('afterbegin','<header><nav class="navbar navbar-expand-lg navbar-light"><div class="container"><a class="navbar-brand" href="https://wsoft.ws/"><img src="https://wsoft.ws/favicon.svg" alt="" width="30" class="d-inline-block align-text-top" /> WSOFT</a><button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#nav-navbar" aria-controls="nav-navbar" aria-expanded="false" aria-label="Toggle navigation"><span class="navbar-toggler-icon"></span></button><div class="collapse navbar-collapse" id="nav-navbar"><ul class="navbar-nav me-auto mb-2 mb-lg-0"><li class="nav-item"><a id="nav-home" class="nav-link" aria-current="page" href="https://wsoft.ws/">Home</a></li><li class="nav-item"><a id="nav-about" class="nav-link" href="https://wsoft.ws/About">About</a></li><li class="nav-item"><a id="nav-works" class="nav-link" href="https://wsoft.ws/Works">Works</a></li><li class="nav-item"><a id="nav-docs" class="nav-link" aria-current="page" href="https://docs.wsoft.ws/">Docs</a></li><li class="nav-download"><a id="nav-downloads" class="nav-link" href="https://download.wsoft.ws">Download</a></li><li class="nav-contact"><a id="nav-contact" class="nav-link" href="https://wsoft.ws/Contact">Contact</a></li></ul><a class="navbar-text" href="https://github.com/WSOFT-Project"><i class="bi bi-github"></i></a><span class="navbar-text">  </span><a class="navbar-text" href="https://twitter.com/WSOFT7"><i class="bi bi-twitter"></i></a><span class="navbar-text">  </span><a class="navbar-text" href="https://a.wsoft.ws/discord"><i class="bi bi-discord"></i></a><span class="navbar-text">  </span><a class="navbar-text" href="https://a.wsoft.ws/youtube"><i class="bi bi-youtube"></i></a></div></div></nav></header>');
document.querySelector('body').insertAdjacentHTML('beforeend', '<footer class="border-top footer text-muted .position-absolute.bottom-0.start-50.translate-middle-x" style="padding-top: 15px;"><div class="container"><div class="row"><div class="col-md"><p>Copyright © 2022 WSOFT All Rights Reserved.</p></div><div class="col-md"><p class=""><a href="https://docs.wsoft.ws/legal" id="legal-link" class="text-decoration-none text-muted">豕慕噪雉�侭</a> | <a href="https://status.wsoft.ws/" class="text-decoration-none text-muted">繧ｵ繝ｼ繝薙せ迥ｶ豕�</a> | <a href="https://wsoft.ws/Sitemap" class="text-decoration-none text-muted">繧ｵ繧､繝医�繝��</a></p></div><div class="col-md-1"><a data-bs-toggle="modal" data-bs-target="#wsoft-custom-modal"><img class="fit-picture" src="https://wsoft.ws/WS-Emblem.png" height="30em" width="46.17em" alt="Powerd by WSOFT"></a></div></div></div></footer>');
function setLegalLink(url) {
document.getElementById('legal-link').setAttribute('href', url);
}
function setLegalLink(url,text) {
let a=document.getElementById('legal-link');
a.setAttribute('href', url);
a.innerHTML=text;
}

メインページ

2022-11-21T05:03:19Z

Master:

__NOTOC__=AliceScriptへようこそ=
{|class="wikitable" align="right"
|+style="white-space:nowrap"|[[AliceScriptのダウンロード]]
!colspan="2"|AliceScript
|-
|最新版
|[https://download.wsoft.ws/WS00003 GM]
|-
|最新安定板
|[https://download.wsoft.ws/WS00003 GM]
|-
!colspan="2"|[[AliceSister]]
|-
|最新版
|[https://download.wsoft.gq/WS00004 GM]
|-
|最新安定板
|[https://download.wsoft.gq/WS00004 GM]
|-
![[AliceEULA-R|規約]]
![[AliceScript_Wiki:著作権|著作権情報]]
|}
{{Accordion|AliceScriptは、.NET上で動作する汎用性のあるスクリプト言語です。 AliceScriptを使用すると簡単にアプリケーションを構築することができます。 AliceScriptはC#やPythonをルーツとしているため、C、C#、JavaScript、Pyhton、PHPのプログラマーであればすぐに使いこなすことができます...|AliceScriptには、簡単に高度なアプリケーションを作成するのに役立つ機能がいくつかあります。"ガページコレクション"には到達できず、使用されていないオブジェクトによって占有されたメモリを自動的に回収することができる機能があります。 "デリゲート"には自他のオブジェクトに対して簡単に連絡を取ることができる機能があります。"例外処理"には、エラーの検出と復旧を行うためのアプローチが用意されています。 AliceScriptは"統合型システム"を備えていますから、numberやstringなどの型を含めたすべての型はルートとなる一つのVariable型から派生しています。すべての型は、一般的な操作のセットを共有していますから、すべての型を一貫した方法で操作することができます。AliceScriptについてもっと詳しく知るには、[[AliceScriptのツアー]]を参照してください。|true}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 14">
<path d="M1 2.828c.885-.37 2.154-.769 3.388-.893 1.33-.134 2.458.063 3.112.752v9.746c-.935-.53-2.12-.603-3.213-.493-1.18.12-2.37.461-3.287.811V2.828zm7.5-.141c.654-.689 1.782-.886 3.112-.752 1.234.124 2.503.523 3.388.893v9.923c-.918-.35-2.107-.692-3.287-.81-1.094-.111-2.278-.039-3.213.492V2.687zM8 1.783C7.015.936 5.587.81 4.287.94c-1.514.153-3.042.672-3.994 1.105A.5.5 0 0 0 0 2.5v11a.5.5 0 0 0 .707.455c.882-.4 2.303-.881 3.68-1.02 1.409-.142 2.59.087 3.223.877a.5.5 0 0 0 .78 0c.633-.79 1.814-1.019 3.222-.877 1.378.139 2.8.62 3.681 1.02A.5.5 0 0 0 16 13.5v-11a.5.5 0 0 0-.293-.455c-.952-.433-2.48-.952-3.994-1.105C10.413.809 8.985.936 8 1.783z"/>
</svg></html> AliceScriptの新しいサイト:[https://docs.wsoft.ws/alice AliceScriptDocs]||0|24px}}
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5z"/>
<path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708l3 3z"/>
</svg></html> [[AliceScriptのダウンロード]]||0|24px}}<br>
{{Alert|<html><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-download" viewBox="0 0 16 16">
<path d="M0 2.5A1.5 1.5 0 0 1 1.5 1h11A1.5 1.5 0 0 1 14 2.5v10.528c0 .3-.05.654-.238.972h.738a.5.5 0 0 0 .5-.5v-9a.5.5 0 0 1 1 0v9a1.5 1.5 0 0 1-1.5 1.5H1.497A1.497 1.497 0 0 1 0 13.5v-11zM12 14c.37 0 .654-.211.853-.441.092-.106.147-.279.147-.531V2.5a.5.5 0 0 0-.5-.5h-11a.5.5 0 0 0-.5.5v11c0 .278.223.5.497.5H12z"/>
<path d="M2 3h10v2H2V3zm0 3h4v3H2V6zm0 4h4v1H2v-1zm0 2h4v1H2v-1zm5-6h2v1H7V6zm3 0h2v1h-2V6zM7 8h2v1H7V8zm3 0h2v1h-2V8zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1zm-3 2h2v1H7v-1zm3 0h2v1h-2v-1z"/>
</svg></html> [https://docs.wsoft.ws/blog/migration-to-docs/ WSOFTのドキュメントの WSOFT Docs への移行に関する情報]||2|24px}}
{|class="wikitable" style="width:100%"
|-
! AliceScriptの基礎 !! 主要な機能 !! 新機能
|-
| [[AliceScriptのツアー]]
| [[式]]
| [[新機能の一覧|AliceScriptの新機能]]
|-
| [[初めてのAliceScript]]
| [[変数]]
| [[破壊的変更の一覧]]
|-
! つながる
| [[関数リファレンス]]
| [[互換性|バージョンの互換性]]
|-
| [[Alice（キャラクター）|AliceScript公式アンバサダー]]
| [[例外]]
| [[WSOFTScriptからの移行]]
|-
| [https://discord.gg/ZHyxYSeCeP Aliceプロジェクト公式コミュニティ]
| [[言語構造]]
| [[リリースノート]]
|}

数値型の計算誤差

2022-11-20T05:20:03Z

Master:

[[Category:チュートリアル]]
AliceScriptの数値型は、倍精度浮動小数点数数値型と定められており、この規格はIEEE754として標準化されています。
しかしこの数値型で小数の計算をしているとき、その計算結果が期待通りでないことがあります。この記事では、その理由について説明します。
=計算誤差の例=
0.1 + 0.2 == 0.3
数学では、上記の式は正しく<code>true</code>と評価されますし、ほとんどの開発者も、それが正しいことを期待します。
では、AliceScriptでこの式を評価してみます。
print(0.1 + 0.2 == 0.3);
このコードを実行すると、<code>false</code>が出力されます。
=理由=
これらの計算誤差はバグではありません。AliceScriptの数値型のような浮動小数点数数値型は、値を2進数で格納していますが、ほとんどの10進数の小数は2進数で表すことができず、その近似値として表現されます。近似値の誤差が例に示したような計算誤差として現れます。

知的好奇心旺盛なあなたのために、もう少し説明します。例えば10進数の<code>0.1</code>を2進数に変換すると<code>0.0001100110011…</code>となり、<code>0011</code>が永遠と循環します。そのため<code>0.1</code>を倍精度浮動小数点数数値型に格納するには、適当な桁で丸める必要があります。このとき、最も近い偶数に値を丸めます。その結果として<code>0.1</code>は数値型では2進数で<code>0.0001100110011001100110011001100110011001100110011001101</code>となります。これを10進数に戻す<code>0.1000000000000000055511151231257827021181583404541015625</code>となり、<code>0.1</code>ではなくなります。

ただし整数は、有効桁数15桁の範囲内であれば、正確に格納できます。また小数であっても、k/2^n (k,nは整数)で表すこともできる小数は2進数で表現できるため、正確に格納できます。

なおこのような誤差は、AliceScript固有のものではありません。IEEE 754の2進浮動小数点形式を採用しているシステムでは、同じことが起こりえます。

=回避策=
==許容範囲を決めて値を比較する==
二つの浮動小数点数数値型数を比較するとき、例えばそれらが等しいかを調べるときに<code>==</code>を使うのは危険です。両者が全く等しい場合のみ等しいと判断するのではなく、「両者の差の絶対値がある程度であれば等しいと認める」など許容範囲を決めて比較する方が安全です。次の例は、許容範囲を定めt、<code>0.000001</code>未満の差の場合に等しいと判断します。
import “Alice.Math”;

///二つの小数が等しいと認められるかどうかを評価します
///パラメータ a:一方の値
/// b:もう一方の値
/// tolerance:許容できる誤差の最大の値(この数値は常に正)
function NumEqual(number a,number b,number tolerance)
{
return (math_abs(a - b) < tolerance);
}

var numA = 0.1 + 0.2;
var numB = 0.3;
///許容範囲
var tolerance = 0.000001;
if(NumEqual(numA,numB,tolerance))
{
print(“二値は等しいと認められました”);
}
==一度整数にした後で変換する==
他には、例えば一度整数にしてから計算する方法も考えられます。次の例では、二つの数を整数にすることができる数<code>dis ** 10</code>を求めて二数を整数にした後、計算を行うことで誤差を防ぎます。ただしこの場合でも、有効数字15桁以上の数は正確に扱うことができません。
import “Alice.Math”;

///与えられた数の小数点以下の桁数を取得します
function GetDisitsUnder1(number num)
{
var priceString = price.ToString().TrimEnd('0');
int index = priceString.IndexOf('.');
if (index == -1){return 0;}
return priceString.Substring(index + 1).Length;
}

///二つの小数が等しいかどうかを判断します
function NumEqual(number numA,numbner numB)
{
//numA,numBの小数点以下の桁数(すなわち、10の何乗倍すれば整数になるか)
var nAd = GetDisitsUnder1(numA);
var nBd = GetDisitsUnder1(numB);
//二つの小数の小数点以下桁数のうち多い方
var dis = math_max(nAd,nBd);

//numA,numBを整数化したもの
var rA = numA * (dis ** 10);
var rB = numB * (dis ** 10);

return (rA == rB);
}

///二つの小数の和を求めます
function Sum(number numA,number numB)
{
//numA,numBの小数点以下の桁数(すなわち、10の何乗倍すれば整数になるか)
var nAd = GetDisitsUnder1(numA);
var nBd = GetDisitsUnder1(numB);
//二つの小数の小数点以下桁数のうち多い方
var dis = math_max(nAd,nBd);

//numA,numBを整数化したもの
var rA = numA * (dis ** 10);
var rB = numB * (dis ** 10);
//整数化されたものの計算結果
var result = rA + rB;

return (result / (dis ** 10));
}

print(NumEqual(0.1+0.2,0.3));//出力例:true
print(Sum(0.1,0.2));//出力例:0.3