delphi - Is there a way to escape a closing bracket for comments? -

-

i'm adding comments delphi code documentation. 1 of things i'm trying document json structure, i'm trying put sample json data commented in code. however, json uses squiggly brackets { }, coincidentally used comments in delphi.

because of this, can't figure out way add these comments. documentation comment blocks use { }, example:

{   unit , that.    use tsomecomponent bla bla }

when try document json data, closing bracket } ends comment - if line prefixed single-line comment //, doesn't work:

{   how json structure looks:  //    { //      "some_string": "value", //      "some_object": { //        "something": 123 //      }, //<-- compiler detects comma //      "something_else": "some other string" //    } }

as there's closing bracket }, commented line becomes uncommented, if it's prefixed 2 slashes. delphi picks comma after bracket. in end, cannot figure out way in can document json samples inside code.

i tried using (* *) around json block still no luck.

is there way around or stuck it?

i discovered solution while typing question, i'm answering q/a style...

when comment block first starts in code in question above, starts opening bracket {. so, compiler desperately looking find closing bracket, if closing bracket in commented line of code. but, if every line in comment block begins 2 slashes // instead of opening bracket {, compiler not looking closing bracket }. so, instead of code in question above, how should written:

//  how json structure looks: //   //    { //      "some_string": "value", //      "some_object": { //        "something": 123 //      }, //      "something_else": "some other string" //    }

so long don't start comment block opening bracket, compiler won't try end comment block when finds closing bracket.

also, using (* *) should work fine, long don't use after you've used {. enclose entire block (* , *) , compiler ignore { or } inside, so:

(*   how json structure looks:      {       "some_string": "value",       "some_object": {         "something": 123       },       "something_else": "some other string"     } *)

essentially, moment begin 1 comment, whether //, {, or (*, ignore further opening of other type of comment - looking end of own comment type. // end of line, { }, , (* *).


Comments

Post a Comment

Popular posts from this blog

javascript - Feed FileReader from server side files -

-
i´m starting customize/improve old audio editor project. can import audio tracks canvas via drag&drop computer. thing use audio tracks stored in server clicking on list of available tracks... instead of use <input type="file"> tags. how can read server side files filereader?ajax perhaps? in advance. this code file reader: player.prototype.loadfile = function(file, el) { //console.log(file); var reader = new filereader, filetypes = ['audio/mpeg', 'audio/mp3', 'audio/wave', 'audio/wav'], = this; if (filetypes.indexof(file.type) < 0) { throw('unsupported file format!'); } reader.onloadend = function(e) { if (e.target.readystate == filereader.done) { // done == 2 $('.progress').children().width('100%'); var onsuccess = function(audiobuffer) { $(el).trigger('audiee:fileloaded', [audiobuffer, file]); ...
Read more

How to Change swipe Tab Title color in java Android -

-
by default, view pager(swipe tabs) tab title color white want change orange. can 1 me please or share if have tutorial. thanks... use style in styles.xml , assign style tab layout. <style name="mymaterialtheme.tablayout" parent="widget.design.tablayout"> <item name="tabindicatorcolor">@android:color/white</item> <item name="tabindicatorheight">3dp</item> <item name="tabtextappearance">@style/mymaterialtheme.tablayout.textappearance</item> <item name="tabselectedtextcolor">@android:color/white</item> <item name="android:background">@color/colorprimary</item> </style> <style name="mymaterialtheme.tablayout.textappearance" parent="textappearance.design.tab"> <item name="android:textsize">14sp</item> <item name="android:textcolor">@color/tab_text_inactive</item> ...
Read more

Using globs in Perl replace one liner in TCL script -

-
i want run 1 perl 1 liner in tcl script below: exec perl -i -pe {s/substring/replacing_string/g} testfile; this works fine. but, if want modify files below: exec perl -i -pe {s/substring/replacing_string/g} *; it gives me error message: can't open '*': no such file or directory. while executing exec perl -i -pe {s/substring/replacing_string/g} *; i tried bracing '*', did not solve problem. requesting help... assuming files a , b , , c present in current working directory, executing echo * in shell prints a b c . because shell command evaluator recognizes wildcard characters , splices in list of 0 or more file names wildcard expression found. tcl's command evaluator not recognize wildcard characters, passes them unsubstituted command invoked. if command can work wildcards so. exec command doesn't, means pass wildcard expression shell command named command string. testing this, get % exec echo * * because asked shell exe...
Read more