section g of routines in std.i

yorick banner

Home

Manual

Packages

Global Index

Keywords

Quick Reference

functions in std.i - g

 
 
 
get_addrs 


             addr_lists= get_addrs(file)  
 
     returns the byte addresses of the non-record and record variables  
     in the binary file FILE, and lists of the record addresses, file  
     indices, and filenames for file families with history records.  
          *addr_lists(1)   absolute addresses of non-record variables  
	  *addr_lists(2)   relative addresses of record variables  
	                   (add record address to get absolute address)  
	     The order of these two address lists matches the  
	     corresponding lists of names returned by get_vars.  
	  *addr_lists(3)   absolute addresses of records  
	  *addr_lists(4)   list of file indices corresponding to  
	                   addr_lists(3); indices are into addr_lists(5)  
	  *addr_lists(5)   list of filenames in the family  

builtin function, documented at i0/std.i   line 2375
SEE ALSO: openb,   updateb,   restore,   jt,   jc,   has_records,  
get_vars  
 
 
 
get_argv 


             get_argv()  
 
     returns string array containing the argv from the command line.  
     The -batch and batch_include.i arguments are removed (not returned).  

builtin function, documented at i0/std.i   line 1596
SEE ALSO: process_argv,   cd,   get_cwd,   get_home,   get_env,  
batch  
 
 
 
get_cwd 


             get_cwd()  
          or get_home()  
 
     returns the pathname of the current working directory or of your  
     home directory.  

builtin function, documented at i0/std.i   line 1580
SEE ALSO: cd,   lsdir,   get_env,   get_argv  
 
 
 
get_env 


             get_env(environment_variable_name)  
 
     returns the environment variable (a string) associated with  
     ENVIRONMENT_VARIABLE_NAME (calls ANSI getenv routine).  

builtin function, documented at i0/std.i   line 1589
SEE ALSO: cd,   get_cwd,   get_home,   get_env,   get_argv  
 
 
 
get_home 


 get_home  
 
builtin function, documented at i0/std.i   line 1580
SEE get_cwd  
 
 
 
get_member 


             get_member(f_or_s, member_name)  
 
     returns F_OR_S member MEMBER_NAME, like F_OR_S.MEMBER_NAME syntax,  
     but MEMBER_NAME can be a computed string.  The F_OR_S may be a  
     binary file or a structure instance.  

builtin function, documented at i0/std.i   line 1739
SEE ALSO: openb  
 
 
 
get_ncycs 


 get_ncycs  
 
builtin function, documented at i0/std.i   line 2400
SEE get_times  
 
 
 
get_primitives 


             prims = get_primitives(file)  
 
     Return the primitive data types for FILE as an array of 32  
     integers.  The format is described under set_primitives.  

builtin function, documented at i0/std.i   line 2067
SEE ALSO: set_primitives,   __xdr,   __i86  
 
 
 
get_times 


             times= get_times(file)  
             ncycs= get_ncycs(file)  
 
     returns the list of time or ncyc values associated with the records  
     if FILE, or nil if there are none.  The time values are not guaranteed  
     to be precise (but they should be good to at least 6 digits or so);  
     the precise time associated with each record may be stored as a record  
     variable.  

builtin function, documented at i0/std.i   line 2400
SEE ALSO: collect,   openb,   updateb,   restore,   jt,   jc,  
edit_times  
 
 
 
get_vars 


             name_lists= get_vars(file)  
 
     returns the lists of non-record and record variable names in the  
     binary FILE.  The return value is an array of two pointers to  
     arrays of type string; *name_lists(1) is the array of non-record  
     variable names (or nil if there are none), *name_lists(2) is the  
     array of record variable names.  
     The get_addrs function returns corresponding lists of disk  
     addresses; the get_member function can be used in conjunction  
     with the dimsof, structof, and typeof functions to determine  
     the other properties of a variable.  

builtin function, documented at i0/std.i   line 2348
SEE ALSO: openb,   updateb,   restore,   jt,   jc,   has_records,  
get_addrs,   set_vars  
 
 
 
grow 


             grow, x, xnext1, xnext2, ...  
          or grow(x, xnext1, xnext2, ...)  
 	 or    _(x, xnext1, xnext2, ...)  
 
     lengthens the array X by appending XNEXT1, XNEXT2, etc. to its  
     final dimension.  If X is nil, X is first redefined to the first  
     non-nil XNEXT, and the remainder of the XNEXT list is processed  
     normally.  Each XNEXT is considered to have the same number of  
     dimensions as X, by appending unit-length dimensions if necessary.  
     All but this final dimension of each XNEXT must be right-conformable  
     (that is, conformable in the sense of the right hand side of an  
     assignment statement) with all but the final dimension of X.  
     The result has a final dimension which is the sum of the final  
     dimension of X and all the final dimensions of the XNEXT.  Nil  
     XNEXT are ignored.  The value of the result is obtained by  
     concatenating all the XNEXT to X, after any required broadcasts.  
     If invoked as a function, grow returns the new value of X; in  
     this case, X may be an expression.  X must be a simple variable  
     reference for the subroutine form of grow; otherwise there is  
     nowhere to return the result.  The subroutine form is slightly  
     more efficient than the function form for the common usage:  
          x= grow(x, xnext1, xnext2)           is the same as  
	  grow, x, xnext1, xnext2              the preferred form  
     The _ function is a synonym for grow, for people who want this  
     operator to look like punctuation in their source code, on analogy  
     with the array building operator [a, b, c, ...].  
     The _cat function is sometimes more appropriate than grow.  

builtin function, documented at i0/std.i   line 857
SEE ALSO: _cat,   array