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

Load Balancing in Bluemix using custom domain and DNS SRV records -

-
i'm trying load balancing of application in bluemix using custom domain , srv record in dns manager. created own doamin ccbluemix.dynu.com , added custom domain bluemix. created application in region , created route custom domain myapp.ccbluemix.dynu.com deployed same application in uk region , created route custom domain myapp.ccbluemix.dynu.com there well. now whenever user hits route want load balancing between , uk region alternate requests served , uk regions. for created srv records like _http._tcp.ccbluemix.dynu.com srv eu-gb.mybluemix.net [priority: 0] [weight: 50] 10 _http._tcp.ccbluemix.dynu.com srv mybluemix.net [priority: 0] [weight: 50] 10 but nothing happening , i'm not able access application using custom route @ all. if create 'a' record cc-load-bal-app.ccbluemix.dynu.com 75.126.81.68 i can access app using custom route ends hitting server. how can achieve load balancing using srv records? wrong creating srv records here? i read ne...
Read more

oracle - pls-00402 alias required in select list of cursor to avoid duplicate column names -

-
my cursor : select xzis.msisdn msisdn, xzis.in_account_number in_account_number xxobw_zte_in_sync xzis not exists (select 1 hz_contact_points hcp, hz_cust_accounts hca hcp.owner_table_id = hca.party_id , hcp.owner_table_name = 'hz_parties' , hcp.phone_number = substr (xzis.msisdn, -8) , nvl (hca.attribute12, 'nil') = xzis.in_account_number); i have given alias columns, still facing issue. suggestions? it's cursor. 1 has no such problems. problem is, when you're joining 2 tables, or apply wrong aliases in subselect, cursor may @ end return 2 columns same name/alias. the problem not need alias, no 2 columns can have same alias (the name counting alias, when no alias given). apparently has happened, far can tell, it's ...
Read more

python - Consider setting $PYTHONHOME to <prefix>[:<exec_prefix>] error -

-
Image
i getting same error when python manage.py runserver. there no such error when have ubuntu 15.10. got started when upgraded ubuntu 16.04. question might duplicate have tried solution provided question have applied command dpkg --configure -a, have done apt-get update,upgrade,dist-upgrade, clean, -f install. have reinstalled python2.7 , python3 no success though. here screenshot while trying run django application i got after re-installing python please me? bashrc file # ~/.bashrc: executed bash(1) non-login shells. # see /usr/share/doc/bash/examples/startup-files (in package bash-doc) # examples # if not running interactively, don't case $- in *i*) ;; *) return;; esac export pythonhome="/usr/bin/python" echo $virtualenvwrapper_python echo 'tushant' # don't put duplicate lines or lines starting space in history. # see bash(1) more options histcontrol=ignoreboth # append history file, don't overwrite shopt -s histappend # setting h...
Read more