Extren可以用一個類型安全的方式來描述目標語言特定的交互。它們像普通類一樣定義,除了:
> Externs can be used to describe target-speci?c interaction in a type-safe manner. They are de?ned like normal classes, except that
* class關鍵字被extern 關鍵字領先,
* 方法(第4.3節)沒有表達式,
* 所有的參數和返回類型需要是顯式的。
> * the class keyword is preceded by the extern keyword,
> * methods (4.3) have no expressions and
> * all argument and return types are explicit.
常見的例子在Haxe標準庫(第10章),Math 類,摘錄如下:
> A common example from the Haxe Standard Library (10) is the Math class, as an excerpt shows:
~~~
extern class Math
{
static var PI(default,null) : Float;
static function floor(v:Float):Int;
}
~~~
我們看到,externs 既可以定義方法也可以定義變量(時尚,PI是聲明為一個只讀屬性(第4.2節))。一旦這個信息對于編譯器可用,它啟用相應的字段訪問,也被稱為類型:
> We see that externs can de?ne both methods and variables (actually, PI is declared as a readonly property (4.2)). Once this information is available to the compiler, it allows ?eld access accordingly and also knows the types:
~~~
class Main {
static public function main() {
var pi = Math.floor(Math.PI);
$type(pi); // Int
}
}
~~~
這這可以運行,因為floor方法返回類型聲明為Int。
> This works because the return type of method floor is declared to be Int.
Haxe標準庫帶有許多外部類,對于Flash和JavaScript目標語言。它們使可以以類型安全的方式訪問原生的APIs,當作設計高層APIs的工具。Externs也可以應用haxelib(第11章)中許多流行的原生庫。
> The Haxe Standard Library comes with many externs for the Flash and JavaScript target. They allow accessing the native APIs in a type-safe manner and are instrumental for designing higher-level APIs. There are also externs for many popular native libraries on haxelib (11).
Flash,Java和C#目標語言允許通過命令行(第7章)直接包括原生的庫。目標特定的細節在每個目標語言細節(第12章)等各自的章節。
> The Flash, Java and C# targets allow direct inclusion of native libraries from command line (7). Target-speci?c details are explained in the respective sections of Target Details (Chapter 12).
一些目標語言如Python或者JavaScript可能需要產生附加的 import 代碼,為原生模塊加載一個extern 類。Haxe提供聲明這樣的依賴關系在各自的目標語言向細節(第12章)的方式。。
> Some targets such as Python or JavaScript may require generating additional ”import” code that loads an extern class from a native module. Haxe provides ways to declare such dependencies also described in respective sections Target Details (Chapter 12).
**Haxe3.2.0以后剩余的參數和類型選擇**
> Rest arguments and type choices Since Haxe 3.2.0
haxe.extern 包提供兩種類型幫助映射原生的語義到Haxe:
> The haxe.extern package provides two types that help mapping native semantics to Haxe:
**Rest<T>** 這個類型可以被實用為一個最終的函數參數,來使傳遞一個額外的調用參數任意的數值到函數。類型參數可以被使用來限制這些參數為某個特定類型。
> **Rest<T>**: This type can be used as a ?nal function argument to allow passing an arbitrary number of additional call arguments. The type parameter can be used to constrain these arguments to a speci?c type.
**EitherType<T1, T2>**:這個類型允許使用任何一個類型參數類型,因此表示了一個類型選擇。它可以被嵌套來允許更多的類型。
> **EitherType<T1,T2>**: This type allows using either of its parameter types,thus representing a type choice. It can be nested to allow more than two different types.
我們在下面代碼示例中演示了其用法:
> We demonstrate the usage in this code sample:
~~~
import haxe.extern.Rest;
import haxe.extern.EitherType;
extern class MyExtern {
static function f1(s:String, r:Rest<Int>):Void;
static function f2(e:EitherType<Int, String>):Void;
}
class Main {
static function main() {
MyExtern.f1("foo", 1, 2, 3); // use 1, 2, 3 as rest argument
MyExtern.f1("foo"); // no rest argument
//MyExtern.f1("foo", "bar"); // String should be Int
MyExtern.f2("foo");
MyExtern.f2(12);
//MyExtern.f2(true); // Bool should be EitherType<Int, String>
}
}
~~~
- 空白目錄
- 1.Haxe介紹
- 1.1.Haxe是什么
- 1.2.關于本文檔
- 1.2.1.作者及貢獻者
- 1.2.2.License
- 1.3Hello World
- 1.4.Haxe的歷史
- 2.類型
- 2.1.基本類型
- 2.1.1.數值類型
- 2.1.2.溢出
- 2.1.3.數值運算符
- 2.1.4.Bool類型
- 2.1.5.Void類型
- 2.2.為空性
- 2.2.1.可選參數和為空性
- 2.3.類實例
- 2.3.1.類的構造函數
- 2.3.2.繼承
- 2.3.3.接口
- 2.4.枚舉實例
- 2.4.1.Enum構造函數
- 2.4.2.使用枚舉
- 2.5.匿名結構
- 2.5.1.結構值的JSON形式
- 2.5.2. 結構類型的類記法
- 2.5.3.可選字段
- 2.5.4.性能影響
- 2.6.函數類型
- 2.6.1.可選參數
- 2.6.2.默認值
- 2.7.動態類型
- 2.7.1.Dynamic使用類型參數
- 2.7.2.實現Dynamic
- 2.8.抽象類型
- 2.8.1.隱式類型轉換
- 2.8.2.運算符重載
- 2.8.3.數組訪問
- 2.8.4.選擇函數
- 2.8.5.枚舉抽象類型
- 2.8.6.轉發抽象類型字段
- 2.8.7.核心類型抽象
- 2.9.單形
- 3.類型系統
- 3.1.Typedef
- 3.1.1.擴展
- 3.2.類型參數
- 3.2.1.約束
- 3.3.泛型
- 3.3.1.泛型類型參數解釋
- 3.4.變異
- 3.5.統一
- 3.5.1.類/接口 之間
- 3.5.2.結構子類型化
- 3.5.3.單形
- 3.5.4.函數返回
- 3.5.5.通用基本類型
- 3.6.類型推斷
- 3.6.1.由上而下推斷
- 3.6.2.局限
- 3.7.模塊和路徑
- 3.7.1.模塊子類型
- 3.7.2.Import
- 3.7.3.解析順序
- 4.類字段
- 4.1.變量
- 4.2.屬性
- 4.2.1.常見訪問標識符組合
- 4.2.2.對類型系統的影響
- 4.2.3.getter和setter的規則
- 4.3.方法
- 4.3.1.重寫方法
- 4.3.2.變異和訪問修飾符的影響
- 4.4.訪問修飾符
- 4.4.1.可見性
- 4.4.2.Inline
- 4.4.3.Dynamic
- 4.4.4.Override
- 4.4.5.Static
- 5.表達式
- 5.1.塊
- 5.2.常量
- 5.3.二元操作符
- 5.4.一元操作符
- 5.5.數組聲明
- 5.6.對象聲明
- 5.7.字段訪問
- 5.8.數組訪問
- 5.9.函數調用
- 5.10.var
- 5.11.局部函數
- 5.12.new
- 5.13.for
- 5.14.while
- 5.15.do-while
- 5.16.if
- 5.17.switch
- 5.18.try/catch
- 5.19.return
- 5.20.break
- 5.21.continue
- 5.22.throw
- 5.23.類型轉換
- 5.23.1.不安全轉換
- 5.23.2.安全轉換
- 5.24.類型檢查
- 6.語言特性
- 6.1.條件編譯
- 6.2.Externs
- 6.3.靜態擴展
- 6.3.1.標準庫中的靜態擴展
- 6.4.模式匹配
- 6.4.1.介紹
- 6.4.2.枚舉匹配
- 6.4.3.變量捕獲
- 6.4.4.結構匹配
- 6.4.5.數組匹配
- 6.4.6.Or 模式
- 6.4.7.守護
- 6.4.8.多個值的匹配
- 6.4.9.提取器
- 6.4.10.窮盡性檢查
- 6.4.11.無效的模式檢查
- 6.5.字符串插值
- 6.6.數組推導
- 6.7.迭代器
- 6.8.函數綁定
- 6.9.元數據
- 6.10.訪問控制
- 6.11.內聯構造函數
- 7.編譯器用法
- 7.1.編譯器標記
- 8.編譯器功能
- 8.1.內建編譯器元數據
- 8.2.無用代碼消除
- 8.3.編譯器服務
- 8.3.1.概述
- 8.3.2.字段訪問完成
- 8.3.3.調用參數完成
- 8.3.4.類型路徑完成
- 8.3.5.使用完成
- 8.3.6.位置完成
- 8.3.7.頂級完成
- 8.3.8.完成服務
- 8.4.資源
- 8.4.1.嵌入資源
- 8.4.2.檢索文本資源
- 8.4.3.檢索二進制資源
- 8.4.4.實現細節
- 8.5.運行時類型信息
- 8.5.1.RTTI 結構
- 8.6.靜態分析儀
- 9.宏
- 9.1.宏上下文
- 9.2.參數
- 9.2.1.ExprOf
- 9.2.2.常數表達式
- 9.2.3.其它的參數
- 9.3.具體化
- 9.3.1.表達式具體化
- 9.3.2.類型具體化
- 9.3.3.類具體化
- 9.4.工具
- 9.5.類型構建
- 9.5.1.枚舉構建
- 9.5.2.@:autoBuild
- 9.5.3.@:genericBuild
- 9.6.限制
- 9.6.1.Macro-in-Macro
- 9.6.2.靜態擴展
- 9.6.3.構建順序
- 9.6.4.類型參數
- 9.7.初始化宏
- 10.標準庫
- 10.1.字符串
- 10.2.數據結構
- 10.2.1.數組
- 10.2.2.向量
- 10.2.3.列表
- 10.2.4.GenericStack
- 10.2.5.Map
- 10.2.6.Option
- 10.3.正則表達式
- 10.3.1.匹配
- 10.3.2.分組
- 10.3.3.替換
- 10.3.4.分割
- 10.3.5.Map
- 10.3.6.實現細節
- 10.4.Math
- 10.4.1.特殊數值
- 10.4.2.數學錯誤
- 10.4.3.整數數學
- 10.4.4.擴展
- 10.5.Lambda
- 10.6.模板
- 10.7.反射
- 10.8.序列化
- 10.8.1.格式化序列化
- 10.9.Xml
- 10.9.1.開始使用Xml
- 10.9.2.解析Xml
- 10.9.3.編碼Xml
- 10.10.Json
- 10.10.1.解析JSON
- 10.10.2.編碼JSON
- 10.10.3.實現細節
- 10.11.Input/Output
- 10.12.Sys/sys
- 10.13.遠程處理
- 10.13.1.遠程連接
- 10.13.2.實現細節
- 10.14.單元測試
- 11.Haxelib
- 11.1.Haxe編譯器使用庫
- 11.2.haxelib.json
- 11.2.1.版本控制
- 11.2.2.依賴關系
- 11.3.extraParams.hxml
- 11.4.使用Haxelib
- 12.目標平臺細節
- 12.1.JavaScript
- 12.1.1.開始使用Haxe/JavaScript
- 12.1.2.使用外部JavaScript庫
- 12.1.3.注入原生JavaScript
- 12.1.4.JavaScript untyped函數
- 12.1.5.調試JavaScript
- 12.1.6.JavaScript目標元數據
- 12.1.7.為JavaScript暴露Haxe類
- 12.1.8.使用 require函數加載外部類
- 12.2.Flash
- 12.2.1.開始使用Haxe/Flash
- 12.2.2.嵌入資源
- 12.2.3.使用外部Flash庫
- 12.2.4.Flash目標元數據
- 12.3.Neko
- 12.4.PHP
- 12.4.1.開始使用Haxe/PHP
- 12.4.2.PHP untyped函數
- 12.5.C++
- 12.5.1.Using C++定義
- 12.5.2.Using C++ 指針
- 12.6.Java
- 12.7.C#
- 12.8.Python