{"id":11298,"date":"2016-03-03T06:00:00","date_gmt":"2016-03-03T14:00:00","guid":{"rendered":"https:\/\/www.sapien.com\/blog\/?p=11298"},"modified":"2016-03-01T08:09:24","modified_gmt":"2016-03-01T16:09:24","slug":"theres-only-one-right-place-for-curly-braces","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2016\/03\/03\/theres-only-one-right-place-for-curly-braces\/","title":{"rendered":"There’s only one right place for curly braces"},"content":{"rendered":"

If you ever want to start an argument with programmers or scripters, mention your preferred code or script formatting habit.<\/p>\n

A tweet about the PowerShell backtick continuation character<\/a> or the placement of comment-based help for a function will elicit enough reaction to bring down a small server.<\/p>\n

But nothing gets people more riled up than the position of curly braces in a script block. On the same line or a separate line?<\/p>\n

\"clip_image002\"<\/a>
\nFrom 10PM.com<\/a><\/p>\n

First, PowerShell MVP Aleksandar Nikolic<\/a> will remind you (and rightly so!) that “curly braces” is redundant, because all braces are curly. That’s how you distinguish braces from brackets.<\/p>\n

Then, everyone who’s not on deadline, and a few people who are, will weigh in about how their curly brace placement is the right way. It’s the professional way. It’s the clearest way. It’s the historic way. It’s the new way.<\/p>\n

In general, PowerShell doesn’t care about white space or line breaks before curly braces in script blocks. They matter only in structures like hash tables. But, everyone else cares.<\/p>\n

Place open brace on new line (or not!)<\/h1>\n

PowerShell Studio wouldn’t dare to make the critical choice of curly brace placement for you. Instead, you decide where you want your curly braces in script blocks.<\/p>\n

To declare your choice:<\/p>\n

    \n
  1. In PowerShell Studio, click Home<\/b> and in the Windows group, click Options<\/b>.<\/li>\n
  2. Under Editor, click Formatting<\/b>.<\/li>\n
  3. Check or uncheck: Place open brace on a new line<\/b>.<\/li>\n<\/ol>\n

    The script diagram shows you the effect.<\/p>\n

    \"clip_image004\"<\/a><\/p>\n

    On the same Formatting page, you can also set your Triggers, that is, the characters on which PowerShell Studio evaluates and reformats for you, if necessary.<\/p>\n

    \"clip_image005\"<\/a><\/p>\n

    As a result, when you hit a trigger or click the amazing Format Script<\/b> button (Home\/Edit), PowerShell Studio formats your script with the curly braces where you want them.<\/p>\n

    Remember that Place open brace on a new line<\/strong> affects only basic script blocks, like those in an IF statement. It doesn’t affect other instances of curly braces, like those in hash tables, functions, or even the script blocks in event handlers.<\/p>\n

    So, there’s only one right place for curly braces in a script block. It’s where you want them.<\/p>\n

     <\/p>\n

    June Blender is a technology evangelist at SAPIEN Technologies, Inc. and a Windows PowerShell MVP. You can reach her at <\/em>juneb@sapien.com<\/em><\/a>\u00a0and follow her on Twitter at <\/em>@juneb_get_help<\/em><\/a>.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

    If you ever want to start an argument with programmers or scripters, mention your preferred code or script formatting habit. A tweet about the PowerShell backtick continuation character or the placement of comment-based help for a function will elicit enough reaction to bring down a small server. But nothing gets people more riled up than […]<\/p>\n","protected":false},"author":31,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[1034,703],"tags":[1064,85,934,1062,1016,1063],"class_list":["post-11298","post","type-post","status-publish","format-standard","hentry","category-best-practices","category-powershell-studio","tag-curly-braces","tag-formatting","tag-juneb","tag-options","tag-powershell-studio","tag-preferences"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/11298","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/31"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=11298"}],"version-history":[{"count":7,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/11298\/revisions"}],"predecessor-version":[{"id":11305,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/11298\/revisions\/11305"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=11298"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=11298"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=11298"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}