home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0210 - 0219 / ibm0210-0219 / ibm0213.tar / ibm0213 / HAM_W32.ZIP / SAMPLES / README < prev    next >
Encoding:
Text File  |  1994-05-12  |  5.4 KB  |  142 lines
  1. Hamilton C shell(tm) Samples Directory, Release 2.2.i
  2. Copyright (c) 1989-1993 by Hamilton Laboratories.  All rights reserved.
  3.  
  4. The sample C programs and C shell scripts in this directory are meant
  5. to help you install or experiment with Hamilton C shell.  Deliberately,
  6. they're relatively trivial.
  7.  
  8. (All these files should be viewed with TABS=3)
  9.         
  10.  
  11. args.c         A simple C program that prints out the *argv[] (argument)
  12.                     and *envp[] (environmental variable) arrays.  Notice that
  13.                     wildcarding, variable substitutions, quoting and command
  14.                     substitutions are done before the C program is started.  If
  15.                     you do a lot of wildcarding, you can create and pass VERY
  16.                     long parameter lists (up 32K characters).  Try some of these
  17.                     commands:
  18.  
  19.                         % args "ho"w 'no'w
  20.                         % args "$cwd" '$cwd'
  21.                         % args * "*" '*'
  22.                         % args `whereis more`
  23.                         % args '`whereis more`'
  24.                         % args * *\* *\*\* | more
  25.  
  26. bits.csh            A simple self-loading procedure that calculates the minimum
  27.                     bits required to represent the argument it's passed as a
  28.                     binary integer.
  29.  
  30. blksize.c      A simple C program that reads from Stdin, copying to Stdout,
  31.                     using the specified blocksize.  This program can be useful
  32.                     to read or write tape devices that only support certain
  33.                     blocksizes.
  34.  
  35. bumpdate.csh    Print the date n number of days forward or backward from a
  36.                     given date.  If only the bump value is given, today's date
  37.                     is bumped.
  38.  
  39. caldate.csh        Print the date corresponding to a given Julian day.
  40.  
  41. calendar.csh    A C shell script for printing out the calendar for any
  42.                     given month, highlighting the current date.  If no date
  43.                     is given, this month's calendar is printed.
  44.  
  45. cl.csh            Run the C compiler and linker for an NT program.  Avoids
  46.                     having to fool with a make file just to compile hello, world.
  47.                     Works pretty much just like the cl command on DOS would.
  48.  
  49. colors.csh        Instructions and examples on customizing the screen colors.
  50.  
  51. deltaday.csh    Print the number of days separating two dates.  If only
  52.                     one date is given, the difference between it and today's date
  53.                     is returned.
  54.  
  55. dumpenv.c        This C program writes out the environment it's passed in
  56.                     the form of setenv commands.
  57.  
  58. duplicat.csh    Look for duplicate files anywhere in a directory tree.
  59.  
  60. easter.csh        A C shell script that calculates when Easter will occur in
  61.                     any given year.  If no year is given, the current year is
  62.                     assumed.
  63.  
  64. factor.csh        The simple factor C shell script shown in the User Guide.
  65.                     Intended to show examples of recursion, expressions, and
  66.                     a self-loading procedure.
  67.  
  68. finance.csh        Another C shell script showing expression evalution.  This
  69.                     defines a number of routines for calculating financial
  70.                     conversion factors, e.g., from present to future value.
  71.  
  72. julian.csh        Calculate the Julian day number (number of days since January 1,
  73.                     4713 BC) for any given date.  If you don't give a date, it
  74.                     uses today's date.
  75.  
  76. makecpgm.csh    A simple C shell script showing how a "make" function might
  77.                     be written in the C shell language.  This one rebuilds any
  78.                     .exe files in the current directory that are older than the
  79.                     corresponding .c file or any of the .h files.
  80.  
  81. mcvisa.csh        A simple C shell script that constructs a special checksum
  82.                     of a credit card number to tell if the card number is
  83.                     plausible or not.  The checksum used is designed to catch
  84.                     transposed or incorrect digits.  Try it on the cards in
  85.                     your wallet.
  86.  
  87. member.csh        Test whether the first argument word appears somewhere in the
  88.                     list given by the second argument.
  89.  
  90. myecho.c            A variation on the builtin echo command that prints its
  91.                     *argv[] (argument) list with quotes around each word it's
  92.                     passed and tells the total character count.  Try these
  93.                     examples:
  94.  
  95.                         % myecho now     is the
  96.                         % myecho "now     is" the
  97.                         % myecho `ls`
  98.                         % myecho `echo`
  99.                         % myecho `echo hello`
  100.                         % myecho * *\* *\*\* | more
  101.  
  102. newfiles.csh    List all the files or directories in the current directory
  103.                     that do not occur in the specified directory.
  104.  
  105. postage.csh        Calculate the U.S. first class postage required for a
  106.                     given weight in ounces.
  107.  
  108. rcode.c            A trivial C program that just prints, then exits with the
  109.                     return code value you pass it.  You can use this routine to
  110.                     see how the status variable is set and also, how the ";",
  111.                     "||" and "&&" statement connectors work.  Try these examples:
  112.  
  113.                         % rcode
  114.                         % calc status
  115.                         % rcode 1
  116.                         % calc status
  117.                         % echo $status
  118.                         % echo status
  119.                         % rcode 2
  120.                         % calc status
  121.                         % rcode 0 || rcode 1
  122.                         % rcode 1 || rcode 2
  123.                         % rcode 0 && rcode 1
  124.                         % rcode 1 && rcode 2
  125.                         % rcode 0 ;  rcode 1
  126.                         % rcode 1 ;  rcode 2
  127.  
  128. sh_2_csh.csh    A script for converting Bourne or Korn shell scripts into
  129.                     Hamilton C shell scripts using a set of sed scripts contained
  130.                     in the sh_2_csh directory.
  131.  
  132. sizeof.csh        A C shell script that calculates the total disk space used
  133.                     by whatever files or directories are given as arguments.
  134.                     
  135. ts.csh            A C shell script that searches for occurrences of a simple
  136.                     string in all the files with a given extension anywhere in
  137.                     a directory tree.
  138.  
  139. weekday.csh        Print the day of the week corresponding to any given date.
  140.  
  141. winerror.c        Print the Win32 message corresponding to a given error code.
  142.