pd.match is a lurking function.....would be nice to add a short blurb to the main docs, maybe in factorize section

https://github.com/pydata/pandas/blob/master/doc/source/reshaping.rst#factorizing-values

used here in docs: https://github.com/pydata/pandas/pull/5875/files

Comment From: jorisvandenbossche

Some questions if we would advertise this function: - at the moment it works with arrays, where it seems more logical for a function of pandas to work with pandas objects (series)? - Related: what to do with a Series as values -> return locations or labels? - the na_sentinel of -1 is also not something much used anywhere else in pandas I think?

Comment From: jreback

yeh not used anywhere afaict

it's like factorize and unique which also operate in arrays (a series works too)

these are sort of internal functions that are exposed

prob could have series methods that call them and wrap

Comment From: jorisvandenbossche

pandas.match is deprecated in the meantime, so closing this.