2009-06-11 05:29:44 +04:00
|
|
|
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
1998-03-28 05:44:41 +03:00
|
|
|
*
|
2003-11-15 03:11:16 +03:00
|
|
|
* ***** BEGIN LICENSE BLOCK *****
|
|
|
|
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
|
1998-03-28 05:44:41 +03:00
|
|
|
*
|
2003-11-15 03:11:16 +03:00
|
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
|
|
* the License. You may obtain a copy of the License at
|
|
|
|
* http://www.mozilla.org/MPL/
|
|
|
|
*
|
|
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
|
|
* for the specific language governing rights and limitations under the
|
|
|
|
* License.
|
1998-03-28 05:44:41 +03:00
|
|
|
*
|
2001-09-20 04:02:59 +04:00
|
|
|
* The Original Code is Mozilla Communicator client code, released
|
|
|
|
* March 31, 1998.
|
1999-09-29 03:12:09 +04:00
|
|
|
*
|
2003-11-15 03:11:16 +03:00
|
|
|
* The Initial Developer of the Original Code is
|
|
|
|
* Netscape Communications Corporation.
|
|
|
|
* Portions created by the Initial Developer are Copyright (C) 1998
|
|
|
|
* the Initial Developer. All Rights Reserved.
|
|
|
|
*
|
|
|
|
* Contributor(s):
|
|
|
|
*
|
|
|
|
* Alternatively, the contents of this file may be used under the terms of
|
|
|
|
* either of the GNU General Public License Version 2 or later (the "GPL"),
|
|
|
|
* or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
|
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
|
|
|
* use your version of this file under the terms of the MPL, indicate your
|
|
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
|
|
* the provisions above, a recipient may use your version of this file under
|
|
|
|
* the terms of any one of the MPL, the GPL or the LGPL.
|
|
|
|
*
|
|
|
|
* ***** END LICENSE BLOCK ***** */
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
#ifndef jsstr_h___
|
|
|
|
#define jsstr_h___
|
2011-03-14 23:59:53 +03:00
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
#include <ctype.h>
|
2010-07-15 10:19:36 +04:00
|
|
|
#include "jsapi.h"
|
1998-03-28 05:44:41 +03:00
|
|
|
#include "jsprvtd.h"
|
2010-03-16 21:28:33 +03:00
|
|
|
#include "jshashtable.h"
|
2009-06-11 05:29:44 +04:00
|
|
|
#include "jslock.h"
|
2010-04-15 05:57:30 +04:00
|
|
|
#include "jsobj.h"
|
2010-07-15 10:19:36 +04:00
|
|
|
#include "jsvalue.h"
|
2010-09-24 21:54:39 +04:00
|
|
|
#include "jscell.h"
|
2010-03-23 08:39:29 +03:00
|
|
|
|
2010-12-01 05:41:32 +03:00
|
|
|
namespace js {
|
2010-07-25 07:26:34 +04:00
|
|
|
|
2011-03-14 23:59:53 +03:00
|
|
|
/* Implemented in jsstrinlines.h */
|
2011-01-13 02:28:58 +03:00
|
|
|
class StringBuffer;
|
|
|
|
|
2010-07-17 04:41:22 +04:00
|
|
|
/*
|
2010-12-01 05:41:32 +03:00
|
|
|
* When an algorithm does not need a string represented as a single linear
|
|
|
|
* array of characters, this range utility may be used to traverse the string a
|
|
|
|
* sequence of linear arrays of characters. This avoids flattening ropes.
|
2010-07-17 04:41:22 +04:00
|
|
|
*
|
2010-12-01 05:41:32 +03:00
|
|
|
* Implemented in jsstrinlines.h.
|
2010-07-17 04:41:22 +04:00
|
|
|
*/
|
2010-12-01 05:41:32 +03:00
|
|
|
class StringSegmentRange;
|
2010-12-06 21:26:58 +03:00
|
|
|
class MutatingRopeSegmentRange;
|
2010-07-17 04:41:22 +04:00
|
|
|
|
2010-07-23 04:54:39 +04:00
|
|
|
/*
|
2010-12-01 05:41:32 +03:00
|
|
|
* Utility for building a rope (lazy concatenation) of strings.
|
2010-07-23 04:54:39 +04:00
|
|
|
*/
|
2010-12-01 05:41:32 +03:00
|
|
|
class RopeBuilder;
|
2010-07-17 04:41:22 +04:00
|
|
|
|
2010-12-01 05:41:32 +03:00
|
|
|
} /* namespace js */
|
2010-07-17 04:41:22 +04:00
|
|
|
|
2011-03-14 23:59:53 +03:00
|
|
|
extern JSString * JS_FASTCALL
|
|
|
|
js_ConcatStrings(JSContext *cx, JSString *s1, JSString *s2);
|
2007-08-16 10:23:06 +04:00
|
|
|
|
2009-06-11 05:29:44 +04:00
|
|
|
extern JSString * JS_FASTCALL
|
2008-08-30 04:35:00 +04:00
|
|
|
js_toLowerCase(JSContext *cx, JSString *str);
|
|
|
|
|
2009-06-11 05:29:44 +04:00
|
|
|
extern JSString * JS_FASTCALL
|
2008-08-30 04:35:00 +04:00
|
|
|
js_toUpperCase(JSContext *cx, JSString *str);
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
struct JSSubString {
|
|
|
|
size_t length;
|
|
|
|
const jschar *chars;
|
|
|
|
};
|
|
|
|
|
|
|
|
extern jschar js_empty_ucstr[];
|
|
|
|
extern JSSubString js_EmptySubString;
|
|
|
|
|
|
|
|
/* Unicode character attribute lookup tables. */
|
|
|
|
extern const uint8 js_X[];
|
|
|
|
extern const uint8 js_Y[];
|
1998-04-24 04:31:11 +04:00
|
|
|
extern const uint32 js_A[];
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
/* Enumerated Unicode general category types. */
|
|
|
|
typedef enum JSCharType {
|
|
|
|
JSCT_UNASSIGNED = 0,
|
|
|
|
JSCT_UPPERCASE_LETTER = 1,
|
|
|
|
JSCT_LOWERCASE_LETTER = 2,
|
|
|
|
JSCT_TITLECASE_LETTER = 3,
|
|
|
|
JSCT_MODIFIER_LETTER = 4,
|
|
|
|
JSCT_OTHER_LETTER = 5,
|
|
|
|
JSCT_NON_SPACING_MARK = 6,
|
|
|
|
JSCT_ENCLOSING_MARK = 7,
|
|
|
|
JSCT_COMBINING_SPACING_MARK = 8,
|
|
|
|
JSCT_DECIMAL_DIGIT_NUMBER = 9,
|
|
|
|
JSCT_LETTER_NUMBER = 10,
|
|
|
|
JSCT_OTHER_NUMBER = 11,
|
|
|
|
JSCT_SPACE_SEPARATOR = 12,
|
|
|
|
JSCT_LINE_SEPARATOR = 13,
|
|
|
|
JSCT_PARAGRAPH_SEPARATOR = 14,
|
|
|
|
JSCT_CONTROL = 15,
|
|
|
|
JSCT_FORMAT = 16,
|
|
|
|
JSCT_PRIVATE_USE = 18,
|
|
|
|
JSCT_SURROGATE = 19,
|
|
|
|
JSCT_DASH_PUNCTUATION = 20,
|
|
|
|
JSCT_START_PUNCTUATION = 21,
|
|
|
|
JSCT_END_PUNCTUATION = 22,
|
|
|
|
JSCT_CONNECTOR_PUNCTUATION = 23,
|
|
|
|
JSCT_OTHER_PUNCTUATION = 24,
|
|
|
|
JSCT_MATH_SYMBOL = 25,
|
|
|
|
JSCT_CURRENCY_SYMBOL = 26,
|
|
|
|
JSCT_MODIFIER_SYMBOL = 27,
|
|
|
|
JSCT_OTHER_SYMBOL = 28
|
|
|
|
} JSCharType;
|
|
|
|
|
|
|
|
/* Character classifying and mapping macros, based on java.lang.Character. */
|
1998-04-24 04:31:11 +04:00
|
|
|
#define JS_CCODE(c) (js_A[js_Y[(js_X[(uint16)(c)>>6]<<6)|((c)&0x3F)]])
|
1998-03-28 05:44:41 +03:00
|
|
|
#define JS_CTYPE(c) (JS_CCODE(c) & 0x1F)
|
|
|
|
|
|
|
|
#define JS_ISALPHA(c) ((((1 << JSCT_UPPERCASE_LETTER) | \
|
2004-12-09 04:32:19 +03:00
|
|
|
(1 << JSCT_LOWERCASE_LETTER) | \
|
|
|
|
(1 << JSCT_TITLECASE_LETTER) | \
|
|
|
|
(1 << JSCT_MODIFIER_LETTER) | \
|
|
|
|
(1 << JSCT_OTHER_LETTER)) \
|
|
|
|
>> JS_CTYPE(c)) & 1)
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
#define JS_ISALNUM(c) ((((1 << JSCT_UPPERCASE_LETTER) | \
|
2004-12-09 04:32:19 +03:00
|
|
|
(1 << JSCT_LOWERCASE_LETTER) | \
|
|
|
|
(1 << JSCT_TITLECASE_LETTER) | \
|
|
|
|
(1 << JSCT_MODIFIER_LETTER) | \
|
|
|
|
(1 << JSCT_OTHER_LETTER) | \
|
|
|
|
(1 << JSCT_DECIMAL_DIGIT_NUMBER)) \
|
|
|
|
>> JS_CTYPE(c)) & 1)
|
1998-03-28 05:44:41 +03:00
|
|
|
|
2000-01-27 01:15:06 +03:00
|
|
|
/* A unicode letter, suitable for use in an identifier. */
|
2004-10-05 14:19:07 +04:00
|
|
|
#define JS_ISLETTER(c) ((((1 << JSCT_UPPERCASE_LETTER) | \
|
2004-12-09 04:32:19 +03:00
|
|
|
(1 << JSCT_LOWERCASE_LETTER) | \
|
|
|
|
(1 << JSCT_TITLECASE_LETTER) | \
|
|
|
|
(1 << JSCT_MODIFIER_LETTER) | \
|
|
|
|
(1 << JSCT_OTHER_LETTER) | \
|
|
|
|
(1 << JSCT_LETTER_NUMBER)) \
|
|
|
|
>> JS_CTYPE(c)) & 1)
|
2000-01-27 01:15:06 +03:00
|
|
|
|
|
|
|
/*
|
2004-06-19 01:59:06 +04:00
|
|
|
* 'IdentifierPart' from ECMA grammar, is Unicode letter or combining mark or
|
|
|
|
* digit or connector punctuation.
|
|
|
|
*/
|
2004-10-05 14:19:07 +04:00
|
|
|
#define JS_ISIDPART(c) ((((1 << JSCT_UPPERCASE_LETTER) | \
|
2004-12-09 04:32:19 +03:00
|
|
|
(1 << JSCT_LOWERCASE_LETTER) | \
|
|
|
|
(1 << JSCT_TITLECASE_LETTER) | \
|
|
|
|
(1 << JSCT_MODIFIER_LETTER) | \
|
|
|
|
(1 << JSCT_OTHER_LETTER) | \
|
|
|
|
(1 << JSCT_LETTER_NUMBER) | \
|
|
|
|
(1 << JSCT_NON_SPACING_MARK) | \
|
|
|
|
(1 << JSCT_COMBINING_SPACING_MARK) | \
|
|
|
|
(1 << JSCT_DECIMAL_DIGIT_NUMBER) | \
|
|
|
|
(1 << JSCT_CONNECTOR_PUNCTUATION)) \
|
|
|
|
>> JS_CTYPE(c)) & 1)
|
2000-01-27 01:15:06 +03:00
|
|
|
|
|
|
|
/* Unicode control-format characters, ignored in input */
|
|
|
|
#define JS_ISFORMAT(c) (((1 << JSCT_FORMAT) >> JS_CTYPE(c)) & 1)
|
|
|
|
|
2011-03-17 01:18:12 +03:00
|
|
|
extern const bool js_isidstart[];
|
|
|
|
extern const bool js_isident[];
|
|
|
|
|
|
|
|
static inline bool
|
|
|
|
JS_ISIDSTART(int c)
|
|
|
|
{
|
|
|
|
unsigned w = c;
|
|
|
|
|
|
|
|
return (w < 128) ? js_isidstart[w] : JS_ISLETTER(c);
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline bool
|
|
|
|
JS_ISIDENT(int c)
|
|
|
|
{
|
|
|
|
unsigned w = c;
|
|
|
|
|
|
|
|
return (w < 128) ? js_isident[w] : JS_ISIDPART(c);
|
|
|
|
}
|
2004-10-05 14:19:07 +04:00
|
|
|
|
|
|
|
#define JS_ISXMLSPACE(c) ((c) == ' ' || (c) == '\t' || (c) == '\r' || \
|
|
|
|
(c) == '\n')
|
|
|
|
#define JS_ISXMLNSSTART(c) ((JS_CCODE(c) & 0x00000100) || (c) == '_')
|
|
|
|
#define JS_ISXMLNS(c) ((JS_CCODE(c) & 0x00000080) || (c) == '.' || \
|
|
|
|
(c) == '-' || (c) == '_')
|
|
|
|
#define JS_ISXMLNAMESTART(c) (JS_ISXMLNSSTART(c) || (c) == ':')
|
|
|
|
#define JS_ISXMLNAME(c) (JS_ISXMLNS(c) || (c) == ':')
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
#define JS_ISDIGIT(c) (JS_CTYPE(c) == JSCT_DECIMAL_DIGIT_NUMBER)
|
|
|
|
|
2010-07-23 07:28:33 +04:00
|
|
|
const jschar BYTE_ORDER_MARK = 0xFEFF;
|
2011-06-07 07:47:12 +04:00
|
|
|
const jschar BYTE_ORDER_MARK2 = 0xFFFE;
|
2010-07-23 07:28:33 +04:00
|
|
|
const jschar NO_BREAK_SPACE = 0x00A0;
|
|
|
|
|
2011-03-17 01:17:55 +03:00
|
|
|
extern const bool js_isspace[];
|
|
|
|
|
2009-08-29 13:17:10 +04:00
|
|
|
static inline bool
|
2011-03-17 01:17:55 +03:00
|
|
|
JS_ISSPACE(int c)
|
2009-08-29 13:17:10 +04:00
|
|
|
{
|
2009-08-30 01:19:44 +04:00
|
|
|
unsigned w = c;
|
2009-08-29 13:36:45 +04:00
|
|
|
|
2011-03-17 01:17:55 +03:00
|
|
|
return (w < 128)
|
|
|
|
? js_isspace[w]
|
|
|
|
: w == NO_BREAK_SPACE || w == BYTE_ORDER_MARK ||
|
|
|
|
(JS_CCODE(w) & 0x00070000) == 0x00040000;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline bool
|
|
|
|
JS_ISSPACE_OR_BOM(int c)
|
|
|
|
{
|
|
|
|
unsigned w = c;
|
2009-08-29 13:36:45 +04:00
|
|
|
|
2011-03-17 01:17:55 +03:00
|
|
|
/* Treat little- and big-endian BOMs as whitespace for compatibility. */
|
|
|
|
return (w < 128)
|
|
|
|
? js_isspace[w]
|
2011-06-07 07:47:12 +04:00
|
|
|
: w == NO_BREAK_SPACE || w == BYTE_ORDER_MARK || w == BYTE_ORDER_MARK2 ||
|
|
|
|
(JS_CCODE(w) & 0x00070000) == 0x00040000;
|
2009-08-29 13:17:10 +04:00
|
|
|
}
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
#define JS_ISPRINT(c) ((c) < 128 && isprint(c))
|
|
|
|
|
|
|
|
#define JS_ISUPPER(c) (JS_CTYPE(c) == JSCT_UPPERCASE_LETTER)
|
|
|
|
#define JS_ISLOWER(c) (JS_CTYPE(c) == JSCT_LOWERCASE_LETTER)
|
|
|
|
|
2004-04-04 02:11:11 +04:00
|
|
|
#define JS_TOUPPER(c) ((jschar) ((JS_CCODE(c) & 0x00100000) \
|
|
|
|
? (c) - ((int32)JS_CCODE(c) >> 22) \
|
|
|
|
: (c)))
|
|
|
|
#define JS_TOLOWER(c) ((jschar) ((JS_CCODE(c) & 0x00200000) \
|
|
|
|
? (c) + ((int32)JS_CCODE(c) >> 22) \
|
|
|
|
: (c)))
|
1998-03-28 05:44:41 +03:00
|
|
|
|
2006-06-02 00:04:29 +04:00
|
|
|
/*
|
|
|
|
* Shorthands for ASCII (7-bit) decimal and hex conversion.
|
|
|
|
* Manually inline isdigit for performance; MSVC doesn't do this for us.
|
|
|
|
*/
|
|
|
|
#define JS7_ISDEC(c) ((((unsigned)(c)) - '0') <= 9)
|
1998-03-28 05:44:41 +03:00
|
|
|
#define JS7_UNDEC(c) ((c) - '0')
|
|
|
|
#define JS7_ISHEX(c) ((c) < 128 && isxdigit(c))
|
2006-06-02 00:04:29 +04:00
|
|
|
#define JS7_UNHEX(c) (uintN)(JS7_ISDEC(c) ? (c) - '0' : 10 + tolower(c) - 'a')
|
1998-03-28 05:44:41 +03:00
|
|
|
#define JS7_ISLET(c) ((c) < 128 && isalpha(c))
|
|
|
|
|
|
|
|
/* Initialize the String class, returning its prototype object. */
|
2010-07-15 10:19:36 +04:00
|
|
|
extern js::Class js_StringClass;
|
2004-10-05 14:19:07 +04:00
|
|
|
|
2010-04-15 05:57:30 +04:00
|
|
|
inline bool
|
|
|
|
JSObject::isString() const
|
|
|
|
{
|
|
|
|
return getClass() == &js_StringClass;
|
|
|
|
}
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
extern JSObject *
|
|
|
|
js_InitStringClass(JSContext *cx, JSObject *obj);
|
|
|
|
|
2000-08-19 12:37:07 +04:00
|
|
|
extern const char js_escape_str[];
|
|
|
|
extern const char js_unescape_str[];
|
|
|
|
extern const char js_uneval_str[];
|
|
|
|
extern const char js_decodeURI_str[];
|
|
|
|
extern const char js_encodeURI_str[];
|
|
|
|
extern const char js_decodeURIComponent_str[];
|
|
|
|
extern const char js_encodeURIComponent_str[];
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
/* GC-allocate a string descriptor for the given malloc-allocated chars. */
|
2011-03-14 23:59:53 +03:00
|
|
|
extern JSFixedString *
|
2008-08-11 22:03:54 +04:00
|
|
|
js_NewString(JSContext *cx, jschar *chars, size_t length);
|
1998-03-28 05:44:41 +03:00
|
|
|
|
2010-12-06 21:26:58 +03:00
|
|
|
extern JSLinearString *
|
2011-03-14 23:59:53 +03:00
|
|
|
js_NewDependentString(JSContext *cx, JSString *base, size_t start, size_t length);
|
2001-10-25 04:26:38 +04:00
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
/* Copy a counted string and GC-allocate a descriptor for it. */
|
2011-03-14 23:59:53 +03:00
|
|
|
extern JSFixedString *
|
2007-07-28 20:57:30 +04:00
|
|
|
js_NewStringCopyN(JSContext *cx, const jschar *s, size_t n);
|
1998-03-28 05:44:41 +03:00
|
|
|
|
2011-03-14 23:59:53 +03:00
|
|
|
extern JSFixedString *
|
2010-07-25 07:26:34 +04:00
|
|
|
js_NewStringCopyN(JSContext *cx, const char *s, size_t n);
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
/* Copy a C string and GC-allocate a descriptor for it. */
|
2011-03-14 23:59:53 +03:00
|
|
|
extern JSFixedString *
|
2007-07-28 20:57:30 +04:00
|
|
|
js_NewStringCopyZ(JSContext *cx, const jschar *s);
|
1998-03-28 05:44:41 +03:00
|
|
|
|
2011-03-14 23:59:53 +03:00
|
|
|
extern JSFixedString *
|
2010-07-25 07:26:34 +04:00
|
|
|
js_NewStringCopyZ(JSContext *cx, const char *s);
|
|
|
|
|
2004-10-05 14:19:07 +04:00
|
|
|
/*
|
|
|
|
* Convert a value to a printable C string.
|
|
|
|
*/
|
2010-11-11 23:40:29 +03:00
|
|
|
extern const char *
|
|
|
|
js_ValueToPrintable(JSContext *cx, const js::Value &,
|
|
|
|
JSAutoByteString *bytes, bool asSource = false);
|
2004-10-05 14:19:07 +04:00
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
/*
|
|
|
|
* Convert a value to a string, returning null after reporting an error,
|
|
|
|
* otherwise returning a new string reference.
|
|
|
|
*/
|
2010-07-15 10:19:36 +04:00
|
|
|
extern JSString *
|
|
|
|
js_ValueToString(JSContext *cx, const js::Value &v);
|
1998-03-28 05:44:41 +03:00
|
|
|
|
2010-10-04 22:45:34 +04:00
|
|
|
namespace js {
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Most code that calls js_ValueToString knows the value is (probably) not a
|
|
|
|
* string, so it does not make sense to put this inline fast path into
|
|
|
|
* js_ValueToString.
|
|
|
|
*/
|
|
|
|
static JS_ALWAYS_INLINE JSString *
|
|
|
|
ValueToString_TestForStringInline(JSContext *cx, const Value &v)
|
|
|
|
{
|
|
|
|
if (v.isString())
|
|
|
|
return v.toString();
|
|
|
|
return js_ValueToString(cx, v);
|
|
|
|
}
|
|
|
|
|
2009-07-01 04:19:42 +04:00
|
|
|
/*
|
2009-08-08 07:09:11 +04:00
|
|
|
* This function implements E-262-3 section 9.8, toString. Convert the given
|
|
|
|
* value to a string of jschars appended to the given buffer. On error, the
|
2009-07-01 04:19:42 +04:00
|
|
|
* passed buffer may have partial results appended.
|
|
|
|
*/
|
2011-03-30 02:46:51 +04:00
|
|
|
inline bool
|
2011-01-13 02:28:58 +03:00
|
|
|
ValueToStringBuffer(JSContext *cx, const Value &v, StringBuffer &sb);
|
|
|
|
|
|
|
|
} /* namespace js */
|
2009-07-01 04:19:42 +04:00
|
|
|
|
1998-04-24 04:31:11 +04:00
|
|
|
/*
|
|
|
|
* Convert a value to its source expression, returning null after reporting
|
|
|
|
* an error, otherwise returning a new string reference.
|
|
|
|
*/
|
2006-05-21 02:27:28 +04:00
|
|
|
extern JS_FRIEND_API(JSString *)
|
2010-07-15 10:19:36 +04:00
|
|
|
js_ValueToSource(JSContext *cx, const js::Value &v);
|
1998-04-24 04:31:11 +04:00
|
|
|
|
2011-03-14 23:59:53 +03:00
|
|
|
namespace js {
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
/*
|
2007-08-12 00:25:16 +04:00
|
|
|
* Compute a hash function from str. The caller can call this function even if
|
|
|
|
* str is not a GC-allocated thing.
|
1998-03-28 05:44:41 +03:00
|
|
|
*/
|
2010-12-06 21:26:58 +03:00
|
|
|
inline uint32
|
2011-03-14 23:59:53 +03:00
|
|
|
HashChars(const jschar *chars, size_t length)
|
2010-12-06 21:26:58 +03:00
|
|
|
{
|
2011-03-14 23:59:53 +03:00
|
|
|
uint32 h = 0;
|
|
|
|
for (; length; chars++, length--)
|
|
|
|
h = JS_ROTATE_LEFT32(h, 4) ^ *chars;
|
2010-12-06 21:26:58 +03:00
|
|
|
return h;
|
|
|
|
}
|
|
|
|
|
2007-08-12 00:25:16 +04:00
|
|
|
/*
|
|
|
|
* Test if strings are equal. The caller can call the function even if str1
|
|
|
|
* or str2 are not GC-allocated things.
|
|
|
|
*/
|
2010-12-06 21:26:58 +03:00
|
|
|
extern bool
|
|
|
|
EqualStrings(JSContext *cx, JSString *str1, JSString *str2, JSBool *result);
|
|
|
|
|
|
|
|
/* EqualStrings is infallible on linear strings. */
|
|
|
|
extern bool
|
|
|
|
EqualStrings(JSLinearString *str1, JSLinearString *str2);
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Return less than, equal to, or greater than zero depending on whether
|
|
|
|
* str1 is less than, equal to, or greater than str2.
|
|
|
|
*/
|
2010-12-06 21:26:58 +03:00
|
|
|
extern bool
|
|
|
|
CompareStrings(JSContext *cx, JSString *str1, JSString *str2, int32 *result);
|
2006-01-26 11:01:54 +03:00
|
|
|
|
2010-10-28 19:15:53 +04:00
|
|
|
/*
|
|
|
|
* Return true if the string matches the given sequence of ASCII bytes.
|
|
|
|
*/
|
2010-12-06 21:26:58 +03:00
|
|
|
extern bool
|
|
|
|
StringEqualsAscii(JSLinearString *str, const char *asciiBytes);
|
2010-10-28 19:15:53 +04:00
|
|
|
|
|
|
|
} /* namespacejs */
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
extern size_t
|
|
|
|
js_strlen(const jschar *s);
|
|
|
|
|
|
|
|
extern jschar *
|
|
|
|
js_strchr(const jschar *s, jschar c);
|
|
|
|
|
2001-11-21 00:26:33 +03:00
|
|
|
extern jschar *
|
|
|
|
js_strchr_limit(const jschar *s, jschar c, const jschar *limit);
|
|
|
|
|
2002-01-25 03:47:11 +03:00
|
|
|
#define js_strncpy(t, s, n) memcpy((t), (s), (n) * sizeof(jschar))
|
1998-03-28 05:44:41 +03:00
|
|
|
|
1998-07-31 04:07:22 +04:00
|
|
|
/*
|
|
|
|
* Return s advanced past any Unicode white space characters.
|
|
|
|
*/
|
2009-08-29 13:17:10 +04:00
|
|
|
static inline const jschar *
|
|
|
|
js_SkipWhiteSpace(const jschar *s, const jschar *end)
|
|
|
|
{
|
|
|
|
JS_ASSERT(s <= end);
|
|
|
|
while (s != end && JS_ISSPACE(*s))
|
|
|
|
s++;
|
|
|
|
return s;
|
|
|
|
}
|
1998-07-31 04:07:22 +04:00
|
|
|
|
2011-05-27 02:50:05 +04:00
|
|
|
namespace js {
|
|
|
|
|
2011-03-21 21:06:34 +03:00
|
|
|
/*
|
2011-05-27 02:50:05 +04:00
|
|
|
* On encodings:
|
|
|
|
*
|
|
|
|
* - Some string functions have an optional FlationCoding argument that allow
|
|
|
|
* the caller to force CESU-8 encoding handling.
|
|
|
|
* - Functions that don't take a FlationCoding base their NormalEncoding
|
|
|
|
* behavior on the js_CStringsAreUTF8 value. NormalEncoding is either raw
|
|
|
|
* (simple zero-extension) or UTF-8 depending on js_CStringsAreUTF8.
|
|
|
|
* - Functions that explicitly state their encoding do not use the
|
|
|
|
* js_CStringsAreUTF8 value.
|
|
|
|
*
|
|
|
|
* CESU-8 (Compatibility Encoding Scheme for UTF-16: 8-bit) is a variant of
|
|
|
|
* UTF-8 that allows us to store any wide character string as a narrow
|
|
|
|
* character string. For strings containing mostly ascii, it saves space.
|
2011-03-21 21:06:34 +03:00
|
|
|
* http://www.unicode.org/reports/tr26/
|
|
|
|
*/
|
|
|
|
|
2011-05-27 02:50:05 +04:00
|
|
|
enum FlationCoding
|
|
|
|
{
|
|
|
|
NormalEncoding,
|
|
|
|
CESU8Encoding
|
|
|
|
};
|
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
/*
|
2011-05-27 02:50:05 +04:00
|
|
|
* Inflate bytes to jschars. Return null on error, otherwise return the jschar
|
|
|
|
* or byte vector that was malloc'ed. length is updated to the length of the
|
|
|
|
* new string (in jschars).
|
1998-03-28 05:44:41 +03:00
|
|
|
*/
|
|
|
|
extern jschar *
|
2011-05-27 02:50:05 +04:00
|
|
|
InflateString(JSContext *cx, const char *bytes, size_t *length,
|
|
|
|
FlationCoding fc = NormalEncoding);
|
1998-03-28 05:44:41 +03:00
|
|
|
|
|
|
|
extern char *
|
2011-05-27 02:50:05 +04:00
|
|
|
DeflateString(JSContext *cx, const jschar *chars, size_t length);
|
1998-03-28 05:44:41 +03:00
|
|
|
|
2000-07-21 04:57:19 +04:00
|
|
|
/*
|
2011-05-27 02:50:05 +04:00
|
|
|
* Inflate bytes to JS chars in an existing buffer. 'chars' must be large
|
|
|
|
* enough for 'length' jschars. The buffer is NOT null-terminated.
|
|
|
|
*
|
|
|
|
* charsLength must be be initialized with the destination buffer size and, on
|
|
|
|
* return, will contain on return the number of copied chars.
|
2000-07-21 04:57:19 +04:00
|
|
|
*/
|
2011-05-27 02:50:05 +04:00
|
|
|
extern bool
|
|
|
|
InflateStringToBuffer(JSContext *cx, const char *bytes, size_t length,
|
|
|
|
jschar *chars, size_t *charsLength);
|
2000-07-21 04:57:19 +04:00
|
|
|
|
2011-05-27 02:50:05 +04:00
|
|
|
extern bool
|
|
|
|
InflateUTF8StringToBuffer(JSContext *cx, const char *bytes, size_t length,
|
|
|
|
jschar *chars, size_t *charsLength,
|
|
|
|
FlationCoding fc = NormalEncoding);
|
2010-04-03 00:05:30 +04:00
|
|
|
|
2011-05-27 02:50:05 +04:00
|
|
|
/* Get number of bytes in the deflated sequence of characters. */
|
2007-03-08 09:25:23 +03:00
|
|
|
extern size_t
|
2011-05-27 02:50:05 +04:00
|
|
|
GetDeflatedStringLength(JSContext *cx, const jschar *chars, size_t charsLength);
|
2007-03-08 09:25:23 +03:00
|
|
|
|
2011-05-27 02:50:05 +04:00
|
|
|
/* This function will never fail (return -1) in CESU-8 mode. */
|
2010-04-03 00:05:30 +04:00
|
|
|
extern size_t
|
2011-05-27 02:50:05 +04:00
|
|
|
GetDeflatedUTF8StringLength(JSContext *cx, const jschar *chars,
|
|
|
|
size_t charsLength,
|
|
|
|
FlationCoding fc = NormalEncoding);
|
2010-04-03 00:05:30 +04:00
|
|
|
|
2007-03-08 09:25:23 +03:00
|
|
|
/*
|
|
|
|
* Deflate JS chars to bytes into a buffer. 'bytes' must be large enough for
|
|
|
|
* 'length chars. The buffer is NOT null-terminated. The destination length
|
|
|
|
* must to be initialized with the buffer size and will contain on return the
|
2010-04-03 00:05:30 +04:00
|
|
|
* number of copied bytes. Conversion behavior depends on js_CStringsAreUTF8.
|
2005-01-12 08:18:17 +03:00
|
|
|
*/
|
2011-05-27 02:50:05 +04:00
|
|
|
extern bool
|
|
|
|
DeflateStringToBuffer(JSContext *cx, const jschar *chars,
|
|
|
|
size_t charsLength, char *bytes, size_t *length);
|
2005-01-12 08:18:17 +03:00
|
|
|
|
2010-04-03 00:05:30 +04:00
|
|
|
/*
|
2011-05-27 02:50:05 +04:00
|
|
|
* Same as DeflateStringToBuffer, but treats 'bytes' as UTF-8 or CESU-8.
|
2010-04-03 00:05:30 +04:00
|
|
|
*/
|
2011-05-27 02:50:05 +04:00
|
|
|
extern bool
|
|
|
|
DeflateStringToUTF8Buffer(JSContext *cx, const jschar *chars,
|
|
|
|
size_t charsLength, char *bytes, size_t *length,
|
|
|
|
FlationCoding fc = NormalEncoding);
|
|
|
|
|
|
|
|
} /* namespace js */
|
2010-04-03 00:05:30 +04:00
|
|
|
|
2010-08-01 20:58:03 +04:00
|
|
|
/*
|
|
|
|
* The String.prototype.replace fast-native entry point is exported for joined
|
|
|
|
* function optimization in js{interp,tracer}.cpp.
|
|
|
|
*/
|
|
|
|
namespace js {
|
|
|
|
extern JSBool
|
|
|
|
str_replace(JSContext *cx, uintN argc, js::Value *vp);
|
|
|
|
}
|
|
|
|
|
2009-07-16 04:36:24 +04:00
|
|
|
extern JSBool
|
2010-07-15 10:19:36 +04:00
|
|
|
js_str_toString(JSContext *cx, uintN argc, js::Value *vp);
|
2009-07-16 04:36:24 +04:00
|
|
|
|
2010-08-06 09:54:34 +04:00
|
|
|
extern JSBool
|
|
|
|
js_str_charAt(JSContext *cx, uintN argc, js::Value *vp);
|
|
|
|
|
|
|
|
extern JSBool
|
|
|
|
js_str_charCodeAt(JSContext *cx, uintN argc, js::Value *vp);
|
|
|
|
|
2005-11-05 04:06:30 +03:00
|
|
|
/*
|
|
|
|
* Convert one UCS-4 char and write it into a UTF-8 buffer, which must be at
|
|
|
|
* least 6 bytes long. Return the number of UTF-8 bytes of data written.
|
|
|
|
*/
|
|
|
|
extern int
|
|
|
|
js_OneUcs4ToUtf8Char(uint8 *utf8Buffer, uint32 ucs4Char);
|
|
|
|
|
2010-10-28 19:15:53 +04:00
|
|
|
namespace js {
|
|
|
|
|
|
|
|
extern size_t
|
2010-12-06 21:26:58 +03:00
|
|
|
PutEscapedStringImpl(char *buffer, size_t size, FILE *fp, JSLinearString *str, uint32 quote);
|
2010-10-28 19:15:53 +04:00
|
|
|
|
2007-03-08 09:25:23 +03:00
|
|
|
/*
|
2010-10-28 19:15:53 +04:00
|
|
|
* Write str into buffer escaping any non-printable or non-ASCII character
|
|
|
|
* using \escapes for JS string literals.
|
|
|
|
* Guarantees that a NUL is at the end of the buffer unless size is 0. Returns
|
|
|
|
* the length of the written output, NOT including the NUL. Thus, a return
|
|
|
|
* value of size or more means that the output was truncated. If buffer
|
|
|
|
* is null, just returns the length of the output. If quote is not 0, it must
|
|
|
|
* be a single or double quote character that will quote the output.
|
2007-03-08 09:25:23 +03:00
|
|
|
*/
|
2010-10-28 19:15:53 +04:00
|
|
|
inline size_t
|
2010-12-06 21:26:58 +03:00
|
|
|
PutEscapedString(char *buffer, size_t size, JSLinearString *str, uint32 quote)
|
2010-10-28 19:15:53 +04:00
|
|
|
{
|
|
|
|
size_t n = PutEscapedStringImpl(buffer, size, NULL, str, quote);
|
|
|
|
|
|
|
|
/* PutEscapedStringImpl can only fail with a file. */
|
|
|
|
JS_ASSERT(n != size_t(-1));
|
|
|
|
return n;
|
|
|
|
}
|
2007-03-08 09:25:23 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Write str into file escaping any non-printable or non-ASCII character.
|
2010-10-28 19:15:53 +04:00
|
|
|
* If quote is not 0, it must be a single or double quote character that
|
|
|
|
* will quote the output.
|
2007-03-08 09:25:23 +03:00
|
|
|
*/
|
2010-10-28 19:15:53 +04:00
|
|
|
inline bool
|
2010-12-06 21:26:58 +03:00
|
|
|
FileEscapedString(FILE *fp, JSLinearString *str, uint32 quote)
|
2010-10-28 19:15:53 +04:00
|
|
|
{
|
|
|
|
return PutEscapedStringImpl(NULL, 0, fp, str, quote) != size_t(-1);
|
|
|
|
}
|
2007-03-08 09:25:23 +03:00
|
|
|
|
2010-10-28 19:15:53 +04:00
|
|
|
} /* namespace js */
|
2007-03-08 09:25:23 +03:00
|
|
|
|
2009-03-10 03:29:42 +03:00
|
|
|
extern JSBool
|
2010-08-11 03:38:08 +04:00
|
|
|
js_String(JSContext *cx, uintN argc, js::Value *vp);
|
2010-03-23 08:39:29 +03:00
|
|
|
|
1998-03-28 05:44:41 +03:00
|
|
|
#endif /* jsstr_h___ */
|