Merge branch 'master' of ssh://gelforn.xestia.co.uk:/scmrepos/xestiaab

[xestiaab/.git] / source / common / textprocessing.cpp

diff --git a/source/common/textprocessing.cpp b/source/common/textprocessing.cpp
index aeec7a8..e2f0428 100644 (file)
--- a/source/common/textprocessing.cpp
+++ b/source/common/textprocessing.cpp
@@ -26,6 +26,8 @@
 void EscapeString(wxString *ReceivedString, bool StripQuotes)
 {
 
+       // Escape a string that contains escapable characters.
+
        ReceivedString->Replace(wxT("\\"), wxT("\\\\"), TRUE);
        ReceivedString->Replace(wxT(","), wxT("\\,"), TRUE);
        ReceivedString->Replace(wxT(";"), wxT("\\;"), TRUE);
@@ -43,6 +45,8 @@ void EscapeString(wxString *ReceivedString, bool StripQuotes)
 void GetEscapeString(wxTextCtrl *TextCtrl, wxString *ProcessString, bool StripQuotes)
 {
 
+       // Get an escaped string from a wxTextCtrl.
+
        *ProcessString = TextCtrl->GetValue();
        EscapeString(ProcessString, StripQuotes);
 
@@ -51,6 +55,8 @@ void GetEscapeString(wxTextCtrl *TextCtrl, wxString *ProcessString, bool StripQu
 void GetEscapeString(wxComboBox *ComboCtrl, wxString *ProcessString, bool StripQuotes)
 {
 
+       // Get an escaped string from a wxComboBox.
+
        *ProcessString = ComboCtrl->GetValue();
        EscapeString(ProcessString, StripQuotes);
 
@@ -59,6 +65,8 @@ void GetEscapeString(wxComboBox *ComboCtrl, wxString *ProcessString, bool StripQ
 void GetEscapeString(wxChoice *ChoiceCtrl, wxString *ProcessString, bool StripQuotes)
 {
 
+       // Get an escaped string from a wxChoice.
+
        *ProcessString = ChoiceCtrl->GetString(ChoiceCtrl->GetSelection());
        EscapeString(ProcessString, StripQuotes);
 
@@ -67,6 +75,8 @@ void GetEscapeString(wxChoice *ChoiceCtrl, wxString *ProcessString, bool StripQu
 void CaptureString(wxString *ProcessString, bool StripQuotes)
 {
 
+       // Capture a string for processing.
+
        ProcessString->Replace(wxT("\\n"), wxT("\n"), TRUE);
        ProcessString->Replace(wxT("\\;"), wxT(";"), TRUE);
        ProcessString->Replace(wxT("\\,"), wxT(","), TRUE);
@@ -83,6 +93,8 @@ void CaptureString(wxString *ProcessString, bool StripQuotes)
 void ResetUnusedString(wxString *ProcessString)
 {
 
+       // Reset an unused string.
+
        ProcessString->Replace(wxT("\\\\"), wxT("\\"), TRUE);
        ProcessString->Replace(wxT("\n"), wxT(""), TRUE);
        ProcessString->Replace(wxT("\\;"), wxT(";"), TRUE);
@@ -93,6 +105,9 @@ void ResetUnusedString(wxString *ProcessString)
 void ConvertToHTML(wxString *ProcessString)
 {
 
+       // Convert string into text that can be used with a 
+       // wxHTMLWindow.
+
        ProcessString->Replace(wxT("&"), wxT("&"), TRUE);
        ProcessString->Replace(wxT("<"), wxT("&lt;"), TRUE);
        ProcessString->Replace(wxT(">"), wxT("&gt;"), TRUE);
@@ -101,23 +116,41 @@ void ConvertToHTML(wxString *ProcessString)
 }
 
 void DeleteMapDataProcess(int IndexNum, std::map<int, std::string>* MapData){
+
+       // Delete map data (for map<int,string>).
+
        MapData->erase(IndexNum);
+       
 }
 
 void DeleteMapDataProcess(int IndexNum, std::map<int, wxString>* MapData){
+
+       // Delete map data (for map<int,wxString>).
+
        MapData->erase(IndexNum);
+       
 }
 
 void DeleteMapDataProcess(int IndexNum, std::map<int, int>* MapData){
+
+       // Delete map data (for map<int,int>).
+
        MapData->erase(IndexNum);
+       
 }
 
 void DeleteMapDataProcess(int IndexNum, std::map<int, bool>* MapData){
+
+       // Delete map data (for map<int,bool>).
+
        MapData->erase(IndexNum);
+       
 }
 
 bool MapDataExists(int *ItemIndex, std::map<int,wxString> *MapPtr){
 
+       // Check if map data exists (for map<int,wxString>).
+       
        if (MapPtr->find(*ItemIndex) == MapPtr->end()){
        
                return FALSE;
@@ -132,6 +165,8 @@ bool MapDataExists(int *ItemIndex, std::map<int,wxString> *MapPtr){
 
 bool MapDataExists(int *ItemIndex, std::map<int,int> *MapPtr){
 
+       // Check if map data exists (for map<int,int>).
+
        if (MapPtr->find(*ItemIndex) == MapPtr->end()){
        
                return FALSE;
@@ -142,20 +177,4 @@ bool MapDataExists(int *ItemIndex, std::map<int,int> *MapPtr){
        
        }
 
-}
-
-/*
-template <typename ArgMap, typename... Args>
-void DeleteMapData(ArgMap* ArgMapPtr, Args*... ArgsList){
-
-       //DeleteMapDataProcess(ArgMapPtr);
-
-       DeleteMapData(ArgsList...);
-
-}
-*/
-/*
-void test(int* x) {
-
-}
-*/
\ No newline at end of file
+}
\ No newline at end of file