Explaining the concepts of Label (break and continue) in Dart #6451

J-Manoj-06 · 2025-02-22T18:51:47Z

This PR improves the Dart documentation by adding detailed explanations and examples for the break and continue statements in various loop structures (for, while, do-while, and nested loops).

The changes have made in two directories:

/examples/language/lib/control_flow/branches.dart
/src/content/language/branches.md

I’ve reviewed the contributor guide and applied the relevant portions to this PR.
This PR doesn't contain automatically generated corrections or text (Grammarly, LLMs, and similar).
This PR follows the Google Developer Documentation Style Guidelines — for example, it doesn't use i.e. or e.g., and it avoids I and we (first person).
This PR uses semantic line breaks of 80 characters or fewer.

This ensures and follows the contributing guidelines.
As per the issue , the Labels in Dart is explained with examples. Waiting for further improvements.

Fixes (#6289)

Best regards,
Manoj J

This is the change for updating the webpage in the https://dart.dev/libraries/async/using-streams . Adding a Youtube video for the topic streams makes the user better to understand the topic and reduce the difficulties of them.

antfitch · 2025-02-26T18:01:07Z

Thank you for this contribution! It looks like the staging docs did not build. Can you build the docs on your local machine and use the validator to validate your changes? https://github.com/dart-lang/site-www?tab=readme-ov-file#validate-your-changes

J-Manoj-06 · 2025-02-26T18:10:40Z

Yeah sure mam,
The documentation is in the progress!!
Thank you.

antfitch · 2025-02-26T18:15:16Z

Yeah sure mam, The documentation is in the progress!! Thank you.

Welcome and I can't wait to see the final version!

antfitch · 2025-02-26T21:39:43Z

/gcbrun

dart-github-bot · 2025-02-26T21:41:49Z

Visit the preview URL for this PR (updated for commit 099bc62):

https://dart-dev--pr6451-j-manoj-06-patch-4-773qilc0.web.app

J-Manoj-06 · 2025-02-27T02:03:25Z

Thank you, ma'am , That means a lot!

samujjal-gogoi

As per the issue , the Labels in Dart is explained with examples. Waiting for further improvements.

Fixes (#6289)

You haven't explained about label in this PR yet.

antfitch · 2025-02-27T21:18:06Z

Converted this to a draft. When it's ready for review, let us know. ^_^

J-Manoj-06 · 2025-02-28T01:37:44Z

Sorry for the delay mam!!
My semester exams is going on . So managing both creates some difficulties for me.
By tomorrow I will be updating the request.
Best regards,
Manoj J

J-Manoj-06 · 2025-02-28T05:08:35Z

Hello @antfitch mam,
I have updated the documentation in both branches.md and branches.dart directories. Please review it.
Waiting for further improvements.
Thank You.
Best Regards,
Manoj J

J-Manoj-06 · 2025-02-28T07:41:09Z

As per the issue , the Labels in Dart is explained with examples. Waiting for further improvements.
Fixes (#6289)

You haven't explained about label in this PR yet.

Hello @samujjal-gogoi ,
I have updated the branches directories.
Please make a review and I'm waiting for the improvements.
Thank you.
Best Regards ,
Manoj J

samujjal-gogoi · 2025-02-28T10:43:03Z

src/content/language/branches.md

@@ -138,6 +138,240 @@ switch (command) {
 }
 ```

+### Labels in Dart


Suggested change

### Labels in Dart

### Labels

Simple heading is preferred.

samujjal-gogoi · 2025-02-28T10:45:58Z

src/content/language/branches.md

+
+In Dart, labels are used to control nested loops(Loop inside Loop) using break and continue. Labels allow you to specify which loop to `break` or `continue`, rather than affecting the innermost loop by default.
+
+Here is the syntax for labels in Dart : 


Suggested change

Here is the syntax for labels in Dart :

Here is the syntax for labels in Dart:

Avoid space between the word and : (I've found multiple occurrences, please find and fix them all).

samujjal-gogoi · 2025-02-28T11:59:25Z

src/content/language/branches.md

@@ -138,6 +138,240 @@ switch (command) {
 }
 ```

+### Labels in Dart
+
+In Dart, labels are used to control nested loops(Loop inside Loop) using break and continue. Labels allow you to specify which loop to `break` or `continue`, rather than affecting the innermost loop by default.


Suggested change

In Dart, labels are used to control nested loops(Loop inside Loop) using break and continue. Labels allow you to specify which loop to `break` or `continue`, rather than affecting the innermost loop by default.

In Dart, labels are used to manage control flow in nested loops using `break` and `continue` statements. They allow you to specify which loop to break out of or continue, rather than affecting the innermost loop by default.

samujjal-gogoi · 2025-02-28T12:55:25Z

examples/language/lib/control_flow/branches.dart

Prefer single-quote string over double-quote string.

samujjal-gogoi · 2025-02-28T12:57:35Z

src/content/language/branches.md

+
+```
+
+In the above example, When `i == 2` and `j == 2`, `break outerLoop;` statement stops both inner and outer loops. So, the expected output would be :


Suggested change

In the above example, When `i == 2` and `j == 2`, `break outerLoop;` statement stops both inner and outer loops. So, the expected output would be :

In the above example, when `i == 2` and `j == 2`, `break outerLoop;` statement stops both inner and outer loops. So, the expected output would be:

Besides this, I've found multiple occurrences, please find and fix them all.

samujjal-gogoi · 2025-02-28T12:58:06Z

src/content/language/branches.md

+
+```
+
+#### Labels in for loop using `contiue` :


Suggested change

#### Labels in for loop using `contiue` :

#### Labels in for loop using `continue`:

Found a typo!

samujjal-gogoi · 2025-02-28T13:17:17Z

src/content/language/branches.md

+}
+
+```
+In the above example, the iteration for i = 2, j = 2 is skipped, and the loop moves directly to i = 3. As a result, the output would be:


Suggested change

In the above example, the iteration for i = 2, j = 2 is skipped, and the loop moves directly to i = 3. As a result, the output would be:

In the above example, the iteration for `i = 2` and `j = 2` is skipped, and the loop moves directly to `i = 3`. As a result, the output would be:

Looks like you forgot to wrap the values with backticks?

samujjal-gogoi · 2025-02-28T13:20:25Z

src/content/language/branches.md

+
+```
+
+In the above example, the loop skips i = 2, j = 2 and moves directly to i = 3. As a result, the output would be:


Suggested change

In the above example, the loop skips i = 2, j = 2 and moves directly to i = 3. As a result, the output would be:

In the above example, the loop skips `i = 2` and `j = 2` and moves directly to `i = 3`. As a result, the output would be:

Same backticks issue here as well.

samujjal-gogoi · 2025-02-28T13:24:22Z

src/content/language/branches.md

Consider removing all unnecessary leading and trailing newlines in code blocks.

samujjal-gogoi · 2025-02-28T13:40:11Z

Also, consider documenting Labels in loops.md file over branches.md file as it suits better there.

J-Manoj-06 · 2025-02-28T13:57:32Z

Also, consider documenting Labels in loops.md file over branches.md file as it suits better there.

Sir, would you like me to document Labels in loops.md instead of branches.md? Please confirm.
Thank you for your valuable suggestions, @samujjal-gogoi sir!

samujjal-gogoi · 2025-02-28T13:59:59Z

Also, consider documenting Labels in loops.md file over branches.md file as it suits better there.

Sir, would you like me to document Labels in loops.md instead of branches.md? Please confirm. Thank you for your valuable suggestions, @samujjal-gogoi sir!

Yes, at the end of the file (i.e after Break and continue section).

J-Manoj-06 · 2025-02-28T14:13:04Z

Okay, @samujjal-gogoi sir.
I'll notify you once the update is done.
Thank you.

J-Manoj-06 · 2025-03-03T15:49:21Z

Hello @samujjal-gogoi sir,
I have considered and updated all you suggestions . And it is ready for review.
Also waiting for further suggestions for improvements.
Thank You.
Best Regards,
Manoj J

samujjal-gogoi

Looks great so far!

samujjal-gogoi · 2025-03-03T18:14:41Z

examples/language/lib/control_flow/loops.dart

Prefer single quotes to satisfy the lint.

site-www/examples/analysis_options.yaml

Line 20 in 5d837cd

- prefer_single_quotes

samujjal-gogoi · 2025-03-03T18:16:28Z

src/content/language/loops.md

Consider removing all unnecessary leading and trailing newlines in code blocks.

antfitch · 2025-03-03T20:05:54Z

/gcbrun

Added editorial changes.

antfitch · 2025-03-03T21:14:15Z

Looking good! @J-Manoj-06, I've added editorial changes. Next, you'll need to connect the changes you made in examples/language/lib/control_flow/loops.dart to src/content/language/loops.md

In src/content/language/loops.md, take a close look at the source code in the For loops section. You'll notice they all start with <?code-excerpt "language/test/control_flow/..."?>

You want to add this line above all of your new samples and then generate the code excerpts to make sure that they run. If you have any issues, check out this doc: https://github.com/dart-lang/site-shared/tree/main/pkgs/excerpter#readme

J-Manoj-06 added 6 commits January 27, 2025 22:16

Update using-streams.md for adding YouTube Video

f60f5b2

This is the change for updating the webpage in the https://dart.dev/libraries/async/using-streams . Adding a Youtube video for the topic streams makes the user better to understand the topic and reduce the difficulties of them.

Update using-streams.md

876baa7

Merge branch 'dart-lang:main' into main

33afdba

Explaining labels in dart with example.

ec83957

Update branches.md

487e613

changing the branches.dart file

77f7112

J-Manoj-06 mentioned this pull request Feb 22, 2025

Need label documentation #6289

Open

1 task

antfitch self-requested a review February 26, 2025 00:28

samujjal-gogoi reviewed Feb 27, 2025

View reviewed changes

antfitch marked this pull request as draft February 27, 2025 21:17

J-Manoj-06 added 3 commits February 28, 2025 08:13

Merge branch 'dart-lang:main' into J-Manoj-06-patch-4

da83483

updated labels documentation in branch.md

70dab6e

Updated label in branches.dart

2449d12

J-Manoj-06 requested a review from samujjal-gogoi February 28, 2025 05:08

J-Manoj-06 added 3 commits February 28, 2025 14:00

Updated the error in branches.md

47b6201

Updated error in branches.dart

7d0f790

Updated error in branches.md

3344b7b

samujjal-gogoi reviewed Feb 28, 2025

View reviewed changes

J-Manoj-06 added 4 commits March 3, 2025 20:48

removed from branches.md

d3a1b40

Updated loops.md

84dbbc0

updated branches.dart

605e025

Documentation updated in loops.dart

099bc62

J-Manoj-06 marked this pull request as ready for review March 3, 2025 15:45

J-Manoj-06 requested a review from samujjal-gogoi March 3, 2025 15:45

samujjal-gogoi reviewed Mar 3, 2025

View reviewed changes

antfitch assigned J-Manoj-06 Mar 3, 2025

Update loops.md

1ef4187

Added editorial changes.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Explaining the concepts of Label (break and continue) in Dart #6451

Explaining the concepts of Label (break and continue) in Dart #6451

J-Manoj-06 commented Feb 22, 2025

antfitch commented Feb 26, 2025

J-Manoj-06 commented Feb 26, 2025

antfitch commented Feb 26, 2025

antfitch commented Feb 26, 2025

dart-github-bot commented Feb 26, 2025 •

edited by antfitch

Loading

J-Manoj-06 commented Feb 27, 2025

samujjal-gogoi left a comment

antfitch commented Feb 27, 2025

J-Manoj-06 commented Feb 28, 2025

J-Manoj-06 commented Feb 28, 2025

J-Manoj-06 commented Feb 28, 2025

samujjal-gogoi Feb 28, 2025

samujjal-gogoi Feb 28, 2025

samujjal-gogoi Feb 28, 2025

samujjal-gogoi Feb 28, 2025

samujjal-gogoi Feb 28, 2025

samujjal-gogoi Feb 28, 2025

samujjal-gogoi Feb 28, 2025

samujjal-gogoi Feb 28, 2025

samujjal-gogoi Feb 28, 2025

samujjal-gogoi commented Feb 28, 2025

J-Manoj-06 commented Feb 28, 2025

samujjal-gogoi commented Feb 28, 2025

J-Manoj-06 commented Feb 28, 2025

J-Manoj-06 commented Mar 3, 2025

samujjal-gogoi left a comment

samujjal-gogoi Mar 3, 2025

samujjal-gogoi Mar 3, 2025

antfitch commented Mar 3, 2025

antfitch commented Mar 3, 2025 •

edited

Loading


		In Dart, labels are used to control nested loops(Loop inside Loop) using break and continue. Labels allow you to specify which loop to `break` or `continue`, rather than affecting the innermost loop by default.

		Here is the syntax for labels in Dart :

	Here is the syntax for labels in Dart :
	Here is the syntax for labels in Dart:

	In Dart, labels are used to control nested loops(Loop inside Loop) using break and continue. Labels allow you to specify which loop to `break` or `continue`, rather than affecting the innermost loop by default.
	In Dart, labels are used to manage control flow in nested loops using `break` and `continue` statements. They allow you to specify which loop to break out of or continue, rather than affecting the innermost loop by default.


		```

		In the above example, When `i == 2` and `j == 2`, `break outerLoop;` statement stops both inner and outer loops. So, the expected output would be :

	#### Labels in for loop using `contiue` :
	#### Labels in for loop using `continue`:

	In the above example, the iteration for i = 2, j = 2 is skipped, and the loop moves directly to i = 3. As a result, the output would be:
	In the above example, the iteration for `i = 2` and `j = 2` is skipped, and the loop moves directly to `i = 3`. As a result, the output would be:


		```

		In the above example, the loop skips i = 2, j = 2 and moves directly to i = 3. As a result, the output would be:

	In the above example, the loop skips i = 2, j = 2 and moves directly to i = 3. As a result, the output would be:
	In the above example, the loop skips `i = 2` and `j = 2` and moves directly to `i = 3`. As a result, the output would be:

Explaining the concepts of Label (break and continue) in Dart #6451

Are you sure you want to change the base?

Explaining the concepts of Label (break and continue) in Dart #6451

Conversation

J-Manoj-06 commented Feb 22, 2025

antfitch commented Feb 26, 2025

J-Manoj-06 commented Feb 26, 2025

antfitch commented Feb 26, 2025

antfitch commented Feb 26, 2025

dart-github-bot commented Feb 26, 2025 • edited by antfitch Loading

J-Manoj-06 commented Feb 27, 2025

samujjal-gogoi left a comment

Choose a reason for hiding this comment

antfitch commented Feb 27, 2025

J-Manoj-06 commented Feb 28, 2025

J-Manoj-06 commented Feb 28, 2025

J-Manoj-06 commented Feb 28, 2025

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

samujjal-gogoi commented Feb 28, 2025

J-Manoj-06 commented Feb 28, 2025

samujjal-gogoi commented Feb 28, 2025

J-Manoj-06 commented Feb 28, 2025

J-Manoj-06 commented Mar 3, 2025

samujjal-gogoi left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

antfitch commented Mar 3, 2025

antfitch commented Mar 3, 2025 • edited Loading

dart-github-bot commented Feb 26, 2025 •

edited by antfitch

Loading

antfitch commented Mar 3, 2025 •

edited

Loading