- WSOFT Docs
- ブログ
- 共同作成ガイド
-
製品
- 製品
- PCMX
- WSOFTアカウント
- AliceScript
- AliceScript
- 謝辞
- ダウンロード
- Alice(キャラクター)
- AliceScriptのツアー
- Wikiの概要
- APIブラウザー
- APIブラウザー
- Alice
- break
- continue
- delay
- do
- exit
- for
- foreach
- function
- if
- import
- include
- lock
- read
- return
- string_format
- switch
- using
- while
- write
- Diagnostics
- Environment
- env_clr_version
- env_commandLine
- env_commandLineArgs
- env_set_exitCode
- env_expand_environmentVariables
- env_get_environmentVariable
- env_hasShutdownStarted
- env_impl_architecture
- env_impl_location
- env_impl_name
- env_impl_target
- env_impl_version
- env_Is64BitOperatingSystem
- env_Is64BitProcess
- env_MachineName
- env_NewLine
- env_os_platform
- env_os_version
- env_set_environmentVariable
- Exception
- Interpreter
- gc_collect
- gc_collectAfterExecute
- gc_getTotalMemory
- interpreter_append_output
- interpreter_append_output
- interpreter_consts
- interpreter_namespaces
- interpreter_getVariable
- interpreter_globalVariables
- interpreter_name
- interpreter_nameexists
- interpreter_namespaces
- interpreter_process
- interpreter_processfile
- interpreter_reset_variables
- Type
- Math
- math_abs
- math_acos
- math_acosh
- math_atan
- math_atan2
- math_atanh
- math_bitdecrement
- math_bitincrement
- math_cbrt
- math_celling
- math_clamp
- math_copysign
- math_cos
- math_cosh
- math_e
- math_exp
- math_factorial
- math_floor
- math_fusedmultiplyadd
- math_isFinite
- math_isInfinity
- math_isNaN
- math_isNegativeInfinity
- math_isNormal
- math_isPositiveInfinity
- math_isprime
- math_isSubNormal
- math_max
- math_min
- math_pi
- math_pow
- math_round
- math_sin
- math_sinh
- math_sqrt
- math_tan
- math_tanh
- math_tau
- math_truncate
- Net
- Parsing
- Random
- Security
- Threading
- Array
- Bool
- Bytes
- Delegate
- None
- Number
- String
- string
- CompareTo
- Contains
- EndsWith
- Equals
- Format
- GetBytes
- Indent
- IndexOf
- Insert
- IsEmptyOrNull
- IsEmptyOrWhiteSpace
- IsNormalized
- Join
- LastIndexOf
- Normalize
- PadCenter
- PadLeft
- PadRight
- Remove
- RemoveAt
- Repeat
- Replace
- ReplaceLineEndings
- Split
- SplitLines
- StartsWith
- SubString
- ToLower
- ToLowerInvariant
- ToUpper
- ToUpperInvariant
- Trim
- Trim
- TrimStart
- Variable
- 変更履歴
- 例外
- 例外
- 0x000 NONE
- 0x001 COULDNT_FIND_FUNCTION
- 0x003 INVALID_OPERAND
- 0x004 COULDNT_FIND_VARIABLE
- 0x005 ITS_RESERVED_NAME
- 0x006 ILLEGAL_IDENTIFIER
- 0x009 INCOMPLETE_ARGUMENTS
- 0x01a COULDNT_ADD_PARAMETERS_AFTER_PARMS_KEYWORD
- 0x020 COULDNT_EXECUTE_BLOCK
- 0x021 NEED_BRACKETS
- 0x022 UNNEED_TO_BRACKETS
- 0x04a CASE_BLOCK_MISSING_BREAK
- 0x04b UNKNOWN_ESCAPE_CHAR
- 基本
- Alice in Discord
- 相互運用
- チュートリアル
- ダウンロードセンター
- ほめて.ws
- アイコンメーカー
- WSOFTScript
- Unidet
- WebSailing
- WSNET
- WSTodon
- WSTube
- Lantana
- 法的資料
-
あみうは
- あみうは
- 新学期が始まりました!
- 恋の相談
- プチコン3号で作ったのは?
- オススメの文庫
- マクドナルド最高!
- ios11β レビュー
- あみうはの歌について
- ついに自分のソフトウェアのホームページができました。
- Windowsタブレットをリセットして起動しなくなった人のために
- PCレスで YouTubeの曲を携帯mp3プレイヤーで聴く(iPhone)
- 食べられないラズベリーパイを買いました。(1)
- ラズベリーパイの下ごしらえ(2)
- 小説始めます~
- 女子がキュンとくる行動ベスト3!!
- MacとWindowsについてあまり知られていない事
- macでできる裏技
- ドコモの格安スマホ「MONO」買っちゃいました☆いい所をいくつか
- 『レビュー』iPhone6sを1年間使い続けて思ったこと
- iPhoneの拡大鏡に関するバクを発見しました。
- iPhoneで圧縮ファイルを作成したり解凍する方法
- Obscura2が今だけ無料!使い方まとめ
- Windowsタブレットがブルースクリーンになった時のメモ
- お知らせ
ネイティブ関数の呼び出し
この記事では、AliceScriptからWin32APIなどのネイティブライブラリを呼び出す方法について説明します。
対応バージョン>=Alice3.0
概要
AliceScriptからネイティブ関数(C-Style関数)を呼び出すことで、AliceScriptで使用できる範囲のAPIを超えてさまざまなAPIを呼び出すことができます。 まずは簡単な例をご覧ください。次の例では、Win32APIで定義されているMessageBox関数を使用してメッセージボックスを表示します。
// 呼び出したい機能を含むライブラリと関数
#libimport "user32.dll"
extern int MessageBox(HWND hwnd,LPCTSTR lpText,LPCTSTR lpCaption,UINT uType);
// 定義した関数を呼び出す
MessageBox(0,"Hello,World!","TestMessage",0);
この例は簡単ながら、ネイティブ関数を呼び出すために必要な要素をすべて含んでいます。
#libimport
指令を使用して、インタプリタに実際に関数が定義されているライブラリを読み込むよう指示します。extern
から始まる関数定義では、ネイティブ関数名と正確に同じ名前と引数を持つ関数を定義しています。MessageBox(...);
では、AliceScriptの関数と同じように関数を呼び出しています。
Linuxの場合でも同様です。次の例では、getpid()
関数を呼び出して、現在のプロセスのIDを取得しています。
// 呼び出したい機能を含むライブラリと関数
#libimport "libc.so.6"
extern int getpid();
// 定義した関数を呼び出す
print(getpid());
変数名の省略
ネイティブ関数を呼び出すとき、本質的に変数名は不要な情報です。 そのため、変数名はなんでもよく、変数名を省略して型名のみを定義することでもネイティブ関数を定義できます。この場合でも、関数名と引数・戻り値の型、引数の個数は呼び出したい関数と一致する必要がある点に注意してください。次に例を示します。
別名での定義
エントリポイントを使用することで、別名でネイティブ関数を定義できます。
次の例では、Win32APIのMessageBox
関数を、AliceScriptのMsgBox
関数として定義しています。
#libimport "user32.dll" , "MessageBox"
extern int MsgBox(HWND hwnd,LPCTSTR lpText,LPCTSTR lpCaption,UINT uType);
// 関数呼び出し
MsgBox(0,"Hello,World!","TestMessage",0);
文字コードの指定
AliceScriptからネイティブ関数に文字列をやり取りするとき、次に示すように一部のAPIではANSI(ナロー)形式とUnicode(ワイド)形式を受取る2種類の関数を公開しています。
ANSI形式
char*
型に変換される(C++の1バイト文字列)- ASCII互換の文字コードを使用(たとえば、日本語ならShift-JIS)
- WindowsAPIでは
MessageBoxA
など、エントリポイント名の末尾がAになっていることが多い - 指定するには
#libimport
の第三引数にfalse
を渡す
Unicode形式
wchar_t*
型に変換される(C++の2バイト文字列)- 文字コードにはUTF-16を使用
- WindowsAPIでは
MessageBoxW
など、エントリポイント名の末尾がWになっていることが多い - 指定するには
#libimport
の第三引数にtrue
を渡す
AliceScriptでは規定では、プラットフォームに応じて適切な文字コードを自動選択します。 また、明示的にネイティブ関数に文字列を渡すときに使用される文字コードを指定することもできます。
次の例では、ANSI形式を使用するMessageBoxA
関数とUnicode形式を使用するMessageBoxW
関数をそれぞれAliceScriptで定義しています。
// ANSI形式の関数の定義
#libimport "user32.dll" , null , false
extern int MessageBoxA(HWND hwnd,LPCTSTR lpText,LPCTSTR lpCaption,UINT uType);
// Unicode形式の関数の定義
#libimport "user32.dll" , null , true
extern int MessageBoxW(HWND hwnd,LPCWSTR lpText,LPCWSTR lpCaption,UINT uType);
// プラットフォームに応じて自動選択
#libimport "user32.dll" , null , null
extern int MessageBox(HWND hwnd,LPCTSTR lpText,LPCTSTR lpCaption,UINT uType);
型変換
C言語は、AliceScriptとは異なる型システムを持っているため、AliceScripとネイティブ関数の間で値のやり取りが必要になる場合は型変換が行われます。
ネイティブ関数の定義ではint
やHWND
などの見慣れない型キーワードが使用されていますが、これはそのためです。
AliceScriptの型との相互変換について詳しく知るには、マーシャリングを参照してください。
ネイティブ関数の動的定義
Interop_GetInvoker
関数を使用することで、ネイティブ関数をデリゲートの形式で動的に定義し、使用できます。次の例を参照してください。