Free Press

• Nume
• SYNOPSIS
• DESCRIPTION
• Funcția read_config_file
  • Sintaxa
  • Argumente

  .

  • Valoare de retur
  • Descriere
• NOTĂ
  • Funcția nu este exportată în mod implicit
  • Migrat din ConfigFile în Config::File
• AUTOR
• VERSION

Config::File – Parsează un fișier de configurare simplu

utilizează Config::File;

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

DESCRIPȚIE

read_config_file analizează un fișier de configurare simplu și stochează valorile sale într-o referință hash anonimă. Sintaxa fișierului de configurare este următoarea:

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

Opțiunile pot fi grupate atunci când se creează grupuri:

Apoi valorile pot fi preluate folosind această sintaxă:

 $hash_config->{CLUSTER_ONE}{data};

Într-un grup pot exista atâtea subopțiuni câte sunt necesare.

 BIG_CLUSTER = data

se preia prin: $hash_config->{BIG_CLUSTER}{partea1}{partea2}{partea3};

Există câteva restricții în ceea ce privește numele cheilor. În primul rând, toate caracterele trebuie să fie alfabetice, numerice, sublinieri sau liniuțe, fiind permise parantezele pătrate pentru grupare. Adică, cheile trebuie să fie conforme cu /^+$/

Aceasta înseamnă, de asemenea, că nu este permis nici un spațiu în partea de cheie a liniei.

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

Funcția read_config_file

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

Argumente

$file este fișierul de configurare.

Valoare de retur

Această funcție returnează o referință hash. Fiecare cheie a hash-ului este o valoare definită în fișierul de configurare.

Descriere

read_config_file analizează un fișier de configurare și stabilește unele valori într-o referință hash.

Funcția nu este exportată în mod implicit

În versiunile de până la 1.0, funcția read_config_file era exportată în spațiul de nume al programului apelant – Începând cu versiunea 1.1, nimic nu este exportat în mod implicit. Puteți fie să o calificați complet pe read_config_file, fie să o importați în mod explicit în spațiul vostru de nume:

Calificarea completă a lui read_config_file

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

Importul explicit al lui read_config_file

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

A migrat de la ConfigFile la Config::File

De la versiunea 1.4, pentru a include acest modul în CPAN, am decis să mă îndepărtez de numele foarte nestandardizat de ConfigFile și să redenumesc modulul în Config::File. Un mic modul de redirecționare este pus în loc, astfel încât codul actual care utilizează acest modul nu se întrerupe, dar utilizarea spațiului de nume ConfigFile este depreciată (și va emite astfel un avertisment). Vă rugăm să vă actualizați codul!

AUTOR

Dezvoltarea a fost începută de Sebastien J. Gross <[email protected]>. Menținut de Gunnar Wolf <[email protected]> până în 2018, când Universitatea din Stockholm (Johan Wassberg și Mikael Nordin) a preluat mentenanța.

Toate drepturile rezervate. Acest program este software liber; îl puteți redistribui și/sau modifica în conformitate cu termenii GPL.

VERSION

Versiunea 1.54 Copyright (c) 2002 Sebastien J. Gross. Toate drepturile rezervate. Copyright (c) 2003-2018 Gunnar Wolf. Toate drepturile rezervate. Copyright (c) 2018- Universitatea din Stockholm. Toate drepturile rezervate. Acest program este software liber; îl puteți redistribui și/sau modifica în conformitate cu termenii GPL v2 (sau mai târziu, la alegerea dumneavoastră).

 cpanm Config::File 

 perl -MCPAN -e shell install Config::File 

.