-- %D \module
-- %D [ file=t-handlecsv.lua,
-- %D version=2018.02.26,
-- %D title=HandleCSV module,
-- %D subtitle=CSV file handling,
-- %D author=Jaroslav Hajtmar,
-- %D date=\currentdate,
-- %D copyright=Jaroslav Hajtmar,
-- %D email=hajtmar@gyza.cz,
-- %D license=GNU General Public License]
--
-- %C Copyright (C) 2018 Jaroslav Hajtmar
-- %C
-- %C This program is free software: you can redistribute it and/or modify
-- %C it under the terms of the GNU General Public License as published by
-- %C the Free Software Foundation, either version 3 of the License, or
-- %C (at your option) any later version.
-- %C
-- %C This program is distributed in the hope that it will be useful,
-- %C but WITHOUT ANY WARRANTY; without even the implied warranty of
-- %C MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-- %C GNU General Public License for more details.
-- %C
-- %C You should have received a copy of the GNU General Public License
-- %C along with this program. If not, see .
-- use a feature that is part of the /texmf-dist/tex/context/base/util-prs.lua
thirddata = thirddata or { }
thirddata.handlecsv = { -- Global variables
-- gCSVSeparator
gUserCSVSeparator=';', -- the most widely used field separator in CSV tables
-- gCSVQuoter
gUserCSVQuoter='"', --
-- gCSVHeader
gUserCSVHeader=false, -- CSV file is by default considered as a CSV file without the header (in header are treated as column names of macros
gUserUseHooks=false, -- In default setting is not use "hooks" when process CSV file
gUserColumnNumbering='XLS', -- Something other than the XLS or undefined variable value (eg commenting that line) to set the Roman numbering ...
gCurrentlyProcessedCSVFile=nil,
gMarkingEmptyLines=false,
gUserMarkingEmptyLines=false, -- if true, then module mark empty rows in CSV file else module accept empty lines as regular lines
gTableEmptyRows={}, -- array of indexes of empty lines of CSV table -> gTableEmptyRows['csvfilename'][1]= 3 etc
gTableNotEmptyRows={}, -- array of indexes of nonempty lines of CSV table -> gTableNotEmptyRows['csvfilename'][1]= 3 etc
gCSVHandleBuffer={}, -- temporary buffer
-- NEW variables
gOpenFiles={}, -- array of all opened files
gNumLine={}, -- global variable - gNumLine['csvfilename.csv']=0
gNumRows={}, -- global variable - save number of rows of csv table: gNumRows['csvfilename']=0
gNumEmptyRows={}, -- global variable - save number of empty rows of csv table: gNumEmptyRows['csvfilename']=0
gNumNotEmptyRows={}, -- global variable - save number of empty rows of csv table: gNumNotEmptyRows['csvfilename']=0
gNumCols={}, -- global variable - save number of columns of csv table: gNumCols['csvfilename']=0
gCurrentLinePointer={}, -- ie. CSV line number ie. number of the currently processed row: gCurrentLinePointer['csvfilename']=0
gColumnNames={}, -- array with column names (readings from header of CSV file): gColumnNames['csvfilename']
gColNames={}, -- associative array with column names for indexing use f.e. gColNames['csvfilename']['Firstname']=1, etc...
gTableRows={}, -- array of contents of cells of CSV table -> gTableRows['csvfilename'][row][column]
gTableRowsIndex={}, -- array of flags of lines of CSV table -> gTableEmptyRowsIndex['csvfilename'][i]= true or false
gSavedLinePointerNo=1, -- global variable to keep the line number
}
local setmacro = interfaces.setmacro or ""
-- Initialize global variables etc.
-- Default value is saved in glob. variable gUseHooks (default is FALSE)
if thirddata.handlecsv.gUseHooks == nil then thirddata.handlecsv.gUseHooks = thirddata.handlecsv.gUserUseHooks end
-- Default value is saved in glob. variable gUserCSVHeader (default FALSE)
if thirddata.handlecsv.gCSVHeader == nil then thirddata.handlecsv.gCSVHeader = thirddata.handlecsv.gUserCSVHeader end
-- Default value is saved in glob. variable gCSVSeparator (default COMMA)
if thirddata.handlecsv.gCSVSeparator == nil then thirddata.handlecsv.gCSVSeparator = thirddata.handlecsv.gUserCSVSeparator end
-- Default value is saved in glob. variable gCSVSeparator (default ")
if thirddata.handlecsv.gCSVQuoter == nil then thirddata.handlecsv.gCSVQuoter = thirddata.handlecsv.gUserCSVQuoter end
-- Default value is saved in glob. variable gMarkingEmptyLines (default is FALSE)
if thirddata.handlecsv.gMarkingEmptyLines==nil then thirddata.handlecsv.gMarkingEmptyLines = thirddata.handlecsv.gUserMarkingEmptyLines end
-- Tools block: Contain auxiliary functions and tools
function thirddata.handlecsv.texmacroisdefined(macroname) -- check whether macroname macro is defined in ConTeXt
-- function is used to test whether the user has defined the macro \macroname. If not, it needs to define any default value
return token.get_cmdname(token.create(macroname)) ~= "undefined_cs"
end
function thirddata.handlecsv.ParseCSVLine(line,sep)
-- tool function ParseCSVLine is defined for compatibility. Parsing string (or line).
local mycsvsplitter = utilities.parsers.rfc4180splitter{
separator = sep,
quote = '"',
strict=true, -- add 15.2.2016
}
local list = mycsvsplitter(line) inspect(list)
return list[1]
end
function thirddata.handlecsv.tmn(s) -- TeX Macro Name. Name of TeX macro should not contain forbidden characters
if string.len(s) == 0 then s='nil' end -- When the parameter 's' does not contain any character that is not the separator character, it is necessary to create macro name
maxmacrolength=50 -- if the first string in line longer "than is healthy, so about 50 characters is sufficient
-- ATTENTION! In the case that 1st CSV table row header that is a different column for content, which coincides with the first 'maxmacrolength' characters, the names of macros in different columns are the same (ie, the macro will give the correct result for the column)
diachar= {"á","ä","č","ď","é","ě","í","ň","ó","ř","š","ť","ú","ů","ý","ž","Á","Ä","Č","Ď","É","Ě","Í","Ň","Ó","Ř","Š","Ť","Ú","Ů","Ý","Ž"}
asciichar={"a","a","c","d","e","e","i","n","o","r","s","t","u","u","y","z","A","A","C","D","E","E","I","N","O","R","S","T","U","U","Y","Z"}
for i=1, 32 do
s=string.gsub(s, diachar[i], asciichar[i]) -- change diakritics chars
end
--s=string.gsub(s, "%d", "n") -- replace the numbers in name
-- For 0-9 to replace the letter O or Roman numerals
s=string.gsub(s, "0", "O") -- replace the numbers in name
s=string.gsub(s, "1", "I") -- replace the numbers in name
s=string.gsub(s, "2", "II") --
s=string.gsub(s, "3", "III") --
s=string.gsub(s, "4", "IV") --
s=string.gsub(s, "5", "V") --
s=string.gsub(s, "6", "VI") --
s=string.gsub(s, "7", "VII") --
s=string.gsub(s, "8", "VIII") --
s=string.gsub(s, "9", "IX") --
s=string.gsub(s, "%A", "x") -- Finally still removes all nealfabetic characters that were left there
if string.len(s) > maxmacrolength+1 then s=string.sub(s, 1, maxmacrolength) end -- to limit the maximum length of a macro
return s
end
function thirddata.handlecsv.xls2ar(colname) -- convert Excel column name (like A, B, ... AA, AB, ...) into serial number of column (A->1, B->2, ...)
-- No for more than 702 columns (ie last column parametr for this function is ZZ)
-- for example Excel 2003 can handle only up to the column IV!
local colnumber=0
local colname=colname:upper()
for i=1, string.len(colname) do
local onechar = string.sub(colname,i,i)
colnumber=26*colnumber + (string.byte(onechar) - string.byte('A') + 1)
end
return colnumber
end
function thirddata.handlecsv.ar2xls(arnum) -- convert number to Excel name column
-- For more than 703 columns (ie column A to ZZ) should be a function to modify
-- Excel 2003 can handle only up to the column IV!
local part=math.floor(arnum/26)
local remainder = math.mod(arnum,26)
part = part - (math.mod(arnum,26)==0 and 1 or 0)
remainder = remainder + (math.mod(arnum,26)==0 and 26 or 0)
local ctl =''
if arnum < 703 then
if part > 0 then
ctl=string.char(64+part)
end
ctl = ctl .. string.char(64+remainder)
else
ctl = 'overZZ'
end
return ctl
end
function thirddata.handlecsv.ar2colnum(arnum) -- According to the settings glob. variable returns the column designation of TeX macros
-- generated TeX macros referring to values in columns are numbered a`la EXCEL ie cA, cB, ..., cAA, etc
-- or a`la roman number ie. cI, cII, cIII, cIV, ..., cXVIII, etc
-- if it is "romannumbers" setting, then columns wil numbered by Romna else ala Excel
if string.lower(thirddata.handlecsv.gUserColumnNumbering) == 'xls' then
return thirddata.handlecsv.ar2xls(arnum) -- a la EXCEL
else
return string.upper(converters.romannumerals(arnum)) -- a la big ROMAN - convert Arabic numbers to big Roman. Used for "numbering" column in the TeX macros
end
end
function thirddata.handlecsv.substitutecontentofcellof(csvfile,column,row,whattoreplace,substitution)
-- Substitute text in cell content of specified CSV file with other text
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
local column=thirddata.handlecsv.gColNames[csvfile][column]
local whattoreplace=tostring(whattoreplace)
local substitution=tostring(substitution)
return thirddata.handlecsv.getcellcontentof(csvfile,column,row):gsub(whattoreplace,substitution)
end
function thirddata.handlecsv.substitutecontentofcell(column,row,whattoreplace,substitution)
-- Substitute text in cell content of current CSV file with other text
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
local column=thirddata.handlecsv.gColNames[csvfile][column]
return thirddata.handlecsv.substitutecontentofcellof(csvfile,column,row,whattoreplace,substitution)
end
function thirddata.handlecsv.substitutecontentofcellofcurrentrow(column,whattoreplace,substitution)
-- Substitute text in cell content of current row of current CSV file with other text
local row=thirddata.handlecsv.linepointer()
return thirddata.handlecsv.substitutecontentofcell(column,row,whattoreplace,substitution)
end
function thirddata.handlecsv.processinputvalue(inputparameter,replacingnumber)
-- when inputparameter is not correct, then return replacingnumber
local returnparameter=inputparameter
if type(inputparameter)~= 'number' then
returnparameter=replacingnumber
end --
return returnparameter
end
-- Main functions and macros:
function thirddata.handlecsv.hookson()
thirddata.handlecsv.gUseHooks=true
end
function thirddata.handlecsv.hooksoff()
thirddata.handlecsv.gUseHooks=false
end
function thirddata.handlecsv.setfiletoscan(filetoscan)
local inpcsvfile=thirddata.handlecsv.handlecsvfile(filetoscan)
thirddata.handlecsv.gCurrentlyProcessedCSVFile=inpcsvfile
end
function thirddata.handlecsv.setheader()
thirddata.handlecsv.gCSVHeader=true
context([[\global\issetheadertrue%]])
context([[\global\notsetheaderfalse%]])
end
function thirddata.handlecsv.unsetheader()
thirddata.handlecsv.gCSVHeader=false
context([[\global\issetheaderfalse%]])
context([[\global\notsetheadertrue%]])
end
function thirddata.handlecsv.setsep(sep)
thirddata.handlecsv.gCSVSeparator=sep
end
function thirddata.handlecsv.unsetsep()
thirddata.handlecsv.gCSVSeparator=thirddata.handlecsv.gUserCSVSeparator
end
function thirddata.handlecsv.indexofnotemptyline(sernumline)
local csvfilename=thirddata.handlecsv.getcurrentcsvfilename()
return thirddata.handlecsv.gTableNotEmptyRows[csvfilename][sernumline]
end
function thirddata.handlecsv.indexofemptyline(sernumline)
local csvfilename=thirddata.handlecsv.getcurrentcsvfilename()
return thirddata.handlecsv.gTableEmptyRows[csvfilename][sernumline]
end
function thirddata.handlecsv.notmarkemptylines()
local csvfilename=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.gMarkingEmptyLines=false
for row=1,thirddata.handlecsv.gNumRows[csvfilename] do
thirddata.handlecsv.gTableNotEmptyRows[csvfilename][row]=row
end
thirddata.handlecsv.gTableEmptyRows[csvfilename]={}
thirddata.handlecsv.gNumEmptyRows[csvfilename]=0
thirddata.handlecsv.gNumNotEmptyRows[csvfilename]=thirddata.handlecsv.gNumRows[csvfilename]
context([[\global\emptylinefalse%]])
context([[\global\notemptylinetrue%]])
context([[\global\emptylinesmarkingfalse%]])
context([[\global\emptylinesnotmarkingtrue%]])
end
function thirddata.handlecsv.markemptylines()
local csvfilename=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.gTableEmptyRows[csvfilename]={}
thirddata.handlecsv.gTableNotEmptyRows[csvfilename]={}
thirddata.handlecsv.gMarkingEmptyLines=true
local counteremptylines=0
local counternotemptylines=0
for row=1,thirddata.handlecsv.gNumRows[csvfilename] do
if thirddata.handlecsv.testemptyrow(row) then
counteremptylines=counteremptylines+1
thirddata.handlecsv.gTableEmptyRows[csvfilename][counteremptylines]=row
else
counternotemptylines=counternotemptylines+1
thirddata.handlecsv.gTableNotEmptyRows[csvfilename][counternotemptylines]=row
end
end -- for
thirddata.handlecsv.gNumEmptyRows[csvfilename]=counteremptylines
thirddata.handlecsv.gNumNotEmptyRows[csvfilename]=counternotemptylines
context([[\global\emptylinesmarkingtrue%]])
context([[\global\emptylinesnotmarkingfalse%]])
end
function thirddata.handlecsv.resetmarkemptylines()
-- do following lines only when file contain completely empty rows and is requiring testing empty lines
local csvfilename=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.gMarkingEmptyLines = thirddata.handlecsv.gUserMarkingEmptyLines
if thirddata.handlecsv.gMarkingEmptyLines then
thirddata.handlecsv.markemptylines()
else thirddata.handlecsv.notmarkemptylines()
end -- if thirddata.handlecsv.gMarkingEmptyLines
end
function thirddata.handlecsv.testemptyrow(lineindex)
local csvfilename=thirddata.handlecsv.getcurrentcsvfilename()
local linecontent=""
local isemptyline=false
for column=1,thirddata.handlecsv.gNumCols[csvfilename] do
linecontent=linecontent..thirddata.handlecsv.gTableRows[csvfilename][lineindex][column]
end
if linecontent=="" or linecontent==nil then
isemptyline=true
-- thirddata.handlecsv.gNumEmptyRows[csvfilename]=thirddata.handlecsv.gNumEmptyRows[csvfilename]+1
end
thirddata.handlecsv.gTableRowsIndex[csvfilename][lineindex]=isemptyline
return isemptyline
end
function thirddata.handlecsv.emptylineevaluation(lineindex)
if thirddata.handlecsv.gTableRowsIndex[thirddata.handlecsv.getcurrentcsvfilename()][lineindex] then
context([[\global\emptylinetrue%]])
context([[\global\notemptylinefalse%]])
else
context([[\global\emptylinefalse%]])
context([[\global\notemptylinetrue%]])
end
return thirddata.handlecsv.gTableRowsIndex[thirddata.handlecsv.getcurrentcsvfilename()][lineindex]
end
function thirddata.handlecsv.removeemptylines()
-- This function remove empty rows only from field of variables thirddata.handlecsv.gTableRows!
-- The field is only re-indexed and function does not affect onto the physical input CSV file!
-- When the physical CSV file is reopened by using \open macro, the global field variable
-- thirddata.handlecsv.gTableRows[csvfile] is reset into original state!
thirddata.handlecsv.markemptylines()
local csvfilename=thirddata.handlecsv.getcurrentcsvfilename()
for i=1,thirddata.handlecsv.gNumNotEmptyRows[csvfilename] do
local indexofnotemptyrow=thirddata.handlecsv.gTableNotEmptyRows[csvfilename][i]
-- i<--indexofnotemptyrow
thirddata.handlecsv.gTableRows[csvfilename][i]=thirddata.handlecsv.gTableRows[csvfilename][indexofnotemptyrow]
end
for i=thirddata.handlecsv.gNumNotEmptyRows[csvfilename]+1,thirddata.handlecsv.gNumRows[csvfilename] do
thirddata.handlecsv.gTableRows[csvfilename][i]=nil
end
thirddata.handlecsv.gNumRows[csvfilename]=thirddata.handlecsv.gNumNotEmptyRows[csvfilename]
thirddata.handlecsv.markemptylines()
thirddata.handlecsv.gTableEmptyRows[csvfilename]={}
thirddata.handlecsv.gTableNotEmptyRows[csvfilename]={}
end
function thirddata.handlecsv.hooksevaluation()
for i=1,#thirddata.handlecsv.gColumnNames[thirddata.handlecsv.getcurrentcsvfilename()] do
if not thirddata.handlecsv.texmacroisdefined('bch'..thirddata.handlecsv.gColumnNames[thirddata.handlecsv.getcurrentcsvfilename()][i]) then
context.setgvalue('bch'..thirddata.handlecsv.gColumnNames[thirddata.handlecsv.getcurrentcsvfilename()][i],'\\relax')
end
if not thirddata.handlecsv.texmacroisdefined('ech'..thirddata.handlecsv.gColumnNames[thirddata.handlecsv.getcurrentcsvfilename()][i]) then
context.setgvalue('ech'..thirddata.handlecsv.gColumnNames[thirddata.handlecsv.getcurrentcsvfilename()][i],'\\relax')
end
end
end
function thirddata.handlecsv.setgetcurrentcsvfile(filename)
-- In the absence of the file name to use the global variable
thirddata.handlecsv.gCurrentlyProcessedCSVFile = (filename ~= nil) and filename or thirddata.handlecsv.gCurrentlyProcessedCSVFile
thirddata.handlecsv.gCurrentlyProcessedCSVFile = (thirddata.handlecsv.gCurrentlyProcessedCSVFile == nil) and filename or thirddata.handlecsv.gCurrentlyProcessedCSVFile
local filename = filename ~= nil and filename or thirddata.handlecsv.gCurrentlyProcessedCSVFile
-- thirddata.handlecsv.gCurrentlyProcessedCSVFile = tostring(filename)
return tostring(filename)
end
function thirddata.handlecsv.handlecsvfile(filename)
-- not used yet
local filename = tostring(filename)
filename = string.gsub(filename, '"', '')
filename = string.gsub(filename, "'", "")
if not (thirddata.handlecsv.isopenfile(filename)) then
filename = (filename ~= nil) and filename or thirddata.handlecsv.gCurrentlyProcessedCSVFile
filename = (thirddata.handlecsv.gCurrentlyProcessedCSVFile == nil) and filename or thirddata.handlecsv.gCurrentlyProcessedCSVFile
filename = filename ~= nil and filename or thirddata.handlecsv.gCurrentlyProcessedCSVFile
filename = filename ~= '' and filename or thirddata.handlecsv.gCurrentlyProcessedCSVFile
end
return filename
end
function thirddata.handlecsv.getcurrentcsvfilename()
-- return current (actual) CSV file
return tostring(thirddata.handlecsv.gCurrentlyProcessedCSVFile)
end
function thirddata.handlecsv.isopenfile(csvfilename)
-- testing of opening CSV files
local retval=(thirddata.handlecsv.gOpenFiles[csvfilename] ~= nil)
return retval
end
function thirddata.handlecsv.closecsvfile(csvfilename)
-- manual closing of CSV files
thirddata.handlecsv.gOpenFiles[csvfilename] = nil
end
function thirddata.handlecsv.getnumberofopencsvfiles()
-- get the number of open files
local count = 0
for k, v in pairs(thirddata.handlecsv.gOpenFiles) do
count = count + 1
end
return count
end
function thirddata.handlecsv.setpointersofopeningcsvfile(inpcsvfile)
thirddata.handlecsv.gCurrentLinePointer[inpcsvfile]=1
thirddata.handlecsv.gNumLine[inpcsvfile]=1 -- set numline counter of file inpcsvfile
thirddata.handlecsv.resetlinepointerof(inpcsvfile) -- set pointer to begin table (first row)
thirddata.handlecsv.setnumlineof(inpcsvfile,1)
context([[\global\EOFfalse%]])
context([[\global\notEOFtrue%]])
thirddata.handlecsv.resetmarkemptylines()
end
function thirddata.handlecsv.opencsvfile(filetoscan)
-- Open CSV tabule, inicialize variables
-- open the table and load it into the global variable thirddata.handlecsv.gTableRows[filetoscan]
-- if the option thirddata.handlecsv.gCSVHeader==true is enabled, then into glob variable thirddata.handlecsv.gColumnNames[filetoscan]
-- sets the column names from the title, if not then sets XLS notation, ie. cA, cB, cC, ...
-- into global variables thirddata.handlecsv.gNumRows[filetoscan] and thirddata.handlecsv.gNumCols[filetoscan] it saves the number of rows and columns of the table
-- if the file header and the header line does not count the number of rows in the table
-- Additionally, they can defined ConTeXt macros \csvfilename, \numrows a \numcols
local inpcsvfile=thirddata.handlecsv.setgetcurrentcsvfile(filetoscan) -- set filetoscan as current processed csv file
if thirddata.handlecsv.isopenfile(inpcsvfile) then -- if file is open, then set needed pointers at first line of file only
thirddata.handlecsv.setpointersofopeningcsvfile(inpcsvfile)
else -- if CSV file is not open, then open it and set all needed variables
local inpcsvfile=thirddata.handlecsv.setgetcurrentcsvfile(inpcsvfile)
thirddata.handlecsv.gOpenFiles[inpcsvfile]=inpcsvfile -- memory opening file
thirddata.handlecsv.gColNames[inpcsvfile]={}
thirddata.handlecsv.gColumnNames[inpcsvfile]={}
thirddata.handlecsv.gTableRowsIndex[inpcsvfile]={}
thirddata.handlecsv.gTableRows[inpcsvfile]={}
thirddata.handlecsv.gTableEmptyRows[inpcsvfile]={}
thirddata.handlecsv.gTableNotEmptyRows[inpcsvfile]={}
local currentlyprocessedcsvfile = io.loaddata(inpcsvfile)
local mycsvsplitter = utilities.parsers.rfc4180splitter{
separator = thirddata.handlecsv.gCSVSeparator,
quote = thirddata.handlecsv.gCSVQuoter,
strict = true,
}
if thirddata.handlecsv.gCSVHeader then
thirddata.handlecsv.gTableRows[inpcsvfile], thirddata.handlecsv.gColumnNames[inpcsvfile] = mycsvsplitter(currentlyprocessedcsvfile,true)
inspect(thirddata.handlecsv.gTableRows[inpcsvfile])
inspect(thirddata.handlecsv.gColumnNames[inpcsvfile])
else -- if thirddata.handlecsv.gCSVHeader
thirddata.handlecsv.gTableRows[inpcsvfile], thirddata.handlecsv.gColumnNames[inpcsvfile] = mycsvsplitter(currentlyprocessedcsvfile)
inspect(thirddata.handlecsv.gTableRows[inpcsvfile])
thirddata.handlecsv.gColumnNames[inpcsvfile]={}
-- ad now set column names for withoutheader situation:
for i=1,#thirddata.handlecsv.gTableRows[inpcsvfile][1] do
-- OK, but not used: thirddata.handlecsv.gColumnNames[inpcsvfile][i]=thirddata.handlecsv.tmn(thirddata.handlecsv.gTableRows[inpcsvfile][1][i])
thirddata.handlecsv.gColumnNames[inpcsvfile][i]=tostring(thirddata.handlecsv.ar2xls(i)) -- set XLS notation (fill array with XLS names of columns like 'cA', 'cB', etc.)
end -- for
end -- if thirddata.handlecsv.gCSVHeader
for i=1,#thirddata.handlecsv.gTableRows[inpcsvfile][1] do
thirddata.handlecsv.gColNames[inpcsvfile][tostring(thirddata.handlecsv.tmn(thirddata.handlecsv.gColumnNames[inpcsvfile][i]))] = i -- for indexing use (register names of macros ie 'Firstname' etc...)
thirddata.handlecsv.gColNames[inpcsvfile][tostring(thirddata.handlecsv.gColumnNames[inpcsvfile][i])] = i -- for indexing use (register names of macros ie 'Firstname' etc...)
thirddata.handlecsv.gColNames[inpcsvfile][tostring(thirddata.handlecsv.ar2xls(i))] = i -- for indexcolname macro (register names of macros ie 'A', 'B', etc...)
thirddata.handlecsv.gColNames[inpcsvfile][tostring('c'..thirddata.handlecsv.ar2xls(i))] = i -- for indexcolname macro (register names of macros ie 'cA', 'cB', etc...)
thirddata.handlecsv.gColNames[inpcsvfile][tostring(i)] = i -- for indexcolname macro (register names of macros ie 'cA', 'cB', etc...)
thirddata.handlecsv.gColNames[inpcsvfile][i] = i -- for indexcolname macro (register names of macros ie 'cA', 'cB', etc...)
end -- for
local j=#thirddata.handlecsv.gTableRows[inpcsvfile][1]
for i=1,#thirddata.handlecsv.gTableRows[inpcsvfile][1] do
j=j+1
thirddata.handlecsv.gColumnNames[inpcsvfile][j]=tostring('c'..thirddata.handlecsv.ar2xls(i)) -- set XLS notation (fill array with XLS names of columns like 'cA', 'cB', etc.)
end -- for
if thirddata.handlecsv.gCSVHeader then
for i=1,#thirddata.handlecsv.gTableRows[inpcsvfile][1] do
j=j+1
thirddata.handlecsv.gColumnNames[inpcsvfile][j]=tostring(thirddata.handlecsv.ar2xls(i)) -- set XLS notation (fill array with XLS names of columns like 'cA', 'cB', etc.)
end -- for
for i=1,#thirddata.handlecsv.gTableRows[inpcsvfile][1] do
j=j+1
thirddata.handlecsv.gColumnNames[inpcsvfile][j]=tostring(thirddata.handlecsv.tmn(thirddata.handlecsv.gColumnNames[inpcsvfile][i])) -- maybe TeX incorect names of columns
end -- for
end -- if thirddata.handlecsv.gCSVHeader then
thirddata.handlecsv.gNumRows[inpcsvfile]=#thirddata.handlecsv.gTableRows[inpcsvfile] -- Getting number of rows
thirddata.handlecsv.gNumCols[inpcsvfile]=#thirddata.handlecsv.gTableRows[inpcsvfile][1] -- Getting number of columns
thirddata.handlecsv.gNumEmptyRows[inpcsvfile]=0
thirddata.handlecsv.gNumNotEmptyRows[inpcsvfile]=#thirddata.handlecsv.gTableRows[inpcsvfile]
thirddata.handlecsv.setpointersofopeningcsvfile(inpcsvfile) -- set pointers
if thirddata.handlecsv.gUseHooks then thirddata.handlecsv.hooksevaluation() end
end -- if thirddata.handlecsv.isopenfile(inpcsvfile) then
return
end -- of thirddata.handlecsv.opencsvfile(file)
function thirddata.handlecsv.readlineof(inpcsvfile,numberofline) --
-- Main function. Read data from specific line of specific file, parse them etc.
local inpcsvfile=thirddata.handlecsv.handlecsvfile(inpcsvfile)
local numberofline=numberofline
local returnpar=false
if type(numberofline)~= 'number' then
if numberofline==nil then
numberofline=thirddata.handlecsv.gCurrentLinePointer[inpcsvfile]
returnpar=true
else numberofline = 0
end -- if numberofline==nil
end -- if type(numberofline)
if (numberofline > 0 and numberofline <=thirddata.handlecsv.gNumRows[inpcsvfile]) then
thirddata.handlecsv.addtonumlineof(inpcsvfile,1)
thirddata.handlecsv.gCurrentLinePointer[inpcsvfile]=numberofline
returnpar=true
thirddata.handlecsv.assigncontentsof(inpcsvfile,thirddata.handlecsv.gTableRows[inpcsvfile][numberofline])
context([[\global\EOFfalse\global\notEOFtrue%]])
else
thirddata.handlecsv.assigncontentsof(inpcsvfile,'nil_line')
if numberofline > thirddata.handlecsv.gNumRows[inpcsvfile] then
context([[\global\EOFtrue\global\notEOFfalse%]])
end
end -- if (numberofline > 0
--řešit thirddata.handlecsv.emptylineevaluation(numberofline)
return returnpar -- return true if numberofline is regular line, else return false
end -- function thirddata.handlecsv.readlineof(inpcsvfile,numberofline) --
function thirddata.handlecsv.readline(numberofline) --
-- Main function. Read data from specific line of specific file, parse them etc.
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
if type(numberofline) == 'number' then
thirddata.handlecsv.readlineof(csvfile,numberofline) --
else
thirddata.handlecsv.readlineof(csvfile,thirddata.handlecsv.gCurrentLinePointer[csvfile]) --
end
end
function thirddata.handlecsv.createxlscommandof(xlsname,csvfile)
local inpcsvfile=thirddata.handlecsv.handlecsvfile(csvfile)
local cxlsname=tostring('col'..xlsname)
local docxlsname=tostring('docol'..xlsname)
local xlsname=tostring(''..xlsname)
-- context([[\def\definice]]..xlsname..[[#1{\ctxlua{context(thirddata.handlecsv.getcellcontentof(']]..inpcsvfile..[[',']]..xlsname..[[','#1'))}}]])
interfaces.definecommand (docxlsname, {
arguments = { { "option", "string" } },
macro = function (opt_1)
if #opt_1>0 then
context(thirddata.handlecsv.getcellcontentof(inpcsvfile,xlsname,tonumber(opt_1)))
else
context(thirddata.handlecsv.getcellcontentof(inpcsvfile,xlsname,thirddata.handlecsv.gCurrentLinePointer[inpcsvfile]))
end
end
})
interfaces.definecommand(cxlsname, {
macro = function ()
context.dosingleempty()
context[docxlsname]()
end
})
-- interfaces.definecommand ("column"..xlsname, {
-- arguments = { { "option"} },
-- macro = function (opt_1)
-- if opt_1~="" then
-- context(thirddata.handlecsv.getcellcontentof(inpcsvfile,xlsname,tonumber(opt_1)))
-- else
-- context(thirddata.handlecsv.getcellcontentof(inpcsvfile,xlsname,thirddata.handlecsv.gCurrentLinePointer[inpcsvfile]))
-- end
-- end
-- })
end
function thirddata.handlecsv.createxlscommand(xlsname)
local inpcsvfile=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.createxlscommandof(xlsname,inpcsvfile)
end
function thirddata.handlecsv.assigncontentsof(inpcsvfile,line) -- put data into columns macros
-- after read of line this function put content of columns into specific TeX macros...
--if tex.modes['XXL'] then context("XXL mode") else context("not XXL mode") end
local inpcsvfile=thirddata.handlecsv.handlecsvfile(inpcsvfile)
local cutoffinpcsvfile=thirddata.handlecsv.ParseCSVLine(inpcsvfile,".")[1] -- cut filename extension
for i=1,thirddata.handlecsv.gNumCols[inpcsvfile] do
content='nil' -- 1.10.2015
if line ~= 'nil_line' then content = line[i] end
local puremacroname=thirddata.handlecsv.gColumnNames[inpcsvfile][i]
-- local macroname=cutoffinpcsvfile..thirddata.handlecsv.gColumnNames[inpcsvfile][i]
local macroname=thirddata.handlecsv.gColumnNames[inpcsvfile][i]
-- context("macroname: "..macroname.."\\crlf")
local purexlsname=thirddata.handlecsv.ar2colnum(i)
-- context("purexlsname: "..purexlsname.."\\crlf")
local xlsname='c'..purexlsname
-- context("xlsname: "..xlsname.."\\crlf")
local xlsfilename=thirddata.handlecsv.tmn(cutoffinpcsvfile)..'c'..purexlsname
-- context("xlsfilename: "..xlsfilename.."\\crlf")
local hookxlsname='h'..xlsname
local macroname=thirddata.handlecsv.tmn(macroname)
local puremacroname=thirddata.handlecsv.tmn(puremacroname)
-- context("macroname: "..macroname.."\\crlf")
local hookmacroname='h'..macroname
-- if content == ' ' then tex.print('space') end
-- if content == '' then tex.print('empty') content=[[\empty]] end
context.setgvalue(xlsname, content) -- defining automatic TeX macros \cA, \cB, atd. resp. \cI, \cII, ... containing the contents of the line. Macros with names of the headers are updated automatically
context.setgvalue(xlsfilename, content) -- defining automatic TeX macros \filenamecA, \filenamecB, atd. resp. \cI, \cII, ... containing the contents of the line. Macros with names of the headers are updated automatically
-- was context.setgvalue(macroname,'\\'..xlsname) -- ie for example \let\Name\cA
-- context.setgvalue(macroname,content) -- defining automatic TeX macros \Name, \Date, etc. (names gets from header), containing the contents of the line. Macros with names of the headers are updated automatically
context.setgvalue(puremacroname,content) -- defining automatic TeX macros \Name, \Date, etc. (names gets from header), containing the contents of the line. Macros with names of the headers are updated automatically
-- experimental version in next two lines:
-- this define variants of macros \colA, \colA[8], ... and \colFirstname, \colFirstname[11] etc.
thirddata.handlecsv.createxlscommandof(''..purexlsname,inpcsvfile) -- create macros \colA, \colB, etc. and their variants \colA[row], ...
--if tex.modes['XXX'] then
--context("XXX-"..macroname.."-XXX")
--end
context.setgvalue('col'..macroname,'\\col'..purexlsname) -- and create fullname macros \colFirstname, \colFirstname[5], etc...
-- context.setgvalue(''..macroname,'\\col'..purexlsname) -- and create fullname macros \colFirstname, \colFirstname[5], etc...
-- context.setgvalue(''..macroname,'\\col'..purexlsname) -- and create fullname macros \colFirstname, \colFirstname[5], etc...
--
interfaces.definecommand ("column"..purexlsname, {
arguments = { { "string"} },
macro = function (opt_1)
if opt_1~="" then
context(thirddata.handlecsv.getcellcontentof(inpcsvfile,xlsname,tonumber(opt_1)))
else
context(thirddata.handlecsv.getcellcontentof(inpcsvfile,xlsname,thirddata.handlecsv.gCurrentLinePointer[inpcsvfile]))
end
end
})
--
-- and now create hooks macros:
if thirddata.handlecsv.gUseHooks then
context.setgvalue(hookxlsname,'\\bch\\bch'..xlsname..'\\'..xlsname..'\\ech'..xlsname..'\\ech') -- defining automatic TeX macros \hcA, \hcB, atd. resp. \hcI, \hcII, ... containing 'hooked' contents of the line. Macros with names of the headers are updated automatically)
context.setgvalue(hookmacroname,'\\bch\\bch'..macroname..'\\'..xlsname..'\\ech'..macroname..'\\ech ') -- defining automatic TeX macros \hName, \hDate, etc. (names gets from header), containing 'hooked' contents of the line. Macros with names of the headers are updated automatically)
end
end -- for i=1,
end -- function thirddata.handlecsv.assigncontentsof(inpcsvfile,line) -- put data into columns macros
function thirddata.handlecsv.assigncontents(line) -- put data into columns macros
thirddata.handlecsv.assigncontentsof(thirddata.handlecsv.getcurrentcsvfilename(),line)
end
function thirddata.handlecsv.getcellcontentof(csvfile,column,row)
-- Read data from specific cell of specific the csv table
-- local returnparametr='nil' -- 1.10.2015
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
local returnparametr='' -- 9.1.2016
local column=column
local row=row
if type(column)=='string' then
local testcolumn=thirddata.handlecsv.gColNames[csvfile][column]
if testcolumn==nil then
column=thirddata.handlecsv.xls2ar(column)
else
column=testcolumn
end
else
testcolumn=tonumber(column)
if testcolumn==nil then
column=0
else
column=testcolumn
end
end
if column<=0 then column=1 end
if column>thirddata.handlecsv.gNumCols[csvfile] then column=thirddata.handlecsv.gNumCols[csvfile] end
if type(row)=='string' then
local testrow=tonumber(row)
if testrow==nil then
row=0
else
row=testrow
end
end
if type(column)=='number' and type(row)=='number' then
if row>0 and row <=thirddata.handlecsv.gNumRows[csvfile] and column>=0 and column<=thirddata.handlecsv.gNumCols[csvfile] then
returnparametr=thirddata.handlecsv.gTableRows[csvfile][row][column]
elseif row==0 then
returnparametr=thirddata.handlecsv.gColumnNames[csvfile][column]
end
end
return returnparametr
end
function thirddata.handlecsv.getcellcontent(column,row)
-- Read data from specific cell of current open csv table
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
local returnparametr=thirddata.handlecsv.getcellcontentof(csvfile,column,row)
return returnparametr
end
function thirddata.handlecsv.nextlineof(csvfile)
-- Move line pointer to next line.
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
if thirddata.handlecsv.gCurrentLinePointer[csvfile] > thirddata.handlecsv.gNumRows[csvfile] then
thirddata.handlecsv.gCurrentLinePointer[csvfile]=thirddata.handlecsv.gNumRows[csvfile]
context([[\global\EOFtrue%]])
context([[\global\notEOFfalse%]])
else
thirddata.handlecsv.gCurrentLinePointer[csvfile]=thirddata.handlecsv.gCurrentLinePointer[csvfile]+1
context([[\global\EOFfalse%]])
context([[\global\notEOFtrue%]])
end
end
function thirddata.handlecsv.nextline()
-- Move line pointer to next line.
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.nextlineof(csvfile)
end
function thirddata.handlecsv.previouslineof(csvfile)
-- Move line pointer to previous line.
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
if thirddata.handlecsv.gCurrentLinePointer[csvfile] < 2 then
thirddata.handlecsv.gCurrentLinePointer[csvfile] = 1
else
thirddata.handlecsv.gCurrentLinePointer[csvfile]=thirddata.handlecsv.gCurrentLinePointer[csvfile] - 1
end
context([[\global\EOFfalse%]])
context([[\global\notEOFtrue%]])
end
function thirddata.handlecsv.previousline()
-- Move line pointer to previous line.
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.previouslineof(csvfile)
end
function thirddata.handlecsv.setlinepointerof(csvfile,numberofline)
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
local numberofline = thirddata.handlecsv.processinputvalue(numberofline,thirddata.handlecsv.gCurrentLinePointer[csvfile])
if numberofline < 1 then numberofline = 1 end
if numberofline > thirddata.handlecsv.gNumRows[csvfile] then
numberofline=thirddata.handlecsv.gNumRows[csvfile]
end
thirddata.handlecsv.gCurrentLinePointer[csvfile]=numberofline
thirddata.handlecsv.readlineof(csvfile,numberofline)
end
function thirddata.handlecsv.setlinepointer(numberofline)
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.setlinepointerof(csvfile,numberofline)
end
function thirddata.handlecsv.savelinepointer()
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.gSavedLinePointerNo = thirddata.handlecsv.gCurrentLinePointer[csvfile]
end
function thirddata.handlecsv.setsavedlinepointer()
thirddata.handlecsv.setlinepointer(thirddata.handlecsv.gSavedLinePointerNo)
end
function thirddata.handlecsv.resetlinepointerof(csvfile)
-- Take pointer to first row of table
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
thirddata.handlecsv.setlinepointerof(csvfile,1)
end
function thirddata.handlecsv.resetlinepointer()
-- Take pointer to first row of table
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.setlinepointerof(csvfile,1)
end
function thirddata.handlecsv.linepointerof(csvfile)
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
return thirddata.handlecsv.gCurrentLinePointer[csvfile]
end
function thirddata.handlecsv.linepointer()
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
return thirddata.handlecsv.gCurrentLinePointer[csvfile]
end
function thirddata.handlecsv.getcurrentlinepointer() -- for compatibility
return thirddata.handlecsv.linepointer()
end
function thirddata.handlecsv.getlinepointer() -- for compatibility
return thirddata.handlecsv.linepointer()
end
function thirddata.handlecsv.setnumlineof(csvfile,numline)
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
thirddata.handlecsv.gNumLine[csvfile]=numline
end
function thirddata.handlecsv.setnumline(numline)
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.setnumlineof(csvfile,numline)
end
function thirddata.handlecsv.resetnumlineof(csvfile)
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
thirddata.handlecsv.setnumlineof(csvfile,0)
end
function thirddata.handlecsv.resetnumline()
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.resetnumlineof(csvfile)
end
function thirddata.handlecsv.addtonumlineof(inpcsvfile,numline)
local inpcsvfile=thirddata.handlecsv.handlecsvfile(inpcsvfile)
thirddata.handlecsv.gNumLine[inpcsvfile]=thirddata.handlecsv.gNumLine[inpcsvfile]+numline
end
function thirddata.handlecsv.addtonumline(numline)
local inpcsvfile=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.addtonumlineof(inpcsvfile,numline)
end
function thirddata.handlecsv.numlineof(csvfile)
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
return thirddata.handlecsv.gNumLine[csvfile]
end
function thirddata.handlecsv.numline()
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
return thirddata.handlecsv.gNumLine[csvfile]
end
function thirddata.handlecsv.nextnumlineof(csvfile)
-- Move numline pointer to next number.
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
thirddata.handlecsv.gNumLine[csvfile]=thirddata.handlecsv.gNumLine[csvfile]+1
end
function thirddata.handlecsv.nextnumline()
-- Move numline pointer to next number.
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
thirddata.handlecsv.gNumLine[csvfile]=thirddata.handlecsv.gNumLine[csvfile]+1
end
function thirddata.handlecsv.numrowsof(csvfile)
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
-- context(thirddata.handlecsv.gNumRows[csvfile])
return thirddata.handlecsv.gNumRows[csvfile]
end
function thirddata.handlecsv.numrows()
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
-- context(thirddata.handlecsv.gNumRows[csvfile])
return thirddata.handlecsv.gNumRows[csvfile]
end
function thirddata.handlecsv.numemptyrows()
return thirddata.handlecsv.gNumEmptyRows[thirddata.handlecsv.getcurrentcsvfilename()]
end
function thirddata.handlecsv.numnotemptyrows()
return thirddata.handlecsv.gNumRows[thirddata.handlecsv.getcurrentcsvfilename()]-thirddata.handlecsv.gNumEmptyRows[thirddata.handlecsv.getcurrentcsvfilename()]
end
function thirddata.handlecsv.numcolsof(csvfile)
local csvfile=thirddata.handlecsv.handlecsvfile(csvfile)
context(thirddata.handlecsv.gNumCols[csvfile])
end
function thirddata.handlecsv.numcols()
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
context(thirddata.handlecsv.gNumCols[csvfile])
-- thirddata.handlecsv.numcolsof(csvfile)
end
function thirddata.handlecsv.resethooks()
-- initialize ConTeXt hooks
context([[%
\letvalue{blinehook}=\relax%
\letvalue{elinehook}=\relax%
\letvalue{bfilehook}=\relax%
\letvalue{efilehook}=\relax%
\letvalue{bch}=\relax%
\letvalue{ech}=\relax%
]])
end
function thirddata.handlecsv.string2context(str2ctx)
-- for safety writen
local s=str2ctx
s=string.gsub(s, "%%(.-)\n", "\n") -- remove TeX comments from string. From % character to the end of line
-- s=string.gsub(s, '\n', "")
context(s)
-- texsprint(s) -- for debugging ...
end
function thirddata.handlecsv.doloopfromto(from, to, action)
context[[\opencsvfile]]
context[[\edef\tempnumline{\numline}]] -- 23.6.2017
context[[\resetnumline]] -- uncommented 23.6.2017
if thirddata.handlecsv.gUseHooks then context[[\bfilehook]] end
context[[\removeunwantedspaces]]
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
local gnumrows=thirddata.handlecsv.gNumRows[csvfile]+0
local from=from+0
local to=to+0
local step=1
local docycle=true
if (from>gnumrows and to>gnumrows) then docycle=false end
if docycle then
if from>to then
step=-1
if from>gnumrows then from=gnumrows end
if to<0 then to=0 end
else -- if from<=to
if to>gnumrows then to=gnumrows end
if from<0 then from=1 end
end
for i=from, to, step do
if thirddata.handlecsv.gUseHooks then context[[\blinehook]] end
context([[\readline{]]..i..[[}]]) --
context(action)
if thirddata.handlecsv.gUseHooks then context[[\elinehook]] end
end
end -- docycle
-- context[[\removeunwantedspaces]]
if thirddata.handlecsv.gUseHooks then context[[\efilehook]] end
context[[\setnumline{\tempnumline}]] -- 23.6.2017
end -- function thirddata.handlecsv.doloopfromto
function thirddata.handlecsv.doloopfornext(numberofrows, action)
if thirddata.handlecsv.gUseHooks then context[[\bfilehook]] end
context[[\removeunwantedspaces]]
local csvfile=thirddata.handlecsv.getcurrentcsvfilename()
local gnumrows=thirddata.handlecsv.gNumRows[csvfile]+0
local from=thirddata.handlecsv.gCurrentLinePointer[csvfile]+0
local to=thirddata.handlecsv.gCurrentLinePointer[csvfile]+numberofrows
local step=1
local docycle=true
if from>to then
step=-1
if from>gnumrows then from=gnumrows end
if to<0 then to=0 end
else -- if from<=to
if to>gnumrows then to=gnumrows end
if from<0 then from=1 end
end
for i=from, to-step, step do
if thirddata.handlecsv.gUseHooks then context[[\blinehook]] end
context([[\readline{]]..i..[[}]]) -- context(thirddata.handlecsv.readline(i))
context(action)
if thirddata.handlecsv.gUseHooks then context[[\elinehook]] end
end
thirddata.handlecsv.addtonumline(-1)
context[[\removeunwantedspaces]]
if thirddata.handlecsv.gUseHooks then context[[\efilehook]] end
context[[\nextrow]]
end -- function thirddata.handlecsv.doloopfornext
-- ConTeXt source:
local string2print=[[%
% library newifs for testing during processing CSV table
\newif\ifissetheader%
\newif\ifnotsetheader%
\newif\ifEOF%
\newif\ifnotEOF%
\newif\ifemptyline%
\newif\ifnotemptyline%
\newif\ifemptylinesmarking% setting by macros \markemptylines and \notmarkemptylines
\newif\ifemptylinesnotmarking% setting by \markemptylines and \notmarkemptylines
% Macros defining above in source text:
\let\lineaction\empty% set user define macro into default value
\def\resethooks{\ctxlua{context(thirddata.handlecsv.resethooks())}}
\resethooks % -- DO IT NOW !!!
\def\hookson{\ctxlua{thirddata.handlecsv.hookson()}}
\let\usehooks\hookson % -- synonym only
\def\hooksoff{\ctxlua{thirddata.handlecsv.hooksoff()}}
\def\setheader{\ctxlua{thirddata.handlecsv.setheader()}}
\def\unsetheader{\ctxlua{thirddata.handlecsv.unsetheader()}}
\let\resetheader\unsetheader % -- for compatibility
\def\setsep#1{\ctxlua{thirddata.handlecsv.setsep('#1')}}
\def\unsetsep{\ctxlua{thirddata.handlecsv.unsetsep()}}
\let\resetsep\unsetsep % -- for compatibility
\def\setfiletoscan#1{\ctxlua{thirddata.handlecsv.setfiletoscan('#1');thirddata.handlecsv.opencsvfile()}}
\def\setcurrentcsvfile[#1]{\ctxlua{thirddata.handlecsv.setgetcurrentcsvfile('#1')}}
\def\numrows{\ctxlua{context(thirddata.handlecsv.numrows())}}
\def\numrowsof[#1]{\ctxlua{context(thirddata.handlecsv.numrowsof('#1'))}}
\def\numcols{\ctxlua{context(thirddata.handlecsv.gNumCols[thirddata.handlecsv.gCurrentlyProcessedCSVFile])}}
\def\numcolsof[#1]{\ctxlua{context(thirddata.handlecsv.gNumCols['#1'])}}
\def\currentcsvfile{\ctxlua{context(thirddata.handlecsv.getcurrentcsvfilename())}}
\let\csvfilename\currentcsvfile % for compatibility using
\def\numemptyrows{\ctxlua{context(thirddata.handlecsv.numemptyrows())}}
\def\numnotemptyrows{\ctxlua{context(thirddata.handlecsv.numnotemptyrows())}}
% usefull tool macros :
% Pass the contents of the macro into parameter
\def\thenumexpr#1{\the\numexpr(#1+0)}
% Add content (#2) into content of macro #1
\long\def\addto#1#2{\expandafter\def\expandafter#1\expandafter{#1#2}}
% Expanded version of previous macro
\long\def\eaddto#1#2{\edef#1{#1#2}}
% Get content of specific cell of CSV table. Calling: \csvcell[column number,row number] OR \csvcell['ColumnName',row number]
\def\getcsvcell[#1,#2]{\ctxlua{context(thirddata.handlecsv.getcellcontent(#1,#2))}}%
%%%%%\def\getcsvcell[#1,#2]{\if!#2!\ctxlua{context(thirddata.handlecsv.getcellcontent(#1,thirddata.handlecsv.gCurrentLinePointer[thirddata.handlecsv.getcurrentcsvfilename()]))}\else\ctxlua{context(thirddata.handlecsv.getcellcontent(#1,#2))}\fi}%
% Get content of specific cell of CSV table. Calling: \csvcell[column number,row number] OR \csvcell['ColumnName',row number]
\def\getcsvcellof[#1][#2,#3]{\ctxlua{context(thirddata.handlecsv.getcellcontentof("#1",#2,#3))}}%
% Get content of specific cell of CSV table. Calling: \csvcell[column number,row number or row number getting from macro] OR \csvcell['ColumnName',row number or row number getting from macro]
\def\csvcell[#1,#2]{\getcsvcell[#1,\the\numexpr(#2+0)]}%
%\def\csvcell\getcsvcell
% Get content of specific cell of current line of CSV table. Calling: \currentcell{column number} OR \currentcell{'ColumnName'}
\def\currentcsvcell#1{\getcsvcell[#1,\thenumexpr{\linepointer}]}%
\let\currcell\currentcsvcell
% Get content of specific cell of next line of CSV table. Calling: \nextcell{column number} OR \nextcell{'ColumnName'}
\def\nextcsvcell#1{\ifnum\linepointer<\numrows{\getcsvcell[#1,\thenumexpr{\linepointer+1}]}\fi}%
\let\nextcell\nextcsvcell
% Get content of specific cell of previous line of CSV table. Calling: \previouscell{column number} OR \previouscell{'ColumnName'}
\def\previouscsvcell#1{\ifnum\linepointer>1{\getcsvcell[#1,\thenumexpr{\linepointer-1}]}\fi}%
\let\prevcell\previouscsvcell
% Get column name of n-th column of CSV table. When is set header, then get headername else get XLSname
\def\colnameof[#1][#2]{\ctxlua{context(thirddata.handlecsv.gColumnNames['#1'][#2])}}%
\def\colname[#1]{\ctxlua{context(thirddata.handlecsv.gColumnNames[thirddata.handlecsv.getcurrentcsvfilename()][#1])}}%
% Get index (ie serrial number) of strings columns names (own name or XLS name)
\def\indexcolnameof[#1][#2]{\ctxlua{context(thirddata.handlecsv.gColNames['#1'][#2])}}%
\def\indexcolname[#1]{\ctxlua{context(thirddata.handlecsv.gColNames[thirddata.handlecsv.getcurrentcsvfilename()][#1])}}%
% Get (alternative) XLS column name (of n-th column)
\def\xlscolname[#1]{\ctxlua{context(thirddata.handlecsv.ar2colnum(#1))}}%
% Get (alternative) XLS column name (of n-th column)
\def\cxlscolname[#1]{\ctxlua{context('c'..thirddata.handlecsv.ar2colnum(#1))}}%
% Get column TeX name of n-th column of CSV table. When is set header, then get headername else get XLSname
\def\texcolname[#1]{\ctxlua{context(thirddata.handlecsv.tmn(thirddata.handlecsv.gColumnNames[thirddata.handlecsv.getcurrentcsvfilename()][#1]))}}%
% Get content of n-th column of current row
\def\columncontent[#1]{%
\getcsvcell[#1,\ctxlua{context(thirddata.handlecsv.linepointer())}] %
%\getcsvcell[#1,\linepointer]%
%\getcsvcell[#1,\ctxlua{context(thirddata.handlecsv.linepointer())}]%
%\ctxlua{context(tostring(thirddata.handlecsv.getcellcontent(#1,8)))}
}%
% Substitution of text #2 in cell content by text #3. Substitution is done in the current column of column #1 (number, XLS name or cX name)
\def\replacecontentin#1#2#3{\ctxlua{context(thirddata.handlecsv.substitutecontentofcellofcurrentrow('#1','#2','#3'))}}%
% Get number from XLS column name (ie n-th column)
\def\numberxlscolname[#1]{\ctxlua{context(thirddata.handlecsv.xls2ar(#1))}}%
%%%\def\columncontent[#1]{\ctxlua{context(thirddata.handlecsv.getcellcontent(#1,thirddata.handlecsv.linepointer()))}}
%%%\def\columncontent[#1]{\ctxlua{context(thirddata.handlecsv.getcellcontent(thirddata.handlecsv.gColNames[#1],thirddata.handlecsv.linepointer()))}}
\def\columncontentof[#1][#2]{\ctxlua{context(thirddata.handlecsv.getcellcontentof('#1',thirddata.handlecsv.gColNames['#1'][#2],thirddata.handlecsv.linepointerof('#1')))}}
\def\columncontent[#1]{\ctxlua{context(thirddata.handlecsv.getcellcontent(thirddata.handlecsv.gColNames[thirddata.handlecsv.getcurrentcsvfilename()][#1],thirddata.handlecsv.linepointerof(thirddata.handlecsv.getcurrentcsvfilename())))}}
\def\resetlinepointer{\ctxlua{context(thirddata.handlecsv.resetlinepointer())}}
\def\resetlinepointerof[#1]{\ctxlua{context(thirddata.handlecsv.resetlinepointerof('#1'))}}
\let\resetlineno\resetlinepointer
\let\resetsernumline\resetlinepointer
\def\setnumline#1{\ctxlua{thirddata.handlecsv.setnumline(#1)}}
\def\resetnumline{\ctxlua{context(thirddata.handlecsv.resetnumline())}}
\resetnumline % DO IT NOW
\def\linepointer{\ctxlua{context(thirddata.handlecsv.linepointer())}}
\def\linepointerof[#1]{\ctxlua{context(thirddata.handlecsv.linepointerof('#1'))}}
\let\lineno\linepointer
\let\sernumline\linepointer
\def\numline{\ctxlua{context(thirddata.handlecsv.numline())}}
\def\addtonumline#1{\ctxlua{thirddata.handlecsv.addtonumline(#1)}}
%\def\setlinepointer#1{\ctxlua{thirddata.handlecsv.setlinepointer(#1);thirddata.handlecsv.readline(#1)}}
\def\setlinepointerof[#1]#2{\ctxlua{thirddata.handlecsv.setlinepointerof('#1',#2)}}
\def\setlinepointer#1{\ctxlua{thirddata.handlecsv.setlinepointer(#1)}}
\def\savelinepointer{\ctxlua{thirddata.handlecsv.savelinepointer()}}
\let\savelineno\savelinepointer % synonym
\def\setsavedlinepointer{\ctxlua{thirddata.handlecsv.setsavedlinepointer()}}
\let\setsavedlineno\setsavedlinepointer % synonym
\def\indexofnotemptyline#1{\ctxlua{context(thirddata.handlecsv.indexofnotemptyline(#1))}}
\def\indexofemptyline#1{\ctxlua{context(thirddata.handlecsv.indexofemptyline(#1))}}
\def\notmarkemptylines{\ctxlua{thirddata.handlecsv.notmarkemptylines()}}
\def\markemptylines{\ctxlua{thirddata.handlecsv.markemptylines()}}
\def\resetmarkemptylines{\ctxlua{thirddata.handlecsv.resetmarkemptylines()}}%
\def\removeemptylines{\ctxlua{thirddata.handlecsv.removeemptylines()}}%
\def\nextlineof[#1]{\ctxlua{thirddata.handlecsv.nextlineof('#1')}} % -- macro for skip to next line. \nextlineof no read data from current line unlike \nextrow macro.
\def\nextline{\ctxlua{thirddata.handlecsv.nextline()}} % -- macro for skip to next line. \nextline no read data from current line unlike \nextrow macro.
\def\prevlineof[#1]{\ctxlua{thirddata.handlecsv.previouslineof('#1')}} % -- macro for skip to previous line. \prevlineof no read data from current line unlike \prevrowof macro.
\def\prevline{\ctxlua{thirddata.handlecsv.previousline()}} % -- macro for skip to previous line. \prevline no read data from current line unlike \prevrow macro.
\def\nextnumline{\ctxlua{thirddata.handlecsv.nextnumline()}} % -- macro for add numline counter.
%\def\nextrow{\readline\nextline} % -- For compatibility
\def\nextrow{\nextline\readline} % -- For compatibility (changed 2015-09-22)
\def\nextrowof[#1]{\nextlineof[#1]\readlineof[#1]{\ctxlua{context(thirddata.handlecsv.linepointerof('#1'))}}} % -- For compatibility (changed 2015-09-22)
%\def\nextrowof[#1]{\nextlineof[#1]\readlineof[#1]{\ctxlua{context(thirddata.handlecsv.gCurrentLinePointer['#1'])}}} % -- For compatibility (changed 2015-09-22)
\def\prevrow{\prevline\readline}
\def\prevrowof[#1]{\prevlineof[#1]\readlineof[#1]{\ctxlua{context(thirddata.handlecsv.linepointerof('#1'))}}}
\def\exitlooptest{\ifEOF\exitloop\else\nextrow\fi}
% MAIN CONTEXT MACRO DEFINITIONS
% Open CSV file. Syntax: \opencsvfile or \opencsvfile{filename}.
\def\opencsvfile{%
\dosingleempty\doopencsvfile%
}%
\def\doopencsvfile[#1]{%
\dosinglegroupempty\dodoopencsvfile%
}%
\def\dodoopencsvfile#1{%
\iffirstargument%
\ctxlua{thirddata.handlecsv.opencsvfile("#1")}%
\doifnot{\env{MainLinePointer}}{}{\setlinepointer{\env{MainLinePointer}}}% added by Pablo
\else%
\ctxlua{thirddata.handlecsv.opencsvfile()}%
\fi%
}%
% manual closing of CSV file
\def\closecsvfile#1{\ctxlua{thirddata.handlecsv.closecsvfile("#1")}}
% Read data from n-th line of CSV table. Calling without parameter read current line (pointered by global variable)
\def\readline{\dosingleempty\doreadline}%
\def\doreadline[#1]{\dosinglegroupempty\dodoreadline}%
% They must remain in such a compact form, otherwise it returns unwanted gaps !!!!
\def\dodoreadline#1{\iffirstargument\ctxlua{thirddata.handlecsv.readline(#1)}\else\ctxlua{thirddata.handlecsv.readline(thirddata.handlecsv.gCurrentLinePointer[thirddata.handlecsv.gCurrentlyProcessedCSVFile])}\fi}%
\def\readlineof[#1]#2{\ctxlua{thirddata.handlecsv.readlineof('#1',#2)}}
%\def\readline{\ctxlua{thirddata.handlecsv.readline(thirddata.handlecsv.gCurrentLinePointer[thirddata.handlecsv.gCurrentlyProcessedCSVFile])}}%
\def\readandprocessparameters#1#2#3#4{%
\edef\firstparam{#1}%
\edef\secondparam{#2}%
\edef\thirdparam{#3}%
\def\fourthparam{#4}%
\edef\paroperator{#2}%
% operator '==' is for strings comparing converted to 'eq' operator
\ctxlua{if '#2'=="==" and not(type(tonumber('#1'))=='number' and type(tonumber('#3'))=='number') then context('\\def\\paroperator{eq}') end}%
% operator '~=' is for strings comparing converted to 'neq' operator
\ctxlua{if '#2'=="~=" and not(type(tonumber('#1'))=='number' and type(tonumber('#3'))=='number') then context('\\def\\paroperator{neq}') end}%
}%
% MACROS FOR CYCLES PROCESSING. DO ACTIONS IN CYCLES
% In this function to remove unwanted gaps
% 1. \doloopfromto{from}{to}{action}
% do action "action" from line "from" to line "to" of open CSV file
\def\doloopfromto#1#2#3{\ctxlua{thirddata.handlecsv.doloopfromto([==[\thenumexpr{#1}]==],[==[\thenumexpr{#2}]==],[==[\detokenize{#3}]==])}}%
%\def\doloopfromto#1#2#3{\ctxlua{thirddata.handlecsv.doloopfromto([==[\thenumexpr{#1}]==],[==[\thenumexpr{#2}]==],[==[\expanded{#3}]==])}}%
\def\Doloopfromto#1#2#3{% deprecated - old version - no longer recommended
{\opencsvfile}%
{\resetnumline}%
\bfilehook%
\removeunwantedspaces%
\ifnum#1<#2\dostepwiserecurse{#1}{#2}{1}{\blinehook{\readline{\recurselevel}}#3\elinehook}%
\else\dostepwiserecurse{#1}{#2}{-1}{\blinehook{\readline{\recurselevel}}#3\elinehook}%
\fi%
\removeunwantedspaces%
\efilehook%
}%
% 2. \doloopforall % implicit do \lineaction for all lines of open CSV table
% \doloopforall{\action} % do \action macro for all lines of open CSV table
\def\doloopforall{\dosinglegroupempty\doloopforAll}%
\def\doloopforAll#1{%
\doifsomethingelse{#1}{%1 args.
\doloopfromto{1}{\numrows}{#1}%
}{%
\doloopfromto{1}{\numrows}{\lineaction}%
}%
}%
% 3. \doloopaction % implicit use \lineaction macro
% \doloopaction{\action} % use \action macro for all lines of open CSV file
% \doloopaction{\action}{4} % use \action macro for first 4 lines
% \doloopaction{\action}{2}{5} % use \action macro for lines from 2 to 5
\def\doloopaction{\dotriplegroupempty\doloopAction}
\def\doloopAction#1#2#3{%
\opencsvfile%
% \resetnumline % commented 22.6.2017
\doifsomethingelse{#3}{%3 args.
\doloopfromto{#2}{#3}{#1}% if 3 arguments then do #1 macro from #2 line to #3 line
}{%
\doifsomethingelse{#2}{%2 args.
\doloopfromto{1}{#2}{#1}% if 2 arguments then do #1 macro for first #2 lines
}%
{\doifsomethingelse{#1}{% 1 arg.
\doloopfromto{1}{\numrows}{#1}%
}{% if without arguments then do \lineaction macro for all lines
\doloopfromto{1}{\numrows}{\lineaction}%
}%
}%
}%
}%
% 4. \doloopif{value1}{[compare_operator]}{value2}{macro_for_doing} % [compareoperators] <, >, ==(eq), ~=(neq), >=, <=, in, ~in, until, while
% actions for rows of open CSV file which are responded of condition
\def\doloopif#1#2#3#4{%
\edef\tempnumline{\numline}% 23.6.2017
\readandprocessparameters{#1}{#2}{#3}{#4}%
% \resetnumline % 22.6.2017
\bfilehook%
% and now process actual operator
\processaction[\paroperator][%
<=>{% {number1}{<}{number2} ... Less
\doloopfromto{1}{\numrows}{\ctxlua{if #1<#3 then context('\\blinehook\\fourthparam\\elinehook') else thirddata.handlecsv.addtonumline(-1) end}}%
},% end < ... Less
>=>{% {number1}{>}{number2} ... Greater
\doloopfromto{1}{\numrows}{\ctxlua{if #1>#3 then context('\\blinehook\\fourthparam\\elinehook') else thirddata.handlecsv.addtonumline(-1) end}}%
},% end > ... Greater
===>{% {number1}{==}{number2} ... Equal
\doloopfromto{1}{\numrows}{\ctxlua{if #1==#3 then context('\\blinehook\\fourthparam\\elinehook') else thirddata.handlecsv.addtonumline(-1) end}}%
},% end == ... Equal
~==>{% {number1}{~=}{number2} ... Not Equal
\doloopfromto{1}{\numrows}{\ctxlua{if #1~=#3 then context('\\blinehook\\fourthparam\\elinehook') else thirddata.handlecsv.addtonumline(-1) end}}%
},% end ~= ... Not Equal
>==>{% {number1}{>=}{number2} ... GreaterOrEqual
\doloopfromto{1}{\numrows}{\ctxlua{if #1>=#3 then context('\\blinehook\\fourthparam\\elinehook') else thirddata.handlecsv.addtonumline(-1) end}}%
},% end >= ... GreaterOrEqual
<==>{% {number1}{<=}{number2} ... LessOrEqual
\doloopfromto{1}{\numrows}{\ctxlua{if #1<=#3 then context('\\blinehook\\fourthparam\\elinehook') else thirddata.handlecsv.addtonumline(-1) end}}%
},% end <= ... LessOrEqual
eq=>{% command {string1}{==}{string2} is converted to command command {string1}{eq}{string2} ... string1 is equal string2
\doloopfromto{1}{\numrows}{\doifelse{#1}{#3}{\blinehook\fourthparam\elinehook}{\addtonumline{-1}}}% 23.06.2017
%%%%%\doloopfromto{1}{\numrows}{\ctxlua{if '#1'=='#3' then context('\\blinehook\\fourthparam\\elinehook') else thirddata.handlecsv.addtonumline(-1) end}}%
},% end eq
neq=>{% command {string1}{~=}{string2} is converted to command command {string1}{neq}{string2} ... string1 is not equal string2
\doloopfromto{1}{\numrows}{\doifelse{#1}{#3}{\ctxlua{thirddata.handlecsv.addtonumline(-1)}}{\blinehook\fourthparam\elinehook}}% 23.06.2017
%%%%%\doloopfromto{1}{\numrows}{\ctxlua{if '#1'~='#3' then context('\\blinehook\\fourthparam\\elinehook') else thirddata.handlecsv.addtonumline(-1) end}}%
},% end neq
in=>{% {substring}{in}{string} ... substring is contained inside string
\doloopfromto{1}{\numrows}{\doifinstringelse{#1}{#3}{\blinehook\fourthparam\elinehook}{\addtonumline{-1}}}% \doifincsnameelse
},% end in
~in=>{% {substring}{~in}{string} ... substring is not contained inside string
\doloopfromto{1}{\numrows}{\doifinstringelse{#1}{#3}{\addtonumline{-1}}{\blinehook\fourthparam\elinehook}}% \doifincsnameelse
},% end notin
repeatuntil=>{% {substring}{until}{string} ... % Repeats the action until the condition is met. If it is not never met, will list all record
\doloop{\ctxlua{if '#1'=='#3' then context('\\exitloop') else context('\\ifEOF\\exitloop\\else\\blinehook\\fourthparam\\elinehook\\nextrow\\fi') end}}%
},% end until % the comma , is very important here!!!
whiledo=>{% {substring}{untilneq}{string} ... % Repeat action when the condition is met. When the condition is not met for the first line, the action will NOT BE performed!
\doloop{\ctxlua{if '#1'~='#3' then context('\\exitloop') else context('\\blinehook\\fourthparam\\elinehook\\ifEOF\\exitloop\\else\\nextrow\\fi') end}}%
},% end untilneq % the comma , is very important here!!!
]% end of \processaction%
\efilehook%
\setnumline{\tempnumline}%
} % end of \doloopif
% specific variations of previous macro \doloopif
\letvalue{doloopifnum}=\doloopif %\doloopifnum{value1}{[compare_operator]}{value2}{macro_for_doing}% [compareoperators] ==, ~=, >, <, >=, <= % FOR COMPATIBILITY ONLY
\def\doloopuntil#1#2#3{\doloopif{#1}{repeatuntil}{#2}{#3}}% \doloopuntil{\Trida}{3.A}{\tableaction}% REPEAT-UNTIL loop: Repeats the action until the condition is met.
\letvalue{repeatuntil}=\doloopuntil%
\def\doloopwhile#1#2#3{\doloopif{#1}{whiledo}{#2}{#3}}% \doloopwhile{\Trida}{3.A}{\tableaction}% Repeat action when the condition is met.
\letvalue{whiledo}=\doloopwhile%
% 5. \filelineaction % implicit do \lineaction for all lines of current open CSV table
% \filelineaction{filename.csv} % do \lineaction macro for all lines of specific CSV table (filename.csv)
\def\filelineaction{\dotriplegroupempty\dofilelineaction}%
\def\dofilelineaction#1#2#3{%
\doifelsenothing{#1}%
{\opencsvfile\doloopaction%0 parameter - open actual CSV file and do action
}%
{\doifelsenothing{#2}%
{\opencsvfile{#1}\doloopaction%1 parameter - parameter = filename
}%
{\doifelsenothing{#3}%
{\opencsvfile{#1}\doloopaction{\lineaction}{#2}%2 parameters, 1st parameter = filename, 2nd parameter = num of lines
}%
{\opencsvfile{#1}\doloopaction{\lineaction}{#2}{#3}%3 parameters, 1st parameter = filename, 2nd parameter = from line, 3rd parameter = to line
}}}%
}%
% 6. \doloopfornext{}{}
% do action for next of rows from current line of open CSV file
\def\doloopfornext#1#2{\ctxlua{thirddata.handlecsv.doloopfornext([==[\thenumexpr{#1}]==],[==[\detokenize{#2}]==])}}%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Complete listing macros and commands that can be used (to keep track of all defined macros):
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% \ifissetheader, \ifnotsetheader
% \ifEOF, \ifnotEOF
% \ifemptyline, \ifnotemptyline
% \ifemptylinesmarking, \ifemptylinesnotmarking (they can be set by macros \markemptylines, \notmarkemptylines and \resetmarkemptylines)
% \hookson, \hooksoff
% \resethooks
% user defined hooks macros: \bfilehook, \efilehook, \blinehook, \elinehook,
% \setheader, \unsetheader, (\resetheader - compatibility synonym)
% \setsep{}, \unsetsep, (\resetsep - compatibility synonym)
% \setfiletoscan{}
% \numrows, \numemptyrows, \numnotemptyrows
% \numcols
% \csvfilename
% \thenumexp{}
% \addto\anymacro{}, \eaddto\anymacro{}
% \getcsvcell[,], \csvcell[,]
% \currentcell{], \cxlscolname[], \texcolname[]
% \indexcolname[<'columnname' or 'xlsname'>]
% \columncontent[ or <'columnname'> or <'xlsname'>]
% \numberxlscolname[<'xlsname'>]
% \linepointer, (\lineno, \sernumline are synonyms), \resetlinepointer, \resetlinepointerof[], (\resetlineno, \resetsernumline are synonyms), \setlinepointer{}
% \savelineno=\savelinepointer, \setsavedlineno=\setsavedlinepointer
% \numline, \setnumline{}, \resetnumline
% \addtonumline{}
% \indexofnotemptyline{}, \indexofemptyline{}
% \markemptylines, \notmarkemptylines, \resetmarkemptylines, \removeemptylines
% \nextlineof[csvfile], \prevlineof[csvfile], \nextline, \prevline
% \nextnumline
% \nextrowof[csvfile], \prevrowof[csvfile], \nextrow, \prevrow
% \exitlooptest
% \opencsvfile, \opencsvfile{}, \closecsvfile{}
% \readline, \readline{}
% \readandprocessparameters#1#2#3#4 -- for internal use only
% \replacecontentin{}{}{}
%
% Module predefined cycles for processing of lines CSV table:
% \doloopfromto{}{}
% \doloopforall, \doloopforall{<\actionmacro>}
% \doloopaction, \doloopaction{<\actionmacro>}, \doloopaction{<\actionmacro>}{}, \doloopaction{<\actionmacro>}{}{}
% \doloopif{}{}{value2}{<\actionmacro>}, (\doloopifnum{}{}{value2}{<\actionmacro>} is synonym)
% \doloopuntil{}{}{<\actionmacro>} = \repeatuntil{}{}{<\actionmacro>}
% \doloopwhile{}{}{<\actionmacro>} = \doloopwhiledo{}{}{<\actionmacro>}
% \filelineaction, \filelineaction{}
% \doloopfornext{<+/-numberofrows>}{<\actionmacro>} % use \setlinepointer, \resetlinepointer (and then set it up \setnumline) to set line pointer. Opening of CSV file automatically reset line pointer.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
]]
-- write definitions into ConTeXt:
thirddata.handlecsv.string2context(string2print)