cuserid 子例程

在线编辑

用途

获取与当前进程关联的字母数字用户名。

库

标准 C 库 (libc.a)

使用 libc_r.a 库来访问此子例程的线程安全版本。

语法

#include <stdio.h>
char *cuserid ( Name)
char *Name;

描述

cuserid 子例程获取与当前进程关联的字母数字用户名。 此子例程生成表示进程所有者的名称的字符串。

注: cuserid 子例程与 getpwuid 和 getuid 子例程提供的功能重复。 现有应用程序应使用 getpwuid 和 getuid 子例程。

如果 Name 参数为空指针，那么为大小字符串L_cuserid使用 malloc动态分配，并且表示进程所有者的名称的字符串存储在此区域中。 然后， cuserid 子例程返回此区域的地址。 多线程应用程序应该使用此功能来获取特定于线程的数据，然后在对 curserid 子例程的后续调用中继续使用此指针。 在任何情况下，当不再需要数据时，应用程序必须使用 free 子例程释放任何动态分配的空间。

如果 Name 参数不是空指针，那么会将字符串存储到由 Name 参数指向的数组中。 此数组必须至少包含由常量指定的字符数L_cuserid。此常量在 stdio.h 文件中定义。

如果找不到用户名，那么 cuserid 子例程返回空指针; 如果 Name 参数不是空指针，那么空字符 ('\0') 存储在 Name [0] 中。

参数

项 描述
名称 指向表示用户名的字符串。