Shared

arrayContains

fjsf.arrayContains(inputArray, targetValue)

Checks if a value exists inside an array. Intended only for sequential tables (1..n).

Parameters

• inputArray (table) — The array to search

• targetValue (any) — The value to look for

Returns

• (boolean) — true if the value exists, otherwise false

Example

if fjsf.arrayContains(allowedJobs, playerJob) then
    openMenu()
end

---

arrayAt

fjsf.arrayAt(inputArray, position)

Returns the element at the given index. Negative indexes are supported (-1 returns the last element).

Parameters

• inputArray (table) — The array to read from

• position (number) — The index to access

Returns

• (any | nil) — The element at the index or nil

Example

local lastPlayer = fjsf.arrayAt(players, -1)

---

arrayForEach

fjsf.arrayForEach(inputArray, iterator, iterateReverse)

Iterates over an array and executes a callback for each element.

Parameters

• inputArray (table) — The array to iterate

• iterator (function) — Function called with (value, index)

• iterateReverse (boolean) — Whether to iterate backwards

Returns

• (nil)

Example

fjsf.arrayForEach(players, function(playerId)
    TriggerClientEvent('refreshUI', playerId)
end)

---

arrayMap

fjsf.arrayMap(sourceArray, mapper)

Creates a new array by transforming each element.

Parameters

• sourceArray (table) — The array to map

• mapper (function) — Function (value, index, sourceArray)

Returns

• (table) — A new mapped array

Example

local pedList = fjsf.arrayMap(players, function(id)
    return GetPlayerPed(id)
end)

---

arrayFind

fjsf.arrayFind(sourceArray, predicate, reverse)

Returns the first element that matches a condition.

Parameters

• sourceArray (table) — The array to search

• predicate (function) — Function (value, index) returning boolean

• reverse (boolean) — Whether to search from the end

Returns

• (any | nil) — The found element or nil

Example

local nearbyVehicle = fjsf.arrayFind(vehicles, function(veh)
    return #(GetEntityCoords(veh) - coords) < 10.0
end)

---

arrayFindIndex

fjsf.arrayFindIndex(sourceArray, predicate, reverse)

Returns the index of the first element matching a condition.

Parameters

• sourceArray (table) — The array to search

• predicate (function) — Function (value, index)

• reverse (boolean) — Whether to search from the end

Returns

• (number | nil) — The index or nil

Example

local index = fjsf.arrayFindIndex(players, function(id)
    return id == source
end)

---

arrayFilter

fjsf.arrayFilter(sourceArray, predicate)

Creates a new array containing only elements that pass a condition.

Parameters

• sourceArray (table) — The array to filter

• predicate (function) — Function (value, index)

Returns

• (table) — Filtered array

Example

local cops = fjsf.arrayFilter(players, function(id)
    return Player(id).job == 'police'
end)

---

arrayMerge

fjsf.arrayMerge(...)

Combines multiple arrays into a single new array.

Parameters

• ... (table) — Arrays to merge

Returns

• (table) — New merged array

Example

local allEntities = fjsf.arrayMerge(vehicles, peds, objects)

---

arrayPop

fjsf.arrayPop(inputArray)

Removes and returns the last element of an array.

Parameters

• inputArray (table) — The array to modify

Returns

• (any) — The removed value

Example

local lastRequest = fjsf.arrayPop(requestQueue)

---

arrayShift

fjsf.arrayShift(inputArray)

Removes and returns the first element of an array.

Parameters

• inputArray (table) — The array to modify

Returns

• (any) — The removed value

Example

local nextTask = fjsf.arrayShift(taskQueue)

---

arrayPush

fjsf.arrayPush(inputArray, ...)

Adds one or more elements to the end of an array.

Parameters

• inputArray (table) — The array to modify

• ... (any) — Values to add

Returns

• (number) — New array length

Example

fjsf.arrayPush(playersInZone, source)

---

arrayUnshift

fjsf.arrayUnshift(inputArray, ...)

Inserts one or more elements at the start of an array.

Parameters

• inputArray (table) — The array to modify

• ... (any) — Values to insert

Returns

• (number) — New array length

Example

fjsf.arrayUnshift(priorityQueue, urgentTask)

---

arraySlice

fjsf.arraySlice(sourceArray, fromIndex, toIndex)

Creates a shallow copy of a portion of an array.

Parameters

• sourceArray (table) — The array to slice

• fromIndex (number) — Starting index

• toIndex (number) — Ending index

Returns

• (table) — New array slice

Example

local firstFive = fjsf.arraySlice(players, 1, 5)

---

arrayReduce

fjsf.arrayReduce(sourceArray, reducer, initial)

Reduces an array to a single value.

Parameters

• sourceArray (table) — The array to reduce

• reducer (function) — Function (accumulator, value, index)

• initial (any) — Initial accumulator value

Returns

• (any) — Reduced result

Example

local totalMoney = fjsf.arrayReduce(players, function(sum, id)
    return sum + Player(id).money
end, 0)

---

arrayReverse

fjsf.arrayReverse(inputArray)

Reverses the array in place.

Parameters

• inputArray (table) — The array to reverse

Returns

• (table) — The same array, reversed

Example

fjsf.arrayReverse(playerQueue)

---

arrayToReversed

fjsf.arrayToReversed(sourceArray)

Creates a new reversed array without modifying the original.

Parameters

• sourceArray (table) — The array to reverse

Returns

• (table) — New reversed array

Example

local reversedHistory = fjsf.arrayToReversed(history)

---

isArray

fjsf.isArray(inputTable)

Determines whether a table is array-like (1..n without gaps).

Parameters

• inputTable (table) — Table to check

Returns

• (boolean) — Whether the table is an array

Example

if fjsf.isArray(data) then
    print('Array detected')
end

---

arrayRandom

fjsf.arrayRandom(sourceArray)

Returns a random element from an array.

Parameters

• sourceArray (table) — The array to pick from

Returns

• (any | nil) — Random element or nil

Example

local spawnPoint = fjsf.arrayRandom(spawnPoints)

---

arrayShuffle

fjsf.arrayShuffle(sourceArray)

Randomly shuffles an array in place.

Parameters

• sourceArray (table) — The array to shuffle

Returns

• (table) — Shuffled array

Example

fjsf.arrayShuffle(lootTable)

---

arrayUnique

fjsf.arrayUnique(sourceArray)

Removes duplicate values from an array.

Parameters

• sourceArray (table) — The array to process

Returns

• (table) — Array with unique values

Example

local uniquePlayers = fjsf.arrayUnique(playersInZone)