Manuale PHP
Indietro |  | Avanti

# dio_open

(PHP 4 >= 4.2.0, PHP 5 <= 5.0.4)

dio_open -- Apre un nuovo file nella modalità specificata da flags e i permessi indicati in mode

## Descrizione

resource dio_open ( string filename, int flags [, int mode] )

La funzione dio_open() apre un file e restituisce un nuovo descrittore di file per questo.

## Elenco dei parametri

filename

  Il file aperto.

flags

  Il parametro flags può contenere qualsiasi combinazione dei seguenti valori:

  - `O_CREAT` - crea un file, se questo non esiste già.

  - `O_EXCL` - se sono impostati sia `O_CREAT` e sia `O_EXCL`, la funzione dio_open() fallisce se il file esiste.

  - `O_TRUNC` - se il file esiste, ed è aperto in scrittura, il file verrà portato a lunghezza zero.

  - `O_APPEND` - nelle operazioni di scrittura, scrive i dati alla fine del file.

  - `O_NONBLOCK` - imposta la modalità non blocking.

mode

  Se flags vale `O_CREAT`, allora il parametro mode imposta la modalità del file (permessi di creazione).

  - `O_RDONLY` - apre il file per accessi in lettura.

  - `O_WRONLY` - apre il file in scrittura.

  - `O_RDWR` - apre il file sia in lettura sia in scrittura.

## Valori restituiti

Restituisce un descrittore di file, oppure `FALSE` in caso di errore.

## Esempi

Esempio 1. Apertura di un descrittore di file

`<?php $fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK); dio_close($fd); ?>`

## Vedere anche:

dio_close()

Indietro | Partenza | Avanti
dio_fcntl | Risali | dio_read