Click above to get retro games delivered to your door ever month!

 cnvumlt()           Expand accented characters in a string
------------------------------------------------------------------------------
 Declaration
   string.hdr

 Syntax
   func char cnvumlt extern
   param const char cString

 Arguments
   cString is a character string.

 Return
   A string derived from the input string, with accented characters
   converted.

 Description
   The cnvumlt() function converts accented characters in the input string
   into their double-vowel equivalents. This allows for correct indexing
   according to the German standards.

   To keep the return value's length equal to the length of cString, right
   characters are truncated if necessary.

   Table of conversions:

   Original | Expansion
   ---------+----------
     .      |    ae
     .      |    oe
     .      |    ue
     .      |    ss
     .G     |    AEG
     .g     |    Aeg
     .K     |    OEK
     .k     |    Oek
     .B     |    UEB
     .b     |    Ueb

 Example
   #define EXAMPLE_STRING
   #include example.hdr

   proc Test_cnvumlt
   vardef
      char cString
   enddef
   cString := "J.rgen R.ucher      "
   ? cString                          // prints J.rgen R.ucher
   ? cnvumlt( cString )               // prints Juergen Raeucher
   cString := trim( cString )
   ? cnvumlt( cString )               // prints Juergen Raeuch
   endproc

   proc main
   Test_cnvumlt()
   endproc