Class NameValueArray

Hierarchy

NameValueArray

Index

Constructors

constructor

Properties

name

Methods

Constructors

constructor

new NameValueArray(): NameValueArray

- Defined in @types/Gjs/Camel-1.2.d.ts:17999
Creates a new #CamelNameValueArray. The returned pointer should be freed with camel_name_value_array_free() when no longer needed.

Returns NameValueArray

Properties

Static name

name: string

Methods

append

append(name: string, value: string): void

- Defined in @types/Gjs/Camel-1.2.d.ts:17891
Appends a new element of the name name and the value value at the end of array.

See: camel_name_value_array_set_named

Parameters
- name: string
  
  a name
- value: string
  
  a value
Returns void

clear

clear(): void

- Defined in @types/Gjs/Camel-1.2.d.ts:17895
Removes all elements of the array.

Returns void

copy

copy(): NameValueArray

- Defined in @types/Gjs/Camel-1.2.d.ts:17900
Creates a new copy of the array. The returned pointer should be freed with camel_name_value_array_free() when no longer needed.

Returns NameValueArray

equal

equal(array_b: NameValueArray, compare_type: CompareType): boolean

- Defined in @types/Gjs/Camel-1.2.d.ts:17907
Compares content of the two #CamelNameValueArray and returns whether they equal. Note this is an expensive operation for large arrays.

Parameters
- array_b: NameValueArray
  
  the second #CamelNameValueArray
- compare_type: CompareType
  
  a compare type, one of #CamelCompareType
Returns boolean

free

free(): void

- Defined in @types/Gjs/Camel-1.2.d.ts:17913
Frees the array, previously allocated by camel_name_value_array_new(), camel_name_value_array_new_sized() or camel_name_value_array_copy(). If the array is %NULL, then does nothing.

Returns void

get

get(index: number): [boolean, string, string]

- Defined in @types/Gjs/Camel-1.2.d.ts:17919
Returns the name and the value of the element at index index. Either of the out_name and out_value can be %NULL, to not return that part.

Parameters
- index: number
  
  an index
Returns [boolean, string, string]

get_length

get_length(): number

- Defined in @types/Gjs/Camel-1.2.d.ts:17920
Returns number

get_name

get_name(index: number): string

- Defined in @types/Gjs/Camel-1.2.d.ts:17925
Returns the name of the element at index index.

Parameters
- index: number
  
  an index
Returns string

get_named

get_named(compare_type: CompareType, name: string): string

- Defined in @types/Gjs/Camel-1.2.d.ts:17933
Returns the value of the first element named name, or %NULL when there is no element of such name in the array. The compare_type determines how to compare the names.

Parameters
- compare_type: CompareType
  
  a compare type, one of #CamelCompareType
- name: string
  
  a name
Returns string

get_value

get_value(index: number): string

- Defined in @types/Gjs/Camel-1.2.d.ts:17938
Returns the value of the element at index index.

Parameters
- index: number
  
  an index
Returns string

remove

remove(index: number): boolean

- Defined in @types/Gjs/Camel-1.2.d.ts:17943
Removes element at index index.

Parameters
- index: number
  
  an index to remove
Returns boolean

remove_named

remove_named(compare_type: CompareType, name: string, all_occurrences: boolean): number

- Defined in @types/Gjs/Camel-1.2.d.ts:17953
Removes elements of the array with the given name. The compare_type determines hot to compare the names. If the all_occurrences is set to %TRUE, then every elements with the name are removed, otherwise only the first occurrence is removed.

Parameters
- compare_type: CompareType
  
  a compare type, one of #CamelCompareType
- name: string
  
  a name to remove
- all_occurrences: boolean
  
  whether to remove all occurrences of the name
Returns number

set

set(index: number, name: string, value: string): boolean

- Defined in @types/Gjs/Camel-1.2.d.ts:17960
Sets both the name and the value of the element at index index.

Parameters
- index: number
  
  an index
- name: string
  
  a name
- value: string
  
  a value
Returns boolean

set_name

set_name(index: number, name: string): boolean

- Defined in @types/Gjs/Camel-1.2.d.ts:17966
Sets the name of the element at index index.

Parameters
- index: number
  
  an index
- name: string
  
  a name
Returns boolean

set_named

set_named(compare_type: CompareType, name: string, value: string): boolean

- Defined in @types/Gjs/Camel-1.2.d.ts:17977
Finds an element named name and sets its value to value, or appends a new element, in case no such named element exists in the array yet. In case there are more elements named with name only the first occurrence is changed. The compare_type determines how to compare the names.

Parameters
- compare_type: CompareType
  
  a compare type, one of #CamelCompareType
- name: string
  
  a name
- value: string
  
  a value
Returns boolean

set_value

set_value(index: number, value: string): boolean

- Defined in @types/Gjs/Camel-1.2.d.ts:17983
Sets the value of the element at index index.

Parameters
- index: number
  
  an index
- value: string
  
  a value
Returns boolean

Static new

new(): NameValueArray

- Defined in @types/Gjs/Camel-1.2.d.ts:18005
Creates a new #CamelNameValueArray. The returned pointer should be freed with camel_name_value_array_free() when no longer needed.

Returns NameValueArray

Static new_sized

new_sized(reserve_size: number): NameValueArray

- Defined in @types/Gjs/Camel-1.2.d.ts:18014
Creates a new #CamelNameValueArray, which has reserved reserve_size elements. This value doesn't influence the camel_name_value_array_get_length(), which returns zero on the array returned from this function. The returned pointer should be freed with camel_name_value_array_free() when no longer needed.

Parameters
- reserve_size: number
  
  an array size to reserve
Returns NameValueArray