Qp0lUnlink()--Remove Link to File

 #include <Qp0lstdi.h>

 int Qp0lUnlink(Qlg_Path_Name_T *path_name);  

The Qp0lUnlink() function, similar to the unlink() function, removes a directory entry that refers to a file. Qp0lUnlink() differs from unlink() in that the path_name parameter is a pointer to a Qlg_Path_Name_T structure instead of a pointer to a character string.

For a discussion of the authorities required, return values, and related information, see unlink()--Remove Link to File.

Parameters

Path_Name

(Input) The path name of the object to be unlinked. This path name is in the Qlg_Path_Name_T format. For more information on this structure, see Path name format.

Related Information

• The <unistd.h> file (see Header Files for UNIX^®-Type Functions)
• unlink()--Remove Link to File
• link()--Create Link to File
• open()--Open File
• close()--Close File or Socket Descriptor
• rmdir()--Remove Directory

Example

The following example removes a link to a file: This program was stored in a source file with CCSID 37, so the constant string "newfile" will be compiled in coded character set identifier (CCSID) 37. Therefore, the country or region and language specified are United States English, and the CCSID specified is 37.

Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.

#include <fcntl.h>
#include <stdio.h>
#include <Qp0lstdi.h>

main() {
  const char US_const[3]= "US";
  const char Language_const[4]="ENU";
  const char Path_Name_Del_const[2] = "/";

  struct pnstruct
    {
     Qlg_Path_Name_T  qlg_struct;
     char             pn[7];
    };
  struct pnstruct pns;
  struct pnstruct *pns_ptr = NULL;

  char fn[]="unlink.file";

  memset((void*)&pns, 0x00, sizeof(struct pnstruct));
  pns.qlg_struct.CCSID = 37;
  memcpy(pns.qlg_struct.Country_ID,US_const,2);
  memcpy(pns.qlg_struct.Language_ID,Language_const,3);;
  pns.qlg_struct.Path_Type = 0;
  pns.qlg_struct.Path_Length = sizeof(fn)-1;
  memcpy(pns.qlg_struct.Path_Name_Delimiter,
         Path_Name_Del_const,1);
  memcpy(pns.pn,fn,sizeof(fn));
  memset((void *)&Attr_types_ptr, 0x00,
         sizeof(struct attrStruct));
  pns_ptr = &pns;

  if (Qp0lUnlink((Qlg_Path_Name_T *)&pns) != 0)
      perror("Qp0lunlink() error");
}

[ Back to top | UNIX-Type APIs | APIs by category ]