FindExec.3
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
源码类别:

通讯编程

开发平台:

Visual C++

  1. '"
  2. '" Copyright (c) 1995-1996 Sun Microsystems, Inc.
  3. '"
  4. '" See the file "license.terms" for information on usage and redistribution
  5. '" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  6. '" 
  7. '" RCS: @(#) $Id: FindExec.3,v 1.5 2001/09/28 17:07:54 msofer Exp $
  8. '" 
  9. .so man.macros
  10. .TH Tcl_FindExecutable 3 8.1 Tcl "Tcl Library Procedures"
  11. .BS
  12. .SH NAME
  13. Tcl_FindExecutable, Tcl_GetNameOfExecutable - identify or return the name of the binary file containing the application
  14. .SH SYNOPSIS
  15. .nf
  16. fB#include <tcl.h>fR
  17. .sp
  18. void
  19. fBTcl_FindExecutablefR(fIargv0fR)
  20. .sp
  21. CONST char *
  22. fBTcl_GetNameOfExecutablefR()
  23. .SH ARGUMENTS
  24. .AS char *argv0 in
  25. .AP char *argv0 in
  26. The first command-line argument to the program, which gives the
  27. application's name.
  28. .BE
  29. .SH DESCRIPTION
  30. .PP
  31. The fBTcl_FindExecutablefR procedure computes the full path name of
  32. the executable file from which the application was invoked and saves
  33. it for Tcl's internal use.
  34. The executable's path name is needed for several purposes in
  35. Tcl.  For example, it is needed on some platforms in the
  36. implementation of the fBloadfR command.
  37. It is also returned by the fBinfo nameofexecutablefR command.
  38. .PP
  39. On UNIX platforms this procedure is typically invoked as the very
  40. first thing in the application's main program;  it must be passed
  41. fIargv[0]fR as its argument.  It is important not to change the
  42. working directory before the invocation.
  43. fBTcl_FindExecutablefR uses fIargv0fR
  44. along with the fBPATHfR environment variable to find the
  45. application's executable, if possible.  If it fails to find
  46. the binary, then future calls to fBinfo nameofexecutablefR
  47. will return an empty string.
  48. .PP
  49. fBTcl_GetNameOfExecutablefR simply returns a pointer to the
  50. internal full path name of the executable file as computed by
  51. fBTcl_FindExecutablefR.  This procedure call is the C API
  52. equivalent to the fBinfo nameofexecutablefR command.  NULL
  53. is returned if the internal full path name has not been
  54. computed or unknown.
  55. .SH KEYWORDS
  56. binary, executable file