ArgumentError 类
当函数传入了不可接受的参数时,会抛出错误。
方法应记录其接受的参数的限制,例如如果整数参数必须非空,字符串参数必须非空,或者动态类型的参数实际上应该有几种接受的类型之一。
用户应该能够预测哪些参数会导致抛出错误,并避免使用这些参数。
几乎总是有必要将不可接受的价值作为错误的一部分提供,以帮助用户找出哪里出错了,因此 ArgumentError.value 构造函数是首选构造函数。只有当某些原因无法提供值时,才应使用 ArgumentError.new。
- 继承
- 实现者
构造函数
- ArgumentError([dynamic message, @Since("2.14") String? name])
- 创建一个描述参数问题的错误 message。
- ArgumentError.notNull([String? name])
- 为必须非空的
null
参数创建一个参数错误。 - ArgumentError.value(dynamic value, [String? name, dynamic message])
- 创建包含无效
value
的错误。
属性
- hashCode → int
- 此对象的哈希码。no setterinherited
- invalidValue → dynamic
- 无效的值。final
- message → dynamic
- 描述问题的消息。final
- name → String?
- 如果可用,无效参数的名称。final
- runtimeType→ Type
- 对象运行时类型的表示。no setterinherited
- stackTrace→ StackTrace?
- 此错误首次抛出时的堆栈跟踪。no setterinherited
方法
-
noSuchMethod(
Invocation invocation) → dynamic - 当访问不存在的方法或属性时调用。inherited
-
toString(
) → String - 此对象的字符串表示形式。override
运算符
-
operator ==(
Object other) → bool - 相等运算符。inherited
静态方法
-
checkNotNull<
@Since("2.8") T> (T? argument, [String? name]) → T - 如果
argument
为null
,将抛出异常。