Same name and namespace in other branches
  1. 10 core/modules/user/user.module \user_load_by_mail()
  2. 8.9.x core/modules/user/user.module \user_load_by_mail()
  3. 9 core/modules/user/user.module \user_load_by_mail()

Fetch a user object by email address.

Parameters

$mail: String with the account's e-mail address.

Return value

A fully-loaded $user object upon successful user load or FALSE if user cannot be loaded.

See also

user_load_multiple()

2 calls to user_load_by_mail()
system_send_email_action in modules/system/system.module
Sends an e-mail message.
_update_cron_notify in modules/update/update.fetch.inc
Performs any notifications that should be done once cron fetches new data.

File

modules/user/user.module, line 381
Enables the user registration and login system.

Code

function user_load_by_mail($mail) {
  $users = user_load_multiple(array(), array(
    'mail' => $mail,
  ));
  return reset($users);
}