section _ of routines in std.i

yorick banner

Home

Manual

Packages

Global Index

Keywords

Quick Reference

functions in std.i - _

 
 
 
_


 _  
 
builtin function, documented at i0/std.i   line 857  
SEE grow  
 
 
 
__alpha


 __alpha  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__cray


 __cray  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__dec


 __dec  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__i86


 __i86  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__ibmpc


 __ibmpc  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__mac


 __mac  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__macl


 __macl  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__sgi64


 __sgi64  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__sun


 __sun  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__sun3


 __sun3  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__vax


 __vax  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__vaxg


 __vaxg  
 
keyword,  defined at i0/std.i   line 2102  
SEE __xdr  
 
 
 
__xdr


             primitive data types for various machines:  
 
       little-endians  
   __i86      Intel x86 Linux  
   __ibmpc    IBM PC (2 byte int)  
   __alpha    Compaq alpha  
   __dec      DEC workstation (MIPS), Intel x86 Windows  
   __vax      DEC VAX (H-double)  
   __vaxg     DEC VAX (G-double)  
       big-endians  
   __xdr      External Data Representation  
   __sun      Sun, HP, SGI, IBM-RS6000, MIPS 32 bit  
   __sun3     Sun-2 or Sun-3 (old)  
   __sgi64    SGI, Sun, HP, IBM-RS6000 64 bit  
   __mac      MacIntosh 68000 (power Mac, Gx are __sun)  
   __macl     MacIntosh 68000 (12 byte double)  
   __cray     Cray XMP, YMP  

keyword,  defined at i0/std.i   line 2102  
SEE ALSO: set_primitives  
 
 
 
_car


 _car  
 
builtin function, documented at i0/std.i   line 2921  
SEE _lst  
 
 
 
_cat


 _cat  
 
builtin function, documented at i0/std.i   line 2921  
SEE _lst  
 
 
 
_cdr


 _cdr  
 
builtin function, documented at i0/std.i   line 2921  
SEE _lst  
 
 
 
_cpy


 _cpy  
 
builtin function, documented at i0/std.i   line 2921  
SEE _lst  
 
 
 
_init_clog


             _init_clog, file  
 
     initializes a Clog binary file.  Used after creating a new file --  
     must be called AFTER the primitive data formats have been set.  

builtin function, documented at i0/std.i   line 1886  
 
 
 
_init_pdb


             _init_pdb, file, at_pdb_close  
             _set_pdb, file, at_pdb_close  
 
     initializes a PDB binary file.  Used after creating a new file --  
     must be called AFTER the primitive data formats have been set.  
     The _set_pdb call only sets the CloseHook, on the assumption that  
     the file header has already been written (as in recover_file).  

builtin function, documented at i0/std.i   line 1875  
SEE ALSO: createb,   recover_file,   at_pdb_close  
 
 
 
_jc


 _jc  
 
builtin function, documented at i0/std.i   line 2250  
SEE _jr  
 
 
 
_jr


             _jt, file, time  
             _jc, file, ncyc  
 
	    _jr, file  
     are raw versions of jt and jc provided to simplify redefining  
     the default jt and jc functions to add additional features.  
     For example, you could redefine jt to jump to a time, then  
     plot something.  The new jt can pass its arguments along to  
     _jt, then call the appropriate plotting functions.  
     There is a raw version of jr as well.  

builtin function, documented at i0/std.i   line 2250  
 
 
 
_jt


 _jt  
 
builtin function, documented at i0/std.i   line 2250  
SEE _jr  
 
 
 
_len


 _len  
 
builtin function, documented at i0/std.i   line 2921  
SEE _lst  
 
 
 
