Agena

agena >> `The Power of Procedural Programming` 7.3.6 Antares, April 04, 2026 - `strings.toutf8` now supports conversion from codepage 850 (Western Latin), 852 (Eastern Latin), 857 (Turkey), 860 (Portuguese), 775 (Baltics) and Windows-1258 (Vietnamese) to UTF-8. Just pass either the integer 850, 852, 857, 860, 775 or 1258 as a second argument to the function. You might have to change the codepage in use by the Windows or OS/2 shell before calling `strings.toutf8` with the optional argument. Example: > oldinputcp, oldoutputcp := os.codepage(); # get current settings > os.codepage(input = 852, output = 852); > strings.toutf8('Lódz', 852): +ü+¦d+¦ Change back to default codepage: > os.codepage(input = oldinputcp, output = oldinputcp); - Likewise, `strings.tolatin` can convert from codepage 850 (Western Latin), 852 (Eastern Latin), 857 (Turkey), 860 (Portuguese) or 775 (Baltics) to Latin-1, Latin-2, Latin-4, Latin-1 or Latin-5, respectively. You may have to change the codepage in the Windows or OS/2 shell before, too. - `strings.isdia` has been extended: if given `true` as an optional second argument, the function checks whether there is at least one diacritic or ligature in the string, contrary to the default mode which requires all characters to be diacritics. - `astro.locate` did not work well in Windows and OS/2 with location names that include diacritics or ligatures. This has been fixed. You may have to change your codepage before calling the function, see above and the Agena Reference, Chapter 11.9, for instructions. In Windows and OS/2, the function now explicitly searches the locations database with the codepages of Western and the Eastern Europe, the Baltics, Brazil and Portugal, Turkey and Vietnam, if needed. - The second argument to `astro.a2tf` has become optional and defaults to -5. - You can now pass location data in decimal degrees to `astro.sun` and `astro.moon` instead of degrees, hours and seconds. For Moonrise and Moonset and the phase in Chattanooga, TN, you may now enter: > astro.moon(2026, 4, 1, 0, [85, 34.848, 0, 'W'], [35, 2, 44.232, 'N']): [phase ~ [0.98778865167974, 4, 167.20068997751], riseset ~ [tm(23, 57, 0), tm(11, 3, 0)]] or > astro.moon(2026, 4, 1, 0, -85.30968, 35.04563): [phase ~ [0.98778865167974, 4, 167.20068997751], riseset ~ [tm(23, 56, 0), tm(11, 2, 0)]] - `astro.moonriseset` and thus also `astro.moon` could inadvertently reuse results from previous computations. This has been fixed. - Signed and unsigned 16-bit integers have not been fully implemented in the `xbase` library. This has been rectified. - `xbase.writeshort` and `xbase.writeushort` can now be called OOP-style. - In the Agena Reference, Chapter 12.3 on the `xbase` package has been improved by providing an easy-to-understand example on how to create a simple city database file, write and read values to it. - This release has been Valgrind-checked on x64 Linux to ensure there are no internal errors or memory leaks.