\n \n\t\t| Parameter | \n\t\tMeaning | \n\t
\t\n\t \n\t | Text | \n\t The Filename (may include (absolute) path) to read from and save to (for all functions that write an output file).
\n Note: by default a filename_copy will be created, use the ! prefix if you want to OverWrite the TextFile (e.g. the source file)
\n\t As of v3 \"Text\" can also be a variable or indeed text directly passed on to the function.
\n See Textfile and the ! Prefix.\n\t | \n\t
\n \n | ! Prefix | \n If Text starts with ! (eg: \"!c:\\sample.txt\") it will overwrite the text file, otherwise it will save the new file to a copy of the text file eg: Filename_copy.txt (All functions, apart from reading functions because there is no output file)
\n Tip: you can use concatenation to add the !, e.g. \"!\" . \"Filename.txt\", see the examples in the AHK thread.
\n Note: If Text is a variable, it can start with a ! as TF will detect automatically that it is not a file and will therefore not create a file but return the altered variable instead.
\n See Textfile and the ! Prefix.\n\t | \n\t
\n \n | Lines | \n Number of lines to read | \n
\n \n | StartLine | \n Start of Range (Almost all).
\n\t See (StartLine, Endline) Syntax.\n\t | \n\t
\n \n | EndLine | \n End of Range (Almost all).
\n \t See (StartLine, Endline) Syntax.\n\t | \n\t
\n \n | SearchText | \n Text to Find (Find / Replace functions) | \n
\n \n | ReplaceText | \n Text to Replace (Find / Replace functions) | \n
\n
\n\n**Notes**\n\n1. Many functions also have specific parameters, see the description of each function below.\n2. **Backup files:** If a subdirectory \"backup\" is present in the directory of TextFile \na backup is made before overwriting the original file (both for file.txt and file_copy.txt)\nwith the BAK extension\n3. You can find examples of most functions in the \"example script\" here [http://www.autohotkey.com/forum/viewtopic.php?p=280363#280363](http://www.autohotkey.com/forum/viewtopic.php?p=280363#280363)\n\n### (StartLine, Endline) Syntax\n\nYou can pass on multiple lines (sections) by using the StartLine parameter.\n\nExamples:\n\n- (5) ; start from line 5 to the end (StartLine)\n- (5, 15) ; Section: lines 5 to 15 (StartLine, EndLine)\n- (\"5,13,45,67\", 135) ; Specific lines: 5,13,45,67, ignore 135 (\"StartLine\", Endline - **EndLine value is ignored**)\n- (\"5-13,45-51\", 135) ; Multiple sections of lines: 5 to 13, 45 to 51 ignore 135 (\"StartLine\", Endline - **EndLine value is ignored**)\n\nIncremental (EndLine will **not** be ignored) in the following cases:\n\n- (\"2+3\", 150) ; start with line 2, increment 3 up-to line 150 so 2,5,8,11,14 etc\n- (\"5+15\") ; start with line 5, increment 15 until end of file so 5,20,35 etc\n\nNegative Startline\n\n- A Negative startline value makes a TF function operate on the last X lines.\n- TF_ColGet and TF_ColPut accept negative StartColumn parameter. This can be used to \"Get\" or \"Put\" text in the x-th \"column\" from the right\n\n### Textfile and the ! Prefix\n\nValid examples for using a Textfile:\n\n```autohotkey\nTF_(\"file.txt\", .... ; Process file.txt and write output to file_copy.txt\n\nF=file.txt ; ; Note how F is a variable, but AHK/TF will see it is meant to represent file.txt and write output to file_copy.txt\nTF_(F, .... ; Process file.txt and write output to file_copy.txt\nTF_(\"!file.txt\", .... ; Process file.txt and overwrite file.txt\n\nF=file.txt\nTF_(\"!\" . F, .... ; Process file.txt and overwrite file.txt\n\nF=!file.txt\nTF_(F, .... ; Process file.txt and overwrite file.txt\n\nIn a Loop, FilePattern:\nTF_(A_LoopFileName, .... ; Process file and write output to file_copy\nTF_(\"!\" . A_LoopFileName, .... ; Process file and overwrite file\n\nLoop, *.txt\n {\n TF_(A_LoopFileName, .... ; Process file and write output to file_copy\n }\n```\n\nIf you want to use multiple TF functions on a single file it is advised to use the ! Prefix\n\n```autohotkey\nF=!file.txt \nTF_RemoveBlankLines(F) ; remove all empty lines from file.txt and overwrite original file.txt\nTF_LineNumber(F) ; add linenumbers to all lines and overwrite original file.txt\nTF_Replace(F, \"this\", \"that\") ; Replace the word \"this\" with \"that\" and overwrite original file.txt\n; So the original file.txt has undergone three changes\n```\n\n**Files & Variables (v3+)**\n\nYou can use TF functions directly on files as well as variables. \nBelow you will find some easy examples.\n\n**Introduced in v3: TF()**\n\nIn order to save you the trouble of using a fileread to read a file into\na variable and proceed to use various TF functions there is the TF()\nFunction.\n\n\n```autohotkey\nTF(\"pathtofile\", CreateGlobalVar=\"T\")\n```\n\nBy default it reads the contents of the file in a global variable named **t** and \nreturns it for further processing. By default it creates variable **t** if a variable\nname is **omitted** so if you do not like to use **t** you can use anything you like.\nIt is NOT mandatory to use TF(), you are welcome to use a fileread as well, TF() is \nmerely added for convenience as we will see in the examples below. TF() doesn't suddenly\nmake the TF library \"not standard compliant\" as some seem to think as it only creates a \nglobal variable if you use the TF() function.\n\n**Repeat:** You only have to use TF() if you want to read a file into a variable \nand use it on multiple TF_\\* Functions but it is NOT required.\n\nSee also [TF Lib Errors](#tf-lib-errors) below.\n\n**TF() Examples:**\n\n\n```autohotkey\nTF(\"file.txt\") ; will create global var t\nTF(\"file.txt\", \"MyVar\") ; will create global var MyVar\n```\n \n**Examples on how to use files & variables with TF:**\n\n\n```autohotkey\n#Include tf.ahk\nTestFile= ; create variable\n(join`r`n\n1 Hi this\n2 a test variable\n3 to demonstrate\n4 how to \n5 use this\n6 new version\n7 of TF.AHK\n)\nFileDelete, TestFile.txt\nFileAppend, %TestFile%, TestFile.txt ; create file\nF=TestFile.txt ; just a shorthand code for TextFile.txt, so when\n; we are using 'F' below we are still passing on a TextFile, not a variable!\n\n; pass on file, read lines 5 to end of file:\nMsgBox % \"From File 1:`n\" TF_ReadLines(\"TestFile.txt\",5)\nMsgBox % \"From File 2:`n\" TF_ReadLines(F,5) ; same\n\n; pass on variable, read lines 1 to 5\nMsgBox % \"From Variable 1:`n\" TF_ReadLines(TestFile,\"1-5\") \nMsgBox % \"From Variable 2:`n\" TF_ReadLines(\"Hi`nthis`nis`na`ntest`nvariable`nfor`ntesting\",1,3) ; pass on string\n\n; Examples using TF(): (it will save you a FileRead if you want to work with Variables)\n\nTF(\"TestFile.txt\") ; read file, create global var t\nt:=TF_ReadLines(t,5) ; pass on global var t created by TF(), read lines 5 to end of file, assign result to t \nMsgBox % \"TF(), example 1:`n\" t\n\nTF(\"TestFile.txt\", \"MyVar\") ; read file, create global var MyVar\nMyVar:=TF_ReadLines(MyVar,5) ; pass on global var MyVar created by TF(), read lines 5 to end of file, assign result to MyVar\nMsgBox % \"TF(), example 2:`n\" MyVar\n\n; Note how we can use TF() here\nt:=TF_ReadLines(TF(\"TestFile.txt\"),5) ; pass on global var t created by TF(), read lines 5 to end of file, assign result to t \nMsgBox % \"TF(), example 3:`n\" t\n\nMyVar:=TF_ReadLines(TF(\"TestFile.txt\",\"MyVar\"),5) ; pass on global var t created by TF(), read lines 5 to end of file, assign result to t \nMsgBox % \"TF(), example 4:`n\" MyVar\n\nt:=TF_ReadLines(TF(F),5) ; pass on global var t created by TF(), read lines 5 to end of file, assign result to t\nt:=TF_ReverseLines(t,5) ; pass on global var t created by TF(), reverse lines, assign result to t\nMsgBox % \"TF(), example 5:`n\" t\n\n; Work directly with the clipboard or another other variable\nClipboard=Line 1`nLine 2`nLine 3`nLine 4`nLine 5`nLine 6`nLine 7`nLine 8\nClipboard:=TF_RemoveLines(Clipboard, 3, 6) ; remove lines 3 to 6\nMsgBox % \"Clipboard, example 6:`n\" Clipboard\n```\n \n**Note** TF_Merge, TF_Prepend, TF_Append currently do not support variables and only work with FILES.\n\n**Common mistake(s):**\n\n\n```autohotkey\nMyVar:=TF_ReadLines(\"TestFile.txt\",5) ; this is wrong. It is AN INCORRECT EXAMPLE!\n```\n\nThe example above is incorrect: You pass on a file so the output is\ntestfile_copy.txt. In this case nothing meaningful is assigned to the\nvariable MyVar. Correct would be:\n\n\n```autohotkey\nMyVar:=TF_ReadLines(MyVar,5) ; this is OK\nMyVar:=TF_ReadLines(TF(\"TestFile.txt\",\"MyVar\"),5) ; this is OK\n```\n\n--------------------------------------------------------------------------\n\n# Functions and Examples\n\n**Note:** Some of these functions are very similar, but they are included in the library for ease of use ...\n\nYou can find examples of most functions in the \"example script\" here [http://www.autohotkey.com/forum/viewtopic.php?p=280363#280363](http://www.autohotkey.com/forum/viewtopic.php?p=280363#280363)\n\n