Plugin: range

• infos = Information about the range plugin is in keys below
• infos/author = Thomas Waser thoma.nosp@m.s.wa.nosp@m.ser@l.nosp@m.ibel.nosp@m.ektra.nosp@m..org
• infos/licence = BSD
• infos/needs =
• infos/provides =
• infos/recommends =
• infos/placements = presetstorage postgetstorage
• infos/status = maintained conformant compatible coverage specific unittest tested libc preview unfinished
• infos/metadata = check/range check/type
• infos/description = tests if a value is within a given range

Introduction

The range plugin checks if a Key's value is within a given range.

Installation

See installation. The package is called libelektra5-experimental.

Usage

The plugin checks every Key in the KeySet for the metakey check/range which contains either a single range with the syntax [-]min-[-]max, or a list of ranges or values separated by , and tests if the Key's value is within the range(s).

check/type can be used to specify the data type. If not specified otherwise the default value is long long

Possible values:

• short, long, long long

  for signed integer values

• unsigned short, unsigned long, unsigned long long

  for unsigned integer values

• float, double, long double

  for floating point values

• HEX

  for hexadecimal values

• char

  for characters

Dependencies

None.

Examples

# Backup-and-Restore:/tests/range
 
sudo kdb mount range.ecf /tests/range range dump
 
# should succeed
kdb set /tests/range/value 5
kdb meta-set /tests/range/value check/range "1-10"
# RET: 0
 
# should fail
kdb set /tests/range/value 11
# RET:5
 
# should also fail
kdb set /tests/range/value "\-1"
# RET:5
 
# we can also allow only individual values:
kdb meta-set /tests/range/value check/range "1,2,4,8"
 
kdb set /tests/range/value 7
# RET:5
 
kdb set /tests/range/value 2
# RET:0
 
kdb rm -r /tests/range
sudo kdb umount /tests/range

Limitations

None.