dart-cheat-sheet
A curated list of awesome stuff needed to get started with your flutter development journey
Table of Contents
- String interpolation
- Functions
- Parsing
- List Arrays
- Lambda Functions
- Null-aware Operators
- Conditional Property Access
- Collections Literals
- Arrow Syntax
- Iterations
- Map
- Variables
- Class
- Getters and Setters
- Futures: Async and Await
- JSON and serialization
- Reading and decoding a file
- Sound null safety
String interpolation
Every language has it's own way of interpolating two or more words or characters. In dart, you can put value of an expression inside a string as follows:
Example
int x=6;
int y=2;
String sum = '${x+y}'; // result is 8
String subtraction = '${x-y}'; // result is 4
String upperCase = '${"hello".toUpperCase()}'; // result is HELLO
String concatXY = '$x$y'; // result is '62'Functions
Dart lang is an OOL(Object-oriented language), In this language, functions are objects and have a type, Function. This implies that functions can be assigned to variables or passed as args to other functions. Interestingly, you can also call an instance of a class as if it were a fuction. That's awesome, right?
Example
String fullName(){
String firstName = "Temidayo";
String lastName = "Adefioye";
return '$firstName $lastName'; // returns 'Temidayo Adefioye'
} int length(String text){
return text.length; // returns length of text
}The above function can be rewritten in a more concise way:
int length(String text) => return text.length; // returns length of textThe above approach is applicable where functions contain just ONE expression. This is also referred to as shorthand syntax.
Parsing
Parsing a string to a number such as integer and double is very key. As a developer, often times I need to convert(parse) a string value coming from a server-side to a number, tryParse method comes in handy. Take a look at this code snippet:
Example
var a = "121";
var b = "120.56";
var c = "100.a12";
var d = "abc";
String parseA = int.tryParse(a); // result is 121
String parseB = double.tryParse(b); // result is 120.56
String parseC = double.tryParse(c); // result is null (that string contains invalid number)
String parseD = double.tryParse(d); // result is null (that string contains invalid number)List Arrays
Perhaps the most common collection in nearly every programming language is the array or ordered set of objects. Please note that Dart arrays are Lists.
Example
var numList = [1,2,3,5,6,7];
var countryList = ["Nigeria","United States","United Kingdom","Ghana","IreLand","Germany"];
String numLength = numList.length; // result is 6
String countryLength = countryList.length; // result is 6
String countryIndex = countryList[1]; // result is 'United States'
String numIndex = numList[0]; // result is 1
countryList.add("Poland"); // Adds a new item to the list.
var emailList = new List(3); // Set a fixed list size
var emailList = new List<String>(); // instance of a list of type String
Lambda Functions
Lambda functions provide you with a short and concise way of representing small functions. They are also referred to as Arrow functions. In dart, if you need to write quick throw away functions without necessarily naming them, lambda fucntion is all you need. With the power of this function you can do the following and more:
Example
var numList = new List<int>.generate(5,(i) => i);
print(numList); //result: {0,1,2,3,4}
var loans = numList.map( (n) => "\#$n").toList();
print(loans); // result: {#0, #1, #3, #4}
printMsg()=> print("Hello world");
// You can declare a state function this way in flutter
_DashboardState createState() => _DashboardState();
// How about creating a widget using lambda?
Card makeCard(Asset assetViewModel) => Card(
elevation: 8.0,
margin: new EdgeInsets.symmetric(horizontal: 10.0, vertical: 6.0),
child: Container(
decoration: BoxDecoration(color: Colors.white),
child: makeListTile(assetViewModel), // where makeListTile is a custom widget created already
),
);
Null-aware Operators
Handling null exceptions in app development is very essential, as this allows you to create a seamless experience for your app users. Dart provides you with some handy operators for dealing with values that might be null. One is the ??= assignment operator, which assigns a value of a variable only if that variable is currently null:
Example
int x; // The initial value of any object is null
x ??=6;
print(x); // result: 6
x ??=3;
print(x); // result is still 6
print(null ?? 10); // result: 10. Display the value on the left if it's not null else return the value on the right
Conditional Property Access
To properly safegaurd access to a property or method of an object that might be null, put a question mark (?) before the (.)
Example
userObject?.userName
//The code snippet above is equivalent to following:
(userObject !=null) ? userObject.userName : null
//You can chain multiple uses of ?. together in a single expression
userObject?.userName?.toString()
// The preceeding code returns null and never calls toString() if either userObject or userObject.userName is null
Collections Literals
With literals you can create Dart's built-in lists, maps and sets without hassle.
Example
final fruitList = ["Orange","Bannana","Carrot","Apple"]; // A list of fruit
final countrySet = {"Nigeria","United States","Poland","Italy"}; // A set of country
final credMap = {
'userName': 'temi',
'password': 'xmen'
} // A map of user credentials
You maybe wondering why we didn't explicitly declare a type for all of the collections above. It's interesting to know that dart's type inference can assign types to these variables for you. In this case, the inferred types are List, Set and Map<String,String>.
Please note that you can choose to specify a type for your variable declaration like this:
final fruitList = <String>[];
final countrySet = <String>{};
final credMap = <String, String>{};
Arrow Syntax
Remember Lambda Functions as discussed earlier in this sheet? We used a symbol => to define our lambda expression. You can check out Lambda function section for more explanation.
Example
String _firstName = "Michael";
String _lastName = "Jones";
String _middleName = "Will";
String get fullName => '$_firstName $_middleName $_lastName'; // result: 'Michael Will Jones'
Iterations
Just like every other programming language out there, you can perform iterations in dart. Here is a for loop example
Example
for (int i=0; i<=20; i++){
print(i); // prints 1 to 20
}
var fruitList = ["Orange","Bannana","Carrot","Apple"];
for (final fruit in fruits){
print(fruit); // prints all types of fruit in the list
}
Map
Map can either be declared using literals or map constructor. To learn more about map declaration using literals, please go to the Collections Literals section. Here is how you can declare map using a map constructor:
Example
var user = new Map();
// To initialize the map, do this:
user['firstName'] = 'Paul';
user['lastName'] = 'Pogba';
// Result: {firstName: Paul, lastName: Pogba}
// Below are map properties
- Keys
- Values
- Length
- isEmpty
- isNotEmpty
// Below are map functions
- addAll()
- clear()
- remove()
- forEach()Variables
Here's an example of creating a variable and initializing it:
Example
int x = 2; // explicitly typed
var p = 5; // type inferred
p = "cool"; // ops! throws an error
dynamic z = 8; // variable can take on any type
z = "cool"; // cool
// if you never intend to change a variable use final or const. Something like this:
final email = "[email protected]"; // you can't change the value
final String email = "[email protected]"; // you can't change the value
// iPhone 11 Pro max calculator using const
const qty = 5;
const totalCost = 1099 * qty;
Class
In Dart, the class keyword is used to declare a class. Here is a basic example:
Example
class Car {
// field
String engine = "E1001";
// function
void disp() {
print(engine);
}
}
Getters and Setters
Getters and setters are special methods that provide read and write access to an object’s properties. Each instance variable of your class has an implicit getter, and a setter if needed. In dart, you can take this even further by implementing your own getters and setters. If you've had any experience in Object-Oriented Programming you'll feel right at home. Here is a basic syntax for a class:
Example
class className {
fields;
getters/setters
constructor
methods/functions
}class Person {
String firstName;
String lastName;
double height;
int personAge;
int yearofBirth;
double weight;
int get age {
return personAge;
}
void set age(int currentYear) {
personAge = currentYear - yearofBirth;
}
// We can also eliminate the setter and just use a getter.
//int get age {
// return DateTime.now().year - yearofBirth;
//}
Person({this.firstName,this.lastName,this.personAge,this.yearofBirth,this.weight});
}We can implement Person class this way:
void main() {
Person person = Person(firstName:"Thanos",lastName:"Rednos",yearofBirth:1990,weight:200.5);
print(person.firstName); // output - Thanos
print(person.lastName); // output - Rednos
person.age = 2019;
print(person.age); // output - 29
}Futures: Async and Await
The async and await keywords provide a declarative way to define asynchronous functions and use their results. Remember these two basic guidelines when using async and await:
- To define an async function, add async before the function body:
- The await keyword works only in async functions.
Example
Future<String> login() {
// Imagine that this function is
// more complex and slow.
String userName="Temidjoy";
return
Future.delayed(
Duration(seconds: 4), () => userName);
}
// Asynchronous
main() async {
print('Authenticating please wait...');
print(await userName());
}
JSON and serialization
Most mobile and web apps use JSON for tasks such as exchanging data with a web server. With Dart support for JSON serialization and deserialization: converting Dart objects to and from JSON, data exchange is made easy in flutter development.
The following libraries and packages are useful across Dart platform:
- dart:convert Converters for both JSON and UTF-8 (the character encoding that JSON requires).
- package:json_serializable An easy-to-use code generation package. When you add some metadata annotations and use the builder provided by this package, the Dart build system generates serialization and deserialization code for you.
- package:built_value A powerful, opinionated alternative to json_serializable.
You need to serialize and deserialize JSON in your Flutter project? see this example to quickly get started.
Reading and decoding a file
The code snippet below reads a file and runs two transforms over the stream. It first converts the data from UTF8 and then runs it through a LineSplitter. All lines are printed, except any that begin with a hashtag, #.
Example
import 'dart:convert';
import 'dart:io';
Future<void> main(List<String> args) async {
var file = File(args[0]);
var lines = utf8.decoder
.bind(file.openRead())
.transform(LineSplitter());
await for (var line in lines) {
if (!line.startsWith('#')) print(line);
}
}
Sound null safety
Sound null safety is now supported by the Dart language!
When you choose to use null safety, types in your code are by default non-nullable, which means variables cannot contain null unless you explicitly allow it. Your runtime null-dereference mistakes become edit-time analysis errors with null safety.
The variables in the following code are all non-nullable thanks to null safety:
// None of these can ever be null in null-safe Dart.
var x = 81; // Inferred to be an int.
String address = getAddress();
final c = Car();
Simply add ? to a variable's type declaration to indicate that it might be null:
// This is now a nullable Int.
int? x = null;
Enabling null safety
Sound null safety is available in Dart 2.12 and Flutter 2.
Migrating an existing package or app
For instructions on how to migrate your code to null safety, see the migration guide.