If expressions update #550

SJ-Nosrat · 2023-02-06T09:18:12Z

Update - `julia/concepts.wip/if-expressions`

Add blurb to config.json
Add intro to introduction.md
Add about to about.md

SaschaMann

I like the examples! I'm thinking perhaps it makes sense to have a very simple example without else or else-if above the more complicated ones. What do you think?

concepts.wip/if-expressions/about.md

SJ-Nosrat · 2023-02-06T11:30:45Z

I like the examples! I'm thinking perhaps it makes sense to have a very simple example without else or else-if above the more complicated ones. What do you think?

Sure, that's a good idea. Where do you want to put the examples in? Intro or about page? or Both?

SJ-Nosrat · 2023-02-06T12:21:41Z

I like the examples! I'm thinking perhaps it makes sense to have a very simple example without else or else-if above the more complicated ones. What do you think?

Sure, that's a good idea. Where do you want to put the examples in? Intro or about page? or Both?

I've added an example using only an if statement in the about.md page. Please let me know if that's okay? Thanks for your valued feedback.

SaschaMann · 2023-02-06T14:08:58Z

concepts.wip/if-expressions/about.md

+## A prompt program example
+
+Suppose you've defined a `password_checker(password)` function that returns `true`, if the password entered by the user is correct.
+
+```julia
+# Login prompt
+println("Enter Password: ")
+
+# Get user input
+password = readline()
+
+# Our main logic
+if password_checker(password)
+    println("Welcome!")
+end
+```
+Although the above program is not very realistic, but it shows the anatomy of an `if` statement. 
+
+In this case the `println("Welcome!")` is run, if the `password_checker(password)` returns `true`, otherwise it is skipped.


This is mostly a personal view, not an Exercism view, even though some other maintainers agree:

Imho any examples with reading input or printing anything should be avoided completely. So many people new to programming struggle with understanding the difference between printing and returning a value, often because their introductory classes or texts use printing everywhere. This is even more confusing in REPL settings where the difference is visually indistinguishable. To avoid this, I'd only print in an exercise that's explicitly about IO, not general examples or other exercises.

The example itself works but perhaps it could be turned into a function password_check(password)?

Thank you for explaining this. Understood, I've converted the example into a function, as suggested. Please let me know if the example is clear.

That's clearer, though I'd change it to return a string

SaschaMann · 2023-02-06T14:09:25Z

I've added an example using only an if statement in the about.md page. Please let me know if that's okay? Thanks for your valued feedback.

Works great!

cmcaine · 2023-02-08T12:42:34Z

concepts.wip/if-expressions/about.md

+julia> password_checker("xyz321")
+
+```
+`println("Welcome back!")` is run, if the `password == system_password`, otherwise it is skipped, and nothing is printed to the screen.


Suggested change

`println("Welcome back!")` is run, if the `password == system_password`, otherwise it is skipped, and nothing is printed to the screen.

`"Welcome back!"` is returned if `password == system_password`, otherwise that block is skipped and `nothing` is returned.

Func returns a string now. Maybe leave out the bit about nothing being returned.

cmcaine · 2023-02-08T12:45:38Z

concepts.wip/if-expressions/about.md

 ```

-<!-- TODO: Add that fancy concept highlight embed thing to boolean expression -->
+In the above chained expression, we can have mulitple `elseif` statements, with only one `else` statement at the end, but it's not necessary. 


Suggested change

In the above chained expression, we can have mulitple `elseif` statements, with only one `else` statement at the end, but it's not necessary.

In a chained if/elseif/else expression, we can have zero or more `elseif` expressions, and at most one `else` expression at the end.

cmcaine · 2023-02-08T12:47:35Z

concepts.wip/if-expressions/about.md

