What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.



yp_first — Fetches the key and value of the first record in a map.


array yp_first(domain, map);
string domain: NIS domain name
string map: NIS map name (or nickname)


Array; FALSE on error


yp_first() fetches the key and value for the first record in a map and returns them in a three-element associative array. The first element uses the record's key name as its key and the record's value as its value. The additional two elements in the array use key and value as their keys, and contain the value for the record key and the record value, respectively.

For example, a record in the passwd map with the key of dosemu would be represented as the following array:

array (
   'dosemu' => 'dosemu:x:30:',
   'key => 'dosemu',
   'value' => 'dosemu:x:30:'


PHP 3.0.7+, PHP 4+

See also

To fetch the next key/value pair from a map:


To find the value for a key within a map:


To fetch all key/value pairs from a map:


To process all key/value pairs in a map:



Example 1441. Fetch the first key from the services.byname map

// Find the default domain
$domain = yp_get_default_domain ();
$map    = 'services.byname';

$record = yp_first ($domain, $map)
   or die ("Could not fetch the first key/value pair from map '$map' in domain '$domain'");

echo "The first record in map '$map' for domain '$domain' has ", 
   "key '$record[key]'and value '$record[value]'";

PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at The authors of this book have elected not to choose any options under the OPL. This online book was obtained from and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.

Powered by: vBulletin Version 3.0.7
Copyright ©2000 - 2005, Jelsoft Enterprises Ltd.
Copyright © 2001 - 2005, ThinkDing LLC. All Rights Reserved.