string getValueString(int $valueidentifier)

$valueidentifier - tells the function which string value to return

1 - the folder where HTML Validator is installed (ends with a \)

2 - the folder where Windows is installed (uses the GetWindowsDirectory() API function and only ends in a \ if Windows is installed in a root directory)

3 - the !DOCTYPE declaration (starts with !DOCTYPE and does not include the < and > characters at the beginning and end of the string)

4 - the version of the configuration being used (as specified in the Notes tab of the Configuration Editor)

5 - the filename or URL (with full path if available) of the document being validated (if available); now valid in the Batch Wizard as of v14.02

6 - the filename (without path) of the file being validated (if available)

7 - returns " If you're using HTML Validator's integrated editor, then this can be added from the 'Tags' menu or from the HTML Inserter."

8 - a message about the DOCTYPE ($doctypestring) not being recognized if it is not in the recognized DOCTYPE list; use only in a DOCTYPE tag name program; returns "" if $doctypestring is in the list or if the list is empty; if a match is not found, then any even number of single quotes are converted to double quotes and the DOCTYPE is tested again (New 20111214).

9 - the sound file to play when errors and/or warning messages are present

10 - the sound file to play when no errors and/or warning messages are present

11 - returns " /" if document is XHTML or "" if not

12 - returns "/" if document is XHTML or "" if not

13 - returns the text (character references are not converted) contained in the tag that is being ended, excluding beginning and trailing spaces; use in end tag programs only; to get the location of this text, call getLocation(3,0); use 33 instead of 13 to including "{text}" for ASP and PHP code sections (New v9.9913); use 30 or 32 instead of 13 to include beginning and trailing space characters

14 - returns the document type (based mainly on the DOCTYPE); example: "XHTML 1.1", "strict HTML 4.0/4.01", "strict XHTML 1.0", etc.

15 - returns the document type with "a" or "an" preceding it (based mainly on the DOCTYPE); example: "an XHTML 1.1", "a strict HTML 4.0/4.01", "a strict XHTML 1.0", etc.

16 - if the "align" attribute is used then returns a string, starting with a space, asking to consider CSS instead of the "align" attribute

17 - if the "bgcolor" attribute is used then returns a string, starting with a space, asking to consider the "background-color" CSS property instead of the "bgcolor" attribute

18 - if the "align" attribute is used then returns a string, starting with a space, asking to consider the CSS "text-align" property instead of the "align" attribute

19 - similar to 14 but returns something like "XHTML 1.1", "HTML 4.01 Strict", "XHTML 1.0 Strict", etc.

20 - if the "background" attribute is used then returns a string, starting with a space, asking to consider the "background-image" CSS property instead of the "background" attribute

21 - if the "text" attribute is used then returns a string, starting with a space, asking to consider the "color" CSS property instead of the "text" attribute

22 - if the "alink" attribute is used then returns a string, starting with a space, asking to consider the ":active" CSS pseudo-class instead of the "alink" attribute

23 - if the "link" attribute is used then returns a string, starting with a space, asking to consider the ":link" CSS pseudo-class instead of the "link" attribute

24 - if the "vlink" attribute is used then returns a string, starting with a space, asking to consider the ":visited" CSS pseudo-class instead of the "vlink" attribute

25 - returns a recommendation not to use frames due to usability and search engine issues (New v7.9910)

26 - returns a list of ignored CSS properties (if any) (New v7.9910)

27 - returns, if set, a string with legacyflag in square brackets followed by a space; example: "[114] " if legacyflag has been set to 114 (New v7.9910)

28 - returns a string of used accesskeys

29 - returns a string of unused accesskeys

30 - returns the text (character references are not converted) contained in the tag that is being ended, including beginning and trailing spaces; use in end tag programs only; to get the location of this text, call getLocation(3,0); use 13 instead of 30 to exclude beginning and trailing space characters; see also 32 (New v8.9910)

31 - returns a string like " The color "darkgreen" is the same as "#006400" in HTML/CSS." for the color name (darkgreen in this example) stored in the variable $getvaluestring31colorname. If there is no value for $getvaluestring31colorname or the color name does not exist or is unknown, then returns an empty string (New v8.9910)

32 - returns the text (character references are not converted) contained in the tag that is being ended, including beginning and trailing spaces and including "{text}" for ASP and PHP code sections; use in end tag programs only; to get the location of this text, call getLocation(3,0); see also 13 and 30 (New v8.9920)

33 - like 13 but includes "{text}" for ASP and PHP code sections (New v9.9913)

34 - if the "align" attribute is used then returns a string, starting with a space, asking to consider the appropriate CSS instead (New v9.9913)

35 - return the file extension of the document being validated (or an empty string if not available), if available; also sets $getvaluestring35infileext to the extension (New v9.9921)

36 - returns a string like " If this is a layout table, then include "layout" as part of the table's "id" attribute value and this message will not be displayed." (New v9.9930)

37 - if the "hspace" attribute is used then returns a string, starting with a space, asking to consider the "margin", "margin-left", and "margin-right" CSS properties instead of the "hspace" attribute (New v10.0020)

38 - if the "vspace" attribute is used then returns a string, starting with a space, asking to consider the "margin", "margin-top", and "margin-bottom" CSS properties instead of the "vspace" attribute (New v10.0020)

39 - if the "border" attribute is used then returns a string, starting with a space, asking to consider the "border" CSS property instead of the "border" attribute (New v10.0020)

40 - returns the file extension of the filename stored in $getvaluestring40input, returns an empty string if can't get a file extension (New v10.0032)

41 - returns a message about HTML5's unfinished status (New v10.0044)

42 - returns a valid default character encoding (like "utf-8", which is the default return encoding if none is specified elsewhere) to use in example messages; priority is given to valid encodings specified in any XML declaration, then in any "meta" tags, then in the HTTP headers (New v10.0127)

43 - returns a string with a link to visit for help with web server charset configuration - like "Visit http://www.htmlvalidator.com/help.php?m=3&h=webservercharset for web server charset configuration help.". (New v10.0133)

44 - returns a valid character encoding string if one has been specified in the XML declaration, in any "meta" tags, and then in the HTTP headers, else returns an empty string (New v10.0140)

45 - returns a string about what attribute values must be quoted based on the document type (New v10.9914)

46 - returns a string, beginning with "NOTE: " about potential issues with accesskeys (New v10.9916)

47 - returns a string like ' Check based on...' (if available); good to use after '... document detected.' (New v11.9915)

48 - returns the message text for when document.write() or document.writeln() is used in XHTML (New v11.9915)

49 - like 48, but better to use for "script" contents (New v11.9916)

50 - returns a string, either an empty string or a string beginning with "NOTE: " about the case-sensitivity of the document (based on the document type) (New v11.9921)

51 - if the "frameborder" attribute is used then returns a string, starting with a space, asking to consider the "border" CSS property instead of the "frameborder" attribute (New v12.0027)

52 - returns either an empty string or "NOTE: The option to require lowercase tags and attributes is enabled." based on whether the option to require lowercase tags and attributes is set. (New v12.0033)

53 - returns a string like " Served using the "(MIME type)" MIME type." (if available); good to use after "... document detected." (New v14.0101)

120 - returns a comma-separated list of unique proprietary attributes that were used (like those starting with "x-") (New v11.01)

121 - returns a comma-separated list of unique proprietary CSS pseudo-elements that were used (like pseudo-elements starting with "-moz-") (New v11.01)

122 - returns a comma-separated list of unique proprietary CSS media features that were used (like media features starting with "-webkit-") (New v11.01)

123 - returns a comma-separated list of unique proprietary CSS pseudo-classes that were used (like pseudo-classes starting with "-moz-") (New v14.0022)

130 - returns a string like "(with class="classname", id="idname") " for the current tag with class="classname" and id="idname", or returns an empty string if those attributes are not used; also calls runProgram(21) (New v11.01)

Returns "" (an empty string) if an error occurs, such as if $valueidentifier is invalid.