Error on stringutil.inc?

[Nicola_Piano]

Hi Charles,
I'm having trouble with this little program.
Specifically I got this error: UNIDENTIFIED OPERAND: GETWORD...

Code Select Expand


'ReadSpecificLine.o2bas
uses stringutil
new Textarray t
t.load "dati.txt"
print t.line 7
print t.lineCount
del t


Ciao

[Charles Pegge]

Hi Nicola,

There is a dependency here. Try uses ParseUtil instead of StringUtil.

[Nicola_Piano]

Thanks Charles.
OK with PARSEUTIL.INC works correctly.
Anyway I wanted to tell you that the example I took from "ROSETTA CODE" ...
Maybe it needs to be corrected?



p.s.
I really appreciate your skills and knowledge.

[Charles Pegge]

Thanks Nicola,

I will fix this dependency by moving the StructuredText class from StringUtil.inc to ParseUtil.inc

[Nicola_Piano]

Please, Charles,
could you tell me what are the "external" functions of PARSEUTIL.INC?
I would like to know them and include them in the HELP.
Ciao

[Charles Pegge]

Hi Nicola,

I'm reviewing ParseUtil.inc and I have removed if few functions which have never been used. The others are used directly or indirectly by Oxide, Co2 and LeanLisp. In the longer term, Parseutil may become merged with Oxygen's source code parsers: lexa.inc and lexi.inc.

I am also interested in developing a standard for embedded documentation from which html pages can be automatically generated, like Doxygen:

https://en.wikipedia.org/wiki/Doxygen
https://www.doxygen.nl/index.html

Code Select Expand


A typical Doxygen layout looks like this:
/**
<A short one line description>

<Longer description>
<May span multiple lines or paragraphs as needed>

@param  Description of method's or function's input parameter
@param  ...
@return Description of the return value
*/


I will post Parseutil as soon a I have completed the review.

[Nicola_Piano]

Hi Charles,
excellent idea of ​​using Doxygen. I read something from the link you entered.
In this way the source file would have all the notes necessary to explain it and, at the same time, could be used to create its part in the HELP.

[Charles Pegge]

Here is a sample: - playing with markup styles

function instrword(string s,k) as int

  to find whole words in a string

  Parameters:
  s is the string to be searched
  k is the keyword to be located in s

  Return:
the index of the first position of k in s

  if the search fails then the return value is 0


function instrword(string s,k) as int
=====================================
/**
  to find whole words in a string

  @param s is the string to be searched
  @param k is the keyword to be located in s
  @return the index of the first position of k in s

  if the search fails then the return value is 0
**/
int  lk=len k
int ,lb,rb
byte b at strptr(s)
if not k then return 0
int i=1
do
  i=instr(i,s,k)
  if i=0
    return 0
  endif
  lb=i-1
  rb=i+lk
  if b[ rb ]<48
    if i=1
      return 1
    elseif b[ lb ]<48
      return i
    endif
  endif
  i+=lk
loop
end function

[Charles Pegge]

Hi Nicola,

A reviewed and annotated ParseUtil.inc:

[Nicola_Piano]

Great thing Charles,
but perhaps a broad revision is needed?
Unfortunately, doing a test I get an error.

Code Select Expand

use parseutil.inc
string s="Hi Charles"

print getword(s,2)


Anyway, the program description is great that way.

[Charles Pegge]

Ah yes, I cleaned up StringUtil.inc. Some of it was to solve a Rosetta code task but it was too specific for library code.