Difference between revisions of "End-of-line"

From NMReDATA
Jump to: navigation, search
(cleanup of typos)
Line 1: Line 1:
NMReDATA tags use backslash("\") as end-of-line character. This is because some functions of CDK libraries sometimes ignore end-of-line (char 10) and because the NMReDATA format needs an line separator we introduced the backslash. When reading tags, we have to ignore the usual end-of-line character (ASCII code 10) except for Version 1 of the NMReDATA.
+
NMReDATA tags use backslash ("\") as end-of-line character. This is because some functions of CDK libraries sometimes ignore end-of-line (<EOL>, ASCII code 10); since the NMReDATA format needs a line separator, we introduced the backslash. When reading tags, we have to ignore the usual <EOL> except for Version 1 of the NMReDATA.
  
 
Tag should look like this...
 
Tag should look like this...
  
 
  >  <NMREDATA_ASSIGNMENT>
 
  >  <NMREDATA_ASSIGNMENT>
  A, 48.3010, 1 ;the label "A" corresponds to the atom one which is the carbon of the CH2<span style="color:#0808F8">'''\'''</span>
+
  A, 48.3010, 1 ;the label "A" corresponds to atom one which is the carbon of the CH2<span style="color:#0808F8">'''\'''</span>
 
  B, 20.3220, 2 ;atom two is the carbon of the CH3<span style="color:#0808F8">'''\'''</span>
 
  B, 20.3220, 2 ;atom two is the carbon of the CH3<span style="color:#0808F8">'''\'''</span>
 
  a, 2.6100, H3 ;"H3" refers to the hydrogen atom of atom 3 (the oxygen)<span style="color:#0808F8">'''\'''</span>
 
  a, 2.6100, H3 ;"H3" refers to the hydrogen atom of atom 3 (the oxygen)<span style="color:#0808F8">'''\'''</span>
Line 10: Line 10:
 
  c, 1.4010, H2<span style="color:#0808F8">'''\'''</span>
 
  c, 1.4010, H2<span style="color:#0808F8">'''\'''</span>
  
but it may look like this  
+
but it may look like this ''(note how data items 2, 3 and 4 are split across two lines)''
  
>  <NMREDATA_ASSIGNMENT>
+
>  <NMREDATA_ASSIGNMENT>
 
  A, 48.3010, 1 ;the label "A" corresponds to the atom one which is the carbon of the CH2<span style="color:#0808F8">'''\'''</span>
 
  A, 48.3010, 1 ;the label "A" corresponds to the atom one which is the carbon of the CH2<span style="color:#0808F8">'''\'''</span>
 
  B, 20.3220,  
 
  B, 20.3220,  
Line 22: Line 22:
 
  c, 1.4010, H2<span style="color:#0808F8">'''\'''</span>
 
  c, 1.4010, H2<span style="color:#0808F8">'''\'''</span>
  
Note: There will never be two consecutive character 10, because this is the end-of-tag signal.
+
Note: There will never be two consecutive <EOL>, because this is the end-of-tag signal.
  
Conclusion, when reading tags, the 10, should be ignored and then the \ be replace with 10.
+
Conclusion: when reading tags, the <EOL> should be ignored and then the "\" be replaced with <EOL>.
When writing, the 10 should always come after a backslash.
+
When writing, the <EOL> should always come after a backslash.

Revision as of 17:03, 19 May 2019

NMReDATA tags use backslash ("\") as end-of-line character. This is because some functions of CDK libraries sometimes ignore end-of-line (<EOL>, ASCII code 10); since the NMReDATA format needs a line separator, we introduced the backslash. When reading tags, we have to ignore the usual <EOL> except for Version 1 of the NMReDATA.

Tag should look like this...

>  <NMREDATA_ASSIGNMENT>
A, 48.3010, 1 ;the label "A" corresponds to atom one which is the carbon of the CH2\
B, 20.3220, 2 ;atom two is the carbon of the CH3\
a, 2.6100, H3 ;"H3" refers to the hydrogen atom of atom 3 (the oxygen)\
b, 4.8020, H1 ;"H1" refers to the hydrogen atoms of atom 1 (of the CH2)\
c, 1.4010, H2\

but it may look like this (note how data items 2, 3 and 4 are split across two lines)

>  <NMREDATA_ASSIGNMENT>
A, 48.3010, 1 ;the label "A" corresponds to the atom one which is the carbon of the CH2\
B, 20.3220, 
2 ;atom two is the carbon of the CH3\
a, 2.61
00, H3 ;"H3" refers to the hydrogen atom of atom 3 (the oxygen)\
b, 4.8020, H1 ;"H1" refers to the hydrogen 
atoms of atom 1 (of the CH2)\
c, 1.4010, H2\

Note: There will never be two consecutive <EOL>, because this is the end-of-tag signal.

Conclusion: when reading tags, the <EOL> should be ignored and then the "\" be replaced with <EOL>. When writing, the <EOL> should always come after a backslash.