Agena

agena >> `The Power of Procedural Programming` 7.3.3 Antares, March 31, 2026 - `binio.filepos` and `io.filepos`, when given any second argument, an offset, set the file position relative to the beginning of the file. - To get the current file position, you no longer have to call `io.sync` first to get a reliable result from `io.filepos` and `binio.filepos`. - New `binio.writeint64` writes 8-byte signed integers created by the `ints` package and `binio.readint64` reads them. - Likewise, new `binio.writeuint64` stores 8-byte unsigned integers used by the `ints` package and `binio.readuint64` reads them in. - `select`, `remove` and `selectremove` now accept a string as input and applies each character from left to right with the given function. They return strings. - `selectremove` could potentially crash Agena if given `null` as an argument, or return garbage. This has been fixed. - `strings.ispattern` now accepts any second argument and if given checks whether a string contains at least one special character or meta-character used in patterns or captures, that is anything in "^$*+?.([%-". - The `skipfaultylines` and `skipfaulty` options to `utils.readcsv` did not work. This has been fixed. - The `xbase` package can now read and write unsigned 2-byte integers, with the new xbase type 'u'. `xbase.readdbf` automatically recognises and returns them, and the new function `xbase.writeushort` stores them. - Likewise, new `xbase.writeshort` writes signed 2-byte integers, with the new xbase type 's'. `xbase.readdbf` reads them, too. - `xbase.writelong` has been revised a bit. - All `xbase.write*` functions now issue an error if the given dBASE file is not in write mode. - `xbase.readdbf` could not correctly read long integer zero from a file, returning `undefined` instead. This has been fixed. - `xbase.readdbf` did not always free memory in case of an error. This has been fixed. - `xbase.writebyte` and `xbase.writelong` did not correctly write -0 to a file. This has been fixed. - New `astro.locate` searches a location database for a given place. Examples: > astro.locate('Houma'): [[country ~ US, elevation ~ 5, latitude ~ 29.59577, location ~ Houma, longitude ~ -90.71953, population ~ 34287, timezone ~ America/Chicago], [country ~ TO, elevation ~ 24, latitude ~ -21.17005, location ~ Houma, longitude ~ -175.30213, population ~ 1932, timezone ~ Pacific/Tongatapu]] > astro.locate('Houma', 'US'): [[country ~ US, elevation ~ 5, latitude ~ 29.59577, location ~ Houma, longitude ~ -90.71953, population ~ 34287, timezone ~ America/Chicago]] - `binio.readstring` is no longer creating memory leaks. - `binio.readshortstring` could corrupt the internal C stack in inunfavourable circumstances. This has been changed. - Improved memory alignment and cache performance of various data structures.