getStringList method

List<String> getStringList(List<String> keys, { List<String>? defaultValues, })

Retrieve a list of String values for keys.

If a key does not exist the corresponding value from defaultValues is returned.

Parameters

• keys: The list of keys to look up.
• defaultValues: List of default values returned when keys are missing. If is provided, its length must match the length of keys. If omitted, empty strings are used as defaults.

Returns

• The list of stored string values, or corresponding defaultValues if not found.
• If defaultValues length does not match keys length, an empty list is returned and GemError.invalidInput is set in ApiErrorService.apiError.

Also see:

• setStringList: to store a list of string values.

Implementation

List<String> getStringList(List<String> keys, {List<String>? defaultValues}) {
  if (defaultValues != null && defaultValues.length != keys.length) {
    ApiErrorServiceImpl.apiError = GemError.invalidInput;
    return <String>[];
  }

  final OperationResult resultString = objectMethod(
    pointerId,
    'SettingsService',
    'getValueStringList',
    args: <String, dynamic>{
      'keys': keys,
      'defaultValues': defaultValues ?? List<String>.filled(keys.length, ''),
    },
  );

  final List<dynamic> resultList = resultString['result'];
  return resultList.cast<String>().toList();
}