first method
Returns the first n
characters of the String
.
n is optional, by default it returns the first character of the String
.
If n
provided is longer than the String
's length, the string will be returned.
Faster than using
substring(0,count)
Example 1
String foo = 'hello world';
String firstChars = foo.first(); // returns 'h'
Example 2
String foo = 'hello world';
bool firstChars = foo.first(3); // returns 'hel'
Implementation
String? first({int n = 1}) {
if (this.isBlank || this!.length < n || n < 0) {
return this;
}
return this!.substring(0, n);
}