Skip to contents

Generate Random Strings

Source: R/random.R
stri_rand_strings.Rd

Generates (pseudo)random strings of desired lengths.

Usage

stri_rand_strings(n, length, pattern = "[A-Za-z0-9]")

Arguments

n

single integer, number of observations

length

integer vector, desired string lengths

pattern

character vector specifying character classes to draw elements from, see stringi-search-charclass

Value

Returns a character vector.

Details

Vectorized over length and pattern. If length of length or pattern is greater than n, then redundant elements are ignored. Otherwise, these vectors are recycled if necessary.

This operation may result in non-Unicode-normalized strings and may give peculiar outputs for bidirectional strings.

Sampling of code points from the set specified by pattern is always done with replacement and each code point appears with equal probability.

See also

The official online manual of stringi at https://stringi.gagolewski.com/

Gagolewski M., stringi: Fast and portable character string processing in R, Journal of Statistical Software 103(2), 2022, 1-59, doi:10.18637/jss.v103.i02

Other random: stri_rand_lipsum(), stri_rand_shuffle()

Author

Marek Gagolewski and other contributors

Examples

stri_rand_strings(5, 10) # 5 strings of length 10
#> [1] "MOYXFQGczz" "NkxqAG2C4g" "z8PVrVKqtw" "vmBe11X9vI" "UKRAMsdRdA"
stri_rand_strings(5, sample(1:10, 5, replace=TRUE)) # 5 strings of random lengths
#> [1] "Il0RyOGu" "Zx"       "5f5Ep5S"  "6KzW6qO"  "xIS"     
stri_rand_strings(10, 5, '[\\p{script=latin}&\\p{Ll}]') # small letters from the Latin script
#>  [1] "ơｙꞓěᶖ" "ấḣfflꞔʈ"  "ỹɒꬲᶀɯ"  "ʋḝṇńẜ"  "vǝꭖǰǒ"  "yɟòḥᶇ"  "ᵻｉȝǥɦ" "ꝕꟑꝓấꞽ" 
#>  [9] "h𝼧ffiúv"  "ḅȭȧƾḝ" 

# generate n random passwords of length in [8, 14]
# consisting of at least one digit, small and big ASCII letter:
n <- 10
stri_rand_shuffle(stri_paste(
   stri_rand_strings(n, 1, '[0-9]'),
   stri_rand_strings(n, 1, '[a-z]'),
   stri_rand_strings(n, 1, '[A-Z]'),
   stri_rand_strings(n, sample(5:11, 5, replace=TRUE), '[a-zA-Z0-9]')
))
#>  [1] "mgAEM1icVyHVC"  "76nLX4SDvC8Krr" "YREw2On5MMJZL"  "XrN12TcqCyl"   
#>  [5] "8kcqFqZ8aTT7"   "Ls7yvTgHrd296"  "0itUx8EkaWHYNW" "GSWVmW95UFtmI" 
#>  [9] "4x8yBjKqavG"    "4KvOYh760kMt"