PEAR Manual
Prev |  | Next

# Net_Finger::query()

Net_Finger::query() -- does a finger query

## Synopsis

    require_once 'Net/Finger.php';

``string Net_Finger::query` (string $server, string $query)`

## Description

Execute a finger query on a server

## Parameter

- `string $server` - The name of the server or the IP-adress

- `string $query` - The finger object to look up

## Return value

`string` - the data from the finger request.

## Throws

The returned PEAR_Error object in case of an error is unspecific, so you can ignore the error code and/or message. The reason for a failure could be a failed connection to the server or the server did not run a finger service.

> Note: You will not get a PEAR_Error, if the query fails due to a not existing finger object. This can be only done by checking the data returned by query().

## Note

This function can be called statically.

## Example

Example 48-1. Using query()
    <?php

    $server = "localhost" ; // or IP adress to use
    $query  = "ralph" ;     // Username to look up

    $data = Net_Finger::query( $server, $query) ;
    echo $data ;

    ?>

Prev | Home | Next
Net_Finger | Up | Net_FTP