fdf_get_value

(PHP 4, PHP 5 < 5.3.0, PECL fdf SVN)

fdf_get_value — Devuelve el valor de un campo FDF

Descripción

function fdf_get_value(resource $fdf_document, string $fieldname, int $which = -1): mixed

Devuelve el valor de un campo FDF.

Parámetros

fdf_document: El gestor de documento FDF, devuelto por la función fdf_create() , la función fdf_open() o la función fdf_open_string() .
fieldname: Nombre del campo FDF, en forma de string .
which: Los elementos de un campo array pueden ser leídos proporcionando este argumento opcional, en forma de un entero cuyo valor mínimo será 0. Para los campos que no son arrays, este argumento opcional será ignorado.

Valores devueltos

Devuelve el valor del campo.

Véase también

fdf_set_value() - Modifica el valor de un campo FDF

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes 1 note

down

mclinden at informed dot net ¶

23 years ago

(i filed a bug report/feature request for this on bugs.php.net and assigned it to myself hartmut@php.net)
The default behavior for the FDF Toolkit is to return an FDFErcNoValue for the FDFGetValue when the field exists but has no value.
Whether or not this is truly an error is debateable. It seems to become an issue in documents created by Acrobat 5 when optional fields are included in a form with required fields since the default behavior seems to be to populate the HTTP_FDF_DATA with the results of the FDFNextFieldName enumerator, which would include the fields which have no value.
This would not be a problem except that the PHP function fdf_get_value() does not specifically test for the FDFErcNoValue condition but, instead, tests for the more general FDFErcOK. If this value is not the result of the error code, the system issues warnings (the display of which could be turned off), but the broader question is, should this be a warning condition at all?
Put another way, should a return of FDFErcNoValue for FDFGetValue be considered an event worth generating a warning?

+add a note