PM37603: docs: Regular expressions example program error

IBM Rational DOORS version 9.3.0.4

APAR status

• Closed as documentation error.

Error description

• Problem
  using the Regular expressions example program from the DXL
  reference manual throws an error
  
  To Reproduce
  run the DXL from the example in your DOORS client:
  
  // regular expression DXL example
  /*
    examples of regular expression DXL
  */
  Regexp line = regexp2 '.*'
  // matches any character except newline
  string txt1 = 'line 1\nline 2\nline 3\n'
  // 3 line string
  while (!null txt1 ?? line txt1) {
      print txt1[match 0] '\n'
      // match 0 is whole of match
      txt1 = txt1[end 0 + 2:]   // move past newline
  }
  // The following regular expression detects and decomposes URLs
  Regexp URL = regexp2 //'(HTTP|http|ftp|FTP|file|FILE)://([^
  \\),;?\']*)'
  string txt3 = 'The ABC URL is http://www.abcinc.com, and may
  be...'
  if (URL txt3) {
    print txt3[match 0] '\n'   // whole match
    print txt3[match 1] '\n'     // first bracketed section
    print txt3[match 2] '\n'     // second.
    print start 1              // position 15 in txt3 (from 0)
    print end 1                  //          18
    print start 2                //          22
    print end 2                  //          34
  }
  
  Expected Results
  it should print out:
  line 1
  line 2
  line 3
  http://www.abcinc.com
  http
  www.abcinc.com
  15
  18
  22
  35
  
  
  Actual Results
  instead it errors out with the following:
  -E- DXL: ?Line:15? incorrect arguments for (=)
  -I- DXL: All done. Errors reported: 1. Warnings reported: 0.
  
  
  Possible Workarounds
  change this line:
  Regexp URL = regexp2 //'(HTTP|http|ftp|FTP|file|FILE)://([^
  \\),;?\']*)'
  
  to:
  Regexp URL = regexp2 '(HTTP|http|ftp|FTP|file|FILE)://([^
  \\),;?\']*)'
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Example given for Regular expression usage in the DXL manual
  is incorrect.
  

Problem conclusion

• Example given for Regular expression usage in the DXL manual
  needs corrected
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels