Reference:Strings - Revision history

Jholsenback: technical correction

2020-02-10T18:19:57Z

technical correction

Clipka: Indexentries fix

2016-12-16T15:14:14Z

Indexentries fix

Clipka: indexentry fix

2016-05-03T23:28:51Z

indexentry fix

Clipka: /* String Functions */ Changed `datetime()` subsection to avoid giving the false impression that `now` would only work in the contect of that function.

2016-01-26T04:51:12Z

String Functions: Changed `datetime()` subsection to avoid giving the false impression that `now` would only work in the contect of that function.

Clipka: /* String Literals */ undone a bit of nonsense in the previous edit

2015-01-21T03:22:05Z

String Literals: undone a bit of nonsense in the previous edit

Clipka: /* String Literals */ documented previously undocumented behaviour when parsing for a file name

2015-01-21T03:15:45Z

String Literals: documented previously undocumented behaviour when parsing for a file name

Jholsenback: 1 revision: link repair

2012-07-23T19:27:59Z

1 revision: link repair

Jholsenback: link repair

2012-07-20T15:09:30Z

link repair

Jholsenback: 1 revision: underscore link repair

2012-07-17T18:09:23Z

1 revision: underscore link repair

Jholsenback: still testing that theory

2012-07-15T12:06:37Z

still testing that theory

@@ Line 98: / Line 98: @@
 </pre>
-<p>Where <em>IDENTIFIER</em> is the name of the identifier up to 40
+<p>Where <em>IDENTIFIER</em> is a valid identifier name and <em>STRING</em> is any valid string specification.</p>
-characters long and <em>STRING</em> is any valid string specification.</p>
+<p class="Note"><strong>Note:</strong> Unlike floats, vectors, or colors, there need not be a semi-colon at the end of the declaration.</p>
-<p class="Note"><strong>Note:</strong> Unlike floats, vectors, or colors,
+<p>See also: <!--<linkto "Identifiers">Identifiers</linkto>--->[[Reference:Identifiers|Identifiers]] and <!--<linkto "#declare vs. #local">#declare vs. #local</linkto>--->[[Reference:Declare and Local Directives#declare vs. local|#declare vs. #local]] for additional information on identifier naming and scope.</p>
 <p>Here are some examples...</p>
 <pre>

