bionic (3) md_src_plugins_null_README.3elektra.gz

NAME

       md_src_plugins_null_READMEREADME
        -

       • infos = Information about null plugin is in keys below

       • infos/author = Markus Raab elektra@libelektra.org

       • infos/licence = BSD

       • infos/needs =

       • infos/provides =

       • infos/placements = postgetstorage presetstorage

       • infos/description = Transforms null and empty values to text and back

       This plugin is a filter plugin which allows Elektra to better deal with null values and empty strings.

       Elektra supports null values for binary keys. They differ from an empty string substantially in how they
       are handled. Some plugins that work on values are not aware of null values. They would crash when they
       try to access a value that is believed to be a string.

   Special Values
       The plugin transcodes all null values to @NULL, all empty strings to @EMPTY, and all strings starting
       with @ to begin with @@.

   Usage
       In order to use the null plugin you must add null to info/needs in the plugin you wish to use.

       Once null is included in infos/needs, the null plugin will filter values for the storage plugin. As a
       result, the storage plugin will never come across a null value or an empty string, instead it will be get
       strings with @NULL and @EMPTY respectively.