initial upload

txtinfo/CMakeLists.txt

@@ -0,0 +1,24 @@
+set(TOOL_NAME txtinfo)
+set(BIN_DIR bin)
+set(INSTALL_DIR sbin)
+
+find_package(GCTL REQUIRED)
+include_directories(${GCTL_INC_DIR})
+
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -O3")
+if(WIN32)
+	set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -O3")
+else()
+	set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -O3")
+endif()
+
+set(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/${BIN_DIR})
+
+aux_source_directory(. TOOL_SRC)
+add_executable(${TOOL_NAME} ${TOOL_SRC})
+set_target_properties(${TOOL_NAME} PROPERTIES INSTALL_RPATH /usr/local/lib)
+set_target_properties(${TOOL_NAME} PROPERTIES CXX_STANDARD 17 CXX_STANDARD_REQUIRED ON)
+
+target_link_libraries(${TOOL_NAME} PUBLIC ${GCTL_LIB})
+
+install(TARGETS ${TOOL_NAME} RUNTIME DESTINATION ${INSTALL_DIR})

txtinfo/txtinfo.cpp

@@ -0,0 +1,73 @@
+/********************************************************
+ *  ██████╗  ██████╗████████╗██╗
+ * ██╔════╝ ██╔════╝╚══██╔══╝██║
+ * ██║  ███╗██║        ██║   ██║
+ * ██║   ██║██║        ██║   ██║
+ * ╚██████╔╝╚██████╗   ██║   ███████╗
+ *  ╚═════╝  ╚═════╝   ╚═╝   ╚══════╝
+ * Geophysical Computational Tools & Library (GCTL)
+ *
+ * Copyright (c) 2022  Yi Zhang (yizhang-geo@zju.edu.cn)
+ *
+ * GCTL is distributed under a dual licensing scheme. You can redistribute 
+ * it and/or modify it under the terms of the GNU Lesser General Public 
+ * License as published by the Free Software Foundation, either version 2 
+ * of the License, or (at your option) any later version. You should have 
+ * received a copy of the GNU Lesser General Public License along with this 
+ * program. If not, see <http://www.gnu.org/licenses/>.
+ * 
+ * If the terms and conditions of the LGPL v.2. would prevent you from using 
+ * the GCTL, please consider the option to obtain a commercial license for a 
+ * fee. These licenses are offered by the GCTL's original author. As a rule, 
+ * licenses are provided "as-is", unlimited in time for a one time fee. Please 
+ * send corresponding requests to: yizhang-geo@zju.edu.cn. Please do not forget 
+ * to include some description of your company and the realm of its activities. 
+ * Also add information on how to contact you by electronic and paper mail.
+ ******************************************************/
+
+#include "gctl/io.h"
+#include "gctl/utility.h"
+
+int main(int argc, char *argv[]) try
+{
+	gctl::flags_parser fp;
+	fp.set_proname("txtinfo");
+	fp.set_proinfo("Display lines from a text file that starts with a given symbol. \
+This program is a toolkit of the GCTL package. The GCTL comes with ABSOLUTE NO WARRANTY. \
+Please see instructions or contact the author for more information.");
+	fp.add_opt('i', "input", required_argument, NULL, "Input file name.", "<filename>", true);
+	fp.add_opt('s', "symbol", required_argument, NULL, "Annotation symbol. The default is '#'.", "<symbol>", false);
+	fp.add_opt('h', "help", no_argument, NULL, "Show help information.", 0, false);
+	fp.configure(argc, argv);
+
+	if(argc == 1 || fp.set_opt('h'))
+	{
+		fp.show_help_page();
+		return 0;
+	}
+
+	std::string in_name, annote_symbol;
+	fp.get_argv({'i', 's'}, {&in_name, &annote_symbol});
+	if (annote_symbol == "NULL") annote_symbol = "#";
+
+	// 查看是否通过强制参数检查
+	if (!fp.pass_mandatory()) return 0;
+
+	std::ifstream infile;
+	gctl::open_infile(infile, in_name, "");
+
+	std::string tmp_line;
+	while(getline(infile, tmp_line))
+	{
+		if (tmp_line[0] == annote_symbol[0])
+		{
+			std::cout << tmp_line << std::endl;
+		}
+	}
+	infile.close();
+	return 0;
+}
+catch(std::exception &e)
+{
+	GCTL_ShowWhatError(e.what(), GCTL_ERROR_ERROR, 0, 0, 0);
+}