_lst


             list= _lst(item1, item2, item3, ...)  

             list= _cat(item_or_list1, item_or_list2, item_or_list3, ...)  
 
	    list= _cpy(list)  
	      list= _cpy(list, i)  
	    length= _len(list)  
            item= _car(list)  
              item_i= _car(list, i)  
              _car, list, i, new_item_i  
	    list= _cdr(list)  
	      list= _cdr(list, i)  
              _cdr, list, i, new_list_i  
     implement rudimentary Lisp-like list handling in Yorick.  
     However, in Yorick, a list must have a simple tree structure  
     - no loops or rings are allowed (loops break Yorick's memory  
     manager - beware).  You need to be careful not to do this as  
     the error will not be detected.  
     Lists are required in Yorick whenever you need to hold an  
     indeterminate amount of non-array data, such as file handles,  
     bookmarks, functions, index ranges, etc.  Note that Yorick  
     pointers cannot point to these objects.  For array data, you have  
     a choice between a list and a struct or an array of pointers.  
     Note that a list cannot be written into a file with the save  
     function, since it may contain unsaveable items.  
     The _lst (list), _cat (catenate), and _cpy (copy) functions  
     are the principal means for creating and maintaining lists.  
     _lst makes a list out of its arguments, so that each argument  
     becomes one item of the new list.  Unlike Yorick array data  
     types, a statement like x=list does not make a copy of the  
     list, it merely makes an additional reference to the list.  
     You must explicitly use the _cpy function to copy a list.  Note  
     that _cpy only copies the outermost list itself, not the items  
     in the list (even if those items are lists).  With the second  
     argument i, _cpy copies only the first i items in the list.  
     The _cat function concatentates several lists together,  
     "promoting" any arguments which are not lists.  This operation  
     changes the values of list arguments to _cat, except for the  
     final argument, since after _cat(list, item), the variable list  
     will point to the new longer list returned by _cat.  
     Nil, or [], functions as an empty list.  This leads to ambiguity  
     in the argument list for _cat, since _cat "promotes" non-list  
     arguments to lists; _cat treats [] as an empty list, not as a  
     non-list item.  Also, _lst() or _lst([]) returns a single item list,  
     not [] itself.  
     The _len function returns the number of items in a list, or 0  
     for [].  
     The _car and _cdr functions (the names are taken from Lisp,  
     where they originally stood for something like "address register"  
     and "data register" of some long forgotten machine) provide  
     access to the items stored in a list.  _car(list,i) returns the  
     i-th item of the list, and i defaults to 1, so _car(list) is the  
     first item.  Also, _car,list,i,new_item_i sets the i-th item  
     of the list.  Finally, _cdr(list,i) returns a list of all the  
     items beyond the i-th, where i again defaults to 1.  The form  
     _cdr,list,i,new_list_i can be used to reset all list items  
     beyond the i-th to new values.  In the _cdr function, i=0 is  
     allowed.  When used to set values, both _car and _cdr can also  
     be called as functions, in which case they return the item or  
     list which has been replaced.  The _cdr(list) function returns  
     nil if and only if LIST contains only a single item; this is  
     the usual means of halting a loop over items in a list.  

builtin function, documented at i0/std.i   line 2921  
SEE ALSO: array,   grow,   _prt,   _map,   _rev,   _nxt  
 
 
 
_map


             _map(f, list)  
 
     return a list of the results of applying function F to each  
     element of the input LIST in turn, as if by  
       _lst(f(_car(list,1)),f(_car(list,2)),...)  

interpreted function, defined at i0/std.i   line 3015  
SEE ALSO: _lst  
 
 
 
_not_cdf


             _not_cdf(file)  
 
     is like _not_pdb, but for netCDF files.  

interpreted function, defined at i0/std.i   line 1899  
 
 
 
_not_pdb


             _not_pdb(file, familyOK)  
 
     returns 1 if FILE is not a PDB file, otherwise returns 0 after  
     setting the structure and data tables, and cataloguing any  
     history records.  Used to open an existing file.  Also detects  
     a file with an appended Clog description.  
     Before calling _not_pdb, set the variable yPDBopen to the value  
     of at_pdb_open you want to be in force.  (For historical reasons  
     -- in order to allow for the open102 keyword to openb -- _not_pdb  
     looks at the value of the variable yPDBopen, rather than at_pdb_open  
     directly.)  

builtin function, documented at i0/std.i   line 1779  
 
 
 
_not_pdbf


 _not_pdbf  
 
  

interpreted function, defined at i0/std.i   line 1873  
 
 
 
_nxt


             item= _nxt(list)  
 
     return first item in LIST, and set LIST to list of remaining  
     items.  If you are iterating through a list, this is the way  
     to do it, since a loop on _car(list,i) with i varying from 1  
     to _len(list) scales quadratically with the length of the list,  
     while a loop on _nxt(list) scales linearly.  

interpreted function, defined at i0/std.i   line 3052  
SEE ALSO: _car,   _lst  
 
 
 
_prt


             _prt, list  
 
     print every item in a list, recursing if some item is itself a list.  

interpreted function, defined at i0/std.i   line 2997  
SEE ALSO: _lst  
 
 
 
_read


             _write, file, address, expression  
             _read, file, address, variable  
 	 or nbytes= _read(file, address, variable);  
 
     are low level read and write functions which do not "see" the  
     symbol table for the binary FILE.  The ADDRESS is the byte address  
     at which to begin the write or read operation.  The type and number  
     of objects of the EXPRESSION or VARIABLE determines how much data  
     to read, and what format conversion operations to apply.  In the  
     case of type char, no conversion operations are ever applied, and  
     _read will return the actual number of bytes read, which may be  
     fewer than the number implied by VARIABLE in this one case.  
     (In all other cases, _read returns numberof(VARIABLE).)  
     If the FILE has records, the ADDRESS is understood to be in the  
     file family member in which the current record resides.  

builtin function, documented at i0/std.i   line 2435  
SEE ALSO: openb,   createb,   updateb,   save,   restore,  
sizeof  
 
 
 
_rev


             _rev(list)  
 
     returns the input list in reverse order  

interpreted function, defined at i0/std.i   line 3036  
SEE ALSO: _lst  
 
 
 
_set_pdb


 _set_pdb  
 
builtin function, documented at i0/std.i   line 1875  
SEE _init_pdb  
 
 
 
_write


 _write  
 
builtin function, documented at i0/std.i   line 2435  
SEE _read