7.3.15. config_delete#

7.3.15.1. Summary#

New in version 5.1.2.

config_delete command deletes the specified configuration item.

7.3.15.2. Syntax#

This command takes only one required parameter:

config_delete key

7.3.15.3. Usage#

Here is an example to delete alias.column configuration item:

Execution example:

config_set alias.column Aliases.real_name
# [[0, 1337566253.89858, 0.000355720520019531], true]
config_get alias.column
# [[0, 1337566253.89858, 0.000355720520019531], "Aliases.real_name"]
config_delete alias.column
# [[0, 1337566253.89858, 0.000355720520019531], true]
config_get alias.column
# [[0, 1337566253.89858, 0.000355720520019531], ""]

Here is an example to delete nonexistent configuration item:

Execution example:

config_delete nonexistent
# [
#   [
#     -22,
#     1337566253.89858,
#     0.000355720520019531,
#     "[config][delete] failed to delete",
#     [
#       [
#         "grn_config_delete",
#         "config.c",
#         166
#       ]
#     ]
#   ],
#   false
# ]

config_delete returns an error when you try to delete nonexistent configuration item.

7.3.15.4. Parameters#

This section describes all parameters.

7.3.15.4.1. Required parameters#

There is only one required parameter.

7.3.15.4.1.1. key#

Specifies the key of target configuration item.

The max key size is 4KiB.

You can’t use an empty string as key.

7.3.15.4.2. Optional parameters#

There is no optional parameter.

7.3.15.5. Return value#

config_delete command returns whether deleting a configuration item is succeeded or not:

[HEADER, SUCCEEDED_OR_NOT]

7.3.15.5.2. SUCCEEDED_OR_NOT#

If command succeeded, it returns true, otherwise it returns false on error.

7.3.15.6. See also#