Free Press

• NAME
• SYNOPSIS
• DESCRIPTION
• Function read_config_file
  • Syntax
  • Arguments
  • Paluuarvo
  • Kuvaus
• HUOMAUTUKSET
  • Funktiota ei viedä oletusarvoisesti
  • Migroitettu pois ConfigFilestä Config::File
• AUTHOR
• VERSION

Config::File – Parseeraa yksinkertaisen konfiguraatiotiedoston

use Config::File;

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

KUVAUS

read_config_file jäsentää yksinkertaisen konfiguraatiotiedoston ja tallentaa sen arvot anonyymiin hash-viittaukseen. Konfiguraatiotiedoston syntaksi on seuraava:

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

Optiot voidaan klusteroida ryhmiä luotaessa:

Tällöin arvot voidaan noutaa tällä syntaksilla:

 $hash_config->{CLUSTER_ONE}{data};

Klusterissa voi olla niin monta alioptiota kuin tarvitaan.

 BIG_CLUSTER = data

noutaa: $hash_config->{BIG_CLUSTER}{part1}{part2}{part3};

Osa on pari rajoitusta avainten nimien suhteen. Ensinnäkin kaikkien merkkien on oltava aakkosia, numeroita, alleviivoja tai väliviivoja, ja klusterointia varten sallitaan hakasulkeet. Toisin sanoen avainten tulisi olla /^+$/

Tämä tarkoittaa myös sitä, että rivin avainosassa ei saa olla välilyöntejä.

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

Funktio read_config_file

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

Argumentit

$file on konfigurointitiedosto.

Palautusarvo

Return value

Funktio palaa hash-viitteen. Jokainen hashin avain on konfiguraatiotiedostossa määritelty arvo.

Kuvaus

read_config_file jäsentää konfiguraatiotiedoston ja asettaa joitakin arvoja hash-viittaukseen.

Funktiota ei viedä oletusarvoisesti

Versioihin 1.0 asti funktio read_config_file vietiin kutsuvan ohjelman nimiavaruuteen – Versiosta 1.1 alkaen mitään ei viedä oletuksena. Voit joko kvalifioida read_config_file täysin tai tuoda sen nimenomaisesti omaan nimiavaruuteesi:

Täysin kvalifioiva read_config_file

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

Eksplisiittinen tuonti read_config_file

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

Siirryttiin pois ConfigFile:stä Config::File:ksi

Versiosta 1.4 alkaen päätin, jotta voisin sisällyttää tämän moduulin CPAN:iin, että siirryn pois erittäin epätyypilliseltä ConfigFile-nimeltä ja nimitän moduulin uudelleen nimeksi Config::File. Pieni uudelleenohjausmoduuli on otettu käyttöön, joten tätä moduulia käyttävä nykyinen koodi ei rikkoudu, mutta ConfigFile-nimiavaruuden käyttö on vanhentunut (ja antaa siten varoituksen). Päivitä koodisi!

AUTHOR

Kehityksen aloitti Sebastien J. Gross <[email protected]>. Ylläpitäjä Gunnar Wolf <[email protected]> vuoteen 2018 asti, jolloin Tukholman yliopisto (Johan Wassberg ja Mikael Nordin) otti ylläpidon hoitaakseen.

Kaikki oikeudet pidätetään. Tämä ohjelma on vapaa ohjelmisto; voit jakaa sitä edelleen ja/tai muokata sitä GPL:n ehtojen mukaisesti.

VERSIO

Versio 1.54 Copyright (c) 2002 Sebastien J. Gross. Kaikki oikeudet pidätetään. Copyright (c) 2003-2018 Gunnar Wolf. Kaikki oikeudet pidätetään. Copyright (c) 2018- Tukholman yliopisto. Kaikki oikeudet pidätetään. Tämä ohjelma on vapaa ohjelmisto; voit jakaa sitä edelleen ja/tai muokata sitä GPL v2:n (tai uudemman, valintasi mukaan) ehtojen mukaisesti.

 cpanm Config::File 

 perl -MCPAN -e shell install Config::File