https://wiki.kram.nz/index.php?action=history&feed=atom&title=SE250%3Alab-9%3Arwan064%3Astring.h SE250:lab-9:rwan064:string.h - Revision history 2026-09-16T20:49:16Z Revision history for this page on the wiki MediaWiki 1.46.0 https://wiki.kram.nz/index.php?title=SE250:lab-9:rwan064:string.h&diff=8689&oldid=prev Mark: 2 revision(s) 2008-11-03T05:20:38Z <p>2 revision(s)</p> <p><b>New page</b></p><div>[[SE250:lab-9:rwan064|Back to Lab Report]]<br /> <br /> &lt;html&gt;<br /> &lt;head&gt;<br /> &lt;title&gt;string.h&lt;/title&gt;<br /> &lt;/head&gt;<br /> &lt;body bgcolor=&quot;#ffffff&quot; text=&quot;#000000&quot;&gt;<br /> &lt;pre&gt;<br /> &lt;a name=&quot;line1&quot;&gt; 1&lt;/a&gt; &lt;font color=&quot;#444444&quot;&gt;/*<br /> &lt;a name=&quot;line2&quot;&gt; 2&lt;/a&gt; File: string.h<br /> &lt;a name=&quot;line3&quot;&gt; 3&lt;/a&gt; Author: Rajitha Wannigama<br /> <br /> &lt;a name=&quot;line4&quot;&gt; 4&lt;/a&gt; Purpose: Header file for String type implementation in C.<br /> &lt;a name=&quot;line5&quot;&gt; 5&lt;/a&gt; */&lt;/font&gt;<br /> &lt;a name=&quot;line6&quot;&gt; 6&lt;/a&gt; <br /> &lt;a name=&quot;line7&quot;&gt; 7&lt;/a&gt; &lt;strong&gt;typedef&lt;/strong&gt;<br /> <br /> &lt;a name=&quot;line8&quot;&gt; 8&lt;/a&gt; &lt;strong&gt;struct&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;&lt;strong&gt;{&lt;/strong&gt;&lt;/font&gt;<br /> &lt;a name=&quot;line9&quot;&gt; 9&lt;/a&gt; &lt;strong&gt;char&lt;/strong&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;str&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;a name=&quot;line10&quot;&gt;10&lt;/a&gt; // &lt;font color=&quot;#2040a0&quot;&gt;Length&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;and&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;capacity&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;doesn&lt;/font&gt;&#039;&lt;font color=&quot;#2040a0&quot;&gt;t&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;include&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;NULL&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;terminator&lt;/font&gt;.<br /> <br /> &lt;a name=&quot;line11&quot;&gt;11&lt;/a&gt; &lt;strong&gt;unsigned&lt;/strong&gt; &lt;strong&gt;int&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;length&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> &lt;a name=&quot;line12&quot;&gt;12&lt;/a&gt; &lt;strong&gt;unsigned&lt;/strong&gt; &lt;strong&gt;int&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;capacity&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;a name=&quot;line13&quot;&gt;13&lt;/a&gt; &lt;font color=&quot;4444FF&quot;&gt;&lt;strong&gt;}&lt;/strong&gt;&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> &lt;a name=&quot;line14&quot;&gt;14&lt;/a&gt; <br /> &lt;a name=&quot;line15&quot;&gt;15&lt;/a&gt; &lt;strong&gt;extern&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;null_s&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;a name=&quot;line16&quot;&gt;16&lt;/a&gt; //&lt;strong&gt;extern&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;empty_s&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> &lt;a name=&quot;line17&quot;&gt;17&lt;/a&gt; <br /> &lt;a name=&quot;line18&quot;&gt;18&lt;/a&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;create_empty_string&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;(&lt;/font&gt; &lt;strong&gt;void&lt;/strong&gt; &lt;font color=&quot;4444FF&quot;&gt;)&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;a name=&quot;line19&quot;&gt;19&lt;/a&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;create_string&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;(&lt;/font&gt; &lt;strong&gt;const&lt;/strong&gt; &lt;strong&gt;char&lt;/strong&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;source&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;)&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;a name=&quot;line20&quot;&gt;20&lt;/a&gt; &lt;strong&gt;void&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;print_string&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;(&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;str&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;)&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> &lt;a name=&quot;line21&quot;&gt;21&lt;/a&gt; <br /> <br /> &lt;a name=&quot;line22&quot;&gt;22&lt;/a&gt; &lt;strong&gt;void&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;change_string&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;(&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;destination&lt;/font&gt;, &lt;strong&gt;const&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;source&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;)&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;a name=&quot;line23&quot;&gt;23&lt;/a&gt; <br /> &lt;a name=&quot;line24&quot;&gt;24&lt;/a&gt; &lt;font color=&quot;#444444&quot;&gt;/*<br /> &lt;a name=&quot;line25&quot;&gt;25&lt;/a&gt; Get a C-Style string of the string represented by this String object<br /> &lt;a name=&quot;line26&quot;&gt;26&lt;/a&gt; This function allocates a new area of memory for the C-style string.<br /> &lt;a name=&quot;line27&quot;&gt;27&lt;/a&gt; */&lt;/font&gt;<br /> &lt;a name=&quot;line28&quot;&gt;28&lt;/a&gt; &lt;strong&gt;char&lt;/strong&gt;&lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;get_cstring&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;(&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;str&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;)&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;a name=&quot;line29&quot;&gt;29&lt;/a&gt; <br /> &lt;a name=&quot;line30&quot;&gt;30&lt;/a&gt; &lt;font color=&quot;#444444&quot;&gt;/* Resize a String object */&lt;/font&gt;<br /> &lt;a name=&quot;line31&quot;&gt;31&lt;/a&gt; &lt;strong&gt;void&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;ensure_capacity&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;(&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;s&lt;/font&gt;, &lt;strong&gt;unsigned&lt;/strong&gt; &lt;strong&gt;int&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;cap&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;)&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;a name=&quot;line32&quot;&gt;32&lt;/a&gt; <br /> &lt;a name=&quot;line33&quot;&gt;33&lt;/a&gt; &lt;strong&gt;void&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;append_string&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;(&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;destination&lt;/font&gt;, &lt;strong&gt;const&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;source&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;)&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;a name=&quot;line34&quot;&gt;34&lt;/a&gt; &lt;strong&gt;void&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;append_cstring&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;(&lt;/font&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;destination&lt;/font&gt;, &lt;strong&gt;const&lt;/strong&gt; &lt;strong&gt;char&lt;/strong&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;source&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;)&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;a name=&quot;line35&quot;&gt;35&lt;/a&gt; <br /> &lt;a name=&quot;line36&quot;&gt;36&lt;/a&gt; &lt;font color=&quot;#444444&quot;&gt;/* TO BE IMPLEMENTED */&lt;/font&gt;<br /> &lt;a name=&quot;line37&quot;&gt;37&lt;/a&gt; &lt;font color=&quot;#444444&quot;&gt;/* Compare two strings and see if they are equal. If they are equal, return TRUE(non-zero). Otherwise FALSE(zero) value is returned. */&lt;/font&gt;<br /> &lt;a name=&quot;line38&quot;&gt;38&lt;/a&gt; &lt;strong&gt;int&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;compare_strings&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;(&lt;/font&gt; &lt;strong&gt;const&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;s1&lt;/font&gt;, &lt;strong&gt;const&lt;/strong&gt; &lt;font color=&quot;#2040a0&quot;&gt;String&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;*&lt;/font&gt;&lt;font color=&quot;#2040a0&quot;&gt;s2&lt;/font&gt; &lt;font color=&quot;4444FF&quot;&gt;)&lt;/font&gt;&lt;font color=&quot;4444FF&quot;&gt;;&lt;/font&gt;<br /> <br /> &lt;/pre&gt;<br /> &lt;hr&gt;<br /> syntax highlighted by &lt;a href=&quot;http://www.palfrader.org/code2html&quot;&gt;Code2HTML&lt;/a&gt;, v. 0.9.1<br /> &lt;/body&gt;<br /> &lt;/html&gt;</div> Mark