-If the boolean expression following the `if` evaluates to `false`, the first block of code is skipped and the second block is run.
-The program continues running at the first line of code after the `end` keyword.
+```julia
+# We can refine our coniditonal evaluation


Probably better to have the comments in the markdown rather than as code comments? There's a typo in conditional too

cmcaine · 2023-02-08T12:49:51Z

concepts.wip/if-expressions/introduction.md

+In Julia, `if`-expressions, are similar to those seen in other languages.
+
+~~~~exercism/note
+[`if`-expressions](https://docs.julialang.org/en/v1/manual/control-flow/#man-conditional-evaluation) as defined here will encompass the following syntaxes:`if`, `if-else` and `if-elseif-else` statements.


Suggested change

[`if`-expressions](https://docs.julialang.org/en/v1/manual/control-flow/#man-conditional-evaluation) as defined here will encompass the following syntaxes:`if`, `if-else` and `if-elseif-else` statements.

[`if`-expressions](https://docs.julialang.org/en/v1/manual/control-flow/#man-conditional-evaluation) as defined here will encompass the following syntaxes:`if`, `if-else` and `if-elseif-else`.

Not statements

cmcaine · 2023-02-08T12:50:31Z

concepts.wip/if-expressions/introduction.md

+[`if`-expressions](https://docs.julialang.org/en/v1/manual/control-flow/#man-conditional-evaluation) as defined here will encompass the following syntaxes:`if`, `if-else` and `if-elseif-else` statements.
+~~~~
+
+`if`-expressions provide the ability to execute certain statements in a _code block_ given that the condition is satisfied. In other words, it allows for branching in our programs.


Suggested change

`if`-expressions provide the ability to execute certain statements in a _code block_ given that the condition is satisfied. In other words, it allows for branching in our programs.

`if`-expressions provide the ability to execute certain expression in a _code block_ given that the condition is satisfied. In other words, it allows for branching in our programs.

cmcaine · 2023-02-08T12:50:47Z

concepts.wip/if-expressions/introduction.md

+
+`if`-expressions provide the ability to execute certain statements in a _code block_ given that the condition is satisfied. In other words, it allows for branching in our programs.
+
+## `if` statement example


Suggested change

## `if` statement example

## `if` example

cmcaine

Thanks for the PR! Here are some suggestions. Don't feel like you have to apply them.

cmcaine · 2023-02-08T12:51:22Z

concepts.wip/if-expressions/introduction.md

+julia> say_if_positive(-10)
+n is negative!
+```
+## `if`-`elseif`-`else` statement example


Suggested change

## `if`-`elseif`-`else` statement example

## `if`-`elseif`-`else` example

cmcaine · 2023-02-08T12:51:42Z

concepts.wip/if-expressions/introduction.md


 ~~~~exercism/note
 In Julia, the `end` keyword signifies the end of all block expressions.
 This syntax is not specific to `if`-expressions or function definitions.
 ~~~~

-In cases where the second block of code would be just another `if`-expression, `elseif` allows us to avoid nesting `if`-expressions within the block:
+## `if`-`else` statement example


Suggested change

## `if`-`else` statement example

## `if`-`else` example

cmcaine · 2023-02-08T12:52:37Z

