Commit 4ce8c94e authored by Jacob Richman's avatar Jacob Richman Committed by GitHub

Use the phrase "must not be null" everywhere instead of "cannot be null" (#11683)

when describing non-nullable method arguments.
parent 47fe630e
...@@ -112,7 +112,7 @@ class AnimationController extends Animation<double> ...@@ -112,7 +112,7 @@ class AnimationController extends Animation<double>
/// null. /// null.
/// ///
/// * `vsync` is the [TickerProvider] for the current context. It can be /// * `vsync` is the [TickerProvider] for the current context. It can be
/// changed by calling [resync]. It is required and cannot be null. See /// changed by calling [resync]. It is required and must not be null. See
/// [TickerProvider] for advice on obtaining a ticker provider. /// [TickerProvider] for advice on obtaining a ticker provider.
AnimationController({ AnimationController({
double value, double value,
...@@ -140,7 +140,7 @@ class AnimationController extends Animation<double> ...@@ -140,7 +140,7 @@ class AnimationController extends Animation<double>
/// debugging (used by [toString]). /// debugging (used by [toString]).
/// ///
/// * `vsync` is the [TickerProvider] for the current context. It can be /// * `vsync` is the [TickerProvider] for the current context. It can be
/// changed by calling [resync]. It is required and cannot be null. See /// changed by calling [resync]. It is required and must not be null. See
/// [TickerProvider] for advice on obtaining a ticker provider. /// [TickerProvider] for advice on obtaining a ticker provider.
/// ///
/// This constructor is most useful for animations that will be driven using a /// This constructor is most useful for animations that will be driven using a
......
...@@ -233,7 +233,7 @@ class DataTable extends StatelessWidget { ...@@ -233,7 +233,7 @@ class DataTable extends StatelessWidget {
/// The [columns] argument must be a list of as many [DataColumn] /// The [columns] argument must be a list of as many [DataColumn]
/// objects as the table is to have columns, ignoring the leading /// objects as the table is to have columns, ignoring the leading
/// checkbox column if any. The [columns] argument must have a /// checkbox column if any. The [columns] argument must have a
/// length greater than zero and cannot be null. /// length greater than zero and must not be null.
/// ///
/// The [rows] argument must be a list of as many [DataRow] objects /// The [rows] argument must be a list of as many [DataRow] objects
/// as the table is to have rows, ignoring the leading heading row /// as the table is to have rows, ignoring the leading heading row
......
...@@ -851,7 +851,7 @@ typedef bool SelectableDayPredicate(DateTime day); ...@@ -851,7 +851,7 @@ typedef bool SelectableDayPredicate(DateTime day);
/// ///
/// An optional [initialDatePickerMode] argument can be used to display the /// An optional [initialDatePickerMode] argument can be used to display the
/// date picker initially in the year or month+day picker mode. It defaults /// date picker initially in the year or month+day picker mode. It defaults
/// to month+day, but cannot be null. /// to month+day, but must not be null.
/// ///
/// See also: /// See also:
/// ///
...@@ -872,7 +872,7 @@ Future<DateTime> showDatePicker({ ...@@ -872,7 +872,7 @@ Future<DateTime> showDatePicker({
selectableDayPredicate == null || selectableDayPredicate(initialDate), selectableDayPredicate == null || selectableDayPredicate(initialDate),
'Provided initialDate must satisfy provided selectableDayPredicate' 'Provided initialDate must satisfy provided selectableDayPredicate'
); );
assert(initialDatePickerMode != null, 'initialDatePickerMode cannot be null'); assert(initialDatePickerMode != null, 'initialDatePickerMode must not be null');
return await showDialog( return await showDialog(
context: context, context: context,
child: new _DatePickerDialog( child: new _DatePickerDialog(
......
...@@ -73,10 +73,10 @@ import 'constants.dart'; ...@@ -73,10 +73,10 @@ import 'constants.dart';
class TabController extends ChangeNotifier { class TabController extends ChangeNotifier {
/// Creates an object that manages the state required by [TabBar] and a [TabBarView]. /// Creates an object that manages the state required by [TabBar] and a [TabBarView].
/// ///
/// The [length] cannot be null or negative. Typically its a value greater than one, i.e. /// The [length] must not be null or negative. Typically its a value greater than one, i.e.
/// typically there are two or more tabs. /// typically there are two or more tabs.
/// ///
/// The `initialIndex` must be valid given [length] and cannot be null. If [length] is /// The `initialIndex` must be valid given [length] and must not be null. If [length] is
/// zero, then `initialIndex` must be 0 (the default). /// zero, then `initialIndex` must be 0 (the default).
TabController({ int initialIndex: 0, @required this.length, @required TickerProvider vsync }) TabController({ int initialIndex: 0, @required this.length, @required TickerProvider vsync })
: assert(length != null && length >= 0), : assert(length != null && length >= 0),
......
...@@ -402,15 +402,15 @@ class _TabBarScrollController extends ScrollController { ...@@ -402,15 +402,15 @@ class _TabBarScrollController extends ScrollController {
class TabBar extends StatefulWidget implements PreferredSizeWidget { class TabBar extends StatefulWidget implements PreferredSizeWidget {
/// Creates a material design tab bar. /// Creates a material design tab bar.
/// ///
/// The [tabs] argument cannot be null and its length must match the [controller]'s /// The [tabs] argument must not be null and its length must match the [controller]'s
/// [TabController.length]. /// [TabController.length].
/// ///
/// If a [TabController] is not provided, then there must be a /// If a [TabController] is not provided, then there must be a
/// [DefaultTabController] ancestor. /// [DefaultTabController] ancestor.
/// ///
/// The [indicatorWeight] parameter defaults to 2, and cannot be null. /// The [indicatorWeight] parameter defaults to 2, and must not be null.
/// ///
/// The [indicatorPadding] parameter defaults to [EdgeInsets.zero], and cannot be null. /// The [indicatorPadding] parameter defaults to [EdgeInsets.zero], and must not be null.
TabBar({ TabBar({
Key key, Key key,
@required this.tabs, @required this.tabs,
...@@ -980,7 +980,7 @@ class _TabBarViewState extends State<TabBarView> { ...@@ -980,7 +980,7 @@ class _TabBarViewState extends State<TabBarView> {
class TabPageSelectorIndicator extends StatelessWidget { class TabPageSelectorIndicator extends StatelessWidget {
/// Creates an indicator used by [TabPageSelector]. /// Creates an indicator used by [TabPageSelector].
/// ///
/// The [backgroundColor], [borderColor], and [size] parameters cannot be null. /// The [backgroundColor], [borderColor], and [size] parameters must not be null.
const TabPageSelectorIndicator({ const TabPageSelectorIndicator({
Key key, Key key,
@required this.backgroundColor, @required this.backgroundColor,
......
...@@ -41,7 +41,7 @@ class Tooltip extends StatefulWidget { ...@@ -41,7 +41,7 @@ class Tooltip extends StatefulWidget {
/// By default, tooltips prefer to appear below the [child] widget when the /// By default, tooltips prefer to appear below the [child] widget when the
/// user long presses on the widget. /// user long presses on the widget.
/// ///
/// The [message] argument cannot be null. /// The [message] argument must not be null.
const Tooltip({ const Tooltip({
Key key, Key key,
@required this.message, @required this.message,
......
...@@ -67,7 +67,7 @@ class ImageCache { ...@@ -67,7 +67,7 @@ class ImageCache {
/// if not, calls the given callback to obtain it first. In either case, the /// if not, calls the given callback to obtain it first. In either case, the
/// key is moved to the "most recently used" position. /// key is moved to the "most recently used" position.
/// ///
/// The arguments cannot be null. The `loader` cannot return null. /// The arguments must not be null. The `loader` cannot return null.
ImageStreamCompleter putIfAbsent(Object key, ImageStreamCompleter loader()) { ImageStreamCompleter putIfAbsent(Object key, ImageStreamCompleter loader()) {
assert(key != null); assert(key != null);
assert(loader != null); assert(loader != null);
......
...@@ -403,7 +403,7 @@ class DecoratedBoxTransition extends AnimatedWidget { ...@@ -403,7 +403,7 @@ class DecoratedBoxTransition extends AnimatedWidget {
/// Creates an animated [DecoratedBox] whose [Decoration] animation updates /// Creates an animated [DecoratedBox] whose [Decoration] animation updates
/// the widget. /// the widget.
/// ///
/// The [decoration] and [position] cannot be null. /// The [decoration] and [position] must not be null.
/// ///
/// See also: /// See also:
/// ///
......
...@@ -22,7 +22,7 @@ import 'framework.dart'; ...@@ -22,7 +22,7 @@ import 'framework.dart';
abstract class UniqueWidget<T extends State<StatefulWidget>> extends StatefulWidget { abstract class UniqueWidget<T extends State<StatefulWidget>> extends StatefulWidget {
/// Creates a widget that has exactly one inflated instance in the tree. /// Creates a widget that has exactly one inflated instance in the tree.
/// ///
/// The [key] argument cannot be null because it identifies the unique /// The [key] argument must not be null because it identifies the unique
/// inflated instance of this widget. /// inflated instance of this widget.
const UniqueWidget({ const UniqueWidget({
@required GlobalKey<T> key, @required GlobalKey<T> key,
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment