summaryrefslogtreecommitdiffstats
path: root/js/src/builtin/String.h
blob: 556bc92488e30b7415847dae81102c82fca5ea87 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 * vim: set ts=8 sts=2 et sw=2 tw=80:
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef builtin_String_h
#define builtin_String_h

#include "NamespaceImports.h"

#include "js/RootingAPI.h"
#include "js/Value.h"

namespace js {

class ArrayObject;
class GlobalObject;

/* Initialize the String class, returning its prototype object. */
extern JSObject* InitStringClass(JSContext* cx, Handle<GlobalObject*> global);

// String methods exposed so they can be installed in the self-hosting global.

extern bool str_fromCharCode(JSContext* cx, unsigned argc, Value* vp);

extern bool str_fromCodePoint(JSContext* cx, unsigned argc, Value* vp);

extern bool str_includes(JSContext* cx, unsigned argc, Value* vp);

extern bool str_indexOf(JSContext* cx, unsigned argc, Value* vp);

extern bool str_startsWith(JSContext* cx, unsigned argc, Value* vp);

extern bool str_toString(JSContext* cx, unsigned argc, Value* vp);

extern bool str_charCodeAt(JSContext* cx, unsigned argc, Value* vp);

extern bool str_codePointAt(JSContext* cx, unsigned argc, Value* vp);

extern bool str_endsWith(JSContext* cx, unsigned argc, Value* vp);

#if JS_HAS_INTL_API
/**
 * Returns the input string converted to lower case based on the language
 * specific case mappings for the input locale.
 *
 * Usage: lowerCase = intl_toLocaleLowerCase(string, locale)
 */
[[nodiscard]] extern bool intl_toLocaleLowerCase(JSContext* cx, unsigned argc,
                                                 Value* vp);

/**
 * Returns the input string converted to upper case based on the language
 * specific case mappings for the input locale.
 *
 * Usage: upperCase = intl_toLocaleUpperCase(string, locale)
 */
[[nodiscard]] extern bool intl_toLocaleUpperCase(JSContext* cx, unsigned argc,
                                                 Value* vp);
#endif

ArrayObject* StringSplitString(JSContext* cx, HandleString str,
                               HandleString sep, uint32_t limit);

JSString* StringFlatReplaceString(JSContext* cx, HandleString string,
                                  HandleString pattern,
                                  HandleString replacement);

JSString* str_replace_string_raw(JSContext* cx, HandleString string,
                                 HandleString pattern,
                                 HandleString replacement);

JSString* str_replaceAll_string_raw(JSContext* cx, HandleString string,
                                    HandleString pattern,
                                    HandleString replacement);

extern bool StringIncludes(JSContext* cx, HandleString string,
                           HandleString searchString, bool* result);

extern bool StringIndexOf(JSContext* cx, HandleString string,
                          HandleString searchString, int32_t* result);

extern bool StringLastIndexOf(JSContext* cx, HandleString string,
                              HandleString searchString, int32_t* result);

extern bool StringStartsWith(JSContext* cx, HandleString string,
                             HandleString searchString, bool* result);

extern bool StringEndsWith(JSContext* cx, HandleString string,
                           HandleString searchString, bool* result);

extern JSString* StringToLowerCase(JSContext* cx, HandleString string);

extern JSString* StringToUpperCase(JSContext* cx, HandleString string);

extern JSString* StringTrim(JSContext* cx, HandleString string);

extern JSString* StringTrimStart(JSContext* cx, HandleString string);

extern JSString* StringTrimEnd(JSContext* cx, HandleString string);

extern bool StringConstructor(JSContext* cx, unsigned argc, Value* vp);

extern bool FlatStringMatch(JSContext* cx, unsigned argc, Value* vp);

extern bool FlatStringSearch(JSContext* cx, unsigned argc, Value* vp);

extern JSLinearString* StringFromCharCode(JSContext* cx, int32_t charCode);

extern JSLinearString* StringFromCodePoint(JSContext* cx, char32_t codePoint);

} /* namespace js */

#endif /* builtin_String_h */