Free Press

• NOME
• SINOPOSI
• DESCRIZIONE
• Funzione read_config_file
  • Sintassi
  • Argomenti
  • Valore di ritorno
  • Descrizione
• NOTE
  • Funzione non esportata di default
  • Migrata da ConfigFile in Config::File
• AUTHOR
• VERSION

Config::File – Analizza un semplice file di configurazione

use Config::File;

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

DESCRIZIONE

read_config_file analizza un semplice file di configurazione e memorizza i suoi valori in un riferimento hash anonimo. La sintassi del file di configurazione è la seguente:

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

Le opzioni possono essere raggruppate quando si creano i gruppi:

Poi i valori possono essere recuperati usando questa sintassi:

 $hash_config->{CLUSTER_ONE}{data};

Ci possono essere tante sotto-opzioni in un cluster quante sono necessarie.

 BIG_CLUSTER = data

viene recuperato da: $hash_config->{BIG_CLUSTER}{part1}{part2}{part3};

Ci sono un paio di restrizioni per quanto riguarda i nomi delle chiavi. Prima di tutto, tutti i caratteri devono essere alfabetici, numerici, sottolineature o trattini, con parentesi quadre permesse per il clustering. Cioè, le chiavi dovrebbero essere conformi a /^+$/

Questo significa anche che nessuno spazio è permesso nella parte della chiave della linea.

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

Funzione read_config_file

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

Argomenti

$file è il file di configurazione.

Valore di ritorno

Questa funzione ritorna un riferimento hash. Ogni chiave dell’hash è un valore definito nel file di configurazione.

Descrizione

read_config_file analizza un file di configurazione e imposta alcuni valori in un riferimento hash.

Funzione non esportata per default

Nelle versioni fino alla 1.0, la funzione read_config_file era esportata nello spazio dei nomi del programma chiamante – A partire dalla versione 1.1, non viene esportato nulla per default. Puoi qualificare completamente read_config_file o importarlo esplicitamente nel tuo spazio dei nomi:

Qualificare completamente read_config_file

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

Importare esplicitamente read_config_file

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

Migrato via da ConfigFile in Config::File

A partire dalla versione 1.4, per poter includere questo modulo nel CPAN, ho deciso di allontanarmi dal nome molto poco standard di ConfigFile e rinominare il modulo in Config::File. Un piccolo modulo di reindirizzamento è stato messo in atto, così il codice corrente che usa questo modulo non si rompe, ma l’uso dello spazio dei nomi ConfigFile è deprecato (e quindi emetterà un avviso). Aggiorna il tuo codice!

AUTHOR

Lo sviluppo è stato iniziato da Sebastien J. Gross <[email protected]>. Mantenuto da Gunnar Wolf <[email protected]> fino al 2018 quando l’Università di Stoccolma (Johan Wassberg e Mikael Nordin) ha assunto la manutenzione.

Tutti i diritti riservati. Questo programma è software libero; è possibile ridistribuirlo e/o modificarlo secondo i termini della GPL.

VERSIONE

Versione 1.54 Copyright (c) 2002 Sebastien J. Gross. Tutti i diritti riservati. Copyright (c) 2003-2018 Gunnar Wolf. Tutti i diritti riservati. Copyright (c) 2018- Università di Stoccolma. Tutti i diritti riservati. Questo programma è software libero; puoi ridistribuirlo e/o modificarlo secondo i termini della GPL v2 (o successiva, a tua scelta).

 cpanm Config::File 

 perl -MCPAN -e shell install Config::File