{"id":107448,"date":"2022-11-24T07:00:00","date_gmt":"2022-11-24T15:00:00","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/oldnewthing\/?p=107448"},"modified":"2022-11-24T06:21:37","modified_gmt":"2022-11-24T14:21:37","slug":"20221124-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20221124-00\/?p=107448","title":{"rendered":"How does JavaScript represent output parameters in the Windows Runtime?"},"content":{"rendered":"

The Windows Runtime allows parameters to be declared as out<\/code>, which means that the variable is passed by reference and will be written to, but not read from, by the method. (At the ABI layer, the variable is passed by address.)<\/p>\n

runtimeclass MyClass\r\n{\r\n    Boolean TryGetCount(out Int32 count);\r\n}\r\n<\/pre>\n
Many languages support passing variables by reference, and the projection aligns with those language features.<\/p>\n
\/\/ C#\r\nint count;\r\nif (c.TryGetCount(out count)) ...\r\n\r\n\/\/ C# 7.0\r\nif (c.TryGetCount(out int count)) ...\r\n\r\n\/\/ Visual Basic\r\nDim count as Integer\r\nIf c.TryGetCount(count) Then\r\n    ...\r\nEnd If\r\n\r\n\/\/ C++\/WinRT\r\nint count;\r\nif (c.TryGetCount(count)) ...\r\n\r\n\/\/ Rust\/WinRT\r\nlet mut count = 0;\r\nif (c.TryGetCount(&mut count)) ...\r\n<\/pre>\n
JavaScript, on the other hand, does not support passing variables by reference. To work around this, any method that has an out<\/code> parameter is rewritten by returning a JavaScript object with a property called result<\/code> which contains the original return value, and with additional properties, one for each out<\/code> parameter. The original out<\/code> parameters disappear from the formal parameter list.<\/p>\n
var retVal = c.tryGetCount();\r\nif (retVal.result) {\r\n    console.log(retVal.count);\r\n}\r\n<\/pre>\n
The return value of the original TryGetCount<\/code> method is recorded as the result<\/code> property, and the count<\/code> that was returned by the original method becomes a count<\/code> property.<\/p>\n
The name of the formal parameter is not just a documentation nicety in JavaScript. The name of the formal parameter is part of the programming interface because it becomes the name of the property!\u00b9<\/p>\n
Python also doesn’t support passing variables by reference. It performs a transform similar to JavaScript, but instead of returning an Object, it returns a tuple.<\/p>\n
\/\/ Python\/WinRT\r\nresult, count = c.try_get_count();\r\n<\/pre>\n
This awkwardness with output parameters in JavaScript and Python makes output parameters slightly less attractive in the Windows Runtime.<\/p>\n
\u00b9 In the Windows Runtime, parameter names are considered part of the interface, and changing parameter names is a breaking change. We saw how JavaScript can be affected by changing the name of a formal parameter. The name is also programmatically significant in C#, since C# lets you pass parameters by name, which is particularly handy for parameters of numeric or Boolean type.<\/p>\n
var trigger = new TimeTrigger(freshnessTime: 60, oneShot: true);\r\n\r\nvar inkPoint = new InkPoint(position,\r\n                    pressure: 0.5, tiltX: 0.0, tiltY: 0.0, timestamp: 0);\r\n<\/pre>\n","protected":false},"excerpt":{"rendered":"
It has to fake it.<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25],"class_list":["post-107448","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
It has to fake it.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/107448","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=107448"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/107448\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=107448"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=107448"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=107448"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}