@@ Line 26: / Line 26: @@
 </pre>
 {{#indexentry:String Literals}}
 {{#indexentry:Literals, string}}
 {{#indexentry:String, literals}}
 <p>String literals begin with a double quote mark '&quot;' which is followed by up to 256 characters and are terminated by another double quote mark. You can change the character set of strings using the <code>global_settings</code> <code>[[Reference:Global Settings#Charset|:charset|charset]]</code> option. The following are all valid string literals:</p>
@@ Line 86: / Line 86: @@
 <p class="Note"><strong>Note:</strong> Up to (and including) version 3.7.0, contrary to the documentation (and on all platforms) backslashes lost their special meaning where a file name is expected, except when preceding a double quote. For backward compatibility, this behaviour is still retained for scenes specifying a <code>#version</code> of 3.70 or lower, but a warning will be issued.</p>
 {{#indexentry:Identifiers, string}}
 {{#indexentry:String, identifiers}}
 <p>String identifiers may be declared to make scene files more readable and
 to parameterize scenes so that changing a single declaration changes many
@@ Line 164: / Line 163: @@
 </pre>
 {{#indexentry:String, functions}}
 {{#indexentry:Functions, string}}
 <p>POV-Ray defines a variety of built-in functions for manipulating floats,
 vectors and strings. Function calls consist of a keyword which specifies the
@@ Line 307: / Line 306: @@
 <!--<linkto "User Defined Macros">User Defined Macros</linkto>--->[[Reference:User Defined Macros|User Defined Macros]] for more details.</p>
 {{#indexentry:String, built-in variables}}
 <p>At the moment there is only one built-in string variable. You can use it to specify values or to create expressions but you cannot re-declare it to change it's value.</p>

@@ Line 26: / Line 26: @@
 </pre>
-{{#indexentry:String Literals|Literals, string|String, literals}}
+{{#indexentry:String Literals}}
 ==String Literals==
 <p>String literals begin with a double quote mark '&quot;' which is followed by up to 256 characters and are terminated by another double quote mark. You can change the character set of strings using the <code>global_settings</code> <code>[[Reference:Global Settings#Charset|:charset|charset]]</code> option. The following are all valid string literals:</p>
@@ Line 84: / Line 86: @@
 <p class="Note"><strong>Note:</strong> Up to (and including) version 3.7.0, contrary to the documentation (and on all platforms) backslashes lost their special meaning where a file name is expected, except when preceding a double quote. For backward compatibility, this behaviour is still retained for scenes specifying a <code>#version</code> of 3.70 or lower, but a warning will be issued.</p>
-{{#indexentry:Identifiers, string|String, identifiers}}
+{{#indexentry:Identifiers, string}}
 ==String Identifiers==
@@ Line 161: / Line 164: @@
 </pre>
-{{#indexentry:String, functions|Functions, string}}
+{{#indexentry:String, functions}}
 ==String Functions==
 <p>POV-Ray defines a variety of built-in functions for manipulating floats,

@@ Line 203: / Line 203: @@
 {{#indexentry:datetime}}
-<p><code>datetime()</code> Can be used to return the date and time. It's syntax is:</p>
+<p><code>datetime()</code> Can be used to return the string representation of a date and time. It's syntax is:</p>
 <pre>
@@ Line 209: / Line 209: @@
 </pre>
-<p>when FLOAT uses the keyword <code>now</code> it will return a string which evaluates to the time elapsed since 2000-01-01, 00:00:00 GMT in days, with a precision of seconds or better. For example:</p>
+<p>where FLOAT is the time elapsed since 2000-01-01, 00:00:00 GMT in days. Note that this fits with the <code>now</code> keyword, so the following example will give you a string representation of the current date and time:</p>
 <pre>

@@ Line 28: / Line 28: @@
 {{#indexentry:String Literals|Literals, string|String, literals}}
 ==String Literals==
-<p>String literals begin with a double quote mark '&quot;' which is followed by an arbitrary number of characters and are terminated by another double quote mark. You can change the character set of strings using the <code>global_settings</code> <code>[[Reference:Global Settings#Charset|:charset|charset]]</code> option. The following are all valid string literals:</p>
+<p>String literals begin with a double quote mark '&quot;' which is followed by up to 256 characters and are terminated by another double quote mark. You can change the character set of strings using the <code>global_settings</code> <code>[[Reference:Global Settings#Charset|:charset|charset]]</code> option. The following are all valid string literals:</p>
 <p>&quot;Here&quot; &quot;There&quot; &quot;myfile.gif&quot; &quot;textures.inc&quot;</p>

← Older revision	Revision as of 19:27, 23 July 2012
(No difference)

@@ Line 3: / Line 3: @@
 used as a file name, text for messages or text for a text object. Strings may
 be specified using literals, identifiers or functions which return string
-values. See <!--<linkto "String Functions">String Functions</linkto>--->[[Reference:Strings#String_Functions|String Functions]]
+values. See [[Reference:Strings#String Functions|String Functions]]
 for details on string functions. Although you cannot build string expressions
 from symbolic operators such as are used with floats, vectors or colors, you

← Older revision	Revision as of 18:09, 17 July 2012
(No difference)

@@ Line 104: / Line 104: @@
 ==String Relational Operators==
 <p>POV-Ray supports the following string relational operators: <code><strong>&lt;</strong> <strong>&lt;=</strong> <strong>=</strong> <strong>&gt;=</strong> <strong>&gt;</strong> <strong>!=</strong></code> and are subject to standard ASCII collating sequence rules.</p>
-<p class="Note"><strong>Note:</strong> These relational operators are nothing more than a <em>shortcut</em> as they are an equivalent to calling the <code>[[Reference:Numeric_Expressions#Functions|strcmp()]]</code> function.</p>
+<p class="Note"><strong>Note:</strong> These relational operators are nothing more than a <em>shortcut</em> as they are an equivalent to calling the <code>[[Reference:Numeric Expressions#Functions|strcmp()]]</code> function.</p>
 <p>For example:</p>
 <pre>
@@ Line 286: / Line 286: @@
 </pre>
-<p> See section [[Reference:Numeric_Expressions#Functions|:Float, functions|Float Functions]] for other functions which are
+<p> See section [[Reference:Numeric Expressions#Functions|:Float, functions|Float Functions]] for other functions which are
 somewhat string-related but which return floats. In addition to the above
 built-in functions, you may also define your own functions using the