set_config_option: Set GDAL configuration option

In gdalraster: Bindings to 'GDAL'

Set GDAL configuration option

Description

set_config_option() sets a GDAL runtime configuration option. Configuration options are essentially global variables the user can set. They are used to alter the default behavior of certain raster format drivers, and in some cases the GDAL core. For a full description and listing of available options see https://gdal.org/en/stable/user/configoptions.html.

Usage

set_config_option(key, value)

Arguments

key	Character name of a configuration option.
value	Character value to set for the option. value = "" (empty string) will unset a value previously set by set_config_option().

Value

No return value, called for side effects.

Note

The configuration option "CPL_LOG_ERRORS" can be set to "OFF" to disable printing error massages to the console by GDAL. This only affects messages printed by GDAL, and does not disable errors, warnings or other messages emitted by gdalraster. The latter can generally be configured using a function argument or object-level setting in most cases.

See Also

get_config_option()

vignette("gdal-config-quick-ref")

Examples

set_config_option("CPL_LOG_ERRORS", "OFF")
get_config_option("CPL_LOG_ERRORS")
## unset to default:
set_config_option("CPL_LOG_ERRORS", "")

gdalraster documentation built on March 25, 2026, 9:07 a.m.