php man page for yp_first

YP_FIRST(3)								 1							       YP_FIRST(3)

yp_first - Returns the first key-value pair from the named map

SYNOPSIS
       array yp_first (string  $domain, string	$map)

DESCRIPTION
	Gets the first key-value pair from the named $map in the named $domain.

PARAMETERS
	      o $domain
		- The NIS domain name.

	      o $map
		- The NIS map.

RETURN VALUES
	Returns the first key-value pair as an array on success, or FALSE on errors.

EXAMPLES
       Example #1

	      Example for the NIS first

	      <?php
	      $entry = yp_first($domain, "passwd.byname");

	      $key = key($entry);
	      $value = $entry[$key];

	      echo "First entry in this map has key " . $key . " and value " . $value;
	      ?>

SEE ALSO
       yp_next(3), yp_get_default_domain(3).

PHP Documentation Group 													       YP_FIRST(3)