# yp_match

(PHP 4, PHP 5 < 5.1.0)

yp_match — Returns the matched line

### 说明

yp_match ( string `$domain` , string `$map` , string `$key` ) : string

Returns the value associated with the passed `key` out of the specified `map`.

### 参数

`domain`

  The NIS domain name.

`map`

  The NIS map.

`key`

  This key must be exact.

### 返回值

Returns the value, or `FALSE` on errors.

### 范例

Example #1 Example for NIS match

    <?php
    $entry = yp_match($domain, "passwd.byname", "joe");
    echo "Matched entry is: " . $entry;
    ?>

以上例程的输出类似于：

    joe:##joe:11111:100:Joe User:/home/j/joe:/usr/local/bin/bash

### 参见

- yp_get_default_domain() - Fetches the machine's default NIS domain