Free Press

• NAME
• SYNOPSIS
• DESCRIPTION
• Function read_config_file
  • Syntax
  • Arguments
  • Return value
  • Description
• MEGJEGYZÉSEK
  • A funkció alapértelmezés szerint nem exportált
  • Migrált a ConfigFile-ból a Config::File
• AUTHOR
• VERSION

Config::File – Egy egyszerű konfigurációs fájl elemzése

use Config::File;

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

DESCRIPTION

read_config_file elemez egy egyszerű konfigurációs fájlt és értékeit egy anonim hash hivatkozásban tárolja. A konfigurációs fájl szintaxisa a következő:

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

Az opciókat csoportosítással lehet csoportosítani a csoportok létrehozásakor:

Azután az értékeket ezzel a szintaxissal lehet lekérni:

 $hash_config->{CLUSTER_ONE}{data};

A csoportosításban annyi alopció lehet, ahány alopcióra szükség van.

 BIG_CLUSTER = data

a lekérés: $hash_config->{BIG_CLUSTER}{part1}{part2}{part3};

A kulcsok neveit illetően van néhány korlátozás. Először is, minden karakternek betűjelnek, numerikusnak, aláhúzásnak vagy kötőjelnek kell lennie, a klaszterezéshez szögletes zárójelek megengedettek. Vagyis a kulcsoknak meg kell felelniük a /^+$/

Ez azt is jelenti, hogy a sor kulcs részében nem megengedett szóköz.

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

Funkció read_config_file

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

Argumentumok

$file a konfigurációs fájl.

Visszatérési érték

A függvény egy hash-hivatkozást ad vissza. A hash minden egyes kulcsa a konfigurációs fájlban definiált érték.

leírás

read_config_file elemzi a konfigurációs fájlt és beállít néhány értéket egy hash-hivatkozásban.

Alapértelmezés szerint nem exportált függvény

Az 1.0-ig terjedő verziókban a read_config_file függvényt a hívó program névterébe exportálta – Az 1.1-es verziótól kezdve alapértelmezés szerint semmit sem exportál. A read_config_file-t vagy teljesen minősítheted, vagy explicit módon importálhatod a névteredbe:

A read_config_file teljes minősítése

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

A read_config_file explicit importálása

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

A ConfigFile helyett Config::File

Az 1.4-es verzió óta, annak érdekében, hogy a modul bekerüljön a CPAN-ba, úgy döntöttem, hogy elhagyom a ConfigFile nagyon nem szabványos nevét, és a modult Config::File-re nevezem át. Egy kis átirányító modul került a helyére, így a modult használó jelenlegi kód nem törik meg, de a ConfigFile névtér használata deprecated (és így figyelmeztetést fog kiadni). Kérjük, frissítse a kódját!

AUTHOR

A fejlesztést Sebastien J. Gross <[email protected]> kezdte el. Karbantartója Gunnar Wolf <[email protected]> volt 2018-ig, amikor a Stockholmi Egyetem (Johan Wassberg és Mikael Nordin) átvette a karbantartást.

Minden jog fenntartva. Ez a program szabad szoftver; a GPL feltételei szerint szabadon terjeszthető és/vagy módosítható.

VERSION

Version 1.54 Copyright (c) 2002 Sebastien J. Gross. Minden jog fenntartva. Copyright (c) 2003-2018 Gunnar Wolf. Minden jog fenntartva. Copyright (c) 2018- Stockholmi Egyetem. Minden jog fenntartva. Ez a program szabad szoftver; a GPL v2 (vagy az Ön választása szerint újabb) feltételei szerint terjesztheti és/vagy módosíthatja.

 cpanm Config::File 

 perl -MCPAN -e shell install Config::File