Free Press

• NAME
• SYNOPSIS
• DESCRIPTION
• Funkce read_config_file
  • Syntaxe
  • Argumenty
  • Vrácená hodnota
  • Popis
• POZNÁMKY
  • Funkce není standardně exportována
  • Migrováno z ConfigFile do Config::File
• AUTHOR
• VERSION

Config::File – Parsování jednoduchého konfiguračního souboru

použije Config::File;

my $config_hash = Config::File::read_config_file($configuration_file);

DESCRIPTION

read_config_file rozebere jednoduchý konfigurační soubor a uloží jeho hodnoty do anonymního hash odkazu. Syntaxe konfiguračního souboru je následující:

 # This is a comment VALUE_ONE = foo VALUE_TWO = $VALUE_ONE/bar VALUE_THREE = The value contains a \# (hash). # This is a comment.

Při vytváření skupin lze volby shlukovat:

Poté lze hodnoty načítat pomocí této syntaxe:

 $hash_config->{CLUSTER_ONE}{data};

V shluku může být tolik dílčích voleb, kolik je třeba.

 BIG_CLUSTER = data

se načítá pomocí: $hash_config->{BIG_CLUSTER}{část1}{část2}{část3};

Je zde několik omezení, pokud jde o názvy klíčů. Především by všechny znaky měly být abecední, číselné, podtržítka nebo pomlčky, přičemž pro shlukování jsou povoleny hranaté závorky. To znamená, že klíče by měly odpovídat /^+$/

To také znamená, že v části klíče na řádku není povolena žádná mezera.

 CLUSTER_ONE = data cluster one # Right CLUSTER_ONE = data cluster one # Wrong

Funkce read_config_file

 Config::File::read_config_file($file);

Argumenty

$file je konfigurační soubor.

Vrací hodnotu

Tato funkce vrací odkaz na hash. Každý klíč hashe je hodnota definovaná v konfiguračním souboru.

Popis

read_config_file analyzuje konfigurační soubor a nastaví některé hodnoty do hashové reference.

Funkce se standardně neexportuje

Ve verzích do 1.0 se funkce read_config_file exportovala do jmenného prostoru volajícího programu – Od verze 1.1 se standardně neexportuje nic. Modul read_config_file můžete buď plně kvalifikovat, nebo explicitně importovat do svého jmenného prostoru:

Plně kvalifikovat read_config_file

 use Config::File; my $config_hash = Config::File::read_config_file($configuration_file);

Explicitně importovat read_config_file

 use Config::File qw(read_config_file); my $config_hash = read_config_file($configuration_file);

Přechod z ConfigFile na Config::File

Od verze 1.4 jsem se kvůli zařazení tohoto modulu do CPANu rozhodl opustit velmi nestandardní název ConfigFile a přejmenovat modul na Config::File. Je zaveden malý přesměrovávací modul, takže současný kód používající tento modul se nerozbije, ale použití jmenného prostoru ConfigFile je zastaralé (a bude tedy vydávat varování). Aktualizujte prosím svůj kód!

AUTHOR

Vývoj zahájil Sebastien J. Gross <[email protected]>. Udržoval ho Gunnar Wolf <[email protected]> až do roku 2018, kdy údržbu převzala Stockholmská univerzita (Johan Wassberg a Mikael Nordin).

Všechna práva vyhrazena. Tento program je svobodný software; můžete jej šířit a/nebo upravovat za podmínek licence GPL.

VERSION

Verze 1.54 Copyright (c) 2002 Sebastien J. Gross. Všechna práva vyhrazena. Copyright (c) 2003-2018 Gunnar Wolf. Všechna práva vyhrazena. Copyright (c) 2018- Stockholmská univerzita. Všechna práva vyhrazena. Tento program je svobodný software; můžete jej šířit a/nebo upravovat za podmínek licence GPL v2 (nebo pozdější, dle vlastního výběru).

 cpanm Config::File 

 perl -MCPAN -e shell install Config::File 

.