concepts.wip/if-expressions/introduction.md


 ```julia
-julia> function say_if_positive(n)
+# Defining a function, allows to pass different values
+# to test. The if statement is the code block inside


Suggested change

# to test. The if statement is the code block inside

# to test. The if expression is the code block inside

cmcaine · 2023-02-08T12:53:08Z

concepts.wip/if-expressions/introduction.md

-julia> say_if_positive(10)
+# 10 > 0 which enters the if block
+# and executes the println("n is positive!") 
+# statement.


Suggested change

# statement.

# expression.

cmcaine · 2023-02-08T12:55:46Z

concepts.wip/if-expressions/.meta/config.json

@@ -1,5 +1,5 @@
 {
-  "blurb": "TODO: add blurb for if-expressions concept",
-  "authors": [],
+  "blurb": "if-expressions control the flow of a code block by allowing to execute certain statements, given that the conditional expression is satisfied.",


Suggested change

"blurb": "if-expressions control the flow of a code block by allowing to execute certain statements, given that the conditional expression is satisfied.",

"blurb": "if-expressions let the program choose whether to execute an expression or not based on some condition.",

cmcaine · 2023-02-08T12:56:42Z

concepts.wip/if-expressions/about.md

@@ -1,52 +1,87 @@
 # About

-`if`-expressions in Julia are similar to those seen in other languages:
+In Julia, like many other languages, allow for the following with `if`-expressions:


Suggested change

In Julia, like many other languages, allow for the following with `if`-expressions:

Julia, like many other languages, allows for the following `if`-expressions:

cmcaine · 2023-02-08T12:57:10Z

concepts.wip/if-expressions/about.md

+
+## A first example
+
+The `function` defined below is not very realistic, but it shows the anatomy of an `if` statement. 


Suggested change

The `function` defined below is not very realistic, but it shows the anatomy of an `if` statement.

The `function` defined below is not very realistic, but it shows the anatomy of an `if` expression.

SJ-Nosrat added 5 commits February 6, 2023 10:05

add blurb to config file in if-expression section

5e477ac

add intro to if-expressions section

66cf9fb

edit intro page in if expressions

bb03ead

add about page in if expressions

e6e0e1e

edit config file in if expressions

61417b1

SJ-Nosrat requested a review from a team as a code owner February 6, 2023 09:18

SaschaMann reviewed Feb 6, 2023

View reviewed changes

concepts.wip/if-expressions/about.md Outdated Show resolved Hide resolved

concepts.wip/if-expressions/about.md Outdated Show resolved Hide resolved

SJ-Nosrat added 2 commits February 6, 2023 14:17

edit intro page for grammar

97ad190

add simple example in about page and grammar check

c26627e

SaschaMann reviewed Feb 6, 2023

View reviewed changes

SJ-Nosrat added 2 commits February 6, 2023 21:16

modify first example to function to demonstrate if statement

4116e66

edit function example in about page for if expressions

72581e7

cmcaine reviewed Feb 8, 2023

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

If expressions update #550

If expressions update #550

SJ-Nosrat commented Feb 6, 2023

SaschaMann left a comment

SJ-Nosrat commented Feb 6, 2023

SJ-Nosrat commented Feb 6, 2023 •

edited

Loading

SaschaMann Feb 6, 2023

SJ-Nosrat Feb 6, 2023

SaschaMann Feb 7, 2023

SaschaMann commented Feb 6, 2023

cmcaine Feb 8, 2023

cmcaine Feb 8, 2023

cmcaine Feb 8, 2023 •

edited

Loading

cmcaine Feb 8, 2023

cmcaine Feb 8, 2023

cmcaine Feb 8, 2023

cmcaine left a comment

cmcaine Feb 8, 2023

cmcaine Feb 8, 2023

cmcaine Feb 8, 2023

cmcaine Feb 8, 2023

cmcaine Feb 8, 2023

cmcaine Feb 8, 2023

cmcaine Feb 8, 2023

	`println("Welcome back!")` is run, if the `password == system_password`, otherwise it is skipped, and nothing is printed to the screen.
	`"Welcome back!"` is returned if `password == system_password`, otherwise that block is skipped and `nothing` is returned.

	In the above chained expression, we can have mulitple `elseif` statements, with only one `else` statement at the end, but it's not necessary.
	In a chained if/elseif/else expression, we can have zero or more `elseif` expressions, and at most one `else` expression at the end.

	[`if`-expressions](https://docs.julialang.org/en/v1/manual/control-flow/#man-conditional-evaluation) as defined here will encompass the following syntaxes:`if`, `if-else` and `if-elseif-else` statements.
	[`if`-expressions](https://docs.julialang.org/en/v1/manual/control-flow/#man-conditional-evaluation) as defined here will encompass the following syntaxes:`if`, `if-else` and `if-elseif-else`.

	`if`-expressions provide the ability to execute certain statements in a _code block_ given that the condition is satisfied. In other words, it allows for branching in our programs.
	`if`-expressions provide the ability to execute certain expression in a _code block_ given that the condition is satisfied. In other words, it allows for branching in our programs.


		`if`-expressions provide the ability to execute certain statements in a _code block_ given that the condition is satisfied. In other words, it allows for branching in our programs.

		## `if` statement example

	## `if`-`elseif`-`else` statement example
	## `if`-`elseif`-`else` example

	# to test. The if statement is the code block inside
	# to test. The if expression is the code block inside

	"blurb": "if-expressions control the flow of a code block by allowing to execute certain statements, given that the conditional expression is satisfied.",
	"blurb": "if-expressions let the program choose whether to execute an expression or not based on some condition.",

	In Julia, like many other languages, allow for the following with `if`-expressions:
	Julia, like many other languages, allows for the following `if`-expressions:


		## A first example

		The `function` defined below is not very realistic, but it shows the anatomy of an `if` statement.

If expressions update #550

Are you sure you want to change the base?

If expressions update #550

Conversation

SJ-Nosrat commented Feb 6, 2023

Update - julia/concepts.wip/if-expressions

SaschaMann left a comment

Choose a reason for hiding this comment

SJ-Nosrat commented Feb 6, 2023

SJ-Nosrat commented Feb 6, 2023 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

SaschaMann commented Feb 6, 2023

Choose a reason for hiding this comment

Choose a reason for hiding this comment

cmcaine Feb 8, 2023 • edited Loading

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

cmcaine left a 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

Update - `julia/concepts.wip/if-expressions`

SJ-Nosrat commented Feb 6, 2023 •

edited

Loading

cmcaine Feb 8, 2023 •

edited

Loading