Dart Symbol

2025年3月17日 | 阅读 3 分钟

Symbol 对象用于指定在 Dart 编程语言中声明的运算符或标识符。一般来说，我们在 Dart 编程中不需要使用符号，但它们对 API 很有帮助。它通常通过名称引用标识符，因为标识符名称可以变化，但标识符符号不能。

Dart 符号是动态字符串名称，用于从库中派生元数据。它主要积累了增强供计算机使用的可读字符串之间的连接。

符号有一个术语，称为反射；它是一种在运行时使用元数据的技术，例如 - 类中使用的函数数量，类中构造函数的数量，或函数中参数的数量。

dart:mirrors 库拥有所有与反射相关的类。它可用于命令行应用程序以及 Web 应用程序。

语法 -

hash(#) 符号，后跟名称用于在 Dart 中定义 Symbol。语法如下所示。

语法 -

在这里，有效的标识符，例如函数、有效的类、公共成员名称或库名称，可以用于代替 name 值。

#radix
#bar

让我们理解下面的例子。

示例 -

library foo_lib;   
// libarary name can be a symbol   

class Foo {         
   // class name can be a symbol  
   m1() {        
      // method name can be a symbol 
      print("Inside m1"); 
   } 
   m2() { 
      print("Inside m2"); 
   } 
   m3() { 
      print("Inside m3"); 
   } 
}

在上面的代码中，我们在库 foo_lib 中声明了一个名为 Foo 的类。该类包含方法 m1、m2 和 m3。我们将上面的文件保存为 foo.dart。

现在，我们正在创建新文件 FooSymbol.dart 并运行以下代码。

FoolSystem.dart

import 'dart:core'; 
import 'dart:mirrors'; 
import 'Foo.dart';  

main() { 
   Symbol lib = new Symbol("foo_lib");   
   //library name stored as Symbol 
   
   Symbol clsToSearch = new Symbol("Foo");  
   // class name stored as Symbol  
   
   if(checkIf_classAvailableInlibrary(lib, clsToSearch))  
   // searches Foo class in foo_lib library 
      print("class found.."); 
}  
   
bool checkIf_classAvailableInlibrary(Symbol libraryName, Symbol className) { 
   MirrorSystem mirrorSystem = currentMirrorSystem(); 
   LibraryMirror libMirror = mirrorSystem.findLibrary(libraryName); 
      
   if (libMirror != null) { 
      print("Found Library"); 
      print("checkng...class details.."); 
      print("No of classes found is : ${libMirror.declarations.length}"); 
      libMirror.declarations.forEach((s, d) => print(s));  
         
      if (libMirror.declarations.containsKey(className)) return true; 
      return false; 
   } 
}
</pre></div>
<p>The above code will show the following output.</p>
<p><strong>Output:</strong></p>
<div class="codeblock"><pre>
Found Library
checkng...class details..
No of classes found is : 1
Symbol("Foo") // Displays the class name
class found..
</pre></div>
<p><strong>Example - 2 : Print the number of instance methods of class</strong></p>
<p>In the following example, The Dart provides predefine class <strong>ClassMirror</strong> which helps us to display the number of instance methods of class.</p>
<p><strong>Example -</strong></p>
<div class="codeblock"><textarea name="code" class="java">
import 'dart:core'; 
import 'dart:mirrors'; 
import 'Foo.dart';  

main() { 
   Symbol lib = new Symbol("foo_lib"); 
   Symbol clsToSearch = new Symbol("Foo");  
   reflect_InstanceMethods(lib, clsToSearch); 
}  
void reflect_InstanceMethods(Symbol libraryName, Symbol className) { 
   MirrorSystem mirrorSystem = currentMirrorSystem(); 
   LibraryMirror libMirror = mirrorSystem.findLibrary(libraryName); 
   
   if (libMirror != null) { 
      print("Found Library"); 
      print("checkng...class details.."); 
      print("No of classes found is : ${libMirror.declarations.length}"); 
      libMirror.declarations.forEach((s, d) => print(s));  
      
      if (libMirror.declarations.containsKey(className)) print("found class");
      ClassMirror classMirror = libMirror.declarations[className]; 
      
      print("No of instance methods found is ${classMirror.instanceMembers.length}");
      classMirror.instanceMembers.forEach((s, v) => print(s)); 
   } 
}   

输出

Found Library
checkng...class details..
No of classes found is : 1
Symbol("Foo")
found class
No of instance methods found is 8
Symbol("==")
Symbol("hashCode")
Symbol("toString")
Symbol("noSuchMethod")
Symbol("runtimeType")
Symbol("m1")
Symbol("m2")
Symbol("m3")

Dart 将 Symbol 转换为 String

我们可以使用内置类 MirrorClass 将 Dart 符号转换为字符串，该类由 dart:mirror 包提供。让我们理解以下示例。

示例 -

import 'dart:mirrors'; 
void main(){ 
   Symbol lib = new Symbol("foo_lib"); 
   String name_of_lib = MirrorSystem.getName(lib); 
   
   print(lib); 
   print(name_of_lib); 
}

输出