#] 
#] *********************
#] "$d_web"'arrays [ToDos, warnings].txt'  - ???
# www.BillHowell.ca  08Oct2022 initial from 'arrays TblOfContents.txt'  
# view in text editor, using constant-width font (eg courier), tabWidth = 3


#48************************************************48


+-----+
ToDos

21Apr2022 should ary_sub_find_idx1stL faults be returned as a list 
		to be constent with other optrs? (NO! - cannot rely on solitary lists, use ary_hasFaults)
01Sep2022 for valence > 2, the [row, col] title concept implies separate lists
		optrs should be redesigned for this - more efficient too
08Oct2022 tbl_keyAxiIdxL_selAxiOdxL_to_slc - make a separate optr for this!!;  


+-----+
 Warnings and notes

xxx_chkFor_ary_apply_optrPhr forces proper [idx, sub] valence (not for itm)
provides error-tracking faults
then it checks [idx,itm,sub] compatibility with ary
default axis augmentation (if necessary) is to higher dimensions
	where n_axisAdd :=  - EACH valence ary  sub : 
	gage shape resFltL  :=  link  (gage shape ary)  ((gage shape sub) link (n_AxisAdd  reshape  1))
faultL if [not found, other reasons], 10Apr2022 actually returns null if not found (should be fault?)  
As QNial is an array-oriented language, it has extremely powerful built-in capabilities.
	This obviates most of the need for [chr, str, lst, tbl, etc]-specific optrs.
	It is best to learn to work in as [high a dimension, deep a nesting] as practical (or won't learn)
My work below comprises very simple arrangements for simple tasks, with some built-in checks.
www.BillHowell.ca  14Apr2020  initial 
some Howell optrs date from late 1980's?  
2014-15 'matrix operations - symbolic & real-valued.ndf' 
Apr2022 [posn, slice, etc] optrs below, although I did earlier stuff too, nomenclature ripped up!
11Feb2022 many operatornew and not well defined, or just ghosts, ds much more [work, test]s
view this file in a text editor, with [constant width font, tab = 3 spaces], no line-wrap
see "$d_Qndfs"'arrays.ndf'  
		"$d_Qndfs"'array notes.txt'  
	"$d_Qtest"'array- tests.ndf'  
	"$d_Qtest"'array- test results log.txt"
	"$d_Qndfs"'types.ndf'  
slc - "[all-full-but-[one or none]]" INDEX of an array
sub - is a sequence of items at the top level of an array, note that a sub can span [one, more, all] Axs 
		not much use for a separate subSlc of an array - just use sub optrs
[cut, put] - require slc of an array, often built from search for a subAry, 
		put something in non-sub parts of slc
split - requires a hyper-plane index as a specific place to split ary

  
  
# enddoc