CTokenEx - A String Tokenizer Class

Environment: VC++ 6.0 SP3 (using Warning Level 4 in RELEASE Mode), Environments Tested: WinNT 4.0 SP4, Win95

Basically, I saw other string tokenizers here (CodeGuru) and they lacked the functionality I was looking for.  Therefore, I created one for myself using the KISS method.  This is a VERY SIMPLE sample!!!!

Here is a summary of the functionality in the CTokenEx class:
  • Can use "SplitPath" to break-up the path into sections (Drive/Sharename, Directory, Filename, Extention).  Also, recognizes UNC Names (which _tsplitpath doesn't).
  • Can use "Join" to create a CString from a CStringArray with delimiters of your choice.
  • Can use "Split" to break-up a CString into a CStringArray (according to the delimiter).
  • Can use "GetString" to get the first sub-string in a CString (according to the delimiter).
NOTE:
The "Split" and "GetString" functions recognize multiple delimiters as an empty string so that it will NOT add blanks to an Array.  See example code below: :

Say you have a CString that contains: "abc,def,,,ghi,,jkl,,"


  //********************************************************
  // Split Function
  //********************************************************
  //
  // Split will fill an array with:
  //
  // String  Position
  // ======  ========
  // abc     0
  // def     1
  // ghi     2
  // jkl     3
  //
  //********************************************************
  void CTokenDlgDlg::OnSplit() 
  {
     CTokenEx tok;

     // CString for the Split Function
     CString csSplit = "abc,def,,,ghi,,jkl,,";

     // CStringArray to fill
     CStringArray SplitIt;
   
     // Call Split
     tok.Split(csSplit, ",", SplitIt);
  }

  /********************************************************
  // GetString Function
  //********************************************************
  //
  // GetString will return a string:
  //
  // abc
  //     ...and more calls to GetString will return a strings:
  // def
  // ghi
  // jkl
  //
  //********************************************************
  void CTokenDlgDlg::OnGetstring() 
  {
     CTokenEx tok;
     char Buf[254];

     CString csRef = "abc,def,,,ghi,,jkl,,";
     do {
        CString csRet = tok.GetString(csRef, ",");
        // Do something with the returned value.
     } while (!csRef.IsEmpty());
  }

I hope that others find this class useful.

Downloads

Download demo project - 37 Kb
Download source - 99 Kb


Comments

  • Succinct, working, well designed code. Great Job!

    Posted by Legacy on 12/16/2003 12:00am

    Originally posted by: Daniel Kemper

    I didn't want to re-invent the wheel with a new split method, and you have provided just what I need. Thank you.

    -DK

    Reply
  • nice, except

    Posted by Legacy on 07/26/2002 12:00am

    Originally posted by: dave Michmerhuizen

    An option to recognize empty strings would actually be nice - this is often needed and in fact is what i'm looking for right now.

    Reply
  • www.google.com

    Posted by Legacy on 05/27/2002 12:00am

    Originally posted by: Me

    Me

    Reply
  • www.google.com

    Posted by Legacy on 05/27/2002 12:00am

    Originally posted by: Me

    Me

    Reply
  • Very good!

    Posted by Legacy on 02/03/2001 12:00am

    Originally posted by: Christoph

    Hi!

    I like it! Thanks a lot! it is very easy to use it with CSV strings.

    Reply
  • http://objectarx.sarang.net

    Posted by Legacy on 02/23/2000 12:00am

    Originally posted by: Sok Woo, Lim

    Thank you ~~~

    Reply
Leave a Comment
  • Your email address will not be published. All fields are required.

Top White Papers and Webcasts

  • Live Event Date: July 28, 2016 @ 1:00 p.m. ET / 10:00 a.m. PT Jepsen tests are third-party tests for distributed databases that validate vendors' guarantees about how they perform under various failure scenarios, especially network partitions. These have proven their value as tools in any distributed system tester's arsenal. When the creator of Jepsen, Kyle Kingsbury, started his Jepsen-for-Hire business last fall, VoltDB immediately got in line, and over the past two months, our solution was given the most …

  • Microsoft® Office 365 is a top choice for enterprises that want a cloud-based suite of productivity/ collaboration applications. With Office 365, you get access to Microsoft™ Office solutions practically anytime, anywhere, on virtually any device. It's a great option for current Microsoft users who can now build on their experience with Microsoft™ solutions while enjoying the flexibility of a cloud-based delivery. But even organizations with no previous investment in Microsoft will find that …

Most Popular Programming Stories

More for Developers

RSS Feeds

Thanks for your registration, follow us on our social networks to keep up-to-date