Documentación offline PHP master

yaz_scan

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

yaz_scan

Prepara para un escaneo YAZ

Descripción#

yaz_scan(resource $id, string $type, string $startterm, [array $flags]): void
```php

Esta función prepara para una solicitud "Z39.50 Scan Request" en la conexión YAZ especificada.

Para transferir realmente la "Scan Request" del servidor y recibir la "Scan Response", debe llamarse `yaz_wait`. Después de la finalización de la llamada a `yaz_wait`, llamar a `yaz_error` y `yaz_scan_result` para gestionar la respuesta.

## Parámetros

`id`  
El recurso de conexión devuelto por `yaz_connect`.

`type`  
Actualmente sólo está soportado el tipo `rpn` .

`startterm`  
Punto de partida del escaneo.

La forma en la que el punto de partida es especificado, viene dado por el parámetro `type`.

La sintaxis de este parámetro es parecido al de la consulta RPN tal y como se describe en `yaz_search`. Consiste en cero o más especificaciones del operador `@attr`, seguido de exactamente un token.

`flags`  
Este parámetro opcional describe información adicional para controlar el comportamiento de la solicitud de escaneo. Tres índices se leen actualmente del array de marcas: `number` (número de términos solicitados), `position` (posición preferida del término) y `stepSize` (tamaño preferido del paso).

## Valores devueltos

No se retorna ningún valor.

## Ejemplos

función PHP que escanea títulos
$val) { echo "$key = $val "; } echo '
'; while (list($key, list($k, $term, $tcount)) = each($ar)) { if (empty($k)) continue; echo ""; } echo '
$term$tcount
'; } else { echo "Error de escaneo. Error: " . yaz_error($id) . "
"; } } ?>

```php